ご注意!

この記事には PHP コードが含まれており、開発者を対象としています。このコードは便宜上提供していますが、コードのカスタマイズやサードパーティの開発についてはサポートを提供していません。

追加のガイダンスについては、WPBeginner の カスタムコードの追加方法に関するチュートリアル を参照してください。

閉じる

説明

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 );