VibeFox Econt for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 ile test edildi) veya 4.0.2 ve üzeri (4.1.0.3 ile test edildi).

PHP: 8.0 veya üzeri.

Ülkeler: Bulgaristan ve Romanya, System > Localisation > Countries bölümünde etkinleştirilmiş olmalıdır.

Econt: Sözleşme veya API anahtarı gerekmez. Ofis listesi Econt'un herkese açık bir kayıt listesidir. Econt'a yalnızca ülke kodu gönderilir, müşteri verileri gönderilmez. Econt mağazanızdan yetkilendirme isterse e-Econt kullanıcı adı ve şifresini girin. e-Econt girişi Econt geliştirici sayfasında açıklanmıştır (econt.com/developers).

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar bir alan adında çalışır.

Kurulum

İndirme, her iki OpenCart sürümü için paketleri içeren tek bir zip dosyasıdır. Bilgisayarınızda açın. İçinde README.txt, OpenCart 3 paketi vfd_econt-oc3-(sürüm).ocmod.zip ve OpenCart 4 paketi vfd_econt.ocmod.zip bulunur. Yalnızca kullandığınız OpenCart sürümünün paketini kurun. Lisans anahtarı iki sürüm için de aynıdır.

OpenCart 3

1. Yönetim panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve vfd_econt-oc3-(sürüm).ocmod.zip dosyasını seçin. Eklenti OCMOD değişikliği eklemez, bu yüzden Extensions > Modifications bölümünü yenilemeniz gerekmez. Installer yerine, bu paketin upload klasörünün içeriğini mağazanızın kök klasörüne de kopyalayabilirsiniz.

2. Extensions > Extensions bölümüne gidin ve eklenti türü olarak Shipping seçin. VibeFox Econt eklentisini bulun ve Install düğmesine (yeşil + düğmesi) tıklayın.

3. Ayar sayfasını açmak için Edit düğmesine (kalem düğmesi) tıklayın.

4. VibeFox lisans anahtarınızı, Edit sayfasının üstündeki lisans bloğunda License key alanına girin ve Activate düğmesine tıklayın (bkz. License key).

5. Ülkelere göre fiyatları belirleyin ve diğer seçenekleri kontrol edin (bkz. Configuration), Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Bağlantıyı test etmek için Load offices from Econt now düğmesine tıklayın.

OpenCart 4

1. Yönetim panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve vfd_econt.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4 eklenti kodunu dosya adından alır ve adı değiştirilmiş bir paket çalışmaz.

2. Paket, aynı sayfadaki kurulu eklentiler listesinde görünür. Yanındaki Install düğmesine (yeşil + düğmesi) tıklayın.

3. Extensions > Extensions bölümüne gidin ve eklenti türü olarak Shipping seçin. VibeFox Econt eklentisini bulun, Install düğmesine (yeşil + düğmesi) ve ardından Edit düğmesine (kalem düğmesi) tıklayın.

4. Lisans anahtarını ve ayarları OpenCart 3 için 4. ve 5. adımlardaki gibi girin. Ayar sayfası ve alanları iki sürümde de aynıdır.

Kurulumdan sonra, Enable/Disable seçeneğini açıp kaydedene kadar yöntem kapalı kalır. Eklentiyi kaldırdıktan sonra yeniden kurarsanız, sakladığınız ayarlar tekrar kullanılır.

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Shipping > VibeFox Econt > Edit. Bölümler solda listelenir. Tek bir Save düğmesi tüm sayfayı yeniden yüklemeden kaydeder. Ayarları kaydetme, ofisleri yükleme veya günlüğü temizleme yetkisi yalnızca bu eklenti için değiştirme izni olan yönetici kullanıcılardadır.

Sayfanın üst kısmında eklenti uyarılar gösterir: demo API açıktır, Bulgaristan veya Romanya için fiyat ayarlanmamıştır (bu durumda yöntem hiçbir zaman gösterilmez), bir ülke için son ofis isteği başarısız olmuştur veya mağazanızda kg birimli bir ağırlık sınıfı yoktur (bu durumda ürün ağırlıkları birim adlarına göre okunur: kg, g, lb veya oz). Sayısal alanlar ondalık virgülü kabul eder, örneğin 5,99. Bir sayısal alan sayı olmayan veya negatif bir değer içeriyorsa ya da Minimum weight (kg) değeri Maximum weight (kg) değerinden büyükse, bir hata alanı belirtir ve hiçbir şey kaydedilmez. Boş bir Name veya 64 karakterden uzun bir ad, tam sayı olmayan bir Sort order ya da bilinmeyen bir vergi sınıfı veya coğrafi bölge için de aynısı geçerlidir.

