WordPress
Shortcode con attributo
Ricerca…
Sintassi
- add_shortcode ('your_short_code', 'your_function_name');
Parametri
parametri | Discription e utilizzo |
---|---|
$ tag | (stringa) (obbligatorio) Tag shortcode da cercare nel contenuto del post Predefinito: Nessuno |
$ func | (richiamabile) (obbligatorio) Hook da eseguire quando viene trovato lo shortcode Predefinito: Nessuno |
Osservazioni
IMPORTANTE: non utilizzare camelCase o UPPER-CASE per i propri attributi
Puoi generare uno shortcode con l'attributo Qui
Esempi di Shortcode
Gli shortcode di WordPress sono stati introdotti in 2.5
Ecco un esempio di shortcode
[button]
per usare lo shortcode direttamente nel tema devi usare do_shortcode()
<?php echo do_shortcode('[button]'); ?>
Per personalizzare il pulsante, potremmo semplicemente aggiungere qualcosa come:
[button type="twitter"]
O per renderlo ancora migliore, potremmo usare uno shortcode che racchiude:
[button type="twitter"]Follow me on Twitter![/button]
Creazione di uno shortcode autochiudente
Lo shortcode più semplice è quello a chiusura automatica. Creeremo un semplice link al nostro account Twitter e quindi lo aggiungeremo in un post sul blog. Tutto il codice va in functions.php
, che si trova in /wp-content/themes/your-theme/
. Se non ne hai uno, crealo e inserisci il codice.
<?php
function button_shortcode() {
return '<a href="http://twitter.com/rupomkhondaker" class="twitter-button">Follow me on Twitter!</a>"';
}
add_shortcode('button', 'button_shortcode');
?>
Utilizzo: [button]
Creazione di uno shortcode autochiudente con parametri
Creazione di uno shortcode autochiudente con parametri
<?php
function button_shortcode( $type ) {
extract( shortcode_atts(
array(
'type' => 'value'
), $type ) );
// check what type user entered
switch ($type) {
case 'twitter':
return '<a href="http://twitter.com/rupomkhondaker" class="twitter-button">Follw me on Twitter!</a>';
break;
case 'rss':
return '<a href="http://example.com/rss" class="rss-button">Subscribe to the feed!</a>'
break;
}
}
add_shortcode( 'button', 'button_shortcode' );
?>
Ora puoi scegliere quale pulsante visualizzare definendo il tipo nel tuo shortcode.
[button type="twitter"]
[button type="rss"]
Creare un shortcode che racchiude
accludere shortcode
Lo shortcode che lo racchiude ti consente di incorporare contenuti all'interno del tuo shortcode, proprio come il BBCode, se lo hai mai usato.
<?php
function button_shortcode( $attr, $content = null ) {
return '<a href="http://twitter.com/filipstefansson" class="twitter-button">' . $content . '</a>';
}
add_shortcode('button', 'button_shortcode');
?>
Per utilizzare questo shortcode, incorporare il testo che si desidera utilizzare in questo modo:
[button]Follow me on Twitter![/button]
Per rendere questo pulsante ancora migliore, potremmo aggiungere parametri proprio come abbiamo fatto nell'esempio precedente.
<?php
function button_shortcode( $atts, $content = null ) {
extract( shortcode_atts( array(
'account' => 'account',
'style' => 'style'
), $atts ) );
return '<a href="http://twitter.com/' . esc_attr($account) . '" class="twitter-button ' . esc_attr($style) . '">' . $content . '</a>';
}
add_shortcode('button', 'button_shortcode');
?>
Uso:
[button account="rupomkhondaker" style="simple"]Follow me on Twitter![/button]
Shortcode in Widget
Per impostazione predefinita, WordPress non supporta gli shortcode nei widget della sidebar. Espande solo gli shortcode nel contenuto di un Post, Pagina o tipo di messaggio personalizzato. Per aggiungere il supporto shortcode ai widget della barra laterale, puoi installare un plug-in o utilizzare il codice seguente:
add_filter( 'widget_text', 'shortcode_unautop' );
add_filter( 'widget_text', 'do_shortcode' );
È importante aggiungere queste righe in questo ordine. La prima riga impedisce a WordPress di trasformare le interruzioni di riga in tag di paragrafo, poiché ciò impedisce il funzionamento dei codici di accesso. La seconda linea è quella che fa funzionare gli shortcode.