プラグインCustom Post Type UIのcptui_after_update_taxonomyアクションの使用方法・解説

概要

cptui_after_update_taxonomy アクションは、Custom Post Type UI プラグインがタクソノミーを更新した後に実行されるフックです。このアクションは、タクソノミーの設定が変更された後に追加の処理を行いたい場合に便利です。

このアクションは、次のような場合に使用されることが一般的です：

タクソノミーの変更に基づいてメタデータを再構築する。
タクソノミーの変更を記録するためにログエントリーを作成する。
タクソノミーのスラッグや名前を変更した際にURLリダイレクトを設定する。
タクソノミーのタームに対してカスタムフィールドを追加する。
タクソノミーの設定変更後にキャッシュをクリアする。
他のプラグインやテーマの機能に影響を与える設定にフックする。

構文

add_action('cptui_after_update_taxonomy', 'custom_function_name', 10, 2);

パラメータ

$taxonomy : 更新されたタクソノミーのスラッグ。
$args : 更新されたタクソノミーの引数を含む配列。

戻り値

このアクションは戻り値を返さず、主に更新処理を実行するために使われます。

使用可能なバージョン

Custom Post Type UI プラグインバージョン: 1.0以上
WordPress バージョン: 4.0以上

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

アクション	使用可能性
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

サンプルコード

サンプル1: タクソノミー変更後にログを記録する

add_action('cptui_after_update_taxonomy', 'log_taxonomy_update', 10, 2);

function log_taxonomy_update($taxonomy, $args) {
    error_log("タクソノミー '{$taxonomy}' が更新されました。");
}

このコードは、タクソノミーが更新されるたびにエラーログにその情報を記録します。

サンプル2: タクソノミーのメタデータを再構築する

add_action('cptui_after_update_taxonomy', 'rebuild_taxonomy_meta', 10, 2);

function rebuild_taxonomy_meta($taxonomy, $args) {
    // タクソノミーに関連するメタデータの再構築処理を実行
    // ここにカスタムコードを挿入
}

このコードは、タクソノミーが更新された際に関連するメタデータを再構築します。

サンプル3: タクソノミー変更時に通知を送信する

add_action('cptui_after_update_taxonomy', 'send_taxonomy_update_notification', 10, 2);

function send_taxonomy_update_notification($taxonomy, $args) {
    wp_mail('admin@example.com', 'タクソノミー更新通知', "タクソノミー '{$taxonomy}' が更新されました。");
}

このコードでは、タクソノミーが更新された際に管理者にメール通知を送信します。

サンプル4: タクソノミーのキャッシュをクリアする

add_action('cptui_after_update_taxonomy', 'clear_taxonomy_cache', 10, 2);

function clear_taxonomy_cache($taxonomy, $args) {
    // タクソノミーのキャッシュをクリア
    delete_transient('taxonomy_cache_' . $taxonomy);
}

このコードは、タクソノミーが更新されると関連するキャッシュをクリアします。

サンプル5: タクソノミーのタームにカスタムフィールドを追加する

add_action('cptui_after_update_taxonomy', 'add_custom_fields_to_terms', 10, 2);

function add_custom_fields_to_terms($taxonomy, $args) {
    // 新たにカスタムフィールドを追加する処理を実行
}

このコードは、タクソノミーが更新された際にそのタクソノミーに関連するタームにカスタムフィールドを追加します。

概要

構文