当你需要自定义你的默认的 Yoast SEO 标题与描述的变量外观时，你可以用到各种各样的官方预设变量，下方喵容已经为你完整列出，有需要请自取。
Yoast SEO 最重要的功能之一是能够自动将 SEO 标题和元描述模板添加到主页、所有（自定义）文章类型、所有（自定义）分类法、产品、集合和其他页面。我们包括对 SEO 友好的默认模板，但您也可以修改默认模板。在本文中，我们将为您提供 Yoast SEO 中所有可用片段变量的列表。
WordPress 中可用的变量类型
- 基本变量
- 高级变量
- 自定义变量
- WooCommerce 变量
基本变量
|
标签 |
变量 |
描述 |
|
日期 |
%%date%% |
替换为文章/页面的日期 |
|
标题 |
%%title%% |
替换为文章/页面的标题 |
|
父标题 |
%%parent_title%% |
替换为当前页面的父页面的标题 |
|
档案标题 |
%%archive_title%% |
替换为 WordPress 生成的档案的正常标题 |
|
网站标题 |
%%sitename%% |
网站名称 |
|
标语 |
%%sitedesc%% |
该网站的标语 |
|
摘抄 |
%%excerpt%% |
替换为文章/页面摘录（如果不存在则自动生成） |
|
仅摘录 |
%%excerpt_only%% |
替换为文章/页面摘录（不自动生成） |
|
标签 |
%%tag%% |
替换为当前标签/标签 |
|
类别 |
%%category%% |
替换为文章类别（逗号分隔） |
|
主要类别 |
%%primary_category%% |
替换为文章/页面的主要类别 |
|
类别说明 |
%%category_description%% |
替换为类别描述 |
|
标签描述 |
%%tag_description%% |
替换为标签描述 |
|
术语说明 |
%%term_description%% |
替换为术语描述 |
|
术语名称 |
%%term_title%% |
替换为术语名称 |
|
搜索词组 |
%%searchphrase%% |
替换为当前搜索词组 |
|
分隔器 |
%%sep%% |
在主题的 wp_title() 标记中定义的分隔符。 |
高级变量
以下变量示例需要更好地理解 SEO。如果您不确定如何使用这些高级变量，那么我们建议您不要使用它们。您可以通过我们的在线Yoast SEO 学院课程了解更多关于 SEO 的信息。
|
标签 |
变量 |
描述 |
|
文章类型（单数） |
%%pt_single%% |
替换为内容类型单标签 |
|
文章类型（复数） |
%%pt_plural%% |
替换为内容类型复数标签 |
|
修改的 |
%%modified%% |
替换为文章/页面修改时间 |
|
ID |
%%id%% |
替换为文章/页面 ID |
|
名称 |
%%name%% |
替换为文章/页面作者的“好名字” |
|
用户描述 |
%%user_description%% |
替换为文章/页面作者的“传记信息” |
|
页码 |
%%page%% |
替换为带有上下文的当前页码（即第 2 页，共 4 页） |
|
总页数 |
%%pagetotal%% |
替换为当前页面总数 |
|
页码 |
%%pagenumber%% |
替换为当前页码 |
|
标题 |
%%caption%% |
附件标题 |
|
重点关键词 |
%%focuskw%% |
替换为文章焦点关键词 |
|
Term404 |
%%term404%% |
替换为导致 404 的蛞蝓 |
|
<自定义字段名称>（自定义字段） |
%%cf_<custom-field-name>%% |
替换为文章自定义字段值。 |
|
<custom-tax-name>（自定义分类法） |
%%ct_<custom-tax-name>%% |
替换为文章自定义分类法，逗号分隔。 |
|
<custom-tax-name> 描述（自定义分类） |
%%ct_desc_<custom-tax-name>%% |
替换为自定义分类描述。 |
自定义变量
最后三个高级变量可用于从非标准 WordPress 元素输出数据，例如WooCommerce 产品。但是，您如何找到正确字段或分类的名称以使用这些变量？
自定义字段
可以使用此处的步骤找到自定义字段名称。获得自定义字段名称后，您将替换 <custom-field-name>. 如果我的自定义字段被调用myfield，那么自定义变量将是 %%cf_myfield%%. 或者，如果自定义字段以下划线开头，例如_anotherfield，自定义变量应包含下划线，如下所示%%cf__anotherfield%%：
注意：包含数组（相关信息列表）的自定义字段将不适用于自定义字段变量。相反，您或您的开发人员应该创建自己的自定义模板变量。
自定义分类法
查看或编辑项目时，可以在后端的浏览器栏中找到自定义分类名称。
示例：edit-tags.php?taxonomy= mycategory &post_type= myposttype
在上面的示例中，我们在名为 myposttype 的自定义文章类型下编辑名为mycategory 的自定义分类。如果我想输出分配给myposttype页面的类别列表，我会使用 . 或者，如果我想在类别存档页面上 输出单个mycategory的描述，我会使用 .%%ct_mycategory%%%%ct_desc_mycategory%%
WooCommerce 变量
以下变量是您可以与 WooCommerce 一起使用的一些变量。如果您要查找的特定变量未在下面列出，请使用上面的自定义变量信息查找您需要的变量。
|
%%ct_product_cat%% |
产品类别（逗号分隔） |
|
%%ct_product_tag%% |
产品标签（逗号分隔） |
|
%%ct_pa_<product-attribute-slug>%% |
产品属性（逗号分隔）。请务必删除 <>，因为它们不是必需的。 |
Yoast WooCommerce SEO 变量
当您使用我们的Yoast WooCommerce SEO插件时，这些附加变量可用：
|
%%wc_shortdesc%% |
替换为产品的简短描述。（从Yoast WooCommerce SEO 6.2 开始可用） |
|
%%wc_sku%% |
替换为产品的库存库存单位 (sku)。（从Yoast WooCommerce SEO 6.2 开始可用） |
|
%%wc_brand%% |
替换为品牌名称。此变量仅适用于“ WooCommerce Brands ”和“ Perfect WooCommerce Brands ”插件。（从Yoast WooCommerce SEO 6.2 开始可用） |
|
%%wc_price%% |
替换为产品的价格。（从Yoast WooCommerce SEO 6.2 开始可用） |
WordPress中不推荐使用的变量
从 Yoast 的 v7.7 开始，我们已弃用这些变量，因为我们看不到它们的有效用例。如果在片段编辑器中使用它们，它们将不会出现在片段预览中。但是，它们会出现在您的源代码中以保持向后兼容性，但我们建议不要使用它们。
|
%%userid%% |
替换为文章/页面作者的用户 ID |
|
%%currenttime%% |
替换为当前时间 |
|
%%currentdate%% |
替换为当前日期 |
|
%%currentday%% |
替换为当天 |
|
%%currentmonth%% |
替换为当前月份 |
|
%%currentyear%% |
替换为当年 |
WordPress 中的默认变量
如果要将 SEO 标题模板变量重置为默认值，请使用以下内容。对于元描述，默认为空白。您可以在 SEO 搜索外观部分输入这些默认标题。然后，这会将默认值分配为该部分的全局模板变量。
|
%%title%% %%page%% %%sep%% %%sitename%%% |
文章、页面、产品、媒体和自定义文章类型 |
|
%%pt_plural%% Archive %%page%% %%sep%% %%sitename%% |
文章、产品和其他自定义文章类型存档页面 |
|
%%term_title%% Archives %%page%% %%sep%% %%sitename%% |
分类法 |
|
You searched for %%searchphrase%% %%page%% %%sep%% %%sitename%% |
特殊页面：搜索页面 |
|
Page Not Found %%sep%% %%sitename%% |
特殊页面：404 页 |
|
%%name%%, Author at %%sitename%% %%page%% |
作者存档页面 |
|
%%date%% %%page%% %%sep%% %%sitename%% |
日期存档页面 |
|
The post %%POSTLINK%% appeared first on %%BLOGLINK%%. |
RSS订阅 |
|
%%sitename%% %%page%% %%sep%% %%sitedesc%% |
主页模板 |
插件代码中记录了许多过滤器，供开发人员以编程方式更改模板变量。这里有一些例子。
在 WordPress 中创建自定义模板变量
添加您自己的模板变量可以使用wpseo_register_extra_replacements您的 functions.php 文件中的过滤器来完成。可以在 此处查看如何使用过滤器的示例。
您可能不希望 Yoast 显示这些 Yoast 创建的标题。在这种情况下，您可以在此处使用这些过滤器。如果您不确定如何添加或使用过滤器，请考虑与Yoast 合作伙伴合作。
Shopify 中可用的代码段变量
Yoast SEO for Shopify 应用程序中提供了以下代码段变量：
|
标签 |
多变的 |
描述 |
|
标题 |
%%title%% |
替换为博客文章或（产品/收藏）页面的标题 |
|
重点关键词 |
%%focus_keyphrase%% |
替换为文章/页面的焦点关键词 |
|
页码 |
%%page_number%% |
替换为当前页的页码 |
|
分隔器 |
%%sep%% |
您的站点默认值中定义的分隔符 |
|
网站标题 |
%%sitename%% |
网站名称 |
|
博客标题 |
%%blog_title%% |
替换为文章所属博客的标题 |
|
集合标题 |
%%collection_title%% |
替换为（产品）页面所属的集合的标题 |
|
产品/文章标签 |
%%tag%% |
替换为当前标签/标签 |
