需要一个简单但完整的向分类法添加元框的示例


18

现在WordPress 4.4已经发布,我们可以开始使用新的了不起的术语meta函数!

尽管如此,似乎还没有关于如何向分类法添加基本文本字段的简单教程。我试图根据贾斯汀·塔德洛克(Justin Tadlock)的需要,改编了这个很棒的教程,删除了所有与颜色选择器有关的代码,并用一个简单的文本输入字段替换了它……但是它不起作用。

有人可以提供一个基本的工作代码示例吗?没有数据验证,随机数,颜色选择器...只是添加到“添加分类法/编辑分类法”页面中的最小文本框。

更新:同时,我对该代码段进行了一些修改:

将术语元字段添加到类别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


请发布您当前的代码段及其失败方式。
birgire 2015年

@birgire很抱歉没有发布我的原始代码,但是它已经太混乱了,我宁愿从一个干净的示例开始。
Manu 2015年

Answers:


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 }

非常感谢,这真的很有帮助!但是,按原样应用代码时,我遇到一个问题:修改术语时,TERM META TEXT字段会更新,但创建术语时不会保存。
Manu

我在另一个测试站点上进行了尝试,并看到了相同的行为–一切正常,除了在创建术语时不保存元文本。我在内部禁用了随机数验证___save_term_meta_text( $term_id )...并解决了这个问题,现在在创建新术语时会保存图元文本!因此,我接受您的回答,因为它提供了我入门所需的一切。
Manu 2015年

1
我只是了解导致问题的原因:___add_form_field_term_meta_text()函数中未定义随机数。添加后,所有工作均按预期进行。
Manu

1
由于WP已经放置了一些随机数,因此无需污染其他随机数。只是做check_admin_referer( 'add-tag', '_wpnonce_add-tag' );check_admin_referer( 'update-tag_' . (int) $_POST['tag_ID'] )'edit_category''category_category'行动。
Z. Zlatev

值得注意的是,在您的___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
By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.