Amazonで商品を見る セール会場へ

Snow Monkey Formsのフック23例|アクション・フィルターの使い方

Web制作時のお問い合わせフォームはブロックエディタで編集できるSnow Monkey Formsを重宝しています。

まずブロックやフォーム設定で実現できるかを確認します。

設定で対応できない送信条件や表示を変更したい場合に、フックを使ったカスタマイズを検討します。

そこでSnow Monkey Formsに用意されているアクションフック・フィルターフックを調査してみました。

一覧は2024年4月の調査を起点としています。

2026年10月21日にSMF 13.0.0の保存ソースと掲載23例を再照合しました。

後半の実行記録は2026年10月2日・3日のもので、今回の再実行結果ではありません。

Snow Monkey Forms の設定・カスタマイズ方法はこちらにまとめています。

目次

著者

WEB制作をしているデジタルノマド
WordPressのカスタマイズが好きで、色々と自作しています。

WordPressのカスタマイズに困ったらご相談ください!

Snow Monkey Formsのフィルターフック・アクションフックのデータの一覧

コードを調査した結果、2024年4月の調査で取り上げたフックは以下の23個です。

現行版に存在するフックの総数を示すものではありません。

初回調査ではString Locatorを使用しました。

表のファイルパスはフック名が見つかる参照先です。

form/appendのReCaptcha.phpはコールバック登録側であり、フックを実行する位置そのものではありません。

スクロールできます
フック名ファイルの場所
snow_monkey_forms/complete/messagewp-content/plugins/snow-monkey-forms/App/Controller/Complete.php
snow_monkey_forms/system_error/messagewp-content/plugins/snow-monkey-forms/App/Controller/SystemError.php
snow_monkey_forms/administrator_mailer/skipwp-content/plugins/snow-monkey-forms/App/Model/AdministratorMailer.php
snow_monkey_forms/administrator_mailer/is_sendedwp-content/plugins/snow-monkey-forms/App/Model/AdministratorMailer.php
snow_monkey_forms/administrator_mailer/after_sendwp-content/plugins/snow-monkey-forms/App/Model/AdministratorMailer.php
snow_monkey_forms/administrator_mailer/headerswp-content/plugins/snow-monkey-forms/App/Model/AdministratorMailer.php
snow_monkey_forms/administrator_mailer/argswp-content/plugins/snow-monkey-forms/App/Model/AdministratorMailer.php
snow_monkey_forms/auto_reply_mailer/skipwp-content/plugins/snow-monkey-forms/App/Model/AutoReplyMailer.php
snow_monkey_forms/auto_reply_mailer/is_sendedwp-content/plugins/snow-monkey-forms/App/Model/AutoReplyMailer.php
snow_monkey_forms/auto_reply_mailer/after_sendwp-content/plugins/snow-monkey-forms/App/Model/AutoReplyMailer.php
snow_monkey_forms/auto_reply_mailer/headerswp-content/plugins/snow-monkey-forms/App/Model/AutoReplyMailer.php
snow_monkey_forms/auto_reply_mailer/argswp-content/plugins/snow-monkey-forms/App/Model/AutoReplyMailer.php
snow_monkey_forms/saved_files/survival_timewp-content/plugins/snow-monkey-forms/App/Model/Directory.php
snow_monkey_forms/mailer/headerswp-content/plugins/snow-monkey-forms/App/Model/Mailer.php
snow_monkey_forms/custom_mail_tagwp-content/plugins/snow-monkey-forms/App/Model/MailParser.php
snow_monkey_forms/control/attributeswp-content/plugins/snow-monkey-forms/App/Model/Setting.php
snow_monkey_forms/checkboxes/optionswp-content/plugins/snow-monkey-forms/App/Model/Setting.php
snow_monkey_forms/select/optionswp-content/plugins/snow-monkey-forms/App/Model/Setting.php
snow_monkey_forms/radio_buttons/optionswp-content/plugins/snow-monkey-forms/App/Model/Setting.php
snow_monkey_forms/validator/error_messagewp-content/plugins/snow-monkey-forms/App/Model/Validator.php
snow_monkey_forms/spam/validatewp-content/plugins/snow-monkey-forms/App/Rest/Route/View.php
snow_monkey_forms/form/appendwp-content/plugins/snow-monkey-forms/App/Service/ReCaptcha/ReCaptcha.php
snow_monkey_forms/enqueue/fallback_stylewp-content/plugins/snow-monkey-forms/snow-monkey-forms.php
Snow Monkey Formsのフィルターフック・アクションフック一覧
スポンサーリンク

Snow Monkey Formsのフィルターフック・アクションフックの解説

以下は必要なものを選んで使う独立したサンプルです。

