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

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

「テンプレートタグ/get posts」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(en:Template Tags/get_posts 19:48, 15 May 2007 SebastienCastiel の版)
 
(原文・外部資料リンク追記)
1行目: 1行目:
 +
* 原文・最新版: [[:en:Template Tags/get_posts|WordPress Codex » Template Tags/get_posts]]
 +
* [http://bono.s201.xrea.com/2007/04/394-wp_get_posts/ power source* » WP: テンプレートタグ get_posts で新着記事リスト等を表示] -- 以下の和訳・各種使用例
 +
 
== Description ==
 
== Description ==
  
This is a simple tag for creating multiple loops.
+
マルチループ(複数ループ)を作成するためのシンプルなタグ。
  
 
== Usage ==
 
== Usage ==

2007年7月8日 (日) 18:45時点における版

Description

マルチループ(複数ループ)を作成するためのシンプルなタグ。

Usage

%%% <?php get_posts('arguments'); ?> %%%

Examples

Generate list

If you had your blog configured to show just one post on the front page, but you also wanted to show links and excerpts to the previous five posts with the category ID of 1, you could use code like this:

 <ul>
 <?php
 global $post;
 $myposts = get_posts('numberposts=5&offset=1&category=1');
 foreach($myposts as $post) :
 ?>
    <li><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a> --- <?php the_excerpt(); ?></li>
 <?php endforeach; ?>
 </ul>

Note: The above query should only be made on a category that has more than one post.

Generate another list

In the event you want to show ten posts sorted alphabetically in ascending order on your web page, you could do the following to grab the posted date, title and excerpt:

<?php
$postslist = get_posts('numberposts=10&order=ASC&orderby=post_title');
foreach ($postslist as $post) : start_wp(); ?>
<?php the_date(); echo "<br />"; ?>
<?php the_title(); ?>    
<?php the_excerpt(); ?> 
<?php endforeach; ?>

Access all post data

For various reasons some data is not available to get_posts by default, such as post content through the_content(), or the ID. This is solved by calling an internal function, setup_postdata(), with the $post array:

<?php
$lastposts = get_posts('numberposts=3');

foreach($lastposts as $post) :
    setup_postdata($post);
    ?>
    <a href="<?php the_permalink(); ?>" id="post-<?php the_ID(); ?>"><?php the_title(); ?></a>
    <?php the_content(); ?>
<?php endforeach; ?>

Another way to access the ID, without having to call setup_postdata, is to just do "$post->ID", or "$post->post_data" for the content. This lets you avoid calling internal functions.

Parameters

numberposts 
(integer) Number of posts to return. Defaults to 5.
offset 
(integer) Offset from latest post. Defaults to 0.
category 
(integer) Only show posts from this category ID. There is no default.
orderby 
("string") Sort Posts by one of various values, including:
  • 'post_title' - Sort alphabetically by Page/post title (Default).
  • 'post_date' - Sort by creation time.
  • 'post_modified' - Sort by time last modified.
  • 'ID' - Sort by numeric Post ID.
  • 'post_author' - Sort by author numeric ID.
  • 'post_name' - Sort alphabetically by Post slug.
  • Note: The orderby value can be the name of any field in the wp_post table.
order 
(string) Sort order for options. Valid values:
  • 'ASC' - Sort from lowest to highest (Default).
  • 'DESC' - Sort from highest to lowest.

Related

記事

コードドキュメンテーション

  • クラス: WP_Query - WP_Query クエリの詳細概要
  • オブジェクト: $wpdb - $wpdb オブジェクトの使い方概要
  • 関数: get_query_var()
  • 関数: query_posts() - 追加カスタムクエリの作成
  • 関数: get_post() - 項目の ID を使ってその投稿のレコードをデータベースから取得する
  • 関数: get_posts() - 項目の配列を返す特別な関数。
  • 関数: get_pages() - ページの配列を返す特別な関数。
  • 関数: have posts() - クエリが記事を返すかどうか判断する条件分岐。
  • 関数: the_post() - クエリの後に自動的にループを設定するのに使われる。
  • 関数: rewind_posts() - 現在のループをクリアする。
  • 関数: setup_postdata() - ループ内で単一クエリ結果のデータを設定する。
  • 関数: wp_reset_postdata() - 以前のクエリを復元する(通常、ループ内のもう一つのループで使われる)。
  • 関数: wp_reset_query()
  • 関数: is_main_query() - 変更するのがメインクエリであるよう保証する。
  • アクションフック: pre_get_posts - 実行される前に WordPress クエリを変更する。
  • アクションフック: the_post - 投稿オブジェクトをクエリの後に変更する。
  • フィルターフック: found_posts - found_posts WP_Query オブジェクトの値を変更する


関連

固定ページ: get_all_page_ids(), get_ancestors(), get_page_link(), get_page_by_path(), get_page_by_title(), get_page_children(), get_page_hierarchy(), get_page_uri() /en, get_pages(), is_page(), page_uri_index() /en, wp_list_pages(), wp_page_menu()


リスト・ドロップダウン関数: wp_list_authors(), wp_list_categories(), wp_list_pages(), wp_list_bookmarks(), wp_list_comments(), wp_get_archives(), wp_page_menu(), wp_dropdown_pages(), wp_dropdown_categories(), wp_dropdown_users()


関数リファレンステンプレートタグ目次もご覧ください。