1.1.28 新增：WhatsApp多功能询盘按钮

升级与迁移：
1. 上传本合集安装包，替换已安装的 FUCUO Elements。
2. 在后台「FUCUO 组件库」勾选「WhatsApp多功能询盘按钮」并保存。
3. 若装有独立版「FUCUO WhatsApp 产品询盘」，停用该独立插件。合集会在独立版仍启用时跳过此模块，避免重复加载。
4. 刷新 Elementor 编辑器；在 FUCUO Elements 分类中搜索新名称。原有页面中的按钮、号码、字段与样式继续使用，无需重建。
5. 模块需要 WooCommerce；在单一产品模板中使用。可填写预览产品 ID，在编辑画布展开表单预览。

字段支持：文本、邮箱、电话、多行文本、下拉、多选下拉、单选、复选、同意条款、数字、日期、时间、网址和说明文字。
支持添加、删除、排序、必填、默认值、选项、字段宽度与表单样式。默认展开编辑器预览，前台仍点击按钮显示弹窗。
新增模块遵循合集的升级规则：已有安装默认关闭，需手动勾选；新安装默认开启。
继续到 WhatsApp 后仍由访客点击发送。自定义表单信息通过跳转链接传给 WhatsApp，本组件不在数据库保存询盘。

本次检查：PHP 语法、组件注册与资源依赖、独立版冲突、旧设置渲染、表单与编辑预览 DOM 自动化；未在真实 WordPress / Elementor 站点运行端到端测试。

----------------------------------------

FUCUO Elements · Elementor 组件库 v1.1.28
作者：建站老王

一、安装
1. 建议先备份网站，已有网站先在测试副本验证。
2. WordPress 后台 → 插件 → 安装插件 → 上传插件。
3. 选择 FUCUO-Elements-1.1.27.zip，安装并启用；不需要解压后逐个安装。
4. 需要已启用 Elementor。合集采用传统 Widget_Base 组件接口，免费版即可。
5. WordPress 6.0+、PHP 7.4+、Elementor 3.5+。请同时满足所用 Elementor 自身的环境要求。

二、已有独立插件如何切换
先在合集勾选要使用的组件并保存，再停用对应的独立插件；不需要删除它们。
若已经同时启用，合集会提示冲突并跳过对应模块，避免重复注册。
可在「FUCUO 组件库」点击「停用本站原独立插件，使用合集」。
网络启用的原插件需由网络管理员到网络管理停用；手动加载的 MU 插件需手动移除。
保留了原组件标识、控件字段、PDF 文章类型、分类、元数据与短代码，不主动改写已有页面。
页面配置可继续由合集读取，但仍需在实际站点核对主题、Elementor 版本和缓存环境。
原插件处于启用状态时，相应组件仍由原插件提供，合集开关不能控制原插件。

三、开启与关闭
WordPress 后台左侧 → FUCUO 组件库 → 组件管理。
全新启用合集时默认开启全部 11 个组件；覆盖升级时新组件默认关闭，需要在「组件管理」中手动开启。可以逐个选择或全部开启 / 关闭，最后点击「保存组件设置」。
保存后重新打开或刷新 Elementor 编辑器，在「FUCUO 组件库」分组中找到已开启的组件。
关闭组件：不注册、不加载该模块，编辑器中不显示，前台该组件也会停止渲染。
关闭前应检查是否有页面正在使用该组件；不要删除缺失组件占位或在关闭期间改写其内容。
重新开启后，保留的配置可继续使用。合集不主动删除页面配置、PDF、客户资料或媒体文件。
保存时会清理 Elementor 生成文件；缓存插件、服务器与 CDN 缓存需自行清除。
外部页面缓存未清除时，前台可能暂时仍显示关闭前的内容。

四、包含的 11 个组件
1. 3D PDF画册资料库（原模块版本 1.1.0）
2. 3D幻灯片（原模块版本 1.2.2）
3. 3D翻页作品展示（原模块版本 1.3.1）
4. 产品分类伸缩面板（原包内部标注版本 1.2.0）
5. 双布局横向时间线（原模块版本 1.1.2）
6. 左右联动幻灯片（原模块版本 1.1.2）
7. 滚动叠层作品集（原模块版本 1.1.0）
8. 滚动生长流程（原模块版本 1.4.2）
9. FUCUO Hero 幻灯片（原模块版本 0.3.1）