同じNAMEの項目が複数フォームにある場合は、他のフォームへの影響も確認してください。

条件を付けていない例はすべての対象処理に作用します。

snow_monkey_forms/complete/message

このフックは、Snow Monkey Formsプラグインにおいて、フォーム送信完了後に表示されるメッセージをカスタマイズするために使用されます。

解説

フォーム送信後にユーザーに表示される完了メッセージは、デフォルトではフォームの設定で指定されたものが使用されます。

しかし、このフックを使用することで、プログラム側から動的にメッセージを変更することが可能になります。

例えば、送信されたフォームの内容に応じて、異なる完了メッセージを表示したい場合などに便利です。

パラメータ

  • $message (string): 完了メッセージの内容。
  • $responser (object): フォームの入力値を保持するResponserオブジェクト。メール配送結果を証明するものではありません。
  • $setting (object): フォームの設定情報を含む設定オブジェクト。
// フォーム送信完了時のメッセージをカスタマイズする
add_filter( 'snow_monkey_forms/complete/message', function( $message, $responser, $setting ) {
    // 特定の条件に基づいてメッセージを変更
    if ( $responser->get( 'your_custom_field' ) === '特定の値' ) {
        $message = 'カスタムメッセージを表示します。';
    }

    return $message;
}, 10, 3 );

snow_monkey_forms/system_error/message

このフックは、Snow Monkey Formsプラグインにおいて、システムエラーが発生した際に表示されるエラーメッセージをカスタマイズするために使用されます。

解説:

フォームの送信処理中にシステムエラーが発生した場合、ユーザーにはエラーメッセージが表示されます。

このフックを使用することで、エラーメッセージの内容を動的に変更することができます。

下の例は表示メッセージを一律に変更します。

エラーの原因を解消したり、送信失敗を成功へ変更したりするコードではありません。

パラメータ:

  • $message (string): エラーメッセージの内容。
  • $responser (object): フォームの入力値を保持するResponserオブジェクト。メール配送結果を証明するものではありません。
  • $setting (object): フォームの設定情報を含む設定オブジェクト。
add_filter( 'snow_monkey_forms/system_error/message', function ( $message ) {
    return '送信を完了できませんでした。時間をおいて再度お試しください。';
} );

snow_monkey_forms/administrator_mailer/skip

このフックは、Snow Monkey Formsプラグインにおいて、管理者宛のメール送信をスキップするかどうかを制御するために使用されます。

解説:

フォームの送信が成功した際に、通常は設定された管理者メールアドレスに通知メールが送信されます。

しかし、このフックを使用することで、特定の条件下で管理者へのメール送信をスキップすることができます。

例えば、フォームの内容に応じてメール送信を行わない場合や、テスト環境でのメール送信を抑制したい場合などに便利です。

パラメータ:

  • $skip (boolean): メール送信をスキップするかどうか。デフォルトは false(スキップしない)。
  • $responser (object): フォームの入力値を保持するResponserオブジェクト。メール配送結果を証明するものではありません。
  • $setting (object): フォームの設定情報を含む設定オブジェクト。
// 特定の条件下で管理者メールの送信をスキップする
add_filter( 'snow_monkey_forms/administrator_mailer/skip', function( $skip, $responser, $setting ) {
    // フォームの入力値に応じて送信をスキップ
    if ( $responser->get( 'your_custom_field' ) === '特定の値' ) {
        $skip = true;
    }

    return $skip;
}, 10, 3 );

snow_monkey_forms/administrator_mailer/is_sended

このフックは、Snow Monkey Formsプラグインにおいて、管理者宛のメールが送信されたかどうかの結果をカスタマイズするために使用されます。

解説:

メール処理の結果を変更するフィルターです。

送信を省略した後も呼ばれます。

Snow Monkey Forms 13.0.0の送信経路では、falseへ変更してもその戻り値だけで完了画面がエラー画面に切り替わるわけではありません。

送信を止めたい場合はskipを使ってください。

パラメータ:

  • $is_sended (boolean): メール処理結果。skipによる省略もtrueで、is_sendedフィルターで変更される場合もあります。配送結果の証明ではありません。
  • $responser (object): フォームの入力値を保持するResponserオブジェクト。メール配送結果を証明するものではありません。
  • $setting (object): フォームの設定情報を含む設定オブジェクト。
// 管理者メールの送信結果をカスタマイズする
add_filter( 'snow_monkey_forms/administrator_mailer/is_sended', function( $is_sended, $responser, $setting ) {
    // 特定の条件下で送信失敗として扱う
    if ( $responser->get( 'your_custom_field' ) === '特定の値' ) {
        $is_sended = false;
    }

    // 追加の処理を実行
    if ( $is_sended ) {
        // 送信成功時の処理
    } else {
        // 送信失敗時の処理
    }

    return $is_sended;
}, 10, 3 );

