created_(taxonomy)
Спрацьовує після додавання терміна (елемента таксономії).
У цьому хуку, наприклад, зручно зберігати метаполя терміна на сторінці створення терміна.
Динамічна частина імені хука $taxonomy — це ім’я (склад) таксономії, з якою ми працюємо.
Дивіться також ідентичний хук created_term , в якому назва таксономії передається в третьому параметрі, в іншому хук також працює.
Використання
add_action( 'created_(taxonomy)', 'wp_kama_created_taxonomy_action', 10, 2);
/**
* Function for `created_(taxonomy)` action-hook.
*
* @param int $term_id Term ID.
* @param int $tt_id Term taxonomy ID.
*
* @return void
*/
function wp_kama_created_taxonomy_action( $term_id, $tt_id ){
// action...
}- $term_id
(число) - ID терміна (елемента таксономії).
- $tt_id
(число) - Унікальний ідентифікатор терміна з урахуванням таксономії (в останніх версіях WordPress дорівнює ID терміну, докладніше в ”
Таксономії WordPress “).
Приклади
#1 Додамо довільне поле до форми створення терміну для таксономії (category)
add_action( 'category_add_form_fields', 'add_custom_form_field' );
// Додамо довільне поле у форму створення терміна
function add_custom_form_field( $term ) {
?>
<div class="form-field">
<label for="custom-field">
<?php _e( 'Custom field'); ?>
</label>
<input id="custom-field" type="text" name="custom_field" value="<?php esc_attr_e( get_term_meta( $term->term_id, 'custom_field', true ) ) ?>">
<p><?php _e( 'Custom field description'); ?></p>
</div>
<?php
}
add_action( 'created_category', 'save_custom_form_field');
// Збережемо значення довільно поля
function save_custom_form_field( $term_id ) {
if ( ! isset( $_POST['custom_field'] ) ) {
return;
}
if ( ! current_user_can( 'edit_term', $term_id ) ) {
return;
}
if ( ! wp_verify_nonce( $_POST['_wpnonce_add-tag'], 'add-tag' ) ) {
return;
}
update_term_meta( $term_id, 'custom_field', wp_unslash( $_POST['custom_field'] ) );
return $term_id;
}
список змін
| З версії 2.3.0 | Введено. |
Де викликається хук
created_(taxonomy)
wp-includes/taxonomy.php 2644
do_action( "created_{$taxonomy}", $term_id, $tt_id);Де використовується хук у WordPress
Використання не знайдено.