WooCommerce Subscriptions 9.2.0 Analizi: Fiziksel Ürünlerde Proration, Güvenlik ve Mimari Değişiklikler

Abonelik tabanlı e-ticaret modelleri, düzenli nakit akışı ve yüksek müşteri sadakati sağlaması nedeniyle hem küresel pazarda hem de Türkiye'deki dijital ticaret ekosisteminde kritik bir yer tutmaktadır. WooCommerce ekosisteminin bu alandaki amiral gemisi olan WooCommerce Subscriptions eklentisi, 9.2.0 sürümü ile birlikte hem mağaza yöneticilerini hem de çekirdek eklenti geliştiricilerini doğrudan ilgilendiren önemli altyapı güncellemeleri sundu.

Bu büyük güncelleme; fiziksel ürünler için orantılama (proration) mekanizmasının genişletilmesinden yetkilendirme (capability) mimarisinin sıkılaştırılmasına, hediye aboneliklerin veri modelinden ödeme bayraklarının tutarlılığına kadar pek çok yapısal yeniliği beraberinde getiriyor. Bu teknik rehberde, WooCommerce Subscriptions 9.2.0 sürümünün getirdiği değişiklikleri, geliştirici seviyesinde kod örnekleriyle ve teknik SEO/altyapı etkileriyle inceliyoruz.

1. Fiziksel Ürünlerde Proration (Orantılama) Desteği

WooCommerce Subscriptions üzerinde paket yükseltme veya düşürme (upgrade/downgrade) süreçlerinde abonelik tutarının ve süresinin orantılanması geçmişten bu yana yalnızca sanal (virtual) ürünlerle sınırlandırılmıştı. Fiziksel abonelik kutuları, düzenli teslim edilen sarf malzemeleri veya donanım kiralama modelleri işleten mağazalar, ara dönem geçişlerinde manuel hesaplamalara ya da karmaşık ek eklentilere bağımlı kalıyordu.

9.2.0 sürümü ile birlikte bu kısıtlama resmen ortadan kaldırıldı. "Prorate Recurring Payment" ve "Prorate Subscription Length" ayarları artık fiziksel ürünleri de kapsayacak şekilde genişletildi.

Veritabanı ve Filtre Düzeyinde Neler Değişti?

Sistem ayarlarında depolanan opsiyonlar yeni değerler kabul etmektedir:

• woocommerce_subscriptions_apportion_recurring_price anahtarı artık physical-upgrade ve physical değerlerini alabilmektedir.
• woocommerce_subscriptions_apportion_length anahtarı ise physical opsiyonunu kabul etmektedir.

-upgrade son eki alan varyasyonlar yalnızca paket yükseltme işlemlerinde aradaki farkı orantılarken, salt physical tanımlaması hem yükseltme hem de düşürme yönündeki tüm geçişlerde devreye girer.

Geriye Dönük Uyumluluk (Rollback) Uyarısı: Eğer mağazanızı 9.2.0 sürümünden 9.1.0 veya daha eski bir sürüme düşürmeniz gerekirse, eski sürümler yeni veritabanı değerlerini tanımaz. Eski sürüm yönetim paneli kaydedildiğinde, tanımlanamayan bu opsiyonlar varsayılan olarak no değerine döner. Bu durum veri tabanında fatal error üretmese de abonelik kurallarınızın sessizce devre dışı kalmasına neden olabilir.

Aşağıdaki filtre kancaları mevcut imzasını korumakta olup, geliştiriciler özel iş kurallarını dinamik olarak bu kancalar üzerinden koşullandırabilir:

add_filter( 'wcs_switch_should_prorate_recurring_price', function( $should_prorate, $subscription, $item, $new_product_id ) {
    // Fiziksel ürünlerde özel kategori bazlı orantılama kuralı
    $product = wc_get_product( $new_product_id );
    if ( $product && ! $product->is_virtual() && has_term( 'premium-kutular', 'product_cat', $product->get_id() ) ) {
        return true;
    }
    return $should_prorate;
}, 10, 4 );

2. Güvenlik Mimarisi: Yetki (Capability) Kontrolleri ve Benzersiz Nonce Yapısı

E-ticaret platformlarında müşteri paneli güvenliği, oturum kaçırma ve CSRF (Cross-Site Request Forgery) açıklarına karşı en üst düzeyde korunmalıdır. 9.2.0 sürümü, abonelik satır öğelerinin (line items) kaldırılması ve yeniden abone olma mekanizmalarında kritik güvenlik yamaları barındırmaktadır.

Satır Öğesi Kaldırma ve Capability Denetimi

Geçmiş sürümlerde abonelik içerisindeki bir kalemin çıkarılması yetkilendirme açısından gevşek bir kontrole sahipti. wcs_can_items_be_removed( $subscription, $user_id = 0 ) fonksiyonu artık açık bir şekilde edit_shop_subscription_line_items yeteneğini denetlemektedir. Bu yetki yalnızca aboneliğin asıl sahibine (owner) verilmektedir.

