WP_Query jest klasą zdefiniowaną w WordPress. Pozwala ona programistom na pisanie własnych zapytań i wyświetlanie wpisów przy użyciu różnych parametrów. Deweloperzy mogą bezpośrednio wysyłać zapytania do bazy danych WordPress. Jednak WP_Query jest jednym z zalecanych sposobów na odpytywanie wpisów z bazy danych WordPress.
Poniżej znajduje się przykład prostego WP_Query, które wyświetla wpisy z kategorii filmów:
<?php // The Query $the_query = new WP_Query( 'category_name=movies' ); ?>
.
Powyższy przykładowy kod nie wyświetla wpisów automatycznie. Aby wyświetlić wyniki zapytania, użytkownik musiałby użyć pętli WordPress. W ten sposób:
<?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 to potężne narzędzie z wieloma parametrami, które można wykorzystać do pisania bardziej złożonych i zaawansowanych zapytań. WP_Query może być używane do tworzenia zagnieżdżonych pętli (pętla WordPress wewnątrz pętli). Programiści WordPress mogą używać go w swoich wtyczkach i motywach do tworzenia własnych niestandardowych wyświetleń wpisów.
Pełna lista parametrów WP_Query jest dostępna na WordPress Codex.