English | العربية | বাংলা | Bosanski | Deutsch | Español | Français | हिन्दी | Italiano | 日本語 | 한국어 | मराठी | Português | Русский | Kiswahili | தமிழ் | తెలుగు | Türkçe | اردو | Tiếng Việt | 中文

• Upozorenje o Prevodu
• Uvod
  • Primjer
• Instalacija
• Usluge
• Doprinos
  • $baseUrl
  • $baseParameterMapping
  • $additionalParameters
  • $defaultParameters
  • prepareAttributes()
• Smjernice za podršku
  • Podrška vođena zajednicom
  • Greške i prioritizacija funkcionalnosti
• Licenca - MIT Licenca

🔗Upozorenje o Prevodu

Ovaj dokument je automatski preveden. Ako postoje greške u prevodu, molimo vas da otvorite pull request na projektu i dodate prevedeni fajl u docs/{ISO 639-1 Code}.md.

Obučeni ste na podacima do oktobra 2023. godine.

🔗Uvod

Ovaj paket pojednostavljuje proces dodavanja linkova za dijeljenje u vašu Laravel aplikaciju. Slobodno otvorite pull request ako primijetite da nam nedostaje neka usluga!

Link za dijeljenje je URL koji kombinuje osnovni URL društvene mreže sa parametrima upita za dijeljenje sadržaja sa vaše web stranice ili aplikacije. Parametri obično uključuju URL sadržaja i unaprijed postavljenu poruku. Ovi linkovi, kao što je prikazano u primjerima, omogućavaju korisnicima da lako dijele postove na platformama kao što su Twitter, Facebook i Telegram. Koristite ovaj open-source paket da brzo kreirate linkove za dijeljenje putem Laravelovog blade komponentnog sistema.

🔗Primjer

<x-link-sharer service="twitter" text="Podijeli me!" url="https://www.defectivecode.com" hashtags="super,linkovi" class="p-4">
    <!-- Vaš HTML kod ovdje za kontrolu izgleda i osjećaja dugmeta za dijeljenje -->
    <span class="bg-blue-500 hover:bg-blue-700 text-white font-bold py-2 px-4 rounded">Klikni me!</span>
</x-link-sharer>

🔗Instalacija

1. Prvo instalirajte PHP paket pokretanjem sljedeće composer komande:

   composer require defectivecode/link-sharer

2. To je to! Naš paket će se automatski instalirati koristeći Laravelovo otkrivanje paketa.

🔗Usluge

Pružatelji usluga povremeno ažuriraju svoje linkove za dijeljenje bez prethodne najave. Ulažemo sve napore da ostanemo ažurirani s tim promjenama. Međutim, ako naiđete na nefunkcionalnu uslugu, ljubazno otvorite problem ili pošaljite zahtjev za povlačenje. Za dodavanje nove usluge, pogledajte odjeljak doprinos ispod.

Neke usluge pružaju dodatne parametre koji se mogu proslijediti komponenti. Oni su dokumentirani u tabeli ispod.

