U prethodnom članku, govorili smo o osnovama mapiranja kratkih kodova (shortcode) i o tome kako možete iskoristiti njegove sjajne prednosti. Odlučili smo da podelimo članak koji predstavlja Page Builder Sandwich verziju mapiranja kratkih kodova, jer sledeći tekst može postati malo više tehnički.
U nastavku se nalaze detaljniji opisi unutrašnjeg funkcionisanja naše funkcije mapiranja kratkih kodova i načina na koji smo je osposobili za rad.
Automatizovani proces
Kako bismo odlučili koje dodatke (plugins) da uključimo u maper kratkih kodova, napravili smo automatizovanu skriptu koja prikuplja najbolje dodatke u WordPress direktorijumu dodataka na osnovu sledećih kriterijuma:
- Među 1.000 popularnih, najbolje ocenjenih i ažuriranih dodataka,
- Sa najmanje 4.000 aktivnih instalacija,
- Sa najmanje 20 ocena, i;
- Sa prosečnom ocenom od najmanje 3 zvezdice
Ovaj upit pokrećemo svakodnevno prema WordPress direktorijumu dodataka. Ovi filteri osiguravaju da dobijemo listu kvalitetnih dodataka koje koristi veliki broj ljudi. U vreme pisanja ovog teksta, ovi kriterijumi su dali rezultat od 800 dodataka. To je zaista mnogo. Baš, baš mnogo.
Zatim pokrećemo niz automatizovanih provera izvornog koda svakog dodatka kako bismo otkrili da li sadrži kratke kodove, a zatim pokušavamo da pronađemo sve te kratke kodove, uključujući sve njihove atribute. Obradom podataka došlo se do preko 2.000 kratkih kodova. Dvostruko „vau“. Detektovani kratki kodovi se zatim unose u bazu podataka za mapiranje kratkih kodova radi ručne provere.
Na kraju ovog procesa, imali bismo ogromnu listu dodataka i njihovih potencijalnih kratkih kodova. Sada je preostalo samo da se ti podaci očiste kako bi se osiguralo da je sve ispravno.
Ručni proces
Ovo je verovatno najteži deo celog sistema mapiranja. Kod dodataka dolazi u različitim oblicima i veličinama, pa naše skripte ne prepoznaju automatski sve kratke kodove. Iako WordPress Codex navodi da treba koristiti funkciju `shortcode_atts` za filtriranje atributa kratkog koda, ovo je samo preporuka i ne pridržavaju je se svi. Takođe ne postoji siguran način da se proveri unutrašnjost kratkog koda kada je dodatak instaliran.
Da bismo se uverili da smo tačno obuhvatili sve kratke kodove i njihove atribute, napravili smo korisnički interfejs (front end) posvećen uređivanju kratkih kodova i atributa, koji je izgrađen pomoću AngularJS i Bootstrap alata.
Moraćemo ručno da prođemo kroz svaki pojedinačni dodatak, proverimo njihovu dokumentaciju o kratkim kodovima i osiguramo da su svi podaci koje imamo tačni.
Iako je ovo mukotrpno i naporno, postoje neke svetle tačke automatizovanog procesa:
- Prema našim ranim statistikama, samo oko 1 od svaka 2 dodatka ima kratke kodove.
- Polovina detektovanih kratkih kodova nema atribute (ali deo toga mogu biti lažno pozitivni rezultati).
- Uzimanjem samo kvalitetnih dodataka, velika je verovatnoća da oni imaju dokumentaciju o kratkim kodovima.
Tek kada se provere svi kratki kodovi jednog dodatka, server počinje da distribuira mapiranja kratkih kodova tog dodatka korisnicima.
REST API poziv
Poslednji deo slagalice je sam dodatak. Koncept je ovde jednostavan: saznajte koji su dodaci aktivni, koju temu sajt koristi i koji su kratki kodovi dostupni, a zatim upitajte bazu podataka za mapiranje kratkih kodova da li poseduje mapiranja. U tu svrhu napravili smo prilagođenu WP REST API krajnju tačku (endpoint) koju svi klijenti kontaktiraju kako bi preuzeli svoja najnovija mapiranja kratkih kodova.
Budućnost: Grupno angažovanje (Crowdsourcing)
Ručna provera svakog dodatka zahteva mnogo vremena i truda. Kada platforma za mapiranje kratkih kodova postane stabilna, planiramo da omogućimo svima pristup mapiranju kratkih kodova. To znači da svako može pomoći u dodavanju kratkih kodova.
Možda razmišljate: „zašto bih pomagao u mapiranju kratkih kodova? Šta ja imam od toga?“ Pa, nekoliko razloga pada na pamet zašto bi ljudi želeli da pomognu:
- Ako ste kreirali dodatak, a mi ga još nismo obuhvatili zbog gorenavedenih kriterijuma (a nalazi se u WordPress direktorijumu dodataka), onda možete sami dodati mapiranja. Vaš dodatak bi postao u potpunosti podržan od strane PBS-a!
- Budući da ćemo se u automatizovanom procesu baviti samo dodacima iz WordPress direktorijuma, autori premijum dodataka i tema neće biti uključeni. Dakle, ako imate neki od njih, možete takođe uneti vaša mapiranja kratkih kodova za njih.
- A za one koji nisu kreatori dodataka, možemo nagraditi one koji pomažu. Da bi mapiranje kratkih kodova postalo privlačan poduhvat, možemo nagraditi vredne pomagače ličnom licencom ili nadogradnjom na premijum licencu za PBS!
Prijavite se na naš bilten
Funkcionalnost mapiranja kratkih kodova biće okvirno dostupna našim korisnicima 12. avgusta 15. avgusta 16. avgusta 2016. godine. Neće svi kratki kodovi biti mapirani do tog trenutka (naša procena je možda oko 100 dodataka), ali mapiranje će se vršiti neprekidno i korisnici će ih dobijati čim se novi pojave.
Prijavite se na naš bilten da biste saznali novosti o mapiranju kratkih kodova, kada ćemo ga objaviti i kada ćemo ga otvoriti za javnost!