VibeFox Econt for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

WooCommerce: 7.0 veya üzeri, kurulu ve etkin. Eklenti WooCommerce olmadan etkinleştirilmez.

PHP: 8.0 veya üzeri.

Econt: Econt sözleşmesi veya API anahtarı gerekmez. Ofis listesi Econt'in herkese açık bir nomenklatürüdür. Econt'e yalnızca ülke kodu gönderilir, müşteri verisi gönderilmez. e-Econt kullanıcı adı ve şifresini yalnızca Econt sitenizden yetkilendirme istediğinde 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

1. WordPress'te Plugins > Add New > Upload Plugin yolunu izleyin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. Ayrıca vfd_econt klasörünü FTP ile /wp-content/plugins/ dizinine de yükleyebilirsiniz.

2. Activate düğmesine tıklayın.

3. Ayarları açın: WooCommerce > Settings > Shipping > VibeFox Econt veya Plugins sayfasında eklenti adının altındaki Settings düğmesine tıklayın.

4. Sayfanın üstündeki lisans bloğuna VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın.

5. Ülkelere göre ücretleri belirleyin ve diğer seçenekleri kontrol edin (bkz. Yapılandırma). Bağlantıyı test etmek için Load offices from Econt now düğmesine tıklayın.

6. WooCommerce > Settings > Shipping > Shipping zones altında, Bulgaristan ve/veya Romanya içeren bir kargo bölgesine VibeFox Econt ekleyin veya Ignore zones seçeneğini açıp ülkeleri seçin.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Shipping > VibeFox Econt. Ücret ve koşullar her kargo bölgesi için geçerlidir. Yöntemi bir bölgeye eklediğinizde bölge penceresinde yalnızca bir alan bulunur:

Title (zone): bu bölge için müşterilerin gördüğü ad. Genel Name değerini kullanmak için boş bırakın.

Sayfanın üstünde eklenti uyarılar gösterir: demo API açıktır, Bulgaristan veya Romanya için ücret ayarlanmamıştır (bu durumda yöntem hiç gösterilmez) veya bir ülke için son ofis isteği başarısız olmuştur. Sayısal alanlar ondalık virgülü kabul eder, örneğin 5,99. Sayı olmayan bir değer yok sayılır ve kaydederken bildirilir.

Genel

Enable/Disable: Econt teslimatını tüm bölgelerde aynı anda açar veya kapatır. Varsayılan: açık.

Name: ödeme sayfasında gösterilen kargo yöntemi adı. Bölgede ayarlanan bir Title bunun yerine geçer. Varsayılan: Econt Express.

Tax status: Taxable kargo ücretine WooCommerce vergisini ekler, None eklemez. Varsayılan: Taxable.

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 ofislerin kimlikleri gerçek ofislerden farklıdır. Demo modunda giriş ayarlanmamışsa Econt'in herkese açık test hesabı kullanılır.

Econt username: isteğe bağlı. HTTP Basic yetkilendirmesi için e-Econt kullanıcı adınız.

Econt password: isteğe bağlı. WordPress veritabanında saklanır ve günlüğe hiçbir zaman yazılmaz.

Office list: ülkeye göre kaç ofisin önbellekte olduğunu ve ne zaman yüklendiklerini gösterir. Load offices from Econt now düğmesi listeleri hemen yeniden yükler ve sonucu 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 ödeme sayfası açılışında otomatik yüklenir. Demo API, kullanıcı adı veya şifre değiştirildiğinde ö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, Filibe, Varna, Bükreş ve diğerleri). Kapalıyken şehirler alfabetik sıralanır. Varsayılan: açık.

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

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

Ücretler (mağaza para biriminde)

Eklenti Econt'ten canlı kargo ücreti sorgulamaz. Bulgaristan 1 Ocak 2026'dan beri euro kullanıyor, bu nedenle Bulgaristan'daki bir mağaza genellikle EUR cinsinden ücret girer.

