Aty ku gjërat bëhen pak teknike: Si e bëmë realitet versionin tonë të hartëzimit të kodeve të shkurtra (Shortcode Mapping)

Shkruar nga

në

,

How-We-Made-Our-Version-Of-Shortcode-Mapping-Happen-2Në artikullin e mëparshëm, diskutuam mbi bazat e hartëzimit të shortcode-ve dhe se si mund të përfitoni nga avantazhet e tij të shkëlqyera. Kemi vendosur ta ndajmë artikullin që paraqet versionin e Page Builder Sandwich për Hartëzimin e Shortcode-ve, pasi shkrimi në vijim mund të bëhet pak më teknik.

Më poshtë gjenden përshkrime më të hollësishme mbi funksionimin e brendshëm të veçorisë sonë të hartëzimit të shortcode-ve, dhe se si e bëmë të funksionojë.

Një Proces i Automatizuar

Për të vendosur se cilat shtojca të përfshihen në hartëzuesin e shortcode-ve, ndërtuam një skript të automatizuar që mbledh shtojcat kryesore në drejtorinë e shtojcave të WordPress bazuar në kriteret e mëposhtme:

  • Brenda 1,000 shtojcave më të njohura, më të vlerësuara dhe të përditësuara, Me të paktën 4,000 instalime aktive,
  • Me të paktën 4,000 instalime aktive,
  • Me të paktën 20 vlerësime, dhe;
  • Me të paktën një vlerësim mesatar prej 3 yjesh

Ne e ekzekutojmë këtë kërkim çdo ditë në drejtorinë e shtojcave të WordPress. Këta filtra sigurojnë që të marrim një listë shtojcash me cilësi të mirë që shumë njerëz i përdorin. Gjatë kohës që u shkrua kjo, ky kriter rezultoi në 800 shtojca. Kjo është shumë. Me të vërtetë shumë.

Disa nga shtojcat më të njohura të zbuluara për hartëzimin e shortcode-ve.
Disa nga shtojcat më të njohura të zbuluara për hartëzimin e shortcode-ve.

Më pas kryejmë një seri kontrollesh të automatizuara në kodin burimor të çdo shtojce për të zbuluar nëse përmban ndonjë shortcode, dhe më pas përpiqemi të gjejmë të gjitha ato shortcode, përfshirë të gjitha atributet e tyre. Pas përpunimit të të dhënave, kjo rezultoi në mbi 2,000 shortcode. Dyfish uau. Shortcode-et e zbuluara futen më pas në bazën e të dhënave të hartëzimit të shortcode-ve për shqyrtim manual.

Në fund të këtij procesi, do të kishim një listë të madhe shtojcash dhe cilat janë shortcode-et e tyre të mundshme. Tani mbetet vetëm pastrimi i këtyre të dhënave për t’u siguruar që gjithçka është e saktë.

Një Proces Manual

Kjo është ndoshta pjesa më e vështirë e të gjithë sistemit të hartëzimit. Kodi i shtojcave vjen në forma dhe madhësi të ndryshme, jo të gjitha shortcode-et zbulohen automatikisht nga skriptet tona. Edhe pse WordPress Codex thotë të përdoret funksioni `shortcode_atts` për të filtruar atributet e një shortcode-i, ky është vetëm një rekomandim dhe jo të gjithë e zbatojnë. Gjithashtu nuk ka një mënyrë të pagabueshme për të kontrolluar përmbajtjen e brendshme të një shortcode-i kur instalohet një shtojcë.

Për t’u siguruar që të marrim saktë të gjitha shortcode-et dhe atributet e tyre, krijuam një zonë në front end të dedikuar për redaktimin e shortcode-eve dhe atributeve, e ndërtuar duke përdorur AngularJS dhe Bootstrap.

Ndërfaqja Bootstrap & AngularJS për rregullimin e të gjitha shortcode-eve të hartëzuara.
Ndërfaqja Bootstrap & AngularJS për rregullimin e të gjitha shortcode-eve të hartëzuara.

