MW WP Form からの移行

Form Plant には、MW WP Form で作成したフォームを Form Plant 形式へ自動変換する移行ツール (v1.2.0 で追加) が付属しています。フィールド (入力項目) ・メール設定・入力画面/確認画面のテンプレート・メール差し込みタグを、管理画面から数クリックで一括変換できます。

このページでは、移行ツールの使い方から、フィールド・ショートコード・フック (mwform_*) の対応表、移行後に手動で必要になる作業までを詳しく解説します。

まず全体像を押さえる

移行ツールが自動でやることと、移行後に手動でやることは明確に分かれています。先に移行ツールが変換するもの / しないものの一覧で全体像をつかんでから読み進めると迷いません。

移行ツールが変換するもの / しないもの

区分	自動 / 手動
入力項目 (フィールド) ・必須設定・選択肢	✅ 移行ツールが自動変換
管理者メール・自動返信メールの設定 (宛先・件名・本文)	✅ 自動変換
入力画面・確認画面の HTML テンプレート	✅ 自動変換
メール差し込みタグ ( `{お名前}` → `{field:your_name}` 等)	✅ 自動変換
バリデーション (必須・メール形式・文字数等)	✅ 自動変換
フォーム設置ショートコード ( `[mwform_formkey]` → `[fplant id]` )	⚠️ 手動で置き換え
*`functions.php` の `mwform_` フック**	⚠️ 手動で書き換え (後述)
Akismet スパム設定	⚠️ 移行不可 (reCAPTCHA / Turnstile を別途設定)

移行は「新しいフォームを追加する」操作です

移行ツールは MW WP Form のフォームを書き換えたり削除したりしません。元のフォームはそのまま残し、変換結果を 新しい Form Plant フォームとして追加します。安心して試せますが、その分設置ページのショートコードは自動では切り替わりません (手動置き換えが必要)。

移行の前提条件

MW WP Form がインストール・有効化されていること。 移行タブは MW WP Form が有効なときだけ表示されます。
MW WP Form のバージョンが 5.0 以上であること。 5.0 未満の場合は移行ボタンが表示されず、更新を促すメッセージが出ます。まず MW WP Form を最新版に更新してください。
操作には manage_options 権限 (管理者) が必要です。

移行ツールの使い方

1. 移行画面を開く

WordPress 管理画面の 「Form Plant」→「ツール」 を開きます
「MW WP Form Migration」 タブを選びます

このタブは MW WP Form が有効なときだけ表示されます。

2. フォームを選んで移行する

移行画面には MW WP Form のフォーム一覧が表示されます。

列	内容
(チェックボックス)	移行対象を選択
Title	MW WP Form のフォームタイトル
Fields	検出されたフィールド数
Migration Status	移行ステータス ( `Migrated` / `Not migrated` )

操作手順:

移行したいフォームのチェックボックスを選びます (全選択も可能)
「Migrate selected forms」 ボタンをクリックします
確認ダイアログで OK を押すと、選択したフォームが 1 件ずつ順番に変換されます
「Migration Report」 に結果が表示されます

3. 移行レポートを確認する

各フォームの結果は次の 3 段階で表示されます。

ステータス	意味
Success	警告なしで移行完了
With warnings	移行はできたが、手動対応が必要な項目あり (要確認)
Failed	エラーで移行できなかった

With warnings の場合でも移行自体は完了しています。レポートに並ぶ警告は、移行ツールが自動変換できなかった項目を「黙って消さずに」明示しているものです。必ず内容を確認し、必要な手動対応を行ってください。

レポートからは、生成された Form Plant フォームへのリンク (「Open the generated Form Plant form」) も開けます。

移行済みフォームの再確認

移行済みフォームは一覧で Migrated と表示され、「View log」 から後でいつでも移行ログ (移行日時・ステータス・警告一覧) を見直せます。

4. 移行後のフォームを確認する

生成されたフォームは「公開・標準デザイン」です

移行で作られた Form Plant フォームは、公開 (published) 状態・標準 (ノーマル) デザインで作成されます。タイトルには (from MW WP Form 2026-06-02 10:00:00) のように移行日時が付きます。ショートコードを設置すればそのまま利用できます (「まず移行して動く」状態) 。

