Обзор
Настройте форматирование значений полей ACF в выводе JSON-LD.
Описание
При сопоставлении поля со свойством Schema.org можно указать формат вывода. Он определяет, как исходное значение поля преобразуется для вывода JSON-LD. Доступные форматы зависят от типа поля и выбранного свойства.
Настройка
Настройка Формат вывода Schema.org отображается после выбора свойства Schema.org. В ней показываются только форматы, допустимые для выбранного сочетания типа поля и свойства.
Доступные форматы
Текстовые форматы
Текст (по умолчанию для текстовых полей)
Выводится как обычная текстовая строка.
"name": "Шоколадное печенье"
URL
Выводится как строка URL. Проверяется, что значение является допустимым URL.
"url": "https://example.com/recipe"
Числовые форматы
Число (по умолчанию для числовых полей)
Выводится как числовое значение без кавычек.
"price": 29.99
Целое число
Выводится как целое число.
"reviewCount": 127
Текст
Число выводится как строка в кавычках.
"sku": "12345"
Форматы продолжительности
Продолжительность ISO 8601
Числовые значения преобразуются в формат продолжительности ISO 8601.
| Входное значение | Результат |
|---|---|
| 15 (минут) | "PT15M" |
| 90 (минут) | "PT1H30M" |
| 2 (часа) | "PT2H" |
"prepTime": "PT15M",
"cookTime": "PT30M"
Форматы даты и времени
Дата (ISO 8601)
Выводится в формате YYYY-MM-DD.
"datePublished": "2024-01-15"
Дата и время (ISO 8601)
Выводятся как полная дата и время с часовым поясом.
"startDate": "2024-02-01T09:00:00-05:00"
Время (ISO 8601)
Выводится в формате HH:MM:SS.
"opens": "09:00:00"
Форматы изображений
ImageObject
Выводится как структурированный ImageObject с метаданными.
"image": {
"@type": "ImageObject",
"url": "https://example.com/image.jpg",
"width": 1200,
"height": 800,
"caption": "Свежеиспечённое печенье"
}
URL
Выводится как простая строка URL.
"image": "https://example.com/image.jpg"
Форматы массивов
Массив текстовых значений
Для повторителей или полей с несколькими значениями выводится массив строк.
"recipeIngredient": [
"2 стакана муки",
"1 стакан сахара",
"1 стакан шоколадной крошки"
]
Массив объектов
Для полей-повторителей с вложенными сопоставлениями схемы.
"recipeInstructions": [
{
"@type": "HowToStep",
"text": "Разогрейте духовку до 350°F"
},
{
"@type": "HowToStep",
"text": "Смешайте сухие ингредиенты"
}
]
Логические форматы
Логическое значение
Выводится как true/false без кавычек.
"isAccessibleForFree": true
Текст
Выводится как строка “true” или “false”.
"availability": "InStock"
Форматы по умолчанию для типов полей
Для каждого типа поля предусмотрен формат вывода по умолчанию:
| Тип поля | Формат по умолчанию |
|---|---|
text | Текст |
textarea | Текст |
wysiwyg | Текст |
number | Число |
range | Число |
email | Текст |
url | URL |
date_picker | Дата |
date_time_picker | Дата и время |
time_picker | Время |
true_false | Логическое значение |
image | ImageObject |
file | URL |
select | Текст |
checkbox | Массив текстовых значений |
repeater | Массив |
Форматы для отдельных свойств
Некоторые свойства переопределяют формат по умолчанию в соответствии со спецификациями Schema.org:
| Свойство | Ожидаемый формат |
|---|---|
prepTime, cookTime, totalTime | Продолжительность ISO 8601 |
datePublished, dateModified | Дата |
startDate, endDate | Дата и время |
price | Число |
image, logo, photo | ImageObject или URL |
recipeIngredient | Массив текстовых значений |
recipeInstructions | Массив HowToStep |
Примечания
- Селектор формата вывода показывает только допустимые варианты для выбранного сочетания типа поля и свойства
- Недопустимый выбранный формат автоматически и без уведомления заменяется форматом по умолчанию
- Пустые значения исключаются независимо от формата
- Массивы, не содержащие допустимых элементов, исключаются из вывода
Обновлено: 30.09.2026