説明
string | false get_the_term_list( int $post_id, string $taxonomy [ , string $before = '' [ , string $sep = ', ' [ , string $after = '' ] ] ] )
投稿のタームのリンク文字列を取得する。
パラメータ
- $post_id投稿IDを指定。
- $taxonomyタクソノミー名を指定。
- $before最初のタームの前に表示する文字列を指定(省略時は'')。
- $sepタームとタームの間に入る区切り文字列を指定(省略時は'')。
- $after最後のタームの後に表示する文字列を指定(省略時は'')。
返り値
投稿のタームのリンク文字列を返す。タームを取得できなかった場合はfalseまたはWP_Errorオブジェクトを返す。
注意
get_the_terms関数により、投稿のタームを取得している。
パラメータ$sepの省略時の値は''になり、 the_terms関数とは異なる。
タームのリンク文字列は次のような書式となる。
<a href="タームのURL" rel="tag">ターム名</a>使用例
- 投稿タグのリンク文字列を取得する。
$links = get_the_term_list( $post->ID, 'post-tag' ); - 区切り文字を指定して投稿タグのリンク文字列を取得する。
$links = get_the_term_list( $post->ID, 'post-tag', '', '、' );
フィルター
[2.5.0]タームのリンク文字列を連結する前に"term_links-{$taxonomy}"フィルターを呼び出す。パラメータ$linksにはタームのリンク文字列の配列が格納されている。$term_links = apply_filters( "term_links-{$taxonomy}", $links );アクション
直接実行するアクションはありません。ソースファイル
/wp-includes/category-template.php最終更新 : 2023年07月28日 11:33
関連
お勧め
meta_compare_key使ってみた(2019年3月19日 更新)
ブロックエディターの登場により、標準のカスタムフィールドを使う機会はかなり減った気がする。そんな中、5.1.0で追加されたのが、カスタムフィールド名(メタキー)に含まれる文字列を指定する'meta_compare_key'キーだ。
WP_List_Tableクラスの「一括操作」フォームを使ってみた(2018年5月27日 更新)
今回は「WP_List_Tableクラスを使ってみた」の続き。投稿一覧やプラグインページなどにある「一括操作」(Bulkアクション)フォーム対応に関するメモである。
テーマから投稿画像のサイズを指定する(2012年3月15日 更新)
投稿記事に挿入する画像サイズは、サムネイル(150×150)、中サイズ(300×300)、大サイズ(1024×1024)がデフォルトだが、テーマによっては別のサイズを指定したい場合はある。基本的には、「設定」-「メディア」の「メディア設定」ページで指定できるが、テーマ内のfunctions.phpで設定しておくとちょっと便利かもしれない。ログインページを変える(2014年9月12日 更新)
WordPressの標準的な不正ログイン対策としては、ログインIDは'admin'を避けるパスワードはユニークで長くする、場合によってはアクセスできるIPアドレスを制限する、といった具合だろう。これらの他に何かできないものだろうかと、ちょっと考えてみた。新規投稿時の本文プレースホルダーテキストを変える(2021年9月9日 更新)
ブロックエディターに影響を与えるフィルターは多数存在する。今回紹介するフィルターはその1つで、新規投稿時の本文ブロックのプレースホルダーテキストを変更するものだ。