Come usare gli shortcode in WordPress
646 visite
Gli shortcode sono stati introdotti dalla versione 2.5 e rappresentano uno strumento molto potete per creare codici macro o anche detti codici brevi da utilizzare all’interno del contenuto di un post.
Vediamo nel dettaglio cosa sono e come possiamo usarli. Immaginiamo di voler creare una funzionalità e poterla richiamare velocemente nei nostri contenuti tramite un codice associato, per esempio un testo incluso tra parentesi quadre (es.: [codice]).
Bene, stiamo usando proprio un codice breve. Un esempio potrebbe essere il seguente.
Registriamolo in function.php:
|
1 2 3 4 5 6 |
<?php function my_short_code( $atts ){ return "Welcome to Geeknews.it"; } add_shortcode( 'welcome', 'my_short_code' ); ?> |
Quindi per usarlo inseriamo nei nostri contenuti il seguente codice:
|
1 2 3 |
[welcome] oppure <?php echo do_shortcode('[welcome]'); ?> |
Possiamo scrivere codici con funzionalità molto più complesse prevedendo, per esempio, l’utilizzo di attributi con variabili dinamiche. Per capire meglio vediamo un altro esempio un pò più complesso.
Creiamo un codice [welcome] che accetti una variabile text:
|
1 2 3 4 5 6 7 8 9 |
<?php function welcome_short_code($text) { extract(shortcode_atts(array( 'text' => 'text' ), $text)); echo "Welcome to $text"; } add_shortcode('welcome', 'welcome_short_code'); ?> |
Ora inseriamolo nei nostri contenuti:
|
1 |
[welcome text="geeknews.it"] |
Infine se vogliamo creare un “eclosing shortcode” tipo [welcome]…[/welcome] inseriamo il seguente codice PHP:
|
1 2 3 4 5 6 |
<?php function welcome_short_code( $attr, $content = null ) { return 'Welcome to ' . $content . ' !'; } add_shortcode('welcome', 'welcome_short_code'); ?> |
Che useremo nel modo seguente:
|
1 |
[welcome]GeekNews.it[/welcome] |
Per attivare codici brevi nei vostri widgets/plugin, basta inserire il seguente codice in functions.php:
|
1 2 3 |
<?php add_filter('widget_text', 'do_shortcode'); ?> |
e per usarli scriviamo:
|
1 2 3 |
<?php do_shortcode("[button]"); ?> |
Se volete avere ulteriori informazioni vi segnaliamo la documentazione ufficiale.
