VibeFox Balikobot for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

WooCommerce: 7.0 veya üzeri, yüklü ve etkin olmalıdır. Eklenti WooCommerce olmadan etkinleştirilmez.

PHP: 8.0 veya üzeri.

Balikobot hesabı (canlı tarifeler ve teslim noktaları için): API erişimi olan bir Balikobot hesabına ihtiyacınız var. API kullanıcısı ve API anahtarı, Balikobot müşteri bölgesinde (client.balikobot.cz) bulunur. Balikobot desteği (podpora@balikobot.cz) hesabınız ve kargo şirketleriniz için API'yi etkinleştirir. Canlı tarifeler, Balikobot'un "transportcosts" desteklediği bir kargo şirketi ve hizmet gerektirir. Teslim noktaları ise "branchlocator" desteği olan bir kargo şirketi gerektirir (örneğin Česká pošta, Zásilkovna, PPL, DPD, GLS). Emin değilseniz Balikobot desteğine danışın. Sabit fiyatlar hesap olmadan çalışır.

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 bölümüne gidin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. Ayrıca vfd_balikobot klasörünü FTP ile /wp-content/plugins/ dizinine yükleyebilirsiniz.

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

3. Ayarları açın: WooCommerce > Settings > Shipping > VibeFox Balikobot veya Eklentiler sayfasında eklenti adının altındaki Settings bağlantısına 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. API kullanıcısını ve API anahtarını girin, kargo şirketini, hizmet türünü, fiyat kaynağını ve ülke fiyatlarını seçin (bkz. Yapılandırma). Teslim noktalı hizmetler için Pickup point selection seçeneğini etkinleştirin.

6. VibeFox Balikobot yöntemini WooCommerce > Settings > Shipping > Shipping zones bölümünde bir kargo bölgesine (örneğin Çekya) ekleyin veya Ignore shipping zones seçeneğini etkinleştirip ülkeleri seçin.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Shipping > VibeFox Balikobot. Tüm kargo bölgelerinde geçerlidir. Yöntemi, canlı tarifeleri veya teslim noktalarını gizleyecek ayarlar hakkındaki uyarılar sayfanın üst kısmında gösterilir. Ayarları her kaydettiğinizde önbellekteki tarifeler ve teslim noktaları temizlenir. Yöntemi bir bölgeye eklediğinizde bölge penceresinde yalnızca bir alan bulunur:

Title (zone): bu bölgedeki müşterilere gösterilen kargo yöntemi adı. Genel Name değerini kullanmak için boş bırakın.

Genel

Enable/Disable: Balikobot kargosunu tüm bölgelerde aynı anda açar veya kapatır.

Name: müşterilere gösterilen kargo yöntemi adı. Bir bölge, kendi Title değeriyle bunu geçersiz kılabilir. Varsayılan: Balikobot.

Tax status: Taxable, WooCommerce'in fiyatın üzerine kargo vergisi eklediği anlamına gelir; None ise eklemediği anlamına gelir. Balikobot fiyatları genellikle KDV hariçtir.

Balikobot API hesabı (canlı tarifeler ve teslim noktaları için gerekli)

API user: müşteri bölgesindeki Balikobot API kullanıcınız.

API key: müşteri bölgesindeki Balikobot API anahtarınız.

Carrier: tarifeler ve teslim noktaları için kullanılan Balikobot kargo şirketi: Česká pošta (varsayılan), Zásilkovna (Packeta), PPL, DPD, GLS, DHL Express, UPS, TNT, FedEx, Geis, InTime, Uloženka, Toptrans, Pošta bez hranic, Slovenská pošta, SPS (Slovak Parcel Service) veya Magyar Posta. Balikobot hesabınızda etkinleştirilmiş olmalıdır.

Service type: kargo şirketinin Balikobot hizmet kodu. Varsayılan: NP. Česká pošta için: NP = postaneye paket, NB = Balíkovna'ya paket, DR = adrese teslimat. Diğer kargo şirketlerinin kodları Balikobot müşteri bölgesinde ve API belgelerinde listelenmiştir.

Fiyat (tüm fiyatlar mağazanızın para biriminde)

Price source: fiyatın nasıl hesaplandığı.

Country prices: her varış ülkesi için sabit bir fiyat (2 harfli kod, örneğin CZ, SK). Diğer tüm ülkeler için * kullanın. Nokta veya virgülle ondalık. Sabit modda ve API hatası durumunda yedek olarak kullanılır. Fiyatı olmayan (ve * satırı olmayan) ülke sabit tarife almaz.