MW WP Form のレイアウトは HTML テンプレートとして保存されますが、デフォルトでは無効 (OFF) です。元のレイアウトに近づけたい場合は、フォーム編集画面の「レイアウト」で「入力画面 HTML テンプレートを使用」「確認画面 HTML テンプレートを使用」を ON にしてください (詳しくは後述の「移行後のレイアウトについて」を参照) 。

フォーム一覧では、各フォームのタイトル横に色付きのステータスバッジ (公開＝緑 / 非公開＝オレンジ / 下書き＝グレー) が表示されます。

移行直後におすすめの確認手順:

生成された Form Plant フォームを開き、フィールド構成・必須設定・選択肢を確認する
フィールド名 (name) を控える (フック書き換えとメールタグで使います。日本語名は英数字に変換されています)
テスト送信して、確認画面・自動返信メール・管理者メールが意図通りか確認する
設置ページのショートコードを [fplant id="..."] に置き換える (次節)

フォーム設置ショートコードの対応

フォームを記事や固定ページに設置するショートコードは、移行ツールでは自動変換されません。手動で置き換えてください。

MW WP Form	Form Plant
`[mwform_formkey key="123"]`	`[fplant id="12"]`
`[mwform_formkey post_id="123"]`	`[fplant id="12"]`

[fplant id="..."] の数値は、生成された Form Plant フォームの フォーム ID です。フォーム ID は次の場所で確認できます。

フォーム編集画面の URL: wp-admin/admin.php?page=fplant-form-new&id=12 の 12
フォーム一覧に表示される設置ショートコード [fplant id="12"]

設置ページの探し方

[mwform_formkey] を書いた固定ページや記事を見つけるには、管理画面の検索や、データベースの post_content 検索を使うと確実です。差し替え漏れがあると、そのページには MW WP Form のフォームが表示されたままになります。

フィールド (入力項目) の対応表

移行ツールは MW WP Form のフォームタグ (ショートコード) を、対応する Form Plant のフィールド型へ自動変換します。

MW WP Form フォームタグ	Form Plant フィールド型	備考
`mwform_text`	テキスト ( `text` )	size / maxlength を反映
`mwform_textarea`	テキストエリア ( `textarea` )	rows / cols / maxlength を反映
`mwform_email`	メールアドレス ( `email` )
`mwform_password`	パスワード ( `password` )
`mwform_tel`	電話番号 ( `tel` )	3 分割入力 ( `split3` ) に変換
`mwform_url`	URL ( `url` )
`mwform_zip`	郵便番号 ( `postal_code` )	3+4 桁の 2 ボックス入力に変換
`mwform_number`	数値 ( `number` )	min / max を反映
`mwform_range`	数値 ( `number` )	⚠️ スライダー UI は再現されません
`mwform_select`	セレクト ( `select` )	選択肢を変換
`mwform_radio`	ラジオボタン ( `radio` )	選択肢・レイアウトを変換
`mwform_checkbox`	チェックボックス ( `checkbox` )	選択肢・レイアウト・区切り文字を変換
`mwform_hidden`	隠しフィールド ( `hidden` )
`mwform_file`	ファイル ( `file` )
`mwform_image`	ファイル ( `file` )	画像拡張子 (jpg/jpeg/png/gif/webp) に限定
`mwform_datepicker`	日付 ( `date` )	形式 `Y-m-d`
`mwform_monthpicker`	日付 ( `date` )	形式 `Y-m`
`mwform_custom_mail_tag`	カスタムメールタグ ( `custom_mail_tag` )	後述

各フィールドの name (フィールド名) ・ラベル・プレースホルダー・初期値・id・class も引き継がれます。

フィールド名は「日本語 → 英数字」に変換されます ⚠️ 最重要

MW WP Form では日本語のフィールド名 (例: お名前 ・ メールアドレス ) を使えますが、Form Plant のフィールド名は英数字キーです。移行ツールは お名前 → your_name 、メールアドレス → email のように自動で英数字へ変換します。

この変換は、後述の メール差し込みタグ・フックにも影響します。移行後は必ず Form Plant 編集画面で新しいフィールド名を確認してください。

メール設定の対応

MW WP Form のメール設定は、Form Plant の 管理者メール と 自動返信メール にそれぞれ変換されます。

