pgintro.net

WordPressクラス - 「WP_Query」

作成日時:2019/06/09

更新日時:2019/06/09

スポンサーリンク

この記事の確認環境

WordPress 5.0.4

クラス概要

公式ドキュメント : https://codex.wordpress.org/Class_Reference/WP_Query

クラス使用例

$args = array(
  'meta_key' => 'meta',
  'orderby' => 'meta_value_num',
  'order' => 'DESC',
  'post_type' => 'post',
  'posts_per_page' => -1,
  'no_found_rows' => true,
 );

$query = new WP_Query( $args );
if ( $query->have_posts() ) {
  while ( $query->have_posts() ) {
  $query->the_post();
  get_the_ID();
  }
}
wp_reset_postdata();

パラメータ一覧

パラメータ説明
authorint | stringauthorのIDを指定
author_namestringuser_nicenameを指定
author__inarray指定authorの記事のみ取得します。
author__not_inarray指定authorの記事を除いて取得します。
catint指定カテゴリIDの記事のみ取得します。
category_namestring指定カテゴリスラッグ名の記事のみ取得します。
category__andarray指定カテゴリIDを全て含む記事のみ取得します。
category__inarray指定カテゴリIDの記事のみ取得します。
category__not_inarray指定カテゴリIDの記事を除いて取得します。
tagstring指定タグスラッグ名の記事のみ取得します。
tag_idint指定タグIDの記事のみ取得します。
tag__andarray指定タグIDを全て含む記事のみ取得します。
tag__inarray指定タグIDを含む記事を全て取得します。
tag__not_inarray指定タグIDを含まない記事のみ取得します。
tag_slug__andarray指定タグスラッグ名を全て含む記事のみ取得します。
tag_slug__inarray指定タグスラッグ名を含む記事全てを取得します。
{tax}string指定タクソノミースラッグ名を含む記事全てを取得します。Version 3.1以降非推奨です。
tax_queryarray指定タクソノミーパラメータの条件に合う記事全てを取得します。
sstring指定ワードで検索を行い条件に合う記事全てを取得します。
pint-
namestring-
titlestring-
page_idint-
pagenamestring-
post_parentint-
post_parent__not_inint-
post__inarray-
post__not_inarray-
post_name__inarray-
post_typestring | array指定投稿タイプの記事のみ取得します。
post, page, revision, attachment, nav_menu_item, any や追加したカスタム投稿タイプを指定します。
post_statusstring | array指定投稿ステータスの記事のみ取得します。
publish, pending, draft, auto-draft, future, private, inherit, trash, any を指定します。
comment_countint | arrayVersion 4.9から使用可能
nopagingboolean-
posts_per_pageint-
posts_per_archive_pageint-
offsetint-
pagedint-
pageint-
ignore_sticky_postsboolean-
orderstring | array-
orderbystring | array-
yearint-
monthnumint-
wint-
dayint-
hourint-
minuteint-
secondint-
mint-
date_queryarrayVersion 3.7から使用可能
meta_keystring-
meta_valuestring-
meta_value_numnumber-
meta_comparestring-
meta_queryarray-
post_mime_typestring | array-
cache_resultsboolean-
update_post_meta_cacheboolean-
update_post_term_cacheboolean-