后台 /admin/ 的完整用法。所有内容都是服务端渲染的普通页面,主体不依赖 JS;表单提交、局部增强才用脚本。
本页导航
后台模块全表
模块(URL ?s=) | 作用 |
|---|---|
dashboard | 统计、最近文章/页面/用户 |
posts | 文章列表、新建/编辑、删除、AI 翻译入口 |
pages | 独立页面管理(关于、联系、文档等) |
metas | 分类与标签,含多语别名、计数 |
poly | 多语译文组与 AI 翻译(插件启用时出现) |
notes | 私人记事本 |
comments | 评论与段评审核 |
users | 注册用户与角色(admin / subscriber) |
attachments | 附件与图片 |
themes | 主题切换与主题设置 |
layouts | 首页/文章/搜索等页面的右栏与功能块顺序、启停 |
upgrade | 版本查看与一键升级(自动备份) |
plugins | 插件启用 / 停用 / 卸载 |
market | 云市场在线安装主题与插件 |
settings | 站点、SEO、统计、多语等全局设置 |
tools | 备份、修复、清缓存 |
停用的内置插件(notes、poly)会从导航隐藏;第三方插件带后台菜单时自动追加 plug_<id>。
文章与页面
ye_contents 统一存 post / page 两类内容,核心字段:
| 字段 | 说明 |
|---|---|
title / slug | 标题、URL 段;slug 全站唯一,不能占 Router::RESERVED 里的保留词 |
excerpt / content | 摘要、正文(content_format=markdown) |
description / keywords | SEO 描述与关键词 |
status | publish / draft;另有 deleted_at 软删除,前台所有列表均过滤 |
published_at / created_at / updated_at | 发布时间(可定时)、创建/更新时间 |
template / order | 自定义模板、页面排序 |
featured / allow_comment / password | 置顶、允许评论、访问口令 |
words / views | 字数、阅读量(由 tools/sync-views.php 回写) |
URL 规则:/<slug>.html;/docs 与 /changelog 另有干净 URL 特例。删除内容优先用后台删除(软删),需要彻底移除时再清库并同步清理 ye_relationships、ye_metas.count。
分类与标签
- 术语存
ye_metas,type=category|tag;文章归属存ye_relationships(content_id, meta_id)。 count是预计算列:列表页直接读它,不要写 SQL 子查询实时COUNT(大表下会拖垮首页,见运维:性能)。- 多语名称走
names_i18n(JSON)或name_en,别名走slug_i18n;后台「分类标签」与「多语」共同维护。 - 删除术语前先确认没有内容引用,否则会出现空分类页;删除文章后应重算术语计数。
导航
导航单一数据源是 core/Nav.php 的 Nav::defs():顶部/页脚共用,children 支持平铺或分组下拉;label 是语言包键(如 nav.docs),链接自动带语言前缀。
| 选项 | 作用 |
|---|---|
nav.hide_top / nav.hide_foot | 隐藏指定导航项(JSON 数组) |
nav.custom | 追加自定义项(label / uri / zone / zh_only) |
新增固定栏目改 Nav::defs() 并同步 lang/zh_CN.php、lang/en_US.php 的语言键;纯内容页用后台「页面」建好,再用自定义导航挂上去。
主题与布局
- 「主题」按
themes/<id>/theme.json读取名称、版本、描述与settings;切换写入theme.default。 - 主题设置只收集该主题声明过的字段,存
theme.options(JSON),避免脏键。 - 「页面布局」控制首页/文章/搜索等页面的右栏功能块及顺序(
theme.sidebar_mode控制flow/sticky)。 - 改主题或布局后清页缓存与区块缓存,并重建首页静态件;详见运维:缓存。
插件
- 目录即清单:
plugins/<id>/plugin.php。启用时先跑migrations/幂等迁移,再置plugin.<id>.enabled=1。 - 停用只停止注册,数据保留;卸载分两种:
purge=1连同自有表与配置一起删(会先自动备份),purge=0只卸载、数据保留。 - 「云市场」在线安装只接受 https 包并强制 SHA-256 校验;包内须有合法
plugin.php/theme.json,安装后逐文件php -l。 - 内置插件清单与用途见快速开始。
多语与 AI 翻译
- 后台「多语」按内容组维护
ye_poly_contents(group_id+lang),译文状态publish才在前台生效。 - 文章/页面列表的「AI 翻译」按钮按单请求单语言 + 并发锁 + 会话队列自动续链执行,避免一个请求翻全部语言把 PHP-FPM 打满(1.2.2)。
- 「覆盖翻译」会重译已有语言,但保护人工修正(
manual_override);目标语种校验不通过会重试,仍失败如实报错、绝不入库(1.2.3)。 - 完整机制见多语言与 AI 翻译。
设置与配置项
config.inc.php(文件,不进版本库):
| 常量 | 说明 |
|---|---|
DB_HOST / DB_PORT / DB_NAME / DB_USER / DB_PASS | 数据库连接 |
DB_PREFIX | 表前缀,默认 ye_ |
SECRET | 会话与密钥加密;轮换会让已加密密钥失效 |
TZ / SITE_LANG / DEBUG | 时区、默认界面语言、调试开关(生产必须 false) |
站点选项(ye_options,后台可改):
| 选项 | 说明 |
|---|---|
site.name / site.name_en / site.subtitle* | 名称与副标题 |
site.description / site.keywords | SEO meta |
site.languages / site.default_lang | 启用语言与基准语言 |
theme.default / theme.options / theme.sidebar_mode | 主题与布局 |
home.landing / home.style / home.show_circle | 首页版式 |
nav.hide_top / nav.hide_foot / nav.custom | 导航 |
stats.head / stats.foot / stats.posts_total | 统计代码位与去规范化文章总数 |
market.source | 云市场清单地址,留空用 var/market/manifest.json |
blog.disabled | 1 时关闭博客类路由(分类/标签/归档/搜索等),适合纯官网 |
密钥一律在后台填写、入库前用 SECRET 加密、界面不回显明文;日志、报错页、导出文件都不得带密钥。
工具与常用运维
# 清缓存(后台「工具 → 清缓存」同效)
php -r 'chdir("/www/wwwroot/yecha.org"); require "config.inc.php"; require "core/bootstrap.php"; Cache::flush("pages"); Cache::flush("blocks");'
# 应用待执行内核迁移(先看 --dry-run)
php tools/upgrade.php --component core --dry-run
php tools/upgrade.php --component core
# 回写阅读量、重建首页静态件
php tools/sync-views.php
curl -s -H 'Host: example.com' https://127.0.0.1/ > /dev/null完整备份/升级/回滚见运维、升级与性能。
内容编写规范
- 正文用 Markdown:标题
##/###、表格、列表、引用、`lang围栏代码块、{#anchor}显式锚点。 - 正文会先做 HTML 转义,不要往正文里塞 HTML 标签;需要特殊版式请做主题视图或内核渲染器(如
/changelog的结构化时间线)。 - 文件名、函数名用行内
code,命令与配置放代码块;代码块语言标记会渲染成右上角角标。 - 站内链接用
/<slug>.html,英文界面用/en/<slug>.html;分类/标签链接由Poly::termUrl()生成,别手写语言前缀。