VibeFox Instabee for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 üzerinde test edildi) veya 4.0.2 ve sonraki sürümler (4.1.0.3 üzerinde test edildi).

PHP: 8.0 veya üzeri.

Budbee API kimlik bilgileri (yalnızca paket kutusu seçimi için): bir API anahtarı ve bir API gizli anahtarı. Instabee bunları teslimat sözleşmesi olan satıcılara verir. Instabee iletişim kişinize danışın veya Instabee satıcı portalını kullanın. API belgeleri developer.budbee.com adresinde bulunur. Kimlik bilgileri olmadan yöntem sabit fiyatlarla çalışmaya devam eder, ancak müşteriler paket kutusu seçemez.

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

Kurulum

İndirme, OpenCart'ın iki 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_instabee-oc3-(version).ocmod.zip ve OpenCart 4 paketi vfd_instabee.ocmod.zip bulunur. Yalnızca OpenCart sürümünüze uygun paketi kurun. Lisans anahtarı iki sürüm için de aynıdır.

OpenCart 3

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

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

3. Ayarlar 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 kısmındaki lisans bloğunda License key alanına girin ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

5. Prices bölümünü doldurun ve paket kutusu seçicisi için Budbee API key ve API secret değerlerinizi girin (Yapılandırma bölümüne bakın). Enable/Disable seçeneğini açın ve Save düğmesine tıklayın.

OpenCart 4

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve vfd_instabee.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 Instabee 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. Ayarlar 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 Instabee ayarları yeniden kullanılır.

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Shipping > VibeFox Instabee > Edit. Bölümler solda listelenir. Tek bir Save düğmesi tüm sayfayı yeniden yüklemeden kaydeder. Her kaydetme işlemi ayrıca önbelleğe alınmış kutu listelerini ve son API hatasını temizler. Yalnızca bu eklenti için değiştirme izni olan yönetici kullanıcıları ayarları kaydedebilir.

Ayarların üstündeki uyarılar; API kimlik bilgilerinden yalnızca birinin girildiğini, hiç API kimlik bilgisi bulunmadığını, ülke fiyatı ve yedek maliyet bulunmadığını, son Budbee API isteğinin başarısız olduğunu (tarih, saat ve nedenle birlikte) ve mağazada kg birimli bir ağırlık sınıfı bulunmadığında ve varsayılan ağırlık sınıfının birimi tanınmadığında bildirir (bu durumda ağırlıklar kg olarak işlenir; System > Localisation > Weight Classes bölümünde bir kg ağırlık sınıfı ekleyin).

Method name boşsa veya çok uzunsa, Min weight (kg), Max weight (kg) değerinden büyükse, Sort order tam sayı değilse veya vergi sınıfı ya da coğrafi bölge mevcut değilse hiçbir şey kaydedilmez ve bir hata gösterilir.

Genel

Enable/Disable: Instabee'yi ödeme sayfasında gösterir veya gizler. Varsayılan: off.

Method name: ödeme sayfasında müşteriye gösterilen kargo yöntemi adı. Varsayılan: Instabee parcel box. Zorunlu, en fazla 64 karakter.

Tax class: None (the prices are final) (varsayılan), aşağıdaki fiyatların kesin olduğu anlamına gelir. Bir vergi sınıfı, aşağıdaki fiyatların üzerine o sınıfın kargo vergisini ekler.

Sort order: ödeme sayfasındaki kargo yöntemleri arasında Instabee'nin konumu. Tam sayı.

Paket kutusu seçici (Budbee API)

API kimlik bilgileriyle müşteri, ödeme sayfasında posta koduna yakın bir paket kutusu seçer ve kutu siparişe kaydedilir. İki alan da gereklidir. Her ikisi de ayarlanana kadar seçici kapalı kalır.

API key: Budbee API anahtarınız (HTTP Basic kullanıcı adı).

