ワードプレスのedit_term_linkフィルタの使用方法・解説

概要

edit_term_linkフィルタは、タームの編集リンクを表示する際に使われるフィルタです。このフィルタを利用することで、リンクにカスタムのクラスや属性を追加したり、URLを変更したりすることができます。以下は、このフィルタがよく使われる機能の例です。

1. ターム編集リンクのスタイリング
2. カスタムURLを設定
3. 新しいカテゴリーやタグ追加リンクの調整
4. 編集リンクにアイコンを追加
5. 特定のユーザーのための限定機能
6. 管理者特権の制御
7. メタデータをリンクに追加
8. フロントエンドでの表示のカスタマイズ

構文

add_filter('edit_term_link', 'my_custom_edit_term_link', 10, 3);

パラメータ

• $term_link (string) – 編集リンクのURL
• $term_id (int) – タームのID
• $taxonomy (string) – タクソノミーの名前

戻り値

• 編集リンクのカスタマイズされたHTML。

関連する関数

edit_term_link

使用可能なバージョン

edit_term_linkフィルタは、WordPress 3.0.0以降で利用可能です。

コアファイルのパス

このフィルタは、wp-includes/taxonomy.phpに含まれています。

サンプルコード

サンプルコード1: 編集リンクにカスタムクラスを追加

add_filter('edit_term_link', 'add_custom_class_to_edit_term_link', 10, 3);
function add_custom_class_to_edit_term_link($term_link, $term_id, $taxonomy) {
    return str_replace('class="', 'class="custom-class ', $term_link);
}

このコードは、ターム編集リンクに custom-class というクラスを追加します。

サンプルコード2: 編集リンクを HTTPS に変更

add_filter('edit_term_link', 'force_https_edit_term_link', 10, 3);
function force_https_edit_term_link($term_link, $term_id, $taxonomy) {
    return str_replace('http://', 'https://', $term_link);
}

このコードは、編集リンクのURLをHTTPからHTTPSへ変更します。

サンプルコード3: 編集リンクにカスタムテキストを追加

add_filter('edit_term_link', 'modify_edit_term_link_text', 10, 3);
function modify_edit_term_link_text($term_link, $term_id, $taxonomy) {
    return str_replace('Edit term', 'Modify this term', $term_link);
}

このコードは、ターム編集リンクのテキストをカスタマイズします。

サンプルコード4: タームIDをリンクに追加

add_filter('edit_term_link', 'add_term_id_to_link', 10, 3);
function add_term_id_to_link($term_link, $term_id, $taxonomy) {
    return $term_link . ' (ID: ' . $term_id . ')';
}

このコードは、編集リンクの後にタームIDを追加します。

サンプルコード5: 管理者でない場合のリンク削除

add_filter('edit_term_link', 'remove_edit_link_for_non_admins', 10, 3);
function remove_edit_link_for_non_admins($term_link, $term_id, $taxonomy) {
    if (!current_user_can('manage_options')) {
        return ''; // 管理者でない場合はリンクを削除
    }
    return $term_link;
}

このコードは、管理者でないユーザーにターム編集リンクを表示しないようにします。

この関数のアクションでの使用可能性

アクション	使用可能性
mu_plugin_loaded
registered_post_type
plugins_loaded
wp_roles_init
setup_theme
after_setup_theme
set_current_user
init
register_sidebar
wp_loaded
send_headers
parse_query
pre_get_posts
wp
template_redirect
get_header
wp_head

このフィルタは特定のバージョンで非推奨または削除されていません。