Описание функции acf_shortcode()
Функция acf_shortcode() позволяет создавать шорткоды для полей, созданных с помощью плагина Advanced Custom Fields (ACF). Она используется для вывода значений пользовательских полей ACF в контенте постов или страниц, что делает их доступными для редактирования через визуальный редактор.
Функция особенно полезна для разработчиков, создающих динамические контенты на своем сайте.
Параметры
$atts
Тип: array
Обязательный: Да
По умолчанию: {}
Описание: Массив атрибутов шорткода, содержащий ключи для полей ACF
Возможные значения:
field: Имя поля ACF
post_id: ID поста, для которого получаем поле
format: value, label
Возвращаемое значение
Тип: mixed
Описание: Значение поля ACF или значение по умолчанию
Возможные значения:
• Строка с значением поля ACF при успешном выполнении
• null если поле не найдено или пустое
• WP_Error в случае ошибки
Примеры использования
Вывод значения поля ACF с именем ‘my_custom_field’
[acf field='my_custom_field']
Если поле пустое, то ничего не будет выведено
Вывод значения поля ACF для поста с ID 123
[acf field='my_custom_field' post_id='123']
Важно указывать корректный ID поста
Безопасность
Валидация входных данных: Параметры шорткода валидируются внутри функции
Санитизация: Значения полей автоматически очищаются WordPress
Рекомендации: Используйте esc_html() для вывода значений полей
— Связанные функции
Получает значение одного поля ACF
Выводит значение одного поля ACF напрямую
— Хуки
Фильтрует атрибуты шорткода перед его выполнением
— Примечания
– Ограничения
Некоторые поля могут требовать специфической обработки
– Частые проблемы
- Ошибка при использовании неверного имени поля
- Проблемы с отображением при отсутствии прав доступа к полю