API secret: Budbee API gizli anahtarınız (HTTP Basic parolası). Asla günlüğe yazılmaz.

Kaydettikten sonra iki alan da 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. Kayıtlı kimlik bilgilerini silmek için Remove the saved API key and secret kutusunu işaretleyin ve kaydedin. Hiçbir şey kayıtlı değilse sayfa No credentials saved. gösterir.

Test environment: Budbee staging API'sini (api.staging.budbee.com) kullanır. Yalnızca Instabee'den alınan staging kimlik bilgileriyle açın. Canlı mağazalar bunu kapalı tutar (api.budbee.com). Varsayılan: off.

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

Tüm fiyatlar mağazanın varsayılan para biriminde, vergi hariç belirtilir. Ondalık virgül ve ondalık nokta ikisi de kabul edilir (49,90 = 49.90). Fiyat müşteriye kendi para biriminde gösterilir.

Calculation type: fiyatın nasıl uygulanacağı.

Country prices: Country, Price, XS ≤1 kg, S ≤2 kg, M ≤3 kg, L ≤5 kg ve XL >5 kg sütunlarına sahip bir tablo. Satır eklemek için Add country düğmesine, birini kaldırmak için × düğmesine tıklayın. Kendi satırı olmayan tüm ülkelere uygulanan bir satır için * Any other country seçin. Boş veya 0 olan bir kademe Price sütununu kullanır. Price değeri 0 ise ücretsiz teslimat anlamına gelir. Ülke satırında sepet ağırlığı için fiyat yoksa * satırı, sonra Fallback cost kullanılır. Kaydederken, 0 veya daha büyük bir sayı olmayan fiyat temizlenir ve bilinmeyen ülkeye sahip satır kaldırılır; bir uyarı bunları listeler. Ürün ağırlıkları OpenCart ağırlık sınıflarından kg'a dönüştürülür.

Fallback cost: ne hedef ülkenin satırı ne de * satırı fiyat vermediğinde kullanılır. Bu ülkelerde yöntemi gizlemek için boş bırakın.

Koşullar

Min weight (kg): yöntemi bu sepet ağırlığının altında gizler. Varsayılan: 0 (sınır yok).

Max weight (kg): yöntemi bu sepet ağırlığının üstünde gizler. Paket kutuları yaklaşık 20 kg'a kadar taşır. Varsayılan: 20. 0 sınır olmadığı anlamına gelir. Min weight (kg) değerinden küçük olamaz.

Minimum order amount: yöntemi yalnızca kargo gerektiren ürünlerin ara toplamı (kupon sonrası, vergi öncesi) bu tutara ulaştığında gösterir. Her zaman göstermek için boş bırakın.

Free shipping from: kargo gerektiren ürünlerin ara toplamı (kupon sonrası, vergi öncesi); yöntemin bu tutardan itibaren ücretsiz olduğu tutar. Hiçbir zaman ücretsiz olmaması için boş bırakın.

Bu alanlardan birinde veya Fallback cost alanında bir değer 0 veya daha büyük bir sayı değilse kaydedilmez, önceki değer korunur ve bir uyarı alanın adını belirtir.

Kullanılabilirlik

Geo zone: Instabee'yi yalnızca bu coğrafi bölgedeki adresler için sunar. All zones (varsayılan) her yer anlamına gelir. Ignore shipping zones açıkken coğrafi bölge kontrol edilmez. Coğrafi bölgeler System > Localisation > Geo Zones bölümünde yönetilir.

Ignore shipping zones: açıkken Geo zone kontrol edilmez ve yöntem aşağıdaki ülkeler için sunulur. Kapalıyken (varsayılan), yalnızca Geo zone geçerlidir.

Countries: bu mod için hedef ülkeler. Tüm ülkelere izin vermek için boş bırakın. Bu alan yalnızca Ignore shipping zones açıkken kullanılır.

Gelişmiş

