NommoTech Adres Modülü, OpenCart tabanlı e-ticaret sistemlerinde adres yönetimini Türkiye’ye özel formatta yeniden tanımlar.
İl → İlçe → Mahalle → Sokak zincirini dinamik biçimde oluşturarak kullanıcıların adres girişini kolaylaştırır, veritabanı standardını korur ve yanlış adres girişlerini önler.
Modül; OpenCart varsayılan tema ve Journal3 Quick Checkout yapısıyla tam uyumlu olacak şekilde tasarlanmıştır.
Kayıt sayfası, misafir kargo adresi, ödeme adresi, adres düzenleme ekranı ve varsayılan checkout dahil olmak üzere tüm adres formlarında tek mantıkla çalışır.
Bu modül, herhangi bir hazır eklenti, framework veya üçüncü parti kod kullanılmadan tamamen sıfırdan geliştirilmiştir.
Tamamen özgün yapısı sayesinde sisteminize tam entegrasyon sağlar ve performans kaybı oluşturmaz.
Ayrıca modülün içinde yer alan “güncelleme bölümü” sayesinde, Türkiye genelindeki en güncel il, ilçe, mahalle ve sokak verilerini NommoTech lisans sunucusundan tek tıkla indirip sisteminize otomatik olarak entegre edebilirsiniz.
Bu sayede adres veritabanınız her zaman güncel kalır, manuel işlem gerektirmez.
Modül videosu: https://nommotech.com.tr/video.php

Teknik Özellikler

Zincirli Adres Yapısı:
İl seçildiğinde otomatik olarak ilgili ilçeler yüklenir.
İlçe seçildiğinde bağlı mahalleler, mahalle seçildiğinde sokaklar dinamik olarak çağrılır.
Tüm zincir verileri NommoTech adres veritabanı üzerinden alınır (oc_ilceler, oc_mahalleler, oc_sokaklar).

Akıllı address_2 Entegrasyonu:
Tüm adres bileşenleri (ilçe, mahalle, sokak) address_2 alanında kodlanmış olarak saklanır.
Böylece mevcut OpenCart eklentileri, ödeme modülleri veya kargo sistemleri hiçbir ek düzenleme gerektirmeden çalışır.
City alanı gizlenmiş olup, otomatik olarak seçilen ilçe adıyla doldurulur.

Tema ve Checkout Uyumluluğu:
OpenCart varsayılan tema adres formlarıyla birebir entegredir.
Journal3 Quick Checkout sayfasında Vue.js tabanlı dinamik yapıyla sorunsuz çalışır.
guest_shipping.twig, register.twig, checkout/payment_address.twig gibi tüm varyasyonlarda aynı zincir mantığı korunur.
Yeni alanlar eklense bile sistem otomatik senkronizasyonu sürdürür.

Lisans Kontrollü ve Güvenli Güncelleme Sistemi:
Modül, NommoTech Lisans Sunucusu ile entegre çalışır.
Yalnızca lisansı aktif domainler güncel SQL veya veri dosyalarını indirebilir.
İndirme işlemleri secure_download.php API’si üzerinden gerçekleşir ve tüm istekler loglanır.
Yetkisiz domainlerde lisans doğrulaması başarısız olur, sistem güvenliği korunur.

Otomatik SQL Güncelleme Paneli:
Modül yönetim ekranından tek tıkla tablo durumu sorgulanabilir.
Güncel SQL dosyası NommoTech sunucusundan güvenli bağlantı ile indirilir.
İndirme tamamlanınca otomatik olarak veritabanına uygulanır.
Kullanıcı hiçbir teknik bilgiye ihtiyaç duymadan taban güncellemesini gerçekleştirebilir.

Avantajlar

4 aşamalı adres zinciri: İl, ilçe, mahalle, sokak düzeyinde eksiksiz seçim

Lisans kontrollü yapı: Yalnızca onaylı domainlerde aktif çalışma

address_2 uyumluluğu: Tüm OpenCart modülleriyle doğal entegrasyon

SQL senkronizasyon sistemi: Otomatik indir-kur mantığıyla manuel işlem gerektirmez

Vue.js tabanlı dinamik yapı: Journal3 Quick Checkout ile canlı adres akışı

Varsayılan tema desteği: OpenCart çekirdek checkout ve kayıt formlarıyla birebir uyum

Lisans loglama: Her doğrulama ve indirme işlemi sunucuda kayıt altına alınır

Teknik Mimarisi

Uyumlu Sürümler: OpenCart 3.0.2.0 - 3.0.3.8
Backend: PHP 7.2+ (Hostinger, cPanel, Apache/Nginx ortamlarında test edilmiştir)
Frontend: Vue.js tabanlı reaktif yapı
Veritabanı: oc_ilceler, oc_mahalleler, oc_sokaklar
Lisans API: https://nommotech.com.tr/license_server.php

Güvenli indirme: secure_download.php (POST: domain + secret + file)

Kurulum ve Kullanım

