WP_Query è una classe definita in WordPress. Permette agli sviluppatori di scrivere query personalizzate e visualizzare post utilizzando diversi parametri. È possibile per gli sviluppatori interrogare direttamente il database di WordPress. Tuttavia, WP_Query è uno dei modi consigliati per interrogare i post dal database di WordPress.
Di seguito è riportato un esempio di una semplice WP_Query che visualizza post dalla categoria film:
<?php // The Query $the_query = new WP_Query( 'category_name=movies' ); ?>
Il codice di esempio sopra non visualizza automaticamente i post. Per visualizzare i risultati della query, l'utente dovrebbe utilizzare il loop di WordPress. In questo modo:
<?php
// The Query
$the_query = new WP_Query( 'category_name=movies' );
// The Loop
if ( $the_query->have_posts() ) {
echo '<ul>';
while ( $the_query->have_posts() ) {
$the_query->the_post();
echo '<li>' . get_the_title() . '</li>';
}
echo '</ul>';
} else {
// no posts found
}
/* Restore original Post Data */
wp_reset_postdata();
?>
WP_Query è uno strumento potente, ci sono molti parametri che possono essere utilizzati per scrivere query più complesse e avanzate. WP_Query può essere utilizzata per creare loop nidificati (un loop di WordPress all'interno di un altro loop). Gli sviluppatori di WordPress possono utilizzarla nei loro plugin e temi per creare le proprie visualizzazioni personalizzate di post.
Un elenco completo dei parametri di WP_Query è disponibile su WordPress Codex.
