Описание функции add_term_meta()
Функция add_term_meta() используется для добавления метаданных к терминам (категориям, тегам и другим таксономиям) в WordPress. Эта функция позволяет хранить дополнительные данные, связанные с терминами, что может быть полезно для расширения функциональности и хранения специфичной информации.
Метаданные могут использоваться в различных сценариях, включая настройку отображения термина на сайте или хранение пользовательских данных.
Параметры
$term_id
Тип: int
Обязательный: Да
Описание: ID термина, к которому добавляется метаданные
Возможные значения:
$meta_key
Тип: string
Обязательный: Да
Описание: Ключ метаданных
Возможные значения:
$meta_value
Тип: mixed
Обязательный: Да
Описание: Значение метаданных
Возможные значения:
$unique
Тип: bool
Обязательный: Нет
Описание: Определяет, должно ли значение быть уникальным для данного ключа
Возможные значения:
0: 1
1:
Возвращаемое значение
Тип: int | false
Описание: ID добавленных метаданных или false в случае ошибки
Возможные значения:
• ID метаданных при успешном добавлении
• false в случае ошибки
Примеры использования
Базовый пример добавления метаданных к термину
$term_id = 42;
$meta_key = 'custom_field';
$meta_value = 'значение поля';
$result = add_term_meta($term_id, $meta_key, $meta_value);
// $result будет содержать ID метаданных
Метаданные успешно добавлены, $result содержит ID
Добавление уникального значения метаданных
$term_id = 42;
$meta_key = 'unique_field';
$meta_value = 'значение';
$result = add_term_meta($term_id, $meta_key, $meta_value, true);
При повторном добавлении с тем же ключом будет возвращено false
Пример обработки возможной ошибки при добавлении
$term_id = 999;
$meta_key = 'nonexistent_field';
$meta_value = 'value';
$result = add_term_meta($term_id, $meta_key, $meta_value);
if ($result === false) {
echo 'Ошибка добавления метаданных';
}
Если термин с ID 999 не существует, будет выведено сообщение об ошибке
Безопасность
Валидация входных данных: Функция не выполняет ручную валидацию входных данных
Санитизация: WordPress автоматически обрабатывает значения перед сохранением
Рекомендации: Убедитесь, что значения корректны перед вызовом функции
— Связанные функции
Получает метаданные термина по его ID
Удаляет метаданные термина
— Примечания
– Ограничения
Метаданные могут храниться только для существующих терминов
– Частые проблемы
- Ошибка при передаче неверного ID термина
- Проблемы с уникальностью значений при неправильном использовании параметра unique