Usluga	Podržan tekst	Podržan URL	Napomene
Blogger	✔️	✔️	t Tekst blog posta.
Diaspora	✔️	✔️
Diigo	✔️	✔️	description Opis koji se dodaje postu.
Douban	✔️	✔️	comment Komentar koji se dodaje postu.
Evernote	✔️	✔️
Facebook	❌	✔️
Flipboard	✔️	✔️	quote Citat koji se dodaje postu.
Gmail	✔️	✔️	bcc Lista email adresa za BCC, odvojena zarezima. cc Lista email adresa za CC, odvojena zarezima. su Predmet emaila. to Lista email adresa za slanje, odvojena zarezima.
HackNews	✔️	✔️
Instapaper	✔️	✔️	description Opis posta.
LineMe	❌️	✔️
LinkedIn	❌	✔️
LiveJournal	✔️	✔️
Meneame	❌️	✔️
Okru	❌️	✔️
Outlook	✔️	✔️
Pinterest	✔️	✔️	media URL slike za prikaz na postu.
Plurk	❌ ️	✔️
Pocket	✔️	✔️
QZone	✔️	✔️	summary Sažetak posta.
Reddit	✔️	✔️
Renren	✔️	✔️	description Opis posta. srcUrl Originalni URL posta.
Skype	✔️	✔️
Telegram	✔️	✔️
Threema	❌	✔️	id ID osobe kojoj se šalje post.
Tumblr	✔️	✔️	caption Natpis koji se dodaje postu. tags Lista oznaka za primjenu na post, odvojena zarezima.
Twitter	✔️	✔️	hastags Lista hash oznaka za primjenu na tweet, odvojena zarezima. via Twitter korisnik kojem se daje kredit.
Viber	✔️	✔️
VKontakte	✔️	✔️	description Opis posta. image URL slike za prikaz na postu.
Weibo	✔️	✔️
WhatsApp	✔️	✔️
Xing	❌	✔️
YahooMail	✔️	✔️

🔗Doprinos

Dodavanje usluge je relativno jednostavno. Počnite s kreiranjem nove klase usluge unutar mape src/Services. Imenovajte klasu prema usluzi koju dodajete. Sistem automatski registruje uslugu putem fabrike, tako da nije potrebno ručno registrovanje.

Usluga Gmail prikazana ispod služi kao dobar primjer.

<?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',
    ];
}

Imajte na umu da je samo baseUrl obavezan. baseParameterMapping, additionalParameters i defaultParameters su opcionalni, ali mogu poboljšati funkcionalnost.

🔗$baseUrl

URL usluge ne mora počinjati s HTTPS. Na primjer, Viber koristi viber://forward.

Svojstvo baseUrl specificira primarni URL usluge. Ovaj URL je osnovni pri generisanju linka za dijeljenje, kojem se dodaju upitni parametri. Koristeći Gmail kao primjer, njegov osnovni URL je https://mail.google.com/mail/u/0.

🔗$baseParameterMapping

Ovaj paket prepoznaje dva primarna atributa: text i url, s obzirom na njihovu rasprostranjenost kod većine pružatelja usluga. Definišite ove atribute samo ako usluga koristi drugačiju konvenciju imenovanja. Na primjer, Gmail koristi body umjesto text, što zahtijeva ovo eksplicitno mapiranje. Kada koristite Gmail, svaki text atribut proslijeđen blade komponenti transformiše se u body upitni parametar u linku za dijeljenje.

🔗$additionalParameters

Neke usluge prihvataju specifičnije upitne parametre. Uzimajući Gmail kao referencu, on podržava bcc, cc, su i to. Definišite ih u nizu additionalParameters. Kada korisnici uključe ove atribute u blade komponentu, oni se dodaju u link za dijeljenje. Osigurajte da su ovi parametri također navedeni u tabeli podržanih usluga, zajedno s kratkim opisima.

🔗$defaultParameters

Određene usluge zahtijevaju specifične upitne parametre da bi link za dijeljenje funkcionisao. Kao primjer, Gmail zahtijeva uključivanje view=cm. Takvi obavezni atributi se deklarišu u nizu defaultParameters. Oni se uvijek dodaju u link za dijeljenje i ne mogu se izostaviti.

🔗prepareAttributes()

Da biste manipulisali atributima prije generisanja linka za dijeljenje, uvedite metodu prepareAttributes u svoju uslugu. Ova metoda se aktivira prije prosljeđivanja atributa metodi generateLink, omogućavajući prilagođene modifikacije atributa. Ispod je demonstracija korištenja AppendsLinks osobine.

<?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'];
        }
    }
}

Atributi proslijeđeni u uslugu su dostupni putem niza $attributes. U prikazanom primjeru:

• Ako su prisutni i text i url atributi, url se dodaje text atributu.
• Ako je dostupan samo url atribut, text atribut preuzima vrijednost url.