Fixed price per: Order fiyatı bir kez tahsil eder. Item (price × quantity) fiyatı sepetteki ürün adediyle çarpar. Bu yalnızca sabit fiyatlar için geçerlidir. Canlı Balikobot tarifesi her zaman tüm paket içindir.

Exchange rate: Balikobot fiyat para biriminin (genellikle CZK) 1 biriminin mağaza para birimindeki değeri, örneğin 0.04. Yalnızca Balikobot farklı bir para biriminde fiyat döndürdüğünde kullanılır. Bu fiyatları reddetmek için boş bırakın; böylece müşteriden hiçbir zaman yanlış fiyat alınmaz.

Koşullar

Min weight (kg): sepet bundan hafifse yöntemi gizler. 0 sınır olmadığı anlamına gelir. Ürün ağırlıkları mağazanızın ağırlık biriminden dönüştürülür.

Max weight (kg): sepet bundan ağırsa yöntemi gizler. Varsayılan: 100. 0 sınır olmadığı anlamına gelir.

Minimum order amount: yöntemi yalnızca bu sepet ara toplamından itibaren gösterir (indirimlerden sonra, vergi hariç). Her zaman göstermek 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.

Free shipping: aşağıdaki tutardan itibaren ücretsiz kargoyu etkinleştirir.

Free shipping from: ücretsiz kargonun başladığı sepet ara toplamı (indirimlerden sonra, vergi hariç). Bu durumda API'ye istek gönderilmez.

Kargo bölgeleri olmadan kullanılabilirlik

Ignore shipping zones: yöntem, eşleşen bölgeye eklenmemiş olsa bile aşağıdaki ülkelerde sunulur.

Countries: bu mod için varış ülkeleri. Gönderim yaptığınız tüm ülkeleri kullanmak için boş bırakın. Yalnızca Ignore shipping zones ile kullanılır.

Teslim noktaları

Pickup point selection: müşterinin bir teslim noktası seçmesi gerekir. Teslim noktalı hizmetler için kullanın, örneğin Česká pošta NP veya NB ya da Zásilkovna. API kullanıcısı ve API anahtarı gerektirir.

Selector width: teslim noktası listesinin CSS genişliği, örneğin 100% veya 400px. Varsayılan: 100%.

Gelişmiş

Debug log: API isteklerini ve tarife hesaplamalarını WooCommerce > Status > Logs altında, "vfd-balikobot" kaynağıyla kaydeder. API hataları her zaman kaydedilir. Kimlik bilgileri ve müşteri adresleri hiçbir zaman kaydedilmez.

Remove data on uninstall: açıksa, eklentiyi silmek ayarlarını ve bölge yöntemlerini kaldırır. Eklentiyi devre dışı bırakmak hiçbir zaman veri silmez. Siparişlere kaydedilmiş teslim noktaları korunur.

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

Müşteri bir teslimat adresi girdiğinde eklenti sepet ağırlığını, Minimum order amount ve Excluded shipping classes değerlerini kontrol eder. Ücretsiz kargo uygulanırsa tarife 0 olur ve Balikobot'a istek gönderilmez.

Sabit modda fiyat Country prices alanından alınır. Canlı modlarda eklenti Balikobot'a kargo şirketini, hizmet türünü, varış ülkesini ve posta kodunu, ayrıca sepet ağırlığını kg cinsinden gönderir. Canlı tarife, müşteri bir posta kodu girdikten sonra istenir. Başka bir para birimindeki fiyat Exchange rate ile dönüştürülür veya hiç kur ayarlanmamışsa reddedilir.

Canlı fiyatlar 1 saat önbellekte tutulur, böylece aynı sepet yeni bir istek tetiklemez. Başarısız bir istek 5 dakika önbellekte tutulur ve API zaman aşımı 12 saniyedir; böylece ödeme sayfası her yenilemede Balikobot'u beklemez. API hataları müşteriye hiçbir zaman gösterilmez: yöntem gizlenir veya yedek modda sabit fiyat kullanılır. Ayrıntılar günlüğe yazılır.

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

Eklenti, Balikobot'ta gönderi oluşturmaz, etiket yazdırmaz ve kurye talebi oluşturmaz: gönderiyi Balikobot müşteri bölgesinde siparişe dönüştürün. Paketleri takip etmez ve sipariş durumlarını güncellemez. Tüm bölgeler için tek bir kargo şirketi ve tek bir hizmet türü kullanılır. Teslim noktaları, harita olmadan açılır liste olarak gösterilir.

