WordPress get_posts関数の調査

キーテイクアウト

• WordPressのget_posts（）関数は、カスタムフィルターを適用し、パラメーターのセットに基づいて最終結果を並べ替えることにより、データベースから投稿を取得するために使用されます。それぞれが個々の投稿を表すwp_postオブジェクトの配列を返します。
get_posts（）関数は、wp_queryオブジェクトよりも優先されます。後者はメインループを変更し、サイトの問題を引き起こす可能性があるためです。 get_posts（）関数とget_pages（）は両方とも投稿を取得しますが、パラメーター名、値、および取得方法が異なります。
• get_posts（）関数は、カスタムフィルターを適用して結果を並べ替えるためのパラメーターの配列を受け入れます。これらのパラメーターには、post_per_page、Paged、tax_query、orderby、order、exclude、meta_key、meta_value、post_type、およびpost_status。
get_posts（）関数を使用して、最も人気のある投稿、ランダムな投稿、一致するメタキーと値のある投稿、およびカスタム分類名を持つカスタム投稿タイプの投稿を取得できます。その後、返された結果は、さらなる使用のためにループされます。
• 多くのWordPressプラグインは、ソート順序をカスタマイズして、特定のメタキーまたは分類に基づいて投稿を取得することにより、データベースから投稿を取得します。これらのプラグインがSQLクエリを書くことなく、投稿のカスタマイズされたリストをどのように取得するか疑問に思ったことはありますか？このチュートリアルでは、それを正確に行う方法を学びます。
この記事では、自分のプロジェクトでそれを使用する方法のいくつかの例を使用して、get_posts（）関数を調べます。また、この関数の典型的なユースケースと、wp_queryオブジェクトとget_pages関数とどのように異なるかについても説明します。

get_posts（）関数は何ですか？

get_posts関数は、wordpress 1.2.0以降、WordPress Coreで利用可能です。この関数は、基本的に、カスタムフィルターを適用し、パラメーターのセットに基づいて最終結果をソートすることにより、データベースから投稿を取得するために使用されます。

get_posts（）関数は、wp_postオブジェクトの配列を返します。各WP_POSTオブジェクトは、個々の投稿を表します

内部的にget_postsは、wp_queryオブジェクトを使用して、パラメーターの合格セットに基づいてSQLクエリを構築および実行します。

注：投稿は、投稿、ページ、カスタム投稿タイプを意味します

wp_queryオブジェクトを直接使用してみませんか？

プラグインは、WP_Queryオブジェクトの代わりにget_posts関数を使用します。wp_queryオブジェクトを使用すると、サイトの問題を引き起こすメインループ（つまり、グローバル$ wp_query変数）を直接変えるためです。

get_posts（）とget_pages（）関数？

の違いは何ですか？

どちらもWordPressデータベースから投稿を取得するために使用されますが、以下にそれらの違いのいくつかを示します。

• パラメーター名と値のいくつかは、それらの間で異なります。パラメーターの名前に関係なく同じように振る舞いますが。
get_pages（）関数は現在、meta_keyおよびmeta_valueパラメーターに基づいて投稿を取得していません。
• get_pages（）関数はwp_queryオブジェクトを使用しません。代わりに、SQLクエリを直接構築および実行します
• get_posts（）関数パラメーター

get_posts関数は、配列として1つの引数のみを取得します。配列には、カスタムフィルターを適用して結果を並べ替えるためのさまざまなパラメーターが含まれています。

この関数と利用可能なさまざまなパラメーターを呼び出す方法を示すコード例を次に示します。

より多くのパラメーターが利用可能ですが、これらは最も一般的に使用されるものです。これらの各パラメーターのそれぞれを見てみましょう：

posts_per_page：このパラメーターは、返す投稿の数を定義します。すべての投稿が必要な場合は-1を使用します。

<span><span><?php 
</span></span><span>
</span><span><span>$args = array(
</span></span><span>	<span>"posts_per_page"   => 5,
</span></span><span>	<span>"paged"            => 1
</span></span><span>	<span>"tax_query" => array(
</span></span><span>		<span>array(
</span></span><span>			<span>"taxonomy" => "category",
</span></span><span>			<span>"field"    => "slug",
</span></span><span>			<span>"terms"    => "videos,movies",
</span></span><span>		<span>)
</span></span><span>	<span>),
</span></span><span>	<span>"orderby"          => "post_date",
</span></span><span>	<span>"order"            => "DESC",
</span></span><span>	<span>"exclude"          => "1123, 4456",
</span></span><span>	<span>"meta_key"         => "",
</span></span><span>	<span>"meta_value"       => "",
</span></span><span>	<span>"post_type"        => "post",
</span></span><span>	<span>"post_status"      => "publish"
</span></span><span><span>);
</span></span><span>
</span><span><span>$posts_array = get_posts($args); 
</span></span><span>
</span><span><span>?></span></span>

Paged：post_per_pageパラメーターを使用しながら、投稿のセット間でナビゲートできます。ページネーションに使用されます。たとえば、post_per_pageが10で、結果に20の投稿があるとします。その後、ページを2つに割り当てると、最後の10の投稿が返されます。