Do të duhet të kalojmë manualisht nëpër çdo shtojcë dhe të kontrollojmë dokumentacionin e shortcode-eve të tyre për t’u siguruar që të gjitha të dhënat që kemi janë të sakta.

Edhe pse kjo është tejet e lodhshme, ka disa anë pozitive të pasurit një proces të automatizuar:

  • Sipas statistikave tona fillestare, vetëm rreth 1 në çdo 2 shtojca ka shortcode.
  • Gjysma e shortcode-eve të zbuluara nuk kanë atribute (por një pjesë e kësaj mund të jenë pozitive false)
  • Duke marrë vetëm shtojca cilësore, ka shumë të ngjarë që ato të kenë dokumentacion për shortcode

Kur të jenë kontrolluar të gjitha shortcode-et e një shtojce, vetëm atëherë serveri do të fillojë shpërndarjen e hartëzimeve të shortcode-eve të asaj shtojce tek përdoruesit.

Një Thirrje Rest API

Pjesa e fundit e enigmës është vetë shtojca. Koncepti këtu është i thjeshtë: zbuloni cilat shtojca janë aktive, cilën temë po përdor faqja dhe cilat shortcode janë të disponueshme, pastaj pyesni bazën e të dhënave të hartëzimit të shortcode-ve nëse ka hartëzime. Për këtë krijuam një pikë fundore të personalizuar të WP REST API me të cilën komunikojnë të gjithë klientët për të marrë hartëzimet më të fundit të shortcode-eve.

E Ardhmja: Crowdsourcing

Kontrolli manual i çdo shtojce kërkon shumë kohë dhe përpjekje. Pasi platforma e hartëzimit të shortcode-ve të jetë e qëndrueshme, planifikojmë ta hapim hartëzimin e shortcode-ve për të gjithë. Kjo do të thotë që të gjithë mund të ndihmojnë në shtimin e shortcode-eve.

Ju mund të mendoni: “Pse duhet të ndihmoj në hartëzimin e shortcode-eve? Çfarë fitoj unë nga kjo?” Epo, disa arsye vijnë në mendje se pse njerëzit do të dëshironin të ndihmonin:

  1. Nëse keni krijuar një shtojcë dhe ne nuk e kemi përfshirë ende për shkak të kritereve të mësipërme (dhe ajo ndodhet në drejtorinë e shtojcave të WordPress), atëherë mund t’i shtoni vetë hartëzimet. Shtojca juaj do të mbështetet plotësisht nga PBS!
  2. Duke qenë se në procesin e automatizuar do të merremi vetëm me ato në drejtorinë e shtojcave të WordPress, autorët e shtojcave dhe temave premium nuk do të përfshihen. Pra, nëse keni një të tillë, mund të shtoni gjithashtu hartëzimet tuaja të shortcode-eve për to.
  3. Dhe për ata që nuk krijojnë shtojca, ne mund t’i shpërblejmë ata që ndihmojnë. Për ta bërë hartëzimin e shortcode-eve një përpjekje joshëse, ne mund t’i shpërblejmë ndihmuesit e zellshëm me një licencë personale ose me një përmirësim në një licencë premium të PBS!

Regjistrohuni në Buletinin Tonë

Funksionaliteti i hartëzimit të shortcode-ve do të jetë i disponueshëm paraprakisht për klientët tanë më 12 gusht  15 gusht  16 gusht 2016. Jo të gjitha shortcode-et do të jenë hartëzuar deri në këtë kohë (vlerësimi ynë është ndoshta 100 shtojca), por hartëzimi do të bëhet vazhdimisht dhe klientët do t’i marrin ato sapo të dalin të rejat.

Regjistrohuni në buletinin tonë për të marrë lajme mbi hartëzimin e shortcode-ve, kur do ta publikojmë dhe kur do ta hapim hartëzimin e shortcode-ve për publikun!