Описание функции get_post_custom_keys()
Функция get_post_custom_keys() возвращает массив уникальных ключей пользовательских полей (метаполей) для заданной записи. Это полезно для получения списка всех метаполей, которые были добавлены к записи, что может быть полезно для отображения или манипуляции с данными.
Функция может использоваться в шаблонах тем или плагинах для работы с метаданными записей
Параметры
$post_id
Тип: int
Обязательный: Да
Описание: ID записи, для которой нужно получить ключи пользовательских полей
Возможные значения:
Возвращаемое значение
Тип: array|null
Описание: Массив уникальных ключей пользовательских полей или null
Возможные значения:
• Массив строк с уникальными ключами пользовательских полей
• null, если запись не найдена или у нее нет метаполей
Примеры использования
Базовый пример получения ключей пользовательских полей для записи с ID 1
$custom_keys = get_post_custom_keys(1);
print_r($custom_keys);
Выводит массив ключей, например: Array ( [0] => _custom_field [1] => another_field )
Проверка наличия метаполей для записи
$custom_keys = get_post_custom_keys(42);
if (empty($custom_keys)) {
echo 'Нет пользовательских полей';
} else {
print_r($custom_keys);
}
Выводит сообщение, если метаполей нет
Безопасность
Валидация входных данных: ID записи должен быть целым числом, проверка осуществляется внутри функции
Санитизация: Не требуется, так как функция работает с ID записи
Рекомендации: Используйте esc_html() при выводе данных с пользовательскими полями
— Связанные функции
Получает все пользовательские поля для записи
Добавляет пользовательское поле к записи
— Примечания
– Ограничения
Работает только с существующими записями, если ID не существует, возвращает null
– Частые проблемы
- Если запись не имеет пользовательских полей, функция вернет null
- Неверный ID записи может привести к отсутствию результатов
