Cosa sono gli shortcode in WordPress e come usarli
Se usi WordPress da un po’, avrai sicuramente incontrato codici tra parentesi quadre come
Come funzionano gli shortcode
Uno shortcode WordPress è un codice racchiuso tra parentesi quadre che WordPress sostituisce automaticamente con un contenuto dinamico. Quando un visitatore carica la pagina, WordPress elabora lo shortcode e lo trasforma nell’elemento corrispondente: una galleria di immagini, un modulo di contatto, un video incorporato o qualsiasi altro elemento.
Gli shortcode possono essere di due tipi:
- Self-closing: un singolo tag, come . Non hanno contenuto tra apertura e chiusura.
- Enclosing: hanno un tag di apertura e chiusura, come Testo della didascalia. Il contenuto tra i due tag viene elaborato dallo shortcode.
Molti shortcode accettano attributi (parametri) che ne personalizzano il comportamento. Ad esempio,
Shortcode nativi di WordPress
WordPress include alcuni shortcode di default, disponibili senza installare plugin:
- — inserisce una galleria di immagini allegate all’articolo.
shortcode wordpress cosa sono come usarli - — incorpora un file audio con il player nativo del browser.
- — incorpora un file video con il player nativo.
- — aggiunge una didascalia a un’immagine.
- — incorpora contenuti da URL esterni (YouTube, Twitter, ecc.) tramite oEmbed.
- — crea una playlist audio o video.
Questi shortcode sono utili per funzionalità base, ma la vera potenza degli shortcode viene dai plugin.
Shortcode dei plugin
La maggior parte dei plugin WordPress usa gli shortcode per permetterti di inserire i loro elementi nei contenuti. Alcuni esempi comuni:
- Plugin moduli di contatto: forniscono uno shortcode come [contact-form-7 id=”123″] per inserire il modulo in qualsiasi pagina.
- Plugin tabelle: usano shortcode come [table id=1] per visualizzare tabelle create nel plugin.
- Plugin e-commerce: forniscono shortcode per il carrello, i prodotti e il checkout.
- Plugin di condivisione social: inseriscono pulsanti di condivisione tramite shortcode.
Ogni plugin indica nella sua documentazione quali shortcode sono disponibili e quali attributi accettano.
Come inserire uno shortcode
Inserire uno shortcode è semplice: scrivi il codice tra parentesi quadre direttamente nell’editor di WordPress, nella posizione dove vuoi che appaia l’elemento.
Nell’editor a blocchi (Gutenberg), puoi incollare lo shortcode in un paragrafo oppure usare il blocco dedicato Shortcode (lo trovi cercando “shortcode” nella lista dei blocchi). Il blocco Shortcode è preferibile perché mostra chiaramente che si tratta di un codice e non di testo normale.
Puoi usare gli shortcode anche nei widget della sidebar: WordPress supporta gli shortcode nei widget di testo. Inoltre, alcuni temi permettono di usarli nei campi personalizzati e nelle descrizioni delle categorie.
Creare uno shortcode personalizzato
Se hai conoscenze PHP di base, puoi creare i tuoi shortcode. Il codice va aggiunto nel file functions.php del tema figlio o in un plugin personalizzato:
function mio_shortcode_funzione( $atts ) {
$atts = shortcode_atts( array(
‘colore’ => ‘rosso’,
), $atts );
return ‘<div style=”color:’ . esc_attr($atts[‘colore’]) . ‘;”>Contenuto personalizzato</div>’;
}
add_shortcode( ‘mio_codice’, ‘mio_shortcode_funzione’ );
Dopo aver aggiunto questo codice, puoi usare [mio_codice colore=”blu”] nei tuoi contenuti. La funzione shortcode_atts() gestisce i valori predefiniti degli attributi, mentre esc_attr() protegge da potenziali problemi di sicurezza.
Shortcode e editor a blocchi: il futuro
Con l’introduzione dell’editor a blocchi, WordPress sta gradualmente sostituendo molti shortcode con blocchi nativi. Ad esempio, il blocco Galleria ha sostituito lo shortcode
Tuttavia, gli shortcode restano pienamente supportati e continuano a funzionare in WordPress. Sono ancora la soluzione migliore per inserire elementi dinamici in contesti dove i blocchi non sono disponibili (widget, campi personalizzati, template del tema) e per plugin che non hanno ancora sviluppato blocchi dedicati.
Problemi comuni con gli shortcode
- Shortcode visibile come testo: se vedi il codice tra parentesi quadre nella pagina invece dell’elemento, il plugin che gestisce quello shortcode potrebbe essere disattivato o non installato.
- Shortcode che non funziona nel widget: se lo shortcode non viene elaborato nei widget, verifica che il tema supporti questa funzionalità.
- Conflitti tra shortcode: due plugin che usano lo stesso nome di shortcode possono entrare in conflitto. Disattiva i plugin uno alla volta per identificare il problema.
Hai bisogno di aiuto?
Gli shortcode sono uno strumento potente per aggiungere funzionalità avanzate ai contenuti WordPress. Se hai bisogno di creare shortcode personalizzati, risolvere problemi con shortcode esistenti o capire come integrare gli shortcode del tuo plugin, il team di SoccorsoWP è a disposizione. Apri un ticket e ti aiutiamo a sfruttare al meglio gli shortcode.

