wp-gravity-wiz

Gravity Wiz — Spellbook、Perks、拡張機能

Gravity Wiz は Gravity エコシステムを提供しています。Spellbook（統合プラットフォーム）、Gravity Perks（48 種類以上のフォーム拡張機能）、Gravity Connect（外部サービスとの連携）、Gravity Shop（WooCommerce）があります。すべての製品は Spellbook を通じてインストールおよび更新します。

使用する場面

• Spellbook や Gravity Wiz 製品をインストールまたは有効化するとき
• Gravity Perks（GP Populate Anything、Nested Forms、Limit Submissions など）を使用するとき
• Gravity Perks の旧個別インストーラーから Spellbook にアップグレードするとき
• Perk の競合や Perk 固有の設定をトラブルシューティングするとき
• AI による動的なフォーム入力のために GP Populate Anything を設定するとき
• account.gravitywiz.com でライセンスを管理するとき

公式ドキュメント

リソース	URL
Spellbook のドキュメント	https://gravitywiz.com/documentation/spellbook/
Gravity Perks のドキュメント	https://gravitywiz.com/documentation/gravity-perks/
Gravity Connect のドキュメント	https://gravitywiz.com/documentation/gravity-connect/
Gravity Shop のドキュメント	https://gravitywiz.com/documentation/gravity-shop-product-configurator/
利用可能な Perks の一覧	https://gravitywiz.com/available-perks/
スニペットライブラリ	https://gravitywiz.com/snippet-library/
アカウントダッシュボード	https://account.gravitywiz.com/
ダウンロード	https://account.gravitywiz.com/downloads
サポート	https://gravitywiz.com/support/
よくある質問	https://gravitywiz.com/documentation/gravity-perks-account-faq/
ライセンスに関するよくある質問	https://gravitywiz.com/documentation/license-faq/

GitHub

リポジトリ	用途
gravitywiz/snippet-library	1000 件以上のフックとフィルター — AI のトレーニングコンテキストに最適です

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

---

手順

1) Spellbook をインストールする（プラットフォーム — 最初にインストール）

Gravity Wiz 製品はすべて Spellbook を通じてインストールします。

1. https://gravitywiz.com/download/spellbook からダウンロードします
   （またはアカウントから：https://account.gravitywiz.com/downloads）
2. インストールします。

wp plugin install path/to/spellbook.zip --activate

3. wp-admin の Spellbook → Account でライセンスを有効化します。
4. Spellbook は、旧 Gravity Perks がインストールされている場合、自動的に無効化します。

2) 個別の製品／Perks をインストールする

wp-admin の Spellbook → Perks（または Connect、Shop）から操作します。

• 製品を閲覧または検索します
• Activate をクリックします。Spellbook がダウンロードと有効化を自動的に行います

Spellbook の有効化後に CLI／自動インストールを行う場合：

# Spellbook manages its own update mechanism — use the UI or its WP-CLI integration
wp plugin list | grep gp-  # list installed perks

3) AI ワークフローに役立つ Perks

Perk	用途	ドキュメント
GP Populate Anything	投稿、ユーザー、ターム、外部 API からフィールドに動的に値を入力します	https://gravitywiz.com/documentation/gravity-forms-populate-anything/
GP Nested Forms	親フォーム内に子フォームを埋め込みます（繰り返し可能なセクション）	https://gravitywiz.com/documentation/gravity-forms-nested-forms/
GP Limit Submissions	期間ごとの送信数を制限して、スパムや不正利用を防ぎます	https://gravitywiz.com/documentation/gravity-forms-limit-submissions/
GP Advanced Select	AI が生成した大規模なリスト向けの検索・選択機能（Choice.js を使用）	https://gravitywiz.com/documentation/gravity-forms-advanced-select/
GP Live Preview	送信前にフィールド値をリアルタイムでプレビューします	https://gravitywiz.com/documentation/gravity-forms-live-preview/
GP Copy Cat	フィールド間で値を自動的にコピーします	https://gravitywiz.com/documentation/gravity-forms-copy-cat/

4) GP Populate Anything と AI フィード

Gravity Connect と組み合わせて、AI による動的なフォーム入力を実現します。

// Filter Populate Anything query before form renders
add_filter('gppa_query_args', function($args, $field, $form) {
    // Inject AI-generated constraints into the population query
    if ($field->id === 5) {
        $args['meta_query'][] = [
            'key'   => 'ai_category',
            'value' => 'featured',
        ];
    }
    return $args;
}, 10, 3);

5) LLM のループでメモリ使用量を抑える

Spellbook はすべての Perks 間でコードを重複排除するため、Perk を個別にインストールする場合と比べて PHP のメモリ使用量を削減できます。これは、Gravity Connect 経由で実行される、メモリを大量に消費する LLM／API の実行ループで役立ちます。

# Verify Spellbook is active (not legacy Gravity Perks)
wp plugin status spellbook
wp plugin status gravityperks  # should show as inactive/not installed

6) プラグインページで Perks を非表示にする（任意）

// Keep wp-admin Plugins page clean (perks still update normally)
add_filter('gp_hide_perks_from_plugins_page', '__return_true');

---

参考資料

• wp-gravity-forms スキル — GF の基本的なセットアップと WP-CLI
• wp-gravity-connect スキル — Connect 経由の OpenAI 統合
• LLM トレーニング用のスニペットライブラリ：https://github.com/gravitywiz/snippet-library