Nell’articolo precedente, abbiamo discusso le basi della mappatura degli shortcode e di come accedere ai suoi fantastici vantaggi. Abbiamo deciso di dividere l’articolo dedicato alla versione di Page Builder Sandwich della mappatura degli shortcode, poiché la trattazione seguente potrebbe diventare un po’ più tecnica.
Di seguito sono riportate descrizioni più approfondite del funzionamento interno della nostra funzionalità di mappatura degli shortcode e di come l’abbiamo fatta funzionare.
Un processo automatizzato
Per decidere quali plugin includere nel mappatore di shortcode, abbiamo creato uno script automatizzato che raccoglie i migliori plugin nella directory dei plugin di WordPress in base ai seguenti criteri:
- Tra i 1.000 plugin popolari, più votati e aggiornati, con almeno 4.000 installazioni attive,
- Con almeno 4.000 installazioni attive,
- Con almeno 20 valutazioni, e;
- Con una valutazione media di almeno 3 stelle
Eseguiamo questa query ogni giorno sulla directory dei plugin di WordPress. Questi filtri assicurano di ottenere un elenco di plugin di buona qualità utilizzati da molte persone. Al momento della stesura di questo articolo, questi criteri hanno prodotto 800 plugin. Sono tantissimi. Davvero tanti.
Eseguiamo poi una serie di controlli automatizzati sul codice sorgente di ciascun plugin per scoprire se contiene shortcode, e quindi cerchiamo di individuare tutti quegli shortcode, inclusi tutti i loro attributi. Elaborando i dati, il risultato è stato di oltre 2.000 shortcode. Doppio wow. Gli shortcode rilevati vengono quindi inseriti nel database di mappatura degli shortcode per un’ispezione manuale.
Alla fine di questo processo, otteniamo un enorme elenco di plugin e dei loro possibili shortcode. Ora si tratta solo di ripulire questi dati per assicurarsi che tutto sia corretto.
Un processo manuale
Questa è probabilmente la parte più difficile dell’intero sistema di mappatura. Il codice dei plugin si presenta in forme e dimensioni diverse, e non tutti gli shortcode vengono rilevati automaticamente dai nostri script. Anche se il Codex di WordPress suggerisce di usare la funzione `shortcode_atts` per filtrare gli attributi di uno shortcode, questa è solo una raccomandazione e non tutti lo fanno. Inoltre, non esiste un modo infallibile per controllare la struttura interna di uno shortcode quando un plugin è installato.
Per assicurarci quindi di individuare correttamente tutti gli shortcode e i loro attributi, abbiamo creato un’area front-end dedicata alla modifica di shortcode e attributi, realizzata con AngularJS e Bootstrap.
Dovremo esaminare manualmente ogni singolo plugin, controllarne la documentazione degli shortcode e assicurarci che tutti i dati in nostro possesso siano corretti.
Anche se questo processo è estremamente noioso, ci sono alcuni lati positivi nell’avere un processo automatizzato:
- Secondo le nostre prime statistiche, solo circa 1 plugin su 2 ha shortcode.
- La metà degli shortcode rilevati non ha attributi (ma una parte di questi potrebbero essere falsi positivi)
- Selezionando solo plugin di buona qualità, molto probabilmente questi dispongono di una documentazione per gli shortcode
Solo quando tutti gli shortcode di un plugin saranno stati controllati, il server inizierà a distribuire le mappature degli shortcode di quel plugin agli utenti.
Una chiamata REST API
L’ultimo tassello del puzzle è il plugin stesso. Il concetto qui è semplice: scoprire quali plugin sono attivi, quale tema sta utilizzando il sito e quali shortcode sono disponibili, quindi chiedere al database di mappatura degli shortcode se contiene le relative mappature. Per questo abbiamo creato un endpoint WP REST API personalizzato che tutti i client contattano per ottenere le mappature degli shortcode più recenti.
Il futuro: Crowdsourcing
Controllare manualmente ciascun plugin richiede molto tempo e impegno. Una volta che la piattaforma di mappatura degli shortcode sarà stabile, prevediamo di aprirla a tutti. Ciò significa che chiunque potrà contribuire ad aggiungere shortcode.
Potreste pensare: “Perché dovrei aiutare a mappare gli shortcode? Cosa ci guadagno?” Beh, vengono in mente alcune ragioni per cui le persone vorrebbero dare una mano:
- Se hai creato un plugin e non l’abbiamo ancora intercettato a causa dei criteri sopra indicati (ed è nella directory dei plugin di WordPress), puoi aggiungere tu stesso le mappature. Il tuo plugin diventerà completamente supportato da PBS!
- Dato che nel processo automatizzato gestiremo solo quelli presenti nella directory dei plugin di WordPress, gli autori di plugin e temi premium non saranno inclusi. Quindi, se ne hai uno, puoi aggiungere tu stesso le mappature degli shortcode anche per quelli.
- E per chi non crea plugin, possiamo ricompensare chi ci aiuta. Per rendere la mappatura degli shortcode un’iniziativa allettante, possiamo premiare i volenterosi aiutanti con una licenza personale o un passaggio a una licenza premium di PBS!
Iscriviti alla nostra newsletter
La funzionalità di mappatura degli shortcode sarà disponibile per i nostri clienti indicativamente il 12 agosto 15 agosto 16 agosto 2016. Non tutti gli shortcode saranno mappati entro tale data (la nostra stima è di circa 100 plugin), ma la mappatura proseguirà costantemente e i clienti la riceveranno non appena ne verranno rilasciati di nuovi.
Iscriviti alla nostra newsletter per ricevere notizie sulla mappatura degli shortcode, sulla data di rilascio e su quando apriremo la mappatura degli shortcode al pubblico!