snow_monkey_forms/administrator_mailer/after_send

このフックは、Snow Monkey Formsプラグインにおいて、管理者宛のメール送信後に実行されるアクションフックです。

解説:

管理者メール処理が例外なく終了した後、追加処理を行うために使います。

メールを省略した場合も呼ばれます。

例えば、送信結果をログに記録したり、別の通知処理を実行したりする場合などに便利です。

パラメータ:

  • $is_sended (boolean): メール処理結果。skipによる省略もtrueで、is_sendedフィルターで変更される場合もあります。配送結果の証明ではありません。
  • $responser (object): フォームの入力値を保持するResponserオブジェクト。メール配送結果を証明するものではありません。
  • $setting (object): フォームの設定情報を含む設定オブジェクト。
  • $mail_parser (object): メール内容の解析を行うMailParserオブジェクト。
// メール処理が例外なく終了した後のフック(配送の証明ではない)。
add_action( 'snow_monkey_forms/administrator_mailer/after_send', function( $is_sended, $responser, $setting, $mail_parser ) {
    if ( $is_sended ) {
        // skip が true の場合もここへ進む。
        error_log( '管理者メール処理が終了しました。' );
    } else {
        // is_sended フィルターで false に変更した場合など。
        error_log( '管理者メール処理結果が false です。' );
    }
}, 10, 4 );

Snow Monkey Forms 13.0.0の管理者メール処理では、wp_mailがfalseを返すと例外になり、このフックは呼ばれません。

上のelseを送信エラーの監視に使わないでください。

また、skipがtrueでも処理結果はtrueです。

実際にメールを送ったか、受信先に届いたかはこの引数だけでは判断できません。

snow_monkey_forms/administrator_mailer/headers

このフックは、Snow Monkey Formsプラグインにおいて、管理者宛のメール送信時に使用されるヘッダー情報をカスタマイズするために使用されます。

解説:

フォームの送信が成功し、管理者へのメール送信が行われる際に、メールのヘッダー情報を設定することができます。

このフックを使用することで、ヘッダー情報を動的に変更したり、追加のヘッダーを設定したりすることが可能です。

例えば、追加のCCやBCCを設定したい場合や、特定の条件下でヘッダーを変更したい場合などに便利です。

パラメータ:

  • $headers (array): メールのヘッダー情報を格納した配列。
  • $responser (object): フォームの入力値を保持するResponserオブジェクト。メール配送結果を証明するものではありません。
  • $setting (object): フォームの設定情報を含む設定オブジェクト。
// 管理者メールのヘッダー情報をカスタマイズする
add_filter( 'snow_monkey_forms/administrator_mailer/headers', function( $headers, $responser, $setting ) {
    // CCを追加
    $headers[] = 'Cc: example@example.com';

    // BCCを追加
    $headers[] = 'Bcc: example_bcc@example.com';

    return $headers;
}, 10, 3 );

snow_monkey_forms/administrator_mailer/args

このフックは、Snow Monkey Formsプラグインにおいて、管理者宛のメール送信時に使用される引数をカスタマイズするために使用されます。

解説:

フォームの送信が成功し、管理者へのメール送信が行われる際に、メールの内容や送信先などを指定する引数を設定します。

このフックを使用することで、引数を動的に変更したり、追加の引数を設定したりすることが可能です。

例えば、送信先のメールアドレスを条件に応じて変更したい場合や、特定の条件下でメールの内容を変更したい場合などに便利です。

パラメータ:

  • $args (array): メール送信時に使用される引数を格納した配列。
  • $responser (object): フォームの入力値を保持するResponserオブジェクト。メール配送結果を証明するものではありません。
  • $setting (object): フォームの設定情報を含む設定オブジェクト。
// 管理者メールの送信引数をカスタマイズする
add_filter( 'snow_monkey_forms/administrator_mailer/args', function( $args, $responser, $setting ) {
    // 送信先メールアドレスを条件に応じて変更
    if ( $responser->get( 'your_custom_field' ) === '特定の値' ) {
        $args['to'] = 'custom@example.com';
    }

    // メール本文に追記
    $args['body'] .= "\n\n追加のメッセージ";

    return $args;
}, 10, 3 );

snow_monkey_forms/auto_reply_mailer/skip

このフックは、Snow Monkey Formsプラグインにおいて、自動返信メールの送信をスキップするかどうかを制御するために使用されます。

解説:

フォームの送信が成功した際に、通常は設定された宛先に自動返信メールが送信されます。

しかし、このフックを使用することで、特定の条件下で自動返信メールの送信をスキップすることができます。