Debug log: hata ayıklama mesajlarını storage/logs/vfd_ibee_debug.log.php (OpenCart 4'te system/storage/logs/vfd_ibee_debug.log.php) dosyasına yazar. Dosya web üzerinden okunamaz. API hataları ve API çalışırken kutusuz verilen siparişler, bu kapalı olsa bile her zaman günlüğe yazılır. API anahtarları ve müşteri verileri asla günlüğe yazılmaz. Dosya 5 MB'a ulaştığında vfd_ibee_debug.old.log.php dosyasına taşınır ve yeni bir günlük başlatılır.

Log: günlüğün boyutunu ve en son girişlerini gösterir. Boşaltmak için Clear log düğmesine tıklayın.

Remove data on uninstall: açıkken eklentiyi kaldırmak ayarları, önbelleğe alınmış kutu listelerini, günlüğü ve tamamlanmamış ödemelerin kutularını siler. Kapalıyken (varsayılan), yeniden kurulum için ayarlar korunur. Siparişlerde kayıtlı paket kutuları her zaman korunur.

İçe / dışa aktarma

Export: ayarları JSON dosyası olarak kaydetmek için Download JSON düğmesine tıklayın. API anahtarı ve gizli anahtarı 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 kaydetme gibi kontrol edilir. Kayıtlı API anahtarı ve gizli anahtar korunur.

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

OpenCart kargo yöntemlerini gösterirken, eklentiden Instabee fiyatını ister. Ignore shipping zones açıkken Instabee yalnızca ülkeye izin verildiğinde sunulur (coğrafi bölge kontrol edilmez). Aksi halde, bir Geo zone ayarlanmışsa ve adres bunun dışındaysa Instabee sunulmaz. Yalnızca Requires Shipping değeri Yes olarak ayarlanmış ürünler sayılır: diğer ürünler ağırlığa eklenmez ve sipariş tutarına dahil edilmez. Sipariş tutarı, kupon indirimi sonrası ve vergi öncesi, kargo gerektiren ürünlerin fiyatıdır. Eklenti sepet ağırlığını ve minimum sipariş tutarını kontrol eder. Ara toplam Free shipping from değerine ulaşırsa fiyat 0 olur. Aksi halde fiyat, hedef ülkenin Country prices satırından, * satırından veya Fallback cost değerinden alınır. Fiyat yoksa yöntem gizlenir. Fiyat, varsayılan para biriminizde hesaplanır, ondalık basamaklarına yuvarlanır ve seçili Tax class vergisiyle birlikte müşterinin para biriminde gösterilir.

Müşteri kargo yöntemi adımında Instabee'yi seçtiğinde ve API kimlik bilgileri ayarlandığında, İsveç, Finlandiya, Danimarka, Hollanda ve Belçika için yöntemin altında bir Parcel box bloğu görünür. Bu blok, teslimat adresinin posta koduna yakın kutuları, mesafeye göre sıralı olarak adı, adresi ve mesafesiyle birlikte listeler. Müşteri başka bir posta kodu yazabilir ve Search düğmesine tıklayabilir (veya Enter tuşuna basabilir). Bir posta kodu girilene kadar blok bunu ister. Hiç kutu bulunamazsa, müşteriden başka bir posta kodu denemesi veya başka bir kargo yöntemi seçmesi istenir. Diğer ülkeler için yöntem kutusuz sunulur.

Paket kutusu zorunludur. Seçilen kutu, yalnızca o posta kodu için Budbee listesinde bulunuyorsa ödeme için kaydedilir. Search düğmesine tıklanmadan yazılan bir posta kodu kullanılmaz. Müşteri kargo yöntemi adımında Continue düğmesine tıkladığında eklenti kutuyu sunucuda yeniden kontrol eder. Aksi halde müşteri Please choose an Instabee parcel box. mesajını görür. Kutu adı tarayıcıdan değil, Budbee listesinden alınır. Müşteri teslimat ülkesini veya adresin posta kodunu değiştirirse, önceki seçim silinir.

OpenCart 4'te müşteri, ödeme sayfasındaki kargo yöntemi bloğunda Choose düğmesine tıklar ve Shipping method options penceresinde Instabee'yi seçer. Parcel box bloğu bu pencerede Instabee seçeneğinin altında görünür ve aynı şekilde çalışır. Pencerenin Continue düğmesi, listeden kutu seçilmeden ilerlemez ve aynı mesajlar gösterilir.

Eklenti Budbee'ye yalnızca hedef ülkeyi ve posta kodunu gönderir; asla ad, adres, e-posta veya sipariş verisi göndermez. Kutu listeleri posta kodu başına 12 saat, kutusu olmayan bir posta kodu 1 saat ve başarısız bir istek 5 dakika önbelleğe alınır; böylece yavaş veya bozuk bir API her ödeme sayfası yenilemesini yavaşlatmaz. Ödeme sayfasının kendisi asla Budbee'yi beklemez: yöntem seçildiğinde liste arka planda yüklenir. API zaman aşımı 10 saniyedir.

Budbee API'ye ulaşılamazsa müşteri Parcel boxes cannot be loaded right now. You can place the order without choosing a box - the shop will assign one. mesajını görür. Sipariş bu durumda işaretlenir ve gönderiyi ayırtırken kutuyu siz seçersiniz. O anda kontrol edilemeyen, daha önce seçilmiş bir kutu korunur ve doğrulanmamış olarak işaretlenir.

Eklenti canlı kargo ücreti hesaplamaz, gönderi ayırtmaz, etiket yazdırmaz, takip numarası veya takip e-postası vermez, Budbee Home teslimat zaman aralıkları sunmaz ve harita göstermez. Paketi, Instabee / Budbee satıcı araçlarınızda seçilen kutu için ayırtın.

Teslim alma noktaları

Sipariş oluşturulduğunda kutu bir kez daha kontrol edilir ve siparişe kaydedilir. Bundan sonra mağaza vitrini bunu değiştiremez. OpenCart 4, ödeme için tek bir sipariş tutar ve müşteri yeniden onayladığında her seferinde onu günceller; siparişin kutusu da onunla birlikte güncellenir. Müşteri bu siparişi başka bir kargo yöntemine geçirirse kutusu kaldırılır. Kutu şu yerlerde gösterilir:

Siparişin kargo yöntemi: kutu, yöntem adına eklenir; örneğin Instabee parcel box: (yöntem adı) ve ardından kutu adı ile adresi. Bu metin, yönetici sipariş sayfalarında ve müşteri hesabında, sipariş e-postalarında ve faturada görünür.

Yönetici sipariş sayfası (Sales > Orders): Instabee parcel box paneli; kutu adı, adresi ve Box ID ile birlikte. Kutu ödeme sırasında kontrol edilemediyse not verified (Budbee API was unavailable at checkout) olarak işaretlenir. API kullanılamadığı için kutu seçilmediyse panel Not chosen - the Budbee API was unavailable at checkout. Choose the box when you book the shipment. yazar. Panel salt okunurdur ve yöntem kapalı olsa bile gösterilir. OpenCart 4'te History bölümünün üstünde gösterilir.

Mağazaya yeni sipariş e-postası: kutu adı ve kimliği veya Instabee parcel box: not chosen (Budbee API unavailable at checkout).

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Instabee lisans bloğu, Extensions > Extensions > Shipping > VibeFox Instabee > Edit sayfasında ayarların üstünde yer alan 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 tarih ve alan adınız) ve Check now (durumu yeniden kontrol eder), 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-instabee satırı ve Manage licenses and domains in your account bağlantısı bulunur; bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca eklenti için Modify izni olan yönetici kullanıcılar değiştirebilir. Bloktaki metinler 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ı serbest bıraktı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ı serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Instabee kargo yöntemi ödeme sayfasında müşterilere gösterilmez ve hiçbir ücret hesaplanmaz. Yönetici paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, yöntemi yine de mağazada görür ve (unlicensed — visible to admins only) ifadesiyle işaretlenir; böylece anahtarı satın almadan önce eklentiyi kurabilir ve test edebilirsiniz. OpenCart 4'te bu önizleme kullanılamaz: mağaza yönetici girişini görmez, bu yüzden etkin bir anahtar yoksa yöntem herkesten gizlenir. Yönetici Edit sayfasını bir kez açtıktan sonra, Dashboard sayfasında bir hatırlatma görünür. Bunu × ile kapatırsanız 7 gün boyunca gizlenir. 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, yönetici Dashboard sayfasını veya Edit sayfasını açtığınızda otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, sonrasında haftada bir kez. Cron job gerekmez. Eklentiyi kaldırmak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

