Gather Grove Sync for Notion
| 开发者 | gturtle108 |
|---|---|
| 更新时间 | 2026年10月20日 03:55 |
| PHP版本: | 8.2 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
Gather Grove Sync for Notion sends your WordPress data to a Notion database — form submissions (Elementor Pro, Contact Form 7, WPForms, Fluent Forms), WooCommerce orders, Gather Grove Booking activity, and anything else via an incoming webhook or the developer API. The plugin owns the Notion schema for you — columns auto-extend as data arrives, with smart type mapping (email → Email, tel → Phone, date → Date) and a rich_text fallback for anything unrecognized.
Features
- Many sources, one Notion pipe — Elementor Pro, Contact Form 7, WPForms (incl. Lite), Fluent Forms, and WooCommerce orders sync out of the box; any other service can POST to a secure incoming webhook. Every source funnels through the same dedup / column-auto-extend / retry / activity-log pipeline.
- Auto-extending schema — submit a new form, the columns appear in Notion. No manual mapping.
- Smart type mapping — Elementor email/tel/url/number/date/select/checkbox fields map to the matching Notion property types so your data is sortable and filterable.
- Multi-database routing — send different forms to different Notion databases via per-form overrides, with a global default for everything else.
- Deduplication — merge submissions by Email (or any column you choose) so the same person's submissions across forms collect into one row, with a chronological log appended to the page body. Original page title is preserved on update so "first contact" stays visible.
- Backfill historical submissions — paginate through Elementor's Submissions storage in 25-row chunks. Idempotent — re-runs skip already-synced submissions.
- Activity log — every sync attempt is recorded to a custom DB table, visible in the admin with success/failure badges and direct "View in Notion" links. Capped at 1000 entries with auto-prune.
- Encrypted token storage — Notion integration token is stored encrypted at rest using AES-256-GCM, with the key derived from your WordPress AUTH_KEY.
- Connection retry — one in-process retry on transient API failures (429, 5xx), then a background retry ladder for anything still failing.
- One-click database creation — search for a parent page, set a title, click Create. New database starts pre-configured with the plugin's system columns.
- Connection status banner — green/red status at the top of the settings page with per-database breakdown when multiple databases are configured.
- Create a Notion integration at https://www.notion.so/profile/integrations and copy the token.
- Install and activate the plugin, then go to Settings → Gather Grove Sync for Notion.
- Paste the token (or use the one-click "Connect to Notion"). Either paste an existing database ID, or use the built-in Create a Notion database tool to make a fresh one.
- The integration must be invited to your Notion database (in Notion: open the database → ··· → Connections → add your integration).
- Submit a form, place a WooCommerce order, or send a webhook — the plugin auto-creates whatever columns it needs and writes the record. See and control every source on the Sources tab.
- The plugin does not provide a manual field-mapping UI — it owns the schema. Field labels become column names automatically. (If you need manual mapping, a different integration may suit you better.)
- The Elementor source requires Elementor Pro (free Elementor has no form widget). Every other source — Contact Form 7, WPForms, Fluent Forms, WooCommerce, Gather Grove Booking, the webhook — works on its own.
安装:
- Upload the
gather-grove-notion-syncfolder to/wp-content/plugins/, or install via Plugins → Add New → Upload Plugin and choose the zip. - Activate through the WordPress Plugins menu.
- Go to Settings → Gather Grove Sync for Notion and connect your Notion workspace (one-click "Connect to Notion", or paste an integration token).
- Either paste an existing database ID into the Default Notion Database ID field, or use the Create a Notion database section to make a fresh one.
- In Notion, open the database as a full page → click
•••→ Connections → add your integration. (If you used the in-plugin creation tool, this is automatic.) - Click Test connection & refresh schema to verify everything's wired up.
- Submit a form on your site to test.
屏幕截图:
常见问题:
Does this work with the free version of Elementor?
No. The plugin hooks into elementor_pro/forms/new_record, which is only available in Elementor Pro.
Which sources are supported?
Out of the box: Elementor Pro, Contact Form 7, WPForms (including the free Lite version), Fluent Forms, WooCommerce orders, and Gather Grove Booking (bookings, attendance, and purchases — members and guests). Any other service can POST to a secure incoming webhook, and developers can push records with gather_grove_notion_record(). Each source auto-activates when its plugin is present — see and manage them all on the Sources tab.
What happens to columns I don't configure?
The plugin auto-extends the database schema. Field labels become column names; types are inferred from the source field type (email → Email, number → Number, etc.) with a rich_text fallback for anything unrecognized.
Will deduplication accidentally merge two different "John Smiths" by name?
Only if you configure name fields as shared. By default, only Email, Phone, and Phone Number are treated as merge keys — they're the only fields reliably unique per person. You can edit the shared field list in settings, but adding name fields is a known footgun: a duplicate row is just visible noise, but a wrong merge silently destroys data.
Can I sync historical Elementor submissions?
Yes, if Elementor's Submissions storage is enabled (visible at Elementor → Submissions in WP admin). Use the Backfill Historical Submissions section in plugin settings. Backfill is idempotent — re-runs skip already-synced submissions.
Is my Notion integration token safe?
The token is stored encrypted at rest using AES-256-GCM. The encryption key is derived from your WordPress AUTH_KEY (defined in wp-config.php) via SHA-256. This defends against database-only leaks (e.g. SQL injection in another plugin, leaked DB backups). It does not defend against full server compromise — if an attacker has both the database and wp-config.php, the token can be decrypted.
What if my Notion database fills up?
Notion databases cap at ~100 properties. Most sites stay well under this. If you have many forms with mostly-unique fields, the connection banner shows the property count so you can monitor it. The fix is either to share more field labels across forms (so they collapse into single columns) or to use multi-database routing to split forms across multiple Notion databases.
What if Notion is down?
The plugin retries once immediately, after a one-second pause — deliberately not the longer wait Notion's Retry-After header asks for, because this runs while your visitor waits for the form to submit. If that retry also fails, the write is handed to a background queue with exponential backoff (1 min → 5 min → 30 min → 2 hr → 12 hr), where waiting properly costs nobody anything. After 5 attempts the entry is dead-lettered; dead-lettered writes are visible on the Tools tab with a "Clear" control.
A failure that retrying cannot fix — no token, a revoked token, a deleted database — is reported rather than queued. Retrying those just fills the queue with the same error.
Can I send the same form to multiple Notion databases?
Not in this release. Each form has at most one destination (its override, or the default). If you need fan-out, the simplest workaround is to query the destination Notion database via Notion's own automations to forward rows.
更新日志:
0.55.1
- Fixed: updating to 0.54.0 or 0.55.0 could stop a site that also runs other Gather Grove plugins with a "critical error" on every page. Includes Gather Grove core 0.89.0, which prevents it. If you deactivated Sync for Notion because of this, you can turn it back on after updating.
- Changed: includes Gather Grove core 0.88.0. Every marketing email carries your studio's postal address (set it under Settings → Email delivery → Marketing email details), email always goes out from your verified sending address, and Tools → Export / Erase Personal Data now covers all of Gather Grove.
- New: Tools → Export Personal Data and Erase Personal Data now cover Sync for Notion. An export lists what the plugin keeps about the person on your site (activity-log entries, writes waiting to be retried or parked) and notes that their rows live in your Notion workspace. An erase deletes those, cancels any write still waiting so it can't put the row back, and archives the person's rows in your Notion databases (matched by the email address in the request; older addresses are only matched on your site, since one may have been a typo). If Notion can't be reached, the request tells you to search Notion for the address and archive the rows by hand.
- Guide: https://gathergrove.io/docs/notion-sync/privacy-and-data/
- Changed: includes Gather Grove core 0.86.0. After a site moves to a new address, a "This site moved" checklist shows what was updated and what still needs you, and email delivery reports follow the site. Someone who unsubscribed now confirms by email before they get news and offers again.
- New: if your site's security keys change (this usually happens when a site moves to a new host), the Setup tab now says the Notion connection needs reconnecting instead of showing it as connected, and Gather Grove's "security keys changed" notice lists it. Copy the old keys back into wp-config.php, or connect again.
- New: when you confirm your site's new address after a move, Gather Grove's move report reminds you to update anything that posts to the incoming webhook (Zapier, Make, a script) to the new address.
- Guide: https://gathergrove.io/docs/notion-sync/troubleshooting/
- Updated: Gather Grove's shared screens — member bar, emails, media player — now follow your site language; Italian included.
- Fixed: the Notion Sync settings screen now shows fully in Italian on an Italian site; part of it had stayed in English.
- Updated: the shared Gather Grove core to 0.81.0. On a copy of your site — a staging or local copy, or the site moved to a new address — Gather Grove's scheduled jobs (emails, syncs, renewals) wait until you confirm in wp-admin that it is the live site, so a copy never does the live site's work twice. If the site's security keys change, a notice lists what to reconnect.
- New: when a member's email changes in Gather Grove (wp-admin, Front Desk or Pulse), their Notion row's Email changes with it, so their next booking or Pulse update keeps the same row instead of starting a second one. Shown on the Activity tab as "email changed". If another row already has the new address, both rows are left alone and the Activity tab shows "email conflict" so you can merge them. Guide: https://gathergrove.io/docs/notion-sync/client-list-in-notion/
- The WordPress Dashboard widget's styles now apply only inside the widget, and the app install prompt, push notification button and offline page now load their scripts and styles the standard WordPress way.
- Fixed: re-saving your Postmark key for the same server no longer switches site email off.
- Fixed: Gather Grove Booking now keeps one row per client in Notion (matched on Email) without needing the Deduplication setting, which is off by default. That setting still decides whether form entries merge. Duplicate rows already in your database are not combined; merge them by hand. Guide: https://gathergrove.io/docs/notion-sync/client-list-in-notion/
- Fixed: Gather Grove Pulse rows are titled with the member's name, and their Form Name now says "Gather Grove Pulse" instead of a member's name.
- Fixed: Contact Form 7 entries are no longer lost when the form's email fails. The entry reaches Notion, and the Activity tab shows "mail failed".
- Fixed: WooCommerce order status changes (completed, refunded, cancelled) now update the order's row in Notion instead of never arriving.
- Fixed: a manually pasted token can now be removed with Disconnect.
- Fixed: databases chosen on the Sources tab are now included in the connection test, the column list and the per-database renames.
- Fixed: the Forms tab shows the right Active / Not synced status for forms from every plugin, not only Elementor.
- Help text now uses the same button and card names as the screen.
- Updated the shared Gather Grove core to 0.70.0, so the whole suite runs the same version.
- Now requires WordPress 6.9 or later.
- Changed: the plugin's internal settings, background jobs and admin actions now use its full
gather_grove_notion_sync_prefix. Your connection, settings and mappings carry over automatically on update. - Changed: the wp-config constant for the incoming-webhook secret is now
GATHER_GROVE_NOTION_SYNC_WEBHOOK_SECRET. The previous name keeps working. - Removed: the old submission action name deprecated in 0.28.0. Use
gather_grove/notion_sync/submission. - Changed: updated the bundled Gather Grove core to 0.63.2.
- Fixed: on a site with no other Gather Grove plugin, the settings page was missing from the admin menu. It is back under Settings.
- Fixed: opening a form on the Forms tab could stop with a fatal error instead of showing its field mapping.
- Hardening: column-rename names are sanitized before they are saved, and the Notion connect flow's return step carries a WordPress nonce.
- Maintenance: admin actions and settings reads are written in the shapes WordPress.org's plugin review expects, and diagnostic messages go to the site's error log in a consistent format. Nothing changes in how the plugin works.
- Maintenance: database queries and admin-screen markup are written in the shapes WordPress.org's plugin review expects, ahead of the plugin's listing there. Nothing changes in how the plugin works.
- Changed: updated the bundled Gather Grove core to 0.55.0.
- Added: if you use Gather Grove Pulse, each member's Notion row now stays up to date with their tags, pipeline stage and last activity — one row per member, updated in place rather than added again each time.
- Added: other plugins can now keep a single Notion row up to date — matched on a column you choose, updating in place rather than adding a new row each time. Groundwork for syncing member and lifecycle data to Notion.
- Added: Notion pages can now be mirrored into WordPress, so other Gather Grove plugins can display them — the groundwork for a Notion-backed wiki tab on Community Spaces. Content refreshes automatically, and a page that is deleted or unshared in Notion is flagged rather than disappearing silently.
- Housekeeping: the settings code is reorganised so each tab owns its own logic. No change to what any screen does or looks like.
- Fixed: submissions arriving from a webhook, the public API, or another plugin could be stored in Notion dated 31 December 1969 instead of when they were actually submitted. The timestamp is now read properly whether it arrives as a number or as a date.
- Fixed: rows already saved with that wrong date now correct themselves the next time the same person submits, and the correction is noted in the activity log. If you renamed a row in Notion, your name for it is kept.
- Changed: the settings screens now use the shared Gather Grove design — the same cards, badges and banners as the other Gather Grove plugins. Colours follow your site's palette instead of being fixed green, so the plugin no longer clashes with your own brand.
- Changed: tables, notices and "nothing here yet" states have been rebuilt. Wide tables scroll on their own instead of pushing the page sideways, and every empty screen now explains what will appear there and how.
- Changed: notices are announced to screen readers, which WordPress's default notices are not.
- Fixed: some help text on the Tools tab showed raw HTML tags.
- Fixed: the Export CSV button sat on its own line instead of beside Clear log. Earlier releases: the complete version history is in CHANGELOG.md within the plugin.