Обзор
Сопоставляйте поля 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 | 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
- Неверные сопоставления тихо игнорируются, чтобы предотвратить некорректный вывод
Обновлено: 01.06.2026