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

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

テンプレートタグ/get month link

提供: WordPress Codex 日本語版
移動先: 案内検索

この項目「テンプレートタグ/get month link」は、翻訳チェック待ちの項目です。加筆、訂正などを通して、Codex ドキュメンテーションにご協力下さい。

説明

PHP で使えるように、指定した年・月の月別アーカイブの URL を返します。これは URL を表示しません。年・月のパラメータに '' を指定すると、このタグは当月のアーカイブの URL を返します。

プラグインやテーマでは、setup_theme /en アクションの呼び出し以降にこれを使用することができます。それより早くに(plugins_loaded /en を含む)使用すると Fatal エラーを起こします。

使い方

<?php get_month_link( $year, $month ); ?>

パラメータ

$year
真偽値/整数) (必須) アーカイブの年。今年を指定するには '' または false を使う。
初期値: なし
$month
真偽値/整数) (必須) アーカイブの月。今月を指定するには '' または false を使う。
初期値: なし

用例

当月のアーカイブをリンクとして表示

返した URL を A タグの中へ入れる(PHP の echo コマンドで表示)することにより、当月のアーカイブへのリンクを表示します。

<a href="<?php echo get_month_link( '', '' ); ?>">今月のすべての投稿</a>

特定の月別アーカイブの URL を変数へ入れる

返された2004年10月のアーカイブの URL を変数 $oct_04 へ入れます。この変数はページ内の他の場所で使えます。

<?php $oct_04 = get_month_link( '2004', '10' ); ?>

PHP の変数に入れて使用

ループ内で使う PHP コードブロックの例です。まず投稿の年・月を変数 $archive_year、$archive_month へ入れます。これを get_month_link() タグで使って、その投稿を含む月別アーカイブのリンクとして URL を取得します。そして A タグの中へ PHP の echo コマンドで出力します。

get_the_time() タグで使う形式指定用の文字列については 日付と時刻の書式 を見てください。

<?php $archive_year  = get_the_time( 'Y' ); ?>
<?php $archive_month = get_the_time( 'm' ); ?>

<a href="<?php echo get_month_link( $archive_year, $archive_month ); ?>"><?php the_time('F Y'); ?>のアーカイブ</a>

変更履歴

新規導入: 1.0.0

ソースファイル

get_month_link()wp-includes/link-template.php にあります。

関連項目

日時に関連するタグ: get_calendar(), get_day_link(), get_month_link(), get_the_date(), get_the_time(), get_year_link(), single_month_title(), the_date(), the_date_xml(), the_modified_date(), get_the_modified_date(), the_modified_time(), get_the_modified_time(), the_time()


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


最新英語版: WordPress Codex » Function_Reference/get_month_link最新版との差分