Описание функции get_metadata()
Функция get_metadata() используется для получения метаданных, связанных с объектами в WordPress, такими как записи, пользователи, комментарии и термины. Она позволяет извлекать метаданные по ключу и типу объекта, что делает её универсальным инструментом для работы с метаинформацией.
Функция может быть использована для получения как одиночных значений, так и массивов значений метаданных в зависимости от переданных параметров.
Параметры
$meta_type
Тип: string
Обязательный: Да
Описание: Тип объекта, для которого требуется метаданные (например, post, user, comment)
Возможные значения:
0: post
1: user
2: comment
3: term
$object_id
Тип: int
Обязательный: Да
Описание: ID объекта, для которого запрашиваются метаданные
$meta_key
Тип: string
Обязательный: Нет
Описание: Ключ метаданных, если указан, вернётся только одно значение или null
$single
Тип: bool
Обязательный: Нет
Описание: Если true, функция вернёт только одно значение метаданных, если оно существует
Возвращаемое значение
Тип: mixed
Описание: Возвращает значение метаданных или массив значений в зависимости от переданных параметров
Возможные значения:
• Строка или массив значений метаданных при успешном выполнении
• null, если метаданные не найдены
• false в случае ошибки
Примеры использования
Получение одного значения метаданных для записи с ID 1
$meta_value = get_metadata('post', 1, '_thumbnail_id', true);
// Вывод: echo $meta_value;
Выводит ID миниатюры записи, если она установлена
Получение всех метаданных для пользователя с ID 42
$user_meta = get_metadata('user', 42);
// Вывод: print_r($user_meta);
Вернёт массив со всеми метаданными пользователя
Проверка на наличие метаданных и вывод сообщения об ошибке
$meta_value = get_metadata('post', 9999, '_thumbnail_id', true);
if ($meta_value === false) {
echo 'Метаданные не найдены';
}
Метаданные не найдены, если ID записи неверен
Безопасность
Валидация входных данных: Все параметры проверяются перед использованием
Санитизация: Параметры очищаются по мере необходимости в WordPress
Рекомендации: Используйте esc_html() для безопасного вывода значений метаданных
— Связанные функции
Обновляет метаданные объекта
Добавляет метаданные объекту
Удаляет метаданные объекта
— Хуки
Фильтрует возвращаемые метаданные перед выводом
Фильтрует метаданные для конкретного типа объекта
— Примечания
– Ограничения
Необходимо учитывать, что метаданные могут отсутствовать
– Частые проблемы
- Неверный ID объекта может привести к отсутствию метаданных
- Использование неправильного типа метаданных вернёт пустой результат
