Zibll Shop Frontend Publish 子比主题商城前端发布插件

插件简介

版本更新

v1.2.0 – 重构优化版本（推荐升级）

1. 代码架构优化

• 命名空间隔离：引入 PHP 命名空间彻底解决全局变量和函数冲突问题
• 单一职责拆分：将原 1866 行的单文件拆分为 8 个独立类文件
  • constants.php – 全局常量与状态枚举定义
  • class-cache.php – 统一缓存管理
  • class-security.php – 安全验证与输入清理
  • class-product.php – 商品 CRUD 与业务逻辑
  • class-order.php – 订单与售后管理
  • class-settings.php – 插件设置管理
  • class-ajax.php – AJAX 请求统一处理
  • zibll-shop-frontend-publish.php – 主入口文件（仅保留钩子注册）
   

2. 安全性增强

• 文件上传双重验证：同时检查文件扩展名和真实 MIME 类型，防止恶意文件上传
• 请求速率限制：所有 AJAX 接口添加 60 秒内最多 10 次请求的限流保护
• 统一权限控制：新增check_seller_permission()方法，集中管理商家权限
• 全面输入过滤：所有外部输入严格使用 WordPress 官方sanitize_*函数处理

3. 性能优化

• 解决 N+1 查询问题：
  • 订单列表批量获取关联商品、用户信息和缩略图
  • 使用get_posts()批量查询替代循环内单次查询
   
• 多层缓存机制：
  • 商品分类列表缓存（1 小时）
  • 优惠活动列表缓存（30 分钟）
  • 商家统计数据缓存（5 分钟）
  • 全部使用 WordPress 原生对象缓存wp_cache_get/set替代get_transient
   

4. 代码质量提升

• 枚举常量替代魔法数字：
  php

   

  运行

   

   

   

  // 订单状态枚举
  Order_Status::PENDING = 1;    // 待付款
  Order_Status::PAID = 2;       // 已付款
  Order_Status::SHIPPED = 3;    // 已发货
  Order_Status::COMPLETED = 4;  // 已完成
  Order_Status::CANCELLED = 5;  // 已取消
  
  // 售后状态枚举
  After_Sale_Status::PENDING = '1';
  After_Sale_Status::PROCESSING = '2';
  After_Sale_Status::COMPLETED = '3';
  After_Sale_Status::REJECTED = '4';
  

  复制

   
   
• 统一状态显示：新增Status_Names类，集中处理所有状态的文本映射
• 标准化 AJAX 响应：封装Security::ajax_error()和Security::ajax_success()方法

5. 前端体验优化

• 原生主题样式：完全采用子比主题 CSS 变量系统，无缝适配日间 / 夜间模式
• 实时表单验证：所有输入项添加实时验证和统一错误提示
• 危险操作确认：删除商品、取消订单等操作添加二次确认弹窗
• 加载状态优化：所有异步操作添加按钮加载状态和全局 loading 动画
• 移动端深度优化：重新设计移动端布局，提升触摸操作体验

6. 标准文件结构

zibll-shop-frontend-publish/
├── zibll-shop-frontend-publish.php    # 插件主入口
├── includes/                          # 核心类文件
│   ├── constants.php                  # 常量与枚举定义
│   ├── class-cache.php               # 缓存管理
│   ├── class-security.php             # 安全验证
│   ├── class-product.php              # 产品管理
│   ├── class-order.php                # 订单与售后管理
│   ├── class-settings.php             # 设置管理
│   └── class-ajax.php                 # AJAX处理
├── templates/                         # 前端模板
│   ├── product-edit.php               # 商品发布/编辑
│   ├── product-manage.php             # 商品管理
│   └── seller-orders.php              # 订单管理
└── assets/                            # 静态资源
    ├── js/frontend.js                 # 前端脚本
    └── css/frontend.css               # 样式文件

v1.1.7

• 修复移动端响应式布局问题
• 修复积分商品收益计算错误
• 完善订单详情页积分商品信息显示
• 新增订单详情弹窗功能
• 添加商品类型（积分 / 付费）标识
• 优化移动端订单详情视图

v1.1.6

• 新增完整售后管理系统
• 支持用户提交退款 / 退货申请
• 商家端可处理退款确认和退货收货
• 新增售后状态统计面板
• 添加售后详情弹窗
• 实现售后状态变更实时通知

安装说明

1. 下载插件并解压
2. 将zibll-shop-frontend-publish目录上传至wp-content/plugins/
3. WordPress 后台 → 插件 → 启用「子比主题商城前端发布」
4. 进入「设置」→「商城前端发布」进行配置

核心功能

• ✅ 前端商品发布与编辑
• ✅ 多规格商品支持（颜色、尺寸等）
• ✅ 商品分类与标签管理
• ✅ 推广返佣比例自定义
• ✅ 优惠活动关联选择
• ✅ 运费模板配置
• ✅ 商家端订单管理
• ✅ 完整售后管理流程
• ✅ 订单与售后消息通知
• ✅ 完美适配子比主题样式
• ✅ 全面支持日间 / 夜间模式
• ✅ 移动端深度优化

伪静态规则配置

Nginx（含宝塔面板）

location /shop-edit {
    try_files $uri $uri/ /index.php?zsfp_product_edit=$1;
}
location /shop-manage {
    try_files $uri $uri/ /index.php?zsfp_product_manage=$1;
}
location /shop-orders {
    try_files $uri $uri/ /index.php?zsfp_seller_orders=$1;
}

Apache (.htaccess)

RewriteEngine On
RewriteRule ^shop-edit/?$ index.php?zsfp_product_edit=add [L]
RewriteRule ^shop-edit/([0-9]+)/?$ index.php?zsfp_product_edit=$1 [L]
RewriteRule ^shop-manage/?$ index.php?zsfp_product_manage=list [L]
RewriteRule ^shop-manage/([0-9]+)/?$ index.php?zsfp_product_manage=$1 [L]
RewriteRule ^shop-orders/?$ index.php?zsfp_seller_orders=list [L]

页面访问链接

• 发布新商品：/shop-edit
• 编辑商品：/shop-edit/{商品ID}
• 商品管理：/shop-manage
• 订单管理：/shop-orders

配置选项

兼容性要求

• WordPress 5.0+
• 子比主题 (Zibll) 最新稳定版
• PHP 7.4+（推荐 PHP 8.0+）

技术支持

注意事项

1. 本插件无需修改任何主题核心文件，升级主题不会影响插件功能
2. 必须正确配置伪静态规则，否则页面将无法正常访问
3. 建议定期备份数据库，以防数据丢失
4. 如遇兼容性问题，请先升级 WordPress 和子比主题至最新版本