例えば、フォームの内容に応じてメール送信を行わない場合や、テスト環境でのメール送信を抑制したい場合などに便利です。

パラメータ:

  • $skip (boolean): メール送信をスキップするかどうか。デフォルトは false(スキップしない)。
  • $responser (object): フォームの入力値を保持するResponserオブジェクト。メール配送結果を証明するものではありません。
  • $setting (object): フォームの設定情報を含む設定オブジェクト。
// 特定の条件下で自動返信メールの送信をスキップする
add_filter( 'snow_monkey_forms/auto_reply_mailer/skip', function( $skip, $responser, $setting ) {
    // フォームの入力値に応じて送信をスキップ
    if ( $responser->get( 'your_custom_field' ) === '特定の値' ) {
        $skip = true;
    }

    return $skip;
}, 10, 3 );

snow_monkey_forms/auto_reply_mailer/is_sended

このフックは、Snow Monkey Formsプラグインにおいて、自動返信メールが送信されたかどうかの結果をカスタマイズするために使用されます。

解説:

メール処理の結果を変更するフィルターです。

送信を省略した後も呼ばれます。

Snow Monkey Forms 13.0.0の送信経路では、falseへ変更してもその戻り値だけで完了画面がエラー画面に切り替わるわけではありません。

送信を止めたい場合はskipを使ってください。

処理結果に応じた追加処理に利用します。

falseを返す操作で、すでに行われたメール送信を取り消すことはできません。

パラメータ:

  • $is_sended (boolean): メール処理結果。skipによる省略もtrueで、is_sendedフィルターで変更される場合もあります。配送結果の証明ではありません。
  • $responser (object): フォームの入力値を保持するResponserオブジェクト。メール配送結果を証明するものではありません。
  • $setting (object): フォームの設定情報を含む設定オブジェクト。
// 自動返信メールの送信結果をカスタマイズする
add_filter( 'snow_monkey_forms/auto_reply_mailer/is_sended', function( $is_sended, $responser, $setting ) {
    // 特定の条件下で送信失敗として扱う
    if ( $responser->get( 'your_custom_field' ) === '特定の値' ) {
        $is_sended = false;
    }

    // 追加の処理を実行
    if ( $is_sended ) {
        // 送信成功時の処理
    } else {
        // 送信失敗時の処理
    }

    return $is_sended;
}, 10, 3 );

snow_monkey_forms/auto_reply_mailer/after_send

このフックは、Snow Monkey Formsプラグインにおいて、自動返信メール送信後に実行されるアクションフックです。

解説:

自動返信メール処理が例外なく終了した後、追加処理を行うために使います。

メールを省略した場合も呼ばれます。

例えば、送信結果をログに記録したり、別の通知処理を実行したりする場合などに便利です。

パラメータ:

  • $is_sended (boolean): メール処理結果。skipによる省略もtrueで、is_sendedフィルターで変更される場合もあります。配送結果の証明ではありません。
  • $responser (object): フォームの入力値を保持するResponserオブジェクト。メール配送結果を証明するものではありません。
  • $setting (object): フォームの設定情報を含む設定オブジェクト。
  • $mail_parser (object): メール内容の解析を行うMailParserオブジェクト。
// メール処理が例外なく終了した後のフック(配送の証明ではない)。
add_action( 'snow_monkey_forms/auto_reply_mailer/after_send', function( $is_sended, $responser, $setting, $mail_parser ) {
    if ( $is_sended ) {
        // skip が true の場合もここへ進む。
        error_log( '自動返信メール処理が終了しました。' );
    } else {
        // is_sended フィルターで false に変更した場合など。
        error_log( '自動返信メール処理結果が false です。' );
    }
}, 10, 4 );

Snow Monkey Forms 13.0.0の自動返信メール処理では、wp_mailがfalseを返すと例外になり、このフックは呼ばれません。

上のelseを送信エラーの監視に使わないでください。

また、skipがtrueでも処理結果はtrueです。

実際にメールを送ったか、受信先に届いたかはこの引数だけでは判断できません。

snow_monkey_forms/auto_reply_mailer/headers

このフックは、Snow Monkey Formsプラグインにおいて、自動返信メール送信時に使用されるヘッダー情報をカスタマイズするために使用されます。

解説:

フォームの送信が成功し、自動返信メールの送信が行われる際に、メールのヘッダー情報を設定することができます。

このフックを使用することで、ヘッダー情報を動的に変更したり、追加のヘッダーを設定したりすることが可能です。

例えば、追加のCCやBCCを設定したい場合や、特定の条件下でヘッダーを変更したい場合などに便利です。