MW WP Form	Form Plant
管理者宛先 ( `mail_to` / `cc` / `bcc` )	管理者メールの宛先・CC・BCC
管理者メール件名・本文	管理者メールの件名・本文
送信元 ( `admin_mail_from` 等) ・Reply-To	送信元名/アドレス・Reply-To
自動返信の返信先フィールド ( `automatic_reply_email` )	自動返信メールの宛先フィールド
自動返信の件名・本文・送信元	自動返信メールの件名・本文・送信元

メール差し込みタグの対応

メール本文・件名に書かれた差し込みタグも自動変換されます。

MW WP Form	Form Plant	変換
`{お名前}` (日本語フィールド名)	`{field:your_name}`	✅ 自動変換
`{email}` (英数字フィールド名)	`{email}`	✅ そのまま (後方互換)
`{tracking_number}` (問い合わせ番号)	`{submission_id}` (送信 ID)	⚠️ 自動変換なし (手動で書き換え)
`{post_title}` `{post_id}` 等の投稿情報タグ	?post_id= プリフィル＋隠しフィールドで代替 ( 1.4.1 以降 )	⚠️ 自動変換なし
`{user_email}` 等のユーザー情報タグ	—	⚠️ 変換不可

Form Plant で解決できるシステムタグ:

{all_fields}      すべての入力値
{form_title}      フォームタイトル
{submission_id}   送信 ID
{submission_date} 送信日時
{ip_address}      送信者の IP アドレス
{user_agent}      ユーザーエージェント
{site_name}       サイト名
{site_url}        サイト URL
{admin_email}     管理者メールアドレス

解決できないタグはメールにそのまま残ります

{post_title} などの MW 固有タグや、どのフィールドにも一致しないタグは、自動変換できずメール本文にそのまま残ります。投稿情報を送りたい場合は、投稿の情報を自動取得する ( ?post_id= ) 機能 ( バージョン 1.4.1 以降 ) を使い、隠しフィールドやテキストフィールドのデフォルト値に {post_title} 等を設定して引き継いでください。移行レポートにも警告として表示されます。

カスタムメールタグの対応

MW WP Form の [mwform_custom_mail_tag] は、Form Plant の カスタムメールタグフィールド ( custom_mail_tag ) に変換されます。値を供給するフックは名前が変わるため、書き換えが必要です (フックの対応表を参照)。

バリデーションの対応

MW WP Form のバリデーション設定は、各フィールドに自動でマージされます。

MW WP Form ルール	Form Plant への適用
`noempty` / `required`	必須
`mail`	メールアドレス型に変更
`numeric`	数値型に変更
`zip`	郵便番号型に変更
`tel`	電話番号型に変更
`url`	URL 型に変更
`date`	日付型に変更 ( `Y-m-d` )
`alpha` / `alphanumeric`	正規表現パターン＋メッセージ
`katakana` / `hiragana` / `kana`	かなバリデーション (パターン)
`between` / `minlength`	最小・最大文字数
`eq`	完全一致パターン
`filetype`	許可する拡張子
`filesize` / `maxFileSize`	最大ファイルサイズ (MB)
`akismet`	⚠️ 移行不可 (reCAPTCHA / Turnstile を別途設定)

不明なルールや適用先が見つからないルールは、移行レポートに警告として表示されます。手動で再設定してください。

画面遷移・送信後アクションの対応

MW WP Form は入力・確認・完了・エラーをそれぞれ別 URL のページで表現できますが、Form Plant は設置したページ内で画面を切り替える方式です。そのため URL 指定の対応が異なります。

MW WP Form 設定	Form Plant
確認画面の有無	確認画面の有効/無効 (ボタン構成から自動判定)
完了 URL ( `complete_url` )	送信後アクション = リダイレクト＋リダイレクト URL。リダイレクト先に入力内容や受付番号を出したい場合は `[fplant_complete]` ( 1.5.0 以降 )
完了メッセージ ( `complete_message` )	送信後アクション = カスタムページ＋完了 HTML。`{キー名}` は `{field:名前}` に、`{tracking_number}` は `{submission_id}` に書き換えると 1.5.0 以降で展開されます
入力 URL / 確認 URL / エラー URL	移行不要 (ページ内遷移のため。レポートに通知が出ます)

移行後のレイアウトについて

移行時、生成フォームのデザインは 標準 (ノーマル) で作成され、入力画面・確認画面の HTML テンプレート使用は OFF になっています。そのため、移行直後は Form Plant の標準レイアウトで表示されます。

