WordPress: come creare uno shortcode

Molto comodi ed intuitivi soprattutto per tenere un certo ordine all’interno della nostra pagina è l’utilizzo degli shortcode. Piccolo codice testuale che normalmente si vede nella forma: [shortcode] che viene inserito all’interno dell’editor testuale delle nostre pagine o articoli e che in base a come è configurato il codice, viene interpretato per produrre un codice html più complesso.

Un esempio molto semplice è quello di applicare per esempio un separatore all’interno della vostra pagina che si mantenga costante per tutto il sito.

Un’altro esempio è magari quello di utilizzare lo shortcode per inserire un icona personalizzata standardizzata, ma vediamo un esempio pratico:

Inserendo nel vostro editor testuale per esempio lo shortcode:

[PDF-icon]

nel vostro codice avete configurato che lo shortcode venga convertito in:

<img src=”images/pdf-icon.png” alt=”icona pdf” class=”align-left”/>

Ma vediamo come realizzare i nostri shortcode personalizzati, partendo appunta dal fine di ottenere un’icona PDF standard caricata nella cartella del vostro template.

Per prima cosa dovrete caricare l’immagine nella cartella, o in una sottocartella del vostro template.

Successivamente aprire il vostro file functions.php del vostro template ed andrete ad aggiungere il seguente codice:

add_shortcode(“nome_shortcode”, “funzione_nome_shortcode”);

function funzione_nome_shortcode( $atts ) {
return ‘<img src=”<percorso dell’immagine” alt=””/>’;
}

E se vogliamo gestire dei parametri nel nostro shortcode?

Per esempio [shortcode variabile=3] ? Ecco qui cosa dovete fare:

add_shortcode(“nome_shortcode”, “funzione_nome_shortcode”);

function funzione_nome_shortcode( $atts ) {
extract(shortcode_atts(array(
“variabile” => 0
), $atts));
return ‘<div>La variabile è impostata a ‘.$variabile.'</div>’;
}