Bootstrap博客主题开发指南
本文档将指导您如何为博客系统开发自定义主题。
1. 主题结构
每个主题是一个独立的文件夹，放置在 /themes/ 目录下。
mytheme/
├── theme.json # 主题配置文件 (必需)
├── preview.png # 主题预览图 (推荐 800x600)
├── header.php # 头部模板 (必需)
├── footer.php # 底部模板 (必需)
├── sidebar.php # 侧边栏模板 (必需)
├── index.php # 首页模板 (必需)
├── article.php # 文章详情模板 (必需)
├── category.php # 分类页模板 (可选)
├── search.php # 搜索页模板 (可选)
├── css/ # 样式文件目录
│ └── style.css
├── js/ # 脚本文件目录
│ └── main.js
└── images/ # 图片资源目录
├── theme.json # 主题配置文件 (必需)
├── preview.png # 主题预览图 (推荐 800x600)
├── header.php # 头部模板 (必需)
├── footer.php # 底部模板 (必需)
├── sidebar.php # 侧边栏模板 (必需)
├── index.php # 首页模板 (必需)
├── article.php # 文章详情模板 (必需)
├── category.php # 分类页模板 (可选)
├── search.php # 搜索页模板 (可选)
├── css/ # 样式文件目录
│ └── style.css
├── js/ # 脚本文件目录
│ └── main.js
└── images/ # 图片资源目录
2. theme.json 配置文件
{
"name": "我的主题",
"version": "1.0.0",
"author": "您的名字",
"description": "一个简洁优雅的博客主题",
"tags": ["简洁", "响应式"]
}3. 可用的系统函数
| 函数 | 说明 | 示例 |
|---|---|---|
getSetting($key, $default) | 获取系统设置 | getSetting('site_title', '博客') |
getCategories() | 获取所有分类 | 返回分类数组 |
getArticles($page, $limit, $categoryId) | 获取文章列表 | getArticles(1, 10) |
getArticle($id) | 获取单篇文章 | getArticle(1) |
getHotArticles($limit) | 获取热门文章 | getHotArticles(5) |
isLoggedIn() | 检查用户是否登录 | 返回 true/false |
escape($str) | HTML转义（防XSS） | escape($title) |
4. 可用的系统变量
| 变量 | 说明 | 可用模板 |
|---|---|---|
$pageTitle | 页面标题 | 所有模板 |
$articles | 文章列表 | index.php, category.php, search.php |
$article | 当前文章 | article.php |
$page | 当前页码 | index.php, category.php |
$totalPages | 总页数 | index.php, category.php |
5. 打包发布
- 确保所有必需文件齐全
- 添加
theme.json配置文件 - 添加预览图
preview.png(推荐 800x600) - 将主题文件夹压缩为 ZIP 格式
- 在后台"主题管理"页面上传即可