五、PDF 画册
启用 PDF 组件后，在「FUCUO 组件库」下可管理「PDF 画册」「资料分类」「下载客户资料」。
先添加画册，选择本站媒体库的 PDF，可选封面，发布后在 Elementor 组件中展示。
推荐短代码 [laowang_pdf_library]；历史短代码仍兼容。
PDF 下载前填写资料的原功能保留，客户资料仅管理员可查看、导出。
画册在线阅读使用媒体库的公开地址。填写资料是下载引导，不是文件访问权限保护；
掌握媒体库文件原地址的人仍可直接读取 PDF。请勿用于需要保密的资料。
关闭 PDF 模块会同时停止其后台入口、短代码和下载处理，但不会删除已保存的资料。

六、本次整合与修复
- 统一插件作者与组件内可见旧署名为 建站老王。
- 统一 Elementor 组件分组，保留原组件 ID 与设置字段。
- 为组件增加独立开关，关闭时跳过对应模块的 PHP 与资源注册。
- 统一资源注册时机，以组件依赖加载样式和脚本。
- 增加原独立插件冲突检测，支持停用本站原独立插件后切换。
- 开关保存使用管理员权限校验、Nonce 校验、模块白名单与严格值校验。
- 修复原 3D 幻灯片 iframe 内联 100vh 高度覆盖响应式高度设置的问题。
- 保留 PDF.js / PageFlip 本地依赖及第三方授权文件。
- 不包含自动删除用户资料的卸载脚本。

七、检查范围与限制
已完成 PHP 8.3 语法检查、第一方 JS 语法检查、资源路径检查，以及隔离环境中的
全开、全关、逐个启用、缺少 Elementor、原插件冲突、保存白名单、权限和 Nonce 检查。
隔离测试通过不等于实际 Elementor 编辑器、主题和缓存插件的完整兼容性保证。
完整 WordPress + Elementor 联调因 Elementor 自身的外部服务请求被自动审批拦截，
未完成实际编辑器联调，也未在你的生产网站安装测试。建议先在测试站安装验证。
新版 Elementor 的原子元素模式、第三方主题容器溢出设置、JS 延迟加载及合并压缩
仍可能影响动画。若组件未找到，请使用 Elementor 支持传统第三方小工具的编辑界面。

八、v1.0.2 修复
提前绑定组件与分类注册钩子，不再依赖单次 plugins_loaded 检测成功才注册。
增加 init 及 Elementor 回调阶段的初始化补偿，并避免重复加载。
管理页区分「模块已加载」与「开关已开启，等待 Elementor 加载」。

九、v1.0.2 时间线箭头左右调节
选择「双布局横向时间线」→ 内容 → 布局与内容 → 布局样式选「全幅背景 + 底部时间线」。
然后打开「样式 → 布局尺寸 → 背景布局箭头距左侧」。
数值增大，两个箭头整体向右移动；数值减小，向左移动。支持 px 与 %，支持电脑、平板、手机分别设置。
原「背景布局箭头距顶部」仍控制上下位置。新项留空沿用原背景左右留白，已有页面无需重新设置。

十、v1.1.0 新增 FUCUO Hero 幻灯片
新增组件保持原组件标识 fucuo_hero_slideshow 和原设置字段，已有页面配置可直接读取。
覆盖升级后，请在「FUCUO 组件库 → 组件管理」开启「FUCUO Hero 幻灯片」；全新安装默认开启。
如原独立插件仍启用，合集检测到冲突后会跳过该组件，请先停用原独立插件。

案例横向轮播（原波浪案例幻灯片）：旧页面会自动显示为直线横向轮播，原案例与样式可继续编辑。从独立版迁移时，在组件管理勾选该模块并保存，再停用独立版。原页面无需重新拖入组件。

响应式手风琴：需要 Elementor 3.26+ 并启用容器功能。升级后到 FUCUO 组件库勾选「FUCUO 响应式手风琴」并保存，再停用原「FUCUO 响应式手风琴」独立插件。已编辑的折叠项目及其嵌套小部件会继续使用，无需重建。

Hero 幻灯片 → 内容 → 布局设置：模式 A 可选择左侧或左下角指示器，内容区默认跟随主题宽度，也可单独选择内容全宽。背景仍铺满外层容器。

Hero 幻灯片 → 内容 → 轮播设置 → 指示器样式：可选择「隐藏指示器」，箭头设置独立。
