內容簡介
TwoTen Inline Canvas for ACF Blocks 外掛旨在恢復 WordPress 7.1 版本後，ACF 區塊編輯器的內嵌編輯模式，讓使用者能夠在主畫布中全寬顯示編輯欄位，提供更流暢的編輯體驗。
【主要功能】
• 恢復 ACF 區塊的內嵌編輯模式
• 支援 WYSIWYG 編輯器和媒體選擇器
• 自動更新以適應 WordPress 核心版本
• 不修改核心檔案，保持系統安全
• 兼容性檢查，確保功能正常運作
外掛標籤
開發者團隊
② 後台搜尋「TwoTen Inline Canvas for ACF Blocks」→ 直接安裝（推薦）
原文外掛簡介
WordPress 7.1 renders the post editor canvas inside an iframe on every
post, unconditionally. ACF PRO cannot initialise its field forms inside
that iframe, so from 7.1 every ACF block is forced into preview mode with
its fields squeezed into the right-hand sidebar — the familiar inline
“edit mode” disappears.
WordPress 7.1 still ships the old non-iframed canvas rendering path; core
just stopped using it. This plugin serves a copy of the wp-editor script
bundle with the single flag that controls this flipped
(shouldIframe: true becomes false), which restores the pre-7.1
editing experience: ACF block fields render inline in the main canvas,
full width, with working WYSIWYG, media pickers and repeaters.
Safety properties
No core files are modified on disk. The patched copy lives in
wp-content/uploads/twoten-inline-canvas/ and core stays pristine
(wp core verify-checksums passes).
Scoped: only post.php / post-new.php receive the patched bundle.
The site editor — which requires the iframe — and all other admin
screens get stock WordPress.
Self-healing: the patched copy is keyed to the WordPress version and
bundle mtime, so it regenerates automatically after every core update.
Fail-safe: the patch is only applied when the flag appears exactly once
in the bundle. If a future WordPress changes that code, the plugin
serves the stock bundle and the editor simply returns to the iframed
canvas — nothing breaks.
Does nothing at all on WordPress below 7.1 (safe to install ahead of an
upgrade) and when SCRIPT_DEBUG is enabled.
Block requirements
Inline edit mode is an ACF Blocks v2 behaviour. ACF PRO 6.8+ defaults
block.json blocks to v3 on WordPress 7.1+, which removes edit mode by
design (iframe or not) — every block becomes a preview with an
“Edit Block” modal. This plugin therefore pins the default back to v2
via ACF’s acf/blocks/default_block_version filter. Your blocks should:
not set "blockVersion": 3 explicitly in block.json (an explicit
value is respected and keeps that block in v3);
set "acf": { "mode": "edit" } (and ideally "supports": { "mode": false })
so blocks open as forms rather than previews.
Blocks saved while stuck in preview mode carry "mode":"preview" in their
saved markup, which overrides the block default. For blocks whose mode
toggle is hidden ("supports": { "mode": false }) the plugin resets that
to the block’s configured mode when the post is parsed in the editor, and
the content self-heals on the next save. Blocks that allow toggling keep
the saved choice. To clean everything in one go instead:
wp search-replace '"mode":"preview"' '"mode":"edit"' wp_posts --include-columns=post_content
Updates
Updates are delivered through the WordPress.org plugin directory like any
other plugin. Updates do not apply when the file is run as a must-use
plugin.
When to remove this plugin
This is a compatibility shim, not a permanent architecture. Remove it once
ACF PRO supports field editing inside the iframed canvas — check the ACF
changelog before major WordPress upgrades. After any WordPress core
update, open a post in the editor and confirm blocks still show inline
forms; if the fail-safe has kicked in they will show previews again, and
the plugin needs a new patch pattern for that WordPress version.
Disabling programmatically
add_filter( 'tts_inline_canvas_enabled', '__return_false' );
