WooCommerce Kurulumu: Sunucu, iyzico, PayTR ve Test
Yapay zeka destekli taslak; yayından önce baştan sona okunur ve iddialar birincil kaynaklara karşı kontrol edilir. İçerik üretim sürecimiz

WooCommerce kurulumu, WordPress yüklü bir sitede WooCommerce eklentisinin kurulup etkinleştirilmesi, kurulum sihirbazında mağaza bilgilerinin girilmesi, ardından ödeme, kargo, vergi ve yasal sayfa ayarlarının yapılmasıyla tamamlanır. Eklentiyi kurmak birkaç tıklamadır. Satışa hazır bir mağaza ise sunucu gereksinimlerinin karşılanmasını, iyzico ya da PayTR gibi bir ödeme modülünün bağlanmasını ve test siparişleriyle akışın denenmesini ister.
Bu sıralama önemlidir, çünkü WooCommerce'in kendisi ücretsiz ve açık kaynaklı olsa da mağazanın çalışması sunucuya, temaya ve eklentilere bağlıdır. Eklentiyi kurup ürün yüklemeye başlayan, ödeme modülünü en sona bırakan bir mağaza, ilk siparişte ödemenin alınmadığını ya da sipariş e-postasının gitmediğini fark eder. Aşağıdaki adımlar kurulumu sunucudan ilk test siparişine kadar sırayla ele alır.
WooCommerce kurulumundan önce sunucu ne istiyor?
WooCommerce kurulmadan önce sunucunun güncel WordPress, PHP ve veritabanı sürümlerini, HTTPS'i ve yeterli bellek sınırını desteklemesi gerekir. Bu koşullar karşılanmazsa mağaza çalışsa bile güvenlik açığı ve yavaşlık riski taşır.
WooCommerce'in sunucu gereksinimleri belgesi, WooCommerce 10.8 ve sonrası için şu koşulları sayar:
| Bileşen | Önerilen | Eski ortamda çalışan alt sınır |
|---|---|---|
| WordPress | 6.9 veya üstü | Belgede ayrıca belirtilmiyor |
| PHP | 8.3 veya üstü (8.4'e kadar test edilmiş) | PHP 7.4+ |
| Veritabanı | MySQL 8.0+ ya da MariaDB 10.6+ | MySQL 5.6+ ya da MariaDB 10.4+ |
| HTTPS | Destek gerekli | — |
| WordPress bellek sınırı | 256 MB veya üstü | — |
Belge eski sürümlerle ilgili açık bir uyarı da yapar: PHP 7.4 ve MySQL 5.6 gibi sürümlerle WooCommerce çalışabilir, ancak bu sürümlerin resmi destek süresi bitmiştir ve siteyi güvenlik açıklarına maruz bırakabilir. Sunucu olarak Apache ya da Nginx önerilir, ama PHP ve MySQL destekleyen her sunucu çalışır.
Hosting satın alınmadan önce bu tablo sağlayıcıya gönderilip yazılı onay alınabilir. Mevcut bir WordPress sitesine mağaza ekleniyorsa önce PHP sürümüne bakılır. PHP sürümünün panelden nasıl yükseltildiğini ve yükseltmeden önce neyin kontrol edildiğini WordPress PHP sürümü güncelleme adım adım verir.
WooCommerce nasıl kurulur?
WooCommerce, WordPress yönetim panelinde Eklentiler menüsünden aranıp kurulur ve etkinleştirilir. Etkinleştirmeden hemen sonra kurulum sihirbazı açılır.
WooCommerce'in kurulum ve kaldırma belgesindeki adımlar şöyledir:
- Eklentiler > Yeni Eklenti Ekle ekranına gidilir.
- "WooCommerce" aranır.
- Şimdi Kur'a tıklanır.
- Etkinleştir'e tıklanır ve kurulum sihirbazı açılır.
Belge, eklenti etkinleştirildiğinde siteye nelerin eklendiğini de sayar: siparişler ve ürünler için yeni menüler, özel içerik türleri ve sınıflandırmalar, yeni WooCommerce sayfaları, bileşenler ve kısa kodlar, mağaza yöneticisi ve müşteri kullanıcı rolleri. Bu liste, kurulumdan sonra sitenin yönetim panelinin neden değiştiğini açıklar.
Kurulumla ilgili bir ayrıntı daha önemlidir. Belgeye göre eklentiyi devre dışı bırakmak ve silmek veritabanındaki verileri kaldırmaz, bu ek bir adım ister. Bir deneme kurulumu yapılıp vazgeçilecekse veritabanında kalan tabloların ayrıca temizlenmesi gerekir. Deneme kurulumunu canlı site yerine bir test kopyasında yapmak bu sorunu baştan önler.
Eklentiden önce seçilmesi gereken bir parça daha vardır: tema. WooCommerce her WordPress temasıyla çalışır, ama ürün, sepet ve ödeme sayfalarının görünümü temanın bu sayfaları nasıl desteklediğine bağlıdır. Mağaza için seçilen temanın WooCommerce uyumluluğunu belirtmesi, mobilde ödeme sayfasını tek sütunda göstermesi ve güncel tutulması beklenir. Görsel olarak zengin ama ağır bir tema, ürün sayfasının mobilde geç açılmasına yol açabilir ve bu gecikme sepete ekleme adımını doğrudan etkiler. Tema kurulduktan sonra boş bir ürün sayfası, sepet ve ödeme sayfası telefonda açılıp bakılmalı, ürünler yüklenmeden önce bu üç sayfanın düzgün göründüğü doğrulanmalıdır. Sonradan tema değiştirmek, ürün açıklamalarındaki kısa kodların ve sayfa düzenlerinin yeniden elden geçirilmesini gerektirebilir.
Kurulum sihirbazında ne girilir?
Kurulum sihirbazında mağazanın adı, satılacak ürün ya da hizmet türü, mağazanın bulunduğu konum ve mağaza e-posta adresi girilir. Bu bilgiler sonradan WooCommerce ayarlarından değiştirilebilir.
WooCommerce'in kurulum sihirbazı belgesi akışı şöyle anlatır: etkinleştirmeden sonra "Set up my store" seçilerek rehberli kurulum başlar, istenirse atlanıp sonra dönülebilir. İlk ekranda iş yolculuğunuza en uygun seçenek (iş kurmak, zaten satış yapmak ya da bir müşteri için mağaza kurmak) seçilir. Ardından mağaza bilgileri girilir. Belgeye göre WooCommerce bu bilgilere dayanarak ödeme, kargo, vergi, pazarlama ve güvenlik gibi alanlarda ücretsiz özellikler önerebilir. Bu önerilerin seçimi kaldırılabilir ya da adım tamamen atlanabilir.
Sihirbazdaki önerileri olduğu gibi kabul etmek, siteye ihtiyaç duyulmayan eklentiler yükleyebilir. Türkiye'de satış yapacak bir mağazada yerel ödeme kuruluşunun modülü ayrıca kurulacağı için, sihirbazın önerdiği ödeme seçenekleri yerine hangi ödeme kuruluşuyla çalışılacağı önceden belirlenmelidir. Sihirbazdan sonra bir kurulum kontrol listesi görünür. Belgeye göre bu liste, mağazanın müşteri getirmeye ve sipariş almaya hazır olduğundan emin olmak için kalan adımları gösterir.
Mağaza ayarları hangi sırayla yapılır?
Mağaza ayarları genelden özele doğru yapılır: önce genel ayarlar (adres, para birimi), sonra vergi, kargo, ödeme ve e-posta bildirimleri. Bu sıra, sonraki ayarların öncekilere dayandığı için önemlidir.
| Sıra | Ayar | Kontrol edilecek nokta |
|---|---|---|
| 1 | Genel: mağaza adresi, satış yapılan ülkeler, para birimi | Para birimi Türk lirası, ondalık ayırıcı virgül |
| 2 | Ürünler: ölçü birimleri, stok yönetimi | Stok takibi açık mı, düşük stok eşiği |
| 3 | Vergi: fiyatlar KDV dahil mi hariç mi | Ürün sayfasında görünen fiyatın son fiyat olması |
| 4 | Kargo: bölgeler, yöntemler, ücretsiz kargo eşiği | Ödeme sayfasında doğru tutarın çıkması |
| 5 | Ödemeler: ödeme modülü, havale, kapıda ödeme | Test modunda başarılı ödeme |
| 6 | E-postalar: yeni sipariş, iptal, tamamlandı | Bildirimin spam klasörüne düşmemesi |
| 7 | Hesaplar ve gizlilik: misafir alışverişi, üyelik | Aydınlatma metni ve onay kutuları |
Vergi ayarı özellikle dikkat ister. Tüketiciye ödeme öncesinde mal veya hizmetin tüm vergiler dahil toplam fiyatının ve varsa nakliye ile teslim masraflarının bildirilmesi Mesafeli Sözleşmeler Yönetmeliği'nin ön bilgilendirme listesindedir. Fiyatı KDV hariç girip ödeme sayfasında vergi ekleyen bir kurulum bu bilginin geç verilmesine yol açabilir. Ön bilgilendirme formunun hangi alanları kapsadığını ön bilgilendirme formunun zorunlu olup olmadığını inceleyen yazı madde madde çıkarır.
iyzico WooCommerce kurulumu nasıl yapılır?
iyzico WooCommerce kurulumu, iyzico'nun WordPress eklenti dizinindeki modülünün kurulması, iyzico hesabındaki API bilgilerinin modül ayarlarına girilmesi ve önce test ortamında deneme yapılmasıyla yapılır.
iyzico WooCommerce modülünün eklenti dizinindeki sayfası, modülün iyzico entegrasyon ekibi tarafından geliştirilen açık kaynaklı bir WooCommerce modülü olduğunu yazar. Aynı sayfada gereksinimler PHP 7.4.33 ve üstü, cURL, WooCommerce 9.0.0 ve WordPress 6.6.2+ olarak verilir. Kurulum için iki yol gösterilir: ZIP dosyasını indirip WordPress eklenti yükleyicisinden kurmak ya da eklenti dizininde "iyzico WooCommerce" aratıp kurmak. Sayfa, modülün entegrasyon öncesi kapsamlı test için bir test ortamı (sandbox) sunduğunu ve taksitli ödeme desteği bulunduğunu da belirtir.
Burada iki belgenin sürüm bilgisi birlikte okunmalıdır. iyzico modülünün alt sınırı PHP 7.4.33'tür, WooCommerce'in kendi önerisi ise PHP 8.3 ve üstüdür. Modülün eski bir PHP sürümünde çalışabilmesi, sunucunun eski sürümde bırakılması için gerekçe değildir. Sunucu WooCommerce'in önerdiği sürüme göre hazırlanır, ödeme modülünün bu sürümle uyumlu olduğu test ortamında doğrulanır.
Ödeme kuruluşunun kendisiyle yapılacak üye işyeri başvurusu ayrı bir süreçtir ve modül kurulumundan önce tamamlanır. Bu başvurunun belge listesini ve ödeme kuruluşunun yetkisinin nasıl kontrol edildiğini sanal POS başvurusu için gerekenler tek tek sayar.
PayTR WooCommerce kurulumu nasıl yapılır?
PayTR WooCommerce kurulumu, PayTR eklentisinin kurulup etkinleştirilmesi, WooCommerce ödeme ayarlarında PayTR'nin açılması ve PayTR mağaza panelindeki API entegrasyon bilgilerinin girilmesiyle yapılır.
PayTR WooCommerce eklentisinin dizin sayfasında kurulum adımları şöyle verilir:
- İndirilen dosyadan çıkan klasör "/wp-content/plugins/" klasörüne kopyalanır.
- Eklentiler menüsünden PayTR WooCommerce eklentisi etkinleştirilir.
- WooCommerce menüsünden Ayarlar > Ödemeler sekmesi açılır.
- PayTR ödeme altyapısı etkinleştirilir, Yönet ya da Ayarla düğmesine tıklanır.
- Açılan sayfada gerekli düzenlemeler yapılır.
Sayfaya göre Mağaza No, Mağaza Parola ve Mağaza Gizli Anahtar alanlarının girilmesi zorunludur ve bu bilgiler PayTR Mağaza Paneli'ndeki Bilgi sayfasında, API Entegrasyon Bilgileri alanında bulunur. Gereksinim olarak WooCommerce eklentisiyle birlikte PayTR'de bir mağazanın bulunması gerektiği yazılıdır.
Mağaza gizli anahtarı, ödeme kuruluşuyla siteniz arasındaki güvenin dayandığı bilgidir. Bu anahtar ekran görüntüsüyle ya da düz metin e-postayla paylaşılmamalı, kurulumu yapan kişi değiştiğinde yenilenmelidir. Aynı kural iyzico'nun API anahtarları için de geçerlidir.
Kargo, iade ve yasal sayfalar nasıl bağlanır?
Kargo ayarı WooCommerce'te kargo bölgeleri ve her bölgeye tanımlanan yöntemlerle yapılır. İade ve yasal metinler ise ayrı sayfalar olarak oluşturulup ödeme adımına bağlanır.
Kargo tarafında iki yol vardır. Basit kurulumda sabit ücret, ücretsiz kargo eşiği ve mağazadan teslim gibi yöntemler tanımlanır, kargo etiketi kargo firmasının kendi panelinden alınır. Sipariş sayısı arttığında kargo firmasının WooCommerce modülü ya da bir kargo entegrasyon hizmeti kullanılır ve etiket, takip numarası doğrudan siparişe yazılır. Hangi aşamada entegrasyona geçileceğini kargo entegrasyonunun kurulum sırası adım adım gösterir.
Yasal sayfalar için WooCommerce bir taslak sunmaz, metinleri işletme hazırlar. En az şu sayfalar gerekir: mesafeli satış sözleşmesi, ön bilgilendirme formu, iade ve cayma koşulları, gizlilik ve kişisel verilerin işlenmesine ilişkin aydınlatma metni, çerez politikası. Cayma hakkını ayıplı maldan ayıran örnek maddeleri e-ticaret iade politikası hazır metin olarak verir. Bu metinler hukuki metindir. Şablon kullanılsa bile işletmenin kendi süreçleriyle uyumlu olup olmadığı kontrol edilmelidir.
Hangi eklentiler gerçekten gerekli?
Bir WooCommerce mağazasında gerekli eklentiler ödeme modülü, gerekiyorsa kargo modülü, yedekleme, güvenlik ve önbellek eklentisiyle sınırlı tutulabilir. Her ek eklenti, güncelleme yükü ve olası çakışma noktası demektir.
Kurulum sihirbazının önerdiği ücretsiz özellikler, tema ile birlikte gelen eklentiler ve "işe yarar" diye eklenen araçlar birkaç ay içinde onlarca eklentiye dönüşebilir. Eklenti sayısı tek başına bir sorun değildir, ama her eklentinin bir güncelleme döngüsü vardır ve bir eklentinin güncellemesi bazen başka bir eklentiyle çakışır. Mağazada bu durum ödeme sayfasının açılmaması ya da sepetin boşalması olarak görünür.
Pratik kural şudur: her eklenti için "bu eklenti kaldırılırsa ne bozulur?" sorusunun cevabı yazılı olmalıdır. Cevabı olmayan eklenti kaldırılabilir. Güncelleme sonrası bozulan bir eklentide önceki sürüme dönmek, WordPress eklenti güncelleme hatası çözümünün ilk adımıdır.
Test siparişi nasıl yapılır?
Test siparişi, ödeme modülü test modundayken gerçek bir müşteri gibi ürün seçilip sepete eklenmesi, ödeme yapılması ve sipariş sonrası her adımın kontrol edilmesiyle yapılır. Amaç ödemenin alındığını değil, siparişin baştan sona doğru işlendiğini görmektir.
Test listesi:
- Ürün sayfası: Fiyat, varyant seçimi ve stok durumu doğru görünüyor mu?
- Sepet: Kargo ücreti doğru hesaplanıyor mu, ücretsiz kargo eşiği çalışıyor mu?
- Ödeme sayfası: Ön bilgilendirme formu ve mesafeli satış sözleşmesi onay kutusuyla görünüyor mu?
- Ödeme: Test kartıyla ödeme başarılı oluyor mu, 3D doğrulama ekranı açılıyor mu?
- Sipariş kaydı: Sipariş yönetim panelinde doğru durumda görünüyor mu, stok düştü mü?
- E-postalar: Müşteriye ve mağazaya sipariş e-postası gitti mi, spam klasörüne düştü mü?
- İptal ve iade: Sipariş iptal edildiğinde stok geri geliyor mu, iade işlemi ödeme modülünden yapılabiliyor mu?
Dördüncü adımda doğrulama ekranı açılmıyorsa sorun ödeme kuruluşu ayarlarında ya da kart tarafındadır. Doğrulama hatalarının nedenlerini 3D Secure doğrulama hatası ayrı bir tabloda toplar. Altıncı adımda e-posta gitmiyorsa WordPress'in varsayılan e-posta gönderimi yerine bir SMTP ayarı gerekebilir.
Test siparişleri bittikten sonra ödeme modülü canlı moda alınır ve ilk gerçek sipariş küçük tutarlı bir ürünle tekrar denenir. Test modundan canlıya geçerken API bilgilerinin de canlı bilgilerle değiştirildiği unutulmamalıdır.
WooCommerce mi, hazır e-ticaret paketi mi?
WooCommerce, kendi sunucunuzda tam kontrol ve esneklik isteyen, güncelleme ve güvenlik bakımını üstlenebilecek ya da bir bakım hizmetine verebilecek mağazalar için uygundur. Hazır e-ticaret paketleri ise sunucu ve güncelleme işini sağlayıcıya bırakır, karşılığında esnekliği sınırlar.
| Ölçüt | WooCommerce | Hazır paket |
|---|---|---|
| Sunucu ve güncelleme | İşletmede ya da bakım hizmetinde | Sağlayıcıda |
| Özelleştirme | Eklenti ve kodla geniş | Paketin izin verdiğiyle sınırlı |
| Veri taşıma | Veritabanı sizde | Sağlayıcının dışa aktarma araçlarına bağlı |
| Maliyet yapısı | Hosting, tema, ücretli eklentiler, bakım | Aylık abonelik, bazen işlem komisyonu |
| Ödeme ve kargo modülleri | Eklentiyle | Pakette hazır ya da uygulama mağazasında |
Karar yalnızca kurulum günü verilmez, mağazanın sonraki yıllarını belirler. Ürün sayısı, beklenen trafik, ekibin teknik kapasitesi ve entegrasyon ihtiyacı bu kararın girdileridir. Altyapı seçiminin ölçütleri e-ticaret altyapısı seçimi için karar çerçevesinde ayrıntılı bir tabloyla durur. Altyapı seçiminden test siparişine kadar uzanan adımları tek bir planda toplayan iş, e-ticaret sitesi kurulumu olarak sunuluyor.
WooCommerce'i seçmenin bedeli, kurulumdan sonra başlayan bakım işidir. WordPress, WooCommerce, tema ve ödeme modülü ayrı ayrı güncellenir ve her güncellemeden önce yedek alınması gerekir. Bu iş takvime bağlanmadığında mağaza bir yıl sonra eski sürümlerle ve kapatılmamış açıklarla çalışır hâle gelir. Kurulum planına bakım takviminin de yazılması, WooCommerce'i doğru seçim yapan şeyin parçasıdır.
Sıkça Sorulan Sorular
WooCommerce kurulumu nasıl yapılır?
WordPress yönetim panelinde Eklentiler > Yeni Eklenti Ekle ekranında "WooCommerce" aranır, Şimdi Kur ve Etkinleştir'e tıklanır. Etkinleştirmeden sonra kurulum sihirbazı açılır ve mağaza adı, ürün türü, konum ve e-posta adresi girilir. Ardından vergi, kargo, ödeme ve e-posta ayarları yapılır, ödeme modülü bağlanır ve test siparişleriyle akış denenir.
WooCommerce ücretsiz mi?
WooCommerce eklentisinin kendisi WordPress eklenti dizininden ücretsiz kurulur. Bir mağazanın çalışması için ise hosting, alan adı, SSL, tema ve gerektiğinde ücretli eklentiler gerekir. Ödeme kuruluşları işlem başına komisyon alabilir. Bu yüzden WooCommerce'in ücretsiz olması, mağazanın maliyetsiz olduğu anlamına gelmez, maliyet kalemleri farklı yerlerde ortaya çıkar.
WooCommerce için hangi PHP sürümü gerekir?
WooCommerce'in sunucu gereksinimleri belgesi, WooCommerce 10.8 ve sonrası için PHP 8.3 ve üstünü önerir ve PHP 8.4'e kadar test edildiğini belirtir. Belgeye göre WooCommerce eski ortamlarda PHP 7.4 ve üstüyle de çalışır, ancak bu sürümlerin resmi destek süresi bitmiştir ve siteyi güvenlik açıklarına maruz bırakabilir. Sunucu önerilen sürüme göre hazırlanmalıdır.
iyzico ile PayTR aynı WooCommerce sitesinde kullanılabilir mi?
WooCommerce birden fazla ödeme yönteminin aynı anda açık olmasına izin verir ve iki modül ayrı eklentiler olarak kurulur. Ancak her iki ödeme kuruluşuyla ayrı üye işyeri sözleşmesi gerekir. İki modülün aynı anda çalıştığı bir kurulumda ödeme sayfasında müşteriye iki seçenek görünür. Bu durumda her modül test ortamında ayrı ayrı denenmeli ve çakışma olmadığı kontrol edilmelidir.
WooCommerce'i silmek ürünleri ve siparişleri siler mi?
WooCommerce'in kurulum ve kaldırma belgesine göre eklentiyi devre dışı bırakmak ve silmek, sitenin veritabanındaki verileri kaldırmaz. Bu verilerin silinmesi ek bir adım gerektirir ve belgenin kaldırma bölümünde anlatılır. Yani yanlışlıkla devre dışı bırakılan eklenti yeniden etkinleştirildiğinde ürünler ve siparişler geri gelir. Kalıcı silmeden önce mutlaka yedek alınmalıdır.