Описание функции get_post_custom()
Функция get_post_custom() возвращает массив пользовательских полей для заданной записи. Это позволяет разработчикам получать дополнительные данные, хранящиеся в метаполях записи, которые могут быть использованы в темах или плагинах. Функция полезна для получения всех пользовательских полей без необходимости запрашивать их по отдельности.
Параметры
$post_id
Тип: int
Обязательный: Да
Описание: ID записи, для которой нужно получить пользовательские поля
Возможные значения:
Возвращаемое значение
Тип: array
Описание: Ассоциативный массив пользовательских полей для заданной записи
Возможные значения:
• Массив, где ключи — это имена пользовательских полей, а значения — массивы значений этих полей
• Пустой массив если пользовательские поля отсутствуют
• null если запись не найдена
Примеры использования
Базовый пример получения пользовательских полей для записи с ID 1
$custom_fields = get_post_custom(1);
print_r($custom_fields);
Вернет массив пользовательских полей для записи
Проверка на наличие пользовательских полей для записи с ID 42
$custom_fields = get_post_custom(42);
if (!empty($custom_fields)) {
// Обработка пользовательских полей
}
Если массив не пустой, можно продолжить обработку
Безопасность
Валидация входных данных: Параметр post_id проходит валидацию внутри функции
Санитизация: Функция автоматически очищает данные
Рекомендации: При выводе значений используйте esc_html() для предотвращения XSS-атак
— Связанные функции
Получает одно или несколько значений конкретного метаполя записи
Добавляет новое метаполе к записи
— Хуки
Фильтрует массив пользовательских полей перед его возвращением
— Примечания
– Ограничения
Возвращает только пользовательские поля, сохраненные для записи
– Частые проблемы
- Возвращает пустой массив, если запись не существует или у нее нет пользовательских полей
- Ошибки при передаче неверного ID записи