実際には、MW WP Form のレイアウトを完全に再現するにはある程度の調整が必要になるため、「まずは標準デザインで動く」状態をデフォルトにしています。MW WP Form のレイアウト ( マークアップ ) は HTML テンプレートとして保存済みなので、元のレイアウトに近づけたい場合はフォーム編集画面の「レイアウト」タブで「入力画面 HTML テンプレートを使用」「確認画面 HTML テンプレートを使用」を ON にし、必要に応じて HTML / CSS を調整してください。

URL 引数 ( `?post_id=` ) の対応

MW WP Form の 「URL 引数を有効にする」 ( querystring ) を使い、?post_id=投稿ID 付きの URL でフォームに {post_title} などの投稿情報を表示していた場合は、Form Plant の 投稿の情報を自動取得する ( ?post_id= ) 機能 ( バージョン 1.4.1 以降 ) が移行先になります。リンク側の URL 形式 ( ?post_id=投稿ID ) は そのまま変更不要です。

移行手順:

フォーム編集画面で、投稿情報を表示したいフィールド ( テキスト・隠しフィールドなど ) を用意する
そのフィールドの デフォルト値 に、MW WP Form と同じ書き方で {post_title} や {カスタムフィールドキー} を入力する
「フォーム設定」タブの 「URL パラメータからの初期値設定を許可」 にチェックを入れて保存する

MW WP Form との違いは次のとおりです。

MW WP Form ではフォーム HTML 内の任意の位置に {key} を書けましたが、Form Plant では フィールドのデフォルト値 ( 初期値 ) として設定する方式です。画面に表示せず送信データ・メールにだけ含めたい場合は隠しフィールドを使ってください
セキュリティ強化のため、取得できる投稿プロパティは {ID} {post_title} {post_name} {post_date} {post_excerpt} {post_content} の 6 種です ( カスタムフィールドは任意のキーを指定可能 ) 。アンダースコア _ で始まる保護されたカスタムフィールドと、下書き・非公開・パスワード保護された投稿からは取得されません

フックの移行対応表

functions.php などに書いた mwform_* フックは自動変換されません。Form Plant の対応するフックへ手動で書き換えてください。

書き換え前に知っておくべき 3 つの違い

違い 1: フック名の付き方

MW WP Form: フォームごとにフォームキー (例 mw-wp-form-1 ) がフック名の末尾に付きます。例: mwform_value_mw-wp-form-1
Form Plant: 2 系統です。
- フィールド名が末尾に付くフック: fplant_field_initial_value_{name} のように、対象フィールドを名前で狙います。
- フォーム全体に発火するフック: fplant_redirect_url のようにサフィックスが無く、コールバック内で $form_id を見て対象フォームを判定します。

違い 2: フォームの識別は「フォーム ID (数値)」

Form Plant はフォームを数値の ID で識別します。フォーム ID は [fplant id="12"] や編集画面 URL ( ...&id=12 ) で確認できます。サフィックスの無いフックでは $form_id で対象を絞り込みます。

add_filter( 'fplant_redirect_url', function ( $url, $form_id, $data ) {
    if ( 12 !== $form_id ) {
        return $url; // 対象フォーム以外はそのまま返す
    }
    // フォーム ID 12 だけの処理
    return $url;
}, 10, 3 );

違い 3: フィールド名が「日本語 → 英数字」に変わる ⚠️ 最重要

移行ツールが日本語のフィールド名を英数字キーへ変換するため (例: お名前 → your_name ) 、フックのコールバックでは移行後の新しいフィールド名を使う必要があります。新しい名前は Form Plant のフォーム編集画面で確認できます。

// MW WP Form (フィールド名は日本語「お名前」)
add_filter( 'mwform_value_mw-wp-form-1', function ( $value, $name ) {
    if ( 'お名前' === $name ) { /* ... */ }
    return $value;
}, 10, 2 );

// Form Plant (移行後の英数字キー「your_name」をフック名に使う)
add_filter( 'fplant_field_initial_value_your_name', function ( $value, $field, $form_id ) {
    /* ... */
    return $value;
}, 10, 3 );

フック対応早見表

