• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

テンプレートタグ/query posts

提供: WordPress Codex 日本語版
< テンプレートタグ
2008年3月31日 (月) 07:56時点におけるNao (トーク)による版 (2006年8月に作成した翻訳データの流し込み(暫定版、要フォーマット))

(差分) ← 古い版 | 最新版 (差分) | 新しい版 → (差分)
移動先: 案内検索
  • 書式: <?php get_posts('arguments'); ?>
  • 説明: ループ内でクエリーを変更するために使う。詳しくは、WordPressループ解説ページを参照。
  • 位置: ループ内
  • 引数:
    • numberposts (整数)- 取得する記事の数。デフォルト値は5。
    • offset (整数)- 最新記事からのオフセット。例えば2を指定すると、最新記事2つは無視され、その前の記事を1つ目として取得する。デフォルト値は0。
    • category (整数)- 出力するカテゴリーのID。デフォルト値は空(すべてのカテゴリーを出力)。
    • orderby (規定値)- 取得した記事の並べ方。さらに、これら以外のデータベースのwp_postテーブル内のフィールド値も指定できる。
      • post_title(記事名順)
      • post_date(記事の投稿日)
      • post_modified(記事の更新日順)
      • ID(デフォルト。記事ID順)
      • post_author(投稿者のID順)
      • post_name(記事の投稿スラッグ順)
    • order (整数)- 取得した記事の並び順。orderbyで指定した並べ方に基づく。
      • asc(デフォルト。orderbyで指定したルールに従い、昇順に並べる)
      • desc(降順に並べる)
  • コード記述例:
<?php
  $posts = get_posts('numberposts=3&category=1');
?>
<h2>最新アウトドア関連情報</h2>
  <ul>
<?php
  foreach($posts as $post) :
?>
    <li><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></li>
<?php endforeach; ?>
  </ul>
  • 出力例:
<h2>最新アウトドア関連情報</h2>
  <ul>
    <li><a href="http://example.com/?p=12">山登り</a></li>
    <li><a href="http://example.com/?p=6">滝修行</a></li>
    <li><a href="http://example.com/?p=3">キャンプへ</a></li>
  </ul>