中国 帮助

内容中心(cms)

文章、页面、分类标签与站点导航怎么管,前台 /site/** 那几屏由谁直出,改主题时要守哪几条。

内容中心(cms)
封面

> 本文整理自平台文档 docs/wujies/5.x/plugins/cms.mdx,用于站点内容演示。

(https://console.wujies.cn/remote-apps/cms-assets/doc-c777de4901a7-cover.svg)

应用编码 cms,本页对应应用版本 1.0.1(引擎要求 >=5.6.2 <6.0.0),清单 license 为 UNLICENSED、licenseRequired 为 true,装与加载都要先有一枚覆盖本应用的凭证,档位口径见 [授权档位](/docs/wujies/5.x/license/editions),仓库 [wujies-cms-plugin](https://gitee.com/wujies/wujies-cms-plugin)。

这个应用管两摊,分开看:一份内容台账(文章、页面、分类、标签、前台导航菜单),一套前台整页直出能力(/site/ 的 HTML、主题模板、样式与脚本)。后一摊牵动别的应用:图床、商城、报价自己出 /site/ 那一屏的内容,头尾、导航、SEO 标签、404 版式向这里借,走 SDK 契约 SiteRenderApi,实现方是 CmsSiteRenderService。

因此 app.json 的 dependencies 虽然是空的,别的应用却在前台这一层依赖它。没装 cms 时,[图床管理](/docs/wujies/5.x/plugins/gallery) 与商城的后台页面、/open/、/portal/ 接口照常可用,/site/** 那几屏取不到:GallerySiteRender 反查不到渲染契约时给一个 404 加空响应体,日志留一行「前台页要渲染但没有主题壳」。

装它

先确认许可证覆盖 cms,其余没有前置,任何部署都能直接装。装之前看一眼宿主 application.yml 里两处,这两处不归本应用管:

1. open-api.tenant.path-patterns 要含 /site/。公开页靠这条匿名租户带认出当前租户,少了它前台读到的是空列表(口径见 [部署配置](/docs/wujies/5.x/deploy/configuration))。 2. xss.excludeUrls 要含 /cms/post/、/cms/page/、/portal/cms/post/ 三条。正文的消毒闸门在保存链路里,全局 XssFilter 若还拦这几条 URL,富文本在进插件之前就被清成纯文本。

安装过程与「装完菜单为什么没立刻出现」见 [在部署里使用应用](/docs/wujies/5.x/platform/app-market/using-apps),菜单键的归属规则见 [菜单归属](/docs/wujies/5.x/platform/app-market/menu-ownership)。装成功后侧栏多一个「内容中心」,下面七项:

菜单路由需要的权限码
概览overviewcms:post:list
文章post/listcms:post:list
页面page/listcms:page:list
菜单menucms:menu:list
分类categorycms:category:list
标签tagcms:tag:list
配置settingscms:settings:list

概览没有独立的权限码,它复用 cms:post:list:能看到文章列表就能看到各状态计数、分类与标签总数、最近文章和前台首页地址。

配它

「配置」那一页两个页签(网站配置、业务配置),组件来自宿主共享包(ModuleWebsiteSettings / ModuleBusinessSettings),本应用只把分类 cms 传进去。值都落在 sys_config:config_category = 'cms',键名一律带 cms. 前缀。读是 GET /system/config/list?configCategory=cms,保存按改动过的键逐条 PUT /system/config/updateByKey。C 端读同一批键走宿主的泛化端点 GET /open/{code}/config(OpenWebsiteConfigController),于是 /open/cms/config 不用写一行宿主代码就能用。

每个公开页渲染前现读一次(CmsThemeConfigReader.load()),改完刷新前台页面就是新值。sys_config 是租户表,一个部署服务多个租户时每个租户一份,所以它不能被做成启动期读一次的单例。库里没有 cms.* 那几行时用代码里的默认值,前台照样出得来;值存在但为空串按空串处理,界面上清空就是不显示。

键默认值什么时候要改
cms.name / cms.description站点名 / 一句兜底描述标题、页脚、OG 站点名都取前者;后者是文章既没 SEO 描述又没摘要时 meta description 用的那一句
cms.icp / cms.police空对外服务要填自己主体的备案号。police 填整段展示文本,拼查询链接时只取里面的数字,一个数字都没有就只印文本
cms.themeCodedefault主题目录名,只认 [a-z0-9][a-z0-9-]{0,63},非法值回落 default。换一套新目录要先把 templates/cms/<编码>/ 与 themes/<编码>/ 打进包并热加载一次,理由见下面「改主题前守这几条」
cms.siteUrl空canonical 与 og:url 的域名,留空这两个标签一起不出。给一个错域名的 canonical 会把整站收录送到别的域名上去
cms.consoleUrl空后台 SPA 的绝对地址。公开页由后端直出、后台是另一份 SPA,两边不同 origin,登录/注册/会员中心只能拼绝对地址;留空整块入口不渲染。回环别名(localhost / 127.0.0.1 / ::1)会被归一成访客正在用的那一个,真域名之间故意不猜
cms.heroTitle / cms.heroSubtitle「没有边界」加一句副标首页 Hero 两行大字,副标清空这一行就不出
cms.regionName / cms.regionUrl「中国」/ 空通知条最左那一格。regionUrl 留空印纯文本:地球图标是「可点」的暗示,没链接就不该摆出来
cms.noticeOne / noticeOneUrl / cms.noticeTwo / noticeTwoUrl两条本站文案公告会过期,活动上线后要回来改。文字留空的那条不进轮播(留着会让轮播翻到一张空白页停两秒),链接留空只印文本
cms.helpName / cms.helpUrl「帮助」/ https://docs.wujies.cn通知条最右那一格,给没登录的访客看。留空印纯文本,故意不回落到后台地址
cms.contactEmail / contactQq / contactWechat / contactPhone空页脚「联系我们」四行,代码里不给示例值(种一个编出来的号码等于把访客送到别人那里)。四项全空整列不渲染;手机号可以写成带分隔符的样子,tel: 里只留数字与开头的 +

⚠️ updateByKey 只改已经存在的行:SysConfigServiceImpl#updateConfig 走 update ... where config_key = ?,影响 0 行时直接抛「操作失败」。这台部署缺哪个键的行(老环境常见于通知条那 8 个、cms.police 和 cms.contact*),界面上保存就会失败,先在「系统管理 → 参数设置」补一行,或等一次升级让迁移脚本补跑。

用它

管理员在「文章」里写正文、批量改状态,在「页面」里管关于、联系、落地页那类不进列表的独立页面,「分类」「标签」是两本词表,「菜单」拼前台导航。

内容生命周期四个值,公开页那几条 SQL 只认 status = 'published' 加 visibility = 'public' 加未删除:

状态怎么进前台
draft新建的初始值;从任何状态转回草稿都会清掉 published_at不可见
published点「发布」,或批量改状态可见
scheduled点「定时发布」并给一个晚于当前时刻的时点,时点为空或早于现在保存就报错到点前不可见
archived点「归档」不可见

定时发布没有自己的列:目标时点就存在 published_at 里,状态是 scheduled。首次发布时 published_at 只在为空处回填(一条单独的 UPDATE),为的是不覆盖已经排定的时点。到点由 CmsPublishTask 翻牌,cron 0 */1 * * * ? 每分钟一轮,整段套 TenantHelper.ignore:调度线程没有租户上下文,而每个站点排定的文章都得各自到点发出去。把

本文导览

(https://console.wujies.cn/remote-apps/cms-assets/doc-c777de4901a7-guide.svg)

章节导览
THE END

喜欢就支持以下吧

评论区需要浏览器启用 JavaScript 才能加载。

回到内容