حذف دسته جمعی تصویر شاخص نوشته‌ها در وردپرس

اگه تعداد زیادی نوشته دارید، برداشتن تصویر شاخص از تک‌تک اون‌ها وقت زیادی می‌گیره. توی این آموزش یاد می‌گیرید چطور حذف دسته جمعی تصویر شاخص در وردپرس رو با یک کد کنترل‌شده انجام بدید. این روش فقط اتصال تصویر شاخص به نوشته رو برمی‌داره و فایل اصلی عکس رو توی کتابخانه رسانه نگه می‌داره.

قبل از اجرا، تفاوت برداشتن تصویر شاخص با پاک‌کردن فایل رسانه رو توضیح می‌دیم، از سایت نسخه پشتیبان می‌گیریم و محدوده نوشته‌ها رو مشخص می‌کنیم. بعد هم کد رو طوری اجرا می‌کنیم که فقط مدیر سایت بهش دسترسی داشته باشه، هر بار تعداد محدودی نوشته رو پردازش کنه، نتیجه حذف‌ها رو بشمره و اجازه اجرای هم‌زمان دو پردازش رو نده.

قبل از حذف دسته جمعی تصویر شاخص، این تفاوت مهم رو بدونید

برداشتن تصویر شاخص با حذف فایل از کتابخانه رسانه چه فرقی داره

وردپرس شناسه فایل انتخاب‌شده به‌عنوان تصویر شاخص رو داخل اطلاعات نوشته نگه می‌داره. وقتی این اتصال رو برمی‌دارید، نوشته دیگه تصویر شاخص نداره؛ ولی خود فایل، اندازه‌های ساخته‌شده از اون و اطلاعاتش توی کتابخانه رسانه باقی می‌مونن.

پاک‌کردن پیوست رسانه کار متفاوتی هست. تابع wp_delete_attachment() می‌تونه رکورد رسانه و فایل‌های مربوط به اون رو حذف کنه. اگه همون عکس داخل نوشته، برگه، محصول یا بخش دیگه‌ای استفاده شده باشه، حذف فایل ممکنه اون بخش‌ها رو هم خراب کنه. برای همین توی این آموزش از تابع امن‌تر delete_post_thumbnail() استفاده می‌کنیم.

این آموزش چه چیزی رو حذف می‌کنه و چه چیزی باقی می‌مونه

• اتصال تصویر شاخص از نوشته‌های منتشرشده برداشته می‌شه.
• فایل اصلی عکس و اندازه‌های ساخته‌شده از اون توی کتابخانه رسانه باقی می‌مونن.
• عکس‌هایی که داخل متن نوشته گذاشتید تغییر نمی‌کنن.
• تصاویر شاخص پیش‌نویس‌ها، برگه‌ها، محصولات و بقیه نوع‌های محتوا دست‌نخورده می‌مونن؛ مگر اینکه خودتون محدوده کد رو آگاهانه عوض کنید.

چه وقت‌هایی حذف دسته جمعی تصویر شاخص در وردپرس منطقیه

• وقتی می‌خواید قالب یا ظاهر نوشته‌ها رو عوض کنید: شاید طراحی جدید اصلاً از تصویر شاخص استفاده نکنه یا بخواید تصاویر رو دوباره انتخاب کنید.
• وقتی تصاویر شاخص اشتباه یا تکراری هستن: اگه درون‌ریزی یا یک فرایند خودکار عکس‌های اشتباهی تنظیم کرده، می‌تونید اتصال همه اون‌ها رو بردارید.
• وقتی می‌خواید تصاویر شاخص جدیدی جایگزین کنید: اول اتصال قبلی رو حذف می‌کنید و بعد تصاویر درست رو دستی یا با یک روش کنترل‌شده تنظیم می‌کنید.

چه وقت‌هایی بهتره تصاویر شاخص رو حذف نکنید

