Cos’è WP_Query
WP_Query è la classe fondamentale di WordPress per eseguire query sul database e recuperare post. Sostituisce le query SQL dirette con un’interfaccia object-oriented che gestisce automaticamente cache, filtri, e compatibilità. Ogni pagina di WordPress utilizza WP_Query internamente, ma crearne di personalizzate permette di visualizzare esattamente i contenuti desiderati in qualsiasi contesto: homepage personalizzata, slider, widget, o sezioni tematiche.
Parametri Base di WP_Query
I parametri di WP_Query si dividono in categorie: post_type (page, post, custom), post_status (publish, draft), orderby (date, title, meta_value), posts_per_page, e category__in/tag__in. Puoi combinare parametri multipli per query complesse: $query = new WP_Query(array(‘post_type’ => ‘product’, ‘posts_per_page’ => 10, ‘meta_key’ => ‘price’, ‘orderby’ => ‘meta_value_num’, ‘order’ => ‘ASC’)).
Meta Query e Tax Query
Le meta_query permettono di filtrare post basati su campi personalizzati con operatori di confronto (==, !=, >, <, LIKE, EXISTS). Le tax_query filtrano per termini di tassonomia. Entrambi supportano relazioni (AND/OR) per condizioni multiple. Esempio avanzato: recupera tutti i post con prezzo tra 10 e 50 nella categoria 'promozioni' escludendo quelli esauriti.
Performance delle Query
WP_Query mal ottimizzato è la principale causa di rallentamenti in WordPress. Best practice: usa ‘no_found_rows’ => true per disabilitare il conteggio totale quando non serve (paginazione non necessaria), ‘fields’ => ‘ids’ per recuperare solo gli ID, e ‘update_post_meta_cache’/’update_post_term_cache’ => false per evitare query aggiuntive. Questi parametri riducono drasticamente il tempo di esecuzione.
Paginazione e Loop
La paginazione con WP_Query richiede attenzione: usa ‘paged’ => get_query_var(‘paged’) per rispettare la navigazione utente, e ‘max_num_pages’ con paginate_links() per generare i link di paginazione. Il loop standard (while $query->have_posts()) deve sempre terminare con wp_reset_postdata() per ripristinare il contesto globale.
Cache con WP_Query
WordPress cache automaticamente i risultati di WP_Query tramite l’object cache. Per query personalizzate ripetute, usa wp_cache_get/set per memorizzare risultati. Il parametro ‘cache_results’ è true per default, ma funziona solo con un object cache persistente (Redis, Memcached). Senza, ogni richiesta riesegue le query SQL completi.
Query per Custom Post Types
I custom post types si integrano nativamente con WP_Query. Usa ‘post_type’ => array(‘product’, ‘post’) per combinare tipi. I meta box dei CPT sono accessibili tramite meta_query. Per CPT gerarchici come ‘page’, ‘post_parent’ e ‘child_of’ permettono query padre-figlio. Le relazioni tra CPT si gestiscono con meta_query collegando post ID.
Query per Date e Autori
Filtra per data con year/month/day, ‘date_query’ per intervalli complessi inclusi before/after con operatori di confronto. Per autori, ‘author’ (ID singolo) o ‘author__in’/’author__not_in’ per multipli. ‘author_name’ accetta lo slug. Questi parametri sono utili per archivi personalizzati: post dell’ultimo mese, articoli di un autore specifico, o contenuti stagionali.
Debugging di WP_Query
Strumenti come Query Monitor mostrano tutte le query WP_Query eseguite, i loro parametri, il tempo di esecuzione, e le query SQL generate. Puoi anche usare $query->request per vedere la query SQL finale, e $query->explain per l’analisi EXPLAIN. Il debugging rivela query N+1, mancanza di indici, e parametri inefficienti.
Conclusione
WP_Query è uno strumento potente che richiede comprensione profonda per essere usato efficientemente. I parametri di ottimizzazione come no_found_rows e fields=ids sono essenziali per siti con molti post. Combina meta_query, tax_query, e date_query per query complesse, e usa sempre wp_reset_postdata(). Con WP_Query ben scritto, puoi creare esperienze dinamiche senza impattare le performance.