Teslim noktaları

Pickup point selection açıkken, müşteri ödeme sayfasında Balikobot seçeneğinin altında bir teslim noktası listesi görür; bu hem klasik hem de blok ödeme sayfası için geçerlidir. Liste, müşterinin ülkesi, şehri ve posta kodu için Balikobot "branchlocator" üzerinden yüklenir. Şehir ve posta kodu girilene kadar müşteri Enter your city and postcode to see the pickup points. mesajını görür. Liste 12 saat önbellekte tutulur.

Seçim zorunludur: müşteri Please select a pickup point. mesajını görür. Sunucu ayrıca seçilen noktanın teslimat adresine ait olduğunu doğrular. Adres değiştikten sonra müşteriden yeniden bir teslim noktası seçmesi istenir. Noktalar yüklenemezse müşteriye daha sonra tekrar denemesi veya başka bir kargo yöntemi seçmesi önerilir.

Seçilen teslim noktası siparişe kaydedilir. Yönetici sipariş ekranında teslimat adresinin altında Balikobot pickup point olarak görünür; Balikobot'ta gönderi oluştururken ihtiyaç duyacağınız Balikobot şube kimliği ve kargo şirketi ile birlikte. Sipariş adresine yakın başka bir nokta seçmek için Change düğmesine tıklayın. Müşteri, noktayı sipariş sayfasında ve sipariş e-postalarında (HTML ve düz metin) Pickup point olarak görür. Mevcut siparişler teslim noktası verilerini korur.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Shipping > VibeFox Balikobot sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blokta durum, örneğin lisansın hangi tarihe kadar aktif olduğu ve alan adınız gösterilir. 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ı bir siteden kaldırmak alan adı hakkını serbest bırakmaz. Bunu vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar yoksa Balikobot, ödeme sayfasında müşterilere gösterilmez. Oturum açmış mağaza yöneticileri yine de (unlicensed — visible to admins only) etiketiyle 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

Balikobot ö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 izinliyse). Ayarlar sayfasının üstündeki uyarıları okuyun. Ağırlık sınırlarını, Minimum order amount ve Excluded shipping classes değerlerini kontrol edin. Sabit modda, ülkenin veya * satırının bir fiyatı olduğunu doğrulayın.

Canlı tarifeler görünmüyor: Debug log seçeneğini açın, ödeme sayfasını yenileyin ve WooCommerce > Status > Logs sayfasını açın (kaynak "vfd-balikobot"). Nedeni orada görürsünüz: eksik API kimlik bilgileri, henüz girilmemiş posta kodu, kargo şirketi ve hizmet için Balikobot hatası veya Exchange rate olmadan başka para biriminde fiyat. Live Balikobot rate, fixed price if the API fails seçeneğiyle, sorunu giderirken müşteriler yine sabit fiyatı alır.

Fiyatlar yanlış para biriminde: sabit fiyatlar mağazanızın para birimindedir. Balikobot canlı fiyatları, Balikobot sözleşmenizin para biriminde (genellikle CZK) döndürür. Bu para birimi mağaza para biriminden farklıysa Exchange rate değerini ayarlayın.

KDV dahil mi? Balikobot fiyatları genellikle KDV hariçtir. Tax status Taxable olarak ayarlıysa WooCommerce kargo vergisini ekler.

Listede teslim noktası yok: API kullanıcısı ve anahtarının girildiğini, kargo şirketinin "branchlocator" desteklediğini ve müşterinin şehir ile posta kodunu girdiğini kontrol edin. Balikobot hatasını günlükte inceleyin.

Bir değişiklikten sonra tarifeler veya teslim noktaları eski görünüyor: ayarlar sayfasını kaydedin. Bu, önbellekteki tarifeleri ve teslim noktalarını temizler.

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, 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 önbellekleri temizler. Kaldırmak için eklentiyi Plugins sayfasında devre dışı bırakın ve silin. Bu eklentinin lisans anahtarı ve lisans durumu ile önbellekteki tarifeler ve teslim noktaları her zaman kaldırılır. Ayarlar ve bölge yöntemleri yalnızca Remove data on uninstall açıksa kaldırılır. Aksi halde sonraki bir yeniden kurulum için saklanır. Siparişlerde kaydedilmiş teslim noktası verileri hiçbir zaman silinmez.

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