Modülü yükleyip aktif hale getirin.

Yönetim panelinde Eklentiler → NommoTech Adres menüsüne gidin.

“Tabloları Kontrol Et” butonuyla sistemdeki tablo durumunu görün.

“SQL İndir” butonuna basarak lisans sunucusundan güncel dosyayı indirin.

“Güncelle” butonuyla veritabanı otomatik olarak yapılandırılsın.

Artık tüm adres formlarınızda İl → İlçe → Mahalle → Sokak zinciri aktif hale gelecektir.

Özet

NommoTech Adres Modülü, Türkiye adres yapısına özel geliştirilmiş, lisans kontrollü, güvenli ve tam entegre bir OpenCart eklentisidir.
Varsayılan tema ve Journal3 Quick Checkout yapılarıyla tam uyumluluk,
adres zincirlerini address_2 alanı üzerinden akıllıca yönetme
ve güvenli SQL güncelleme altyapısıyla sıfır bakım gerektiren kurumsal seviye bir çözüm sunar.

------
The NommoTech Address Module redefines address management in OpenCart-based e-commerce systems in a format specific to Turkey.
It dynamically creates a Province → District → Neighborhood → Street chain, simplifying user address entry, maintaining database standards, and preventing incorrect address entries.
The module is designed to be fully compatible with the OpenCart default theme and Journal3 Quick Checkout structure.
It operates with a single logic across all address forms, including the registration page, guest shipping address, payment address, address edit screen, and default checkout.
This module was developed entirely from scratch, without using any pre-built plugins, frameworks, or third-party code.
Its completely unique structure ensures full integration into your system and eliminates performance degradation.
Furthermore, thanks to the module's "update section," you can download the most up-to-date province, district, neighborhood, and street data from across Turkey from the NommoTech license server with a single click and automatically integrate it into your system.
This ensures your address database is always up-to-date, eliminating the need for manual intervention. Module video: https://nommotech.com.tr/video.php

Technical Specifications

Chained Address Structure:
When a province is selected, the relevant districts are automatically loaded.
When a district is selected, the connected neighborhoods are dynamically loaded, and when a neighborhood is selected, the streets are dynamically loaded.
All chain data is retrieved from the NommoTech address database (oc_districts, oc_mahalleler, oc_streets).

Smart address_2 Integration:
All address components (district, neighborhood, street) are stored encoded in the address_2 field.
This allows existing OpenCart plugins, payment modules, or shipping systems to work without any additional modifications.
The City field is hidden and automatically populated with the selected district name.

Theme and Checkout Compatibility:
Fully integrated with OpenCart's default theme address forms.
The Journal3 Quick Checkout page works seamlessly with a Vue.js-based dynamic structure.
The same chain logic is maintained across all variations, such as guest_shipping.twig, register.twig, and checkout/payment_address.twig.

The system maintains automatic synchronization even when new fields are added.

License-Controlled and Secure Update System:
The module integrates with the NommoTech License Server.
Only domains with active licenses can download updated SQL or data files.
Downloads occur through the secure_download.php API, and all requests are logged.
License validation fails for unauthorized domains, maintaining system security.

Automatic SQL Update Panel:
The table status can be queried with a single click from the module's administration screen.
The updated SQL file is downloaded from the NommoTech server via a secure connection.
Once the download is complete, it is automatically applied to the database.
The user can perform the database update without requiring any technical knowledge.

Advantages

4-stage address chain: Complete selection at the city, district, neighborhood, and street level

License-controlled architecture: Active only on approved domains

address_2 compatibility: Native integration with all OpenCart modules

SQL synchronization system: No manual work required with automatic download and install logic

Vue.js-based dynamic architecture: Live address feed with Journal3 Quick Checkout

Default theme support: Full compatibility with OpenCart core checkout and registration forms

License logging: Every verification and download process is logged on the server

Technical Architecture

Compatible Versions: OpenCart 3.0.2.0 - 3.0.3.8
Backend: PHP 7.2+ (Tested in Hostinger, cPanel, Apache/Nginx environments)
Frontend: Vue.js-based reactive architecture
Database: oc_districts, oc_neighborhoods, oc_streets
License API: https://nommotech.com.tr/license_server.php

Secure download: secure_download.php (POST: domain + secret + file)

Installation and Usage

Install and activate the module.

Go to Plugins → NommoTech Address in the admin panel.

Click the "Check Tables" button to view the table status in the system.

Click the "Download SQL" button to download the updated file from the license server.

Click the "Update" button to automatically configure the database.

The Province → District → Neighborhood → Street chain will now be active in all your address forms.

Summary

The NommoTech Address Module is a license-controlled, secure, and fully integrated OpenCart plugin specifically developed for the Turkish address structure.

It offers full compatibility with the default theme and Journal3 Quick Checkout structures, intelligent management of address chains via the address_2 field, and a secure SQL update infrastructure, providing a zero-maintenance, enterprise-level solution.