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

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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(説明)
(残りを和訳。クリーンアップ。)
 
1行目: 1行目:
== 説明 ==
+
{{CheckTrans}}
  
特定の月別アーカイブページへの[[Glossary#URI and URL|URL]]を[[Glossary#PHP|PHP]]の値として返します。ループ内・外で使用。 
+
== 説明 ==
  
これはURLは表示されません。年と月のパラメータは<tt>&#39;&#39;</tt>に設定されている場合、タグは現在の月のアーカイブのためのURLを返します。
+
[[Glossary#PHP|PHP]] で使えるように、指定した年・月の月別アーカイブの [[Glossary#URI and URL|URL]] を返します。これは URL を表示しません。年・月のパラメータに <tt>&#39;&#39;</tt> を指定すると、このタグは当月のアーカイブの URL を返します。
  
プラグインやテーマでは、[[Plugin_API/Action_Reference/setup_theme|setup_theme]] /[[:en :Plugin_API/Action_Reference/setup_theme|en]]アクションとして使用することができます。 [[Plugin_API/Action_Reference/plugins_loaded|plugins_loaded]] /[[:en:Plugin_API/Action_Reference/plugins_loaded|en]]を含む以前の使用法は、fatal エラーを生成します。
+
プラグインやテーマでは、[[プラグイン API/アクションフック一覧/setup_theme|setup_theme]] /[[:en:Plugin_API/Action_Reference/setup_theme|en]] アクションの呼び出し以降にこれを使用することができます。それより早くに([[プラグイン API/アクションフック一覧/plugins_loaded|plugins_loaded]] /[[:en:Plugin_API/Action_Reference/plugins_loaded|en]] を含む)使用すると Fatal エラーを起こします。
  
 
==使い方 ==
 
==使い方 ==
13行目: 13行目:
 
== パラメータ ==
 
== パラメータ ==
  
{{Parameter|year|真または偽/整数|年のアーカイブ。現在の年にするには<tt>&#39;&#39;</tt>(空欄)を使用します。|オプション}}
+
{{Parameter|$year|真偽値/整数|アーカイブの年。今年を指定するには <tt>&#39;&#39;</tt> または <tt>false</tt> を使う。}}
{{Parameter|month|真または偽/整数|月のアーカイブ。 現在の月にするには<tt>&#39;&#39;</tt>(空欄)を使用します。|オプション}}
+
{{Parameter|$month|真偽値/整数|アーカイブの月。今月を指定するには <tt>&#39;&#39;</tt> または <tt>false</tt> を使う。}}
  
 
== 用例 ==
 
== 用例 ==
  
=== 月アーカイブをリンクとして ===
+
=== 当月のアーカイブをリンクとして表示 ===
  
現在の月間のアーカイブをリンクとしてURLを返します、PHP echoとして、別のタグの間に入れて表示します。
+
返した URL を A タグの中へ入れる(PHP の echo コマンドで表示)することにより、当月のアーカイブへのリンクを表示します。
  
 
<pre>
 
<pre>
<a href="<?php echo get_month_link('', ''); ?>">All posts this month</a>
+
<a href="<?php echo get_month_link( '', '' ); ?>">今月のすべての投稿</a>
 
</pre>
 
</pre>
  
=== 変数に特定の月の割り当てる===
+
=== 特定の月別アーカイブの URL を変数へ入れる ===
  
2004年10月のアーカイブのURLを返し、変数$ oct_04に割り当てます。変数は、ページ内の他の場所で使用することができます。
+
返された2004年10月のアーカイブの URL を変数 $oct_04 へ入れます。この変数はページ内の他の場所で使えます。
  
 
<pre>
 
<pre>
<?php $oct_04 = get_month_link('2004', '10'); ?>
+
<?php $oct_04 = get_month_link( '2004', '10' ); ?>
 
</pre>
 
</pre>
  
=== PHP変数を使う ===
+
=== PHP の変数に入れて使用 ===
  
PHP code block for use within [[The Loop]]: Assigns year and month of a post to the variables $arc_year and $arc_month. These are used with the get_month_link() tag, which returns the URL as a link to the monthly archive for that post, displaying it within an anchor tag with the PHP echo command.
+
[[ループ]]内で使う PHP コードブロックの例です。まず投稿の年・月を変数 $archive_year、$archive_month へ入れます。これを get_month_link() タグで使って、その投稿を含む月別アーカイブのリンクとして URL を取得します。そして A タグの中へ PHP echo コマンドで出力します。
[[テンプレートタグ/get_the time|get_the_time()]]タグに使用する書式文字列の情報のための[[Formatting Date and Time|日付と時刻の書式]]をご参照ください。
+
 
 +
[[テンプレートタグ/get_the time|get_the_time()]] タグで使う形式指定用の文字列については [[Formatting Date and Time|日付と時刻の書式]] を見てください。
  
 
<pre>
 
<pre>
<?php $archive_year  = get_the_time('Y'); ?>
+
<?php $archive_year  = get_the_time( 'Y' ); ?>
<?php $archive_month = get_the_time('m'); ?>
+
<?php $archive_month = get_the_time( 'm' ); ?>
  
<a href="<?php echo get_month_link( $archive_year, $archive_month ); ?>">
+
<a href="<?php echo get_month_link( $archive_year, $archive_month ); ?>"><?php the_time('F Y'); ?>のアーカイブ</a>
Archive for <?php the_time('F Y'); ?>
+
</a>
+
 
</pre>
 
</pre>
  
== 更新履歴 ==
+
== 変更履歴 ==
  
 
新規導入: 1.0.0
 
新規導入: 1.0.0
54行目: 53行目:
 
== ソースファイル ==
 
== ソースファイル ==
  
<tt>get_month_link()</tt> は {{Trac|wp-includes/link-template.php}}にあります。
+
<tt>get_month_link()</tt> は {{Trac|wp-includes/link-template.php}} にあります。
  
 
== 関連項目 ==
 
== 関連項目 ==
 
  
 
{{Tag Date Tags}}
 
{{Tag Date Tags}}
63行目: 61行目:
 
{{Tag Footer}}
 
{{Tag Footer}}
  
{{NeedTrans}}
+
{{原文|Function_Reference/get_month_link|146160}} <!-- 01:46, 28 August 2014 Adiant 版 -->
 
+
{{原文|Template Tags/get_month_link|146160}} <!-- 01:46, 28 August 2014‎ Adiant 版 -->
+
  
{{DEFAULTSORT:get_month_link}}
+
{{DEFAULTSORT:Get_month_link}}
 +
[[Category:関数]]
  
[[en:Template Tags/get_month_link]]
+
[[en:Function_Reference/get_month_link]]

2016年5月3日 (火) 22:34時点における最新版

この項目「テンプレートタグ/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最新版との差分