Нужен простой, но полный пример добавления метабокса в таксономию

18

Теперь, когда вышел WordPress 4.4, мы можем начать использовать новые потрясающие мета-функции термина!

Тем не менее, кажется, нет простого руководства о том, как добавить базовое текстовое поле в таксономию. Я попытался приспособить это удивительное руководство Джастина Тэдлока к своим потребностям, удалив весь код, относящийся к палитре цветов, и заменил его простым полем ввода текста ... но он не работает.

Может ли кто-нибудь предоставить пример работающего кода? Без проверки данных, одноразовых номеров, палитр цветов ... просто минимальное текстовое поле, добавленное на страницу Добавить таксономию / Изменить таксономию.

Обновление: тем временем я сделал несколько вариантов этого фрагмента кода:

Добавить мета-поле термина в категорию :
https://gist.github.com/ms-studio/543a0f7dd8ac05ccf037

Добавьте мета-поле термина в тег публикации :
https://gist.github.com/ms-studio/2d78ad3839e05ece2e48

Добавьте мета-поле термина в пользовательскую таксономию :
https://gist.github.com/ms-studio/fc21fd5720f5bbdfaddc

Добавьте несколько мета-полей терминов в пользовательскую таксономию :
https://gist.github.com/ms-studio/aeae733f5fd9fc524bbc

Manu
источник
Пожалуйста, опубликуйте свой текущий фрагмент кода и как он не работает
Биргире
@birgire извините за то, что не опубликовал мой оригинальный код, но он был уже слишком испорчен, и я бы лучше начал с чистого примера.
Ману

Ответы:

13

Это добавит поле под названием «TERM META TEXT» в ваши категории. Я вытащил одноразовый номер, но я действительно думаю, что он должен вернуться. Кроме того, лучше иметь некоторую дезинфекцию, чем ничего. Этот пример включает в себя javascript и CSS-хуки, которые вам могут понадобиться или не понадобиться, но вы можете быстро увидеть, как все части идут вместе.

Наслаждайтесь!

// REGISTER TERM META

add_action( 'init', '___register_term_meta_text' );

function ___register_term_meta_text() {

    register_meta( 'term', '__term_meta_text', '___sanitize_term_meta_text' );
}

// SANITIZE DATA

function ___sanitize_term_meta_text ( $value ) {
    return sanitize_text_field ($value);
}

// GETTER (will be sanitized)

function ___get_term_meta_text( $term_id ) {
  $value = get_term_meta( $term_id, '__term_meta_text', true );
  $value = ___sanitize_term_meta_text( $value );
  return $value;
}

// ADD FIELD TO CATEGORY TERM PAGE

add_action( 'category_add_form_fields', '___add_form_field_term_meta_text' );

function ___add_form_field_term_meta_text() { ?>
    <?php wp_nonce_field( basename( __FILE__ ), 'term_meta_text_nonce' ); ?>
    <div class="form-field term-meta-text-wrap">
        <label for="term-meta-text"><?php _e( 'TERM META TEXT', 'text_domain' ); ?></label>
        <input type="text" name="term_meta_text" id="term-meta-text" value="" class="term-meta-text-field" />
    </div>
<?php }


// ADD FIELD TO CATEGORY EDIT PAGE

add_action( 'category_edit_form_fields', '___edit_form_field_term_meta_text' );

function ___edit_form_field_term_meta_text( $term ) {

    $value  = ___get_term_meta_text( $term->term_id );

    if ( ! $value )
        $value = ""; ?>

    <tr class="form-field term-meta-text-wrap">
        <th scope="row"><label for="term-meta-text"><?php _e( 'TERM META TEXT', 'text_domain' ); ?></label></th>
        <td>
            <?php wp_nonce_field( basename( __FILE__ ), 'term_meta_text_nonce' ); ?>
            <input type="text" name="term_meta_text" id="term-meta-text" value="<?php echo esc_attr( $value ); ?>" class="term-meta-text-field"  />
        </td>
    </tr>
<?php }


// SAVE TERM META (on term edit & create)

add_action( 'edit_category',   '___save_term_meta_text' );
add_action( 'create_category', '___save_term_meta_text' );