パラメータ:

  • $headers (array): メールのヘッダー情報を格納した配列。
  • $responser (object): フォームの入力値を保持するResponserオブジェクト。メール配送結果を証明するものではありません。
  • $setting (object): フォームの設定情報を含む設定オブジェクト。
// 自動返信メールのヘッダー情報をカスタマイズする
add_filter( 'snow_monkey_forms/auto_reply_mailer/headers', function( $headers, $responser, $setting ) {
    // CCを追加
    $headers[] = 'Cc: example@example.com';

    // BCCを追加
    $headers[] = 'Bcc: example_bcc@example.com';

    return $headers;
}, 10, 3 );

snow_monkey_forms/auto_reply_mailer/args

このフックは、Snow Monkey Formsプラグインにおいて、自動返信メール送信時に使用される引数をカスタマイズするために使用されます。

解説:

フォームの送信が成功し、自動返信メールの送信が行われる際に、メールの内容や送信先などを指定する引数を設定します。

このフックを使用することで、引数を動的に変更したり、追加の引数を設定したりすることが可能です。

例えば、送信先のメールアドレスを条件に応じて変更したい場合や、特定の条件下でメールの内容を変更したい場合などに便利です。

パラメータ:

  • $args (array): メール送信時に使用される引数を格納した配列。
  • $responser (object): フォームの入力値を保持するResponserオブジェクト。メール配送結果を証明するものではありません。
  • $setting (object): フォームの設定情報を含む設定オブジェクト。
// 自動返信メールの送信引数をカスタマイズする
add_filter( 'snow_monkey_forms/auto_reply_mailer/args', function( $args, $responser, $setting ) {
    // 送信先メールアドレスを条件に応じて変更
    if ( $responser->get( 'your_custom_field' ) === '特定の値' ) {
        $args['to'] = 'custom@example.com';
    }

    // メール本文に追記
    $args['body'] .= "\n\n追加のメッセージ";

    return $args;
}, 10, 3 );

snow_monkey_forms/saved_files/survival_time

このフックは、通常清掃で添付ファイルを削除対象にするまでの時間を秒単位で変更します。

保存後30分間の保持を保証する設定ではありません。

解説:

フォーム送信時にユーザーが添付したファイルは、サーバー上の特定のディレクトリに一時的に保存されます。

Snow Monkey Forms 13.0.0ではファイルの最終更新時刻と現在時刻を比較し、設定時間を超えたファイルを通常清掃の削除対象にします。

時間が来た瞬間に削除するタイマーではありません。

既定値は15分(900秒)です。

下の例では通常清掃の期限を30分(1800秒)に変更しますが、送信完了処理は強制清掃を使うため、期限前でも対象ディレクトリのファイルを削除します。

パラメータ:

  • $survival_time (int): ファイルが保存される期間(秒単位)。
// 通常清掃の削除対象になる期限を30分へ変更する。保持保証ではない。
add_filter( 'snow_monkey_forms/saved_files/survival_time', function( $survival_time ) {
    return 60 * 30; // 30分
} );

snow_monkey_forms/mailer/headers

このフックは、Snow Monkey Formsプラグインにおいて、メール送信時に使用されるヘッダー情報をカスタマイズするために使用されます。

解説:

フォームの送信が成功し、メール送信が行われる際に、メールのヘッダー情報を設定することができます。

このフックを使用することで、ヘッダー情報を動的に変更したり、追加のヘッダーを設定したりすることが可能です。

例えば、追加のCCやBCCを設定したい場合や、特定の条件下でヘッダーを変更したい場合などに便利です。

パラメータ:

  • $headers (array): メールのヘッダー情報を格納した配列。
// メールのヘッダー情報をカスタマイズする
add_filter( 'snow_monkey_forms/mailer/headers', function( $headers ) {
    // CCを追加
    $headers[] = 'Cc: example@example.com';

    // BCCを追加
    $headers[] = 'Bcc: example_bcc@example.com';

    return $headers;
} );

snow_monkey_forms/custom_mail_tag

このフックは、Snow Monkey Formsプラグインにおいて、メール本文内のカスタムタグをカスタマイズするために使用されます。

解説:

フォームの送信が成功し、メール送信が行われる際に、メール本文内にはフォームの入力値を埋め込むためのタグ(例: {name})が使用されます。

このフックを使用することで、カスタムタグの値を動的に変更したり、追加の処理を行ったりすることが可能です。

例えば、特定のフィールドの値を加工してメールに埋め込みたい場合などに便利です。

パラメータ:

  • $value (mixed): カスタムタグの値。
  • $tag (string): カスタムタグの名前(フィールド名)。
  • $responser (Responser): フォームの入力値を保持するResponserオブジェクト。メール配送結果を証明するものではありません。
  • $setting (Setting): フォームの設定情報を含む設定オブジェクト。
