説明

wpforms_conditional_logic_core_is_field_id_shown フィルターは、フォームビルダー内の条件付きロジックフィールドのドロップダウンに、各フィールドのラベルの後にIDを表示するかどうかを制御します。デフォルトではオフになっています。true を返すと、すべてのフォームフィールドオプションは Email (ID #4) のように読み取られ、ビルダーがフィールドオプションヘッダーで使用するのと同じ形式になります。

このフィルターは WPForms 2.0.5 以降で利用可能です。

パラメータータイプ説明
$is_shownブール値条件付きロジックフィールドのドロップダウンにフィールドIDを表示するかどうか。デフォルトは false。

戻り値: (bool) フィールドラベルの後にフィールドIDを表示する場合は true、ラベルのみを表示する場合は false。

詳細情報

フィールドラベルのみでは、複数のフィールドが同じラベルを共有している場合やラベルがない場合に、条件付きロジックのドロップダウンで区別するのが難しいことがあります。このフィルターをオンにすると、各オプションにフィールドIDが追加されるため、ビルダーを離れることなく、正しいフィールドにルールを一致させることができます。

この設定は、フィールドのスマートロジック、通知、確認、支払い設定、マーケティングおよびその他の統合接続など、条件付きロジックビルダーが表示されるすべての場所に適用されます。ドロップダウンが再構築されたとき(たとえば、フィールドラベルを変更した後、フィールドを追加または削除した後、またはフィールドを複製した後)、IDはそのまま残ります。ドロップダウンのホバーテキストは、選択されたオプションと一致します。

ラベルのないフィールドは、追加の接尾辞なしで Field #4 と表示され続けます。クイズアドオンのグレード、性格、スコアオプションなど、フォームフィールド以外のオプションにはIDは付きません。条件付きロジックには有料ライセンスが必要なため、このフィルターは WPForms Lite では効果がありません。フィルターがオフの場合、ドロップダウンは WPForms 2.0.5 より前の状態とまったく同じように表示されます。

ソース

wpforms/pro/includes/class-conditional-logic-core.php

例

この例では、条件付きロジックドロップダウンの各フィールドラベルの後にフィールドIDが表示されます。

/**
 * Show field IDs after field labels in the conditional logic dropdown.
 *
 * @link https://wpforms.com/developers/wpforms_conditional_logic_core_is_field_id_shown/
 *
 * @param bool $is_shown Whether to show field IDs. Default false.
 *
 * @return bool
 */
function wpf_dev_conditional_logic_show_field_ids( $is_shown ) {

    return true;
}
add_filter( 'wpforms_conditional_logic_core_is_field_id_shown', 'wpf_dev_conditional_logic_show_field_ids', 10, 1 );

参考記事