Avada Builder Pro 集成工具

MCP Avada Builder Pro

Avada Fusion Builder的高级MCP集成，具有完整的短代码解析和元素管理功能。

版本：3.3.3

身份和隶属关系

• 这是一个 独立社区项目.
• 它是 不隶属于ThemeFusion/Avada，也不由其背书或维护.
• 所有产品名称和商标均归其各自所有者所有。

概述

MCP Avada Builder Pro通过WordPress abilities API和MCP协议提供全面的功能，以编程方式控制Avada Fusion Builder。特征：

• 递归短代码解析器 -处理深层嵌套结构，包括内部行/列
• 完全层次结构支持 -容器>行>列>元素（包括内部行/列）
• 56种元素类型 -Fusion Builder元素的完整注册表，包括 fusion_imageframe
• 通道保护 -未注册的元素类型保留为原始短代码（无数据丢失）
• 基于路径的元素访问 -独特的路径，如 container_0/row_0/column_0/fusion_text_1
• 媒体字段验证 -对image_id、图像URL、图库id进行严格验证
• 结构验证 -替换内容在写入之前验证结构模式
• 写入路径ID稳定性 -每次写入操作后返回规范路径
• 数据丢失防护 -所有突变的干运行验证可防止沉默元素丢失
• 审计日志 -所有突变都记录到带有时间戳/用户/操作的post-meta中
• 页面结构健康检查 -验证标签平衡、重复、往返保真度
• 短代码树修复 -对格式错误的短代码树进行初步修复

能力（共28项）

核心页面+元素管理

• avada-pro/get-info -获取构建器/主题/插件版本和元素计数。
• avada-pro/get-page-structure -获取页面的完整解析结构。
• avada-pro/list-all-elements -列出所有页面元素（可选类型筛选器）。
• avada-pro/add-container -添加一个容器（可选带有行/列）。
• avada-pro/add-element -将元素添加到容器/行/列坐标中。
• avada-pro/update-element -按路径更新元素内容/属性。
• avada-pro/delete-element -按路径删除元素。
• avada-pro/replace-content -替换结构对象中的整个页面内容（使用结构验证和备份）。
• avada-pro/list-element-types -列出所有静态元素类型（56）。
• avada-pro/clean-duplicates -删除页面中的重复元素。

布局操作

• avada-pro/restructure-layout -根据匹配的内容重构目标行。
• avada-pro/duplicate-element -将元素克隆到位。
• avada-pro/move-element -在容器/行/列之间移动元素。
• avada-pro/find-element -按类型/内容/属性搜索页面元素。
• avada-pro/bulk-update -在一次保存中更新多个元素（事务性、全部或无）。
• avada-pro/select-columns -通过作用域选择器（容器标签/索引、行、列索引、属性、包含的元素类型）选择列。
• avada-pro/bulk-update-columns -通过选择器或显式路径批量修补列属性（支持模拟运行）。
• avada-pro/clone-column-style -使用保留键将源列样式克隆到目标（支持模拟运行）。
• avada-pro/clone-element-style -将源元素样式属性克隆到目标元素（支持模拟运行）。
• avada-pro/enforce-responsive-policy -批量应用桌面/平板电脑/移动列宽策略（支持模拟运行）。

页面生命周期

• avada-pro/create-page -在启用Avada的情况下创建草稿/已发布页面/帖子。
• avada-pro/list-pages -列出Avada Builder处于活动状态的帖子/页面。

元素模式反思

• avada-pro/get-element-schema -获取短代码的运行时/静态参数架构。
• avada-pro/get-element-defaults -从FusionSC/runtime参数中获取运行时默认值。
• avada-pro/list-element-categories -列出类别+每个类别的元素。
• avada-pro/search-elements -按关键字/类别搜索可用元素类型。

验证与修复（v3.2.0）

• avada-pro/validate-page-structure -健康检查：标签平衡、重复、往返保真度、构建器状态。返回健康评分。
• avada-pro/repair-shortcode-tree -修复格式错误的短代码树（默认情况下为模拟运行）。删除重复项，清理空容器，创建备份。

支持的元素类型（共56种）

布局元素

• fusion_builder_container -主包装
• fusion_builder_row -行组织者
• fusion_builder_column -立柱布局
• fusion_accordion -可折叠部分
• fusion_toggle -单切换
• fusion_tabs -标签界面
• fusion_tab -个人选项卡
• fusion_tooltip -悬停工具提示
• fusion_popover -点击弹出窗口
• fusion_modal -弹出模式
• fusion_modal_text_link -模态触发链接
• fusion_viewport -可见性控制

