WD Türkiye Adres — İl İlçe Mahalle Sokak Seçimi

WooCommerce ödeme ve hesap sayfalarında il → ilçe → mahalle → cadde/sokak zincirleme adres seçimi.
Otomatik posta kodu, canlı gönderi etiketi önizlemesi, mobil seçim paneli. Ücretsiz ve açık kaynak.

⬇️ Son sürümü indir (ZIP)  ·  Kurulum  ·  Özellikler  ·  SSS  ·  oblifex.com

[!TIP] Bu eklenti Oblifex tarafından ücretsiz sunulur. Eklenti WordPress'e kurulduğunda yeni sürümleri kendisi bulur: GitHub'da yayınlanan her sürüm, WordPress › Eklentiler ekranında normal bir güncelleme gibi görünür ve tek tıkla kurulur.

✨ Özellik isteği	Eklentide görmek istediğiniz her şeyi oblifex.com/ozellik-istegi üzerinden iletin. Öncelikli olarak değerlendirilir.
🛟 Destek	Kurulum, tema ve uyumluluk soruları: oblifex.com/destek
🔄 Güncellemeler	Otomatik. Elle denetlemek için Eklentiler ekranındaki Güncellemeleri denetle bağlantısını kullanın.
🧩 Özel geliştirme	Mağazanıza özel WordPress / WooCommerce çözümleri için oblifex.com

Neden?

Türkiye'de serbest metin adres alanı, kargo iadelerinin ve "adres bulunamadı" aramalarının başlıca kaynağıdır. Bu eklenti müşteriye adresini resmi adres kayıtlarından seçtirir: 81 il, 970 ilçe, 74.276 mahalle/köy ve 1.148.699 cadde/sokak eklentiyle birlikte gelir. Harici servis, API anahtarı veya aylık ücret yoktur.

Özellikler

• Zincirleme seçim: il → ilçe → mahalle → cadde/sokak; seçim yapıldıkça bir sonraki alan açılır
• Aranabilir listeler: Türkçe karakter duyarsız arama (cankaya → Çankaya), eşleşme vurgusu, tam klavye desteği
• Otomatik posta kodu: mahalle bazında
• Listede olmayan sokaklar için elle giriş seçeneği
• Kapı no, daire no, bina/site adı, kurye tarifi alanları (her biri ayarlardan açılıp kapatılabilir)
• Canlı gönderi etiketi önizlemesi
• Mobilde alttan açılan tam ekran seçim paneli
• Tema uyumu: otomatik açık/koyu, vurgu rengi ve köşe yuvarlaklığı ayarı
• Ödeme sayfası, farklı teslimat adresi ve Hesabım › Adresler
• Sunucu tarafı doğrulama: il-ilçe-mahalle-sokak tutarlılığı
• WooCommerce standart alanlarını da doldurur (state TR16, city, address_1/2, postcode) → kargo, e-fatura ve ödeme eklentileri (iyzico, PayTR vb.) ek ayar gerektirmez
• Sipariş detayında yapılandırılmış adres kutusu
• HPOS uyumlu
• Blok ödeme sayfasını tek tıkla klasik yapıya dönüştürme (yedekli, geri alınabilir)

Kurulum

Seçenek 1 — ZIP (önerilen)

1. Son sürümü indirin.
2. WordPress › Eklentiler › Yeni Ekle › Eklenti Yükle ile ZIP'i yükleyip etkinleştirin.
3. WooCommerce › Türkiye Adres sayfasını açın.
4. Ödeme sayfanız blok tabanlıysa Uyumluluk sekmesinden klasik yapıya dönüştürün.

Seçenek 2 — git

cd wp-content/plugins
git clone https://github.com/oblifex/wd-turkiye-adres.git

Güncellemeler her iki kurulumda da WordPress panelinden gelir. Deponun main dalı geliştirme sürümüdür; kararlı sürümler için Releases sayfasına bakın.

Gereksinimler

	En az
WordPress	6.0
WooCommerce	7.0 (HPOS destekli)
PHP	7.4, zlib etkin (gzdecode)
Ödeme sayfası	Klasik [woocommerce_checkout] — blok sayfa tek tıkla dönüştürülür

Ayarlar

WooCommerce › Türkiye Adres altında beş sekme:

Sekme	İçerik
Genel	Etkinleştirme, fatura/teslimat adresinde kullanım, otomatik ilerleme, anlık doğrulama, sokak modu
Alanlar	Kırsal birimler, kapı/daire zorunluluğu, bina ve tarif alanları, canlı etiket önizlemesi
Görünüm	Açık/koyu/otomatik tema, vurgu rengi, köşe, yoğunluk
Veri	Veri seti bilgisi, sokak önbelleği durumu ve temizleme
Uyumluluk	Ödeme sayfası yapısı, HPOS, blok → klasik dönüştürme

Sipariş meta anahtarları

Kargo ve muhasebe entegrasyonları için yapılandırılmış veriler siparişte saklanır:

_billing_wdta_il          _billing_wdta_ilce        _billing_wdta_mahalle
_billing_wdta_mahalle_ad  _billing_wdta_sokak       _billing_wdta_sokak_ad
_billing_wdta_kapi        _billing_wdta_daire       _billing_wdta_bina
_billing_wdta_tarif

Teslimat adresi için _shipping_ önekli eşdeğerleri vardır. _*_wdta_sokak boşsa sokak adı müşteri tarafından elle girilmiştir.

REST

GET /wp-json/wdta/v1/mahalle/{ilce_id}
GET /wp-json/wdta/v1/sokak/{ilce_id}/{mahalle_id}

SSS

Sokak listesi sunucumu yorar mı?

Hayır. Sokaklar ilçe bazında sıkıştırılmış dosyalarda tutulur; yalnızca seçilen mahallenin listesi açılıp uploads/wd-turkiye-adres altına önbelleğe yazılır.

Sokak listesi gelmiyor.

Sunucunuzda PHP zlib (gzdecode) etkin olmalıdır. Durumu Veri sekmesinden görebilirsiniz.

Kapı ve daire numaraları neden listeden seçilmiyor?

Kapı/daire için açık bir veri kaynağı bulunmadığından bu alanlar doğrulamalı metin alanıdır.

Yeni açılan sokaklar listede yok.

Adres verisi 2021 tarihlidir; listede olmayan sokaklar için elle giriş seçeneği bulunur. Daha güncel bir veri kaynağı bildirmek için özellik isteği açabilirsiniz.

Güncellemeler nasıl geliyor?

Eklenti, Update URI başlığı sayesinde bu deponun Releases sayfasını 12 saatte bir denetler ve yeni sürümü WordPress'in standart güncelleme akışına ekler. Eklentiler ekranındaki Güncellemeleri denetle bağlantısı denetimi hemen yapar. wordpress.org ile hiçbir bağlantısı yoktur.

Veri kaynakları

• emreuenal/turkiye-il-ilce-sokak-mahalle-veri-tabani — NVİ Adres Kayıt Sistemi dökümü, Nisan 2021, GPL-3.0
• serhatmorkoc/PTT-il-ilce-semt-mahalle-jsondata — PTT posta kodları, Kasım 2021

Katkı

Hata bildirimi ve PR'lar için CONTRIBUTING.md. Güvenlik açıkları için SECURITY.md. Değişiklikler: CHANGELOG.md.

Lisans

GPL-3.0-or-later © Oblifex

---

WordPress & WooCommerce için ücretsiz eklentiler, özel geliştirme ve destek — oblifex.com