VibeFox Instabee for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

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

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 anlaşması olan satıcılara verir. Instabee iletişim kişinize sorun veya Instabee satıcı portalını kullanın. API belgeleri developer.budbee.com adresinde. Kimlik bilgileri olmadan yöntem sabit fiyatlarla yine çalışır, ancak müşteriler paket kutusu seçemez.

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

Kurulum

1. WordPress'te Plugins > Add New > Upload Plugin sayfasına gidin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. vfd_instabee 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 Instabee veya eklentiler sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

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

5. Fiyatlar bölümünü doldurun ve paket kutusu seçici için Budbee API key ve API secret değerlerinizi girin (bkz. Yapılandırma).

6. Teslimat yaptığınız ülkelerin (örneğin İsveç) kargo bölgelerine VibeFox Instabee ekleyin: WooCommerce > Settings > Shipping > Shipping zones; ya da Ignore shipping zones seçeneğini açıp ülkeleri seçin.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Shipping > VibeFox Instabee. Tüm kargo bölgeleri için geçerlidir. Yöntemi bir bölgeye eklediğinizde bölge penceresinde yalnızca bir alan bulunur:

Title: bu bölgede ödeme sayfasında bu tarifenin adı. Genel Method name değerini kullanmak için boş bırakın.

Ayarların üstündeki uyarılar, API kimlik bilgilerinden yalnızca birinin girildiğini, hiç kimlik bilgisi olmadığını, ülke fiyatı ve yedek ücret bulunmadığını ve son Budbee API isteğinin başarısız olduğunu (tarih, saat ve neden ile birlikte) bildirir. Ayarları her kaydettiğinizde önbelleğe alınmış paket kutusu listeleri ve son API hatası silinir.

Genel

Enable/Disable: yöntemi kargo bölgeleri dahil her yerde açar veya kapatır. Varsayılan: açık.

Method name: sepette ve ödeme sayfasında gösterilen kargo yöntemi adı. Bir bölge bunu kendi Title değeriyle değiştirebilir. Varsayılan: Instabee parcel box.

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

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 girilene 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ı).

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 kapalı tutar (api.budbee.com). Varsayılan: kapalı.

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

Tüm fiyatlar mağazanın para biriminde girilir. Hem ondalık virgül hem de ondalık nokta kabul edilir (49,90 = 49.90). Sayı olmayan bir değer kaydedilmez ve bir hata mesajı alanı belirtir.

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

