点号标签系列共有四套：内容、栏目、单页与标签，分别对应四类页面实体。四套写法统一为点号加字段名，主要差异在字段白名单与空值边界上。栏目页、单页与标签页的模板因此可以共享同一套取值风格，降低模板作者的记忆成本。
栏目页可直接输出当前栏目的基础字段、SEO 字段、模板字段、状态字段与扩展字段。名称、别名、描述、图标、封面图等基础信息，SEO 标题、关键词、描述三件套，主页模板、列表模板、详情模板三个模板字段，以及栏目简介、栏目目录、每页条数、内容数量等扩展信息都在白名单内。
栏目点号标签采用严格白名单模式，不支持动态字段回退，映射表未命中的字段名直接返回空字符串。英文字段名大小写敏感，中文标签无大小写问题，前缀本身大小写不敏感。页面未注入栏目上下文时，所有栏目点号标签输出为空。
单页用于关于我们、联系方式、使用文档等独立页面，单页点号标签输出该单页的任意字段：名称、标题、副标题、正文内容、SEO 三件套、封面图与缩略图、链接与打开方式、重定向地址与状态码、导航显示与静态化开关。
单页模板按固定优先级匹配：页面模板字段优先，其次按单页代码匹配同名模板文件，再回退到通用页面模板与关于模板。把模板文件命名为单页代码即可自动匹配，单页上线因此不需要在后台额外配置模板路径。
标签详情页输出当前标签的字段：名称、别名、描述、使用次数、链接与智能链接、状态。标签页的筛选列表复用内容列表标签，配合标签点号标签输出头部信息，即可构成完整的标签聚合页。
标签的使用次数是存储值，由业务代码在内容状态变化时同步维护；直接改数据库改内容状态不会同步该字段。需要纠偏时可在后台标签管理页执行重建标签使用次数操作，按正确口径全量重算，该操作幂等，可以重复执行。
| 系列 | 适用页面 | 回退策略 | 空值表现 |
|---|---|---|---|
| 内容 | 内容详情页 | 白名单加 meta 动态回退 | 输出空字符串 |
| 栏目 | 栏目列表页与详情页 | 严格白名单，无回退 | 输出空字符串 |
| 单页 | 单页详情页 | 严格白名单 | 输出空字符串 |
| 标签 | 标签详情页 | 严格白名单 | 输出空字符串 |
四套点号标签的查询全部强制携带站点条件，不会跨站点读取数据；同时只查询启用且未删除的记录。栏目点号标签只查启用栏目，单页与标签同样按状态过滤。这意味着后台把某栏目禁用后，前台不会输出其字段，禁用即下线，无需再改模板。
{xiis:实体.字段名}，英文别名对应 content、category、page、tag 前缀点号标签系列把四类实体的字段访问统一成同一种语法，模板作者只需要记住字段清单，不需要为每类页面学习不同的取值结构。这种一致性正是使用手册建议优先掌握点号标签的原因。
评论
加载中...