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

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

テンプレートタグ/wp get archives

提供: WordPress Codex 日本語版
< テンプレートタグ
2007年10月10日 (水) 21:37時点におけるBono (トーク | 投稿記録)による版 (en:Template Tags/wp_get_archives 2007年6月10日 (日) 15:42 MichaelH 版)

(差分) ← 古い版 | 最新版 (差分) | 新しい版 → (差分)
移動先: 案内検索

Description

This function displays a date-based archives list in the same way as get_archives(). The only difference is that parameter arguments are given to the function in query string format. This tag can be used anywhere within a template.

Usage

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

Examples

Default Usage

$defaults = array('type' => 'monthly', 'limit' => '', 'format' => 'html', 
  'before' => '', 'after' => '', 'show_post_count' => false);

By default, the usage shows:

  • Monthly archives links displayed
  • Displays all archives (not limited in number)
  • Displays archives in an <li> HTML list
  • Nothing displayed before or after each link
  • Does not display the count of the number of posts
<?php wp_get_archives(); ?>

Last Twelve Months

Displays archive list by month, displaying only the last twelve.

<p><?php wp_get_archives('type=monthly&limit=12'); ?></p>

Last Fifteen Days

Displays archive list by date, displaying only the last fifteen days.

<p><?php wp_get_archives('type=daily&limit=15'); ?></p>

Last Twenty Posts

Displays archive list of the last twenty most recent posts listed by post title.

<p><?php wp_get_archives('type=postbypost&limit=20&format=custom'); ?></p>

Dropdown Box

Displays a dropdown box of Monthly archives, in select tags, with the post count displayed.

<select name="archive-dropdown" onChange='document.location.href=this.options[this.selectedIndex].value;'> 
  <option value=""><?php echo attribute_escape(__('Select Month')); ?></option> 
  <?php wp_get_archives('type=monthly&format=option&show_post_count=1'); ?> </select>

Parameters

type 
(string) The type of archive list to display. Defaults to WordPress settings. Valid values:
  • yearly
  • monthly (Default)
  • daily
  • weekly
  • postbypost
limit 
(integer) Number of archives to get. Default is no limit.
format 
(string) Format for the archive list. Valid values:
  • html - In HTML list (<li>) tags and before and after strings. This is the default.
  • option - In select (<select>) or dropdown option (<option>) tags.
  • link - Within link (<link>) tags.
  • custom - Custom list using the before and after strings.
before 
(string) Text to place before the link when using the html or custom for format option. There is no default.
after 
(string) Text to place after the link when using tge html or custom for format option. There is no default.
show_post_count 
(boolean) Display number of posts in an archive (1 - true) or do not (0 - false). For use with all type except 'postbypost'. Defaults to 0.

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()


テンプレートタグへのクエリ文字列型パラメータの渡し方関数リファレンステンプレートタグ目次もご覧ください。