Обзор
Автоматически выводите структурированные данные Schema.org для полей ACF в виде JSON-LD в секции head страницы.
Описание
В ACF 6.8 появился вывод структурированных данных JSON-LD для полей ACF. Эта функция сопоставляет значения полей ACF со свойствами Schema.org, помогая поисковым системам и системам ИИ лучше понимать структуру вашего контента.
JSON-LD (JavaScript Object Notation for Linked Data) — рекомендуемый Google формат структурированных данных. Сопоставляя поля ACF со свойствами Schema.org, вы можете:
- Улучшить SEO с помощью расширенных сниппетов в результатах поиска
- Помочь системам ИИ и LLM понимать ваш контент (ChatGPT, Claude, Google AI Overviews)
- Поддержать Generative Engine Optimization (GEO) и Answer Engine Optimization (AEO)
- Предоставлять машинно-читаемые данные агрегаторам контента
ACF поддерживает 867 типов Schema.org и 1 509 свойств из коробки.
См. пост о релизе ACF 6.8 для обзора.
Экспериментальная функция
В ACF admin UI эта функция помечена как экспериментальная. Область generative engine optimization (GEO) быстро развивается, и лучшие практики того, как системы ИИ интерпретируют и показывают структурированные данные, только формируются. Мы рекомендуем поэкспериментировать с этой функцией и поделиться обратной связью.
Требования
- ACF 6.8 или новее
- WordPress 6.0 или новее
Настройка
Включите функцию Schema
Добавьте этот фильтр в файл functions.php вашей темы или в пользовательский плагин:
add_filter( 'acf/settings/enable_schema', '__return_true' );
1. Включите JSON-LD для типа записи
Отредактируйте ваш пользовательский тип записи ACF и перейдите на вкладку Schema:
- Включите «Автоматически добавлять данные JSON-LD для полей этого типа записи»
- При необходимости выберите тип Schema.org (например, Recipe, Product, Event)
Тип Schema.org определяется автоматически по сопоставлениям полей, но здесь его можно задать явно.
2. Сопоставьте поля со свойствами Schema.org
Отредактируйте каждое поле и настройте параметр Свойство Schema.org:
- Откройте настройки поля
- Найдите «Свойство Schema.org» в общих настройках
- Выберите подходящее свойство (например,
name,description,price) - При необходимости настройте формат вывода
Список свойств фильтруется так, чтобы показывать только совместимые с типом поля варианты.
Типы Schema.org
ACF поддерживает все типы Schema.org. Среди распространённых типов:
| Тип | Сценарий использования |
|---|---|
Article | Записи блога, новостные статьи |
BlogPosting | Записи блога |
Product | Товары для e-commerce |
Recipe | Кулинарные рецепты |
Event | События с датами и локациями |
Person | Люди, авторы, члены команды |
Organization | Компании, бренды |
LocalBusiness | Локальные бизнес-организации |
HowTo | Пошаговые руководства |
FAQPage | Контент FAQ |
Совместимость типов полей
Каждый тип поля ACF сопоставляется с определёнными типами данных Schema.org:
| Тип поля ACF | Типы Schema.org |
|---|---|
text, textarea, wysiwyg | Текст, URL, Name |
number, range | Число, Integer, Float |
email | Текст (формат email) |
url | URL |
date_picker | Дата |
date_time_picker | Дата и время |
time_picker | Время |
true_false | Логический тип |
image | ImageObject, URL |
select, radio, button_group | Текст, Enumeration |
user | Person |
taxonomy | Текст, Thing |
Формат вывода
JSON-LD выводится в секции <head> отдельных записей и страниц:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Recipe",
"name": "Печенье с шоколадной крошкой",
"description": "Классическое домашнее печенье с шоколадной крошкой",
"prepTime": "PT15M",
"cookTime": "PT12M",
"recipeYield": "24 печенья",
"recipeIngredient": [
"2 стакана муки",
"1 стакан сахара",
"1 стакан шоколадной крошки"
]
}
</script>
Фильтры
ACF предоставляет обширные фильтры для настройки вывода JSON-LD.
Управление выводом
| Фильтр | Описание |
|---|---|
| acf/schema/debug | Включить HTML-комментарии для отладки |
| acf/schema/disable_output | Отключить вывод JSON-LD для конкретных данных |
| acf/schema/enabled_post_types | Отфильтровать типы записей, для которых включён JSON-LD |
| acf/schema/render_script | Действие перед выводом тега script |
Настройка данных
| Фильтр | Описание |
|---|---|
| acf/schema/data | Изменить итоговые данные JSON-LD перед выводом |
| acf/schema/auto_add_image | Управлять автоматическим добавлением изображения записи |
| acf/schema/auto_add_author | Управлять автоматическим добавлением автора |
Для конкретной записи
| Фильтр | Описание |
|---|---|
| acf/schema/post_field_objects | Отфильтровать объекты полей для записи |
| acf/schema/post_field_objects/post_type={post_type} | Объекты полей для конкретного типа записи |
Для конкретного блока
| Фильтр | Описание |
|---|---|
| acf/schema/block_jsonld_enabled | Включить или отключить JSON-LD для конкретных блоков |
| acf/schema/block_field_objects | Отфильтровать объекты полей для блока |
| acf/schema/block_field_objects/block_name={block_name} | Объекты полей для конкретного блока |
Форматирование значений
| Фильтр | Описание |
|---|---|
| acf/schema/format_value/pre | Предварительное форматирование значения поля |
| acf/schema/format_value/pre/type={field_type} | Предварительное форматирование по типу поля |
| acf/schema/format_value/pre/name={field_name} | Предварительное форматирование по имени поля |
| acf/schema/format_value | Постформатирование значения поля |
| acf/schema/format_value/type={field_type} | Постформатирование по типу поля |
| acf/schema/format_value/name={field_name} | Постформатирование по имени поля |
Настройка Schema
| Фильтр | Описание |
|---|---|
| acf/schema/schema_types | Отфильтровать доступные типы Schema.org |
| acf/schema/schema_priority_types | Отфильтровать приоритетные типы в выпадающих списках |
| acf/schema/schema_properties | Отфильтровать доступные свойства Schema.org |
| acf/schema/output_format_choices | Отфильтровать варианты формата вывода |
Поддержка блоков ACF
Вывод JSON-LD также доступен для блоков ACF. Включите его через block.json:
{
"name": "acf/recipe-card",
"title": "Карточка рецепта",
"acf": {
"autoJsonLd": true,
"schemaType": "Recipe"
}
}
Или через программную регистрацию:
acf_register_block_type( array(
'name' => 'recipe-card',
'title' => 'Карточка рецепта',
'acf' => array(
'autoJsonLd' => true,
'schemaType' => 'Recipe',
),
));
Автоматическое дополнение данных
ACF автоматически дополняет вывод JSON-LD основными данными WordPress:
- Автор: схема Person с именем и URL архива
- Избранное изображение: ImageObject с размерами и URL
- Мета-данные записи:
datePublished,dateModified,url,name
Эти данные автоматически объединяются с вашими сопоставлениями полей.
Поля Repeater
Подполя Repeater могут сопоставляться со свойствами Schema, создавая массивы:
Сопоставление поля: Repeater с текстовым подполем, сопоставленным с recipeIngredient
Вывод:
{
"recipeIngredient": [
"2 стакана муки",
"1 стакан сахара",
"3 яйца"
]
}
Примечания
- JSON-LD выводится только на страницах отдельных записей/страниц (не в предпросмотре редактора блоков)
- Пустые значения полей автоматически исключаются
- Вложенные объекты (например,
authorилиpublisher) автоматически получают соответствующие значения@type - В admin UI эта функция помечена как Experimental
Обновлено: 01.06.2026