register_term_meta()
Реєструє метапол для зазначеної таксономії.
Це обгортка функції register_meta() , щоб зручніше та зрозуміліше було реєструвати метаполі для таксономії.
Щоб зробити те саме для типу запису, дивіться register_post_meta() .
Працює на основі:
register_meta()
register_meta()
1 раз – 0.000001 сек
(швидкість світла) | 50000 разів – 0.26 сек
(дуже швидко) |
PHP 7.1.11, WP 4.9.8
(швидкість світла) | 50000 разів – 0.26 сек
(дуже швидко) |
PHP 7.1.11, WP 4.9.8
Хуків немає.
Повертає
true|false.
true – якщо мета-ключ був успішно зареєстрований у глобальному масиві $wp_meta_keys .
false – якщо не вдалося зареєструвати ключ.
Використання
register_term_meta($taxonomy, $meta_key, $args);
- $taxonomy
(рядок) (обов’язковий) - Таксономія на яку реєструється метаполі. Надайте порожній рядок для реєстрації мета-ключа для всіх існуючих таксономій.
- $meta_key
(рядок) (обов’язковий) - Назва ключа, який потрібно зареєструвати.
- $args
(масив) (обов’язковий) Дані описують метаполі. За замовчуванням такі:
$ args = array ( 'type' => 'string', 'description' => '', 'single' => false, 'sanitize_callback' => null, 'auth_callback' => null, 'show_in_rest' => false, );
Опис кожного параметра дивіться у функції register_meta() .
Приклади
#1 Реєстрація метаполя для таксономії shelves
register_term_meta( 'shelves', 'my_meta_key', array( 'show_in_rest' => true, // Додамо у відповідь REST 'sanitize_callback' => 'absint', // Обробимо значення поля за збереження їх у базу, функцією absint() )));
Те саме можна зробити за допомогою register_meta() , так:
register_meta( 'term', 'my_meta_key', array( 'object_subtype' => 'shelves', // таксономія 'show_in_rest' => true, 'sanitize_callback' => 'absint', )));
список змін
| З версії 4.9.8 | Введено. |
Код register_term_meta() register term meta WP 6.0.2
function register_term_meta( $taxonomy, $meta_key, array $args ) {
$args['object_subtype'] = $taxonomy;
return register_meta( 'term', $meta_key, $args );
}