WooCommerce Özel Eklenti İçin Teknik Şartname

“WooCommerce'e API bağlanacak” cümlesi geliştirme için yeterli değildir. Hangi verinin hangi yönde, ne zaman ve hangi hata davranışıyla taşınacağı yazılmadığında proje sonunda çalışan ama işletilemeyen bir eklenti ortaya çıkabilir.

İlk bölüm: iş kuralını tanımlayın

Teknik çözümden önce “hangi olaydan sonra ne olmalı?” sorusu cevaplanmalıdır. Örneğin sipariş ödeme alınca ERP'ye mi gönderilecek, yoksa sipariş oluştuğu anda mı? ERP ürün kodu bulunamazsa sipariş duracak mı, uyarı mı üretilecek? İptal ve iade karşı sisteme nasıl yansıyacak?

Veri sözlüğü hazırlayın

Güvenlik maddeleri neleri kapsamalı?

Yönetim işlemlerinde yetki kontrolü ve nonce doğrulaması; dış veride tür kontrolü ve temizleme; ekrana veya loga yazılan çıktıda güvenli kaçış uygulanmalıdır. API anahtarları kaynak koda gömülmemeli, hassas bilgiler yönetici dışındaki kullanıcıya gösterilmemelidir. Webhook çağrılarında imza, zaman ve mükerrer istek kontrolü tasarlanmalıdır.

WooCommerce uyumluluğu nasıl yazılır?

• Desteklenecek WordPress, PHP ve WooCommerce sürüm aralığı
• High-Performance Order Storage uyumluluğu
• Klasik checkout ve gerekiyorsa Checkout Block desteği
• Tek veya çoklu para birimi ve vergi davranışı
• Abonelik, ön sipariş veya çoklu dil eklentileriyle sınırlar
• Cron ve Action Scheduler görevlerinin izlenmesi
• Güncelleme sonrası geriye dönük uyumluluk yaklaşımı

Kabul testleri örnekleri

Başarılı sipariş, eksik zorunlu alan, geçersiz anahtar, servis zaman aşımı, aynı webhook'un iki kez gelmesi, ürün eşleşmemesi ve kısmi iade ayrı ayrı test edilmelidir. Her senaryo için beklenen WooCommerce durumu, yönetici mesajı ve dış sistem kaydı yazılmalıdır.

Teslim ve destek koşulları

Kaynak kod, sürüm numarası, kurulum ve kaldırma davranışı, ayar ekranı açıklaması, test raporu ve üçüncü taraf bağımlılıkları teslim paketinde bulunmalıdır. Garanti süresi yeni özellik geliştirmeden ayrılmalıdır. WooCommerce ve WordPress eklenti geliştirme sayfası RentonDiji'nin uygulama kapsamını; sanal POS entegrasyonu sayfası ödeme özelindeki ihtiyaçları açıklar.

Özel ödeme eklentisi şartnamesinde bakım sınırı

Checkout tipi, hook/filter, log, iade, test, lisans ve WooCommerce sürüm desteği kabul ölçütleriyle yazılmalıdır.

Ödeme entegrasyonunda tarayıcıdaki başarı sayfası tek başına tahsilat kanıtı değildir. Sağlayıcı destekliyorsa sunucudan gelen imzalı callback/webhook doğrulanmalı, tutar ve sipariş kimliği eşleştirilmeli ve aynı bildirim tekrar geldiğinde işlem ikinci kez uygulanmamalıdır. Gizli anahtarlar istemci koduna veya herkese açık loglara yazılmamalıdır.

Test planı başarılı ödeme, doğrulama reddi, kullanıcı iptali, zaman aşımı, bağlantı kesintisi, çift bildirim, kuruşlu tutar, tam/kısmi iade ve manuel mutabakatı kapsar. WooCommerce sipariş notunda sağlayıcı işlem referansı bulunmalı; ancak kart, parola veya gereksiz kişisel veri yer almamalıdır.

Fiyat karşılaştırmasında komisyon dışında sabit ücret, taksit, yabancı kart, valör, erken ödeme, iade, ters ibraz, teknik destek ve bakım dikkate alınır. Hazır eklenti ile özel geliştirme aynı kapsam değildir. Checkout tipi, WooCommerce/PHP sürümü, iade desteği ve güncelleme sorumluluğu lisans satın alınmadan önce doğrulanmalıdır.

• Test ve canlı anahtarlarının ayrılması
• İmzalı bildirim ve tekil işlem
• Hata, iptal ve zaman aşımı senaryoları
• Tam/kısmi iade ile mutabakat
• Eklenti lisansı, sürüm ve bakım kapsamı

Sıkça sorulan sorular

Kod temaya yazılabilir mi?

İşletme mantığı temadan bağımsız bir eklentide tutulmalıdır.

Test senaryoları şartnamede olmalı mı?

Evet; hata, kesinti ve mükerrer işlem davranışı önceden tanımlanmalıdır.

Teslimde ne alınmalı?

Kaynak kod, belge, test sonucu, sürüm geçmişi ve bağımlılık listesi alınmalıdır.