Запис #8 "wp_insert_term"

Додано: 2015-10-21 23:22:20 'admin

Функція wp_insert_term() додає до таксономії об'єкт - так званий термін. Також може зв'язати його вже з існуючим терміном роблячи його дочірнім. 

Використовується у функції wp_insert_category().

Синтаксис функції:

 wp_insert_term( $term, $taxonomy, $args = array() ); ?>

Функція приймає три параметри:

- $term. Строка або число. Обов'язковий. Назва терміну який буде додано або оновлено.
- $taxonomy. Строка. Обов'язковий. Назва таксономії до якої буде додано термін.
- $args. Масив або строка. Задає аргументи терміну.

Аргументи параметру $args:

alias_of. Строка. Якщо задати - буде слаг (УРЛ), який стане аліасом даному терміну
description. Строка. Опис терміну
parent. Число. ІД батьківського елементу для даного терміну
slug. Строка. Слаг (УРЛ) для даного терміну

Функція повертає:

Масив із двума значеннями: array('term_id'=>(int),'term_taxonomy_id'=>(int))
Якщо виникли помилки під час виконання функції - вона поверне обєкт WP_error.

 Приклад використання:

$parent_term = term_exists( 'apple', 'jam' ); // поверне масив, якщо таксономія існує
$parent_term_id = $parent_term['term_id']; // отримуємо ІД батьківського елементу
wp_insert_term(
    'Яблучне', // Новий термін
    'jam', // таксономія
    array(
        'description'=> 'Яблучне варення.',
        'slug' => 'apple',
        'parent'=> $parent_term_id
    )
);

Цей код створить новий термін у таксономії:

Офіційний опис функції:

wp_insert_term()

 

Коментарі: