功能演示:





功能特性
核心功能
- 多种模块类型支持:优惠券、弹窗、通知、幻灯片、文章展示、分类展示、作者展示、自定义模块
- 可视化配置:直观的管理界面,支持拖拽排序和实时预览
- 短代码支持:通过短代码在任意位置插入模块
- PHP函数调用:支持在主题文件中直接调用
- REST API:完整的API接口支持
- 缓存机制:智能缓存提升性能
- 统计分析:详细的模块使用统计
模块类型
1. 优惠券模块 (coupon)
- 自定义优惠券标题和描述
- 设置优惠码和折扣信息
- 配置有效期和样式
- 支持背景色和文字颜色自定义
2. 弹窗模块 (popup)
- 多种触发方式:页面加载、点击、滚动、退出意图
- 自定义弹窗尺寸和延迟时间
- 支持HTML内容和样式定制
3. 通知模块 (notification)
- 多种通知类型:信息、成功、警告、错误
- 6种显示位置可选
- 自动隐藏和延迟设置
4. 幻灯片模块 (slider)
- 支持多张图片轮播
- 自动播放和播放速度控制
- 指示点和箭头显示控制
- 每张幻灯片支持标题、描述和链接
5. 文章展示模块 (post_display)
- 支持文章和页面类型
- 多种排序方式和数量控制
- 可选显示摘要、日期、作者
6. 分类展示模块 (category_display)
- 指定分类ID或显示所有分类
- 可选显示文章数量和描述
7. 作者展示模块 (author_display)
- 指定作者ID或显示所有作者
- 可选显示头像、简介、文章数量
8. 自定义模块 (custom)
- 完全自定义HTML、CSS、JavaScript
- 适合高级用户和特殊需求
安装和使用
安装步骤
- 将插件文件夹上传到
/wp-content/plugins/
目录 - 在WordPress管理后台激活插件
- 访问”模块管理”菜单开始使用
基本使用
创建模块
- 进入”模块管理” > “添加新模块”
- 选择模块类型
- 配置模块参数
- 保存模块
使用模块
短代码方式:
[ac_module id="1"]
[ac_module_display id=”1″]
[ac_module id=”1″ config='{“title”:”自定义标题”}’]
PHP函数方式:
<?php
// 显示模块
module_manager_display_module(1);
// 带配置覆盖
module_manager_display_module(1, array('title' => '自定义标题'));
// 获取模块HTML
$html = module_manager_get_module_html(1);
echo $html;
?>
REST API方式:
// 获取模块列表
fetch('/wp-json/module-manager/v1/modules')
.then(response => response.json())
.then(data => console.log(data));
// 渲染模块
fetch('/wp-json/module-manager/v1/modules/1/render')
.then(response => response.json())
.then(data => document.getElementById('module-container').innerHTML = data.html);
管理功能
模块管理
- 模块列表查看和搜索
- 批量操作:启用、禁用、删除
- 模块复制和导入导出
- 实时预览功能
统计分析
- 模块浏览次数统计
- 点击率和转化率分析
- 时间段统计报告
- 数据导出功能
系统设置
- 缓存配置
- 资源加载控制
- API访问设置
- 性能优化选项
开发者指南
钩子和过滤器
动作钩子:
// 模块渲染前
do_action('module_manager_before_render', $module);
// 模块渲染后
do_action('module_manager_after_render', $module, $output);
// 模块保存前
do_action('module_manager_before_save_module', $module_data);
// 模块保存后
do_action('module_manager_after_save_module', $module_id, $module_data);
过滤器钩子:
// 过滤模块输出
$output = apply_filters('module_manager_module_output', $output, $module, $config);
// 过滤模块类型
$types = apply_filters('module_manager_module_types', $types);
// 过滤模块配置
$config = apply_filters('module_manager_module_config', $config, $module);
自定义模块类型
// 注册自定义模块类型
add_filter('module_manager_module_types', function($types) {
$types['my_custom'] = '我的自定义模块';
return $types;
});
// 渲染自定义模块
add_filter('module_manager_render_my_custom', function($output, $config, $module) {
return '<div class="my-custom-module">' . $config['content'] . '</div>';
}, 10, 3);
数据库结构
模块表 (wp_module_manager_modules):
- id: 模块ID
- name: 模块名称
- type: 模块类型
- config: 配置数据(JSON)
- status: 状态(active/inactive)
- created_at: 创建时间
- updated_at: 更新时间
统计表 (wp_module_manager_stats):
- id: 统计ID
- module_id: 模块ID
- event_type: 事件类型(view/click/conversion)
- event_data: 事件数据(JSON)
- ip_address: IP地址
- user_agent: 用户代理
- created_at: 创建时间
API文档
REST API端点
获取模块列表:
GET /wp-json/module-manager/v1/modules
获取单个模块:
GET /wp-json/module-manager/v1/modules/{id}
创建模块:
POST /wp-json/module-manager/v1/modules
更新模块:
PUT /wp-json/module-manager/v1/modules/{id}
删除模块:
DELETE /wp-json/module-manager/v1/modules/{id}
渲染模块:
GET /wp-json/module-manager/v1/modules/{id}/render
获取统计:
GET /wp-json/module-manager/v1/modules/{id}/stats
常见问题
Q: 如何自定义模块样式?
A: 可以通过以下方式自定义样式:
- 在主题的style.css中添加CSS规则
- 使用自定义模块类型添加内联样式
- 在插件设置中禁用默认CSS,使用自己的样式
Q: 模块不显示怎么办?
A: 请检查:
- 模块状态是否为”启用”
- 短代码或函数调用是否正确
- 是否有JavaScript错误
- 缓存是否需要清理
Q: 如何备份模块数据?
A: 可以通过以下方式备份:
- 使用插件的导出功能
- 直接备份数据库表
- 使用WordPress的完整备份工具
Q: 插件对性能有影响吗?
A: 插件已经过性能优化:
- 智能缓存机制减少数据库查询
- 按需加载资源文件
- 可配置的资源加载选项
- 数据库查询优化
更新日志
v1.0.0
- 初始版本发布
- 支持8种模块类型
- 完整的管理界面
- REST API支持
- 统计分析功能
- 缓存机制
- 多语言支持
技术支持
如果您在使用过程中遇到问题,请:
- 查看常见问题部分
- 检查WordPress和PHP版本兼容性
- 联系技术支持
系统要求
- WordPress 5.0+
- PHP 7.4+
- MySQL 5.6+
兼容性
- ✅ WordPress 6.0+ 完全兼容
- ✅ 已修复 WordPress 5.9.0 中 WP_User_Query 的弃用警告
- ✅ 支持最新的WordPress REST API
- ✅ 兼容主流主题和插件
许可证
本插件采用GPL v2或更高版本许可证。
开发者: CodeBuddy Team
版本: 1.0.0
最后更新: 2025-08-22
扫码访问小程序中的本文
