wp_set_post_tags()
Встановлює позначки для посту.
Працює на основі:
wp_set_post_terms()
wp_set_post_terms()
Хуків немає.
Повертає
Массив|false|WP_Error.
false, якщо $post_id не число або 0, в інших випадках – масив ID які були задіяні або об’єкт WP_Error.
Використання
wp_set_post_tags($post_id, $tags, $append);
-
$post_id
(число) (обов’язковий) - ID посту. За умовчанням НЕ ставитися до глобальної змінної Global $post.
-
$tags
(рядок/масив) Список елементів таксономії у вигляді масиву або рядку через кому.
Функція створить нові позначки, якщо не знайде вказані. Якщо вказати назву (у кирилиці), то функція створить мітку. При цьому: назва буде назвою, слаг слагом (обробиться як завжди).
Якщо передається ID, або масив з ID, переконайтеся, що змінні передаються як числа, а не як рядки! Тому що рядки у вигляді числа, наприклад, ’98’ інтерпретуватимуться як назва терміна, а не його ID!
За замовчуванням: ”
-
$append
(логічний) -
Доповнити запис вказаними мітками або замінити їх.
Якщо true, то поточний зв’язок запису з мітками не буде обірваний, а нові вказані мітки додадуться до поточних.
Якщо false, то для запису встановляться лише зазначені мітки, з решти запис буде видалено.
Типово: false
Приклади
#1 Додамо мітки для посту
Цей приклад додає пост 42 у мітки «почуття» та «життя»
wp_set_post_tags (42, 'почуття, життя', true);
П.С. Якщо вказаних міток немає, то вони будуть створені.
нотатки
- Дивіться: wp_set_object_terms()
список змін
| З версії 2.3.0 | Введено. |
Код wp_set_post_tags() wp set post tags WP 6.0.2
function wp_set_post_tags( $post_id = 0, $tags = '', $append = false ) {
return wp_set_post_terms( $post_id, $tags, 'post_tag', $append );
}