get_term_link

（2.5.0以降）
get_term_link - タームのリンク文字列を取得する

説明

string get_term_link( mixed $term [ , string $taxonomy = '' ] )
カテゴリーや投稿タグなどのタームのリンク文字列を取得する。

パラメータ

  • $term
    タームのIDかオブジェクトを指定。
  • $taxonomy
    'category'、'post_tag'などのタクソノミー名を指定（省略時は''）。

返り値

タームのリンク文字列を返す。パラメータ$termが無効な値の場合は、エラー内容を示すWP_Errorオブジェクトを返す。

注意

カテゴリーの場合のリンク文字列の書式は次の通り（1の部分にはそのカテゴリーのIDが入る）。
http://ドメイン名/?cat=1
投稿タグの場合のリンク文字列の書式は次の通り（slugの部分にはその投稿タグのスラッグが入る）。
http://ドメイン名/?tag=slug

[2.5.0]'term_link'フィルターが追加され、'tag_link'および'category_link'フィルターは非推奨となった。

[5.4.1]バージョン2.5.0で非推奨になっていた'tag_link'フィルターおよび'category_link'フィルターが復活した。

使用例

  • カテゴリーIDが1のリンク文字列を取得する。
    <?php $link = get_term_link( 1, 'category' ); ?>
  • 投稿タグIDが11のリンク文字列を取得する。
    <?php $link = get_term_link( 11, 'post_tag' ); ?>

フィルター

[4.9.0]パーマリンクを作成する前に'pre_term_link'フィルターを呼び出す。パラメータ$termlinkにはパーマリンクのパターン（例：標準のカテゴリーの場合は'/category/%category%'）が、$termにはターム情報のオブジェクトが格納されている。 
$termlink = apply_filters( 'pre_term_link', $termlink, $term );
[2.3.0][5.4.1]パラメータ$taxonomyが'post_tag'の場合は'term_link'フィルターを呼び出す前に'tag_link'フィルターを呼び出す。パラメータ$termlinkにはパーマリンクが、$term_idにはタームIDが格納されている。 
$termlink = apply_filters( 'tag_link', $termlink, $term_id );
[1.5.0][5.4.1]パラメータ$taxonomyが'category'の場合は'term_link'フィルターを呼び出す前に'tag_link'フィルターを呼び出す。パラメータ$termlinkにはパーマリンクが、$term_idにはタームIDが格納されている。 
$termlink = apply_filters( 'category_link', $termlink, $term_id );
[2.5.0]パーマリンクを返す前に'term_link'フィルターを呼び出す。パラメータ$termlinkにはパーマリンクが、$termにはターム情報のオブジェクトが、$taxonomyにはタームのタクソノミー名（例：'category'）が格納されている。 
return apply_filters( 'term_link', $termlink, $term, $taxonomy );

アクション

実行するアクションはありません。

ソースファイル

/wp-includes/taxonomy.php

最終更新 : 2020年05月07日 13:58

関連

参考

Code Reference: get_term_link

お勧め

ダッシュボードの「クイックドラフト」を「CodeMirror」に変更してみた（2019年11月5日 更新）

管理ページの「テーマエディター」では4.9以降「CodeMirror」が利用されている。今回はこの「CodeMirror」をプラグインで活用できないか調べた話である。

headタグのmeta（generator）タグを取り除く（2018年5月27日 更新）

標準的なWordPressのテーマで出力されるHTMLには、headタグ内に次のようなmetaタグが出力されている。 
<meta name="generator" content="WordPress 3.0.5" />

Blacklist keys manager：プラグイン作ってみました（2015年5月22日 更新）

少し前から明らかにスパムと思われるコメントが投稿され、そのモデレーションメールを受け取る回数が増えてきた。あまりにもあからさまなコメントばかりなので、何らかの対策ができないか考えてみました。

5.5の機能強化：テーマ変更時に要求バージョンを確認（2020年8月12日 更新）

WordPress 5.5 RC 2が公開され、来週には正式版がリリース。変更箇所が多い「WordPress 5.5 RC 2（以降RC 2）」のソースコードを眺めていると、テーマの切り替え前にWordPressとPHPのバージョンを確認するようになっていた。

投稿内容に応じてwpautopを制御する（2013年8月13日 更新）

投稿内容を表示する the_content関数では、 wpautop関数がフィルターの1つとして呼び出され、改行をbrタグに変換したり、pタグで調整したりする。この機能自体は便利なのだが、きちんとデザインされたHTMLソースを流し込んだ場合はこの機能は好ましくない。そんなわけで、記事内容に応じてwpautop関数を制御できないか考えてみた。