やりたいこと	MW WP Form	Form Plant
フィールドの初期値を設定	`mwform_value_*`	`fplant_field_initial_value_{name}`
選択肢を動的生成	`mwform_choices_*`	`fplant_field_choices_{name}`
独自バリデーション	`mwform_validation_*`	`fplant_validate_field_{name}`
エラーメッセージを変更	`mwform_error_message_*`	`fplant_validation_message_*`
カスタムメールタグ	`mwform_custom_mail_tag(_*)`	`fplant_custom_mail_tag_value_{name}`
メール件名・本文を変更	`mwform_admin_mail_` / `mwform_auto_mail_`	`fplant_admin_email_subject` / `_body` 、`fplant_user_email_subject` / `_body`
メール宛先を動的に変更	`mwform_admin_mail_*` ( `$Mail->to` )	`fplant_admin_email_to` / `fplant_user_email_to`
メールヘッダー (CC/BCC 等) を変更	`mwform_admin_mail_*` ( `$Mail` )	`fplant_admin_email_headers` / `fplant_user_email_headers`
メール送信を条件でスキップ	`mwform_admin_mail_*` ( `$Mail->to = false` )	`fplant_skip_admin_email` / `fplant_skip_user_email`
送信完了後に外部連携	`mwform_after_send_*`	`fplant_after_submission_complete`
リダイレクト先を動的に変更	`mwform_redirect_url_*`	`fplant_redirect_url`
完了メッセージを動的に変更	`mwform_complete_content_*`	`fplant_complete_message` / `fplant_success_html` ( リダイレクト先の完了画面は `fplant_complete_shortcode_html` )
完了アクションの種別を入力値で切り替え	—	`fplant_submission_result` ( 1.5.0 )
添付ファイルの保存先・ファイル名	`mwform_upload_dir_` / `mwform_upload_filename_`	`fplant_upload_dir` / `fplant_upload_filename`
設定画面に独自項目を追加	`mwform_settings_extend_fields(_*)`	`fplant_custom_settings_fields`
CSV の文字コード	`mwform_csv_encoding-*`	`fplant_export_encoding`
入力フィールド種別を追加	`mwform_form_fields`	`fplant_field_types`

書き換え例 (before / after)

以降、mw-wp-form-1 はフォームキー、Form Plant 側の 12 はフォーム ID、your_name 等は移行後のフィールド名の例です。ご自身の環境の値に置き換えてください。

フィールドの初期値を設定する

// before: MW WP Form (ログインユーザーのメールアドレスを初期値に)
add_filter( 'mwform_value_mw-wp-form-1', function ( $value, $name ) {
    if ( 'email' === $name && is_user_logged_in() ) {
        $value = wp_get_current_user()->user_email;
    }
    return $value;
}, 10, 2 );

// after: Form Plant (フック名の末尾にフィールド名を付ける)
add_filter( 'fplant_field_initial_value_email', function ( $value, $field, $form_id ) {
    if ( is_user_logged_in() ) {
        $value = wp_get_current_user()->user_email;
    }
    return $value;
}, 10, 3 );

選択肢を動的に生成する

// before: MW WP Form (引数は $children, $atts)
add_filter( 'mwform_choices_mw-wp-form-1', function ( $children, $atts ) {
    if ( 'product' === ( $atts['name'] ?? '' ) ) {
        foreach ( get_posts( array( 'post_type' => 'product' ) ) as $p ) {
            $children[ $p->ID ] = $p->post_title;
        }
    }
    return $children;
}, 10, 2 );

// after: Form Plant (option は array( 'label' => ラベル, 'value' => 値 ) の配列)
add_filter( 'fplant_field_choices_product', function ( $options, $field, $form_id ) {
    foreach ( get_posts( array( 'post_type' => 'product' ) ) as $p ) {
        $options[] = array( 'label' => $p->post_title, 'value' => (string) $p->ID );
    }
    return $options;
}, 10, 3 );

対応フィールド種別: セレクト / ラジオ / チェックボックス。

独自バリデーション

// before: MW WP Form (Validation オブジェクトにエラーをセット)
add_filter( 'mwform_validation_mw-wp-form-1', function ( $Validation, $data ) {
    if ( empty( $data['member_id'] ) || ! preg_match( '/^\d{6}$/', $data['member_id'] ) ) {
        $Validation->set_rule( 'member_id', 'noNull' );
    }
    return $Validation;
}, 10, 2 );

