wp_insert_term()

wp_insert_term( string $term, string $taxonomy, array|string $args = array() ): array|WP_Error

<?php
// Создаем новый термин с названием "Новая категория" в таксономии "category"
$new_term = wp_insert_term( 'Новая категория', 'category', array(
  'description' => 'Описание новой категории',
  'parent' => 0,
  'slug' => 'new-category'
) );
if ( ! is_wp_error( $new_term ) ) {
  // Термин успешно добавлен
  $term_id = $new_term['term_id'];
  $term_name = $new_term['name'];
  echo "Термин $term_name (ID: $term_id) успешно добавлен.";
} else {
  // Возникла ошибка при добавлении термина
  $error_message = $new_term->get_error_message();
  echo "Ошибка при добавлении термина: $error_message";
}
?>

$term = 'New Term';
$taxonomy = 'category';
$result = wp_insert_term( $term, $taxonomy );
if ( ! is_wp_error( $result ) ) {
    echo 'Термин успешно добавлен.';
} else {
    echo 'Ошибка при добавлении термина: ' . $result->get_error_message();
}

$term = 'Existing Term';
$taxonomy = 'category';
$description = 'New description';
$term_data = get_term_by( 'name', $term, $taxonomy );
if ( $term_data ) {
    $term_id = $term_data->term_id;
    $result = wp_update_term( $term_id, $taxonomy, array( 'description' => $description ) );
    if ( ! is_wp_error( $result ) ) {
        echo 'Описание термина успешно изменено.';
    } else {
        echo 'Ошибка при изменении описания термина: ' . $result->get_error_message();
    }
} else {
    echo 'Термин не найден.';
}

$term = 'Existing Term';
$taxonomy = 'category';
$alias = 'Alias Term';
$term_data = get_term_by( 'name', $term, $taxonomy );
if ( $term_data ) {
    $term_id = $term_data->term_id;
    $result = wp_update_term( $term_id, $taxonomy, array( 'alias_of' => $alias ) );
    if ( ! is_wp_error( $result ) ) {
        echo 'Псевдоним успешно создан.';
    } else {
        echo 'Ошибка при создании псевдонима: ' . $result->get_error_message();
    }
} else {
    echo 'Термин не найден.';
}

$term = 'Child Term';
$taxonomy = 'category';
$parent = 'Parent Term';
$parent_term_data = get_term_by( 'name', $parent, $taxonomy );
if ( $parent_term_data ) {
    $parent_term_id = $parent_term_data->term_id;
    $result = wp_insert_term( $term, $taxonomy, array( 'parent' => $parent_term_id ) );
    if ( ! is_wp_error( $result ) ) {
        echo 'Родительский термин успешно установлен.';
    } else {
        echo 'Ошибка при установке родительского термина: ' . $result->get_error_message();
    }
} else {
    echo 'Родительский термин не найден.';
}

$term = 'Existing Term';
$taxonomy = 'category';
$slug = 'new-term-slug';
$term_data = get_term_by( 'name', $term, $taxonomy );
if ( $term_data ) {
    $term_id = $term_data->term_id;
    $result = wp_update_term( $term_id, $taxonomy, array( 'slug' => $slug ) );
    if ( ! is_wp_error( $result ) ) {
        echo 'Слаг термина успешно изменен.';
    } else {
        echo 'Ошибка при изменении слага термина: ' . $result->get_error_message();
    }
} else {
    echo 'Термин не найден.';
}

Вопросы и ответы

Как добавить новый термин в базу данных?

Для добавления нового термина в базу данных WordPress используется функция wp_insert_term(). Эта функция принимает три обязательных параметра: $term, $taxonomy и $args.

Параметр $term должен содержать название нового термина, который вы хотите добавить.

Параметр $taxonomy должен содержать название таксономии, к которой вы хотите добавить термин.

Параметр $args является необязательным и может содержать дополнительные аргументы для добавления термина. Например, вы можете указать родительский термин, описание или слаг для нового термина.

$term = 'Новый термин';
$taxonomy = 'название_таксономии';
$args = array(
    'description' => 'Описание нового термина',
    'slug' => 'новый-термин'
);
$result = wp_insert_term( $term, $taxonomy, $args );
if ( ! is_wp_error( $result ) ) {
    echo 'Термин успешно добавлен!';
} else {
    echo 'Ошибка при добавлении термина: ' . $result->get_error_message();
}

Как указать родительский термин при добавлении нового термина?

