AI要約
説明
wpforms_display_submit_after アクションは、送信ボタン要素が表示された直後に実行されます。
パラメーター
- $form_data
- (配列) 後で使用するために処理および準備されたフォーム設定/データ。
- $ボタン
- (string) ボタンタイプ。例: `submit`、`next`。
ソース
wpforms/src/Frontend/Frontend.php
詳細情報
このフックは、フォームの送信ボタンコンテナのdiv内で、送信ボタン要素が表示された後に実行されます。
例として、このフックを使用して、フォームの送信ボタンの後に出力されるHTMLを追加できます。
代替案として、wpforms_display_submit_beforeを使用して、送信ボタンの前に何かを表示することもできます。
wpforms_display_submit_beforeは、送信ボタンのみをパラメータとして受け取ります。したがって、この特定のフックは送信ボタンにのみ関連付けられ、次へまたは前へのページボタンには関連付けられません。
例
例のコードスニペットでは、まずフォームIDが5と等しいかどうかを確認します。もしそうであれば、フォームの送信ボタンの直後にビデオへのリンクが表示されます。
コードを実行したい特定のフォームIDと一致するように、フォームIDを5から変更することを忘れないでください。このチェックを削除すると、すべてのフォームに適用されます。
フォームIDの見つけ方がわからない場合は、このチュートリアルを確認してください。
/**
* Action that fires just after the submit button element is displayed.
*
* @link https://wpforms.com/developers/wpforms_display_submit_after/
*
* @param array $form_data Form data and settings.
* @param string $button Button type, e.g. `submit`, `next`.
*/
function wpf_dev_display_submit_after( $form_data, $button ) {
if ( $button !== 'submit' ) {
return;
}
// Only run on my form with ID = 5
if ( absint( $form_data['id'] ) !== 1145 ) {
return;
}
// Display a link to a YouTube video after the submit button.
_e( '<div class="track-click"> <a href="https://www.youtube.com/watch?v=eiQ3viAGung" data-rel="lightbox">Click here for a special video announcement!</a>.</div>', 'plugin-domain' );
}
add_action( 'wpforms_display_submit_after', 'wpf_dev_display_submit_after', 10, 2 );