プラグインAdvanced custom fields(ACF)のacf/field_group/admin_footerアクションの使用方法・解説

概要

acf/field_group/admin_footerは、Advanced Custom Fields（ACF）の重要なアクションフックの一つであり、フィールドグループを編集するときに、「admin_footer」アクション中に発生します。このアクションは、管理画面のフッター部分にカスタムスクリプトやスタイルを追加するために使用されます。具体的には、フィールドグループの編集ページに特有の機能を実装する際によく使われます。以下はその主な使用例です：

カスタムJavaScriptを追加して、特定のフィールドの動作を強化する。
特定の条件に基づいてフィールドの表示非表示を制御するスクリプトを挿入。
ユーザーにインタラクティブな通知を表示するためのカスタムメッセージを追加。
エラーメッセージや警告を表示するためのカスタムHTMLを挿入。
エディタ内でのフィールドのパフォーマンスを向上させるための追加スクリプトを追加。
フィールドグループの状態を保存するためのAjaxスクリプトを挿入。

構文

add_action('acf/field_group/admin_footer', 'your_function_name');

function your_function_name() {
    // カスタムコードをここに記述
}

パラメータ

このアクションには特別なパラメータはありません。

戻り値

このアクションは特定の戻り値を返しませんが、実行されるカスタムコードによって様々なエフェクトが発生します。

バージョン情報

ACFバージョン: 5.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('acf/field_group/admin_footer', 'custom_acf_js');

function custom_acf_js() {
    echo '<script type="text/javascript">alert("カスタムメッセージ");</script>';
}

説明: フィールドグループ編集ページにアラートを表示するJavaScriptコードを追加しています。

サンプル 2

add_action('acf/field_group/admin_footer', 'add_custom_styles');

function add_custom_styles() {
    echo '<style>.custom-class { background-color: #f0f0f0; }</style>';
}

説明: フィールドグループ編集ページにカスタムスタイルを追加しています。

サンプル 3

add_action('acf/field_group/admin_footer', 'hide_field_by_condition');

function hide_field_by_condition() {
    echo '<script type="text/javascript">if (jQuery("#field_123").val() === "特定の値") { jQuery("#field_456").hide(); }</script>';
}

説明: 特定のフィールドの値に応じて別のフィールドを非表示にするJavaScriptを挿入しています。

サンプル 4

add_action('acf/field_group/admin_footer', 'custom_admin_message');

function custom_admin_message() {
    echo '<div class="notice notice-info is-dismissible"><p>カスタム情報メッセージ</p></div>';
}

説明: フィールドグループ編集ページにカスタムの情報メッセージを表示します。

サンプル 5

add_action('acf/field_group/admin_footer', 'ajax_save_field_state');

function ajax_save_field_state() {
    echo '<script type="text/javascript">jQuery("#submit").on("click", function() { /* Ajax処理 */ });</script>';
}

説明: フィールドグループの保存ボタンにAjax処理を追加しています。

概要

構文