wp-gravity-forms

Gravity Forms

WordPress 向けの構造化されたフォーム処理とトランザクション入力を提供します。Gravity Forms は Gravity スタックの主要なデータ収集エンドポイントとして機能し、エントリーを SMTP 配信、GravityView による表示、Gravity Connect AI による処理、GravityKit のワークフローに送ります。

使用する場面

• wp gf を使って Gravity Forms または公式アドオンをインストール、更新、確認する
• コマンドラインからフォームとエントリーを管理する
• フォーム定義を JSON としてバージョン管理する
• 通知と確認メッセージをテストする
• AI ボット向けのスパム対策を設定する（Cloudflare Turnstile）
• GFAPI ベースの PHP を記述する（データベースへ直接書き込まない）
• MCP／AI パイプライン向けにフォームスキーマをシリアライズする

公式ドキュメント

リソース	URL
ドキュメントトップ	https://docs.gravityforms.com/
はじめに	https://docs.gravityforms.com/getting-started/
ユーザーガイド	https://docs.gravityforms.com/category/user-guides/
Gravity Forms 3.0 ベータ版	https://docs.gravityforms.com/category/user-guides/
WP-CLI リファレンス	https://docs.gravityforms.com/manage-gravity-forms-and-add-ons-with-wpcli/
アドオンのスラッグ	https://docs.gravityforms.com/gravity-forms-add-on-slugs/
開発者向け API（GFAPI）	https://docs.gravityforms.com/api-functions
開発者向けドキュメント	https://docs.gravityforms.com/category/developers/
フックとフィルター	https://docs.gravityforms.com/category/developers/hooks/
フォームオブジェクト	https://docs.gravityforms.com/form-object
エントリーオブジェクト	https://docs.gravityforms.com/entry-object
フィールドオブジェクト	https://docs.gravityforms.com/field-object
マージタグ	https://docs.gravityforms.com/category/user-guides/merge-tags-getting-started/
条件付きロジック	https://docs.gravityforms.com/category/user-guides/conditional-logic/
スパム対策と保護	https://docs.gravityforms.com/category/user-guides/spam-detection-and-protection/
アドオンフレームワーク	https://docs.gravityforms.com/category/developers/php-api/add-on-framework/
REST API	https://docs.gravityforms.com/category/developers/rest-api/
デモ	https://www.gravityforms.com/gravity-forms-demo/
価格とライセンス	https://www.gravityforms.com/pricing/

GitHub

リポジトリ	用途
gravityforms/gravityformscli	公式 WP-CLI アドオン（wp gf コマンド）
gravitywiz/snippet-library	AI トレーニング向けのコミュニティ提供フックとフィルター 1000 件以上

• https://github.com/gravityforms/gravityformscli
• https://github.com/gravitywiz/snippet-library

---

手順

0) ガードレール

• 必ず GFAPI を使用し、wp_rg_lead_* テーブルへ直接書き込まないでください
• GF_LICENSE_KEY は CLI 引数ではなく、wp-config.php に設定してください
• インストールまたは更新の後は、wp gf setup --force を実行してデータベースのマイグレーションを適用してください
• wp gf version gravitysmtp を実行し、CVE-2026-4020 を確認してください。詳細は wp-gravity-smtp スキルを参照してください

1) インストールと確認

# Requires GF_LICENSE_KEY constant in wp-config.php:
# define('GF_LICENSE_KEY', 'your-key-here');

wp gf install --force --activate
wp gf install gravityformscli --activate
wp gf install gravitysmtp --activate      # ⚠️  verify version ≥ 2.1.5 immediately
wp gf install gravityformsturnstile --activate
wp gf install gravityformsuserregistration --activate
wp gf install gravityformswebhooks --activate
wp gf setup --force
wp gf version

2) フォーム管理

wp gf form list --active --format=table
wp gf form export 1 --path=./forms/contact-form.json   # commit to git
wp gf form import ./forms/contact-form.json
wp gf form duplicate 1

# Export all forms
mkdir -p forms
for id in $(wp gf form list --format=ids); do
  wp gf form export $id --path=forms/form-${id}.json
done

3) エントリー管理

wp gf entry list --form_id=1 --status=active --format=table
wp gf entry get 42 --format=json
wp gf entry export 1 --dir=./exports --format=csv
wp gf entry export 1 --dir=./exports --start_date=2026-01-01
wp gf entry notification get 42 --event=form_submission   # test notifications

4) GFAPI — 正しい PHP のパターン

// ✅ Always use GFAPI
$entry  = GFAPI::get_entry($entry_id);
$form   = GFAPI::get_form($form_id);
$result = GFAPI::add_entry($entry_data);
GFAPI::update_entry($entry);

// ❌ Never write directly to wp_rg_lead_* tables
global $wpdb;
$wpdb->update('wp_rg_lead', [...]); // never

5) MCP 互換の JSON スキーマ

$form   = GFAPI::get_form(1);
$schema = ['form_id' => $form['id'], 'title' => $form['title'],
    'fields' => array_map(fn($f) => [
        'id' => $f->id, 'label' => $f->label,
        'type' => $f->type, 'required' => $f->isRequired,
        'choices' => $f->choices ?? null,
    ], $form['fields'])];
file_put_contents(ABSPATH . 'llms-form-schema.json', json_encode($schema, JSON_PRETTY_PRINT));

6) AI ボット向けのスパム対策

wp gf install gravityformsturnstile --activate
# Configure: Forms → Settings → Turnstile → "Managed" mode

7) リモート管理（WP Engine）

wp @production gf check-update
wp @production gf update
wp @production gf setup --force --skip-plugins --skip-themes
wp @production cache flush --skip-plugins --skip-themes

---

エージェントスクリプト

bash {baseDir}/scripts/gf-inspect.sh             # local audit
bash {baseDir}/scripts/gf-inspect.sh --remote    # WP Engine via SSH

参考資料

• references/gravity-forms-cli.md — wp gf コマンドの完全なリファレンス
• wp-gravity-smtp スキル — SMTP 配信と CVE-2026-4020
• wp-gravity-connect スキル — OpenAI 連携
• wp-gravityview スキル — フロントエンドでのエントリー表示
• wp-gravity-wiz スキル — Spellbook、Perks、GP Populate Anything
• wp-wpcli-and-ops スキル — WP-CLI の一般的なパターン