zibll 采用模块化、分层化、低耦合、高扩展的现代化架构，核心目录如下：

 

zibll/
├── functions.php # 主题唯一入口
├── func.php # 自定义代码区（更新不覆盖）
├── inc/ # 核心框架、函数、配置
├── zibpay/ # 支付与商城系统
├── action/ # 动作与 AJAX 处理
├── oauth/ # 第三方登录
├── pages/ # 自定义页面模板
├── template/ # 复用模板组件
└── 静态资源目录：css、js、fonts、img

 

二、核心技术架构特点

1. 双 CSF 配置框架

• inc/codestar-framework/：原版轻量框架
• inc/csf-framework/：Zibll 定制增强版（主题核心）

2. 高级小工具系统 Zib_CFSwidget

• 核心类：inc/widgets/widget-class.php
• 支持：动画、侧边栏吸附、PC / 移动端条件显示、尺寸提示

3. 自定义文件加载机制

4. 强大支付商城系统（ZibPay）

• 多渠道支付：支付宝、微信、PayPal、虎皮椒、PayJS
• 完整体系：订单、VIP、积分、余额、优惠券、卡密
• 高级能力：用户提现、推广返利、订单管理

---

三、插件开发建议（官方规范）

1. 使用 zib_require_end 钩子

    

   确保主题完全加载完毕后再运行插件逻辑，避免依赖缺失。

    
2. 直接使用 zib_require() 加载文件

    

   复用主题成熟的加载机制，保持代码风格统一。

    
3. 继承 Zib_CFSwidget 开发小工具

    

   一键获得动画、吸附、多端显示、后台配置等原生能力。

    
4. 基于 CSF 框架添加配置面板

    

   无缝融入主题后台，体验统一，无需重新造轮子。

    

---

四、架构整体评价

• 模块化程度极高
• 功能与视图分离
• 加载流程统一可控
• 二次开发友好
• 插件扩展便捷
• 主题更新不覆盖自定义代码
   

  是 WordPress 商业主题中结构规范、易开发、易维护的优秀典范。

---

五、二次开发总结

1. 自定义 PHP 写在 func.php（更新不覆盖）
2. 模板修改用子主题
3. 插件开发用 zib_require_end 钩子
4. 小工具继承 Zib_CFSwidget
5. 后台配置使用 CSF 框架
6. 禁止修改核心目录文件（inc/、zibpay/、action/）