WP_Term

Методы

filter()

Метод filter() класса WP_Term используется для санитизации полей термина в соответствии с указанным типом фильтра.

WP_Term::filter( string $filter )

Метод filter() принимает один обязательный параметр:

• $filter (string) — Тип фильтра. Принимает значения: ‘edit’, ‘db’, ‘display’, ‘attribute’, ‘js’, ‘rss’ или ‘raw’.

$filter (string) — Обязательный. Контекст фильтра. Принимает значения: ‘edit’, ‘db’, ‘display’, ‘attribute’, ‘js’, ‘rss’ или ‘raw’.

<?php
/**
 * Пример использования метода filter() класса WP_Term
 *
 * @param string $filter Тип фильтра. Принимает значения: 'edit', 'db', 'display', 'attribute', 'js', 'rss' или 'raw'.
 * @return string Санитизированное значение поля термина.
 */
$filter = 'edit';
$term = new WP_Term();
$filtered_value = $term->filter( $filter );
?>

get_instance()

Метод get_instance() класса WP_Term используется для получения экземпляра объекта WP_Term.

WP_Term::get_instance( int $term_id, string $taxonomy = null )

Метод get_instance() принимает два параметра:

• $term_id (обязательный) — идентификатор термина.
• $taxonomy (необязательный) — ограничивает поиск только терминами, соответствующими указанной таксономии. По умолчанию: null.

$term_id (int) — Обязательный. Идентификатор термина.

$taxonomy (string) — Необязательный. Ограничивает поиск только терминами, соответствующими указанной таксономии. Используется для разрешения потенциально общих терминов. По умолчанию: null.

Метод get_instance() возвращает объект WP_Term, если термин найден. Если $term_id используется в нескольких таксономиях и недостаточно данных для определения, какой термин требуется, возвращается объект WP_Error. В случае других ошибок возвращается false.

<?php
// Получение экземпляра объекта WP_Term с идентификатором 42
$term = WP_Term::get_instance( 42 );
if ( ! is_wp_error( $term ) ) {
    // Термин найден
    // Дальнейшие действия с объектом $term
} else {
    // Ошибка при получении термина
    $error_message = $term->get_error_message();
    // Обработка ошибки
}
?>

to_array()

Метод to_array() является частью класса WP_Term и используется для преобразования объекта в массив.

Метод выполняет преобразование объекта WP_Term в массив, что позволяет получить доступ к свойствам объекта в виде элементов массива.

WP_Term::to_array(): array

Данный код представляет собой вызов метода to_array() класса WP_Term и возвращает массив.

Метод to_array() не принимает никаких аргументов.

Преобразование объекта в массив осуществляется путем вызова метода to_array() на объекте WP_Term.

Метод to_array() возвращает массив, представляющий объект WP_Term в виде массива.

__construct()

Метод «__construct()» является конструктором класса «WP_Term». Он вызывается при создании нового объекта WP_Term и выполняет необходимую инициализацию.

WP_Term::__construct( WP_Term|object $term )

Конструктор принимает один обязательный параметр — объект WP_Term или объект, совместимый с WP_Term. Он используется для создания нового объекта WP_Term.

$term (обязательный): Объект WP_Term или объект, совместимый с WP_Term. Представляет термин, для которого создается объект WP_Term.

<?php
$term = new WP_Term( $term_object );
?>

В приведенном выше примере создается новый объект WP_Term с использованием объекта $term_object.

__get()

Метод «__get()» класса «WP_Term» является геттером (getter) и используется для получения значения свойства объекта WP_Term.

WP_Term::__get( string $key ): mixed

Метод «__get()» принимает один обязательный параметр:

• $key (string) — Название свойства, значение которого нужно получить.

Метод возвращает значение свойства объекта WP_Term, указанного в параметре $key.

<?php
// Создаем объект WP_Term
$term = new WP_Term();
// Получаем значение свойства 'name' объекта $term
$name = $term->__get('name');
// Получаем значение свойства 'taxonomy' объекта $term
$taxonomy = $term->__get('taxonomy');
?>

В данном примере мы создаем объект WP_Term и используем метод «__get()» для получения значений свойств ‘name’ и ‘taxonomy’ объекта $term.

$key (string) — Обязательный параметр, указывающий на свойство объекта WP_Term, значение которого нужно получить.

Метод «__get()» возвращает значение свойства объекта WP_Term, указанного в параметре $key. Тип возвращаемого значения может быть любым.

// Создание экземпляра WP_Term с помощью конструктора
$term = new WP_Term(123, 'category');

// Получение значения свойства name
$name = $term->name;

// Преобразование объекта WP_Term в массив
$array = $term->to_array();

// Санитизация поля description
$description = $term->filter('description');

// Получение экземпляра WP_Term по идентификатору
$term = WP_Term::get_instance(123, 'category');

$terms = get_terms( array(
    'taxonomy' => 'category',
) );
foreach ( $terms as $term ) {
    echo $term->name;
}

$new_term = wp_insert_term(
    'New Term',
    'category'
);
if ( ! is_wp_error( $new_term ) ) {
    echo 'Term added successfully.';
}

$term_id = 42;
$updated_term = wp_update_term(
    $term_id,
    'category',
    array(
        'name' => 'Updated Term',
    )
);
if ( ! is_wp_error( $updated_term ) ) {
    echo 'Term updated successfully.';
}

$term_id = 42;
$taxonomy = 'category';
$result = wp_delete_term( $term_id, $taxonomy );

$args = array(
    'tax_query' => array(
        array(
            'taxonomy' => 'category',
            'field'    => 'slug',
            'terms'    => 'term-slug',
        ),
    ),
);
$posts = get_posts( $args );

$post_id = 123;
$taxonomy = 'category';
$terms = wp_get_post_terms( $post_id, $taxonomy );

$terms = get_terms( array(
    'taxonomy' => 'category',
) );
if ( ! empty( $terms ) && ! is_wp_error( $terms ) ) {
    foreach ( $terms as $term ) {
        echo '<li>' . $term->name . '</li>';
    }
}

$term = get_term( $term_id, 'category' );
if ( ! is_wp_error( $term ) && $term->parent != 0 ) {
    $parent_term = get_term( $term->parent, 'category' );
    echo $parent_term->name;
}

$terms = get_terms( array(
    'taxonomy' => 'category',
    'child_of' => $parent_term_id,
) );
if ( ! empty( $terms ) && ! is_wp_error( $terms ) ) {
    foreach ( $terms as $term ) {
        echo '<li>' . $term->name . '</li>';
    }
}