wp-gravityview

GravityView（GravityKit）

GravityView は、カスタムのクエリコードを使わずに、Gravity Forms のエントリーを検索・並べ替え・絞り込み可能なフロントエンドのビューとして表示します。GravityActions、GravityBoard と並ぶ GravityKit 製品スイートの一部です。

使用する場面

• Gravity Forms のエントリーをフロントエンドに表示する（スタッフ名簿、ポートフォリオ、リストなど）
• 検索・絞り込み可能なエントリー表示を作成する
• エントリー承認ワークフローを設定する
• フロントエンドでのユーザー編集用にエントリー編集フォームを作成する
• 権限グループまたはエントリーの所有者に基づいてビューを制限する
• 自動分類を利用した管理者向けワークフローを構築する

公式ドキュメント

リソース	URL
GravityKit ドキュメント	https://docs.gravitykit.com/
はじめに	https://www.gravitykit.com/docs/gravityview/getting-started/
ビューの設定	https://www.gravitykit.com/docs/gravityview/getting-started-gravityview/
検索／絞り込み	https://www.gravitykit.com/docs/gravityview/filter-and-sort-results/
エントリーの承認	https://www.gravitykit.com/docs/gravityview/entry-approval/
エントリーの編集	https://www.gravitykit.com/docs/gravityview/edit-entry/
マージタグ	https://www.gravitykit.com/docs/gravityview/merge-tags/
ショートコード	https://www.gravitykit.com/docs/gravityview/shortcodes/
権限グループと権限	https://www.gravitykit.com/docs/gravityview/roles-and-capabilities/
ビューの設定	https://www.gravitykit.com/docs/gravityview/view-settings/
よくある問題	https://www.gravitykit.com/docs/gravityview/common-problems/
よくある質問	https://www.gravitykit.com/docs/gravityview/faq/
開発者向けドキュメント（フック）	https://www.gravitykit.dev/
Foundation フレームワーク	https://www.gravitykit.dev/docs/foundation/
アカウント	https://account.gravitykit.com

GravityKit エコシステム

製品	用途
GravityView	エントリーをビュー（リスト、テーブル、マップ、カード）として表示
GravityView Pro	拡張レイアウト：マップ、テーブル、評価、マジックリンク
GravityActions	数千件のエントリーを一括更新、一括メール送信
GravityBoard	列と投票機能を備えたエントリー用カンバンボードビュー
WordPress MCP	AI アシスタント向けの Gutenberg ブロック単位の精密な編集

• アカウント： https://account.gravitykit.com
• GitHub 組織： https://github.com/GravityKit
• 開発者向けドキュメント（フック、Foundation、37 製品）： https://www.gravitykit.dev/

---

手順

1) インストール

GravityView は有料プラグインです。GravityKit アカウントからダウンロードしてインストールします。

wp plugin install gravityview.zip --activate
wp plugin install gravityview-datatables.zip --activate  # optional table layout

SatisPress/Composer を利用する場合：

"satispress/gravityview": "*"

2) ビューを作成する

1. Views → New View
2. エントリーを取得する Gravity Form を選択します
3. レイアウトを選択します（Table、List、DataTables、Map）
4. Multiple Entries レイアウト（ディレクトリビュー）にフィールドを追加します
5. Single Entry レイアウト（詳細ページ）にフィールドを追加します
6. View Settings（並べ替え、ページネーション、エントリーの所有者）を設定します

3) 所有者と権限グループによる制限

View Settings → Show only entries created by the current user: ✓
View Settings → Required Capability: gravityview_view_entries

// Prevent metadata exposure in public views
add_filter('gravityview/fields/custom/content_after', function($content, $field) {
    if (!is_user_logged_in() && in_array($field->ID, ['internal_notes', 'api_key'])) {
        return '—';
    }
    return $content;
}, 10, 2);

4) エントリー承認ワークフロー

1. ビューレイアウトに Approval フィールドを追加します
2. 次のように設定します：View Settings → Approval Status → Approved only
3. Gravity Connect を使うと、送信内容を自動分類できます：

Gravity Connect Feed → classify "Flagged" →
GravityView filter: {Approval Status} = Flagged →
Admin-only view for review

5) エントリーの編集（フロントエンドでの編集）

1. Views → Edit → Edit Entry レイアウトにフィールドを追加します
2. ショートコードで埋め込みます：[gravityview id="1" context="edit"]
3. 権限を設定します：View Settings → User Edit → "Own entries only"

6) ショートコード

[gravityview id="1"]                         # basic view
[gravityview id="1" page_size="20"]          # paginated
[gravityview id="1" search_field="2"]        # pre-filtered by field 2
[gravityview id="1" context="single" entry_id="42"]  # single entry

7) MCP プロトタイピング

GravityView の構造を LLM に入力して、カスタムレイアウトの HTML を生成します：

// Export view field config for LLM context
$view_fields = get_post_meta(get_the_ID(), '_gravityview_directory_fields', true);
echo json_encode($view_fields, JSON_PRETTY_PRINT);

---

セキュリティ

• 公開ビューには、必ずエントリーの所有者制限を適用してください
• 公開ショートコードで機密性の高いフィールド ID を公開しないでください
• Roles and Capabilities の設定を使って、管理者専用ビューへのアクセスを制限してください
• 監査スクリプトの全容は wp-gravity-stack → references/security.md を参照してください

参考資料

• wp-gravity-forms スキル — ビューにデータを提供するフォームとエントリー
• wp-gravity-connect スキル — GravityView のフィルターにデータを提供する AI 分類