FieldPilot - AI & JSON Copilot for ACF
| 开发者 | xaviermsd |
|---|---|
| 更新时间 | 2026年10月1日 16:25 |
| 捐献地址: | 去捐款 |
| PHP版本: | 8.1 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
Advanced Custom Fields has not changed how you author fields in a decade: you click
through a UI, one field at a time. Meanwhile every developer has an AI that writes
JSON perfectly well. The missing piece was never generation - it was safe
application.
FieldPilot is an AI & JSON Copilot and configuration patch engine for ACF. Paste JSON, see exactly
what will change, apply only that, and roll back if you were wrong.
The rule the whole plugin is built around:
Nothing changes except what the JSON asked for.Set one field to required and that is the only byte that moves. Instructions, conditional logic, wrapper classes, field keys and every other field in the group come out byte-identical. What it does
- Partial updates. Change one setting on one field. ACF's own importer can only replace a whole field group; this changes precisely what you named.
- Diff preview. Every change is shown before anything is written - added, removed, moved, and every setting that differs, old value to new.
- Target Isolation & Sibling Protection. Target any node in a nested ACF tree (Repeater subfield, Flexible Content layout) with guarantees that sibling branches are untouched.
- Conflict detection. Changing a field's type, renaming a field that holds content, deleting something with data in it - each stops and asks, with the trade-offs spelled out. It never guesses.
- Snapshot and rollback. Every batch is snapshotted with its complete field tree. One click restores the exact prior configuration. If a write fails verification, it rolls back automatically.
- Interactive Custom Field Builder (All 4 ACF Tabs). Dynamic controls for General, Validation, Presentation, and Conditional Logic across all 36 ACF field types with responsive width, return formats, choices, sub-fields, layouts, and bulk appending.
- Deep 4-Tab Settings Mapping. Full parameter mapping for General, Validation, Presentation, and Conditional Logic across all 36 ACF field types.
- Deep nesting. Groups, Repeaters, Flexible Content layouts and Clone fields,
at any depth, targeted by human path:
["Agent", "Contact", "Social"]. - Reads sloppy JSON. AI output uses
groupforfield_group,descriptionforinstructions,truewhere ACF wants1. All of it is normalised rather than rejected, so you paste instead of hand-fixing. - Reads native ACF exports too, in both directions.
- Visual 10-Step Guided Onboarding Tour. An interactive walkthrough across Dashboard, Import, and History with target spotlights, safety checklists, and replay controls.
- Target Field Group Gate & Inline Creation. Select an existing group or click "+ Add New Field Group" to generate one in ACF with instant AJAX selection and builder unlock.
- WordPress.org Compliant Uninstall Controls. Configure data cleanup options in Settings to preserve or completely wipe snapshots, options, and logs on uninstall.
- REST API and WP-CLI with full parity, so deployments can do everything the UI can.
- Knows what it cannot touch. Field groups registered in PHP, or loaded from
acf-jsonand not yet synced, are physically unpatchable. The plugin detects them up front and says so, instead of silently writing orphaned rows.
安装:
- Upload the plugin to
/wp-content/plugins/fieldpilot-for-acf/, or install it through Plugins -> Add New. - Activate it. ACF must already be active.
- Go to FieldPilot in the admin menu.
屏幕截图:
常见问题:
Will this overwrite my existing fields?
No. An update changes only the settings your JSON names. Every other setting, and
every other field, is preserved exactly. Field keys are never regenerated, so no
existing content is ever orphaned by an update.
What happens if something goes wrong?
Every batch is snapshotted before the first write, then verified afterwards by re-reading what was saved. If the result does not match the plan, the snapshot is restored automatically and you are told nothing was changed. You can also roll back any past change manually from the History screen.
How do I create a new field group if none exist yet?
Click "+ Add New Field Group" in the Target Field Group bar on the Import screen, enter a title, and click "Create & Select". FieldPilot creates the ACF group via AJAX and instantly unlocks the custom field builder and prompt generator.
What happens to my data when I delete the plugin?
By default, your settings and rollback history remain safely stored in the database in case you reinstall. If you want a complete wipe, go to FieldPilot -> Settings and enable "Wipe all FieldPilot data on uninstall". When deleted through the WordPress Plugins screen, all snapshots, options, and demo flags are cleanly purged.
How do I replay or restart the guided onboarding tour?
You can restart the 10-step guided tour anytime by clicking the "Replay Guided Tour" button at the top of the FieldPilot Dashboard or Settings screen.
Can I delete fields?
Yes, but deliberately. The plugin scans for stored content first - including values inside repeaters, which a name-based search would miss - and a delete that would orphan content requires explicit confirmation.
Why can't it edit my field group?
If a group is registered in PHP with acf_add_local_field_group(), it does not live
in the database, so nothing can be written to it. If it comes from an acf-json file
that has not been synced, the same applies. The Dashboard labels every group so you
know in advance; for JSON groups, sync them into the database first.
Does it work with ACF free?
Yes, for every field type ACF free provides. Repeater, Flexible Content, Clone and Gallery are ACF PRO features.
Does it need an API key?
No. The plugin contains no AI integration at all - it generates prompts for whichever AI you already use.
更新日志:
1.0.30
- Fixed: Guided tour Step 2 on fresh sites with zero field groups now displays sample preview rows and highlights the status table clearly, avoiding collapsed 0px spotlight line.
- Enhanced: Dashboard screen renders an inline notice and sample preview table demonstrating editable vs locked field groups when no ACF groups exist yet.
- Enhanced: Updated Guided Onboarding Tour Step 3 to highlight Target Field Group selection and inline creation gate.
- Enhanced: Comprehensive documentation updates across README, FAQs, and developer screenshot guides.
- Fixed: Resolved Plugin Check (PCP) NonceVerification warning on tour step parameter handling.
- Enhanced: Target Field Group creation UX with toggle button state switching between "+ Add New Field Group" and "Close".
- Enhanced: Persistent creation form when no field groups exist, preventing dead-end UI states on fresh installations.
- Enhanced: 100% WordPress.org guideline compliance for uninstall cleanup by configuring data purge exclusively via FieldPilot Settings.
- Fixed: Form cancellation and focus state handling when closing field group creation box.
- Added: Uninstall data cleanup setting in FieldPilot Settings to wipe or preserve settings, history snapshots, and demo data when deleting the plugin.
- Added: Safe, idempotent uninstall routine (uninstall.php) with prefix handling, demo marker checks, and scheduled cron cleanup.
- Added: Direct "Add New Field Group" creation button with instant AJAX ACF group generation and auto-selection.
- Added: Mandatory Step 1 gate requiring an active Target Field Group before unlocking the custom field builder or prompt generator.
- Added: Soft red validation error borders and clear warning messages for required field labels, empty group titles, and validation range limits.
- Fixed: Resolved JavaScript SyntaxError on variable declarations in custom field builder.
- Fixed: Guided tour replay button icon and styling alignment in Settings and Dashboard screens.
- Fixed: Prevented premature sample diff cleanup and sidebar guide flash when transitioning from Step 8 to Step 9.
- Fixed: Instantly hide previous overlay and spotlight before navigating across screens.
- Added: Non-revocable, disabled sample row in History table when empty to cleanly demonstrate rollback functionality.
- Fixed: Ensured Step 8 targets conflict box directly instead of falling back to sidebar controls.
- Fixed: Flawless step transitions between Import (Step 8) and History (Step 9).
- Fixed: Replaced collapsed empty notice in History screen with styled empty card to fix spotlight rendering.
- Fixed: Ensured backward step navigation from History to Import page restores editor tab and diff preview.
- Enhanced: Robust retry and auto-recovery for tour spotlights across all screen transitions.
- Added: Visual 10-step guided onboarding tour with target spotlight overlay.
- Added: Direct Settings and Schema & Operations Guide action links on Plugins screen.
- Added: Replay tour action on Dashboard and Settings screens.
- Enhanced: Completely eliminated demo data from code, history screen, and UI.
- Enhanced: Polished tour modal styling, close button, and diff review layout.
- Maintenance release.
- Maintenance release.
- Maintenance release.
- Hardened: Removed --file option and arbitrary file write from WP-CLI export command in favor of standard shell output redirection.
- Security: Converted Export admin screen to POST method with explicit nonce verification and permission checks.
- Security: Sanitized and validated all components of uploaded JSON file structures before processing.
- Security: Added explicit capability checks to all form and file submission handlers.
- Added: Side-by-side split review workbench in Tab 2 with live diff preview rendering directly alongside JSON editor.
- Added: Target field group selector in JSON editor toolbar for dynamic template group assignment.
- Added: Glowing pulse animation on Apply button once safety checklist checkboxes are confirmed.
- Enhanced: Step 2 in AI tab split into clear sequential sub-steps (2A: Copy & Open AI, 2B: Paste AI Output).
- Fixed: Cleaned up append button labeling to avoid double plus signs.
- Added: Prominent bottom action bar (+ Append Field to Queue) directly below the 4 ACF tabs in the Custom Field Builder.
- Added: Instant Enter key triggers on all builder fields to append specifications immediately from any tab.
- Added: Visual indicator badge confirming when fields are added to the queue.
- Added: Comprehensive in-app Schema & Operations Developer Guide in Tab 3 covering all 8 operations, target scope resolution, 4 ACF tabs parameter mapping, 36 field types reference matrix, and 1-click template loaders.
- Fixed: Resolved DOM hierarchy and removed duplicate intent textarea in AI Prompt tab.
- Fixed: Prevented WordPress admin footer (#wpfooter) from overlapping content.
- Fixed: Standardized AI steps into full-width sequential workflow and aligned editor action buttons.
- Added: Complete 36 ACF field type template patches in the JSON Editor template selector across 6 clean optgroups.
- Enhanced: Reordered workflow tabs so Tab 1 is "1. Generate with AI" (default) and Tab 2 is "2. JSON Editor & Import".
- Enhanced: Interactive step guidance animations (pulsing ready states) when fields are queued to direct the user toward generating prompts and pasting responses.
- Fixed: Standardized button alignments, heights (36px), and flex centering across all action bars.
- Enhanced: AI prompt generator with compound multi-field examples and full 4-tab token parsing.
- Added: Full 4-tab interactive Custom Field Builder (General, Validation, Presentation, Conditional Logic) with dynamic type-adapting controls for return format, choices, sub-fields, layouts, post types, taxonomy, toolbar, button label, min/max/step, allowed MIME types, maxlength, placeholder, prepend, append, textarea rows, wrapper classes, and conditional logic.
- Added: Complete 4-tab parameter mapping (General, Validation, Presentation, Conditional Logic) and comprehensive specifications across all 36 ACF field types.
- Added: Width and instructions controls in the Interactive Custom Field Builder with Enter key shortcuts.
- Enhanced: Detailed user guide and complete JSON property mapping documentation in README.md and readme.txt.
- Added: Interactive Custom Field Builder in AI tab allowing developers to specify project-specific field names, choose from all 36 ACF types, toggle required flags, and append specs into prompt.
- Enhanced: AI prompt generator with deep parameter rules, return formats, choice schemas, and bulk multi-field addition examples.
- Fixed: SchemaValidator now accepts 0/1 integer booleans alongside boolean true/false to prevent false warning notices with ACF internal storage format.
- Added: Multi-field bulk append without overwriting when clicking quick idea chips.
- Added: Categorized quick dropdown covering all 36 ACF field types.
- Added: Quick "Clear text" action in AI prompt tab.
- Fixed: TreeReader exportArray now populates complete field trees via acf_get_fields prior to export, guaranteeing byte-for-byte snapshot and rollback integrity.
- Enhanced: Standardized button heights, flex vertical centering, Dashicons alignment, and AI launcher pills.
- Fixed: Diagnostics SelfTest export method to prevent TypeError on live ACF installs.
- Added: Tab navigation URL hash synchronization (#editor, #ai, #guide).
- Fixed: adding a field produced a spurious warning about its key.
- Import screen rewritten around numbered steps and tabs.
- Added "Insert an example" template picker.
- Added read-only mode and Diagnostics Self-Test runner.
- Initial release.