// after: Form Plant (該当フィールドのコールバックで、エラー文字列を返すとエラー扱い)
add_filter( 'fplant_validate_field_member_id', function ( $error, $field, $value, $data, $form_id ) {
    if ( ! preg_match( '/^\d{6}$/', (string) $value ) ) {
        return __( '会員番号は 6 桁の数字で入力してください。', 'your-textdomain' );
    }
    return $error; // 問題なければそのまま返す
}, 10, 5 );

カスタムメールタグ

// before: MW WP Form ({member_rank} タグ。引数 $value, $name, $insert_id)
add_filter( 'mwform_custom_mail_tag_mw-wp-form-1', function ( $value, $name, $insert_id ) {
    if ( 'member_rank' === $name ) {
        $value = get_user_meta( get_current_user_id(), 'rank', true );
    }
    return $value;
}, 10, 3 );

// after: Form Plant (custom_mail_tag フィールド "member_rank" の値を供給)
add_filter( 'fplant_custom_mail_tag_value_member_rank', function ( $value, $field, $form_id ) {
    return get_user_meta( get_current_user_id(), 'rank', true );
}, 10, 3 );

メールの宛先を動的に振り分ける

// before: MW WP Form ($Mail->to を書き換え)
add_filter( 'mwform_admin_mail_mw-wp-form-1', function ( $Mail, $values ) {
    if ( '営業' === ( $values['category'] ?? '' ) ) {
        $Mail->to = 'sales@example.com';
    }
    return $Mail;
}, 10, 2 );

// after: Form Plant (管理者宛先は配列で返す。空配列を返すと送信スキップ)
add_filter( 'fplant_admin_email_to', function ( $to, $form_id, $data ) {
    if ( 12 === $form_id && '営業' === ( $data['category'] ?? '' ) ) {
        $to = array( 'sales@example.com' );
    }
    return $to;
}, 10, 3 );

送信完了後に外部サービスへ連携する

// before: MW WP Form (Slack 通知)
add_action( 'mwform_after_send_mw-wp-form-1', function ( $Data ) {
    notify_slack( $Data->get( 'email' ) );
} );

// after: Form Plant (引数は $data, $form_id, $form, $submission_id)
add_action( 'fplant_after_submission_complete', function ( $data, $form_id, $form, $submission_id ) {
    if ( 12 === $form_id ) {
        notify_slack( $data['email'] ?? '' );
    }
}, 10, 4 );

より詳しいバリデーションフックの解説はバリデーションフック (PHP) を参照してください。

サポート外のフックと代替策

以下の MW WP Form フックには、Form Plant のアーキテクチャ上、同等フックを用意していません。多くは Form Plant の標準機能で代替できます。

MW WP Form フック	Form Plant での代替策
`mwform_post_content(_raw)` (フォーム HTML を加工)	フォーム設定の HTML テンプレート機能でフォーム HTML を直接編集。動的な値の差し込みは `fplant_template_values` フィルター、テンプレートのテーマ上書きは `fplant_locate_template`
`mwform_no_save_keys` (DB に保存しない項目)	フォーム設定の「送信データの保存」で制御。項目単位の除外は `fplant_before_save_submission_data` フィルターで該当キーを `unset`
`mwform_default_settings` / `mwform_default_content` (新規フォームの既定値)	非対応。フォームの複製機能で代用
`mwform_inquiry_data_columns` / `mwform_csv_columns` 等 (問い合わせデータ画面)	非対応 (Form Plant は独自の送信データ管理画面・エクスポートを使用)
`mwform_tag_generator_*` (タグ生成ツール)	非対応 (Form Plant はフィールドエディターでフィールドを追加)
`mwform_translate_datepicker` / `mwform_styles` / `mwform_secure_cookie` / `mwform_log_directory` 等	非対応 (日付・CSS・セッション・ログの仕組みが異なるため)

Form Plant フックリファレンス (移行で使う主なもの)