اگه فقط چند نوشته مشکل دارن، ویرایش دستی اون‌ها امن‌تره. همین‌طور اگه قالب، صفحه وبلاگ، شبکه‌های اجتماعی یا افزونه سئو از تصویر شاخص استفاده می‌کنه، حذف گروهی ممکنه ظاهر یا پیش‌نمایش لینک نوشته‌ها رو ناقص کنه. اول چند نوشته رو روی سایت آزمایشی بررسی کنید تا بدونید نتیجه دقیقاً چه شکلی می‌شه.

برای مشکل اندازه و برش تصویر چه راه بهتری دارید

اگه بعد از عوض‌کردن قالب، تصاویر کشیده، تار یا بدبرش‌خورده دیده می‌شن، معمولاً لازم نیست تصویر شاخص رو حذف کنید. قالب جدید ممکنه اندازه‌های متفاوتی بخواد و فایل‌های قدیمی هنوز با اون اندازه‌ها ساخته نشده باشن. در این شرایط، راهنمای حل مشکل بهم‌ریختگی تصاویر شاخص بعد از تغییر قالب وردپرس رو ببینید و اندازه‌های تصاویر رو دوباره بسازید.

کارهایی که باید قبل از حذف تصاویر شاخص انجام بدید

از پایگاه داده و پوشه uploads نسخه پشتیبان بگیرید

اتصال تصویر شاخص داخل پایگاه داده ذخیره می‌شه. پس برای برگردوندن اون اتصال‌ها، نسخه پشتیبان پایگاه داده ضروریه. از پوشه wp-content/uploads هم نسخه پشتیبان بگیرید تا اگه اشتباه دیگه‌ای پیش اومد، فایل‌های رسانه رو داشته باشید. فایل پشتیبان رو دانلود کنید و توی سایت آزمایشی بازیابی کنید تا مطمئن بشید نسخه سالمه و واقعاً برمی‌گرده.

اول عملیات رو روی سایت آزمایشی امتحان کنید

سایت آزمایشی یا Staging یک کپی غیرعمومی از سایتتونه که می‌تونید تغییرها رو بدون آسیب‌زدن به سایت اصلی روی اون امتحان کنید. اگه هاستتون امکان ساخت Staging داره، اول یک نسخه بسازید، کد رو همون‌جا اجرا کنید و چند صفحه مهم رو ببینید.

محدوده نوشته‌هایی که باید تغییر کنن رو مشخص کنید

قبل از اجرا مشخص کنید که می‌خواید تصویر شاخص همه نوشته‌های منتشرشده برداشته بشه یا فقط نوشته‌های یک دسته و چند شناسه مشخص. کد اصلی این آموزش فقط نوع محتوای post با وضعیت publish رو پردازش می‌کنه. یعنی پیش‌نویس‌ها، نوشته‌های خصوصی، نوشته‌های داخل زباله‌دان، برگه‌ها و محصولات ووکامرس وارد عملیات نمی‌شن.

روش امن حذف دسته جمعی تصویر شاخص در وردپرس

کد حذف اتصال تصویر شاخص چطور کار می‌کنه

کد زیر یک صفحه موقت به منوی «ابزارها» اضافه می‌کنه. هر بار که روی دکمه پردازش می‌زنید، حداکثر ۱۰۰ نوشته منتشرشده و دارای تصویر شاخص بررسی می‌شن. ابزار نتیجه هر حذف رو کنترل می‌کنه و تعداد حذف‌های موفق و ناموفق رو نشون می‌ده. برای بسته بعدی باید دوباره روی دکمه بزنید؛ پس مرورگر وارد زنجیره طولانی ریدایرکت‌ها نمی‌شه.

بررسی سطح دسترسی اجازه نمی‌ده کاربرهای عادی عملیات رو اجرا کنن. Nonce هم یک کد امنیتی موقته که به وردپرس کمک می‌کنه معتبر بودن درخواست رو بررسی کنه، ولی جای کنترل دسترسی مدیر رو نمی‌گیره. یک قفل کوتاه‌مدت هم جلوی شروع دو پردازش هم‌زمان رو می‌گیره.

