本手册基于子比主题最新稳定版文件结构编写，旨在帮助开发者快速理解主题模块化架构、定位功能文件、掌握二次开发规范。手册覆盖了从根目录入口、核心加载器、业务模块、静态资源到开发规范的完整内容，是主题定制与维护的权威参考文档。

根目录文件

文件名	功能说明
functions.php	主题入口文件，加载核心模块
style.css	主题样式文件，含主题信息
index.php	首页模板
header.php	头部模板
footer.php	底部模板
single.php	文章单页模板
page.php	页面模板
archive.php	归档模板
category.php	分类模板
tag.php	标签模板
author.php	作者模板
search.php	搜索模板
404.php	404 模板
comments.php	评论模板
screenshot.png	主题截图

主题核心功能目录 – inc

inc/inc.php 核心加载器

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

inc/dependent.php 前置依赖函数

函数 / 功能	说明
zib_get_template_page_url()	自动创建 / 获取自定义页面（登录、发布等）
zib_get_user_integral_add_options()	用户经验值获得规则配置
_pz($name, $default, $subname)	获取主题选项，全局通用
_spz($name, $value)	设置主题选项
zib_get_option_meta()	统一获取选项 / 元数据（支持缓存）
zib_update_option_meta()	统一设置选项 / 元数据
zib_get_user_meta() / zib_update_user_meta()	用户元数据读写（统一接口）
zib_get_post_meta() / zib_update_post_meta()	文章元数据读写
zib_get_comment_meta() / zib_update_comment_meta()	评论元数据读写
zib_get_term_meta() / zib_update_term_meta()	分类元数据读写

inc/options/ – 后台配置选项

文件名	功能说明
options.php	选项模块入口，加载 CSF 框架
options-module.php	选项模块定义
admin-options.php	后台主题设置面板（核心配置）
metabox-options.php	文章编辑页的元框选项
profile-options.php	用户资料页的配置选项
action.php	选项保存等操作钩子
upgrade.php	主题升级数据迁移处理
zib-update.php	在线更新功能
zib-code.php	主题授权码相关

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

基础功能文件

文件名	功能说明
functions.php	函数库入口，加载所有功能文件
zib-tool.php	通用工具函数
zib-theme.php	主题相关功能
zib-head.php	<head> 标签输出
zib-header.php	头部导航功能
zib-footer.php	底部功能
zib-page.php	页面模板功能
zib-post.php	文章功能
zib-single.php	文章详情页功能
zib-posts-list.php	文章列表功能
zib-index.php	首页功能
zib-category.php	分类页功能
zib-author.php	作者页功能
zib-attachment.php	附件页功能
zib-search.php	搜索功能
zib-content.php	内容处理（文章内容过滤等）
zib-comments-list.php	评论列表功能
zib-share.php	分享功能
zib-share-wechat.php	微信分享功能
zib-email.php	邮件发送功能
zib-svg-icon.php	SVG 图标功能
zib-user.php	用户基础功能
zib-frontend-set.php	前端设置功能

inc/functions/user/ – 用户系统

文件名	功能说明
user.php	用户系统主文件
user-auth.php	用户认证（登录、注册、找回密码）
user-level.php	用户等级系统
user_medal.php	用户勋章系统
user-checkin.php	用户签到功能
user-ban.php	用户封禁功能
user-cap.php	用户权限模板
page.php	用户页面模板
ajax.php	用户相关 AJAX
invit-code.php	邀请码功能
admin/admin.php	用户管理后台
admin/auth-page.php	认证管理后台
admin/ban-page.php	封禁管理后台
admin/invit-code-page.php	邀请码管理后台
page/user-center.php	用户中心页面

inc/functions/bbs/ – 论坛系统

文件名	功能说明
bbs.php	论坛系统入口
inc/class.init.php	论坛初始化类
inc/class.admin.php	论坛管理类
inc/posts.php	帖子功能
inc/plate.php	版块功能
inc/plate-cat.php	版块分类功能
inc/comment.php	评论功能
inc/term.php	分类功能
inc/user.php	用户功能
inc/edit.php	编辑功能
inc/edit-posts.php	帖子编辑
inc/functions.php	论坛工具函数
inc/moderator.php	版主功能
inc/setup.php	论坛设置
inc/single.php	帖子详情页
inc/template.php	模板函数
inc/msg.php	消息通知
inc/home.php	论坛首页
inc/user-page.php	用户论坛页
action/action.php	论坛动作钩子
action/ajax-*.php	各类 AJAX 处理（帖子、评论、版块等）
admin/option.php	论坛后台设置
admin/meta-option.php	论坛元数据设置
page/*.php	论坛页面模板（首页、帖子、版块等）
widgets/*.php	论坛小工具
assets/css/main.css	论坛样式
assets/js/main.js	论坛脚本

inc/functions/shop/ – 商城系统

文件名	功能说明
shop.php	商城系统入口
inc/class.init.php	商城初始化类
inc/class.setup.php	商城设置类
inc/product.php	商品功能
inc/cart.php	购物车功能
inc/order.php	订单功能
inc/pay.php	支付功能
inc/cat.php	商品分类
inc/tag.php	商品标签
inc/comment.php	商品评论
inc/discount.php	折扣功能
inc/shipping.php	物流功能
inc/after-sale.php	售后功能
inc/public.php	公共函数
inc/template.php	模板函数
inc/lists.php	列表功能
inc/home.php	商城首页
inc/term.php	分类页
inc/single.php	商品详情页
inc/user.php	用户商城功能
inc/user-center.php	用户商城中心
inc/vue.php	Vue.js 集成
inc/author.php	作者商品页
inc/msg.php	商城消息
action/action.php	商城动作钩子
action/other.php	其他操作
admin/admin.php	商城后台管理
admin/options/*.php	商城后台配置选项
page/*.php	商城页面（商品、购物车、订单等）
widgets/*.php	商城小工具
assets/css/main.css	商城样式
assets/js/main.js	商城脚本

本站收集的资源仅供内部学习研究软件设计思想和原理使用，学习研究后请自觉删除，请勿传播，因未及时删除所造成的任何后果责任自负。

如果用于其他用途，请购买正版支持作者，谢谢！若您认为本站发布的内容若侵犯到您的权益，请联系站长邮箱:596993347@qq.com 进行删除处理。
本站资源大多存储在云盘，如发现链接失效，请联系我们，我们会第一时间更新。

THE END