WP_Query Builder

Configurez votre requête WordPress visuellement : type de publication, filtres de taxonomie, champs ACF et tri. Le code PHP complet avec wp_reset_postdata() est généré automatiquement.

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 est la classe principale pour interroger la base de données WordPress : elle permet de récupérer des articles, pages et types de publication personnalisés avec des filtres complexes sur les taxonomies, les champs ACF, la date, l'auteur, le statut, et bien plus encore.

Ce builder visuel génère :

  • post_type, posts_per_page, paged, offset
  • Tax queries pour catégories, étiquettes et taxonomies personnalisées (AND/OR, IN/NOT IN)
  • Meta queries pour champs ACF avec opérateurs de comparaison
  • Paramètres de tri incluant meta_value et meta_value_num
  • Snippet PHP complet avec commentaires et wp_reset_postdata()

WP_Query - reference rapide

Les parametres les plus utiles, expliques pour les themes custom et les workflows ACF.

Conseils de performance

  • Pour les requetes sans pagination, utilisez no_found_rows => true : WordPress evite le comptage total et une requete SQL supplementaire.
  • Si vous avez seulement besoin des IDs, utilisez fields => 'ids' : les objets complets WP_Post ne sont pas charges.
  • Pour des requetes frequentes, envisagez update_post_meta_cache => false si vous n'utilisez pas les metas dans la boucle.

Parametres principaux

  • post_type : chaine ou tableau. 'any' pour tout type, 'attachment' pour les medias.
  • posts_per_page : -1 retourne tous les posts, attention aux performances sur de grosses bases.
  • meta_query : tableau de clauses pour filtrer les champs ACF/personnalises, avec key, value et compare.
  • tax_query : filtrez par taxonomies (category, post_tag, taxonomies custom) avec relation AND/OR.
  • orderby + order : triez par date, titre, meta value, menu order, aleatoire, etc.