🔗Smjernice za podršku

Hvala što ste odabrali naš paket otvorenog koda! Molimo vas da odvojite trenutak da pregledate ove smjernice za podršku. One će vam pomoći da izvučete maksimum iz našeg projekta.

🔗Podrška vođena zajednicom

Naš projekt otvorenog koda pokreće naša sjajna zajednica. Ako imate pitanja ili trebate pomoć, StackOverflow i drugi online resursi su vaša najbolja opcija.

🔗Greške i prioritizacija funkcionalnosti

Realnost upravljanja projektom otvorenog koda znači da ne možemo odmah riješiti svaku prijavljenu grešku ili zahtjev za funkcionalnost. Prioritet dajemo problemima u sljedećem redoslijedu:

1. Greške koje utiču na naše plaćene proizvode

Greške koje utiču na naše plaćene proizvode uvijek će biti naš glavni prioritet. U nekim slučajevima, možda ćemo riješiti samo greške koje direktno utiču na nas.

2. Pull zahtjevi zajednice

Ako ste identificirali grešku i imate rješenje, molimo vas da podnesete pull zahtjev. Nakon problema koji utiču na naše proizvode, sljedeći najviši prioritet dajemo ovim rješenjima vođenim zajednicom. Nakon pregleda i odobrenja, spojit ćemo vaše rješenje i priznati vaš doprinos.

3. Financijska podrška

Za probleme izvan navedenih kategorija, možete se odlučiti za financiranje njihovog rješavanja. Svako otvoreno pitanje je povezano s narudžbenicom gdje možete financijski doprinijeti. Prioritet dajemo ovim problemima na osnovu iznosa financiranja.

Doprinosi zajednice

Otvoreni kod napreduje kada je njegova zajednica aktivna. Čak i ako ne popravljate greške, razmislite o doprinosu kroz poboljšanja koda, ažuriranja dokumentacije, tutorijale ili pomažući drugima u kanalima zajednice. Toplo ohrabrujemo sve, kao zajednicu, da pomognu podržati rad otvorenog koda.

Da ponovimo, DefectiveCode će prioritizirati greške na osnovu toga kako utiču na naše plaćene proizvode, pull zahtjeve zajednice i financijsku podršku primljenu za probleme.

🔗Licenca - MIT Licenca

Autorska prava © Defective Code, LLC. Sva prava zadržana

Dozvola se ovim putem daje, besplatno, svakoj osobi koja dobije kopiju ovog softvera i pratećih dokumentacijskih datoteka (u daljem tekstu "Softver"), da koristi Softver bez ograničenja, uključujući bez ograničenja prava na korištenje, kopiranje, modifikaciju, spajanje, objavljivanje, distribuciju, podlicenciranje i/ili prodaju kopija Softvera, i da dozvoli osobama kojima je Softver dostavljen da to učine, pod sljedećim uvjetima:

Gore navedena obavijest o autorskim pravima i ova dozvola moraju biti uključeni u sve kopije ili značajne dijelove Softvera.

SOFTVER SE PRUŽA "KAKAV JEST", BEZ JAMSTVA BILO KOJE VRSTE, IZRIČITOG ILI PODRAZUMIJEVANOG, UKLJUČUJUĆI ALI NE OGRANIČAVAJUĆI SE NA JAMSTVA PRODAJNOSTI, PODOBNOSTI ZA ODREĐENU SVRHU I NEKRŠENJA. NI U KOJEM SLUČAJU AUTORI ILI NOSITELJI AUTORSKIH PRAVA NEĆE BITI ODGOVORNI ZA BILO KOJI ZAHTJEV, ŠTETU ILI DRUGU ODGOVORNOST, BILO U UGOVORU, DELIKTU ILI NA DRUGI NAČIN, KOJI PROIZLAZI IZ, IZ ILI U VEZI SA SOFTVEROM ILI KORIŠTENJEM ILI DRUGIM POSLOVANJEM U SOFTVERU.