Обзор
Сопоставляйте поля ACF со свойствами Schema.org для вывода структурированных данных.
Описание
Каждое поле ACF можно сопоставить со свойством Schema.org. Это сопоставление определяет, как значение поля отображается в выводе JSON-LD. Свойства фильтруются с учетом совместимости с типом поля, поэтому вы увидите только те свойства, которые подходят для редактируемого типа поля.
Настройка
Настройки на уровне поля
При редактировании поля отображаются две настройки Schema.org:
Свойство Schema.org
Выберите свойство, с которым должно быть сопоставлено это поле. Свойства сгруппированы по типу Schema.org и отфильтрованы: отображаются только совместимые варианты.
Формат вывода Schema.org
Выберите формат, в котором значение поля должно быть представлено в выводе JSON-LD. Доступные форматы зависят от типа поля и выбранного свойства.
Выбор свойства
Свойства представлены в иерархическом раскрывающемся списке и сгруппированы по типу Schema.org:
Распространенные свойства
├── name
├── description
├── url
└── image
Recipe
├── prepTime
├── cookTime
├── recipeYield
├── recipeIngredient
└── recipeInstructions
Product
├── price
├── priceCurrency
├── sku
└── availability
Контекстные рекомендации
При редактировании группы полей, назначенной типу записи с настроенным типом Schema.org, релевантные свойства выводятся в верхней части списка.
Например, если ваша группа полей назначена типу записи «Recipe» с параметром schema_type: Recipe, такие свойства, как prepTime, cookTime и recipeIngredient, отображаются первыми.
Квалифицированные свойства
Некоторые свойства относятся к вложенным объектам внутри основной схемы. Они представлены как «квалифицированные свойства» с использованием точечной нотации:
| Квалифицированное свойство | Значение |
|---|---|
Offer.price | Цена внутри объекта Offer |
Offer.priceCurrency | Валюта внутри объекта Offer |
NutritionInformation.calories | Количество калорий в данных о питательной ценности |
HowToStep.text | Текст шага инструкции |
При использовании квалифицированного свойства ACF автоматически создает вложенную структуру:
Сопоставление поля: Offer.price со значением 29.99
Вывод:
{
"@type": "Product",
"offers": {
"@type": "Offer",
"price": 29.99
}
}
Распространенные сопоставления свойств
Текстовые поля
| Свойство | Описание | Пример значения |
|---|---|---|
name | Основное название/заголовок | «Шоколадное печенье» |
description | Текст описания | «Классическое домашнее печенье» |
headline | Заголовок статьи | «Как испечь идеальное печенье» |
alternativeHeadline | Подзаголовок | «Руководство для начинающих» |
text | Основной текст | Полное содержимое статьи |
sku | Артикул товара | «COOKIE-001» |
Числовые поля
| Свойство | Описание | Пример значения |
|---|---|---|
price | Цена | 29.99 |
ratingValue | Оценка | 4.5 |
reviewCount | Количество отзывов | 127 |
calories | Количество калорий | 250 |
recipeYield | Количество порций | 24 |
Поля даты и времени
| Свойство | Описание | Пример значения |
|---|---|---|
datePublished | Дата публикации | «2024-01-15» |
dateModified | Дата последнего изменения | «2024-01-20» |
startDate | Начало мероприятия | «2024-02-01T09:00:00» |
endDate | Окончание мероприятия | «2024-02-01T17:00:00» |
prepTime | Продолжительность подготовки | «PT15M» (15 минут) |
cookTime | Продолжительность приготовления | «PT30M» (30 минут) |
Поля изображений
| Свойство | Описание | Вывод |
|---|---|---|
image | Основное изображение | URL или ImageObject |
thumbnail | Миниатюра | URL |
logo | Логотип организации | ImageObject |
photo | Фотография человека или места | ImageObject |
Поля связей
| Свойство | Описание | Вывод |
|---|---|---|
author | Автор содержимого | Объект Person |
publisher | Издатель | Объект Organization |
brand | Бренд товара | Объект Brand |
Диапазоны типов полей
Каждый тип поля поддерживает определенные типы данных Schema.org:
Текстовые поля
text, textarea, wysiwyg
├── Text
├── URL
├── CssSelectorType
├── XPathType
└── PronounceableText
Числовые поля
number, range
├── Number
├── Integer
├── Float
├── Text (форматированный)
└── Duration (ISO 8601)
Поля даты и времени
date_picker → Date
date_time_picker → DateTime
time_picker → Time
Логические поля
true_false → Boolean
Медийные поля
image
├── ImageObject
├── URL
└── Text (строка URL)
file
├── MediaObject
├── URL
└── Text
Примечания
- В вывод JSON-LD включаются только поля с заданным
schema_property - Пустые значения автоматически исключаются
- Вложенные типы объектов (Person, Organization и т. д.) автоматически получают значение
@type - Свойства проверяются в соответствии со спецификациями Schema.org
- Некорректные сопоставления игнорируются без уведомления, чтобы предотвратить формирование неправильного вывода
Обновлено: 30.09.2026