结构化数据标记

📅 2026-11-21 👁️ 0

结构化数据标记

结构化数据标记用于自动向页面插入 JSON-LD 格式的结构化数据,帮助搜索引擎理解网站内容。

入口路径

后台顶部菜单 →「功能」→「SEO/GEO」→「结构化数据标记」。实际地址:/system/plugin/seo/jsonld,需要管理员权限(canAdmin)。

功能说明

页面只有一个开关。开启后,系统会自动把网站的结构化数据以 JSON-LD 格式插入页面底部,无需手动修改模板。

界面截图

结构化数据标记

设置项说明

设置项 作用 取值 / 默认 怎么选 / 填写建议 影响 / 注意
开启结构化数据标记 是否自动插入 JSON-LD radio:否 / 是;源码未注明默认值 [源码] 希望搜索引擎更好理解内容时开启 开启后页面底部自动插入,模板中不要重复写

配置项详解

结构化数据类型的选择

出现条件:开启结构化数据标记后,模型数据结构与各分类数据结构可配置 list_type 与 schema_type [源码]。

list_type 3 项:CollectionPage(分类/集合页)、ItemList(简单条目列表)、DetailedItemList(详细内容卡片列表)[源码]。

schema_type 20 项:Article、Product、ScholarlyArticle、BlogPosting、NewsArticle、WebPage、ItemPage、Recipe、Course、FAQPage、HowTo、Event、Person、Place 等 [源码]。

推荐值:文章用 Article、产品用 Product、常见问题用 FAQPage;非 VIP 部分类型不可选。

填错后果:类型与内容不符会影响搜索引擎富摘要展示,不会导致功能故障。

数据类型与联系方式

出现条件:data_type 选择组织机构或个人时显示对应字段 [源码]。

  • data_type=1 组织机构:组织类型 15 项(含 LocalBusiness 本地商家等)、名称、法定名称、URL。
  • data_type=2 个人:姓名、职位、图片。
  • 两者共用:联系类型 12 项、联系号码(disabled,需到联系方式设置修改)、联系 URL、Logo 图片(尺寸须 160×50 或 600×60)[源码]。
  • 本地商家(LocalBusiness)另需营业时间、价格区间、经纬度、地址等 [源码,VIP]。

填错后果:Logo 尺寸不符或联系方式缺失会导致结构化数据校验不通过。

操作步骤

  1. 进入「功能 → SEO/GEO → 结构化数据标记」。
  2. 将开关设为「是」。
  3. 点击「提交」保存。
  4. 查看前台页面源代码,确认已输出 JSON-LD 脚本。

适用场景与建议

  • 希望通过富摘要(Rich Results)提升搜索展示效果的站点建议开启。
  • 具体支持的标记类型可参考 Google 结构化数据文档。

注意事项

  • 自动插入的标记由系统生成;如需自定义字段,使用 jsonLd 标签覆盖同名字段,不要在模板里另起一套重复的结构化数据。
  • 开启后如果前台源代码看不到 JSON-LD,先清理缓存再检查。

前台调用示例

开启后台功能后,页面默认插入名为 json-ld 的结构化数据标签。需要更自由地控制内容时,可以用 jsonLd 标签包裹自定义字段;自定义字段与默认字段同名时会覆盖默认值:

{% jsonLd %}
{
  "author": { "@type": "Person", "name": "示例作者" },
  "images": ["{{ siteLogo }}"]
}
{% endjsonLd %}

自定义内容必须符合 JSON-LD 语法,字段说明见模板标签手册的 jsonLd 标签。

相关文档