Country prices: Country, Price, XS (1 kg'a kadar), S (2 kg'a kadar), M (3 kg'a kadar), L (5 kg'a kadar) ve XL (5 kg'ın üzeri) sütunlarından oluşan bir tablo. Satır eklemek için + Add country düğmesine, satır silmek için çarpı işaretine tıklayın. Kendi satırı olmayan tüm ülkeler için geçerli bir satır üzerinde * Any other country seçin. Boş veya 0 olan bir aralık 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ı, o da yoksa Fallback cost kullanılır. Ağırlıklar mağazanızın ağırlık biriminden kg'a çevrilir.

Fallback cost: hedef ülkenin satırında ve * satırında fiyat yoksa kullanılır. Bu ülkelerde yöntemi gizlemek için boş bırakın.

Koşullar

Min weight (kg): sepet bundan hafif olduğunda yöntemi gizler. Varsayılan: 0 (sınır yok).

Max weight (kg): sepet bundan ağır olduğunda yöntemi gizler. Paket kutuları yaklaşık 20 kg'a kadar taşır. Varsayılan: 20. 0 sınır yok anlamına gelir.

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

Free shipping from: sepet ara toplamının (indirimler sonrası, vergi öncesi) bu tutara ulaştığı durumda yöntem ücretsiz olur. Asla ücretsiz yapmamak için boş bırakın.

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

Kargo bölgeleri olmadan kullanılabilirlik

Normalde VibeFox Instabee yöntemini bir kargo bölgesine eklersiniz. Alternatif olarak, burada bir ülke listesi için etkinleştirebilirsiniz.

Ignore shipping zones: yöntemi, hiçbir kargo bölgesi içermese bile aşağıdaki ülkelerde sunar.

Countries: bu mod için hedef ülkeler. Gönderim yaptığınız tüm ülkeleri kullanmak 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ı WooCommerce > Status > Logs sayfasına (kaynak vfd-instabee) yazar. API hataları bu kapalıyken bile her zaman kaydedilir. API anahtarları ve müşteri verileri hiçbir zaman kaydedilmez.

Remove data on uninstall: açıksa eklentiyi silmek bu yöntemin ayarlarını ve bölge tarifelerini kaldırır. Eklentiyi devre dışı bırakmak ayarları asla silmez. Siparişlere kaydedilmiş paket kutuları korunur.

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

Müşteri bir teslimat adresi girdiğinde WooCommerce eklentiden bir tarife ister. Eklenti koşulları kontrol eder: sepet ağırlığı, minimum sipariş tutarı ve hariç tutulan kargo sınıfları. Sepet ara toplamı Free shipping from değerine ulaşırsa tarife ücretsizdir. 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.

Müşteri Instabee tarifesini seçtiğinde ve API kimlik bilgileri ayarlıysa, İsveç, Finlandiya, Danimarka, Hollanda ve Belçika için tarifenin altında bir Parcel box seçici görünür. Seçici, teslimat adresinin posta koduna yakın kutuları mesafeye göre sıralı, ad, adres ve mesafeyle birlikte listeler. Müşteri başka bir posta kodu yazıp Search düğmesine tıklayabilir. Bir posta kodu girilene kadar seçici bir posta kodu ister. Kutu bulunamazsa müşteriden başka bir posta kodu denemesi veya başka bir kargo yöntemi seçmesi istenir.

Paket kutusu zorunludur. Sipariş verildiğinde eklenti, seçilen kutunun o posta kodu için Budbee listesinde olduğunu sunucuda kontrol eder. Aksi halde müşteri Please choose an Instabee parcel box. mesajını görür. Kutunun adı tarayıcıdan değil, Budbee listesinden alınır.

Eklenti Budbee'ye yalnızca hedef ülkeyi ve posta kodunu gönderir; ad, adres, e-posta veya sipariş verisi asla gönderilmez. 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. API zaman aşımı 10 saniyedir.

Budbee API'ye ulaşılamazsa müşteriye, siparişin paket kutusu seçmeden verilebileceği bildirilir. Sipariş bu durumda işaretlenir ve kutuyu gönderiyi oluştururken siz seçersiniz. Daha önce seçilmiş ama o anda kontrol edilemeyen bir kutu korunur ve doğrulanmamış olarak işaretlenir.

Seçici klasik ödeme sayfasında ve Sepet ile Ödeme bloklarında çalışır. Eklenti WooCommerce High-Performance Order Storage (HPOS) ile uyumludur.

Eklenti canlı tarife hesaplamaz, gönderi oluşturmaz, etiket yazdırmaz, takip numarası veya takip e-postası vermez, Budbee Home teslimat zaman aralıkları sunmaz ve harita göstermez. Seçilen kutu için paketi Instabee / Budbee satıcı araçlarınızda oluşturun.

Teslim noktaları

Seçilen paket kutusu siparişe kaydedilir ve şu yerlerde gösterilir:

Yönetici sipariş ekranı: teslimat adresinin altında, Instabee parcel box olarak kutu adı, adres ve Box ID ile birlikte. Kutu ödeme sayfasında kontrol edilemediyse not verified (Budbee API was unavailable at checkout) olarak işaretlenir. API kullanılamadığı için hiçbir kutu seçilmediyse ekran bunu belirtir ve gönderiyi oluştururken kutuyu seçmenizi hatırlatır.

Teşekkür sayfası ve Hesabım sipariş sayfası: kutu adı ve adresi.

Sipariş e-postaları: HTML ve düz metin. Mağazaya giden e-postalarda kutu kimliği de gösterilir. API kullanılamadığı için hiçbir kutu seçilmediyse yalnızca mağazaya giden e-postalar bunu belirtir.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Shipping > VibeFox Instabee sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blokta durum gösterilir; örneğin lisansın hangi tarihe kadar etkin olduğu ve alan adınız. Durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu siteden kaldırmak için Remove key kullanın. Manage licenses and domains in your account bağlantısı vibefox.net hesabınızı açar.

Bir anahtar tek bir alan adında çalışır. Anahtarın bir siteden kaldırılması o site için alan adı hakkını serbest bırakmaz. Alan adı hakkını vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Instabee ödeme sayfasında müşterilere gösterilmez. Oturum açmış mağaza yöneticileri 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.

Lisans sona erdiğinde eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum arka planda otomatik olarak yeniden kontrol edilir.

Sorun giderme

Instabee ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve yöntemin müşterinin ülkesinin bölgesine eklendiğini kontrol edin (veya Ignore shipping zones açık ve ülke izinli olmalıdır). Ülkenin bir fiyatı olduğunu ya da bir * satırı veya Fallback cost bulunduğunu kontrol edin. Ağırlık sınırlarını, Minimum order amount ve Excluded shipping classes ayarlarını kontrol edin. Ayarların üstündeki uyarı, fiyat yapılandırılmadığında bunu bildirir.

Müşteriler paket kutusu listesini görmüyor: liste yalnızca API key ve API secret ayarlıysa, İ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 WooCommerce > Status > Logs sayfasındadır (kaynak vfd-instabee). 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ğinden emin olun (staging kimlik bilgileri yalnızca test ortamı açıkken kullanılır).

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.

Değişiklikten sonra eski kutu listeleri: ayarlar sayfasını kaydedin. Bu, önbelleğe alınmış kutu listelerini temizler.

Kutu araması için diğer ülkeler: geliştiriciler, ülke listesini vfd_ibee_box_countries filtresiyle değiştirebilir.

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 hak serbest bırakın ve Check now düğmesine tıklayın. Site adresi değiştiyse yeni alan adı için anahtarı etkinleştirmek üzere Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamıyorsa eklenti son bilinen durumla çalışmaya devam eder.

Kaldırma

Eklentiyi devre dışı bırakmak yalnızca önbelleğe alınmış kutu listelerini temizler. Tamamen kaldırmak için devre dışı bırakın ve Plugins sayfasından silin. Bu eklentinin lisans anahtarı ve lisans durumu, önbelleğe alınmış kutu listeleri ve son API hatası her zaman kaldırılır. Ayarlar, bölge yöntemleri ve sürüm verileri yalnızca Remove data on uninstall açıksa kaldırılır. Aksi halde sonraki yeniden kurulum için saklanır. Siparişlere kaydedilmiş paket kutuları her zaman korunur ve mevcut siparişler kendi kargo satırlarını korur.

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.