Описание функции get_post_custom_values()
Функция get_post_custom_values() используется для получения значений пользовательских полей (метаполей) конкретной записи. Она позволяет извлекать значения мета-данных, что может быть полезно для работы с дополнительной информацией, связанной с записями, такой как цена товара, рейтинг и т. д.
Функция поддерживает извлечение значений для конкретного метаполя и возвращает их в виде массива.
Параметры
$key
Тип: string
Обязательный: Да
Описание: Ключ метаполя, значения которого необходимо получить
Возможные значения:
$post_id
Тип: int
Обязательный: Нет
По умолчанию: null
Описание: ID записи, для которой нужно получить значения метаполя. Если не указан, используется текущий пост
Возможные значения:
Возвращаемое значение
Тип: array|null
Описание: Массив значений метаполя или null, если значения не найдены
Возможные значения:
• Массив строк, представляющий значения метаполя
• null если метаполе не найдено
Примеры использования
Получение значений метаполя ‘price’ для записи с ID 42
$values = get_post_custom_values('price', 42);
print_r($values);
Может вернуть массив значений, связанных с метаполем ‘price’
Получение значений метаполя ‘rating’ для текущей записи
$values = get_post_custom_values('rating');
print_r($values);
Если не указан ID, используется текущий пост
Проверка на отсутствие значений метаполя
$values = get_post_custom_values('non_existent_key');
if ($values === null) {
echo 'Значения не найдены';
}
Вывод сообщения, если метаполе не найдено
Получение и вывод цены товара в шаблоне темы
$price = get_post_custom_values('price', get_the_ID());
if ($price) {
echo 'Цена: ' . esc_html($price[0]);
}
Используется esc_html для безопасного вывода
Безопасность
Валидация входных данных: Параметры проходят валидацию внутри функции
Санитизация: Параметры автоматически очищаются WordPress
Рекомендации: При выводе данных используйте esc_html() для значений метаполей
— Связанные функции
Получает одно или несколько значений метаполя по ID поста
Обновляет или добавляет значение метаполя для записи
— Примечания
– Ограничения
Возвращает только значения метаполей, которые существуют
– Частые проблемы
- Возвращает null при неправильном ключе или отсутствии метаполя
- Необходимо следить за правильностью ID поста