Описание функции get_field()
Функция get_field() используется для получения значений произвольных полей, созданных с помощью плагина Advanced Custom Fields (ACF). Она позволяет извлекать данные, ассоциированные с постами, страницами и другими объектами, с целью их дальнейшего использования в шаблонах.
Функция поддерживает различные типы данных, включая текст, изображения, массивы и объекты
Параметры
$field_name
Тип: string
Обязательный: Да
Описание: Имя поля, значение которого нужно получить
Возможные значения:
$post_id
Тип: mixed
Обязательный: Нет
По умолчанию: null
Описание: ID поста, для которого нужно получить значение поля. Если не указано, будет использован текущий пост
Возможные значения:
Возвращаемое значение
Тип: mixed
Описание: Возвращает значение поля, если оно существует и доступно
Возможные значения:
• Значение поля (например, строка, массив, объект)
• null если поле не существует
• false в случае ошибки
Примеры использования
Получение значения произвольного поля для текущего поста
$value = get_field('my_custom_field');
// Вывод значения произвольного поля
echo $value;
Выводит значение поля, если оно существует
Получение значения произвольного поля для поста с указанным ID
$value = get_field('my_custom_field', 123);
// Вывод значения произвольного поля для поста с ID 123
echo $value;
ID поста должен существовать
Проверка на существование поля перед выводом
$value = get_field('non_existent_field');
if ($value === null) {
echo 'Поле не найдено';
} else {
echo $value;
}
Выводит сообщение об ошибке, если поле не найдено
Использование произвольного поля в шаблоне темы
$subtitle = get_field('subtitle');
if ($subtitle) {
echo '<h2>' . esc_html($subtitle) . '</h2>';
}
Выводит подзаголовок если он существует
Безопасность
Валидация входных данных: Функция проверяет наличие поля перед его получением
Санитизация: Рекомендуется использовать esc_html() для вывода данных
Рекомендации: Проверяйте существование поля перед использованием его значения
— Связанные функции
Обновляет значение произвольного поля
Удаляет значение произвольного поля
— Хуки
Фильтрует значение поля перед его возвратом
— Примечания
– Ограничения
Работает только с полями, созданными с помощью ACF
– Частые проблемы
- Возвращает null если поле не существует
- Неправильное имя поля приводит к отсутствию результата