// カスタムタグの値をカスタマイズする
add_filter( 'snow_monkey_forms/custom_mail_tag', function( $value, $tag, $responser, $setting ) {
    // 特定のフィールドの値を加工する
    if ( 'your_custom_field' === $tag && is_string( $value ) ) {
        $value = strtoupper( $value ); // 値を大文字に変換
    }

    return $value;
}, 10, 4 );

snow_monkey_forms/control/attributes

このフックは、Snow Monkey Formsプラグインにおいて、フォームコントロール(入力フィールド)の属性をカスタマイズするために使用されます。

解説:

フォームの入力フィールドやボタンなどのコントロールは、様々な属性(例: name、class、value など)を持っています。

このフックを使用することで、コントロールの属性を動的に変更したり、追加の属性を設定したりすることが可能です。

例えば、特定のフィールドにカスタムクラスを追加したい場合や、属性の値を条件に応じて変更したい場合などに便利です。

パラメータ:

  • $attributes (array): コントロールの属性を格納した連想配列。
  • $setting (Setting): フォームの設定情報を含む設定オブジェクト。
// 特定のフィールドにカスタムクラスを追加する
add_filter( 'snow_monkey_forms/control/attributes', function( $attributes, $setting ) {
    if ( 'your_custom_field' === ( $attributes['name'] ?? '' ) ) {
        // 'class' 属性が存在しない場合は、空の文字列を設定
        if ( ! isset( $attributes['class'] ) ) {
            $attributes['class'] = '';
        }

        // カスタムクラスを追加
        $attributes['class'] .= ' custom-class';
    }

    return $attributes;
}, 10, 2 );

snow_monkey_forms/checkboxes/options

このフックは、Snow Monkey Formsプラグインにおいて、チェックボックスコントロールのオプションをカスタマイズするために使用されます。

解説:

フォームにチェックボックスを設置する際に、選択肢(オプション)を設定します。

このフックを使用することで、チェックボックスのオプションを動的に変更したり、追加のオプションを設定したりすることが可能です。

例えば、データベースから取得した値をオプションとして設定したい場合や、特定の条件下でオプションを変更したい場合などに便利です。

パラメータ:

  • $options (array): チェックボックスのオプションを格納した配列。
  • $name (string): チェックボックスコントロールの名前(name属性の値)。
  • $setting (Setting): フォームの設定情報を含む設定オブジェクト。
// チェックボックスのオプションをカスタマイズする
add_filter( 'snow_monkey_forms/checkboxes/options', function( $options, $name, $setting ) {
    // 特定のチェックボックスに対してオプションを設定
    if ( 'your_checkbox_field' === $name ) {
        $options = array(
            'option1' => 'Option 1',
            'option2' => 'Option 2',
            'option3' => 'Option 3',
        );
    }

    return $options;
}, 10, 3 );

snow_monkey_forms/select/options

このフックは、Snow Monkey Formsプラグインにおいて、セレクトボックスコントロールのオプションをカスタマイズするために使用されます。

解説:

フォームにセレクトボックス(ドロップダウンメニュー)を設置する際に、選択肢(オプション)を設定します。

このフックを使用することで、セレクトボックスのオプションを動的に変更したり、追加のオプションを設定したりすることが可能です。

例えば、データベースから取得した値をオプションとして設定したい場合や、特定の条件下でオプションを変更したい場合などに便利です。

パラメータ:

  • $options (array): セレクトボックスのオプションを格納した配列。
  • $name (string): セレクトボックスコントロールの名前(name属性の値)。
  • $setting (Setting): フォームの設定情報を含む設定オブジェクト。
// セレクトボックスのオプションをカスタマイズする
add_filter( 'snow_monkey_forms/select/options', function( $options, $name, $setting ) {
    // 特定のセレクトボックスに対してオプションを設定
    if ( 'your_select_field' === $name ) {
        $options = array(
            'value1' => 'Option 1',
            'value2' => 'Option 2',
            'value3' => 'Option 3',
        );
    }

    return $options;
}, 10, 3 );

snow_monkey_forms/radio_buttons/options

このフックは、Snow Monkey Formsプラグインにおいて、ラジオボタンコントロールのオプションをカスタマイズするために使用されます。

解説:

フォームにラジオボタンを設置する際に、選択肢(オプション)を設定します。

このフックを使用することで、ラジオボタンのオプションを動的に変更したり、追加のオプションを設定したりすることが可能です。

例えば、データベースから取得した値をオプションとして設定したい場合や、特定の条件下でオプションを変更したい場合などに便利です。

