# Onyo la Tafsiri

Hati hii imetafsiriwa kiotomatiki. Ikiwa kuna makosa ya tafsiri tafadhali fungua pull request kwenye mradi na ongeza faili iliyotafsiriwa kwenye docs/{ISO 639-1 Code}.md.

# Utangulizi

Kifurushi hiki hurahisisha mchakato wa kuongeza viungo vya kushiriki kwenye programu yako ya Laravel. Jisikie huru kufungua ombi la kuvuta ikiwa utaona tunakosa huduma!

Kiungo cha kushiriki ni URL inayounganisha URL ya msingi ya mitandao ya kijamii na vigezo vya maswali kwa ajili ya kushiriki maudhui kutoka kwenye tovuti au programu yako. Vigezo kawaida hujumuisha URL ya maudhui na ujumbe uliowekwa tayari. Viungo hivi, kama inavyoonyeshwa kwenye mifano, huwaruhusu watumiaji kushiriki machapisho kwa urahisi kwenye majukwaa kama Twitter, Facebook, na Telegram. Tumia kifurushi hiki cha chanzo huria kuunda viungo vya kushiriki haraka kupitia mfumo wa vipengele vya blade vya Laravel.

Mfano
Huduma

Mfano

<x-link-sharer service="twitter" text="Nishiriki!" url="https://www.defectivecode.com" hashtags="awesome,links" class="p-4">
    <!-- Msimbo wako wa HTML hapa kudhibiti mwonekano na hisia za kitufe cha kushiriki -->
    <span class="bg-blue-500 hover:bg-blue-700 text-white font-bold py-2 px-4 rounded">Bonyeza mimi!</span>
</x-link-sharer>

# Ufungaji

Kwanza, sakinisha kifurushi cha PHP kwa kuendesha amri ifuatayo ya composer:
```
composer require defectivecode/link-sharer
```
Hiyo tu! Kifurushi chetu kitawekwa kiotomatiki kwa kutumia ugunduzi wa kifurushi cha Laravel.

Huduma

Watoa huduma mara kwa mara husasisha viungo vyao vya kushiriki bila taarifa ya awali. Tunajitahidi sana kubaki na habari mpya kuhusu mabadiliko haya. Hata hivyo, ikiwa utakutana na huduma isiyofanya kazi, tafadhali fungua suala au wasilishe ombi la kuvuta. Kwa kuongeza huduma mpya, rejelea sehemu ya kuchangia hapa chini.

Baadhi ya huduma hutoa vigezo vya ziada ambavyo vinaweza kupitishwa kwa kipengele. Hivi vimeandikwa kwenye jedwali hapa chini.

Huduma	Maandishi Yanaungwa Mkono	URL Inayoungwa Mkono	Maelezo
Blogger	✔️	✔️	`t` Maandishi ya chapisho la blogu.
Diaspora	✔️	✔️
Diigo	✔️	✔️	`description` Maelezo ya kuongeza kwenye chapisho.
Douban	✔️	✔️	`comment` Maoni ya kuongeza kwenye chapisho.
Evernote	✔️	✔️
Facebook	❌	✔️
Flipboard	✔️	✔️	`quote` Nukuu ya kuongeza kwenye chapisho.
Gmail	✔️	✔️	`bcc` Orodha ya anwani za barua pepe za BCC. `cc` Orodha ya anwani za barua pepe za CC. `su` Kichwa cha barua pepe. `to` Orodha ya anwani za barua pepe za kutuma.
HackNews	✔️	✔️
Instapaper	✔️	✔️	`description` Maelezo ya chapisho.
LineMe	❌	✔️
LinkedIn	❌	✔️
LiveJournal	✔️	✔️
Meneame	❌	✔️
Okru	❌	✔️
Outlook	✔️	✔️
Pinterest	✔️	✔️	`media` URL ya picha ya kuonyesha kwenye chapisho.
Plurk	❌	✔️
Pocket	✔️	✔️
QZone	✔️	✔️	`summary` Muhtasari wa chapisho.
Reddit	✔️	✔️
Renren	✔️	✔️	`description` Maelezo ya chapisho. `srcUrl` URL ya asili ya chapisho.
Skype	✔️	✔️
Telegram	✔️	✔️
Threema	❌	✔️	`id` Kitambulisho cha mtu wa kutuma chapisho.
Tumblr	✔️	✔️	`caption` Maelezo ya kuongeza kwenye chapisho. `tags` Orodha ya vitambulisho vya kuongeza kwenye chapisho.
Twitter	✔️	✔️	`hastags` Orodha ya vitambulisho vya hash vya kuongeza kwenye tweet. `via` Mtumiaji wa Twitter wa kutoa sifa.
Viber	✔️	✔️
VKontakte	✔️	✔️	`description` Maelezo ya chapisho. `image` URL ya picha ya kuonyesha kwenye chapisho.
Weibo	✔️	✔️
WhatsApp	✔️	✔️
Xing	❌	✔️
YahooMail	✔️	✔️

