WordPress.org

Lingue: English – Français – 日本語 (Add your language)

Dalla versione 2.5 WordPress supporta i cosiddetti Shortcodes. Sono stati introdotti per creare macro da utilizzare nel contenuto di un post. Per esempi di shortcodes e come usarli, vedi WordPress.com Shortcodes, anche se alcuni shortcodes presenti lì sono esclusivi di WordPress.com.

Un banale shortcode per una galleria appare così:

Gli shortcode possono anche essere usati con attributi aggiuntivi come mostra il seguente esempio:

Entrambi gli esempi visualizzeranno una galleria di immagini, che sarebbe difficile da mantenere quando si scrive il markup HTML per essa e lo si tiene sincronizzato con le immagini caricate. Usando uno shortcode, il markup per la galleria sarà creato dinamicamente e automaticamente.

Built-In and Additional Shortcodes

WordPress offre alcuni shortcodes di default (per esempio quello della galleria) e i plugin possono aggiungere i loro tramite la Shortcode API.

I seguenti shortcode sono inclusi in WordPress:

Escaping Shortcodes

A volte potresti voler usare il testo che solitamente rappresenta uno shortcode nei tuoi post. Per fare questo, devi fare l’escape dello shortcode usando due serie di parentesi invece di una sola. Quindi per visualizzare questo nel tuo post:

Scriveresti questo:

]

Per gli shortcode che hanno un tag iniziale e uno finale, hai solo bisogno di sfuggire alla prima e all’ultima parentesi:

 ... ]

Nota che solo gli shortcodes che sono attualmente disponibili possono essere nascosti in questo modo. Usando le doppie parentesi attorno al testo che non è attualmente registrato come shortcode, entrambe le serie di parentesi saranno visualizzate nel tuo post, non solo una come quando si fa l’escape degli shortcode registrati.

Shortcodes in Widgets

Per default, WordPress non supporta gli shortcodes nei Sidebar Widgets fino alla 4.9. Espande solo gli shortcode all’interno del contenuto di un post, di una pagina o di un tipo di post personalizzato. Per aggiungere il supporto degli shortcode ai widget della sidebar, potete installare un plugin, usare il codice qui sotto, o rivedere Widget Improvements in 4.9:

add_filter( 'widget_text', 'shortcode_unautop' );add_filter( 'widget_text', 'do_shortcode' );

È importante che queste linee siano aggiunte in questo ordine. La prima linea impedisce a WordPress di trasformare le interruzioni di riga in tag di paragrafo, poiché questo impedisce agli shortcode di funzionare. La seconda linea è quella che fa funzionare gli shortcodes.

Shortcodes per i plugin mancanti (nomi non registrati)

Al di fuori degli shortcodes incorporati tutti gli altri sono aggiunti attraverso i plugin. Se il plugin che fornisce un dato shortcode è mancante o disattivato, WordPress tratterà l’intero shortcode, i suoi attributi e il contenuto al suo interno come normale testo semplice e conserverà i caratteri speciali nell’HTML di uscita.

Yay!

<Yay>

<(^_^)>

<(^_^)> -- Yay!

<(^_^<) -- <Yay>

Yay!

<Yay>