function ___save_term_meta_text( $term_id ) {

    // verify the nonce --- remove if you don't care
    if ( ! isset( $_POST['term_meta_text_nonce'] ) || ! wp_verify_nonce( $_POST['term_meta_text_nonce'], basename( __FILE__ ) ) )
        return;

    $old_value  = ___get_term_meta_text( $term_id );
    $new_value = isset( $_POST['term_meta_text'] ) ? ___sanitize_term_meta_text ( $_POST['term_meta_text'] ) : '';


    if ( $old_value && '' === $new_value )
        delete_term_meta( $term_id, '__term_meta_text' );

    else if ( $old_value !== $new_value )
        update_term_meta( $term_id, '__term_meta_text', $new_value );
}

// MODIFY COLUMNS (add our meta to the list)

add_filter( 'manage_edit-category_columns', '___edit_term_columns' );

function ___edit_term_columns( $columns ) {

    $columns['__term_meta_text'] = __( 'TERM META TEXT', 'text_domain' );

    return $columns;
}

// RENDER COLUMNS (render the meta data on a column)

add_filter( 'manage_category_custom_column', '___manage_term_custom_column', 10, 3 );

function ___manage_term_custom_column( $out, $column, $term_id ) {

    if ( '__term_meta_text' === $column ) {

        $value  = ___get_term_meta_text( $term_id );

        if ( ! $value )
            $value = '';

        $out = sprintf( '<span class="term-meta-text-block" style="" >%s</div>', esc_attr( $value ) );
    }

    return $out;
}

// ADD JAVASCRIPT & STYLES TO COLUMNS

add_action( 'admin_enqueue_scripts', '___admin_enqueue_scripts' );

function ___admin_enqueue_scripts( $hook_suffix ) {

    if ( 'edit-tags.php' !== $hook_suffix || 'category' !== get_current_screen()->taxonomy )
        return;

    // ADD YOUR SUPPORTING CSS / JS FILES HERE
    // wp_enqueue_style( 'wp-color-picker' );
    // wp_enqueue_script( 'wp-color-picker' );

    add_action( 'admin_head',   '___meta_term_text_print_styles' );
    add_action( 'admin_footer', '___meta_term_text_print_scripts' );
}

// PRINT OUR CUSTOM STYLES

function ___meta_term_text_print_styles() { ?>

    <style type="text/css">
        .column-__term_meta_text { background-color:rgb(249, 249, 249); border: 1px solid lightgray;}
        .column-__term_meta_text .term-meta-text-block { display: inline-block; color:darkturquoise; }
    </style>
<?php }

// PRINT OUR CUSTOM SCRIPTS

function ___meta_term_text_print_scripts() { ?>

    <script type="text/javascript">
        jQuery( document ).ready( function( $ ) {
             $input_field = $( '.term-meta-text-field' );
             // console.log($input_field); // your input field
        } );
    </script>
<?php }
jgraup
источник
Большое спасибо, это действительно полезно! Но при применении кода «как есть» я сталкиваюсь с одной проблемой: поле TERM META TEXT обновляется при изменении термина, но не сохраняется при его создании.
Ману
Я попробовал на другом тестовом сайте и увидел то же самое поведение - все работает нормально, за исключением того, что при создании термина метатекст не был сохранен. Я отключил одноразовую проверку внутри ___save_term_meta_text( $term_id )... и это решило проблему, метатекст теперь сохраняется при создании нового термина! Поэтому я принимаю ваш ответ, так как он содержит именно то, что мне нужно для начала.
Ману
1
Я просто понял, что вызвало проблему: одноразовый номер не был определен в ___add_form_field_term_meta_text()функции. После добавления все работает как положено.
Ману
1
Не нужно загрязнять дополнительными одноразовыми номерами, так как WP уже разместил некоторые. Просто делай check_admin_referer( 'add-tag', '_wpnonce_add-tag' );и check_admin_referer( 'update-tag_' . (int) $_POST['tag_ID'] )в 'edit_category'и 'category_category'действиях.
З. Златев
Стоит отметить, что в вашей ___register_term_meta_text()функции третий параметр устарел и заменен на массив. Вы должны будете использовать что-то вроде:$args = array( 'type' => 'string', 'description' => 'A text field', 'single' => 'false', 'sanitize_callback' => '___sanitize_term_meta_weare_product', 'auth_callback' => null, 'show_in_rest' => false, ); register_meta( 'term', '__term_meta_text', $args );
Frits