Price per country: her satıra bir ülke (veya virgülle ayırarak): ülke kodu, iki nokta üst üste ve ücret, örneğin BG:5.99 ve RO:8.99 (varsayılan değerlerdir). Ondalık virgül de kullanılabilir: BG:5,99. 0 ücret ücretsiz teslimat anlamına gelir. Başka biçimdeki girişler yok sayılır ve kaydederken bir hata mesajında listelenir.

Calculation: Per order ücreti bir kez alır. Per item (price x quantity) ücreti sepetteki gönderilebilir ü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

Free shipping from: teslimatın ücretsiz olduğu sepet ara toplamı. Ücretsiz teslimat hiç sunulmasın istiyorsanız boş bırakın.

Minimum subtotal: yöntemi yalnızca sepet ara toplamı bu tutarın en az olduğunda 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ı mağazanızın birimden kg'a çevrilir. 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.

Hide for shipping classes: sepette bu WooCommerce kargo sınıflarından birine ait bir ürün varsa yöntemi gizler.

Kargo bölgesi olmadan kullanılabilirlik

Ignore zones: hiçbir bölge Econt'i eklemediğinde aşağıdaki ülkelerde de Econt'i sunar. Yöntemi içeren bölgeler her zamanki gibi çalışmaya devam eder.

Countries: Bulgaristan ve/veya Romanya. Yalnızca Ignore zones ile kullanılır. Mağazanızın gönderim yaptığı tüm Econt ülkeleri için boş bırakın.

Gelişmiş

Debug log: hata ayıklama mesajlarını WooCommerce > Status > Logs altına, kaynak vfd-econt olarak yazar. API hataları her zaman kaydedilir. Şifreler veya müşteri verileri yazılmaz.

Remove data on uninstall: açıksa eklentiyi silmek Econt ayarlarını ve bölge yöntemlerini kaldırır. Eklentiyi devre dışı bırakmak ayarları asla silmez. Siparişlerde kayıtlı ofisler her zaman korunur.

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

Yöntem yalnızca Bulgaristan ve Romanya için sunulur. Müşteri bir teslimat adresi girdiğinde eklenti sepet ağırlığını, minimum ara toplamı ve gizli kargo sınıflarını kontrol eder, ardından ülkenin ücretini alır. Sepet ara toplamı Free shipping from değerine ulaşırsa ücret 0 olur. Ülke için bir ofis listesi yoksa yöntem gizlenir, çünkü teslimat her zaman bir ofise yapılır.

Müşteri Econt'i seçtiğinde yöntemin altında iki liste görünür: City ve Office / Econtomat. Ofis listesi sayfa başına bir kez yüklenir. Econtomat'lar listede işaretlenir. Seçim oturum boyunca hatırlanır. Ofis listesi yüklenemezse müşteri birkaç dakika sonra tekrar denemesi veya başka bir kargo yöntemi seçmesi yönünde bir mesaj görür.

Müşteri ofis seçmeden siparişi tamamlayamaz. Sunucuda eklenti, ofisin teslimat ülkesi için Econt listesinde bulunduğunu yeniden kontrol eder. Ofis adı her zaman tarayıcıdan değil Econt listesinden alınır. Bu, klasik ödeme sayfasında ve blok ödeme sayfasında çalışır. Eklenti WooCommerce High-Performance Order Storage (HPOS) ile uyumludur.

Ofis listesi 24 saat önbellekte tutulur. Econt'e ulaşılamazsa son başarılı liste kullanılır ve 10 dakika boyunca Econt'e yeniden istek gönderilmez. API zaman aşımı 15 saniyedir.

Eklenti yalnızca sabit ücret kullanır. Econt'ten canlı ücret sorgulamaz, irsaliye veya etiket oluşturmaz, kurye çağırmaz, kargoları takip etmez, kapıda ödemeyi yönetmez ve adrese teslimat yapmaz. Yalnızca Bulgaristan ve Romanya'nın bir ofis listesi vardır.