Tax_Query：特定の分類スラッグの投稿を表示します。つまり、他の分類スラグの投稿を除外します。用語は、複数の分類スラグを表すコンマ分離文字列を取得できます。

Orderby：取得した投稿を並べ替えるために使用されます。いくつかの考えられる値は、「なし」、「日付」、「rand」、「comment_count」、「meta_value」、「meta_value_num」などです。「meta_value」と「meta_value_num」を使用してソートする際には、meta_keyパラメーターを提供する必要があります。
注文：Orderbyパラメーターの昇順または降順の順序を指定します。考えられる値は「DESC」または「ASC」です
2. 除外：データベース検索から除外されるコンマ分離の投稿IDのリストが必要です。
Meta_KeyおよびMeta_Value：Meta_Keyのみを提供する場合は、キーがある投稿が返されます。 Meta_Valueも提供する場合は、Meta_KeyのMeta_Valueに一致する投稿が返されます。
3. post_type：投稿、ページ、またはカスタム投稿タイプに基づいてコンテンツを取得します。デフォルトのpost_typeは、投稿のみを表示するように設定されているが、ページは表示されないことを忘れないでください。
post_status：投稿のステータスごとに投稿を取得します。考えられる値は、「パブリッシュ」、「保留」、「ドラフト」、「将来」、「任意」または「ゴミ」です。
wp_postオブジェクト
get_posts関数は、wp_postオブジェクトを含む配列を返します。 WP_POSTオブジェクトの重要なプロパティは次のとおりです
1. id：id of the post
2. post_author：postの著者名
3. post_type：post
のタイプ
4. post_title：post
のタイトル
5. post_date：投稿が公開された日付。フォーマット：0000-00-00 00:00:00
6. post_content：postのコンテンツ
7. post_status：post
のステータス
8. comment_count：投稿のコメントの数

get_postsの例

get_posts関数を使用していくつかの例をチェックしましょう。

最も人気のある投稿

サイトで最も議論されている投稿のトップn番号を表示する場合は、get_postsを使用してそれらを取得できます。例を次に示します：

<span><span><?php 
</span></span><span>
</span><span><span>$args = array(
</span></span><span>	<span>"posts_per_page"   => 5,
</span></span><span>	<span>"paged"            => 1
</span></span><span>	<span>"tax_query" => array(
</span></span><span>		<span>array(
</span></span><span>			<span>"taxonomy" => "category",
</span></span><span>			<span>"field"    => "slug",
</span></span><span>			<span>"terms"    => "videos,movies",
</span></span><span>		<span>)
</span></span><span>	<span>),
</span></span><span>	<span>"orderby"          => "post_date",
</span></span><span>	<span>"order"            => "DESC",
</span></span><span>	<span>"exclude"          => "1123, 4456",
</span></span><span>	<span>"meta_key"         => "",
</span></span><span>	<span>"meta_value"       => "",
</span></span><span>	<span>"post_type"        => "post",
</span></span><span>	<span>"post_status"      => "publish"
</span></span><span><span>);
</span></span><span>
</span><span><span>$posts_array = get_posts($args); 
</span></span><span>
</span><span><span>?></span></span>

ここで、Orderbyパラメーターを使用して、コメントの数に基づいて投稿をソートし、上位10の投稿を取得しています。 ランダムな投稿

ランダムな投稿を簡単に取得することもできます。これは、ユーザーが現在の記事を読み終えたら、サイト上の別の記事を推奨するのに役立ちます。これがこのコードです：

<span><span><?php
</span></span><span>	<span>$args = array("posts_per_page" => 10, "orderby" => "comment_count");
</span></span><span>	<span>$posts_array = get_posts($args);
</span></span><span>	<span>foreach($posts_array as $post)
</span></span><span>	<span>{
</span></span><span>	  <span>echo "<h1>" . $post->post_title . "</h1><br>";
</span></span><span>	  <span>echo "<p>" . $post->post_content . "</p><br>";
</span></span><span>	<span>} 
</span></span><span><span>?></span></span>

上記の例では、value randをOrder_byパラメーターに渡しました。 一致するメタキーと値を備えた

投稿

特定のメタキーと値が割り当てられているすべての投稿を取得することをお勧めします。たとえば、一部のブログには、すべての記事のレビュアーがいます。特定のレビュアーがレビューした記事を取得したいと思うかもしれません。

ここにそれを行うコードがあります：

ここでは、「NarayanPrusty」によってレビューされたすべての投稿を取得しています。レビュアーの名前は、すべての投稿のメタキー「レビュアー」を介して保存されていると仮定しています。 カスタム分類法を備えたカスタム投稿タイプ

<span><span><?php
</span></span><span>  <span>$args = array("posts_per_page" => 1, "orderby" => "rand");
</span></span><span>  <span>$posts_array = get_posts($args);
</span></span><span>  <span>foreach($posts_array as $post)
</span></span><span>  <span>{
</span></span><span>    <span>echo "<h1>" . $post->post_title . "</h1><br>";
</span></span><span>    <span>echo "<p>" . $post->post_content . "</p><br>";
</span></span><span>  <span>} 
</span></span><span><span>?></span></span>

