WooCommerce Türkiye Kurulum Rehberi

Giriş — neden Türkiye için özel kurulum?

WooCommerce dünyada en yaygın e-ticaret altyapısı; WordPress üzerinde çalışıyor, açık kaynak, son derece esnek. Türkiye’de de orta-büyük ölçekli e-ticaret operasyonlarında yaygın tercih. Ama global bir yazılımı Türkiye pazarına uyumlu çalıştırmak standart kurulumun ötesinde adımlar gerektiriyor.

Karşılaştığım en yaygın sorun şu: bir müşteri standart WooCommerce kurulumu yapıp aylarca uğraşıyor, sonra “neden bizde fatura kesimi otomatik değil, kargo entegrasyonu çakışıyor, ödeme bazen düşmüyor?” diye soruyor. Cevap basit: WooCommerce Türkiye’ye hazır gelmiyor. Bunlar ayrı kurulum adımları.

Bu rehber, geçen yıl 8 farklı WooCommerce kurulumunda yaptığımız işlerin damıtılmış hali. Hangi adım hangi sırada gelir, hangi tuzaklar var, hangi araçlar gerçekten işe yarıyor — pratik notlar.

Hosting seçimi

İlk karar hosting. Yanlış hosting seçimi ileride performans, güvenlik ve maliyet sorunlarına yol açıyor. Üç ana seçenek:

1. Yerel paylaşımlı hosting (Natro, GoDaddy.tr, Turhost vb.)

• Avantaj: ucuz (aylık 50-150 TL), kolay başlangıç
• Dezavantaj: performans sınırlı, büyüdükçe yetmiyor, eski PHP versiyonları yaygın
• Uygun: aylık <500 sipariş, yeni başlayan markalar

2. Cloud VPS / managed WordPress hosting (Cloudways, Kinsta, WP Engine)

• Avantaj: yüksek performans, otomatik backup, profesyonel destek
• Dezavantaj: daha pahalı (aylık $30-200), Türkiye’den biraz daha yüksek latency
• Uygun: aylık 500-5000 sipariş, ciddi büyüme planı olan markalar

3. Türkiye’de cloud (Atlas, Vargonen, GoldenHost)

• Avantaj: yerel latency düşük, Türkçe destek
• Dezavantaj: managed WordPress deneyimi global rakiplere göre daha az olgun
• Uygun: yerel SEO + kullanıcı deneyimi öncelikli markalar

PHP versiyonu kritik: WooCommerce 8.x için minimum PHP 7.4, ama 8.2+ %30-50 daha hızlı. Hosting seçerken eski PHP zorlama yapan firmalar kara liste.

Temel kurulum ve KDV ayarları

WordPress kurulduktan sonra WooCommerce eklentisini kurmak basit: WordPress Admin → Eklentiler → Yeni Ekle → “WooCommerce” ara → Kur → Etkinleştir.

Setup wizard sizi karşılıyor. Türkiye için kritik ayarlar:

1. Para birimi: Türk Lirası (TL) seçin. Sembol: ₺. Binlik ayraç: nokta (10.000), ondalık: virgül (10,50).

2. Vergi (KDV) ayarları:

• WooCommerce → Ayarlar → Vergi
• “Ürün fiyatları KDV dahil mi?” → Evet (Türkiye’de standart)
• KDV oranları: Standart %20, Yiyecek/içecek %1 veya %10 (kategoriye göre), Sağlık ürünleri %1 veya %10

3. Ürün fiyatları görünümü: “Mağazada KDV dahil göster, sepette KDV ayrı çıkar” konfigürasyonu en yaygın yaklaşım. Bu sayede müşteri net fiyatı görür, sepete eklediğinde fatura için KDV detay açılır.

4. Genel ayarlar:

• Konum: Türkiye, varsayılan müşteri konumu da Türkiye
• Ölçü birimleri: kg, cm
• Görsel ayarlar: ürün resmi 800×800px (büyütülürse 2400×2400px retina için)

Adres yapısı (il-ilçe-mahalle)

WooCommerce default checkout formu Türkiye’nin il-ilçe-mahalle hiyerarşisine uymuyor. Müşteri il adını manuel yazıyor, ilçe alanı serbest text — kargo entegrasyonu için kabus.

Çözüm: Türkiye il-ilçe-mahalle eklentisi. Birkaç seçenek var:

• WP Türkiye Adres Eklentisi (ücretsiz) — temel ihtiyaç
• Türkiye E-Ticaret Eklentileri Paketi (ücretli) — adres + e-fatura + kargo entegre
• Custom geliştirme — büyük projeler için, mevcut PostgreSQL/MySQL il-ilçe-mahalle veritabanı