Teslim noktaları

Seçilen ofis siparişle birlikte kaydedilir: şehir, ofis adı ve adresi ile Econt ofis kodu. Gönderiyi e-Econt'te oluştururken ofis kodunu kullanın.

Yönetici sipariş ekranı: ofis ve ofis kodu teslimat adresinin altında gösterilir. Ofis listesini yüklemek ve başka bir şehir ile ofis seçmek için Change düğmesine tıklayın. Değişiklik hemen kaydedilir ve bir sipariş notu eski ve yeni ofisi kaydeder.

Müşteri: ofis, müşterinin sipariş sayfasında ve teşekkür sayfasında, ayrıca sipariş e-postalarında (HTML ve düz metin) gösterilir.

Site dili Bulgarca veya Rumence ise ofis adları yerel dilde (Bulgaristan için Kiril alfabesiyle) gösterilir; diğer durumlarda İngilizce gösterilir.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Shipping > VibeFox Econt sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blok durumu gösterir; örneğin lisansın geçerli olduğu tarihi ve alan adınızı. Check now ile durumu yeniden kontrol edebilir, Change key ile başka bir anahtar girebilir ve Remove key ile bu siteden kaldırabilirsiniz. Manage licenses and domains in your account bağlantısı vibefox.net hesabınızı açar.

Bir anahtar bir alan adında çalışır. Anahtarı bir siteden kaldırmak alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Econt ödeme sayfasında müşterilere gösterilmez. Oturum açmış mağaza yöneticileri ise yine de (unlicensed — visible to admins only) işaretiyle görür; böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Eklentiler sayfasında ve WooCommerce sayfalarında bir hatırlatma görünür. Mevcut siparişler etkilenmez.

Bir lisansın süresi dolduğunda eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum arka planda otomatik olarak yeniden kontrol edilir.

Sorun giderme

Econt ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, teslimat ülkesinin Bulgaristan veya Romanya olduğunu ve yöntemin o ülkenin bölgesine eklendiğini kontrol edin (veya Ignore zones açık ve ülke izinliyse). Ülke için bir ücretin ayarlandığını, ağırlık sınırlarını, Minimum subtotal ve Hide for shipping classes ayarlarını kontrol edin. Ayarlardaki Office list satırına bakın: ülke için bir ofis listesi olmadığı sürece yöntem gizlenir.

Ofis listesi yüklenmiyor: Load offices from Econt now düğmesine tıklayın ve sonucu veya ayarlar sayfasının üstündeki uyarıyı okuyun. Hatalar WooCommerce > Status > Logs altına, kaynak vfd-econt olarak yazılır. Econt sitenizden yetkilendirme istiyorsa Econt username ve Econt password alanlarını doldurun.

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

Ücretler hangi para biriminde? Mağaza para biriminizde.

Diğer ülkeler: geliştiriciler, vfd_ecn_countries filtresiyle ülke ekleyebilir (2 harfli kodun 3 harfli kodla eşlenmesi).

Lisans bloğu bir hata gösteriyor: bloktaki mesajı izleyin. Örneğin anahtar başka bir alan adında zaten kullanılıyorsa, vibefox.net hesabınızda bir yuva serbest bırakın ve Check now düğmesine tıklayın. Site adresi değiştiyse, anahtarı yeni alan adı için etkinleştirmek üzere Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Kaldırma

Eklentiyi devre dışı bırakmak tüm ayarları korur ve yalnızca ofis önbelleğini temizler. Tamamen kaldırmak için Plugins sayfasında devre dışı bırakın ve silin. Bu eklentinin lisans anahtarı ve lisans durumu ile önbellekteki ofis listeleri her zaman silinir. Ayarlar ve bölge yöntemleri yalnızca Remove data on uninstall açıksa silinir. Aksi halde sonraki bir yeniden kurulum için saklanır. Siparişlerde kayıtlı ofisler her zaman korunur ve mevcut siparişler kargo satırlarını korur.

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