کد رو کجا و چطور اجرا کنید

برای اینکه کد با به‌روزرسانی قالب از بین نره، اون رو به‌صورت یک افزونه موقت اجرا کنید. داخل کامپیوترتون پوشه‌ای با نام mihanwp-remove-featured-images بسازید. بعد داخلش فایلی با نام mihanwp-remove-featured-images.php بسازید و کل کد زیر رو در اون قرار بدید.

<?php
/**
 * Plugin Name: MihanWP Remove Featured Images
 * Description: Safely removes featured-image links from published WordPress posts without deleting media files.
 * Version: 1.1.0
 */

if ( ! defined( 'ABSPATH' ) ) {
    exit;
}

function mihanwp_rfi_add_tools_page() {
    add_management_page(
        'حذف گروهی تصویر شاخص',
        'حذف گروهی تصویر شاخص',
        'manage_options',
        'mihanwp-remove-featured-images',
        'mihanwp_rfi_render_page'
    );
}
add_action( 'admin_menu', 'mihanwp_rfi_add_tools_page' );

function mihanwp_rfi_get_stats() {
    return wp_parse_args(
        get_option( 'mihanwp_rfi_stats', array() ),
        array(
            'processed' => 0,
            'success'   => 0,
            'failed'    => 0,
        )
    );
}

function mihanwp_rfi_get_remaining_count() {
    $query = new WP_Query(
        array(
            'post_type'              => 'post',
            'post_status'            => 'publish',
            'posts_per_page'         => 1,
            'fields'                 => 'ids',
            'meta_key'               => '_thumbnail_id',
            'no_found_rows'          => false,
            'update_post_meta_cache' => false,
            'update_post_term_cache' => false,
        )
    );

    return (int) $query->found_posts;
}

function mihanwp_rfi_render_page() {
    if ( ! current_user_can( 'manage_options' ) ) {
        return;
    }

    $stats     = mihanwp_rfi_get_stats();
    $remaining = mihanwp_rfi_get_remaining_count();
    ?>
    <div class="wrap">
        <h1>حذف گروهی تصویر شاخص نوشته‌ها</h1>

        <p>این ابزار فقط اتصال تصویر شاخص نوشته‌های منتشرشده رو برمی‌داره و فایل‌های کتابخانه رسانه رو نگه می‌داره.</p>
        <p>
            حذف موفق: <strong><?php echo esc_html( $stats['success'] ); ?></strong> |
            حذف ناموفق: <strong><?php echo esc_html( $stats['failed'] ); ?></strong> |
            باقی‌مونده: <strong><?php echo esc_html( $remaining ); ?></strong>
        </p>

        <?php if ( 0 === $remaining ) : ?>
            <div class="notice notice-success">
                <p>نوشته منتشرشده‌ای با تصویر شاخص باقی نمونده. حالا نتیجه رو بررسی کنید و افزونه رو غیرفعال و حذف کنید.</p>
            </div>
        <?php else : ?>
            <form method="post" action="<?php echo esc_url( admin_url( 'admin-post.php' ) ); ?>">
                <input type="hidden" name="action" value="mihanwp_rfi_run">
                <?php wp_nonce_field( 'mihanwp_rfi_run_action', 'mihanwp_rfi_nonce' ); ?>
                <?php submit_button( 'پردازش بسته بعدی تا ۱۰۰ نوشته', 'primary' ); ?>
            </form>
        <?php endif; ?>
    </div>
    <?php
}

