WP_Query Builder

Configura la tua query WordPress visivamente: post type, filtri taxonomy, campi ACF e ordinamento. Il tool genera il blocco PHP completo con wp_reset_postdata() pronto da incollare.

Tipo e stato
post_type
Premi Enter o virgola per aggiungere. Lascia vuoto per 'post'.
post_status
Paginazione
posts_per_page
-1 = tutti
paged
offset
no_found_rows
Ordinamento
orderby
order
Post specifici
post__in
ID da includere (preserva l'ordine con orderby=post__in)
post__not_in
ID da escludere
post_parent
Autore
author
author_name
author__not_in
Data
year
monthnum
day
Oppure usa date_query avanzata:
after
before
column
Taxonomy query
Meta query (campi ACF)
relation
Opzioni extra
ignore_sticky_posts
suppress_filters - disabilita filtri plugin
fields
cache_results
update_post_meta_cache
update_post_term_cache

WP_Query è la classe principale per interrogare il database di WordPress: consente di estrarre post, pagine e custom post type con filtri complessi su taxonomy, meta field ACF, data, autore, stato e molto altro. Padroneggiarne la sintassi richiede pratica, e un parametro sbagliato può portare a loop infiniti o risultati inattesi.

Questo builder visivo genera:

  • Post_type, posts_per_page, paged, offset
  • Tax query per category, tag e tassonomie custom (AND/OR, IN/NOT IN)
  • Meta query per campi ACF con operatori di confronto (=, !=, >, <, LIKE)
  • Parametri di ordinamento inclusi meta_value e meta_value_num
  • Snippet PHP completo con commenti e wp_reset_postdata() incluso

WP_Query - riferimento rapido

I parametri piu utili, spiegati per chi lavora con temi custom e ACF.

Consigli sulle performance

  • Per query che non richiedono paginazione, imposta no_found_rows => true: WordPress salta il conteggio totale dei risultati, che richiede una query SQL aggiuntiva.
  • Se hai bisogno solo degli ID dei post, usa fields => 'ids': non carica gli oggetti WP_Post completi.
  • Con query molto frequenti, considera update_post_meta_cache => false se non accedi ai meta nel loop.

Parametri principali

  • post_type: stringa o array. 'any' per qualsiasi tipo, 'attachment' per i media.
  • posts_per_page: -1 restituisce tutti i post, ma attenzione alle performance su database grandi.
  • meta_query: array di clausole per filtrare su campi personalizzati ACF. Ogni clausola usa almeno key, value, compare.
  • tax_query: filtra per tassonomie (category, post_tag, tassonomie custom) e supporta relation AND/OR.
  • orderby + order: ordina per data, titolo, meta value, menu order, random, ecc.