# Kuchangia
 
Kuongeza huduma ni rahisi sana. Anza kwa kuunda darasa jipya la huduma ndani ya folda ya `src/Services`. Lipe darasa jina la huduma unayoongeza. Mfumo hujisajili huduma kiotomatiki kupitia kiwanda, kwa hivyo hakuna haja ya usajili wa mwongozo.
 
Huduma ya Gmail iliyo hapa chini inatumika kama mfano mzuri.
 
```php
<?php
 
namespace DefectiveCode\LinkSharer\Services;
 
use DefectiveCode\LinkSharer\Traits\AppendsLinks;
 
class Gmail extends Service
{
    use AppendsLinks;
 
    protected string $baseUrl = 'https://mail.google.com/mail/u/0';
 
    protected array $baseParameterMapping = [
        'text' => 'body',
    ];
 
    protected array $additionalParameters = [
        'bcc',
        'cc',
        'su',
        'to',
    ];
 
    protected array $defaultParameters = [
        'view' => 'cm',
    ];
}

Tafadhali kumbuka kuwa ni baseUrl pekee ndiyo ya lazima. baseParameterMapping, additionalParameters, na defaultParameters ni hiari lakini zinaweza kuongeza utendaji.

`$baseUrl`

URL ya huduma haihitaji kuanza na HTTPS. Kwa mfano, Viber hutumia viber://forward.

Sifa ya baseUrl inaeleza URL kuu ya huduma. URL hii ni ya msingi wakati wa kuzalisha kiungo cha kushiriki, ambapo vigezo vya swali vinaongezwa. Kwa kutumia Gmail kama mfano, URL yake ya msingi ni https://mail.google.com/mail/u/0.

`$baseParameterMapping`

Kifurushi hiki kinatambua sifa mbili kuu: text na url, kutokana na upana wao kwa watoa huduma wengi. Eleza sifa hizi tu ikiwa huduma husika inatumia majina tofauti. Kwa mfano, Gmail hutumia body badala ya text, ikihitaji ramani hii wazi. Unapotumia Gmail, sifa yoyote ya text inayopitishwa kwa kipengele cha blade inabadilishwa kuwa kigezo cha swali cha body katika kiungo cha kushiriki.

`$additionalParameters`

Huduma zingine zinakubali vigezo maalum zaidi vya swali. Kwa kuchukua Gmail kama rejeleo, inasaidia bcc, cc, su, na to. Eleza hizi katika safu ya additionalParameters. Watumiaji wanapojumuisha sifa hizi katika kipengele cha blade, zinaongezwa kwenye kiungo cha kushiriki. Hakikisha vigezo hivi pia vimeorodheshwa katika jedwali la huduma zinazosaidiwa, pamoja na maelezo mafupi.

`$defaultParameters`

Huduma fulani zinahitaji vigezo maalum vya swali ili kiungo cha kushiriki kifanye kazi. Kwa mfano, Gmail inahitaji kujumuisha view=cm. Sifa hizi za lazima zinatangazwa katika safu ya defaultParameters. Zinaongezwa kila wakati kwenye kiungo cha kushiriki na haziwezi kuachwa.

`prepareAttributes()`

Ili kudhibiti sifa kabla ya kuzalisha kiungo cha kushiriki, ongeza njia ya prepareAttributes kwenye huduma yako. Njia hii inafanya kazi kabla ya kupitisha sifa kwa njia ya generateLink, ikiruhusu marekebisho maalum ya sifa. Hapa chini ni onyesho kwa kutumia sifa ya AppendsLinks.

<?php
 
namespace DefectiveCode\LinkSharer\Traits;
 
trait AppendsLinks
{
    protected function prepareAttributes(): void
    {
        if (isset($this->attributes['text']) && isset($this->attributes['url'])) {
            $this->attributes['text'] = $this->attributes['text'] . "\n" . $this->attributes['url'];
            return;
        }
 
        if (isset($this->attributes['url'])) {
            $this->attributes['text'] = $this->attributes['url'];
        }
    }
}

Sifa zinazopitishwa kwenye huduma zinapatikana kupitia safu ya $attributes. Katika mfano ulioonyeshwa:

Ikiwa sifa zote mbili text na url zipo, url inaongezwa kwenye sifa ya text.
Ikiwa sifa ya url pekee ndiyo inapatikana, sifa ya text inachukua thamani ya url.

 
 
```markdown
# Miongozo ya Usaidizi
 
