Gravity Formsの電話番号で日本用カスタムフォーマットを追加する

1. Gravity Formsの電話番号フィールドの仕様
2. フィルターフックを使用したカスタム電話番号フォーマットの追加
3. 追加したカスタムフォーマットを適用する
3.1. 一般設定の設定
3.1.1. フォームの表示例
3.1.2. エラー発生時の表示例

Gravity Formsの電話番号フィールドの仕様

Gravity Formsの電話番号フィールドは、アメリカ（US）と海外（インターナショナル）の2種類がプリセットされています。
海外のフィールドタイプは幅広い国に対応する必要があるため、特に入力値に対するバリデーションは設定されていません。

そのため、日本用のバリデーションを設定するためにはプラグインを使用するか、またはフィルターフックを使用してカスタムフォーマットを適用する必要があります。

フィルターフックを使用したカスタム電話番号フォーマットの追加

以下のコードをfunctions.php、もしくはCode Snippetsプラグインに登録します。
functions.phpを使用するとテーマ変更時に正常動作しなくなるのでCode Snippetsをおすすめします。

なお、この例では先頭が0から始まり、残りが9桁または10桁の数字が入力されているバリデーションを行っています。（ハイフンは無し）

add_filter( 'gform_phone_formats', 'jp_phone_format' );
function jp_phone_format( $phone_formats ) {
    $phone_formats['jp'] = array(
        'label'       => 'JP',
        'mask'        => false,
        'regex'       => '/^0[0-9]{9,10}$/',
        'instruction' => 'ハイフンなしで先頭が0から始まり、10桁または11桁の半角数字を入力してください。',
    );
 
    return $phone_formats;
}

キー	値の説明
label	カスタム電話番号フォーマットのラベル名。管理画面での選択時のドロップボックスに表示される名前でフロントエンドには表示されません。
mask	入力マスク。日本では電話番号にマスクを使用する場面をほとんど見ないので「false」に設定しています。
regex	正規表現の内容
instruction	エラー時に表示するカスタムエラー文言

gform_phone_formats のパラメータ

参考情報

すべてのフォームの電話番号フィールドではなく、特定のフォームの電話番号フィールドにのみカスタムフォーマットを追加したい場合は、以下のように「gform_phone_format」に「_5」等フォームIDを追加して制限を行うことができます。
add_filter( 'gform_phone_formats_5', 'your_function_name', 10, 2 );