内容元素

• fusion_text -文本块
• fusion_title -标题（H1-H6）
• fusion_button -带链接的按钮
• fusion_separator -视觉分隔器
• fusion_alert -通知框
• fusion_code -代码块
• fusion_code_block -代码块包装器
• fusion_syntax_highlighter -高级代码
• fusion_table -数据表
• fusion_tagline -标注框
• fusion_checklist -样式化列表
• fusion_content_boxes -内容网格
• fusion_content_box -独立盒子
• fusion_blog -博客文章
• fusion_portfolio -投资组合项目
• fusion_portfolio_masonry -砌体布置
• fusion_faq -常见问题解答部分
• fusion_counter -动画计数器
• fusion_counters -多个计数器
• fusion_progress -进度条
• fusion_testimonial -客户见证
• fusion_testimonials -推荐滑块
• fusion_pricing_table -定价栏
• fusion_pricing_column -单层
• fusion_pricing_price -价格显示
• fusion_pricing_button -CTA按钮
• fusion_person -团队简介

媒体元素

• fusion_image -图片
• fusion_imageframe -具有样式和效果的图像框架
• fusion_images -图像轮播
• fusion_gallery -图片库
• fusion_video -视频嵌入
• fusion_audio -音频播放器
• fusion_map -谷歌地图
• fusion_fontawesome -图标
• fusion_slider -内容滑块
• fusion_post_slider -帖子滑块
• fusion_rev_slider -旋转滑块
• fusion_layerslider -图层滑块
• fusion_fusion_slider -Fusion滑块
• fusion_post_grid -立柱网格

排版元素

• fusion_google_fonts -字体导入
• fusion_highlight -文本高亮显示
• fusion_dropcap -大写首字母

社会因素

• fusion_social_links -社交图标

列类型

支持所有Avada列布局： 1_1, 1_2, 2_3, 1_3, 3_5, 1_4, 3_4, 1_5, 2_5, 4_5, 1_6, 5_6

元素路径

每个元素都有一个唯一的路径：

container_{index}/row_{index}/column_{index}/{element_type}_{index}

例子： container_0/row_0/column_0/fusion_text_2

在写入操作之后，a canonical_path 返回反映实际持久路径的值（在保存周期内稳定）。

安全特性

• 数据丢失防护 -每个突变都会在写入前后验证短代码标签计数。阻止可能丢失元素的操作。
• 结构验证 - replace-content 在接受之前验证容器/行/列层次结构。
• 媒体验证 - image_id 根据媒体库进行验证，验证URL，检查库ID。
• 事务性批量更新 -全有或全无验证：要么所有更新都通过，要么不应用任何更新。
• 自动备份 - replace-content 和 repair-shortcode-tree 在执行破坏性操作之前，将备份存储在post-meta中。
• 审计日志 -所有突变都记录了时间戳、用户、能力和动作描述（每个帖子最后100个事件）。
• 通道元素 -在解析/生成周期中，未注册的短代码作为原始文本保留。

需求

• WordPress 5.8+
• Avada主题7.0+
• Avada Builder插件3.0+
• 能力API插件

先决条件和MCP适配器设置

要将MCP Avada Builder Pro与AI代理或外部自动化一起使用，您必须具备：

• WordPress MCP适配器插件 (mcp适配器)
• 能力API插件 (能力api)
• Avada主题 (7.0+)
• Avada生成器插件 (3.0+)

1.安装所需插件

1. API能力

   • 下载自 能力api GitHub
   • 上传到 wp-content/plugins/ 并激活

2. MCP适配器

   • 下载自 mcp适配器GitHub
   • 上传到 wp-content/plugins/ 并激活

3. Avada主题和构建器

   • 通过ThemeForest或您喜欢的方法安装
   • 激活主题和构建器插件

4. MCP Avada Builder Pro （此插件）

   • 上传到 wp-content/plugins/ 并激活

2.验证能力暴露

激活后，MCP Avada Builder Pro的能力将通过以下方式展示：

• WordPress REST API：
  • GET /wp-json/wp-abilities/v1/abilities （列出能力）
  • POST /wp-json/wp-abilities/v1/abilities/{id}/invoke （奔跑能力）
• MCP适配器：
  • GET /wp-json/mcp/mcp-adapter-default-server （MCP工具发现）

测试：

curl http://your-site.local/wp-json/wp-abilities/v1/abilities | jq '.[] | select(.meta.mcp.public == true)'

