ループには2つの異なるコンテキストがあります:

• メインループはURLリクエストに基づいて発生し、テンプレートが読み込まれる前に処理されます
• セカンダリループは、テンプレートファイルなどから呼び出され、他の方法で発生します

query_posts()の問題は、メインループになろうとして、惨めに失敗するのはセカンダリループであるということです.したがって、それが存在することを忘れてください.

メインループを変更するには

• query_posts()
を使用しないでください
• $ query-＆gt;is_main_query()チェックでpre_get_posts フィルターを使用する
• 代わりに request フィルターを使用します(少し粗すぎるので上記の方が良いです)

セカンダリループを実行するには

ほとんど互換性のあるnew WP_Query またはget_posts()を使用します(後者は前者の薄いラッパーです).

クリーンアップするには

query_posts()を使用した場合、またはグローバルな $ wp_query を直接使用した場合は、 wp_reset_query()を使用します.そのため、ほとんど必要ありません.

the_post()または setup_postdata()を使用した場合、またはグローバルな $post wp_reset_postdata()を使用してください>そしてポスト関連のものの初期状態を復元する必要があります.

There are two different contexts for loops:

• main loop that happens based on URL request and is processed before templates are loaded
• secondary loops that happen in any other way, called from template files or otherwise

Problem with query_posts() is that it is secondary loop that tries to be main one and fails miserably. Thus forget it exists.

To modify main loop

• don't use query_posts()
• use pre_get_posts filter with $query->is_main_query() check
• alternately use request filter (a little too rough so above is better)

To run secondary loop

Use new WP_Query or get_posts() which are pretty much interchangeable (latter is thin wrapper for former).

To cleanup

Use wp_reset_query() if you used query_posts() or messed with global $wp_query directly - so you will almost never need to.

Use wp_reset_postdata() if you used the_post() or setup_postdata() or messed with global $post and need to restore initial state of post-related things.

query_posts($query)を使用するための正当なシナリオがあります.例:

1. (ページテンプレートを使用して)ページに投稿またはカスタム投稿タイプの投稿のリストを表示したい

2. これらの投稿のページ付けを機能させたい

アーカイブテンプレートを使用する代わりに、なぜそれをページに表示したいのですか?

1. 管理者(顧客?)にとってはより直感的です-管理者は「ページ」でページを見ることができます

2. メニューに追加することをお勧めします(ページがない場合は、URLを直接追加する必要があります)

3. テンプレートに追加のコンテンツ(テキスト、投稿のサムネイル、またはカスタムメタコンテンツ)を表示する場合は、ページから簡単に取得できます(そして、すべてが顧客にとってより意味があります).アーカイブテンプレートを使用したかどうかを確認するには、追加のコンテンツをハードコーディングするか、たとえばテーマ/プラグインオプションを使用する必要があります(これにより、顧客にとって直感的ではなくなります)

ここに簡略化されたサンプルコードがあります(これはページテンプレートにあります-例:page-page-of-posts.php):

 /**
 * Template Name: Page of Posts
 */

while(have_posts()) { // original main loop - page content
  the_post();
  the_title(); // title of the page
  the_content(); // content of the page
  // etc...
}

// now we display list of our custom-post-type posts

// first obtain pagination parametres
$paged = 1;
if(get_query_var('paged')) {
  $paged = get_query_var('paged');
} elseif(get_query_var('page')) {
  $paged = get_query_var('page');
}

// query posts and replace the main query (page) with this one (so the pagination works)
query_posts(array('post_type' => 'my_post_type', 'post_status' => 'publish', 'paged' => $paged));

// pagination
next_posts_link();
previous_posts_link();

// loop
while(have_posts()) {
  the_post();
  the_title(); // your custom-post-type post's title
  the_content(); // // your custom-post-type post's content
}

wp_reset_query(); // sets the main query (global $wp_query) to the original page query (it obtains it from global $wp_the_query variable) and resets the post data

// So, now we can display the page-related content again (if we wish so)
while(have_posts()) { // original main loop - page content
  the_post();
  the_title(); // title of the page
  the_content(); // content of the page
  // etc...
}
 

これで、完全に明確にするために、ここでもquery_posts()の使用を避け、代わりにWP_Queryを使用できます-次のように:

 // ...

global $wp_query;
$wp_query = new WP_Query(array('your query vars here')); // sets the new custom query as a main query

// your custom-post-type loop here

wp_reset_query();

// ...
 

しかし、このような素敵な小さな機能を利用できるのに、なぜそうするのでしょうか?

