Обзор
Настройте, как значения полей 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"
DateTime (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 чашка шоколадных капель"
]
Массив объектов
Для повторяющихся полей со вложенными сопоставлениями Schema.
"recipeInstructions": [
{
"@type": "HowToStep",
"text": "Разогрейте духовку до 350°F"
},
{
"@type": "HowToStep",
"text": "Смешайте сухие ингредиенты"
}
]
Булевы форматы
Boolean
Выводится как true/false без кавычек.
"isAccessibleForFree": true
Текст
Выводится как строка «true» или «false».
"availability": "InStock"
Значения по умолчанию для типов полей
У каждого типа поля есть формат вывода по умолчанию:
| Тип поля | Формат по умолчанию |
|---|---|
text | Текст |
textarea | Текст |
wysiwyg | Текст |
number | Число |
range | Число |
email | Текст |
url | URL |
date_picker | Дата |
date_time_picker | DateTime |
time_picker | Время |
true_false | Boolean |
image | ImageObject |
file | URL |
select | Текст |
checkbox | Массив текста |
repeater | Массив |
Форматы для конкретных свойств
Некоторые свойства переопределяют формат по умолчанию в соответствии со спецификацией Schema.org:
| Свойство | Ожидаемый формат |
|---|---|
prepTime, cookTime, totalTime | Длительность ISO 8601 |
datePublished, dateModified | Дата |
startDate, endDate | DateTime |
price | Число |
image, logo, photo | ImageObject or URL |
recipeIngredient | Массив текста |
recipeInstructions | Массив HowToStep |
Примечания
- Селектор формата вывода показывает только допустимые варианты для комбинации типа поля и свойства
- Недопустимые варианты формата незаметно исправляются на значение по умолчанию
- Пустые значения исключаются независимо от формата
- Массивы без допустимых элементов исключаются из вывода
Обновлено: 01.06.2026