概要
get_year_link関数は、特定の年に関連するアーカイブページのURLを生成するために使用されます。この関数を使用することで、年アーカイブのURLを取得し、簡単にリンクを作成できるため、年ごとの投稿を整理するのに役立ちます。特に以下のようなシナリオで利用されることが多いです。
- 年間アーカイブのナビゲーションメニューを作成する
- 年別投稿一覧ページへのリンクを生成する
- フッターやサイドバーに年アーカイブリンクを表示する
- 特定の年の投稿をフロントエンドで表示する
- 投稿の投稿日を基に年リンクを生成する
- 年別統計情報のページを作成する
- 年アーカイブページへのリダイレクトを管理する
- 投稿一覧のフィルタリング機能の一部として機能する
構文
get_year_link( int $year )
パラメータ
$year(int): 年を示す整数値（例: 2023）
戻り値
- (string): 指定された年に関連付けられたアーカイブページのURL
関連する関数
使用可能なバージョン
- この関数は最新のWordPressバージョンから使用できます。
コアファイルのパス
wp-includes/link.php
この関数のアクションでの使用可能性
| アクション | 使用例 |
|---|---|
| mu_plugin_loaded | |
| registered_post_type | |
| plugins_loaded | |
| wp_roles_init | |
| setup_theme | |
| after_setup_theme | |
| set_current_user | |
| init | |
| register_sidebar | |
| wp_loaded | |
| send_headers | |
| parse_query | |
| pre_get_posts | |
| wp | |
| template_redirect | |
| get_header | |
| wp_head |
サンプルコード
サンプルコード 1: 年アーカイブリンクを表示する
$year = 2023;
$year_link = get_year_link($year);
echo '<a href="' . esc_url($year_link) . '">2023年の投稿</a>';
このコードは、指定した年（2023年）のアーカイブページへのリンクを表示します。
サンプルコード 2: 現在の年のアーカイブリンクを表示する
$current_year = date('Y');
$year_link = get_year_link($current_year);
echo '<a href="' . esc_url($year_link) . '">現在の年のアーカイブ</a>';
このコードは、現在の年のアーカイブページへのリンクを生成し、表示します。
サンプルコード 3: 年アーカイブを生成するループ
$years = range(2000, date('Y'));
foreach ($years as $year) {
$year_link = get_year_link($year);
echo '<a href="' . esc_url($year_link) . '">' . $year . '年のアーカイブ</a><br>';
}
このコードは、2000年から現在の年までのアーカイブリンクをリスト表示します。
サンプルコード 4: 年リンクのカスタマイズ
$year = 2022;
$year_link = get_year_link($year);
echo '<button onclick="window.location.href='' . esc_url($year_link) . ''">2022年の投稿を見る</button>';
このコードは、ボタンをクリックすることで特定の年のアーカイブページに遷移できるリンクを作成します。
サンプルコード 5: 年アーカイブへのリンクをリスト化
$years = get_posts(array(
'post_type' => 'post',
'year' => '2023',
'posts_per_page' => -1
));
if ($years) {
echo '<ul>';
foreach ($years as $year) {
$year_link = get_year_link(get_the_date('Y', $year->ID));
echo '<li><a href="' . esc_url($year_link) . '">' . get_the_date('Y', $year->ID) . '年の投稿</a></li>';
}
echo '</ul>';
}
このコードは、2023年の投稿をリストし、それぞれの投稿が属する年のアーカイブリンクを提供します。