Zibll 子比主题完整文件结构开发手册-小武站

AI摘要

小武站

一、根目录文件

表格

文件名	功能说明
`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/` – 主题核心功能目录

2.1 `inc/inc.php` ★★★ 核心加载器

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

2.2 `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()`	分类元数据读写

2.3 `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`	主题授权码相关

2.4 `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`	商城脚本

`inc/functions/message/` – 消息系统 ★

表格

文件名	功能说明
`functions.php`	消息系统入口
`class/message-class.php`	消息核心类
`class/private-class.php`	私信类
`functions/user.php`	用户消息功能
`functions/ajax.php`	消息 AJAX
`functions/new.php`	新消息处理
`functions/admin.php`	后台消息管理
`functions/admin_page.php`	后台消息页面
`functions/wechat-template-msg.php`	微信模板消息
`page/msg-center.php`	消息中心页面

`inc/functions/admin/` – 管理后台

表格

文件名	功能说明
`admin-main.php`	后台主功能
`admin-set.php`	后台设置

`inc/functions/rest-api/` – REST API

表格

文件名	功能说明
`function.php`	REST API 功能

2.5 `inc/class/` – 核心类库

表格

文件名	功能说明
`class.php`	核心类
`db-class.php`	数据库操作类
`file-class.php`	文件处理类
`qrcode.class.php`	二维码生成类
`sms-class.php`	短信发送类
`express-class.php`	物流查询类
`ms-class.php`	可能是微软相关集成
`meilisearch-class.php`	Meilisearch 搜索集成
`api-audit-class.php`	内容审核 API 类
`SignatureHelper.php`	签名助手类
`tx-sdk-send.php`	腾讯云 SDK 发送

2.6 `inc/widgets/` – 小工具系统 ★

表格

文件名	功能说明
`widget-class.php`	★ `Zib_CFSwidget` 核心类，用于创建 CSF 框架的小工具
`widget-index.php`	注册所有小工具
`widget-user.php`	用户小工具
`widget-posts.php`	文章小工具
`widget-more.php`	更多小工具
`widget-slider.php`	轮播小工具

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

Codestar Framework 是一个 WordPress 选项框架。

表格

目录 / 文件	说明
`codestar-framework.php`	框架入口
`classes/*.php`	框架核心类
`fields/*.php`	字段类型（文本、复选框、上传、颜色等）
`views/*.php`	视图模板
`samples/*.php`	使用示例
`assets/css/`	样式文件
`assets/js/`	脚本文件

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

这是子比主题深度定制的 CSF 框架版本。

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

表格

文件名	功能说明
`require.php`	自动加载（部分代码被加密）
`aut.php`	授权认证相关
`new_aut.php`	新授权认证
`tool.php`	工具函数
`action.php`	动作钩子
`update.php`	更新相关
`code.php`	其他代码
`file.php`	文件操作

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

这是子比主题的核心商业功能，包括付费阅读、付费下载、VIP、积分、余额等。

表格

目录 / 文件	功能说明
`functions.php`	支付系统入口，加载所有模块
`class/order-class.php`	订单核心类
`class/ajax-class.php`	AJAX 处理类
`class/card-pass.php`	卡密 / 卡券类
`class/alipay-check.php`	支付宝验证
`functions/zibpay-func.php`	支付基础函数
`functions/zibpay-post.php`	文章付费功能
`functions/zibpay-order.php`	订单功能
`functions/zibpay-download.php`	付费下载功能
`functions/zibpay-user.php`	用户支付功能
`functions/zibpay-vip.php`	VIP 会员系统
`functions/zibpay-points.php`	积分系统
`functions/zibpay-balance.php`	余额系统
`functions/zibpay-coupon.php`	优惠券系统
`functions/zibpay-rebate.php`	返利 / 分销系统
`functions/zibpay-income.php`	收入系统
`functions/zibpay-withdraw.php`	提现系统
`functions/zibpay-msg.php`	支付消息通知
`functions/zibpay-ajax.php`	支付 AJAX
`functions/ajax.php`	其他 AJAX
`functions/income-ajax.php`	收入 AJAX
`functions/rebate-ajax.php`	返利 AJAX
`functions/balance-ajax.php`	余额 AJAX
`functions/widget.php`	支付小工具
`functions/admin/admin.php`	支付后台管理
`functions/admin/admin-options.php`	支付后台设置
`functions/admin/admin-ajax.php`	支付后台 AJAX
`shop/alipay/`	支付宝支付（回调、通知）
`shop/wechat/`	微信支付
`shop/xunhupay/`	虎皮椒支付
`shop/xhpay/`	其他支付通道
`shop/vmq/`	V 免签支付
`shop/payjs/`	PayJS 支付
`shop/epay/`	易支付
`shop/codepay/`	码支付
`shop/paypal/`	PayPal 支付
`sdk/`	各支付平台 SDK
`page/index.php`	支付页首页
`page/shop.php`	商城页
`page/product.php`	商品页
`page/order.php`	订单页
`page/coupon.php`	优惠券页
`page/charge-card.php`	卡密充值页
`page/rebate.php`	返利页
`page/income.php`	收入页
`page/withdraw.php`	提现页
`page/template/*.php`	页面模板（头部、底部、内容等）
`download.php`	下载页面

