I template tag nei temi di WordPress

I template tag sono funzioni definite nel core di WordPress che prelevano informazioni dal database e generano dinamicamente un output, quest'ultimo può essere mandato direttamente a video o restituito come valore di una variabile.

Molti template tag generano informazioni relative a post e pagine, come il titolo, l'autore, la data di pubblicazione, etc. Questi tag vanno utilizzati all'interno del Loop. Altri tag generano informazioni di carattere generale e possono essere utilizzati al di fuori del Loop.

Tag frequentemente utilizzati

Tra i tag di utilizzo più frequente, bloginfo() fornisce un semplice esempio di come restituire a video informazioni sul sito Web corrente:

<h2 class="site-description"><?php bloginfo( 'description' ); ?></h2>

L'argomento individua il tipo di informazione richiesta e la funzione invia direttamente l'output al browser. Il codice precedentemente proposto manda a video il seguente testo:

<h2 class="site-description">Un nuovo sito targato WordPress</h2>

Spesso l'output restituito a video non è costituito da una semplice stringa di testo, ma da un frammento di codice HTML:

<article id="post-<?php the_ID(); ?>" <?php post_class(); ?>>

the_ID() restituisce l'ID del post corrente in forma di stringa; post_class(), invece, restituisce un frammento di codice HTML, sicché l'output a video sarà:

<article id="post-90" class="post-90 post type-post status-publish format-standard hentry category-news">

Tra le molte decine di tag, è possibile individuare due sottogruppi che si presentano con caratteristiche omogenee: i tag con prefisso the_ e i tag con prefisso get_.

I tag the_

Il prefisso the_ individua un tag che manda a video un output. the_title() e the_permalink(), ad esempio, restituisce a video il titolo e il permalink di un post (o di una pagina) e deve necessariamente essere utilizzato all'interno del Loop. Si consideri questo esempio:

<h2><a href="<?php the_permalink() ?>"><?php the_title(); ?></a></h2>

Con questa istruzione vengono stampati a video il permalink e il titolo di un post all'interno di un titolo delimitato da h2. Altri tag the_ di impiego comune sono:

Tag	Descrizione
the_author()	Produce una stringa con il nome dell'autore di un post.
the_author_meta()	Mostra ogni altro tipo di informazione sull'autore del post.
the_time() e the_date()	Mostrano ora e data di pubblicazione.
the_excerpt() e the_content()	Mandano a video il riassunto e il contenuto principale del post.
the_category() e the_tags()	Generano l'elenco delle categorie e dei tag post.

I tag get_

Se i tag the_ stampano un output a video, i tag get_ restituiscono una stringa da gestire via PHP. Il framework dispone, per molti tag the_, di un corrispondente tag get_. Così i tag get_permalink() e get_the_title() permettono di ottenere lo stesso risultato dell'esempio precedente:

<a href="<?php esc_url( get_permalink() ); ?>"><?php echo get_the_title(); ?></a></h2>

get_permalink() e get_the_title() possono essere utilizzati al di fuori del Loop, e quindi si prestano ad una molteplicità di impieghi. Altri tag di uso comune sono get_bloginfo(), get_the_author(), get_the_author_meta(), get_the_time(), get_the_date(), get_the_excerpt() e get_the_content() i cui nomi rendono facilmente intuibile la funzione svolta.

Tag condizionali

Sono funzioni che permettono di testare una condizione. Grazie a questi tag, è possibile generare un output alternativo a seconda del valore TRUE o FALSE restituito. is_single(), ad esempio, restituisce TRUE al caricamento di una pagina singola:

if ( is_single() ) :
	the_title( '<h1 class="entry-title">', '</h1>' );
else :
	the_title( '<h1 class="entry-title"><a href="' . esc_url( get_permalink() ) . '" rel="bookmark">', '</a></h1>' );
endif;

Altri tag condizionali di uso corrente sono is_home() e is_front_page(), che testano se la pagina corrente sia la Home Page del sito Web corrente (blog o pagina statica); is_page(), che verifica che l'utente si trovi in una pagina statica; is_category(), che verifica la categoria del post corrente.

Include tags

Gli Include Tags, di cui si è già parlato nei capitoli precedenti, sono funzioni che includono il contenuto di specifici template. Si tratta dei seguenti template tags:

• get_header()
• get_footer()
• get_sidebar()
• get_template_part()
• get_search_form()
• comments_template()

Anche in questo caso i nomi dei tags rendono facilmente intuibile la funzione svolta

I parametri

Come tutte le funzioni PHP, i template tag possono accettare o meno argomenti. bloginfo(), ad esempio, accetta una stringa che individua il tipo di dato da mandare a video. Nel caso non venisse passato alcun argomento, bloginfo() stamperà il nome del sito Web corrente.
Alcuni tag accettano argomenti come ogni funzione PHP; a tal proposito si consideri la seguente istruzione:

<?php single_post_title( 'Title: ', TRUE ); ?>

Qui il primo argomento è un testo da visualizzare prima dell'output, il secondo stabilisce se la funzione deve mandare a video il testo, o restituirlo in una variabile PHP. Infine, alcuni tag accettano argomenti nella forma di array o di querystring:

<?php wp_list_categories( 'orderby=name&exclude=4,5&title_li=<h2>' . __('Events') . '</h2>&taxonomy=event' ); ?>

L'argomento passato alla funzione consiste in una querystring che imposta i valori di quattro parametri: orderby, exclude, title_li e taxonomy. In alternativa alla querystring, gli stessi parametri avrebbero potuto essere trasmessi come elementi di un array.

Riferimenti online

In questo capitolo si è fatto ampio riferimento al Codex di WordPress, e in particolare ai seguenti articoli:

• Template Tags
• Stepping into Template Tags
• Anatomy of a Template Tag
• How to pass tag parameters
• Conditional Tags
• Include Tags

Nel prossimo capitolo si parlerà nel dettaglio della gerarchia dei template.