Nel tutorial seguente vediamo come realizzare uno shortcode con WordPress per mostrare l’elenco degli ultimi post di un blog.
Innanzitutto, che cos’è uno shortcode? E’ un breve codice racchiuso tra parentesi quadre che, inserito all’interno dell’editor di WordPress, richiama una funzione particolare per ottenere un risultato predefinito. Si possono creare shortcodes per fare qualsiasi cosa, dalla gestione delle colonne dei layout, all’inserimento di mappe di Google Maps ecc ecc… Di seguito vediamo come richiamare, dentro ad un post, l’elenco dei post recenti che abbiamo scritto.
La prima cosa che dovremo fare sarà realizzare, all’interno del file functions.php, una funzione che si occupi di recuperare i post. Per farlo scriviamo il seguente codice (che ho commentato direttamente per semplicità):
function mostra_ultimi_post(){
$result = '';
// Effettuiamo una nuova query con i parametri che vogliamo
$query = new WP_Query( 'posts_per_page=5' );
// Creiamo il loop
while ( $query->have_posts() ) : $query->the_post();
$result.= '<li>';
$result.= '<a href="'.get_permalink().'">'.get_the_title().'</a>';
$result.= '<div class="excerpt">'.get_the_excerpt().'</div>';
$result.= '</li>';
endwhile;
// Resettiamo la query in modo che non vengano influenzate le altre eseguite in pagina
wp_reset_postdata();
//Restituisci il risultato
return $result;
}
//Registriamo lo shortcode
function register_shortcodes(){
add_shortcode( 'MOSTRA_ULTIMI_POST', 'mostra_ultimi_post' );
}
add_action( 'init', 'register_shortcodes');Come possiamo vedere fondamentalmente dovremo fare due operazioni:
- Dovremo effettuare la query che ci restituisca i post che vogliamo (in questo caso abbiamo preso indiscriminatamente tutti i post di tutte le categorie ecc… ma usando gli argomenti possiamo eseguire una query molto personalizzata)
- Dovremo registrare lo shortcode per poterlo usare nell’editor
Fatto questo basterà inserirlo nell’editor per ottenere il risultato! Ovvero mostrare 5 post di cui verranno estratti titolo (e link) e riassunto!