Genel

Enable/Disable: Econt teslimatını ödeme sayfasında gösterir veya gizler. Varsayılan: kapalı.

Name: sepette ve ödeme sayfasında gösterilen kargo yöntemi adı. Varsayılan: Econt Express. Zorunlu, en fazla 64 karakter.

Sort order: ödeme sayfasındaki kargo yöntemleri arasındaki konum. Bir tam sayı.

Tax class: kargo ücretinin vergi sınıfı veya --- None --- (varsayılan). OpenCart bu vergiyi aşağıdaki fiyatların üzerine ekler. --- None --- seçiliyken fiyatlar kesindir.

Econt ofis listesi

Ofisler ve Econtomat'lar Econt API'sinden yüklenir ve 24 saat önbellekte tutulur.

Demo API: test verileriyle Econt demo API'sini kullanır. Canlı bir mağazada kapalı tutun. Demo ofislerinin kimlikleri gerçek olanlardan farklıdır. Demo modunda giriş ayarlanmamışsa Econt'un herkese açık test hesabı kullanılır.

Econt username: isteğe bağlı. HTTP Basic yetkilendirmesi için e-Econt girişiniz.

Econt password: isteğe bağlı. Mağaza veritabanında saklanır ve günlüğe asla yazılmaz. Kaydettikten sonra alan boş kalır ve Saved - leave empty to keep it. ifadesini gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin.

Remove the saved password: seçeneği açın ve kayıtlı şifreyi silmek için Save düğmesine tıklayın.

Office list: ülkeye göre önbellekte kaç ofis olduğunu ve ne zaman yüklendiklerini gösterir. Load offices from Econt now düğmesi Bulgaristan ve Romanya listelerini hemen yeniden yükler ve sonucu ülke bazında gösterir. Bir yükleme başarısız olursa son başarılı yüklemedeki ofisler korunur. Bu düğme olmasa da liste ilk ödemede otomatik yüklenir. Demo API, kullanıcı adı veya şifre değiştirilirse önbellekteki listeler temizlenir.

Ödeme sayfasında ofis seçici

Show: müşterilerin seçebileceği noktalar.

City order: en büyük şehirleri önce gösterir (Sofya, Plovdiv, Varna, Bükreş ve diğerleri). Kapalıyken şehirler alfabetik sıralanır. Varsayılan: açık.

City list width: şehir listesinin CSS genişliği, örneğin 100% veya 300px. Varsayılan: 100%.

Office list width: ofis listesinin CSS genişliği, örneğin 100% veya 400px. Varsayılan: 100%.

Fiyatlar (bölüm başlığı mağazanızın varsayılan para birimini gösterir)

Fiyatlar mağazanızın varsayılan para biriminde, vergi hariç girilir. Eklenti Econt'tan anlık kur istemez. Bulgaristan 1 Ocak 2026'dan beri euro kullanıyor, bu yüzden bir Bulgar mağazası genellikle fiyatları EUR olarak girer.

Price per country: her satıra bir ülke (ya da virgülle ayrılmış): ülke kodu, iki nokta üst üste ve fiyat, örneğin BG:5.99 ve RO:8.99 (bunlar varsayılan değerlerdir). Ondalık virgül de kullanılabilir: BG:5,99. 0 fiyatı ücretsiz teslimat anlamına gelir. Alan boşsa varsayılan fiyatlar BG:5.99 ve RO:8.99 kullanılır. Başka biçimdeki girişler yok sayılır ve kaydederken bir uyarıda listelenir. Geri kalanı kaydedilir.

Calculation: Per order (varsayılan) fiyatı bir kez tahsil eder. Per item (price x quantity) ise fiyatı kargolanması gereken ürün sayısıyla çarpar.

Price for other countries: yukarıda listelenmeyen bir Econt ülkesi (Bulgaristan veya Romanya) için kullanılır. Boş veya 0 değeri yöntemi o ülkede gizler.

Koşullar

Sepet ara toplamı, kupondan sonra ve vergiden önce kargolanması gereken ürünler anlamına gelir.

Free shipping from: teslimatın ücretsiz olduğu sepet ara toplamı. Hiçbir zaman ücretsiz teslimat sunmamak için boş bırakın.

Minimum subtotal: yöntemi yalnızca sepet ara toplamı bu tutarın en az bir değerine ulaştığında gösterir. Her zaman göstermek için boş bırakın.

