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()?
- Позволяет добавлять пользовательские данные к терминам, такие как изображения, описания и другие метаданные.
- Помогает улучшить функциональность тем и плагинов, добавляя кастомные возможности и функции для таксономий.
- Используется для управления таксономиями и добавления дополнительной информации для модерации и отображения.
Примеры использования
Добавление кастомного поля к термину
Добавим кастомное поле с уникальным ключом и значением к термину.
$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() помогает создавать более функциональные и гибкие темы и плагины, улучшая управление таксономиями и пользовательский опыт на сайте.
