edit_term_link

説明

string edit_term_link( [ string $link = '' [ , string $before = '' [ , string $after = '' [ , object $term = null [ , bool $echo = true ] ] ] ] ] )
タームの編集リンクを表示または取得する。

パラメータ

  • $link
    リンクとしてで表示する文字列(aタグの中身)を指定(省略時は''で、'Edit This'の翻訳文字列となる)。
  • $before
    aタグの前に付く文字列を指定(省略時は'')。
  • $after
    aタグの後に付く文字列を指定(省略時は'')。
  • $term
    タームを指定(省略時はnull)。
  • $echo
    表示する場合はtrue、取得する場合はfalseを指定(省略時はtrue)。

返り値

パラメータ$echoがfalseの場合はリンクの文字列を返す。

注意

ターム(カテゴリーや投稿タグなど)のアーカイブページ内ではパラメータ$termを省略できる( get_queried_object関数で現在のタームが適用される)。

ログインしているユーザがタームの編集権限を持っていない場合は何も表示されない。


使用例

  • タームアーカイブページ内でそのターム編集用リンクを表示する。
    <?php edit_term_link(); ?>
  • カテゴリーIDが10のカテゴリーの編集用リンクを表示する。
    <?php
    $cat = get_category( 10 );
    edit_term_link( '', '', '', $cat );
    ?>

フィルター

[3.1.0]表示または出力する直前に'edit_term_link'フィルターを呼び出す。パラメータ$linkには関数内で作成したリンク文字列(aタグ)が、$term_idはタームIDが格納されている。
$link = $before . apply_filters( 'edit_term_link', $link, $term_id ) . $after;

アクション

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

ソースファイル

/wp-includes/link-template.php

最終更新 : 2018年05月27日 10:45



お勧め

投稿画面のウェジェットを2列にする(2013年4月17日 更新)

ダッシュボード画面ではスクリーンレイアウトを最大4列まで選択できるのに、投稿画面は1列か2列のどちらか。高解像度のディスプレイを使っていると、投稿画面では大画面のメリットを生かせていない理由がここにあるのではと感じ、3列対応にしてみた。

プラグインの設定ページもレスポンシブ対応(2014年6月3日 更新)

レスポンシブ対応したWordPressの管理画面。プラグインやテーマのカスタマイズで管理画面を拡張しているなら、切り替わるタイミングはきっちり押さえておきたいところではないだろうか。

投稿一覧に独自リンクを追加する(2013年10月16日 更新)

管理者ページの「投稿一覧」や「固定ページ一覧」の各投稿記事はマウスポインタを移動すると、「編集」や「クイック編集」といったリンクが表示される。このリンクに独自のリンクを追加する方法を調べてみた。

Slightly troublesome permalink:プラグイン作ってみました(2017年12月17日 更新)

カテゴリーを含んだパーマリンクを設定している場合、複数のカテゴリーを指定した投稿記事のパーマリンクのURLに目的のカテゴリーとは異なるカテゴリーが適用された経験はないだろうか。このプラグインは、パーマリンクに適用されるカテゴリーをコントロールし、希望通りのパーマリンクを設定します。

HTML編集モードに定型文ボタンを追加する(2011年6月1日 更新)

投稿編集ページにはビジュアル編集モードとHTML編集モードがあり、それらを拡張するプラグインも多数存在している。そういったプラグインを利用するのもいいのだが、仕組みを理解するのも悪くないはず。というわけで、ここではHTML編集モードのボタンの仕組みと定型文を挿入するボタンを追加する方法を紹介する。