內容簡介
Esumo Field Renamer for ACF 是一款免費的開發者工具，專為 Advanced Custom Fields 設計，能夠在重新命名欄位時保留原有的數據和元資料，確保資料的完整性與一致性。
【主要功能】
• 支援欄位重新命名前後的數據遷移
• 保留欄位鍵、原始值及元資料行 ID
• 可預覽主題參考及檢查差異
外掛標籤
開發者團隊
原文外掛簡介
Renaming a field in Advanced Custom Fields changes its definition, but values already saved on posts can remain under the previous metadata name.
Esumo Field Renamer for ACF supports both before and after renaming, preserving the field key, raw values and metadata row IDs. It is a free developer tool with no account, license key, telemetry or external service.
Workflow
Test on a copy of your site, keep a full database backup and pause content editing.
Open Tools > Field Renamer and choose Before renaming or After renaming.
Select the field and enter its new name (Before) or previous name (After).
Prepare a preview. Resolve any conflicts before starting a new preview.
Optionally preview theme references, review every difference, and apply only checked files.
Rename the field and migrate values (Before), or migrate values (After). Verify the affected pages and remaining code references.
Before renaming supports native database definitions managed in the ACF editor. It changes only the field-name column and preserves the other field settings. PHP and Local JSON definitions must be renamed in their source first, then migrated with After renaming. Recent operations has its own tab; opening an operation there returns to its details.
When a field is renamed through the ACF field editor, the plugin records a suggestion for its previous name. Data migration always requires an explicit action.
Supported in 1.0
Top-level Text, Textarea, Number, Email and URL fields in active field groups explicitly assigned to posts, pages or custom post types. Data belonging to a different ACF field key is skipped. Ambiguous references and occupied destination names block migration, including empty destination values.
Nested fields, Repeater, Group, Flexible Content, Clone, ACF Blocks, Options Pages, attachments, revisions, users, terms and multisite are outside this version. The plugin does not edit definitions in PHP/JSON, dynamic names, JavaScript, Twig or meta queries. Test compatibility with any additional ACF extensions.
Optional theme references
Review literal first arguments of get_field(), the_field(), get_field_object(), update_field() and delete_field() in PHP files of the active theme and its parent. Check each file before applying it. Calls use field names, so review their context if multiple field groups share a name. Dynamic, named and namespaced calls need manual review. Symbolic links, vendor and node_modules are excluded.
Limits: 2,000 PHP files scanned, 512 KB per file, 50 matching files, and 2 MB of combined before/after content. Writes require edit_themes permission, allowed file modifications and direct filesystem access. Pause deployments and file edits during the operation. Files are restored separately from database changes. Hash checks refuse later edits, and saved file copies allow recovery after a lost response.
The preview checks write access to both the file and its directory. Unwritable files cannot be selected. Permissions are checked again before writing; existing theme permissions are never changed automatically. Replacement files preserve the original mode. Fix ownership/permissions through your hosting tools or apply the reviewed differences in your code editor.
MySQL / MariaDB require InnoDB for posts, postmeta and journal tables. SQLite requires the WordPress SQLite Database Integration drop-in 1.8.0 or later.
Recovery and data retention
Operations run in batches of up to 50 posts. Closing the tab stops subsequent requests; reopen the operation to resume. Completed requests remain recorded. Individual post changes and their journal updates use database transactions. On SQLite, each request also runs inside a write transaction.
Before-mode rollback restores the native field name and unchanged values. After-mode rollback requires restoring the old name in the source definition first, keeping the same key, type and group. Rollback refuses later edits. Restore selected theme files separately. Resolve any reported difference before resuming, or recover from a full backup.
The journal stores state and original metadata in {prefix}fracf_jobs and {prefix}fracf_items, and file copies in {prefix}fracf_code. Only administrators can use the tool. Metadata responses exclude raw field values; file previews show the relevant code lines to users allowed to edit themes. Journals are retained on deactivation and uninstall. Deleting a closed operation’s journal also removes its file backups and rollback ability. Keep database backups and journal access appropriately protected.
This is an independent plugin by Esumo and is not affiliated with or endorsed by Advanced Custom Fields.
