# WP_Term: Объект термина в WordPress
WP_Term — это основной класс, который используется для работы с объектами термина в WordPress.
## Для чего используется WP_Term?
Класс WP_Term помогает управлять терминами, такими как категории и метки. Вы можете получать информацию о терминах и работать с ними на своем сайте.
## Как использовать WP_Term
Чтобы использовать класс WP_Term, вы можете создать новый объект следующим образом:
```php
$term = new WP_Term();
После этого вы можете использовать методы класса для выполнения различных операций с терминами.
Методы класса
Вот основные методы, которые предоставляет класс WP_Term:
-
public __construct( $term )
- Конструктор объекта, который задает параметры термина.
-
public __get( $key )
- Позволяет получать значения свойств объекта по его имени.
-
public filter( $filter )
- Очищает поля термина в зависимости от типа фильтра.
-
public static get_instance( $term_id, $taxonomy = null )
- Получает экземпляр термина по его ID и таксономии.
-
public to_array()
- Преобразует объект термина в массив.
Примеры использования
Получение термина по ID
$term = WP_Term::get_instance( 37, 'category' );
При успешном выполнении вы получите объект WP_Term, содержащий данные о термине:
WP_Term Object
(
[term_id] => 37
[name] => Code
[slug] => codex
[term_group] => 0
[term_taxonomy_id] => 37
[taxonomy] => category
[description] =>
[parent] => 3
[count] => 19
[filter] => raw
)
Если термина с такими параметрами не существует, метод вернёт false
.
Пример с неве��ным именем термина
$term = WP_Term::get_instance( 'codex', 'category' ); // Вернет false
$term = WP_Term::get_instance( 'code', 'category' ); // Вернет false
Структура класса WP_Term
Вот основные свойства класса WP_Term:
- term_id: ID термина (целое число).
- name: название термина (строка).
- slug: уникальный идентификатор термина (строка).
- term_group: ID группы термина (целое число).
- term_taxonomy_id: ID таксономии термина (целое число).
- taxonomy: имя таксономии (строка).
- description: описание термина (строка).
- parent: ID родительского термина (целое число).
- count: количество объектов, связанных с этим термином (целое число).
- filter: уровень очистки объекта термина (строка).
Пример конструктора
public function __construct( $term ) {
foreach ( get_object_vars( $term ) as $key => $value ) {
$this->$key = $value;
}
}
Этот метод позволяет инициализировать объект WP_Term значениями из другого объекта термина.
Пример метода filter
public function filter( $filter ) {
sanitize_term( $this, $this->taxonomy, $filter );
}
С помощью этого метода можно очищать поля термина в зависимости от контекста.
Пример метода to_array
public function to_array() {
return get_object_vars( $this );
}
Данный метод преобразует объект термина в массив, что может быть удобным для дальнейшей работы с данными.
Заключение
Класс WP_Term в WordPress предоставляет мощные инструменты для работы с терминами. Понимание его методов и свойств поможет вам более эффективно управлять терминами на вашем сайте.