プラグインNinja Formsのninja_forms_display_after_formアクションの使用方法・解説

概要

ninja_forms_display_after_formは、Ninja Formsのフォームが表示された後に実行されるアクションフックです。このフックを使用することで、フォームの後に追加のHTMLやJavaScriptを挿入したり、カスタムメッセージを表示したりすることができます。よく使用される場面は以下の通りです。

フォーム送信後のサンクスメッセージを表示する
フォームの下に関連する情報や注意事項を追加する
フォームの周りにカスタムスタイルを適用する
JavaScriptを使って特定の動作を追加する
ウェブサイトの分析ツールにイベントトラッキングを送信する
カスタムフィールドを利用してデータを追加する

構文

add_action('ninja_forms_display_after_form', 'your_function_name', 10, 2);

パラメータ

$form_data: フォームのデータ
$form_id: フォームのID

戻り値

このアクションは何も戻り値を返しません。

バージョン

Ninja Formsのバージョン: 3.x以降
WordPressのバージョン: 5.x以降

サンプルコード

サンプルコード 1

add_action('ninja_forms_display_after_form', 'add_thank_you_message', 10, 2);
function add_thank_you_message($form_data, $form_id) {
    echo '<p>ご利用いただきありがとうございます！フォームが送信されました。</p>';
}

このコードは、Ninja Formsのフォームが表示された後に、感謝メッセージを追加します。

サンプルコード 2

add_action('ninja_forms_display_after_form', 'insert_custom_html', 10, 2);
function insert_custom_html($form_data, $form_id) {
    echo '<div class="custom-note">注意: 入力内容を確認してください。</div>';
}

このコードは、フォームの下にカスタム注意メッセージを挿入します。

サンプルコード 3

add_action('ninja_forms_display_after_form', 'enqueue_custom_script', 10, 2);
function enqueue_custom_script($form_data, $form_id) {
    ?>
    <script>
        // 送信完了時にアラートを表示するカスタムスクリプト
        alert('フォームが送信されました！');
    </script>
    <?php
}

このコードは、フォームが表示された後にJavaScriptを使ってアラートを表示します。

サンプルコード 4

add_action('ninja_forms_display_after_form', 'track_form_submission_event', 10, 2);
function track_form_submission_event($form_data, $form_id) {
    ?>
    <script>
        // Google Analyticsなどのイベントトラッキングコード
        ga('send', 'event', 'フォーム', '送信', 'フォームID: <?php echo $form_id; ?>');
    </script>
    <?php
}

このコードは、フォームの送信イベントをGoogle Analyticsなどの分析ツールに送信します。

サンプルコード 5

add_action('ninja_forms_display_after_form', 'add_custom_styles', 10, 2);
function add_custom_styles($form_data, $form_id) {
    echo '<style>.custom-note { color: red; font-weight: bold; }</style>';
}

このコードは、フォーム表示後にカスタムスタイルを定義し、関連する要素に適用します。

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

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

概要

構文