چرا متاباکس شما ذخیره نمی‌شود؟ راهنمای تخصصی add_meta_box

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

تابع add_meta_box چیست؟

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

function add_meta_box( $id, $title, $callback, $screen = null, $context = 'advanced', $priority = 'default', $callback_args = null ) {
    // ...
}

هوک add_meta_boxes و زمان فراخوانی

add_action( 'add_meta_boxes', 'myplugin_register_meta_boxes' );
function myplugin_register_meta_boxes() {
    add_meta_box(
        'myplugin_product_details',
        'جزئیات محصول',
        'myplugin_render_product_details_box',
        'product',
        'normal',
        'high'
    );
}

پارامتر screen و انتخاب پست تایپ

add_meta_box(
    'myplugin_seo_box',
    'تنظیمات سئو',
    'myplugin_render_seo_box',
    array( 'post', 'page' ),
    'normal'
);

پارامتر context و موقعیت نمایش

callback و ساخت فرم

function myplugin_render_product_details_box( $post ) {
    wp_nonce_field( 'myplugin_product_details', 'myplugin_product_details_nonce' );

    $price = get_post_meta( $post->ID, '_myplugin_price', true );
    $sku   = get_post_meta( $post->ID, '_myplugin_sku', true );
    ?>
    <div class="myplugin-fields">
        <p>
            <label for="myplugin_price">قیمت:</label>
            <input type="number" id="myplugin_price" name="myplugin_price"
                   value="<?php echo esc_attr( $price ); ?>" step="0.01">
        </p>
        <p>
            <label for="myplugin_sku">شناسه کالا:</label>
            <input type="text" id="myplugin_sku" name="myplugin_sku"
                   value="<?php echo esc_attr( $sku ); ?>">
        </p>
    </div>
    <?php
}

ذخیره متادیتا با save_post

add_action( 'save_post', 'myplugin_save_product_details', 10, 2 );
function myplugin_save_product_details( $post_id, $post ) {
    if ( ! isset( $_POST['myplugin_product_details_nonce'] ) ) {
        return;
    }

    $nonce = sanitize_text_field( wp_unslash( $_POST['myplugin_product_details_nonce'] ) );

    if ( ! wp_verify_nonce( $nonce, 'myplugin_product_details' ) ) {
        return;
    }

    if ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) {
        return;
    }

    if ( wp_is_post_revision( $post_id ) ) {
        return;
    }

    if ( ! current_user_can( 'edit_post', $post_id ) ) {
        return;
    }

    if ( isset( $_POST['myplugin_price'] ) ) {
        $price = (float) $_POST['myplugin_price'];
        update_post_meta( $post_id, '_myplugin_price', $price );
    }

    if ( isset( $_POST['myplugin_sku'] ) ) {
        $sku = sanitize_text_field( wp_unslash( $_POST['myplugin_sku'] ) );
        update_post_meta( $post_id, '_myplugin_sku', $sku );
    }
}

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

add_action( 'add_meta_boxes', 'myplugin_add_advanced_settings_box' );
function myplugin_add_advanced_settings_box() {
    add_meta_box(
        'myplugin_advanced',
        'تنظیمات پیشرفته',
        'myplugin_render_advanced_box',
        'post',
        'side',
        'default'
    );
}

function myplugin_render_advanced_box( $post ) {
    wp_nonce_field( 'myplugin_advanced', 'myplugin_advanced_nonce' );

    $featured = get_post_meta( $post->ID, '_myplugin_featured', true );
    $priority = get_post_meta( $post->ID, '_myplugin_priority', true );
    ?>
    <p>
        <label>
            <input type="checkbox" name="myplugin_featured" value="1"
                   <?php checked( $featured, '1' ); ?>>
            نمایش در بخش ویژه
        </label>
    </p>
    <p>
        <label for="myplugin_priority">اولویت:</label>
        <select id="myplugin_priority" name="myplugin_priority">
            <option value="low" <?php selected( $priority, 'low' ); ?>>پایین</option>
            <option value="normal" <?php selected( $priority, 'normal' ); ?>>عادی</option>
            <option value="high" <?php selected( $priority, 'high' ); ?>>بالا</option>
        </select>
    </p>
    <?php
}

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

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

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

ادامه مسیر