パラメータ:

  • $options (array): ラジオボタンのオプションを格納した配列。
  • $name (string): ラジオボタンコントロールの名前(name属性の値)。
  • $setting (Setting): フォームの設定情報を含む設定オブジェクト。
// ラジオボタンのオプションをカスタマイズする
add_filter( 'snow_monkey_forms/radio_buttons/options', function( $options, $name, $setting ) {
    // 特定のラジオボタンに対してオプションを設定
    if ( 'your_radio_field' === $name ) {
        $options = array(
            'option1' => 'Option 1',
            'option2' => 'Option 2',
            'option3' => 'Option 3',
        );
    }

    return $options;
}, 10, 3 );

snow_monkey_forms/validator/error_message

このフックは、Snow Monkey Formsプラグインにおいて、フォームのバリデーションエラーメッセージをカスタマイズするために使用されます。

解説:

フォームの入力値がバリデーション(検証)に失敗した際に表示されるエラーメッセージをカスタマイズすることができます。

特定のフィールドやバリデーションルールに応じて、エラーメッセージを変更できます。

SMF 13.0.0では先頭3引数に加えて第4引数にResponser、第5引数にSettingを渡します。

以下の例は先頭3引数だけを受け取ります。

パラメータ:

  • $message (string): デフォルトのエラーメッセージ。
  • $validation_name (string): バリデーションルールの名前。
  • $name (string): フォームフィールドの名前(name属性の値)。
// バリデーションエラーメッセージをカスタマイズする
add_filter( 'snow_monkey_forms/validator/error_message', function( $message, $validation_name, $name ) {
    // 特定のフィールドの特定のバリデーションルールに対するエラーメッセージを変更
    if ( 'your_field_name' === $name && 'required' === $validation_name ) {
        $message = 'このフィールドは必須です。';
    }

    return $message;
}, 10, 3 );

snow_monkey_forms/spam/validate

このフックは、Snow Monkey Formsプラグインにおいて、フォームのスパム検証を行うために使用されます。

解説:

フォームが送信されたときに、その内容がスパムであるかどうかを検証するために使用されます。

このフックを利用して、独自のスパム検証ロジックを実装することができます。

add_filter( 'snow_monkey_forms/spam/validate', function ( $valid, $responser, $setting ) {
    if ( is_wp_error( $valid ) || ! $valid ) {
        return $valid;
    }
    $message = $responser->get( 'message' );
    if ( is_string( $message ) && strpos( $message, 'spam_keyword' ) !== false ) {
        return false;
    }
    return $valid;
}, 10, 3 );

snow_monkey_forms/form/append

このフックは、Snow Monkey Formsプラグインにおいて、フォームの末尾に追加のフィールドやコンテンツを挿入するために使用されます。

解説:

フォームの最後にカスタムフィールドやHTMLコンテンツを追加したい場合に利用します。

たとえば、Google reCAPTCHAのトークンフィールドを挿入するために使用されています。

// フォームの末尾にカスタムテキストを追加する
add_action( 'snow_monkey_forms/form/append', function() {
    echo '<p>カスタムテキストをここに追加</p>';
} );

snow_monkey_forms/enqueue/fallback_style

このフックは、Snow Monkey Formsプラグインにおいて、フォームのスタイルが読み込まれるかどうかを制御するために使用されます。

解説:

Snow Monkey Formsプラグインは、デフォルトでフォームのスタイルを提供しています。

SMF 13.0.0では、このフィルターはfallback.cssの読み込み判定に使われます。

フォーム本体のapp.cssまで止めるものではありません。

下の例は使用テーマを判定せず、フォールバックスタイルを常に無効にします。

テーマ側などで必要な見た目を用意できている場合だけ使い、入力欄・エラー・確認画面の表示を確認してください。

// 使用テーマに関係なく、フォールバックスタイルを無効にする。
add_filter( 'snow_monkey_forms/enqueue/fallback_style', '__return_false' );

保存ファイルの期限と清掃の違い

条件SMF 13.0.0で確認した結果
既定15分・最終更新から20分通常清掃の削除対象
掲載例の30分・最終更新から20分通常清掃では残る
掲載例の30分・最終更新から31分通常清掃で削除
掲載例の30分・強制清掃20分のファイルも削除

2026年10月3日、隔離環境の検証専用ファイルで更新時刻を調整し、SMFのDirectoryクラスによる期限判定と削除処理を実行しました。

実ファイルを30分待って測定した結果ではありません。

添付ファイルを送信後も保管したい用途は、このフックだけでは実現できません。

別の保存先と保存期間を設計し、送信完了後にも必要なファイルが残るかを確認してください。

メールを止める設定と処理結果を変える設定