function mihanwp_rfi_run() {
    if ( ! current_user_can( 'manage_options' ) ) {
        wp_die( 'اجازه انجام این کار رو ندارید.' );
    }

    check_admin_referer( 'mihanwp_rfi_run_action', 'mihanwp_rfi_nonce' );

    if ( get_transient( 'mihanwp_rfi_lock' ) ) {
        wp_die( 'یک پردازش دیگه در حال اجراست. یک دقیقه صبر کنید و دوباره برگردید.' );
    }

    set_transient( 'mihanwp_rfi_lock', 1, MINUTE_IN_SECONDS );

    $post_ids = get_posts(
        array(
            'post_type'              => 'post',
            'post_status'            => 'publish',
            'posts_per_page'         => 100,
            'fields'                 => 'ids',
            'orderby'                => 'ID',
            'order'                  => 'ASC',
            'meta_key'               => '_thumbnail_id',
            'no_found_rows'          => true,
            'update_post_meta_cache' => false,
            'update_post_term_cache' => false,
        )
    );

    $stats = mihanwp_rfi_get_stats();

    foreach ( $post_ids as $post_id ) {
        $stats['processed']++;

        if ( delete_post_thumbnail( $post_id ) ) {
            $stats['success']++;
        } else {
            $stats['failed']++;
        }
    }

    update_option( 'mihanwp_rfi_stats', $stats, false );
    delete_transient( 'mihanwp_rfi_lock' );

    wp_safe_redirect( admin_url( 'tools.php?page=mihanwp-remove-featured-images' ) );
    exit;
}
add_action( 'admin_post_mihanwp_rfi_run', 'mihanwp_rfi_run' );

function mihanwp_rfi_cleanup() {
    delete_option( 'mihanwp_rfi_stats' );
    delete_transient( 'mihanwp_rfi_lock' );
}
register_deactivation_hook( __FILE__, 'mihanwp_rfi_cleanup' );

پوشه افزونه رو به فایل ZIP تبدیل کنید. بعد توی پیشخوان وردپرس به «افزونه‌ها ← افزودن افزونه تازه ← بارگذاری افزونه» برید، فایل ZIP رو انتخاب کنید و افزونه رو فعال کنید. حالا از منوی «ابزارها» روی «حذف گروهی تصویر شاخص» بزنید. بعد از کنترل دوباره نسخه پشتیبان، دکمه پردازش رو بزنید. پس از هر بسته، شمارنده‌ها رو ببینید و تا وقتی عدد باقی‌مونده صفر بشه، پردازش بسته بعدی رو خودتون شروع کنید.

چطور اجرای کد رو فقط به مدیر سایت محدود کنید

کد در دو نقطه قابلیت manage_options رو بررسی می‌کنه. این قابلیت معمولاً در اختیار مدیر سایت قرار داره و کنترل اصلی مجوز اجرای ابزار همینه. مسیر عملیات از هوک admin_post استفاده می‌کنه و Nonce هم معتبر بودن درخواست ارسال‌شده از فرم ابزار رو بررسی می‌کنه.

چطور جلوی اجرای هم‌زمان کد رو بگیرید

ابزار قبل از شروع هر بسته یک قفل موقت یک‌دقیقه‌ای می‌سازه. اگه همون لحظه فرم توی تب دیگه‌ای دوباره ارسال بشه، پردازش دوم شروع نمی‌شه. بعد از پایان بسته، قفل پاک می‌شه و می‌تونید بسته بعدی رو اجرا کنید.

بعد از اجرا چطور کد رو غیرفعال کنید

وقتی عدد باقی‌مونده به صفر رسید، چند نوشته و کتابخانه رسانه رو بررسی کنید. بعد به «افزونه‌ها ← افزونه‌های نصب‌شده» برید و افزونه «MihanWP Remove Featured Images» رو غیرفعال و حذف کنید. با غیرفعال‌کردن افزونه، شمارنده‌ها و قفل موقت هم پاک می‌شن؛ پس نصب دوباره افزونه با وضعیت تازه شروع می‌شه.

حذف تصویر شاخص فقط از نوشته‌های مشخص

اگه نمی‌خواید همه نوشته‌های منتشرشده تغییر کنن، قبل از ساخت فایل ZIP آرایه داخل get_posts() و آرایه داخل WP_Query رو به شکل یکسان محدود کنید. اگه فقط یکی از این دو بخش رو تغییر بدید، شمارنده باقی‌مونده با پردازش واقعی هماهنگ نمی‌مونه. اول نتیجه رو روی سایت آزمایشی ببینید.

