Функция add_term_meta() в WordPress: Обзор и Примеры

add_term_meta() — это функция в WordPress, которая добавляет новое метаполе к указанному термину. Метаполя терминов используются для хранения дополнительной информации о таксономиях, таких как категории, метки и пользовательские таксономии.

add_term_meta( $term_id, $meta_key, $meta_value, $unique )

• $term_id (int): ID термина, к которому добавляется метаполе.
• $meta_key (string): Уникальный ключ метаполя.
• $meta_value (mixed): Значение метаполя.
• $unique (bool, необязательный): Опциональный параметр, указывающий, следует ли предотвращать добавление дублирующихся значений. По умолчанию false.

Зачем использовать add_term_meta()?

1. Позволяет добавлять пользовательские данные к терминам, такие как изображения, описания и другие метаданные.
2. Помогает улучшить функциональность тем и плагинов, добавляя кастомные возможности и функции для таксономий.
3. Используется для управления таксономиями и добавления дополнительной информации для модерации и отображения.

Примеры использования

Добавление кастомного поля к термину

Добавим кастомное поле с уникальным ключом и значением к термину.

$term_id = 123; // ID термина
$meta_key = 'thumbnail_url';
$meta_value = 'https://example.com/image.jpg';

add_term_meta( $term_id, $meta_key, $meta_value );

Использование в темах и плагинах

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

Сохранение метаданных термина из формы

Рассмотрим пример, когда данные добавляются из формы в плагине или теме:

function save_custom_term_meta( $term_id ) {
    if ( isset( $_POST['custom_field'] ) ) {
        $custom_field_value = sanitize_text_field( $_POST['custom_field'] );
        add_term_meta( $term_id, 'custom_field_key', $custom_field_value );
    }
}
add_action( 'created_category', 'save_custom_term_meta' );
add_action( 'edited_category', 'save_custom_term_meta' );

Этот код сохраняет данные, отправленные из формы при создании или редактировании категории, в качестве кастомного поля у нового или отредактированного термина.

Добавление пользовательских настроек

Вы можете использовать add_term_meta() для добавления пользовательских настроек, таких как описание для отображения.

function set_term_description( $term_id, $description ) {
    add_term_meta( $term_id, 'custom_description', $description );
}

// Пример использования
set_term_description( 101, 'This is a custom description for the term.' );

Этот код добавляет кастомное поле с ключом ‘custom_description’ и значением ‘This is a custom description for the term.’ к термину с ID 101.

Заключение

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