# jixia

**Repository Path**: lifengdi/jixia

## Basic Information

- **Project Name**: jixia
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-10
- **Last Updated**: 2026-08-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 稷下 · Jixia Forum

新一代风格的 WordPress 论坛主题。基于自研 CPT（版块 / 主题 / 回复），
不依赖 bbPress，支持游客发帖、积分等级、审核队列与前端用户中心。

- 主题 slug：`jixia`
- 要求：WordPress ≥ 6.0，PHP ≥ 7.4
- 许可：GPL-3.0

## 安装

1. 从 [Releases](https://gitee.com/lifengdi/jixia/releases) 下载 `jixia-<version>.zip`
2. 「外观 → 主题 → 安装主题 → 上传主题」上传并启用
3. 首次启用会自动创建一套默认分区与版块

## 自动更新

更新源**只有 Gitee**（`inc/update.php`）：

- 定期（WordPress 自身的更新检查周期，缓存 12 小时）读取
  `https://gitee.com/api/v5/repos/lifengdi/jixia/releases/latest`
- 版本号比对 `JIXIA_VERSION`，有新版时在「外观 → 主题」出现更新按钮，直接一键升级
- 「稷下论坛 → 仪表盘」的版本卡片可手动「检查更新」，并展示新版本的 Release Note
- Gitee 会对 `WordPress/x.y` 这种 UA 返回 403，主题已统一改写为浏览器 UA

私有仓库可用过滤器注入令牌：

```php
add_filter('jixia_update_token', fn() => 'your_gitee_private_token');
add_filter('jixia_update_repo',  fn() => 'youraccount/jixia'); // fork 后改仓库
```

## 友情链接

链接数据用 WordPress **内置链接管理器**（`wp_links` 表 + `link_category` 分类），
主题只负责重新打开被隐藏的后台菜单并做前台渲染，见 `inc/links.php`。

1. 后台「友情链接 → 添加友链」录入。主题对内置字段的用法：
   「描述」= 前台简介，「高级 → 图片地址」= 图标（留空则显示站名首字色块），
   「高级 → 评级」= 排序权重（0~10，大的在前），
   「链接关系(XFN)」留空时用设置里的默认 rel，
   「保留此链接为私有」= 前台下架，「备注」仅后台可见。
2. 新建页面并选择「友情链接」页面模板（slug 取 `links` 也会自动套用），
   页面正文可选，会显示在链接列表上方。
3. 「稷下论坛 → 论坛设置 → 友情链接」控制总开关、侧栏/页脚展示、
   侧栏与页脚取哪个分类、默认 rel。

只接受 http/https 链接；新窗口打开的链接一律自动补 `noopener`。

## 发布流程

由 Gitee Go 流水线 `.workflow/release.yml` 在 tag 推送后自动完成，需在仓库
「设置 → 流水线变量」配置 `PUBLISH_TOKEN`（Gitee 私人令牌）。

1. 同步改三处版本号：`style.css` 的 `Version:`、`functions.php` 的 `JIXIA_VERSION`
   （流水线会校验两者与 tag 一致，不一致直接失败）
2. 写更新说明：`release-notes/v<version>.md`
3. 打 tag 并推送：

```bash
git tag v0.2.0 && git push origin v0.2.0
```

流水线会打出 `jixia-<version>.zip`（顶层目录为 `jixia/`，剔除 `.workflow/`、
`release-notes/`、`.gitignore`、`CLAUDE.md` 等开发期文件），创建 Gitee Release
并上传附件。同 tag 重跑会先删除旧 Release。

## 目录结构

```
inc/            功能模块（CPT、REST、反垃圾、用户中心、积分账本、自动更新…）
assets/css      按视图拆分的样式
assets/js       前端交互（发帖、点赞、通知、验证码…）
template-parts  可复用模板片段
release-notes   各版本更新说明（不进主题包）
.workflow       Gitee Go 发布流水线
```