محدود کردن عملیات به نوع محتوای نوشته

مقدار 'post_type' => 'post' یعنی فقط نوشته‌های معمولی بررسی می‌شن و مقدار 'post_status' => 'publish' محدوده رو به نوشته‌های منتشرشده محدود می‌کنه. برای یک نوع محتوای سفارشی باید post رو با نام فنی همون نوع محتوا عوض کنید. تا وقتی نام دقیق نوع محتوا و اثر این تغییر رو نمی‌دونید، این مقدار رو عوض نکنید.

حذف تصویر شاخص بر اساس دسته‌بندی

برای محدودکردن نوشته‌ها به یک دسته، خط category_name رو در هر دو آرایه و درست بعد از post_status بذارید. به‌جای news نامک واقعی دسته رو وارد کنید. نامک رو توی «نوشته‌ها ← دسته‌ها» می‌بینید.

array(
    'post_type'      => 'post',
    'post_status'    => 'publish',
    'category_name'  => 'news',
    // بقیه تنظیمات فعلی آرایه رو بدون تغییر نگه دارید.
)

حذف تصویر شاخص از چند نوشته انتخاب‌شده

برای پردازش چند نوشته مشخص، خط post__in رو در هر دو آرایه و درست بعد از post_status بذارید. عددها شناسه نوشته‌ها هستن. شناسه هر نوشته رو می‌تونید هنگام ویرایش اون، داخل نشانی مرورگر و بعد از post= ببینید.

array(
    'post_type'      => 'post',
    'post_status'    => 'publish',
    'post__in'       => array( 123, 456, 789 ),
    // بقیه تنظیمات فعلی آرایه رو بدون تغییر نگه دارید.
)

اگه فقط چند نوشته دارید، ویرایش دستی معمولاً ساده‌تره. نوشته رو باز کنید، پنل «تصویر شاخص» رو پیدا کنید، روی گزینه برداشتن تصویر بزنید و نوشته رو ذخیره کنید. برای آشنایی بیشتر با محیط ویرایش هم می‌تونید راهنمای تنظیمات ویرایش نوشته در وردپرس رو ببینید.

چطور مطمئن بشید تصاویر شاخص درست حذف شدن

1. شمارنده ابزار رو بررسی کنید. عدد باقی‌مونده باید صفر باشه. اگه عدد حذف ناموفق بیشتر از صفره، عملیات رو موفق فرض نکنید و قبل از ادامه، گزارش خطاهای وردپرس و دسترسی پایگاه داده رو بررسی کنید.
2. چند نوشته رو در بخش مدیریت بررسی کنید. چند نوشته قدیمی و جدید رو باز کنید. بخش تصویر شاخص باید خالی باشه و متن و عکس‌های داخل محتوا باید سر جاشون مونده باشن.
3. کتابخانه رسانه رو بررسی کنید. به «رسانه ← کتابخانه» برید و چند فایل قبلی رو پیدا کنید. فایل‌ها باید هنوز قابل مشاهده و بازشدن باشن.
4. صفحه‌های سایت و حافظه کش رو بررسی کنید. صفحه وبلاگ، دسته‌ها و چند نوشته رو در پنجره ناشناس مرورگر باز کنید. اگه هنوز تصویر قبلی دیده می‌شه، کش وردپرس، سرور یا CDN رو پاک کنید و دوباره صفحه رو ببینید.

برگرداندن تصاویر شاخص بعد از حذف دسته جمعی

بازیابی اتصال تصاویر با نسخه پشتیبان

مطمئن‌ترین راه برگشت، بازیابی پایگاه داده از نسخه پشتیبانیه که درست قبل از عملیات گرفتید. این کار تغییرهای بعد از زمان تهیه نسخه پشتیبان رو هم برمی‌گردونه؛ پس قبل از بازیابی، وضعیت سفارش‌ها، دیدگاه‌ها، کاربران و نوشته‌های تازه رو بررسی کنید. اگه سایت در این فاصله تغییر مهمی داشته، از پشتیبانی هاست یا یک متخصص وردپرس کمک بگیرید تا فقط داده‌های لازم بازیابی بشن.

