跳至正文
WordPress 与 WooCommerce · Google SEO

WordPress 怎么正确输出文章结构化数据

// / / 光算科技

文章结构化数据这件事,WordPress 站上最常见的误判是"以为主题已经输出好了"。WordPress 核心不会自动输出 Article 标记,官方手册把页面输出描述为模板文件加钩子回调的组合,并没有把结构化数据列成核心或主题的内置项。所以那段 JSON-LD 到底来自哪里、填得对不对,只能打开渲染后的 HTML 自己核对。Google 那一侧的要求比多数人想象的松:它在文章指南里明确写了没有必填属性,列出来的全部是推荐项。同一轮源码检查里,还可以顺带判断面包屑结构化数据是否真的有必要。

先分清标记是谁写进页面的

在WordPress 主题开发手册对经典主题输出方式的说明里,经典主题是"主要使用 PHP、JavaScript 和 CSS",靠 WordPress 的 PHP 函数、钩子和过滤器来输出;区块主题则由区块加一个主题配置文件组成,头部内容在站点编辑器里编辑。两种形态的共同点是:页面上有什么,取决于哪段代码被注册进来。所以同一套内容,换主题或再加一个 SEO 类插件,标记可能凭空多出第二份,也可能悄悄消失。 如果文章以自定义文章类型发布,按WordPress 自定义内容类型的 SEO 检查核公开 URL 与索引设置。

后果很直接:不要靠"我记得装了什么"来判断,要靠看页面源码。先看 <head> 里有几段 application/ld+json,再看每段的 @type。同一页出现两个 Article,或者 Article 与 BlogPosting 同时描述同一篇内容,就是有来源在重复输出。

Google 到底要求写哪些字段

按Google 对文章结构化数据的推荐字段与作者标记规范,推荐项是五个:headline(文章标题,长标题在部分设备上会被截断)、image(与文章相关的图,不是 logo)、datePublished、dateModified,以及 author。两个日期用 ISO 8601 格式,官方建议带上时区;不带时区时,Google 会回落到 Googlebot 使用的时区。

作者这一项规矩最细:页面上呈现为作者的人都要写进标记;多人时每人一个 author 对象,不要合并成一个字符串;author.name 里只写名字,不要塞称谓、职位、发布方名称或"posted by"这类引导词;人用 Person,机构用 Organization。图片还要求 URL 可被抓取、可被索引,并且确实代表被标记的内容。

还有一条总则约束,结构化数据总则里关于可见内容与放置位置的要求写得比字段要求更硬:不要标记页面上读者看不到的内容,标记必须是页面内容的真实反映,要放在它所描述的那一页上;同一内容有多个重复页面时,官方建议每个重复页都放上同样的标记。总则还说明,标记只是启用某个功能的可能,不保证该功能一定出现在结果里。

照着做:一篇文章的核对顺序

  1. 先看页面上真实显示了什么。标题、作者署名、发布日期、修改日期、特色图,这些肉眼能确认的先记住,标记只能复述它们,不能补充页面上没有的信息。
  2. 只写一条文章标记。类型三选一:Article、NewsArticle 或 BlogPosting,按内容性质选,不要三个一起上。
  3. 作者按人拆开写。两个作者就是两个 author 对象,各自带 name 和 url;url 指向能唯一识别这个人的站内简介页或外部主页。
  4. 日期只用两个值。datePublished 用首次发布时间,dateModified 用最后一次实质修改时间。分类、标签调整算不算修改,你自己定标准,但前后要一致。
  5. 系列文章要处理 canonical。官方对多篇系列的技术要求是:rel=canonical 指向每一篇单独页或一个"看完"合集页,不要指向系列的第一页。
示意图分三层:页面可见内容、WordPress 主题或插件输出的 JSON-LD 块、Google 文档的推荐字段清单,箭头只从可见内容指向标记层,标记层再指向字段清单
原创示意:图中为"可见内容 → 谁输出的标记 → 官方字段清单"三层关系与核对方向,不是真实后台截图或数据。

不适用的情况:这三类页面先别加

  • 纯导航型或空壳页面。标签归档、作者归档里没有实质正文的页面,标记无法真实反映页面内容,加了只会制造不一致。
  • 分页页 /page/2/。分页页的标题与描述通常和第一页高度重复,标记也会重复。怎么处理这类重复页,思路与站内那篇 站内搜索页被收录:先查 noindex 有没有真正输出 相同:先看真实输出再决定。
  • 多语言版本页。每种语言的页面各有一套 URL 与内容,标记要按语言分别写,不要把一种语言的字段复制到另一种语言页面上。

还有一个边界要说明白:WordPress 官方文档不承诺任何搜索排名效果,主题或插件的输出行为也会随版本变化。哪些主题会输出哪种标记,官方没有清单,需要你在自己的站点上核对。这和WordPress 为什么便于做 SEO:5 项优势及使用条件里说的优势是同一层性质:可控性,不是结果承诺。

怎么验证它真的生效了

  • 第一步,看工具报什么。用 Google 的富媒体结果测试工具跑一个真实 URL,修掉所有关键错误;非关键提示也值得看,但官方说明它不是获得富媒体结果的必要条件。
  • 第二步,看 Google 眼里的版本。用 URL 检查工具测试同一个线上地址,确认页面可被抓取、没有 noindex、没有登录墙,再请求重新抓取。官方提醒过,发布新页后 Google 发现并抓取可能需要几天。
  • 第三步,看状态报告的趋势。在 Search Console 里对比有效项与无效项:有效项上升、无效项不上升,是正常状态;无效项突然增加,先怀疑刚换的模板或新装的插件。

工具报"通过"只说明语法和必填项过关。总则列出的常见原因包括:标记与页面主要内容不符、标记在某些细节上不准确、内容本身对用户不可见。把这三类排掉,才算完成验证。修改模板后如果无效项减少、又没有对应的有效项增加,多半是某段标记已经不再被输出。