功能预览
自定义字段适合承载可结构化、可比较、可筛选的信息,例如参数、适用范围、时间与联系方式类别;大段正文、频繁改动的营销文案和任何凭据类内容不适合放进字段。列表页取用字段通常有两种做法:在模板里按字段名直接输出,或作为筛选与排序条件参与列表生成,两者对字段类型的要求不同。
内容模型里的自定义字段能放哪些信息,列表页要怎么取用?判断标准是这条内容是否会被用于比较、筛选或批量输出:会,就做成字段;不会,就留在正文里。字段的价值在于让列表页与详情页共用同一份带类型的字段值,代价是改动会影响所有引用它的模板,所以不能把所有额外信息都塞进字段。
| 信息类型 | 是否适合做字段 | 原因 |
|---|---|---|
| 规格参数、适用范围 | 适合 | 需要跨文章比较与筛选 |
| 价格档位、版本号 | 适合 | 列表页要排序与过滤 |
| 时间类信息(发布、有效期) | 适合 | 参与条件判断与展示格式 |
| 大段说明正文 | 不适合 | 属于正文,字段里难维护格式 |
| 经常改动的营销话术 | 不适合 | 一改就要动所有引用它的模板 |
| 密钥、凭据类内容 | 禁止 | 字段会随详情接口输出 |
一句话概括:字段是给机器读的,正文是给人读的。需要被列举、被比较、被筛出来的内容做成字段;只需要在一篇文章里说清楚的内容留在正文。
三类内容最容易被误放。其一是一整段说明文字,字段里存长文本会让列表页输出难以截断,也绕过了正文侧的排版与过滤规则。其二是全站在用的口号或提示语,这类文字改动频繁,放进字段后每次调整都要逐条改数据,正确做法是用全站替换或模板层统一控制。其三是任何凭据类信息,包括接口令牌与服务账号内容,字段会随着文档详情一起被接口取走,写在字段里等于写在公开输出中。
另外要留意字段数量的膨胀。同一套内容模型里几十个字段时,模板可读性与维护成本都会下降,重复含义的字段应当合并。
一种是直接输出:在模板里按字段名取值,渲染到列表卡片上,常用于展示参数摘要或适用范围标签。这种方式要求字段有稳定的默认值,缺失时列表会出现空白项。
另一种是参与条件:把字段作为筛选或排序依据,例如按版本、按适用场景生成列表。此时字段类型要选可比较的类型,文本型字段做排序通常得不到预期结果。
在 AnQiCMS 中,内容模型定义了每类文档可用的字段集合,自定义字段在文章编辑页与列表条件里同时可见;伪静态规则则决定列表页的筛选参数怎么写进地址,自定义伪静态可以约定参数的呈现形态,而不必固定用默认的查询串写法。两者要一起设计,字段名定了再改地址形态成本更低。
要看改的是名称还是取值。改名称会让所有引用该字段的模板取不到值,属于破坏性变更;只改取值不影响模板结构。建议在改动前用备份保留一份可回退的状态,改完后逐页检查列表页与详情页的输出是否一致。
删除字段的顺序也重要:先从模板里去掉引用,再确认没有筛选条件仍在使用该字段,最后删除字段本身。已经删除的内容可以在回收站里找回,字段结构与已填数据是否一并可恢复,要以当前版本的备份为准,不要把回收站当成长期归档。
发布前的抽样核对可以借助创建文章时生成的 AI 自动标签快速筛出批量内容,但标签不能替代字段本身的结构约束。
问:字段和分类标签有什么区别? 答:标签用于跨模型归类,字段用于描述这一类文档自身的属性;需要参与排序或成组展示的取值,更适合字段。
问:一个内容模型最多该放多少个字段? 答:没有硬性上限,但实践上控制在十几个以内更好,超出时优先考虑拆成新的内容模型或归类到标签。
问:字段值能在列表页截断显示吗? 答:可以,但截断规则要写在模板层统一处理;在数据里预先截短会破坏详情页与接口输出的完整性。
预览
用后台全站替换改掉链接之后,已经生成的静态页面要不要重建,取决于站点是否开启了静态化。替换动作落在数据层,前台地址由伪静态规则和缓存共同决定,纯动态渲染无需重建,静态化开启后要挑低峰重建并抽样验证,改地址还要配一条 301 跳转兜底。
预览
文档删掉之后还能恢复,是因为删除正式文档执行的是移入回收站而不是物理删除。AnQiCMS 的文档状态分为正式文档、草稿、待发布与回收站四种,各自对应不同的对外可见性与流转路径。本文梳理四种状态之间的转换、草稿预览与对外发布的差别,以及定时发布到点自动放开的用法。
预览
小范围的标题样式、段落排版与模块顺序调整,可以用 AI 可视化模板编辑在预览里直接说改动意图完成,改完再回落到代码确认;涉及内容模型字段与页面结构的改动仍需回到字段定义。本文说明两种改法的分界与回退做法。