フック	種別	引数
`fplant_field_initial_value_{name}`	filter	`( $value, $field, $form_id )`
`fplant_field_choices_{name}`	filter	`( $options, $field, $form_id )`
`fplant_validate_field_{name}`	filter	`( $error, $field, $value, $data, $form_id )`
`fplant_validation_message_*`	filter	`( $message, $field, $value, $context )`
`fplant_custom_mail_tag_value_{name}`	filter	`( $value, $field, $form_id )`
`fplant_admin_email_subject` / `fplant_user_email_subject`	filter	`( $subject, $form_id )`
`fplant_admin_email_body` / `fplant_user_email_body`	filter	`( $message, $form_id, $data )`
`fplant_admin_email_to` / `fplant_user_email_to`	filter	`( $to, $form_id, $data )`
`fplant_admin_email_headers` / `fplant_user_email_headers`	filter	`( $headers, $form_id, $data )`
`fplant_skip_admin_email` / `fplant_skip_user_email`	filter	`( $skip, $form, $data, $submission_id )`
`fplant_after_submission_complete`	action	`( $data, $form_id, $form, $submission_id )`
`fplant_redirect_url`	filter	`( $url, $form_id, $data )`
`fplant_complete_message` / `fplant_success_html`	filter	`( $message_or_html, $form_id, $data )`
`fplant_upload_dir`	filter	`( $custom_dir, $form_id )`
`fplant_upload_filename`	filter	`( $filename, $field, $form_id )`
`fplant_custom_settings_fields`	filter	`( $fields, $form_id )`
`fplant_export_encoding`	filter	`( $encoding, $form_id )`
`fplant_field_types`	filter	`( $types )`

_{name} は移行後のフィールド名 (英数字キー) です。

移行できないもの・注意点まとめ

フォーム設置ショートコード ( [mwform_formkey] ) は手動で [fplant id="..."] に置き換えが必要
mwform_* フックは手動書き換えが必要 (フックの移行対応表)
Akismet スパム設定は移行不可。reCAPTCHA / Turnstile を別途設定 (→ スパム対策)
MW 固有の差し込みタグ ( {post_title} 等) は変換されずメールに残る ( 投稿情報は ?post_id= プリフィルで代替可 )
mwform_range のスライダー UI は数値入力に縮退する
同名フィールドが複数あると入力値が衝突する恐れ (移行レポートに警告)
自動返信の返信先フィールドが移行後に存在しないと、自動返信が送られないことがある (送信テストで必ず確認)
生成フォームは公開・標準デザインで作成される。MW WP Form のレイアウトは HTML テンプレートとして保存されるがデフォルトでは OFF (必要なら編集画面の「レイアウト」で ON)

移行作業のチェックリスト

MW WP Form を 5.0 以上に更新する
「Form Plant」→「ツール」→「MW WP Form Migration」 でフォームを移行する
移行レポートの警告をすべて確認する
生成された Form Plant フォームを開き、フィールド構成と新しいフィールド名を確認する
テスト送信し、確認画面・管理者メール・自動返信メールを検証する
設置ページのショートコードを [fplant id="..."] に置き換える
functions.php の mwform_* フックを Form Plant のフックへ書き換える
スパム対策 (reCAPTCHA / Turnstile) を設定し直す
必要なら「レイアウト」で HTML テンプレートを ON にし、デザインを調整する
動作を確認できたら MW WP Form の旧フォームを停止する

ご不明点や、本ページに載っていないカスタマイズがある場合は、Form Plant のサポートへお問い合わせください。

移行ツールが変換するもの / しないもの​

移行の前提条件​

移行ツールの使い方​

1. 移行画面を開く​

2. フォームを選んで移行する​

3. 移行レポートを確認する​

4. 移行後のフォームを確認する​

フォーム設置ショートコードの対応​

フィールド (入力項目) の対応表​

メール設定の対応​

メール差し込みタグの対応​

カスタムメールタグの対応​

バリデーションの対応​

画面遷移・送信後アクションの対応​

URL 引数 ( ?post_id= ) の対応​

フックの移行対応表​

書き換え前に知っておくべき 3 つの違い​

違い 1: フック名の付き方​

違い 2: フォームの識別は「フォーム ID (数値)」​

違い 3: フィールド名が「日本語 → 英数字」に変わる ⚠️ 最重要​

フック対応 早見表​

書き換え例 (before / after)​

フィールドの初期値を設定する​

選択肢を動的に生成する​

独自バリデーション​

カスタムメールタグ​

メールの宛先を動的に振り分ける​

送信完了後に外部サービスへ連携する​

サポート外のフックと代替策​

Form Plant フック リファレンス (移行で使う主なもの)​

移行できないもの・注意点まとめ​

移行作業のチェックリスト​