你应该看到所有 avada-pro/* 列出并可调用的能力。

3.AI代理/自动化设置

使用wordpress API URL、用户名和密码配置MCP客户端（例如@automatic/MCP-wordpress-remote）。看 .mcp.json 例如config。

安装

1. 将插件上传到 wp-content/plugins/
2. 通过WordPress管理员激活
3. 能力将自动注册

贡献者快速入门

1. 分叉存储库。
2. 从以下位置创建分支 main.
3. 做出有针对性的改变。
4. 运行PHP lint：
   • php -l mcp-avada-builder-pro.php
   • php -l includes/class-avada-parser.php
   • php -l includes/class-avada-elements.php
5. 使用模板打开PR。

请参阅：

• 贡献.md
• 安全.md
• 代码_OF_CONDUCT.md

结构化编辑模式（示例）

1） 真相卡复制源（列）

• 使用 clone-column-style 与：
  • source_column_path：例如。 container_5/row_0/column_1
  • selector：作用域为目标节
  • preserve_attributes：例如。 type, type_medium, type_small, first, last, class, id
  • dry_run: true 首先，然后 false

2） 跨多张卡的阴影同步

• 使用 bulk-update-columns:
  • selector：目标卡
  • column_attributes: { "box_shadow_horizontal": "2", "box_shadow_vertical": "2" }
  • dry_run: true 第一

3） 响应式堆叠规范化

• 使用 enforce-responsive-policy:
  • desktop: "keep"
  • tablet: "1_2"
  • mobile: "1_1"
  • 选择器作用于目标卡集

4） 元素级样式克隆（图标/标题/图像）

• 使用 clone-element-style:
  • source_element_path：例如第一张卡 fusion_title/fusion_fontawesome/fusion_image 元素
  • selector.element_type：目标元素类型相同
  • preserve_attributes：保留内容标识密钥（例如图像/链接/文本特定的attr）
  • dry_run: true 第一

更新日志

3.3.3

• 修正了解析器行为 fusion_image 内部简码 fusion_images 不会被解析为独立元素。
• 防止在结构化页面更新后，在图像转盘下方重新引入重复的大图像块。
• 强化转盘编辑工作流程，实现可重复的构建器安全突变。

3.3.1

• 添加 avada-pro/clone-element-style 用于使用保留键控件进行真值源元素属性克隆。
• 添加 avada-pro/enforce-responsive-policy 用于批量桌面/平板电脑/移动设备宽度策略执行。
• 为样式克隆工作流中的结构化元素定位添加了选择器助手。
• 添加了批量样式和响应式规范化的模拟运行优先工作流示例。
• 添加了OSS基线文档和GitHub模板(LICENSE, CONTRIBUTING, SECURITY，问题/PR模板，CI PHP lint工作流）。

3.3.0

• 添加 avada-pro/select-columns 用于按容器标签/索引、行/索引、attr和元素存在进行范围列查询。
• 添加 avada-pro/bulk-update-columns 在差速器前后进行干式运行。
• 添加 avada-pro/clone-column-style 带有保留键控制和模拟运行预览。

3.2.0

• 解析器修复：修复了所有前缀冲突正则表达式模式（fusion_image/imageframe/images、tab/tab、counter/counters、content_box/content_boxes等）
• 解析器修复：容器解析器现在使用递归 parse_nested_shortcode 而不是非贪婪正则表达式
• 媒体验证：在add元素和update元素中添加了对image_id、图像URL、画廊image_ids的严格验证
• 写入路径稳定性：所有写入操作现在都返回 canonical_path 保存后重新读取
• 更换硬化的内容物：结构模式验证、空内容拒绝、替换前自动备份
• 新能力: validate-page-structure -带有标签平衡、重复、往返保真度的健康检查
• 新能力: repair-shortcode-tree -先进行干式修复，去除重复部分并清理空容器
• 注册表：已添加 fusion_imageframe 到静态元素注册表（共56种）
• 版本：提升至3.2.0（共23种能力）

3.1.2

• 强化权限回调，对所有12个帖子特定能力进行输入验证
• 添加了元素类型和属性验证助手
• 批量更新的事务安全性（全验证或全无验证）
• 所有突变操作的审计日志系统

3.1.0

• 添加了模式自检功能： get-element-schema, get-element-defaults, list-element-categories, search-elements

3.0.0

• 添加了高级编辑功能： create-page, list-pages, duplicate-element, move-element, find-element, bulk-update, restructure-layout

2.0.0

• 最初的Pro版本具有解析器、层次结构管理和核心CRUD功能。

作者

arnelG

• GitHub：@wikiwyrhead

许可证

GNU通用公共许可证v2.0或更高版本（GPL-2.0或更高）。
看 许可证.