get_pages

パラメータ

• $args
  検索条件を文字列または連想配列で指定（省略時は''）。主なキーワードは次の通り。

  キーワード	意味
  child_of	子孫のページを取得するための親固定ページのID（省略時は0）
  sort_order	並び順として'ASC'か'DESC'を指定（省略時は'ASC'）。
  sort_column	ソート対象として'ID'、'post_title'、'menu_order'などのカラム名か'rand'、'comment_count'を指定（省略時は'post_title'）
  hierarchical	下階層を取得する場合は1、しない場合は0を指定（省略時は1）
  exclude	除外する固定ページのID（省略時はarray()）
  include	取得する固定ページのID（省略時はarray()）
  meta_key	カスタムフィールドの名前（省略時は''）
  meta_value	カスタムフィールドの値（省略時は''）
  authors	投稿者ID。複数指定する場合は空白文字かカンマで区切る（省略時は''）
  parent	親の固定ページのID（省略時は-1）
  exclude_tree	除外する親固定ページのID（省略時は''）
  number	取得件数（省略時は''）
  offset	取得位置を示すオフセット（省略時は0）
  post_type	投稿情報タイプ（省略時は'page'）
  post_status	投稿ステータスを示す'auto-draft'、'draft'、'inherit'、'private'、'publish'、'any'など（省略時は'publish'）

返り値

注意

投稿ページを取得する get_posts関数の固定ページ版的な位置づけの関数で、検索条件のパラメータは多少異なっている。

includeパラメータを指定した場合は、以下のパラメータは強制的に書き換えられる。

またchild_ofとparentキーワードの違いは、取得する階層にある。child_ofキーワードを指定した場合はそれ以下すべてが対象になるが、parentはその直下のみが対象になる。

[6.3.0]'get_pages_query_args'フィルターが追加された。

使用例

• 公開されているすべての固定ページを取得する。
  <?php $pages = get_pages(); ?>
• 文字列で条件を指定して固定ページを取得する。
  <?php $pages = get_pages( 'number=10' ); ?>
• 連想配列で条件を指定して固定ページを取得する。
  <?php $pages = get_pages( array( 'number'=>10, 'offset'=>10) ); ?>

フィルター

$query_args = apply_filters( 'get_pages_query_args', $query_args, $parsed_args );

return apply_filters( 'get_pages', $pages, $parsed_args );

アクション

ソースファイル