Instabee ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable/Disable seçeneğinin açık olduğunu kontrol edin. Geo zone ayarını denetleyin veya Ignore shipping zones açıksa, ülkenin Countries içinde izinli olduğunu kontrol edin. Ülkenin bir fiyatı olduğunu veya bir * satırı ya da bir Fallback cost bulunduğunu kontrol edin. Ağırlık sınırlarını ve Minimum order amount değerini, ayrıca ürünlerin Requires Shipping değerinin Yes olduğunu kontrol edin. Ayarların üstündeki bir uyarı, hiçbir fiyatın yapılandırılmadığını gösterir. Nedeni Log alanında görmek için Debug log seçeneğini açın.

Müşteriler paket kutusu listesini görmüyor: liste yalnızca hem API key hem de API secret ayarlandığında, İsveç, Finlandiya, Danimarka, Hollanda ve Belçika için ve bir posta kodu girildikten sonra görünür. Son API hatası ayarların üstünde gösterilir. Ayrıntılar eklenti sayfasındaki Log alanındadır. Daha fazla ayrıntı için Debug log seçeneğini açın.

Günlükte HTTP 401 veya 403: Budbee API anahtarını veya gizli anahtarı reddetti. Bunları kontrol edin ve Test environment ayarının kimlik bilgilerinizle eşleştiğini doğrulayın (staging kimlik bilgileri yalnızca test ortamı açıkken).