フック・条件wp_mailの呼び出し実プラグインの結果
skipがtrue呼ばれない処理結果はtrue、after_sendにもtrue
is_sendedでfalseへ変更既に呼ばれた後処理結果はfalse、after_sendにもfalse
wp_mailがfalseを返す1回呼ばれる例外になり、after_sendは呼ばれない
headers・argsで変更変更した宛先・本文・ヘッダーで呼ばれる宛先への到達確認は別途必要

2026年10月3日、SMF 13.0.0の管理者メールと自動返信メールを各フック例で比較し、両方のMailerクラスからwp_mailへ渡る値と処理結果を確認しました。

メールは配送前に捕捉し、成功・失敗の戻り値を切り替えています。

送信自体を止めたい条件にはskipを使います。

is_sendedをfalseへ変えても、既に行われた送信を取り消せません。

after_sendのtrueも、受信者がメールを受け取った証明にはなりません。

管理者用と自動返信用のargs例は、対象値が一致すると宛先を変え、どちらの入力でも本文を追記します。

例のメールアドレスとyour_custom_field、特定の値を運用に合わせて変更し、意図しない宛先や同報先が追加されていないか確認してください。

共通のmailer/headers例は、管理者メールにも自動返信メールにも適用されます。

個別のheaders例と同時に追加すると同じCC・BCCを重ね得るため、必要な例だけを選びます。

実フォームでフックを選んで確認する

掲載例を一括で有効にせず、使いたいフックを1つ選んで項目のNAMEと条件値を実際の設定へ合わせます。

2026年10月2日、WordPress 7.1.2・SWELL 2.19.0・SMF 13.0.0の隔離環境で、通常のCSRF検証を使った実HTTP通信を確認しました。

選択肢の3例では、確認画面にOption 2・Option 3・Option 2を表示し、生成メールでは対応する値 value2・option3・option2 を確認しました。

カスタムタグの例では入力値abcが生成メールでABCとなり、属性の例では対象の入力欄に custom-class が付きました。

必須エラーの例は未入力時の文言を変え、スパム判定の例は spam_keyword を含む入力をsystemerrorで拒否しました。

管理者メールのskip例は実メール処理へ進まずにcompleteとなり、after_sendへ渡る結果はtrueでした。

is_sended例で結果をfalseにした場合も画面はcompleteとなり、after_sendにはfalseが渡りました。

処理結果の真偽だけでメール到達を判断せず、導入先のテスト受信と照合してください。

今回のメールは配送前に捕捉しています。

2026年10月3日には保存ファイルの通常清掃と強制清掃を実プラグインで追加検証しました。

実メールの到達、外部スパムサービス、全23例の運用は未検証です。

実フォームの確認画面で変更したセレクト・チェック・ラジオのラベルを確認した状態
2026年10月2日撮影:合成入力を使い、選択肢3種の表示ラベルを確認した隔離実フォームの画面です。
スポンサーリンク

まとめ

Contact Form 7やMW WP Formはネットに知見があり、いろいろなカスタマイズができますが、

ブロックエディタ対応のSnow Monkey Formsは便利で使いやすいものの、まだまだ知見が足りません。

今後カスタマイズする中で情報を追記したいと思います。

この記事で紹介しているコードは、GitHubのMOTOKI-LLC/WAZA-codeにもまとめています。

スパム判定例のmessageは入力項目のname、spam_keywordは拒否したい文字列へ変更します。

既存のfalseやWP_Errorを維持し、別の検証で拒否された送信を許可へ戻しません。

この例は文字列の一致判定だけで、スパム対策全体を置き換えるものではありません。

コードは必要なフックだけを子テーマのfunctions.phpまたはCode Snippetsの一方へ追加します。

元へ戻す場合は追加したコールバックを削除または無効化します。

検証範囲は前節の2026年10月2日・3日の記録を参照してください。

今回の再照合は本文とソースの確認であり、全23例の送信・画面動作を再実行したものではありません。

根拠:開発元のソースコード。

選択肢の3例(select・checkboxes・radio_buttons)は「送信値 => 表示ラベル」の配列を返します。

nameが一致しない項目は元の選択肢を維持します。

掲載例の3項目について、開発元のControlクラスでHTMLを生成するところまで確認しました。

ブラウザーでの選択操作やメール到達は別の検証です。

カスタムメールタグの大文字変換例は文字列だけを加工し、配列などはそのまま返します。

  • URLをコピーしました!

プラグインの設定でお困りなら

プラグインの導入・カスタマイズ代行

プラグインの選定から設定、競合の解消、動作に合わせた追加実装まで承ります。1時間 ¥8,000〜(税込)。

WAZAの有料記事のサブスクリプションも開始しました。

サービス

Service

WordPressサイトのカスタマイズのサービスに関心がありましたら、ぜひ詳細をご覧ください。

目次