Minimum weight (kg): daha hafif sepetler için yöntemi gizler. Ürün ağırlıkları ağırlık sınıflarından kg'a dönüştürülür. Sınır olmaması için boş bırakın.

Maximum weight (kg): daha ağır sepetler için yöntemi gizler. Sınır olmaması için boş bırakın.

Kullanılabilirlik

Econt yalnızca Bulgaristan ve Romanya'ya teslimat yapar. Normalde yöntemin nerede sunulacağına coğrafi bölge karar verir; Ignore geo zone seçildiğinde bunun yerine seçilen ülkeler karar verir.

Geo zone: Econt'u yalnızca bu coğrafi bölgedeki adreslere sunar. All Zones (varsayılan) Bulgaristan ve Romanya'nın her yeri anlamına gelir. Coğrafi bölgeler System > Localisation > Geo Zones bölümünde yönetilir. Ignore geo zone ile coğrafi bölge kullanılmaz.

Ignore geo zone: coğrafi bölge kontrol edilmez. Adres coğrafi bölgede olsun veya olmasın, Econt aşağıdaki ülkelerde sunulur.

Countries: Bulgaristan ve/veya Romanya. Yalnızca Ignore geo zone ile kullanılır. Hiçbiri seçilmezse tüm Econt ülkeleri anlamına gelir.

Gelişmiş

