> For the complete documentation index, see [llms.txt](https://docs.morpara.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.morpara.com/api-dokumantasyonu/gelistiriciaraclari/acik-kaynak-eklentiler/woocommerce.md).

# Woocommerce

[![WordPress Plugin Version](https://img.shields.io/badge/WordPress-6.0%2B-blue.svg)](https://wordpress.org/) [![WooCommerce](https://img.shields.io/badge/WooCommerce-7.0%2B-purple.svg)](https://woocommerce.com/) [![PHP Version](https://img.shields.io/badge/PHP-7.4%2B-777bb4.svg)](https://php.net/) ![License](https://img.shields.io/badge/license-MIT-blue.svg)

**WooCommerce için MorPOS**, Morpara MorPOS ödeme sistemini WooCommerce mağazalarıyla entegre eden güvenli ve kullanımı kolay bir ödeme geçidi eklentisidir.\
Müşteriler siparişlerini tamamlarken güvenli **Hosted Payment Page (HPP)** akışıyla yönlendirilir.

***

### 📥 Eklenti İndir

**MorPOS WooCommerce eklentisini Wordpress altyapınızda,   Eklentiler -> Yeni Ekle bölümünden "MorPOS WooCommerce" yazarak aratarak kurabilirsiniz.** \
**Manuel kurulum yapmak için aşağıdaki bağlantıdan indirebilirsiniz.**

[**Eklentiyi İndir**](https://github.com/morpara/morpos-woocommerce/archive/refs/heads/main.zip) ✅

> Not: ZIP dosyası WordPress yönetici paneli veya manuel kurulum için uygundur.

***

### ✨ Özellikler

* 🛒 WooCommerce Entegrasyonu
* 🔒 Güvenli Ödemeler (Hosted Payment Page)
* 🏗️ WooCommerce Blocks Desteği
* 🌍 Çoklu Para Birimi (TRY, USD, EUR)
* 💳 Çoklu Ödeme Seçenekleri (Kredi kartı, banka kartı, taksitli ödeme)
* 🧪 Sandbox Modu
* 🔧 Kolay Yapılandırma
* 🛡️ Güvenlik Özellikleri (TLS 1.2+, imzalı API iletişimi)

***

### 📋 Gereksinimler

#### Sunucu Gereksinimleri

| Bileşen     | Minimum | Önerilen |
| ----------- | ------- | -------- |
| WordPress   | 6.0     | 6.8+     |
| WooCommerce | 7.0     | 10.0+    |
| PHP         | 7.4     | 8.2+     |
| TLS         | 1.2     | 1.3      |

#### PHP Uzantıları

* `cURL`
* `json`
* `hash`
* `openssl`

#### WordPress Özellikleri

* WooCommerce kurulu ve aktif
* Pretty Permalinks aktif
* SSL sertifikası (üretim için önerilen)

***

### 🚀 Kurulum

#### WordPress.org Deposu

1. WordPress panel → **Eklentiler → Yeni Ekle**
2. "MorPOS for WooCommerce" arayın
3. **Şimdi Yükle → Etkinleştir**

#### WP-CLI

```bash
wp plugin install morpos-gateway --activate
```

#### Manuel Yükleme

1. ZIP dosyasını indirin: Eklentiyi İndir
2. WordPress → **Eklentiler → Yeni Ekle → Eklenti Yükle → Dosya Seç**
3. ZIP dosyasını seçin → **Şimdi Yükle → Etkinleştir**

***

### ⚙️ Yapılandırma

1. **WooCommerce → Ayarlar → Ödemeler → MorPOS**
2. Zorunlu alanları doldurun:

| Alan          | Açıklama               | Örnek                |
| ------------- | ---------------------- | -------------------- |
| Merchant ID   | Bayi kimliği           | 12345                |
| Client ID     | OAuth istemci kimliği  | your\_client\_id     |
| Client Secret | OAuth istemci şifresi  | your\_client\_secret |
| API Key       | API doğrulama anahtarı | your\_api\_key       |

3. **Ortam Ayarları**

* Test Modu: Sandbox kullanır, gerçek işlem yapılmaz
* Form Türü: `Hosted` (önerilen) veya `Embedded`

4. **Bağlantı Testi**

* Kimlik bilgilerini girdikten sonra **Bağlantıyı Test Et**
* Yeşil onay görünmeli

***

### 🛠️ Hata Ayıklama ve Loglar

```php
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
```

Loglar `/wp-content/debug.log` dosyasına yazılır.

#### Yaygın Sorunlar

* Ödeme başlatılamıyor → Kimlik bilgilerini kontrol edin, TLS 1.2+
* Ödeme işlenmiyor → Para birimi ve tutar limitlerini kontrol edin
* Ödeme sayfası hatası → Pretty permalink ve WooCommerce kurulumunu kontrol edin

***

### 🌐 Uluslararasılaştırma

* Türkçe (`tr_TR`) ve İngilizce (`en_US`) destekler
* WP-CLI ile POT ve JSON çeviri dosyaları oluşturulabilir

***

### 🤝 Katkıda Bulunma

1. Repository'yi Fork → Değişiklik yap → Pull request gönder
2. WordPress/WooCommerce uyumluluğunu test edin

***

### 📄 Lisans

MIT Lisansı. Detaylar için LICENSE

***

### 🆘 Destek

* Dokümantasyon
* [GitHub Issues](https://github.com/morpara/morpos-woocommerce/issues)
* [WordPress Destek Forumu](https://wordpress.org/support/plugin/morpos-gateway/)
* [Morpara Destek](https://morpara.com/support)