Eklenti kurulumu sonrası test edin: 5 farklı il’den 5 farklı sipariş açın, kargo entegrasyonuna doğru veri gidip gitmediğini kontrol edin.

Sanal POS entegrasyonu

Türk bankalarına BKM uyumlu kart ödemesi alabilmek için sanal POS sağlayıcı gerekli. WooCommerce’in default ödeme modülü (Stripe, PayPal) Türkiye’de çalışmıyor.

Yaygın seçenekler:

iyzico

• BKM lisanslı, en yaygın tercih
• Resmi WooCommerce eklentisi var, hızlı kurulum
• Komisyon: ~%2.49 + 0.25 TL (sözleşmeye göre değişir)
• 3D Secure, taksit, geçici ödeme desteği
• Avantaj: stabil API, iyi dökümantasyon
• Dezavantaj: yüksek hacimlerde komisyon birikiyor

PayTR

• BKM lisanslı, fiyat avantajlı
• WooCommerce eklentisi mevcut
• Komisyon: ~%1.79 + 0.30 TL (genellikle daha düşük)
• Hızlı entegrasyon
• Avantaj: düşük komisyon, esnek paket
• Dezavantaj: bazı bankalarda 3D Secure issue raporları (geliştiriliyor)

Param POS

• Yeni nesil sağlayıcı, modern API
• Komisyon: orta seviye
• WooCommerce için 3rd party eklenti
• Avantaj: developer-friendly API
• Dezavantaj: pazar payı henüz daha düşük

Banka direkt entegrasyonu (Garanti, İş, Akbank vb.)

• Avantaj: en düşük komisyon
• Dezavantaj: kurulum ve sertifika süreci 2-4 hafta, sürekli teknik bakım gerekiyor
• Uygun: aylık 100K+ TL ciro, IT ekibi olan büyük markalar

Kurulum sonrası mutlaka 3D Secure test siparişleri yapın. Test kartlarıyla kart bilgisi yanlış / banka onayı reddi / başarılı ödeme senaryolarını deneyin.

E-fatura ve e-arşiv

Türkiye’de e-ticaret yapıyorsanız her sipariş için e-fatura veya e-arşiv kesimi yasal zorunluluk (vergi mükellefi olduğunuz varsayılarak). WooCommerce’in default fatura modülü bu işi yapmıyor — ayrı sistem gerekli.

Üç temel yaklaşım:

1. GİB Özel Entegratörü kullanma (Bir-Fatura, FaturaPort, Foriba)

• E-fatura kesimini doğrudan GİB’e iletiyor
• WooCommerce eklentisi mevcut
• Aylık 50-300 TL arası abonelik
• Avantaj: tam mevzuat uyumu, GİB’le direkt iletişim
• Dezavantaj: muhasebe kaydı ayrı yapılmalı

2. Muhasebe yazılımı + e-fatura modülü (Paraşüt, Logo, Mikro)

• Hem muhasebe hem e-fatura tek yerde
• Sipariş geldiğinde otomatik fatura + cari kayıt
• Aylık 200-1500 TL (paket büyüklüğüne göre)
• Avantaj: bütünleşik akış, raporlama kolay
• Dezavantaj: WooCommerce-muhasebe köprüsü gerekiyor (custom geliştirme veya 3rd party)

3. WooCommerce → muhasebe yazılımı köprüsü (custom veya 3rd party)

• Mevcut Paraşüt veya Bizim Hesap aboneliğiniz varsa, WooCommerce ile bu yazılım arasına bir köprü kurulur
• WooCommerce siparişi → köprü → ön muhasebe yazılımı (cari + fatura)
• Köprü için: WP eklentisi (varsa), 3rd party orchestration veya custom REST API geliştirmesi
• Avantaj: mevcut muhasebe yazılımınızı değiştirmeden devam edersiniz
• Dezavantaj: köprü katmanı bakım gerektirir, mevzuat değişikliklerinde güncellenmeli

KDV oranlarının doğru yansıması, vergi muafiyetli ürünler, indirim kuponlarının fatura üzerinde nasıl gösterileceği — bu detaylar muhasebeci ile birlikte çalışılarak ayarlanmalı. Yanlış yapılırsa SMM (Serbest Muhasebeci Mali Müşavir) düzeltme sürecine girer.

Kargo entegrasyonu

Sipariş geldiğinde manuel kargo etiketi basmak — günde 50+ siparişte sürdürülemez. WooCommerce için kargo entegrasyonu seçenekleri:

Aras Kargo: Resmi REST API + WordPress eklentisi mevcut. Kurulum 1-2 günde tamam. Sipariş onayı sonrası otomatik etiket basma + takip numarası WC’ye geri yazma.

