在当今竞争激烈的网络环境中，让您的网站内容在搜索引擎结果页面（SERP）中脱颖而出，是吸引用户点击的关键。而Json-LD结构化数据正是实现这一目标的重要工具。通过在页面中嵌入Json-LD，您可以向搜索引擎提供关于页面内容的明确信息，从而有机会以更丰富的形式（如星级评分、产品价格、文章缩略图等）展示在搜索结果中，这就是我们常说的“富媒体结果”。

安企CMS（AnQiCMS）在设计之初就充分考虑了搜索引擎优化（SEO）的需求，提供了从内容发布到高级SEO工具的全面解决方案，旨在帮助用户提升网站的可见度和排名。其灵活的模板机制和对自定义标签的支持，使得在页面中集成Json-LD结构化数据变得尤为便捷和高效。

认识安企CMS与Json-LD的融合点

AnQiCMS的模板系统采用了类似Django模板引擎的语法，这意味着您可以通过简洁的标签来输出网站的各种数据。为了便于结构化数据的集成，AnQiCMS内置了一个专门用于Json-LD的标签，这大大简化了操作流程。这个标签允许您在输出默认Json-LD数据的基础上，根据具体需求进行灵活的扩展和覆盖，确保您的结构化数据既符合标准又贴合页面内容。

系统在生成页面时，可能会根据页面类型自动输出一些基础的Json-LD结构化数据。而通过自定义Json-LD标签，您可以检查、完善甚至覆盖这些默认输出，以实现更精准、更丰富的富媒体结果展示。

Json-LD基础：核心元素与常见类型

Json-LD是一种轻量级的数据格式，它使用JSON语法来描述数据，并结合Schema.org词汇表来定义数据的类型和属性。了解其核心构成有助于更好地进行集成：

  • @context: 指明了Json-LD使用的词汇表，通常是 http://schema.org。
  • @type: 定义了您正在描述的实体类型，例如 Article（文章）、Product（产品）、Organization（组织）或 WebSite（网站）。

根据不同的页面内容，您可以选择合适的@type来描述您的实体，并填充相应的属性。安企CMS的强大之处在于，它能帮助您将这些所需的动态数据轻松地嵌入到Json-LD代码中。

在安企CMS模板中应用Json-LD

要在安企CMS的页面中嵌入Json-LD，我们主要利用 {% jsonLd %} 这个自定义标签。这个标签通常放置在HTML页面的<head>区域内，因为它能让搜索引擎在抓取和渲染页面时更快地发现并理解结构化数据。

{% jsonLd %}
<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "您要描述的实体类型",
  "name": "实体名称",
  "url": "实体URL",
  // 其他属性...
}
</script>
{% endjsonLd %}

以下将通过几个常见场景，演示如何在安企CMS中动态填充Json-LD数据。

场景一：文章页面的结构化数据 (Article)

对于博客文章或新闻页面，我们可以使用Article类型来描述。这有助于在搜索结果中显示文章标题、发布日期、作者、缩略图等信息。

假设我们希望在文章详情页中嵌入Article类型的Json-LD：

{# 确保在文档详情页中才能正确获取archive数据 #}
{% archiveDetail currentArchive with name="Id" %} {# 确保archiveDetail标签已获取当前文档数据 #}
<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "Article",
  "headline": "{% tdk with name="Title" %}", {# 文章标题，使用TDK标签获取 #}
  "image": [
    "{% archiveDetail with name="Logo" %}" {# 文章封面图 #}
  ],
  "datePublished": "{{ stampToDate(archive.CreatedTime, "2006-01-02T15:04:05-07:00") }}", {# 发布日期，注意时间格式 #}
  "dateModified": "{{ stampToDate(archive.UpdatedTime, "2006-01-02T15:04:05-07:00") }}", {# 修改日期 #}
  "author": {
    "@type": "Person",
    "name": "安企CMS小编" {# 示例作者名，可替换为动态获取 #}
  },
  "publisher": {
    "@type": "Organization",
    "name": "{% system with name="SiteName" %}", {# 网站名称 #}
    "logo": {
      "@type": "ImageObject",
      "url": "{% system with name="SiteLogo" %}" {# 网站Logo #}
    }
  },
  "description": "{% tdk with name="Description" %}", {# 文章描述，使用TDK标签获取 #}
  "mainEntityOfPage": {
    "@type": "WebPage",
    "@id": "{% archiveDetail with name="Link" %}" {# 文章链接 #}
  }
}
</script>
{% endjsonLd %}

请注意，{% archiveDetail with name="Id" %}这一行是一个占位符，用于确保后续的archive变量可用。在实际的模板中，如果页面已经是文档详情页，那么archive对象通常已经可以直接访问。stampToDate过滤器用于将时间戳格式化为Json-LD所需的ISO 8601格式，而|safe过滤器则用于确保输出的HTML或JSON内容不会被转义。

场景二：产品页面的结构化数据 (Product)

对于产品展示页面，Product类型能够提**品名称、图片、价格、评价等信息，这对于电商或产品展示型网站尤其重要。安企CMS的“灵活内容模型”功能在这里发挥了巨大作用，您可以自定义产品的各种属性。

”`twig {# 假设在产品详情页中，archive变量代表当前产品 #} {% archiveDetail currentProduct with name=“Id” %} {# 确保archiveDetail标签已获取当前文档数据 #}