Quando usare WP_query(), query_posts() e pre_get_posts

Esistono due contesti diversi per i loop:

• Il loop principale che viene eseguito in base alla richiesta URL e viene processato prima del caricamento dei template
• I loop secondari che avvengono in qualsiasi altro modo, richiamati dai file template o altrimenti

Il problema con query_posts() è che è un loop secondario che cerca di essere quello principale e fallisce miseramente. Quindi dimenticate che esista.

Per modificare il loop principale

• Non usare query_posts()
• Usa il filtro pre_get_posts con il controllo $query->is_main_query()
• In alternativa usa il filtro request (un po' troppo grezzo quindi l'opzione precedente è migliore)

Per eseguire un loop secondario

Usa new WP_Query o get_posts() che sono praticamente intercambiabili (il secondo è un wrapper leggero del primo).

Per ripulire

Usa wp_reset_query() se hai usato query_posts() o hai modificato direttamente la variabile globale $wp_query - quindi quasi mai ne avrai bisogno.

Usa wp_reset_postdata() se hai usato the_post() o setup_postdata() o hai modificato la variabile globale $post e devi ripristinare lo stato iniziale degli elementi relativi al post.

Ci sono scenari legittimi per l'utilizzo di query_posts($query), ad esempio:

1. Vuoi visualizzare un elenco di articoli o articoli di un custom-post-type su una pagina (utilizzando un page template)

2. Vuoi far funzionare la paginazione di questi articoli

Ora, perché vorresti visualizzarlo su una pagina invece di utilizzare un template di archivio?

1. È più intuitivo per un amministratore (il tuo cliente?) - possono vedere la pagina in 'Pagine'

2. È meglio per aggiungerla ai menu (senza la pagina, dovrebbero aggiungere l'URL direttamente)

3. Se vuoi visualizzare contenuti aggiuntivi (testo, thumbnail dell'articolo o qualsiasi meta contenuto personalizzato) sul template, puoi ottenerlo facilmente dalla pagina (e ha anche più senso per il cliente). Se utilizzassi un template di archivio, dovresti inserire il contenuto aggiuntivo direttamente nel codice o utilizzare ad esempio le opzioni del tema/plugin (il che lo rende meno intuitivo per il cliente)

Ecco un esempio di codice semplificato (che sarebbe nel tuo page template - ad esempio page-page-of-posts.php):

/**
 * Template Name: Pagina di Articoli
 */

while(have_posts()) { // loop principale originale - contenuto della pagina
  the_post();
  the_title(); // titolo della pagina
  the_content(); // contenuto della pagina
  // ecc...
}

// ora visualizziamo l'elenco dei nostri articoli di custom-post-type

// prima otteniamo i parametri di paginazione
$paged = 1;
if(get_query_var('paged')) {
  $paged = get_query_var('paged');
} elseif(get_query_var('page')) {
  $paged = get_query_var('page');
}

// query degli articoli e sostituzione della query principale (pagina) con questa (così la paginazione funziona)
query_posts(array('post_type' => 'my_post_type', 'post_status' => 'publish', 'paged' => $paged));

// paginazione
next_posts_link();
previous_posts_link();

// loop
while(have_posts()) {
  the_post();
  the_title(); // titolo del tuo articolo di custom-post-type
  the_content(); // contenuto del tuo articolo di custom-post-type
}

wp_reset_query(); // reimposta la query principale (globale $wp_query) alla query originale della pagina (la ottiene dalla variabile globale $wp_the_query) e reimposta i dati dell'articolo

// Quindi, ora possiamo visualizzare nuovamente il contenuto relativo alla pagina (se lo desideriamo)
while(have_posts()) { // loop principale originale - contenuto della pagina
  the_post();
  the_title(); // titolo della pagina
  the_content(); // contenuto della pagina
  // ecc...
}

Ora, per essere perfettamente chiari, potremmo evitare di usare query_posts() anche qui e usare invece WP_Query - in questo modo:

// ...

global $wp_query;
$wp_query = new WP_Query(array('i tuoi parametri di query qui')); // imposta la nuova query personalizzata come query principale

// il tuo loop di custom-post-type qui

wp_reset_query();

// ...

Ma, perché dovremmo farlo quando abbiamo a disposizione una così comoda piccola funzione?

Modifico la query di WordPress da functions.php:

//sfortunatamente, la condizione "IS_PAGE" non funziona in pre_get_posts (è un comportamento di WORDPRESS)
//quindi puoi usare `add_filter('posts_where', ....);`    OPPURE   modificare direttamente la query "PAGE" nel file template

add_action( 'pre_get_posts', 'myFunction' );
function myFunction($query) {
    if ( ! is_admin() && $query->is_main_query() )  {
        if (  $query->is_category ) {
            $query->set( 'post_type', array( 'post', 'page', 'my_postType' ) );
            add_filter( 'posts_where' , 'MyFilterFunction_1' ) && $GLOBALS['call_ok']=1; 
        }
    }
}
function MyFilterFunction_1($where) {
   return (empty($GLOBALS['call_ok']) || !($GLOBALS['call_ok']=false)  ? $where :  $where . " AND ({$GLOBALS['wpdb']->posts}.post_name NOT LIKE 'Journal%')"; 
}

Solo per delineare alcuni miglioramenti alla risposta accettata, dato che WordPress si è evoluto nel tempo e alcune cose sono diverse ora (cinque anni dopo):

pre_get_posts è un filtro, per modificare qualsiasi query. Viene spesso utilizzato per modificare solo la 'query principale':

In realtà è un action hook. Non un filtro, e influenzerà qualsiasi query.

La query principale appare nei tuoi template come:

if( have_posts() ):
    while( have_posts() ): the_post();
       //Il loop
    endwhile;
endif;

Anche questo non è del tutto vero. La funzione have_posts itera sull'oggetto global $wp_query che non è relativo solo alla query principale. global $wp_query; può essere modificato anche con query secondarie.

function have_posts() {
    global $wp_query;
    return $wp_query->have_posts();
}

get_posts()

Questo è essenzialmente un wrapper per un'istanza separata di un oggetto WP_Query.

In realtà, al giorno d'oggi WP_Query è una classe, quindi abbiamo un'istanza di una classe.

Per concludere: Al tempo in cui @StephenHarris ha scritto molto probabilmente tutto questo era vero, ma nel tempo le cose in WordPress sono cambiate.