Функция WP_TERM_IS_SHARED() │ WP 4.4.0

Функция WP_TERM_IS_SHARED() помогает определить, используется ли термин в нескольких таксономиях. Таксономии в WordPress — это способы группировки контента, например, категории и метки.

Когда использовать

Таксономические термины, которые используются в нескольких местах, начали разделять с версии 4.3. Однако неполадки при выполнении задач или задержки в обновлениях могут привести к тому, что некоторые общие термины останутся.

Используется в

• update_term_meta()
• add_term_meta()

Возврат значения

Функция возвращает:

• true — если термин используется в нескольких таксономиях.
• false — если термин не распространён или процесс разделения терминов завершён.

Использование функции

wp_term_is_shared( $term_id );

Аргументы

• $term_id (int) — ID термина, который вы проверяете (обязательный параметр).

Примеры

Пример 1: Проверка, является ли термин 123 общим

$term_id = 123;

if( wp_term_is_shared( $term_id ) ){
    echo "{$term_id} является общим термином";
}

Замечания

• Эта функция использует глобальный объект базы данных WordPress: $wpdb.

Изменения в функции

• С версии 4.4.0 функция была введена.

Код функции WP_TERM_IS_SHARED()

Вот как выглядит код функции в файле wp-includes/taxonomy.php:

function wp_term_is_shared( $term_id ) {
global $wpdb;

if ( get_option( 'finished_splitting_shared_terms' ) ) {
    return false;
}

$tt_count = $wpdb->get_var( $wpdb->prepare( "SELECT COUNT(*) FROM $wpdb->term_taxonomy WHERE term_id = %d", $term_id ) );

return $tt_count > 1;

}

Заключение

Функция WP_TERM_IS_SHARED() полезна для разработчиков WordPress, так как позволяет понять, используется ли термин в нескольких таксономиях. Это может помочь избежать путаницы и облегчить управление терминами в вашем сайте.