WooCommerce tabanlı bir e-ticaret sitesi yönetiyorsanız, muhtemelen fark etmişsinizdir: Bir ürünü sildiğinizde, o ürüne ait fotoğraflar medya kütüphanenizde ve sunucunuzda kalmaya devam eder.

WordPress, güvenlik önlemi olarak (başka bir yerde kullanılıyor olma ihtimaline karşı) medya dosyalarını otomatik silmez. Ancak binlerce ürünün girip çıktığı, varyasyonlu ürünlerin olduğu sitelerde bu durum zamanla ciddi bir “dijital çöp” yığınına dönüşür. Hosting kotanız dolar, yedekleme boyutlarınız gereksiz yere şişer.

Bu yazımda, bir WooCommerce ürününü kalıcı olarak sildiğinizde, ona bağlı tüm görsellerin (öne çıkan görsel, galeri ve varyasyon resimleri) sunucudan da otomatik olarak nasıl silineceğini paylaşacağım.

Mantık Nasıl Çalışıyor? WordPress’in sunduğu before_delete_post kancasını (hook) kullanacağız. Bu kanca, bir içerik çöp kutusundan tamamen silinmeden hemen önce tetiklenir.

İşleyiş şöyle olacak:

1. Silinmekte olan içeriğin bir “Ürün” olup olmadığını kontrol et.
2. Ürünün Öne Çıkan Görselinin ID’sini al.
3. Ürünün Galeri Görsellerinin ID’lerini al.
4. Eğer ürün varyasyonlu ise, alt ürünleri (children) tara ve onlara atanmış görselleri bul.
5. Toplanan tüm görsel ID’lerini wp_delete_attachment fonksiyonu ile sunucudan kalıcı olarak sil.

Kod Parçası: Aşağıdaki kodu temanızın functions.php dosyasına veya kendi yazdığınız bir eklenti dosyasına ekleyebilirsiniz.

/**
 * WooCommerce Ürünü Silindiğinde Bağlı Görselleri de Siler
 */
add_action( 'before_delete_post', 'custom_delete_product_images', 10, 1 );

function custom_delete_product_images( $post_id ) {
    
    // 1. Sadece 'product' post tipi için çalış
    if ( 'product' !== get_post_type( $post_id ) ) {
        return;
    }

    // Görsel ID'lerini toplayacağımız dizi
    $attachment_ids = array();

    // 2. Ürünün Ana Görseli (Featured Image)
    $thumbnail_id = get_post_thumbnail_id( $post_id );
    if ( $thumbnail_id ) {
        $attachment_ids[] = $thumbnail_id;
    }

    // 3. Ürün Galerisi
    $gallery = get_post_meta( $post_id, '_product_image_gallery', true );
    if ( ! empty( $gallery ) ) {
        $gallery_ids = explode( ',', $gallery );
        $attachment_ids = array_merge( $attachment_ids, $gallery_ids );
    }

    // 4. Varyasyon Görselleri
    $product = wc_get_product( $post_id );
    
    if ( $product && $product->is_type( 'variable' ) ) {
        $children = $product->get_children();
        
        if ( ! empty( $children ) ) {
            foreach ( $children as $child_id ) {
                $child_thumbnail_id = get_post_thumbnail_id( $child_id );
                if ( $child_thumbnail_id ) {
                    $attachment_ids[] = $child_thumbnail_id;
                }
            }
        }
    }

    // 5. Tekrar eden ID'leri temizle ve Sil
    $attachment_ids = array_unique( $attachment_ids );

    foreach ( $attachment_ids as $attachment_id ) {
        // True parametresi dosyayı çöp kutusuna atmadan direkt sunucudan siler
        if ( $attachment_id ) {
            wp_delete_attachment( $attachment_id, true );
        }
    }
}

⚠️ Çok Önemli Uyarı Bu kod parçacığı “acımasızdır“. Ürünü sildiğiniz an resimleri de siler. Eğer sitenizde aynı görseli birden fazla üründe kullanıyorsanız (örneğin; ortak bir beden tablosu görseli, bir marka logosu vb.), bu kodu kullanmamalısınız.

Çünkü A ürününü sildiğinizde, o ortak görsel silineceği için B ürünündeki görsel de kırık (bozuk) görünecektir. Bu yöntem, her ürünün kendine has fotoğraflarının olduğu senaryolar için mükemmeldir.

Sonuç Bu basit fonksiyon sayesinde e-ticaret sitenizin veritabanını ve dosya sistemini temiz tutabilirsiniz. Özellikle 5.000+ ürünü olan ve sık sık ürün sirkülasyonu yaşayan mağazalarda bu işlem GB’larca yer tasarrufu sağlar.