速報

ジェトロのサイトで情報漏えい|追加9,413件の内訳と暫定再開の範囲

CATEGORY

【MW WP Form】エラーメッセージを変更する【WordPress】

※本ページのリンクにはプロモーションが含まれています。

【MW WP Form】エラーメッセージを変更する【WordPress】

目次

本記事では、WM WP Formで出力するエラーメッセージを変更する方法をご紹介しています。

MW WP Formでエラーメッセージを変更したいな~良い方法ないかな?

上記の疑問にお答えしています。

では、解説していきます。

スポンサーリンク

MW WP Formのマニュアルについて

MW WP Formは開発者の方が提供されている公式のマニュアルがあります。下記のリンク先がマニュアルになります。

https://plugins.2inc.org/mw-wp-form/manual/

とても読みやすく、理解しやすいので公式マニュアルがあれば大抵の事は実現できるかと思います。同プラグインでフォームを作成する場合に参考にしていただければと思います。

今回はMW WP Formでエラーメッセージを変更します。マニュアルでいうところの下記のページの内容となります。

https://plugins.2inc.org/mw-wp-form/filter-hook/mwform_error_message/

上記のマニュアルを参考に、エラーメッセージを変更していきます。

MW WP Formでエラーメッセージを変更してみる

今回はMW WP Formで作成した下記のフォームを使用します。お名前・メールアドレス・お問い合わせ内容で構成されたよくあるお問い合わせフォームです。すべてのバリデーションルールに必須を追加しています。確認ページを挟んでいるので、戻るボタンや入力確認ボタンを設置しています。

使用するフォーム

<div id="app">
    <table>
        <tr>
            <th>お名前</th>
            <td>[mwform_text name="お名前"]</td>
        </tr>
        <tr>
            <th>メールアドレス</th>
            <td>[mwform_email name="メールアドレス"]</td>
        </tr>
        <tr>
            <th>お問い合わせ</th>
            <td>[mwform_textarea name="お問い合わせ内容"]</td>
        </tr>
    </table>
    <div class="btn-group">
        [mwform_backButton value="戻る"]
        [mwform_submitButton name="送信" confirm_value="入力内容確認" submit_value="送信する"]
    </div>
</div>

上記のままだと、必須項目を入力しなければ「未入力です。」というエラーメッセージが表示されます。

このメッセージの内容をで変更します。下記を使用するテーマ内の「functions.php」に追加します。位置に指定はありませんので、行頭・行末問わず任意の行に追加してください。

PHP

function my_error_message($error, $key, $rule){
    if($key === 'お名前' && $rule === 'noempty'){
        return 'お名前が入力されていません';
    }
    return $error;
}
add_filter('mwform_error_message_mw-wp-form-xxx', 'my_error_message', 10, 3);

「mwform_error_message_mw-wp-form-xxx」の「xxx」部分には管理画面で作成したフォームの「key」を指定します。

複数の項目を変更する場合は項目分追加していきます。

PHP

function my_error_message($error, $key, $rule){
    if($key === 'お名前' && $rule === 'noempty'){
        return 'お名前が入力されていません';
    }
    if($key === 'メールアドレス' && $rule === 'noempty'){
        return 'メールアドレスが入力されていません';
    }
    return $error;
}
add_filter( 'mwform_error_message_mw-wp-form-xxx', 'my_error_message', 10, 3 );

以上で完了です。実際にフォームで確認すると表示されるエラーメッセージが変更されています。

その他バリデーションルール

本記事では必須項目を例にあげましたが、MW WP Formで指定可能なバリデーションルールが豊富にあります。下記のページに詳しい記載ありますので、参考にしてください。

https://plugins.2inc.org/mw-wp-form/manual/validation-rule/

微妙に違いがあるかもしれないので、実際に使用する場合は第三引数の「$rule」の中身をダンプすることで適用されているルールがわかるかと思います。

スポンサーリンク

最後に

Webサイトを作成する上でお問い合わせやエントリーといったフォームは必ず必要になります。WordPressを使用する場合はMW WP Formをインストールして少し設定するだけでフォームを構築することができるので、工数を減らすことができるので助かりますね。

今後も制作するサイトで使用させていただきたいと思います!

以上、WordPressのMW WP Formでエラーメッセージを変更する方法のご紹介でした!

この記事を書いた人

Ryohei

Webエンジニア / アプリ開発者 / 技術ブログ運営者

福岡のWeb制作会社に勤務するWebエンジニアです。10年以上にわたりWeb制作・開発に携わり、ヒアリングや進行管理から、コーディング、CMSの構築、システム開発、サーバーの構築・保守・運用まで、Webサイト制作の工程を幅広く担当しています。Webサイトは、これまでに100以上の構築・保守を手がけてきました。

個人でもWebサイトの制作・改修やWebアプリの開発・運用を行い、AIを活用した開発にも取り組んでいます。近年はWebセキュリティにも注力しています。

2015年から技術メディア「Into the Program」を運営し、実務や開発で得た知識をもとに、プログラミングの実装方法やWebサイトの運用・セキュリティ情報を発信しています。

主な分野
Webサイト構築・保守・運用 / HTML/CSS / JavaScript / PHP / WordPress / サーバー構築・保守・運用 / アプリ開発 / セキュリティ対策
資格・試験合格
情報セキュリティマネジメント試験
基本情報技術者試験
AWS認定ソリューションアーキテクト アソシエイト
PHP8技術者認定ウィザード
メディア運営
2015年〜

記事の作成・更新について

セキュリティ記事は、ベンダーの公式アドバイザリやCVE・JVNなどの一次情報を参照し、出典と情報確認日を記載します。実環境での検証を行った場合は、その環境と確認範囲を明示します。重要な追加情報や誤りを把握した場合は、内容を確認して追記・訂正します。

関連する記事

おすすめの書籍

キーワードから探す

スポンサーリンク

フィルターフック

WordPressで、出力や設定の値を受け取って加工し、返すための仕組み。add_filter()で登録する。

詳しく見る