Debug log: hata ayıklama mesajlarını storage/logs/vfd_ecn_debug.log.php (OpenCart 4'te system/storage/logs/vfd_ecn_debug.log.php) dosyasına yazar. Dosya web üzerinden okunamaz. 5 MB'a ulaştığında yeni bir günlük başlatılır. API hataları ve uyarıları (Econt'a ulaşılamaz, ofis yok, ofissiz sipariş) her zaman günlüğe yazılır. Şifre veya müşteri verisi yazılmaz.

Log: günlüğün boyutunu ve son kayıtlarını gösterir. Temizlemek için Clear log düğmesine tıklayın.

Remove data on uninstall: açıksa eklentiyi kaldırmak Econt ayarlarını, günlüğü ve tamamlanmamış ödemelerin seçimlerini siler. Kapalıysa ayarlar yeniden kurulum için saklanır. Siparişlerde kaydedilen ofisler her zaman korunur.

İçe / Dışa Aktarma

Export: ayarları bir JSON dosyası olarak kaydetmek için Download JSON düğmesine tıklayın. Şifre dışa aktarılmaz.

Import: daha önce dışa aktarılmış JSON'u yapıştırın ve ayarları geri yüklemek için Import düğmesine tıklayın; örneğin başka bir mağazada. Değerler normal bir kayıtta olduğu gibi kontrol edilir. Kayıtlı şifre korunur.

Ödeme sayfasında nasıl çalışır

Yöntem yalnızca Bulgaristan ve Romanya için sunulur. OpenCart kargo yöntemlerini gösterirken eklentiden Econt fiyatını ister. Ignore geo zone seçiliyken coğrafi bölge kontrol edilmez ve yöntem yalnızca seçilen Countries için sunulur (hiçbiri seçilmezse = Bulgaristan ve Romanya). Aksi halde bir Geo zone ayarlıysa adres o bölgede olmalıdır. Yalnızca Requires Shipping değeri Yes olan ürünler dikkate alınır: diğer ürünler ağırlık eklemez ve ara toplama dahil edilmez. Eklenti ağırlık sınırlarını ve minimum ara toplamı kontrol eder, ardından ülke için fiyatı alır. Sepet ara toplamı Free shipping from değerine ulaşırsa fiyat 0 olur. Ülke için ofis listesi yoksa, teslimat her zaman bir ofise yapıldığı için yöntem gizlenir. Fiyat mağazanızın varsayılan para biriminde hesaplanır ve müşteriye, seçilen Tax class vergisiyle birlikte kendi para biriminde gösterilir.

Müşteri Econt'u seçtiğinde yöntemin altında iki liste görünür: City ve Office / Econtomat. Ofis listesi sayfa başına yalnızca bir kez ve yalnızca Econt seçiliyken yüklenir. Econtomat'lar listede işaretlenir. Seçim hemen kaydedilir. Ofis listesi yüklenemezse müşteri Econt offices cannot be loaded right now. Please try again in a few minutes or choose another shipping method. mesajını görür.

Müşteri kargo yöntemi adımında Continue düğmesine tıkladığında eklenti, sunucuda bir ofisin seçildiğini ve teslimat ülkesi için Econt listesinde bulunduğunu kontrol eder (Show filtresine göre). Ofis yoksa müşteri Please select an Econt office or Econtomat. mesajını görür. Listede olmayan bir ofis The selected Econt office is not available for the shipping country. Please select it again. mesajıyla reddedilir. Ofis adı her zaman tarayıcıdan değil, Econt listesinden alınır.

OpenCart 4'te müşteri, ödeme sayfasındaki kargo yöntemi bloğunda Choose düğmesine tıklar ve Shipping method options penceresinde Econt'u seçer. City ve Office / Econtomat listeleri bu pencerede yöntemin altında görünür ve yukarıda açıklandığı gibi çalışır. Pencerenin Continue düğmesi, geçerli bir ofis olmadan ilerlemez; aynı mesajlar gösterilir.

Ofis listesi, canlı ve demo API için ayrı ayrı ve her ülke için 24 saat önbellekte tutulur. Econt'a ulaşılamazsa son başarılı liste kullanılır ve Econt 10 dakika boyunca tekrar sorgulanmaz. API zaman aşımı 15 saniyedir. Ofis listesi https://ee.econt.com/services/ (canlı) veya https://demo.econt.com/ee/services/ (demo) adresinden gelir.

Eklenti yalnızca sabit fiyatlar kullanır. Econt'tan anlık fiyat istemez, irsaliye veya etiket oluşturmaz, kurye çağırmaz, kargoları takip etmez, kapıda ödeme almaz veya adrese teslimat yapmaz. Yalnızca Bulgaristan ve Romanya'nın bir ofis listesi vardır.

Teslim noktaları

Sipariş verildiğinde ödeme sayfasında seçilen ofis siparişle birlikte kaydedilir: şehir, ofis adı ve adresi ile Econt ofis kodu. e-Econt'ta gönderiyi oluştururken ofis kodunu kullanın.

Müşteri: ofis, siparişin kargo yöntemine eklenir, örneğin Econt Express - Econt office / Econtomat: city, office (address) (en fazla 128 karakter; OpenCart 4'te metin kısaltılmaz). Böylece müşterinin sipariş geçmişinde, sipariş e-postalarında, faturada ve yönetici siparişinde görünür. OpenCart 4, ödeme için tek bir sipariş tutar ve müşteri her yeniden onayladığında bunu günceller; siparişin ofisi de onunla birlikte güncellenir.

Yönetici sipariş sayfası: Sales > Orders bölümünde, geçmişin üstündeki Econt office / Econtomat paneli ofisi ve ofis kodunu gösterir; yöntem daha sonra kapatılsa bile. Change altında siparişin ülkesinden başka bir şehir ve ofis seçip Save düğmesine tıklayın. Panel Saved. gösterir, siparişin kargo yöntemi metni güncellenir ve sipariş geçmişindeki bir not (müşteriye gönderilmez) eski ve yeni ofisi kaydeder. Ofis seçmeden Save düğmesine tıklarsanız panel Select a city and an office first - nothing was changed. der. Siparişin ülkesi için listede olmayan bir ofis The selected Econt office is not available for the shipping country - nothing was changed. mesajıyla reddedilir. Siparişleri değiştirme izni olan herhangi bir yönetici kullanıcı ofisi değiştirebilir; eklenti ayarlarına erişim gerekmez. Ofis listesi yüklenemezse panel Econt offices cannot be loaded right now. gösterir. Ofissiz verilen bir sipariş No Econt office is saved for this order. gösterir ve günlükte bu sipariş için bir hata bulunur.

Ofis adları, mağaza dili Bulgarca veya Rumence ise yerel dilde (Bulgaristan için Kiril alfabesiyle), değilse İngilizce gösterilir.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Econt lisans bloğu, Extensions > Extensions > Shipping > VibeFox Econt > Edit sayfasında ayarların üstündeki ilk bloktur. Anahtarı License key alanına girin ve Activate düğmesine tıklayın. Bundan sonra blok anahtarı maskeli olarak, durumu (örneğin lisansın geçerli olduğu tarihi ve alan adınızı) ve Check now (durumu yeniden denetler), Change key (başka bir anahtar girer) ve Remove key (anahtarı bu mağazadan kaldırır) düğmelerini gösterir. Bunların altında Product: opencart-shipping-econt satırı ve vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca eklenti için Modify izni olan yönetici kullanıcılar değiştirebilir. Bloğun metinleri yönetici dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini gösterir; örneğin Key not found, This key belongs to another product, Domain limit reached veya License expired on ve bir tarih. Mağaza adresi değiştikten sonra veya hesabınızda bir alan adı yuvasını boşalttıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Bir anahtar bir alan adında çalışır: OpenCart yapılandırmasındaki mağaza adresi. Anahtarı mağazadan kaldırmak alan adı yuvasını boşaltmaz. Yuvayı vibefox.net hesabınızda boşaltın.

Etkin bir anahtar olmadan Econt kargo yöntemi ödeme sayfasında müşterilere gösterilmez ve hiçbir fiyat hesaplanmaz. Aynı tarayıcıda yönetim paneline giriş yapmış bir yönetici kullanıcı, yöntemi mağazada hâlâ (unlicensed — visible to admins only) işaretiyle görür; böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu önizleme yoktur: mağaza yönetici girişini görmez, bu yüzden etkin bir anahtar olmadan yöntem herkesten gizlenir. Edit sayfasını bir kez açtıktan sonra, yönetim panelindeki Dashboard üzerinde bir hatırlatma görünür. 7 gün gizlemek için × ile kapatın. Mevcut siparişler etkilenmez.

Lisans sona erdiğinde eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetim panelindeki Dashboard veya Edit sayfası açıldığında durum otomatik olarak yeniden denetlenir: anahtar girildikten sonraki ilk 14 gün her gün, sonrasında haftada bir. Cron işi gerekmez. Eklentiyi kaldırmak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

Econt ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable/Disable seçeneğinin açık olduğunu, teslimat ülkesinin Bulgaristan veya Romanya olduğunu (System > Localisation > Countries bölümünde etkin) kontrol edin. Geo zone (veya Ignore geo zone ve Countries), ülke için bir fiyatın ayarlandığını, ağırlık sınırlarını ve Minimum subtotal değerini kontrol edin. Ayarlardaki Office list satırını kontrol edin: ülke için ofis listesi yokken yöntem gizlenir. Ürünlerin Requires Shipping değerinin Yes olduğunu kontrol edin.

Ofis listesi yüklenmiyor: Load offices from Econt now düğmesine tıklayın ve sonucu ya da ayar sayfasının üstündeki uyarıyı okuyun. Hatalar her zaman günlüğe yazılır; daha fazla ayrıntı için Debug log seçeneğini açın ve Log alanına bakın. Econt mağazanız için yetkilendirme istiyorsa Econt username ve Econt password alanlarını doldurun.

Müşteriler test ofislerini görüyor: Demo API açıktır. Canlı bir mağazada kapatın.

Fiyatlar hangi para birimindedir? Mağazanızın varsayılan para biriminde, vergi hariç. Müşteriler kendi para biriminde görür.

Vergi fiyatın üzerine ekleniyor: bir vergi sınıfı seçili. Fiyatlarınız KDV'yi zaten içeriyorsa Tax class değerini --- None --- olarak ayarlayın.

Sayfa "Warning: You do not have permission to modify VibeFox Econt!" diyor: yönetici kullanıcı grubunuz ayarları yalnızca görüntüleyebilir. Gruba System > Users > User Groups bölümünde extension/shipping/vfd_econt (OpenCart 3) veya extension/vfd_econt/shipping/vfd_econt (OpenCart 4) için değiştirme izni verin.

Kaldırma

Extensions > Extensions bölümüne gidin, Shipping türünü seçin ve VibeFox Econt yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Bu eklentinin lisans anahtarı ve lisans durumu her zaman silinir. OpenCart her zaman Enable/Disable, Sort order, Tax class ve Geo zone değerlerini sıfırlar. Eklenti her zaman kendi olaylarını ve önbellekteki ofis listelerini kaldırır. Remove data on uninstall açıksa diğer ayarlar, günlük ve tamamlanmamış ödemelerin seçimleri de silinir. Kapalıysa ayarlar korunur ve eklentiyi yeniden kurduğunuzda tekrar kullanılır. Siparişlerde kaydedilen ofisler her zaman korunur ve mevcut siparişler kendi kargo yöntemini ve maliyetini korur.

OpenCart 4'te eklenti dosyalarını da kaldırmak için, kaldırma işleminden sonra Extensions > Installer bölümüne gidin, kurulu eklentiler listesinde VibeFox Econt yanındaki Uninstall düğmesine (turuncu − düğmesi) ve ardından yüklenen paketi silmek için Delete düğmesine (kırmızı çöp kutusu düğmesi) tıklayın.

Econt, ilgili sahibinin ticari markasıdır. Bu eklenti Econt ile bağlantılı değildir ve Econt tarafından onaylanmamıştır.