使用手册

后台 /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 / keywordsSEO 描述与关键词
statuspublish / 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.keywordsSEO 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.disabled1 时关闭博客类路由(分类/标签/归档/搜索等),适合纯官网

密钥一律在后台填写、入库前用 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() 生成,别手写语言前缀。