Yurtiçi Kargo: Açık API var ama resmi WooCommerce eklentisi yok. Custom entegrasyon veya 3rd party eklenti (genelde ücretli) gerekiyor.

DHL Kargo (eski MNG): Mayıs 2025 itibarıyla DHL eCommerce çatısı altında. Yurt içi + uluslararası gönderim için tercih ediliyor; WC entegrasyonu 3rd party köprülerle veya custom REST API ile.

PTT Kargo: Fiyat avantajlı, geniş kapsama. Resmi WooCommerce eklentisi sınırlı, custom kurulum sıkça yapılıyor.

Sürat Kargo: API erişimi mevcut, custom entegrasyon. Hızlı dağıtım odaklı.

Hepsijet: Şehir içi hızlı teslimat. Hepsiburada Marketplace ekosistemi içinden veya custom kurulum.

Geliver / Kargonomi: Çoklu kargo orchestration platformları — tek arayüzden 5-10 kargo firmasını yönetiyor. Pratik, ama aylık abonelik ek maliyet.

Kargo seçimi sırasında adres doğruluğu kritik. İl-ilçe-mahalle eklentisi düzgün çalışmıyorsa kargo entegrasyonu da çakılıyor. İlk 1 ay tüm kargoları manuel kontrol edin, hata oranını ölçün.

SEO ve Core Web Vitals

WooCommerce sitesi yavaşsa Google sıralaması düşer, dönüşüm oranı azalır. Türkiye’de özellikle mobil performans kritik (trafiğin %70+‘i mobil).

Core Web Vitals (Google sıralama faktörü):

• LCP (Largest Contentful Paint): <2.5 saniye hedef. Hero görsel yüklenme süresi.
• INP (Interaction to Next Paint): <200ms. Kullanıcı tıklamasından sonraki tepki süresi (FID’in yerine geçti, 2024 mart).
• CLS (Cumulative Layout Shift): <0.1. Layout kaymaları (görsel yüklenirken sayfa zıplaması).

Performans için temel adımlar:

1. Cache eklentisi: WP Rocket (ücretli, en stabil) veya LiteSpeed Cache (LiteSpeed hosting’de ücretsiz). Page caching + browser caching + GZIP.

2. Görsel optimizasyon:

   • WebP formatı (eski JPEG’den %30-50 daha küçük)
   • Lazy loading (below-the-fold görseller)
   • Responsive srcset (farklı ekran boyutları için farklı boyut)
   • Eklenti: ShortPixel veya Imagify

3. CDN: Cloudflare ücretsiz paket Türkiye için yeterli. Türkiye’de de POP’u var (İstanbul). Static asset’ler edge’den serv edilir, latency düşer.

4. Database optimization: WP-Optimize ile aylık temizlik. Auto-draft’lar, transient’ler, eski revision’lar siteyi yavaşlatıyor.

5. PHP versiyonu: PHP 8.2+ kullanın. Hosting eski versiyonda kalmışsa zorlayın veya hosting değiştirin.

6. Eklenti audit: Aktif eklenti sayısı 20’den az olmalı. Her eklenti performans yüküdür. Query Monitor ile en yavaş eklentileri tespit edin.

SEO temel:

• Yoast SEO veya RankMath: meta title/description, sitemap, robots.txt yönetimi
• Schema.org markup: Product schema, Review schema, BreadcrumbList — Yoast/RankMath premium’da otomatik
• Türkçe URL yapısı: /urun-adi-12345 yerine /urun-adi/ (slug bazlı, kısa)
• Canonical URL: dublicate content önleme (kategori sayfalarında özellikle)

PageSpeed Insights ile aylık ölçüm yapın, Search Console’da Core Web Vitals raporunu izleyin. 3 aylık trend kritik — bir günlük rakam yanıltıcı olabilir.

Analytics ve tracking

Doğru veri olmadan kararlar tahmine kalır. Modern e-ticaret tracking stack’i:

Google Tag Manager (GTM): Tüm tracking script’lerini tek yerden yönet. WooCommerce için datalayer push’larını GTM Variables ile yapılandır.

Google Analytics 4 (GA4): Universal Analytics 2024 itibarıyla emekli. GA4 enhanced ecommerce events:

• view_item (ürün sayfası)
• add_to_cart, remove_from_cart
• begin_checkout
• purchase (en kritik, ROI ölçümü)

WooCommerce-GA4 entegrasyonu için GTM + custom datalayer veya MonsterInsights eklentisi. iOS 14 sonrası server-side tracking (Measurement Protocol API) önemli — istemci tarafı tracking %30-40’a kadar kayıp veriyor.

Meta Pixel + Conversions API (CAPI):

• iOS 14 ATT’den sonra istemci-side pixel data güvenilirliği düştü
• CAPI server-side event aktarımı zorunlu hale geldi
• WooCommerce için PixelYourSite veya Meta resmi eklenti