• Hediye Alıcıları: Hediye olarak bir abonelik alan kullanıcılar artık "Hesabım" sayfasında satır öğesi silme aksiyonunu göremez ve tetikleyemez.
• Filtre Değişikliği: wcs_can_items_be_removed filtresi artık üçüncü parametre olarak $user nesnesini kabul eder. Mevcut filtreler yetkiyi daraltabilir ancak tek başına yetkisiz bir kullanıcıya silme hakkı tanıyamaz.
• Bağlamsız Çağrılar: WP-CLI, Cron görevleri veya kimlik doğrulaması yapılmamış REST API çağrılarında geçerli bir kullanıcı bulunmadığı durumlarda fonksiyon doğrudan false döner.

İşlem Bazlı (Action-Specific) Nonce Üretimi

Önceki sürümlerde satır öğesi silme ve tekrar abone olma (resubscribe) bağlantıları yalnızca abonelik kimliğine (subscription ID) bağlı ortak bir nonce paylaşıyordu. Bu durum, bir işlem için üretilen bağlantının başka bir işlem için yeniden oynatılmasına (replay attack) teorik olarak zemin hazırlıyordu.

9.2.0 ile birlikte her işlem kendi özel nonce değerini üretir (mint). Dolayısıyla silme işlemi için oluşturulmuş bir nonce, yeniden abone olma işlemi için doğrulanamaz. Ayrıca 9.2.0 öncesinde üretilmiş olan eski bağlantılar geçersiz kılınmıştır.

3. Manuel Yenileme Bayraklarındaki Mantıksal Çelişkinin Çözümü

WooCommerce Subscriptions ayarlarında yer alan iki temel bayrak arasında geçmişten gelen mantıksal bir çakışma bulunmaktaydı: "Turn off automatic payments" (Otomatik ödemeleri kapat) seçeneği, üst ayar olan "Accept Manual Renewals" (Manuel yenilemeleri kabul et) devre dışı olsa dahi aboneliği manuel yenileme moduna zorlayabiliyordu. Bu da müşterilerin yenileme yapamamasına veya ödeme ağ geçidinin kilitlenmesine yol açıyordu.

WCS_Manual_Renewal_Manager::is_manual_renewal_required() metodu güncellenerek artık her iki ayarın da açık olmasını zorunlu kılıyor. Mağazaların ödeme akışlarının kesintiye uğramaması adına, arka planda çalışan tek seferlik bir yükseltme rutini (upgrade routine) çelişkili durumda kalan sitelerde "Accept Manual Renewals" seçeneğini otomatik olarak aktif hale getirir.

4. Gifting (Hediye Abonelik) Mimarisi: Globalden Ürün Başına Geçiş

Abonelik hediye etme fonksiyonu, dönüşüm oranlarını artıran popüler bir özellik olmasına karşın küresel bir ayar olarak yönetildiğinde lojistik ve operasyonel zorluklar yaratıyordu. 9.2.0 sürümüyle birlikte mağaza genelindeki "Tüm ürünler için hediyeleşmeyi aç/kapat" mantığı kaldırıldı.

Artık hediye seçeneği ürün bazlı olarak _subscription_gifting meta anahtarı üzerinden kontrol edilmektedir:

• Ürün bazında etkinleştirme/kapatma imkanı tanınmıştır.
• Toplu düzenleme (bulk edit) arayüzüne hediye durumu eklenmiştir.
• Daha önce küresel olarak hediyeleşmeyi açık tutan mağazalar için arka plan veritabanı geçişi (migration) çalışarak mevcut ürünlere bu meta değerini işler.

Teknik SEO ve E-Ticaret Performansına Yansımaları

Bir e-ticaret sitesinde altyapı güncellemeleri doğrudan arama motoru optimizasyonunu ve Core Web Vitals metriklerini etkiler. Subscriptions 9.2.0 güncellemesinin teknik SEO boyutu göz ardı edilmemelidir:

1. Önbellek (Caching) Dinamikleri: Nonce yapısının işlem bazlı olarak özelleştirilmesi, "Hesabım" sayfalarındaki dinamik alanların önbellek stratejilerini doğrular niteliktedir. Dinamik parçaların (cart-fragments ve müşteri bazlı nonce'lar) doğru bypass kurallarıyla yönetilmesi, sayfa yanıt sürelerini (TTFB) optimize eder.
2. Veritabanı Yükü ve Arka Plan Görevleri: Hediyeleşme geçişi arka planda (Action Scheduler aracılığıyla) çalışır. Büyük envanterli sitelerde Action Scheduler tablolarının (wp_actionscheduler_actions) temiz ve optimize tutulması, sunucu CPU darboğazlarını engelleyerek tarama bütçesinin (crawl budget) verimli kullanılmasını sağlar.
3. URL ve Yönlendirme Bütünlüğü: Eski silme bağlantılarının geçersiz kalması, arama motorlarının dizine eklememesi gereken işlem URL'lerinin (noindex veya disallow ile korunması gereken parametreler) güvenliğini artırır.

Kaynak: WooCommerce Devs - https://developer.woocommerce.com/2026/09/08/wc-subscriptions-9-2-0/