四、`oauth/` – 第三方登录

表格

目录 / 文件	功能说明
`oauth.php`	OAuth 入口
`wechat/login.php`	微信登录
`wechat/callback.php`	微信回调
`weixingzh/login.php`	微信公众号登录
`weixingzh/callback.php`	微信公众号回调
`weixinagent/login.php`	微信企业号 / 企业微信登录
`weiboagent/login.php`	微博登录
可能还有 qq、github、gitee、baidu 等	其他平台登录支持

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

表格

文件名	功能说明
`user-sign.php`	登录 / 注册 / 找回密码页面
`user-auth.php`	用户认证页面
`newposts.php`	前端发布文章页面
`postsnavs.php`	文章导航页面
`download.php`	下载页面
`documentnav.php`	文档导航页面
`archives.php`	归档页面
`links.php`	友情链接页面
`forums.php`	论坛页面

六、`template/` – 模板部件

表格

文件名	功能说明
`content-404.php`	404 内容模板
`comments.php`	评论模板
`excerpt.php`	摘要模板
`single-dosc.php`	文档单页模板
`category-topics.php`	话题分类模板
`category-dosc.php`	文档分类模板

七、`yiyan/` – 一言功能

表格

文件名	功能说明
`qv-yiyan.php`	一言功能实现

八、`action/` – 动作钩子处理

表格

文件名	功能说明
`action.php`	动作入口
`main.php`	主要动作
`ajax.php`	AJAX 动作
`user.php`	用户动作
`sign_register.php`	注册登录动作
`comment.php`	评论动作
`media.php`	媒体动作
`img.php`	图片动作
`imgcode.php`	图片验证码动作
`captcha.php`	验证码动作
`author.php`	作者动作
`post_navs.php`	文章导航动作
`new_posts.php`	新文章动作
`documentnav.php`	文档导航动作
`function.php`	动作相关函数

九、资源文件目录

9.1 `css/` – 样式文件

表格

文件名	功能说明
`main.css`	主题主样式
`bootstrap.css`	Bootstrap 框架样式
`animate.css`	动画效果样式
`font-awesome.min.css`	FontAwesome 图标样式
`admin-main.css`	后台样式
`customize-controls.css`	自定义器样式
`editor-style.css`	编辑器样式
`new-posts.css`	新文章样式
`page-navs.css`	页面导航样式
`swiper.css`	Swiper 轮播样式
`tinymce.css`	TinyMCE 编辑器样式
`widget-set.css`	小工具样式
`*.min.css`	对应压缩版

9.2 `js/` – JavaScript 文件

表格

文件名	功能说明
`main.js`	主题主脚本
可能还有	其他 JS 文件（轮播、AJAX 等）

9.3 `fonts/` – 字体文件

表格

文件名	功能说明
`fontawesome-webfont.`	FontAwesome 字体文件
`img-code.ttf`	图片验证码字体
`lg.svg`	其他字体

9.4 `img/` – 图片资源

表格

目录 / 文件	功能说明
`captcha/`	验证码图片
`medal/`	勋章 SVG 图标
`smilies/`	表情包
`favicon.png`	网站图标
`logo.png`	网站 Logo
`logo_dark.png`	暗色 Logo
`icon.png`	其他图标
`avatar-default.png`	默认头像
`share_img.jpg`	分享图片
`slide.jpg`	幻灯片图片
`slider-bg.jpg`	幻灯片背景
`topic.jpg`	话题图片
`mail-bg.png`	邮件背景
`trash-badge.svg`	垃圾桶标记
`draft-badge.svg`	草稿标记
`pending-badge.svg`	待审标记
`hot-comment.svg`	热门评论标记
`msg-*.svg`	各类消息图标
`null-*.svg`	空状态图标
`user-*.svg`	用户相关图标
`vip-*.svg`	VIP 图标
`zib-*.svg`	其他主题图标