چرا تاکسونومی سفارشی شما در پنل ظاهر نمی‌شود؟ راهنمای register_taxonomy

چرا تاکسونومی سفارشی یک نیاز جدی است؟

تابع register_taxonomy چیست؟

امضای تابع و پارامترهای اصلی

function register_taxonomy( $taxonomy, $object_type, $args = array() ) {
    // ...
}

پارامتر labels و برچسب‌ها

$labels = array(
    'name'              => 'برندها',
    'singular_name'     => 'برند',
    'menu_name'         => 'برندها',
    'all_items'         => 'همه برندها',
    'add_new_item'      => 'افزودن برند جدید',
    'edit_item'         => 'ویرایش برند',
    'update_item'       => 'به‌روزرسانی برند',
    'search_items'      => 'جستجوی برندها',
    'not_found'         => 'برندی پیدا نشد',
    'parent_item'       => 'برند والد',
);

hierarchical و انتخاب ساختار

rewrite و ساختار URL

'rewrite' => array(
    'slug'         => 'brand',
    'with_front'   => false,
    'hierarchical' => false,
),

capability و کنترل دسترسی

'capabilities' => array(
    'manage_terms' => 'manage_categories',
    'edit_terms'   => 'manage_categories',
    'delete_terms' => 'manage_categories',
    'assign_terms' => 'edit_posts',
),

flush_rewrite_rules و زمان صحیح

register_activation_hook( __FILE__, 'myplugin_activate' );
function myplugin_activate() {
    myplugin_register_brand_taxonomy();
    flush_rewrite_rules();
}

هوک init و ترتیب ثبت

add_action( 'init', 'myplugin_register_brand_taxonomy' );
function myplugin_register_brand_taxonomy() {
    register_taxonomy( 'brand', array( 'post', 'product' ), array(
        // args
    ) );
}

کاربردهای عملی در افزونه

function myplugin_register_brand_taxonomy() {
    $labels = array(
        'name'          => __( 'برندها', 'myplugin' ),
        'singular_name' => __( 'برند', 'myplugin' ),
        'search_items'  => __( 'جستجوی برندها', 'myplugin' ),
        'all_items'     => __( 'همه برندها', 'myplugin' ),
        'edit_item'     => __( 'ویرایش برند', 'myplugin' ),
        'add_new_item'  => __( 'افزودن برند جدید', 'myplugin' ),
    );

    register_taxonomy( 'brand', array( 'product' ), array(
        'labels'            => $labels,
        'hierarchical'      => false,
        'public'            => true,
        'show_ui'           => true,
        'show_admin_column' => true,
        'show_in_rest'      => true,
        'rewrite'           => array(
            'slug'       => 'brand',
            'with_front' => false,
        ),
    ) );
}
add_action( 'init', 'myplugin_register_brand_taxonomy' );

$brands = get_the_terms( get_the_ID(), 'brand' );

if ( $brands && ! is_wp_error( $brands ) ) {
    echo '<ul class="brand-list">';
    foreach ( $brands as $brand ) {
        printf(
            '<li><a href="%s">%s</a></li>',
            esc_url( get_term_link( $brand ) ),
            esc_html( $brand->name )
        );
    }
    echo '</ul>';
}

نکات امنیتی و اشتباهات رایج

if ( ! taxonomy_exists( 'brand' ) ) {
    register_taxonomy( 'brand', array( 'product' ), $args );
}

تحلیل فنی پیشرفته

پرسش‌های پرتکرار

ادامه مسیر