There are legitimate scenarios for using query_posts($query), for example:

1. You want to display a list of posts or custom-post-type posts on a page (using a page template)

2. You want to make pagination of those posts work

Now why would you want to display it on a page instead of using an archive template?

1. It's more intuitive for an administrator (your customer?) - they can see the page in the 'Pages'

2. It's better for adding it to menus (without the page, they'd have to add the url directly)

3. If you want to display additional content (text, post thumbnail, or any custom meta content) on the template, you can easily get it from the page (and it all makes more sense for the customer too). See if you used an archive template, you'd either need to hardcode the additional content or use for example theme/plugin options (which makes it less intuitive for the customer)

Here's a simplified example code (which would be on your page template - e.g. page-page-of-posts.php):

/**
 * Template Name: Page of Posts
 */

while(have_posts()) { // original main loop - page content
  the_post();
  the_title(); // title of the page
  the_content(); // content of the page
  // etc...
}

// now we display list of our custom-post-type posts

// first obtain pagination parametres
$paged = 1;
if(get_query_var('paged')) {
  $paged = get_query_var('paged');
} elseif(get_query_var('page')) {
  $paged = get_query_var('page');
}

// query posts and replace the main query (page) with this one (so the pagination works)
query_posts(array('post_type' => 'my_post_type', 'post_status' => 'publish', 'paged' => $paged));

// pagination
next_posts_link();
previous_posts_link();

// loop
while(have_posts()) {
  the_post();
  the_title(); // your custom-post-type post's title
  the_content(); // // your custom-post-type post's content
}

wp_reset_query(); // sets the main query (global $wp_query) to the original page query (it obtains it from global $wp_the_query variable) and resets the post data

// So, now we can display the page-related content again (if we wish so)
while(have_posts()) { // original main loop - page content
  the_post();
  the_title(); // title of the page
  the_content(); // content of the page
  // etc...
}

Now, to be perfectly clear, we could avoid using query_posts() here too and use WP_Query instead - like so:

// ...

global $wp_query;
$wp_query = new WP_Query(array('your query vars here')); // sets the new custom query as a main query

// your custom-post-type loop here

wp_reset_query();

// ...

But, why would we do that when we have such a nice little function available for it?

Functions.phpからWordPressクエリを変更します:

 //unfortunately, "IS_PAGE" condition doesn't work in pre_get_posts (it's WORDPRESS behaviour)
//so you can use `add_filter('posts_where', ....);`    OR   modify  "PAGE" query directly into template file

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%')"; 
}
 

I modify WordPress query from functions.php:

//unfortunately, "IS_PAGE" condition doesn't work in pre_get_posts (it's WORDPRESS behaviour)
//so you can use `add_filter('posts_where', ....);`    OR   modify  "PAGE" query directly into template file

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%')"; 
}

WordPressは時間の経過とともに進化し、現在(5年後)はいくつかの点で異なっているため、受け入れられた回答に対するいくつかの改善点の概要を説明します.

pre_get_postsは、クエリを変更するためのフィルターです.これは、「メインクエリ」のみを変更するために最もよく使用されます:

実際にはアクションフックです.フィルタではなく、クエリに影響します.

メインクエリはテンプレートに次のように表示されます:

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

実際、これも真実ではありません.関数have_postsは、メインクエリにのみ関連付けられていないglobal $wp_queryオブジェクトを繰り返し処理します. global $wp_query;は、セカンダリクエリでも変更できます.

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

get_posts()

これは基本的に、WP_Queryオブジェクトの個別のインスタンスのラッパーです.

実際、現在WP_Queryはクラスであるため、クラスのインスタンスがあります.

結論:@StephenHarrisが書いた時点では、おそらくこれはすべて真実でしたが、時間の経過とともにWordPressの状況は変化しました.

Just to outline some improvements to the accepted answer since WordPress evolved over the time and some things are different now (five years later):

pre_get_posts is a filter, for altering any query. It is most often used to alter only the 'main query':

Actually is an action hook. Not a filter, and it will affect any query.

The main query appears in your templates as:

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

Actually, this is also not true. The function have_posts iterates the global $wp_query object that is not related only to the main query. global $wp_query; may be altered with the secondary queries also.

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

get_posts()

This is essentially a wrapper for a separate instance of a WP_Query object.

Actually, nowadays WP_Query is a class, so we have an instance of a class.

To conclude: At the time @StephenHarris wrote most likely all this was true, but over the time things in WordPress have been changed.