Gli shortcode sono uno dei punti di forza di WordPress. Gli shortcode sono il ponte tra sviluppatori e creatori di siti, consentendo alle persone di inserire contenuti elaborati quasi ovunque desiderino. I creatori di plugin adorano gli shortcode poiché consentono una maggiore flessibilità nel modo e nel luogo in cui i loro utenti visualizzano i propri contenuti.
Se non sai cosa siano gli shortcode e come si presentano, sono quei frammenti di testo dall’aspetto arcaico racchiusi tra parentesi quadre. Hanno un aspetto simile a questo:
Questo in particolare è chiamato shortcode embed ed è integrato di default in WordPress. Questo specifico shortcode incorpora il video dall’URL all’interno dei tuoi contenuti. Ti basta copiare e incollare lo shortcode qui sopra nel tuo sito se vuoi fare una prova.
Dietro le quinte, ciò che accade è che quando WordPress incontra uno shortcode nei tuoi contenuti, questo viene elaborato e convertito in qualcos’altro. Nel nostro caso sopra, ogni volta che un
shortcode viene rilevato, WordPress prende l’URL nello shortcode e lo confronta con una serie di content provider supportati. Quando ne trova uno, recupera il codice di incorporamento iframe appropriato e visualizza invece quello.
Quindi qual è il problema? Sembra abbastanza semplice: basta inserire un breve testo tra parentesi e il gioco è fatto.
Entra in gioco la Shortcode API..
Shortcode in abbondanza
La Shortcode API apre la creazione degli shortcode agli sviluppatori. Grazie a ciò, gli sviluppatori possono aggiungere i propri shortcode all’interno dei loro plugin.
Questo è fantastico: ora, con un semplice snippet simile a codice (da cui il nome “shortcode”), sia i principianti che gli utenti avanzati possono inserire praticamente qualsiasi tipo di contenuto desiderino ovunque.
WordPress di default ha solo una manciata di shortcode. È facile digitarli a memoria perché ce ne sono solo pochi. Ma se installi qualche plugin, il numero di shortcode sale rapidamente a una dozzina o più, e in alcuni casi a oltre un centinaio. Ogni shortcode ha il proprio set di attributi e istruzioni su come utilizzarli. Molto probabilmente ogni plugin dispone di una sorta di documentazione su come funzionano tutti i suoi shortcode ed elenca tutti i parametri disponibili in ciascuno di essi. Ma saresti pazzo a provare a memorizzare tutti gli shortcode e i loro attributi.
Il problema è che non esiste un’area centralizzata in cui trovare tutti gli shortcode disponibili sul tuo sito e capire come usarli.
Alcuni provano a risolvere il problema
Alcuni plugin provano a risolvere questo problema presentando tutti i propri shortcode in un menu a discesa di facile accesso. Cliccando su uno di essi, viene stampato lo shortcode, completo di tutti i possibili attributi. Non c’è più bisogno di memorizzarlo, il che è una buona cosa.
Alcuni vanno oltre e aggiungono un modulo popup di impostazioni dotato di caselle di controllo e selettori di colore per compilare gli attributi dello shortcode.
Questa soluzione in parte funziona. Tuttavia, ogni plugin elenca solo i propri shortcode. Quindi, se ogni plugin crea la propria forma di selettore di shortcode, ci si ritrova inevitabilmente ad avere più selettori di shortcode sullo schermo (mi è già capitato in passato).
In altre parole, ogni plugin fa a modo suo e implementa la propria soluzione per i propri shortcode. Alcuni plugin aggiungono un nuovo pulsante accanto al pulsante “Aggiungi media”, oppure uno nuovo all’interno di TinyMCE.
Quindi ora potresti pensare: “Perché non raccogliere anche gli shortcode degli altri plugin e includerli nel menu a discesa / selettore di shortcode?”. Beh, è esattamente ciò che ho pensato anch’io. Ma è più facile a dirsi che a farsi. Spiegherò il perché tra poco, ma prima vediamo come sarebbe una soluzione ideale.
La soluzione ideale
Il piano perfetto sarebbe creare un plugin che raccolga tutti gli shortcode disponibili nel tuo sito, per poi presentarti l’elenco e aiutarti anche a compilare tutti gli attributi. E ogni volta che installi un nuovo plugin, ti verrebbero presentati anche tutti i nuovi shortcode introdotti.
Immagina un posto centrale in cui verrebbero collocati tutti i tuoi shortcode per un facile accesso. Ogni shortcode descriverebbe cosa fa e a quale plugin appartiene. Poi, per ogni attributo disponibile, immagina che ciascuno di essi abbia un’etichetta, un modo appropriato per selezionarne un valore e una descrizione. Ti verrebbero mostrati menu a discesa, selettori di colore, pulsanti radio, interruttori e quant’altro.
Una cosa del genere renderebbe la nostra vita di creatori di siti web e contenuti molto più semplice. Niente più verifiche su documentazioni diverse, o diverse sezioni della tua bacheca solo per copiare uno shortcode generato per uno slider che desideri utilizzare.
L’avvertenza
Sfortunatamente, al momento è piuttosto difficile fare qualcosa del genere. Non esiste un modo sicuro per conoscere tutti i dettagli di uno shortcode. Puoi ottenere un elenco di tutti gli shortcode, ma solo i loro tag/nomi effettivi; non puoi ottenere alcun dettaglio aggiuntivo su di essi, come un elenco di attributi, cosa fanno e i loro tipi – come una stringa, un colore o un numero. Né puoi ottenere una parvenza di descrizione per ciascun attributo.
Una nota per gli sviluppatori: sì, c’è un terzo argomento aggiunto di recente per la funzione shortcode_atts, ma non è un argomento obbligatorio. Quindi, a meno che ogni sviluppatore di plugin al mondo non lo implementi, continueremo a non avere un modo sicuro per determinare tutti gli attributi di uno shortcode.
La Shortcode API non fornisce alcuna funzionalità per aggiungere descrizioni agli shortcode, convertire i tipi di attributi o aggiungere descrizioni agli attributi. E a meno che WordPress stesso non aggiunga un’area centrale per accedere agli shortcode, dubito che questa funzionalità verrà mai creata.
Conclusione
Al momento il compito di organizzare gli shortcode è lasciato a ciascuno sviluppatore. A meno che non venga sviluppato un metodo centrale all’interno di WordPress, aspettati di continuare a vedere molteplici pulsanti “Add Shortcode” nel tuo backend. Se una cosa del genere debba essere aggiunta o meno al Core di WordPress è già di per sé un’altra enorme discussione.
Un’alternativa
Esistono plugin di page builder che affrontano questo problema in modo diverso. Invece di rilevare gli shortcode a livello di codice, dispongono di mappatori di shortcode in cui gli utenti possono inserire manualmente ogni dettaglio di uno shortcode. Una volta fatto, diventa disponibile all’interno del page builder. Sebbene questo funzioni, questi sono disponibili solo all’interno del tuo sito.
Noi di Page Builder Sandwich stiamo creando qualcosa che si spera possa risolvere questo rompicapo degli shortcode. Iscriviti alla nostra newsletter qui sotto per essere informato sui nostri progressi.