wp_get_archives()


WordPressのwp_get_archives()関数は、ブログのアーカイブリンクを表示するために使用されます。これにより、月別、年別、投稿タイプ別などのアーカイブリンクを簡単に生成できます。

構文

wp_get_archives( array $args = '' );

引数の説明:

  • $args(array) — アーカイブリンクの表示方法を制御するための引数。以下のキーを持つ連想配列です。
  • type(string) — アーカイブのタイプを指定します。デフォルトは’monthly’。
  • limit(int) — 表示するアーカイブの数を指定します。
  • format(string) — アーカイブの表示形式を指定します。’html’、’option’、’link’、’custom’が利用可能。
  • before(string) — 各リンクの前に表示するテキスト。
  • after(string) — 各リンクの後に表示するテキスト。
  • show_post_count(bool) — 投稿数を表示するかどうか。
  • echo(bool) — 結果を直接出力するか、返すかを指定します。

例1: 月別アーカイブを表示

月別のアーカイブリンクを表示します。

<?php wp_get_archives(array('type' => 'monthly')); ?>

例2: 投稿数付きで年別アーカイブを表示

年別のアーカイブリンクを表示し、投稿数を表示します。

<?php wp_get_archives(array('type' => 'yearly', 'show_post_count' => true)); ?>

例3: カスタムフォーマットでアーカイブを表示

カスタムフォーマットを使用してアーカイブリンクを表示します。

<?php wp_get_archives(array('format' => 'custom', 'before' => '<li>', 'after' => '</li>')); ?>

例4: 最新の5つの月別アーカイブを表示

最新の5つの月別アーカイブリンクを表示します。

<?php wp_get_archives(array('type' => 'monthly', 'limit' => 5)); ?>

例5: 投稿タイプ別アーカイブを表示

特定の投稿タイプのアーカイブリンクを表示します。

<?php wp_get_archives(array('post_type' => 'post')); ?>

例6: アーカイブリンクを返す

アーカイブリンクを直接出力せずに返します。

<?php $archives = wp_get_archives(array('echo' => false)); echo $archives; ?>

例7: ドロップダウン形式でアーカイブを表示

アーカイブリンクをドロップダウン形式で表示します。

<?php wp_get_archives(array('type' => 'monthly', 'format' => 'option')); ?>

例8: カスタムテキスト付きアーカイブリンク

各アーカイブリンクの前後にカスタムテキストを追加します。

<?php wp_get_archives(array('before' => 'Archive: ', 'after' => '<br />')); ?>

注意点

  • wp_get_archives()は、テーマファイルやウィジェット内で使用することを想定しています。
  • カスタム投稿タイプを使用する場合、適切な引数を指定する必要があります。
  • echoをfalseに設定すると、結果が返されるため、手動で出力する必要があります。

関連機能：