Bir posta kodu için kutu yok: Budbee bu posta koduna hizmet vermiyor. Müşteri başka bir posta kodu arayabilir veya başka bir kargo yöntemi seçebilir.

Müşteri kargo yöntemi adımından devam edemiyor: Budbee API'ye ulaşılamıyorsa dışında, listeden bir paket kutusu seçilmelidir. Aranan posta kodunun listesinde olmayan bir kutu kaydedilmez ve müşteri This parcel box is not in the Budbee list for the postal code. Please choose the parcel box again. mesajını görür.

Bir değişiklikten sonra eski kutu listeleri: eklenti sayfasında Save düğmesine tıklayın. Bu, önbelleğe alınmış kutu listelerini temizler.

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

Kaldırma

Extensions > Extensions bölümüne gidin, Shipping türünü seçin ve VibeFox Instabee yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. OpenCart her zaman Enable/Disable, Sort order, Tax class ve Geo zone ayarlarını sıfırlar. Önbelleğe alınmış kutu listeleri her zaman kaldırılır. Remove data on uninstall açıksa ayarlar, günlük ve hiçbir zaman siparişe dönüşmeyen ödemelerde seçilen kutular da silinir. Kapalıysa diğer ayarlar korunur ve eklentiyi yeniden kurduğunuzda tekrar kullanılır. Siparişlerde kayıtlı paket kutuları her zaman korunur ve mevcut siparişler kargo yöntemini ve maliyetini korur.

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

Instabee ve Budbee, ilgili sahiplerinin ticari markalarıdır. Bu eklenti Instabee veya Budbee ile bağlantılı değildir ve onlar tarafından onaylanmamıştır.