Asante kwa kuchagua kifurushi chetu cha chanzo huria! Tafadhali chukua muda kidogo kuangalia miongozo hii ya usaidizi. Itakusaidia kupata zaidi kutoka kwa mradi wetu.
 
## Usaidizi Unaotokana na Jamii
 
Mradi wetu wa chanzo huria unachochewa na jamii yetu nzuri. Ikiwa una maswali au unahitaji msaada, StackOverflow na rasilimali zingine za mtandaoni ni chaguo bora.
 
## Hitilafu, na Kipaumbele cha Vipengele
 
Ukweli wa kusimamia mradi wa chanzo huria unamaanisha hatuwezi kushughulikia kila hitilafu iliyoripotiwa au ombi la kipengele mara moja. Tunapa kipaumbele masuala kwa mpangilio ufuatao:
 
### 1. Hitilafu Zinazoathiri Bidhaa Zetu za Malipo
 
Hitilafu zinazoathiri bidhaa zetu za malipo zitakuwa kipaumbele chetu cha juu kila wakati. Katika baadhi ya matukio, tunaweza kushughulikia tu hitilafu zinazotuathiri moja kwa moja.
 
### 2. Maombi ya Kuvuta ya Jamii
 
Ikiwa umebaini hitilafu na una suluhisho, tafadhali wasilisha ombi la kuvuta. Baada ya masuala yanayoathiri bidhaa zetu, tunatoa kipaumbele cha juu kwa marekebisho haya yanayotokana na jamii. Baada ya kukaguliwa na kuidhinishwa, tutaunganisha suluhisho lako na kukupa sifa kwa mchango wako.
 
### 3. Msaada wa Kifedha
 
Kwa masuala nje ya makundi yaliyotajwa, unaweza kuchagua kufadhili utatuzi wake. Kila suala lililofunguliwa linaunganishwa na fomu ya agizo ambapo unaweza kuchangia kifedha. Tunapa kipaumbele masuala haya kulingana na kiasi cha fedha kilichotolewa.
 
### Michango ya Jamii
 
Chanzo huria kinastawi wakati jamii yake inafanya kazi. Hata kama hurekebishi hitilafu, fikiria kuchangia kupitia maboresho ya msimbo, masasisho ya nyaraka, mafunzo, au kwa kusaidia wengine katika njia za jamii. Tunahimiza sana kila mtu, kama jamii, kusaidia kazi ya chanzo huria.
 
_Kurudia, DefectiveCode itapa kipaumbele hitilafu kulingana na jinsi zinavyoathiri bidhaa zetu za malipo, maombi ya kuvuta ya jamii, na msaada wa kifedha uliopokelewa kwa masuala._

# Leseni - Leseni ya MIT

Ruhusa inatolewa hapa, bila malipo, kwa mtu yeyote anayepata nakala ya programu hii na faili za nyaraka zinazohusiana (hapa "Programu"), kushughulikia Programu bila kizuizi, ikiwa ni pamoja na bila kikomo haki za kutumia, kunakili, kurekebisha, kuunganisha, kuchapisha, kusambaza, kutoa leseni ndogo, na/au kuuza nakala za Programu, na kuruhusu watu ambao Programu inatolewa kwao kufanya hivyo, kwa masharti yafuatayo:

Ilani ya haki miliki hapo juu na ruhusa hii itajumuishwa katika nakala zote au sehemu kubwa za Programu.

PROGRAMU INATOLEWA "KAMA ILIVYO", BILA DHAMANA YA AINA YOYOTE, IKIWA IMEELEZWA AU KUDOKEZWA, IKIWA NI PAMOJA NA BILA KIKOMO DHAMANA ZA KUUZIKA, USTAHIKI KWA KUSUDI FULANI NA KUTOKUKIUKA. KWA HALI YOYOTE WAANDISHI AU WENYE HAKI MILIKI HAWATAWAJIBIKA KWA DAI LOLOTE, UHARIBIFU AU DHIMA NYINGINE, IKIWA KATIKA MKATABA, KOSA AU VINGINEVYO, INAYOTOKEA KUTOKANA NA, KUTOKA KWA AU KATIKA UHUSIANO NA PROGRAMU AU MATUMIZI AU MAMBO MENGINE KATIKA PROGRAMU.

🔗Mfano

🔗Huduma

🔗$baseUrl

🔗$baseParameterMapping

🔗$additionalParameters

🔗$defaultParameters

🔗prepareAttributes()