Onyo wa Tafsiri
Utangulizi
- Mfano
Ufungaji
Huduma
Kuchangia
Mwongozo wa Msaada
- Msaada Unaotolewa na Jumuiya
- Mende na Uthamini wa Vipengele
Leseni - Leseni ya MIT

Onyo wa Tafsiri

Hati hii imefasiriwa kiotomatiki. Ikiwa kuna makosa ya tafsiri tafadhali fungua ombi la kuvuta kwenye mradi na ongeza faili iliyotafsiriwa kwa docs/{ISO 639-1 Code}.md.

Utangulizi

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

Kiungo cha kushiriki ni URL inayounganisha URL ya msingi ya media ya kijamii na vigezo vya utafutaji kwa kushiriki maudhui kutoka kwenye tovuti au programu yako. Vigezo kawaida ni pamoja na URL ya maudhui na ujumbe uliowekwa mapema. Viungo hivi, kama inavyoonyeshwa kwenye mifano, huruhusu watumiaji kwa urahisi kushiriki machapisho kwenye majukwaa kama Twitter, Facebook, na Telegram. Tumia kifurushi hiki cha chanzo wazi ili haraka kuunda viungo vya kushiriki kupitia mfumo wa sehemu za blade za Laravel.

Mfano

<x-link-sharer service="twitter" text="Shiriki nami!" url="https://www.defectivecode.com" hashtags="nzuri,viungo" class="p-4">
    <!-- Weka hapa namna ya kudhibiti muonekano na hisia ya kitufe cha kushiriki -->
    <span class="bg-blue-500 hover:bg-blue-700 text-white font-bold py-2 px-4 rounded">Bonyeza hapa!</span>
</x-link-sharer>

Ufungaji

Kwanza, sakinisha kifurushi cha PHP kwa kukimbia amri ifuatayo ya composer:
```
composer require defectivecode/link-sharer
```
Hiyo ndiyo! Kifurushi chetu kitasakinishwa moja kwa moja kwa kutumia ugunduzi wa kifurushi cha Laravel.

Huduma

Watoa huduma mara kwa mara hufanya marekebisho kwenye viungo vyao vya kushiriki bila taarifa mapema. Tunafanya kila juhudi kuwa na habari zilizosasishwa kuhusu mabadiliko haya. Hata hivyo, ikiwa utakutana na huduma isiyofanya kazi, tafadhali fungua suala au wasilisha ombi la kuvuta. Ili kuongeza huduma mpya, tazama sehemu ya uchangiaji hapo chini.

Baadhi ya huduma zinatoa vigezo ziada ambavyo vinaweza kupitishwa kwa sehemu. Vimeorodheshwa katika jedwali hapa chini.

Huduma	Inayoungwa mkono na Nakala	Inayoungwa mkono na URL	Maelezo
Blogger	✔️	✔️	`t` Nakala ya chapisho la blogi.
Diaspora	✔️	✔️
Diigo	✔️	✔️	`description` Maelezo ya kuongeza kwenye chapisho.
Douban	✔️	✔️	`comment` Maoni ya kuongeza kwenye chapisho.
Evernote	✔️	✔️
Facebook	❌	✔️
Flipboard	✔️	✔️	`quote` Ujumbe wa kuongeza kwenye chapisho.
Gmail	✔️	✔️	`bcc` Orodha ya anwani za barua pepe za BCC zilizotenganishwa na alama ya koma. `cc` Orodha ya anwani za barua pepe za CC zilizotenganishwa na alama ya koma. `su` Mada ya 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 alama za koma za alama za kutumia kwenye chapisho.
Twitter	✔️	✔️	`hastags` Orodha ya alama za koma za alama za kutumia kwenye chapisho. `via` Mtumaji wa ujumbe wa kutambua.
Viber	✔️	✔️
VKontakte	✔️	✔️	`description` Maelezo ya chapisho. `image` URL ya picha ya kuonyesha kwenye chapisho.
Weibo	✔️	✔️
WhatsApp	✔️	✔️
Xing	❌	✔️
YahooMail	✔️	✔️

Kuchangia

Kuongeza huduma ni rahisi. Anza kwa kuunda darasa la huduma mpya ndani ya folda ya src/Services. Ita darasa kwa jina la huduma unayoongeza. Mfumo unasajili huduma kiotomatiki kupitia kiwanda, kwa hivyo hakuna haja ya usajili wa mwongozo.

Huduma ya Gmail iliyotolewa hapa chini ni mfano mzuri.

<?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 baseUrl pekee ndio lazima. baseParameterMapping, additionalParameters, na defaultParameters ni hiari lakini zinaweza kuongeza utendaji.

`$baseUrl`

URL ya huduma haina lazima ianze na HTTPS. Kwa mfano, Viber hutumia viber://forward.

Mali ya baseUrl inabainisha URL kuu ya huduma. URL hii ni msingi wakati wa kuzalisha kiunga cha kushiriki, ambapo vigezo vya utafutaji huzidishwa. 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, kwa sababu ya uwepo wao katika watoa huduma wengi. Andika sifa hizi tu ikiwa huduma husika inatumia mkataba tofauti wa majina. Kwa mfano, Gmail hutumia body badala ya text, hivyo inahitaji ramani wazi. Wakati unatumia Gmail, sifa yoyote ya text iliyopitishwa kwa kipengele cha blade inabadilishwa kuwa kigezo cha utafutaji body katika kiunga cha kushiriki.

`$additionalParameters`

Baadhi ya huduma hukubali vigezo vya utafutaji maalum zaidi. Kwa kurejelea Gmail, inasaidia bcc, cc, su, na to. Andika hizi katika safu ya additionalParameters. Wakati watumiaji wanajumuisha sifa hizi katika kipengele cha blade, zinaongezwa kwenye kiunga cha kushiriki. Hakikisha vigezo hivi pia vimeorodheshwa katika jedwali la huduma zinazoungwa mkono, pamoja na maelezo mafupi.

