本手册基于子比主题最新稳定版文件结构编写，旨在帮助开发者快速理解主题模块化架构、定位功能文件、掌握二次开发规范。手册覆盖了从根目录入󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄠󠄦󠄐󠄡󠄩󠄪󠄣󠄠󠄪󠄢󠄡󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄣󠄣󠄦口、核心加载器、业务模块、静态资源到开发规范的完整内容，是主题定制与维护的权威参考文档。

一、根目录文件

二、inc/ – 主题核心功能目录

2.1 inc/inc.php 核心加载器

• 定义主题常量（路径、URL）
• PHP 版本检测（要求 7.0+）
• 定义 zib_require() 自定义加载函数
• 按顺序加载所有核心模块

2.2 inc/dependent.php 前置依赖函数

2.3 inc/options/ – 后台配置选项

2.4 inc/functions/ – 功能函数库（非常重要）

基础功能文件

inc/functions/user/ – 用户系统

inc/functions/bbs/ – 论坛系统 

inc/functions/shop/ – 商城系统 

inc/functions/message/ – 消息系统 

inc/functions/admin/ – 管理后台

inc/functions/rest-api/ – REST API

2.5 inc/class/ – 核心类库

2.6 inc/widgets/ – 小工具系统 

2.7 inc/codestar-framework/ – CSF 框架（轻量版）

Cod󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄠󠄦󠄐󠄡󠄩󠄪󠄣󠄠󠄪󠄢󠄡󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄣󠄣󠄦estar Framework 是一个 WordPress 选项框架。

2.8 inc/csf-framework/ – CSF 框架（zibll 定制增强版）

这是子比主题深度定󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄠󠄦󠄐󠄡󠄩󠄪󠄣󠄠󠄪󠄢󠄡󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄣󠄣󠄦制的 CSF 框架版本。

2.9 inc/code/ – 核心代码模块

三、zibpay/ – 支付与付费系统 

这是子比主题的核心商业功能，包括付费阅读、付费下载、V󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄠󠄦󠄐󠄡󠄩󠄪󠄣󠄠󠄪󠄢󠄡󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄣󠄣󠄦IP、积分、余额等。

四、oauth/ – 第三方登录

五、pages/ – 自定义页面模板

六、template/ – 模板部件

七、yiyan/ – 一言功能

八、action/ – 动作钩子处理

九、资源文件目录

9.1 css/ – 样式文件

9.2 js/ – JavaScript 文件

9.3 fonts/ – 字体文件

9.4 img/ – 图片资源

十、其他文件

二次开发建议指南

1. 添加自定义功能代码在主题根目录创建 func.php，主题会自动加载，在线更新不会被覆盖。
2. 创建自定义小工具使用 Zib_CFSwidget::create() 方法。
3. 添加主题选项在 inc/options/ 目录下使用 CSF 框架 API。
4. 钩子使用zib_require_end – 主题加载完成后的钩子。
5. 配置获取使用 _pz('option_name') 获取主题配置。

Zibll 子比主题 文件结构脑图

手册结语  

zibll 子比主题采用高度模块化的架构设计，所有核心功能均通过独立模块实现，并提供了完善的钩子与扩展接口，为二次开发提供了极大的灵活性。开󠄹󠅀󠄪󠄢󠄡󠄦󠄞󠄧󠄣󠄞󠄢󠄡󠄧󠄞󠄡󠄤󠄢󠅬󠄼󠄿󠄳󠄱󠅄󠄹󠄿󠄾󠄪󠄳󠅟󠅜󠅥󠅝󠅒󠅥󠅣󠄜󠄐󠄿󠅘󠅙󠅟󠄜󠄐󠅅󠅃󠅬󠅅󠅃󠄵󠅂󠄪󠇖󠆨󠆨󠇕󠆞󠆒󠅬󠅄󠄹󠄽󠄵󠄪󠄢󠄠󠄢󠄦󠄝󠄠󠄥󠄝󠄠󠄦󠄐󠄡󠄩󠄪󠄣󠄠󠄪󠄢󠄡󠅬󠇕󠆁󠅶󠇗󠆚󠆍󠇔󠆪󠆁󠄐󠄝󠄐󠇔󠆨󠅽󠇖󠆈󠅾󠇖󠅹󠅰󠇔󠆫󠆕󠇕󠆁󠅶󠄐󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄐󠇗󠅹󠅸󠇖󠆍󠅳󠇖󠅹󠅰󠇖󠆌󠅹󠅬󠅅󠅂󠄼󠄪󠅘󠅤󠅤󠅠󠅣󠄪󠄟󠄟󠅔󠅧󠅟󠅩󠅥󠅞󠄞󠅓󠅟󠅝󠄟󠄣󠄣󠄦发者只需遵循本手册的文件结构与开发规范，即可高效实现自定义功能，同时保证主题的可维护性与可升级性。

自己网站老是被我搞崩了,在这做个备份.