Описание функции get_fields()
Функция get_fields() используется для получения всех пользовательских полей (custom fields) для конкретного поста, страницы или пользовательского типа записи. Она возвращает массив значений пользовательских полей, которые могут быть добавлены с помощью плагина Advanced Custom Fields (ACF).
Функция полезна для работы с метаполями и позволяет легко извлекать данные, добавленные к записям.
Параметры
$post_id
Тип: int
Обязательный: Да
Описание: ID поста или страницы, для которого необходимо получить пользовательские поля
Возможные значения:
Возвращаемое значение
Тип: array|null
Описание: Массив пользовательских полей или null
Возможные значения:
• Массив значений пользовательских полей при успешном выполнении
• null если пользовательские поля не найдены
Примеры использования
Базовый пример получения пользовательских полей поста с ID 1
$fields = get_fields(1);
if ($fields) {
foreach ($fields as $key => $value) {
echo $key . ': ' . $value . '<br>';
}
}
Вывод всех пользовательских полей поста
Проверка на наличие пользовательских полей для поста с ID 2
$fields = get_fields(2);
if ($fields === null) {
echo 'Нет пользовательских полей';
}
Вывод сообщения, если поля отсутствуют
Безопасность
Валидация входных данных: ID поста должен быть целым числом
Санитизация: Данные, возвращаемые функцией, очищаются автоматически
Рекомендации: При выводе данных используйте esc_html() для защиты от XSS
— Связанные функции
Получает одно пользовательское поле по его ключу
Обновляет значение пользовательского поля
— Хуки
Фильтрует массив пользовательских полей перед их возвратом
— Примечания
– Ограничения
Работает только с пользовательскими полями, созданными с помощью ACF
– Частые проблемы
- Возвращает null, если нет пользовательских полей для данного поста
- Неправильный ID поста приведет к ошибке