`$defaultParameters`

Baadhi ya huduma zinahitaji vigezo vya utafutaji maalum ili kiunga cha kushiriki kifanye kazi. Kwa mfano, Gmail inahitaji kuingiza view=cm. Sifa kama hizo za lazima zinatangazwa katika safu ya defaultParameters. Mara zote zinaongezwa kwenye kiunga cha kushiriki na haziwezi kuachwa.

`prepareAttributes()`

Ili kubadilisha sifa kabla ya kuzalisha kiunga cha kushiriki, ongeza njia ya prepareAttributes kwa huduma yako. Njia hii inaendesha kabla ya kupeleka sifa kwa njia ya generateLink, kuruhusu mabadiliko ya desturi ya sifa. Hapa chini ni mfano wa matumizi ya tabia 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 zilizopitishwa kwenye huduma zinapatikana kupitia safu ya $attributes. Katika mfano ulioonyeshwa:

Ikiwa sifa za text na url zote zipo, url inaongezwa kwenye sifa ya text.
Ikiwa sifa ya url pekee ipo, sifa ya text inachukua thamani ya url.

Mwongozo wa Msaada

Asante kwa kuchagua pakiti yetu ya chanzo wazi! Tafadhali chukua muda wa kusoma mwongozo huu wa msaada. Utakusaidia kupata faida zaidi kutoka kwa mradi wetu.

Msaada Unaotolewa na Jumuiya

Mradi wetu wa chanzo wazi unategemea jumuiya yetu nzuri. Ikiwa una maswali au unahitaji msaada, StackOverflow na rasilimali zingine za mtandaoni ndizo chaguo bora zaidi.

Mende na Uthamini wa Vipengele

Uhalisia wa kusimamia mradi wa chanzo wazi una maana hatuwezi kushughulikia kila mende iliyoripotiwa au ombi la kipengele mara moja. Tunapanga masuala kwa utaratibu ufuatao:

1. Mende Zinazoathiri Bidhaa Zetu za Kulipia

Mende ambazo zinaathiri bidhaa zetu za kulipia daima zitakuwa kipaumbele chetu cha juu. Katika baadhi ya kesi, tunaweza kushughulikia mende ambazo zinaathiri sisi moja kwa moja.

2. Maombi ya Jumuiya ya Kuchangia

Ikiwa umetambua mende na una suluhisho, tafadhali wasilisha ombi la kuchangia. Baada ya masuala yanayoathiri bidhaa zetu, tunatoa kipaumbele cha juu kwa marekebisho haya yaliyotolewa na jumuiya. Baada ya ukaguzi na idhini, tutaunganisha suluhisho lako na kukiri mchango wako.

3. Msaada wa Fedha

Kwa masuala yaliyo nje ya makundi yaliyotajwa, unaweza kuchagua kuchangia kifedha kwa ajili ya ufumbuzi wao. Kila suala wazi linaunganishwa na fomu ya agizo ambapo unaweza kuchangia kifedha. Tunapanga masuala haya kwa kuzingatia kiasi cha fedha kilichotolewa.

Michango ya Jumuiya

Chanzo wazi kinakua wakati jumuiya yake inakuwa hai. Hata kama huwezi kusahihisha mende, tafadhali fikiria kuchangia kupitia marekebisho ya nambari, sasisho za nyaraka, mafunzo, au kwa kusaidia wengine katika njia za jumuiya. Tunahimiza sana kila mtu, kama jumuiya, kusaidia kazi ya chanzo wazi.

Kwa kusisitiza, DefectiveCode itapanga mende kulingana na jinsi zinavyoathiri bidhaa zetu za kulipia, maombi ya jumuiya ya kuchangia, na msaada wa kifedha uliopokelewa kwa masuala.

Leseni - Leseni ya MIT

Hapa kwa hii programu na faili zake zinazohusiana (pamoja na "Programu"), ruhusa inatolewa bure kwa mtu yeyote anayepata nakala ya programu hii na faili za nyaraka zake (pamoja na "Programu"), kushughulika na Programu bila kizuizi, pamoja na bila kikomo haki za kutumia, kunakili, kurekebisha, kuunganisha, kuchapisha, kusambaza, kutoa leseni, na / au kuuza nakala za Programu, na kuruhusu watu ambao Programu imetolewa kufanya hivyo, chini ya masharti yafuatayo:

Hati ya haki miliki hapo juu na hati hii ya ruhusa lazima iwe pamoja na nakala zote au sehemu kubwa ya Programu.

PROGRAMU IMETOLEWA "KAMA ILIVYO", BILA DHAMANA YA AINA YOYOTE, IMESEMA AU IMEIMARISHWA, IKIWA NI PAMOJA NA LAKINI HAIJAZUIWA KWA DHAHABU ZA KUUZWA, KWA MADHUMUNI YA KIUCHUMI, KWA KUFANYA KAZI KWA MADHUMUNI FULANI NA KWA KUFANYA KAZI BILA KUKUFA, KUTOKA KWA AU KATIKA UHUSIANO NA PROGRAMU AU MATUMIZI AU MATUMIZI MENGINE YA PROGRAMU.

🔗Onyo wa Tafsiri

🔗Utangulizi

🔗Mfano

🔗Ufungaji

🔗Huduma

🔗Kuchangia

🔗$baseUrl

🔗$baseParameterMapping

🔗$additionalParameters

🔗$defaultParameters

🔗prepareAttributes()

🔗Mwongozo wa Msaada

🔗Msaada Unaotolewa na Jumuiya

🔗Mende na Uthamini wa Vipengele