چرا فایل‌های باقی‌مانده در کتابخانه رسانه خودکار برنمی‌گردن

باقی‌بودن فایل عکس به این معنی نیست که وردپرس می‌دونه اون عکس قبلاً به کدوم نوشته وصل بوده. با حذف متای _thumbnail_id این ارتباط از بین می‌ره. اگه نسخه پشتیبان پایگاه داده ندارید، باید تصاویر رو دوباره برای نوشته‌ها انتخاب کنید یا بر اساس اطلاعات قابل‌اعتماد خودتون یک فرایند جایگزینی بسازید.

اشتباه‌های رایج موقع حذف دسته جمعی تصویر شاخص

• حذف دائمی فایل رسانه به‌جای برداشتن تصویر شاخص: برای این هدف از wp_delete_attachment() استفاده نکنید، چون ممکنه خود فایل و اندازه‌های اون هم پاک بشن.
• قرار دادن کد بدون شرط در فایل functions.php: این فایل در درخواست‌های مختلف بارگذاری می‌شه و کد کنترل‌نشده ممکنه بارها اجرا بشه.
• ویرایش مستقیم قالب اصلی: به‌روزرسانی قالب می‌تونه تغییرتون رو پاک کنه. افزونه موقت این آموزش از کد قالب جداست.
• اجرای چند بسته در تب‌های مختلف: قفل موقت جلوی اجرای هم‌زمان رو می‌گیره، ولی بهتره صفحه ابزار رو فقط در یک تب باز نگه دارید.
• نادیده‌گرفتن شمارنده حذف ناموفق: صفرشدن تعداد باقی‌مونده به‌تنهایی کافی نیست. اگه حذف ناموفق ثبت شده، نتیجه رو بررسی کنید و بدون پیدا‌کردن علت، افزونه رو حذف نکنید.
• اجرای عملیات بدون نسخه پشتیبان: بدون نسخه پایگاه داده، برگردوندن ارتباط قبلی هر عکس با نوشته مربوط به خودش ساده نیست.
• حذف تصویر شاخص برای حل مشکل اندازه تصاویر: اگه مشکل فقط ابعاد یا برش عکسه، اول بازسازی اندازه تصاویر رو امتحان کنید.

جمع‌بندی

برای حذف دسته جمعی تصویر شاخص در وردپرس لازم نیست فایل عکس‌ها رو از کتابخانه رسانه پاک کنید. روش امن‌تر اینه که فقط اتصال تصویر شاخص نوشته‌های موردنظرتون برداشته بشه. کد این آموزش همین کار رو در بسته‌های دستی ۱۰۰تایی انجام می‌ده، نتیجه حذف‌ها رو می‌شمره، دسترسی رو به مدیر محدود می‌کنه و جلوی اجرای هم‌زمان دو پردازش رو می‌گیره.

قبل از اجرا از پایگاه داده و پوشه uploads نسخه پشتیبان بگیرید، بازیابی نسخه رو روی سایت آزمایشی امتحان کنید و بعد از پایان، افزونه موقت رو حذف کنید. اگه هدفتون جایگزینی خودکار عکس‌های تازه‌ست، آموزش ساخت خودکار تصویر شاخص در وردپرس هم می‌تونه بهتون کمک کنه.

سؤالات متداول درباره حذف دسته جمعی تصویر شاخص در وردپرس

تیم تولید محتوا

ما در تیم تولید محتوای میهن وردپرس در تلاش هستیم تا بهترین مقالات آموزشی در زمینه وردپرس و کسب‌و‌کارهای اینترنتی را تهیه کنیم. صحت محتوای این صفحه توسط رضا راد بررسی خواهد شد.