カスタム分類名を持つカスタム投稿タイプの投稿を取得することができます。このコードの例を考えてみましょう：

この例では、「プラグイン」と「テーマ」に属する「クーポン」という名前のカスタム投稿タイプの投稿を取得しています。

結論

この記事では、get_postsの機能がどのように機能するか、サポートするさまざまなパラメーター、返された結果、およびいくつかのサンプルユースケースをループする方法を見ました。 get_posts関数は、最も使用されているWordPress関数の1つです。自分のプロジェクトの使用を開始できることを願っています。 WordPress get_posts関数に関するよくある質問（FAQ）

<span><span><?php
</span></span><span>  <span>$args = array("posts_per_page" => -1, "meta_key" => "reviewer", "meta_value" = "narayanprusty");
</span></span><span>  <span>$posts_array = get_posts($args);
</span></span><span>  <span>foreach($posts_array as $post)
</span></span><span>  <span>{
</span></span><span>    <span>echo "<h1>" . $post->post_title . "</h1><br>";
</span></span><span>    <span>echo "<p>" . $post->post_content . "</p><br>";
</span></span><span>  <span>} 
</span></span><span><span>?></span></span>

wordpressのget_postsとwp_queryの違いは何ですか？
get_postsとwp_queryの両方を使用して、wordpressデータベースから投稿を取得します。ただし、使用と柔軟性は異なります。 get_postsはよりシンプルな機能であり、初心者や特定の投稿セットのみを取得する必要がある状況に最適です。一方、WP_Queryはより強力で柔軟です。これにより、より複雑なクエリが可能になり、WordPressループをより制御できます。 get_postsは使いやすいですが、wp_queryはクエリをカスタマイズするためのより高度な機能を提供します。

get_postsによって返される投稿の数を変更するにはどうすればよいですか？

「numberposts」パラメーターを使用してget_postsによって返される投稿の数を制御できます。デフォルトでは5に設定されます。すべての投稿を取得する場合は、「numberpost」を-1に設定できます。たとえば、10の投稿を取得するには、get_posts（array（ 'numberposts' => 10））;

get_postsを使用してカスタム投稿タイプを取得できますか？ get_postsを使用して、カスタム投稿タイプを取得できます。クエリで「post_type」パラメーターを指定するだけです。たとえば、「製品」と呼ばれるカスタム投稿タイプがある場合、これらの投稿をget_posts（array（ 'post_type' => 'products'））;

返した投稿をソートするにはどうすればよいですかby get_posts？

「Orderby」と「Order」パラメーターを使用して、get_postsが返された投稿をソートできます。 「Orderby」は、分類するフィールドを決定し、「Order」は並べ替え順序を決定します（上昇するためのASCおよび降順のDESC）。たとえば、昇順でタイトルごとに投稿を並べ替えるには、get_posts（array（ 'orderby' => 'title'、 'order' => 'asc'）;

get_postsを使用できますか？特定のカテゴリから投稿を取得するには、

はい、get_postsを使用して特定のカテゴリから投稿を取得できます。クエリで「カテゴリ」パラメーターを指定するだけです。たとえば、ID 3のカテゴリからの投稿を取得するには、get_posts（array（ 'category' => 3））;

get_postsを使用して複数のカテゴリから投稿を取得するにはどうすればよいですか？ >

複数のカテゴリから投稿を取得するには、カテゴリIDの配列を「カテゴリ」パラメーターに渡すことができます。たとえば、IDS 3および4のカテゴリから投稿を取得するには、get_posts（array（ 'category' => array（3、4）））;
get_postsを使用して取得できますか？特定の著者による投稿？
はい、get_postsを使用して特定の著者による投稿を取得できます。クエリで「著者」パラメーターを指定するだけです。たとえば、著者がID 1を使用して投稿を取得するには、get_posts（ '著者' => 1））;
get_postsを使用して特定のメタ値を含む投稿を取得するにはどうすればよいですか。 ？
特定のメタ値を含む投稿を取得するには、「Meta_Key」および「Meta_Value」パラメーターを使用できます。たとえば、「色」のメタキーと「ブルー」のメタ値を持つ投稿を取得するには、get_posts（array（ 'meta_key' => 'color'、 'meta_value' => 'blue'）を使用します。 ）;
get_postsを使用して特定のタグを持つ投稿を取得できますか？クエリで「タグ」パラメーターを指定するだけです。たとえば、「WordPress」というタグを持つ投稿を取得するには、get_posts（array（ 'tag' => 'wordpress'）;

を使用します。

get_postsを使用して特定の日付範囲から投稿を取得するにはどうすればよいですか？

特定の日付範囲から投稿を取得するには、「date_query」パラメーターを使用できます。このパラメーターは、各内側配列が日付クエリ節を定義する配列の配列を受け入れます。たとえば、2020年1月から投稿を取得するには、get_posts（array（ 'date_query” => array（' year '=> 2020、' month '=> 1）））;

を使用します。

以上がWordPress get_posts関数の調査の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。