| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Contacts (contacts)
• Website (website) • Discuss (mail) |
| Lines of code | 46 |
| Technical Name |
res_city_turkiye_data_kita |
| License | LGPL-3 |
| Website | https://kitayazilim.com |
| Versions | 16.0 17.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Contacts (contacts)
• Website (website) • Discuss (mail) |
| Lines of code | 46 |
| Technical Name |
res_city_turkiye_data_kita |
| License | LGPL-3 |
| Website | https://kitayazilim.com |
| Versions | 16.0 17.0 |
🇹🇷 Türkiye Semt - İlçe Bilgisi
Odoo İş Ortağı Kayıtları için Türkiye Semt/İlçe Modülü
Bu modül, Odoo'daki İş Ortağı (res.partner) kayıtlarında bulunan city (İlçe) alanı için Türkiye'ye özgü semt/ilçe seçeneklerini ekler ve seçilebilir hale getirir. Amaç, adres doğruluğunu artırmak ve Türkiye'ye özel adres girdilerini standardize etmektir.
✨ Özellikler
- 🏙️ Türkiye illeri ve ilçelerinin (semt/ilçe) listesini Odoo'ya yükler
- 📝 İş Ortağı formunda city alanına Türkiye içi semt/ilçe seçimi ekler
- 🇹🇷 Ülke = Türkiye olan adreslerde uygun ilçe listesinin kullanılmasını sağlar
- 🌐 Website ve contact/addresses görünümleriyle uyumludur
🧭 Kullanım
Modül yüklü olduğunda İş Ortağı (res.partner) formunda ülke "Türkiye" (TR) seçildiğinde city alanı Türkiye'ye özel semt/ilçe listesini sunar. İl seçimine bağlı filtreleme ve arama/otomatik tamamlama desteklenir.
- Adres formunda Country alanını "Türkiye" olarak seçin.
- İl (state/province) seçildikten sonra City (ilçe/semt) alanından uygun kaydı seçin.
- Toplu güncelleme için CSV import: data/res.city.csv kullanarak res.city kayıtlarını güncelleyin; eşlemelerde country_id='TR' ve state_id doğruluğuna dikkat edin.
- Web formları veya özel görünümler için city alanına domain ekleyerek yalnızca Türkiye kayıtlarında görünmesini sağlayabilirsiniz (ör. domain="[('country_id.code','=','TR')]").
📦 Bağımlılıklar
- base_address_extended Gelişmiş adres alanlarını kullanmak ve city alanının genişletilmesi için
- contacts İş Ortağı (res.partner) modelinde değişiklik yapabilmek için
- website Site üzerinde gösterim veya form kullanımı varsa uyumluluk için
📁 Veri Dosyaları
- data/res.city.csv - Türkiye illeri ve ilçelerinin esas veri kümesi (CSV)
- data/res_country_data.xml - Türkiye ülke kaydına ilişkin ek yapılandırmalar
- data/res_partner_data.xml - İş Ortağı kayıtlarında kullanılacak başlangıç verileri
🔧 Kurulum ve Kullanım Notları
- Modül kurulduktan sonra ülke alanı "Türkiye" olan kayıtlar city alanında ilgili ilçe/semt listesini otomatik olarak sunacaktır
- Veri güncelleme veya özelleştirme gerektiğinde data/res.city.csv dosyası düzenlenebilir
- Düzenleme sonrası modül verilerini tekrar içe aktarmak gerekebilir
- Büyük veri güncellemelerinde CSV içe aktarımı sırasında benzersiz anahtarlar ve kaynak kayıtların korunmasına dikkat edin
🛠️ Özelleştirme ve Geliştirme İpuçları
📝 Veri Normalizasyonu
İlçe isimlerini farklı yazım, harf ve karakter kurgularına göre normalize etmek istiyorsanız veriyi ön işleyip UTF-8 uyumluluğunu koruyun.
🌍 Yerelleştirme
Yerel isimlendirme ve çeviri için i18n çeviri dosyaları ekleyebilirsiniz.
🔍 Filtreleme
Eğer ilçe seçimi ülke dışındaki kayıtlarda da gösteriliyorsa, domain/filtreleme kuralları ekleyin (ör. country_id == 'TR').
📄 Telif ve Lisans
- Yazar: Kıta Yazılım
- Lisans: LGPL-3 (GNU Lesser General Public License v3 veya daha yeni)
- Web: https://kitayazilim.com
Please log in to comment on this module