Описание функции wp_set_post_tags()
Функция wp_set_post_tags() устанавливает теги для заданной записи. Она позволяет добавлять, обновлять и удалять теги, используя массив тегов, что делает управление таксономиями более удобным и гибким.
Функция часто используется при программном обновлении записей, импорте данных или автоматизации создания контента
Параметры
$post_id
Тип: int
Обязательный: Да
Описание: ID записи, для которой устанавливаются теги
Возможные значения:
$tags
Тип: array|string
Обязательный: Да
Описание: Массив или строка тегов, которые нужно установить для записи
Возможные значения:
Возвращаемое значение
Тип: array|false
Описание: Возвращает массив установленных тегов или false при ошибке
Возможные значения:
• Массив строк с установленными тегами
• false при ошибке
Примеры использования
Устанавливаем теги для записи с ID 42
$tags = array('новости', 'технологии');
$result = wp_set_post_tags(42, $tags);
// $result будет массивом установленных тегов
теги будут установлены на запись
Теги передаются как строка
$result = wp_set_post_tags(42, 'спорт, здоровье');
// $result будет массивом установленных тегов
разделение тегов запятыми
Проверка на ошибку при установке тегов
$result = wp_set_post_tags(9999, 'тег');
if ($result === false) {
echo 'Ошибка: не удалось установить теги';
}
// Проверка на успешность операции
ID записи не существует
Функция устанавливает теги при сохранении записи
function my_plugin_set_tags($post_id) {
$tags = array('плагин', 'WordPress');
wp_set_post_tags($post_id, $tags);
}
add_action('save_post', 'my_plugin_set_tags');
Связываем с хуком сохранения записи
Безопасность
Валидация входных данных: Функция проверяет существование записи по переданному ID
Санитизация: Входные параметры автоматически очищаются WordPress
Рекомендации: Перед использованием убедитесь, что запись существует и ID валиден
— Связанные функции
Получает теги для заданной записи
Удаляет теги у записи
— Примечания
– Ограничения
Не устанавливает теги для записей, которые не существуют
– Частые проблемы
- Проблемы с неверным ID записи
- Неверный формат тегов