Microsoft Clarity / Microsoft Clarity: heatmap + session recording. Müşteri davranışı analizi için. Clarity ücretsiz, Microsoft Clarity daha gelişmiş.

Search Console: zorunlu. Sitemap ekle, Core Web Vitals takip et, indexlenme hatalarını gör.

Türkiye consent mode: GDPR + KVKK uyumu. CookieYes veya Complianz eklentisi ile cookie consent banner. Consent verilmeden GA4/Meta event göndermemek için consent mode v2 yapılandırması.

Bakım ve güvenlik

Kurulum bittikten sonra sürekli bakım süreç başlıyor. WordPress + WooCommerce ekosistemi yaygın olduğu kadar saldırı hedefi de.

Aylık rutin bakım:

1. WordPress core update (otomatik veya manuel)
2. WooCommerce update (önce staging’de test)
3. Tüm aktif eklenti update
4. Tema update
5. Database optimization (WP-Optimize)
6. Backup verification (yedeğin gerçekten alındığını test et)
7. Security scan (Wordfence veya Sucuri)
8. Broken link check (Broken Link Checker eklentisi)

Güvenlik temel:

• HTTPS zorunlu (Cloudflare ücretsiz SSL veya Let’s Encrypt)
• Wordfence Security: WAF + malware scan + brute force protection
• 2FA admin login: Wordfence veya Google Authenticator
• /wp-admin URL gizleme (WPS Hide Login eklentisi) — bot saldırılarını %90 azaltır
• Limit Login Attempts: brute force koruma
• Database prefix değiştirme: default wp_ yerine random prefix
• File permission’lar doğru: wp-config.php → 600, dizinler → 755, dosyalar → 644

Backup stratejisi:

• Tam site backup haftada 1 (UpdraftPlus veya BackWPup)
• Database backup günlük
• Backup’lar uzak depolamaya (S3, Dropbox, Google Drive) — sunucu çökerse kurtulabilmek için
• Aylık restore testi — yedeğin gerçekten çalıştığını doğrulamak için

Kurulum öncesi/sonrası checklist

Kurulum öncesi (1-2 hafta):

• Hosting seçimi yapıldı (PHP 8.2+, Redis cache desteği)
• Domain DNS ayarları (A record, MX record e-posta için)
• SSL sertifikası aktif
• Staging ortamı kuruldu (test için)
• Backup stratejisi belirlendi (3rd party storage dahil)
• Sanal POS sözleşmesi imzalandı (iyzico/PayTR)
• Muhasebe yazılımı / e-fatura entegratörü seçimi yapıldı
• Kargo firmaları için satıcı hesapları açıldı

Kurulum sırasında (2-4 hafta):

• WordPress + WooCommerce kurulumu
• Tema seçimi + özelleştirme
• KDV ayarları + para birimi
• Türkiye il-ilçe-mahalle eklentisi
• Sanal POS entegrasyonu + 3D Secure test
• E-fatura entegrasyonu + KDV doğrulama
• En az 1 kargo firması entegrasyonu
• Performans cache + CDN
• SEO eklentisi (Yoast/RankMath)
• GA4 + GTM + Meta Pixel CAPI
• Cookie consent (KVKK uyumu)
• Test siparişleri (5-10 farklı senaryo)
• 5 farklı il’den adres testi

Canlıya geçiş günü:

• DNS değişikliği (TTL kısaltılmış olmalı, 5 dk)
• HTTPS yönlendirme kontrol
• sitemap.xml Search Console’a gönder
• robots.txt kontrol (eski kalıntı yok)
• 301 redirect (eski siteden geliyorsanız) — URL haritası
• Test siparişi (canlıda)

İlk hafta:

• Günde 2x performans + uptime kontrol
• Hata loglarını izleme (Wordfence + sunucu logs)
• Müşteri geri bildirim toplama (anket veya e-posta)
• İlk sipariş hata oranını ölçme
• E-fatura otomasyon doğrulama

İlk ay:

• Aylık bakım rutini başlatıldı
• PageSpeed + Core Web Vitals raporu
• Search Console index doğrulama
• Müşteri-kargo problem analizi
• KPI dashboard kurulumu (sipariş, ciro, dönüşüm oranı)

WooCommerce kurulumu 6-8 haftalık ciddi bir proje. Hızlı yapmaya çalışmak ileride iki katı bedeli oluyor. Bu rehberdeki adımları sırayla, test ederek, doğru aracı seçerek uygulayın.

Sorularınız için iletişime geçebilirsiniz; mevcut kurulumlarınızda denetim isterseniz Code Review tarzı denetim hizmeti de veriyoruz.