Для указания родительского термина при добавлении нового термина в базу данных, в параметре $args функции wp_insert_term() нужно указать значение 'parent' равное ID родительского термина.

$term = 'Новый термин';
$taxonomy = 'название_таксономии';
$args = array(
    'parent' => 5
);
$result = wp_insert_term( $term, $taxonomy, $args );
if ( ! is_wp_error( $result ) ) {
    echo 'Термин успешно добавлен!';
} else {
    echo 'Ошибка при добавлении термина: ' . $result->get_error_message();
}

Как задать описание для нового термина?

Для задания описания для нового термина при добавлении в базу данных, в параметре $args функции wp_insert_term() нужно указать значение 'description' равное описанию термина.

$term = 'Новый термин';
$taxonomy = 'название_таксономии';
$args = array(
    'description' => 'Описание нового термина'
);
$result = wp_insert_term( $term, $taxonomy, $args );
if ( ! is_wp_error( $result ) ) {
    echo 'Термин успешно добавлен!';
} else {
    echo 'Ошибка при добавлении термина: ' . $result->get_error_message();
}

Как задать слаг для нового термина?

Для задания слага нового термина в функции wp_insert_term() используется параметр slug. По умолчанию, если параметр не указан, слаг будет пустым.

$args = array(
    'slug' => 'my-term-slug'
);
wp_insert_term( 'My Term', 'my_taxonomy', $args );

Как сделать новый термин псевдонимом другого термина?

Для того чтобы сделать новый термин псевдонимом другого термина, в функции wp_insert_term() используется параметр alias_of. Этот параметр принимает слаг термина, который должен стать псевдонимом.

$args = array(
    'alias_of' => 'existing-term-slug'
);
wp_insert_term( 'New Term', 'my_taxonomy', $args );

Как получить данные о новом термине после его добавления?

После добавления нового термина с помощью функции wp_insert_term(), можно получить данные о нем, используя возвращаемое значение функции. Если термин успешно добавлен, возвращается массив с данными о новом термине.

$result = wp_insert_term( 'New Term', 'my_taxonomy' );
if ( ! is_wp_error( $result ) ) {
    $term_id = $result['term_id'];
    $term_name = $result['name'];
    $term_slug = $result['slug'];
    // и другие данные о термине
}

Как обработать ошибку при добавлении нового термина?

При использовании функции wp_insert_term() для добавления нового термина в базу данных WordPress, возможны ситуации, когда происходит ошибка. Для обработки ошибок необходимо проверить возвращаемое значение функции.

Если функция успешно добавляет новый термин, она возвращает массив данных нового термина. В случае ошибки, функция возвращает объект класса WP_Error. Для проверки наличия ошибок можно использовать функцию is_wp_error().

Пример обработки ошибки:

$term = 'New Term';
$taxonomy = 'category';
$result = wp_insert_term( $term, $taxonomy );
if ( is_wp_error( $result ) ) {
    $error_message = $result->get_error_message();
    echo 'Ошибка при добавлении термина: ' . $error_message;
} else {
    echo 'Термин успешно добавлен.';
}

Как удалить новый термин после его добавления?

Если после добавления нового термина необходимо его удалить, можно воспользоваться функцией wp_delete_term(). Эта функция удаляет термин из базы данных.

Пример удаления термина:

$term_id = 123;
$result = wp_delete_term( $term_id, $taxonomy );
if ( is_wp_error( $result ) ) {
    $error_message = $result->get_error_message();
    echo 'Ошибка при удалении термина: ' . $error_message;
} else {
    echo 'Термин успешно удален.';
}

Как обновить данные нового термина после его добавления?

Если после добавления нового термина необходимо обновить его данные, можно воспользоваться функцией wp_update_term(). Эта функция обновляет информацию о термине в базе данных.

Пример обновления данных термина:

$term_id = 123;
$args = array(
    'name' => 'Updated Term',
    'description' => 'New description',
);
$result = wp_update_term( $term_id, $taxonomy, $args );
if ( is_wp_error( $result ) ) {
    $error_message = $result->get_error_message();
    echo 'Ошибка при обновлении термина: ' . $error_message;
} else {
    echo 'Термин успешно обновлен.';
}

Функция wp_insert_term() позволяет добавлять новые термины в базу данных WordPress. При использовании этой функции важно проверять возвращаемое значение на наличие ошибок с помощью функции is_wp_error(). Если возникла ошибка, можно обработать ее и вывести соответствующее сообщение. Также можно использовать функции wp_delete_term() и wp_update_term() для удаления и обновления данных термина соответственно.