VibeFox Bob Go for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

WooCommerce: 5.0 veya üzeri, kurulu ve etkin. Eklenti WooCommerce olmadan etkinleştirilemez.

PHP: 8.0 veya üzeri.

Bob Go hesabı (yalnızca canlı ücretler için): Bob Go'nun API anahtarı yoktur. Bir Bob Go hesabına (bobgo.co.za), Bob Go hesabınızda satış kanalı olarak kurulmuş WooCommerce mağazanıza (Sales channels) ve bu kanal için etkin "Rates at checkout" özelliğine ihtiyacınız vardır; hizmetleriniz ve fiyatlarınız orada ayarlanmış olmalıdır. Yalnızca sabit fiyat kullanıyorsanız Bob Go hesabına ihtiyacınız yoktur.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar yalnızca 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. Ayrıca vfd_bob_go klasörünü FTP ile /wp-content/plugins/ dizinine yükleyebilirsiniz.

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

3. Bob Go hesabınızda WooCommerce mağazanızı satış kanalı olarak kurun. Bu kanal için "Rates at checkout" özelliğini etkinleştirin ve hizmetlerinizi ile fiyatlarınızı ayarlayın.

4. Ayarları açın: WooCommerce > Settings > Shipping > VibeFox Bob Go veya Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

5. VibeFox lisans anahtarınızı sayfanın üstündeki lisans bölümüne girin ve Activate düğmesine tıklayın.

6. Mağaza alan adını, çıkış (ship from) adresini ve mağaza para biriminiz ZAR değilse ZAR dönüşüm oranını kontrol edin (bkz. Yapılandırma).

7. VibeFox Bob Go eklentisini WooCommerce > Settings > Shipping > Shipping zones içinde Güney Afrika için bir kargo bölgesine ekleyin veya Ignore shipping zones seçeneğini açın.

Yapılandırma

Tüm ayarlar tek bir sayfada bulunur: WooCommerce > Settings > Shipping > VibeFox Bob Go. Ayarlar tüm kargo bölgelerinde geçerlidir. Ayarları her kaydettiğinizde, önbelleğe alınmış Bob Go ücretleri temizlenir. Yöntemi bir bölgeye eklediğinizde bölge penceresinde yalnızca bir alan bulunur:

Title (zone): bu bölgede sabit fiyatlar ve ücretsiz kargo için gösterilen ad. Genel Method title değerini kullanmak için boş bırakın. Bob Go canlı ücretleri her zaman Bob Go'da yapılandırılan hizmet adlarıyla gösterilir.

Genel

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

Method title: sabit fiyatlar ve ücretsiz kargo için müşteriye gösterilir. Bir bölge bunu geçersiz kılabilir. Bob Go canlı ücretleri, Bob Go'dan gelen hizmet adlarıyla gösterilir, örneğin "The Courier Guy - Economy". Varsayılan: Bob Go.

Shipping cost: fiyatın nasıl hesaplanacağı.

Canlı ücretlerin eksik olmasının nedeni günlüğe yazılır. Müşteriye hiçbir zaman gösterilmez.

Bob Go hesabı

Bu bölüm, mağaza alan adınız için Bob Go'dan gelen son yanıtı gösterir: connected, the WooCommerce channel is not installed on Bob Go (HTTP 404), "Rates at checkout" is not enabled for this channel (HTTP 401) veya başka bir hata. Mağaza para biriminiz ZAR değilse ve dönüşüm oranı ayarlanmamışsa, canlı ücretlerin istenmediği konusunda da uyarır.

Store domain: Bob Go, mağazanızı alan adına göre tanır. Site alan adınızı kullanmak için boş bırakın. Bob Go'daki kanalınız farklı bir adreste kuruluysa yalnızca başka bir alan adı girin; örneğin alt klasördeki bir mağaza için example.co.za/shop.

ZAR conversion rate: Bob Go, Güney Afrika randı (ZAR) cinsinden fiyat verir. Mağaza para biriminiz ZAR değilse, 1 ZAR'ın mağaza para biriminizde ne kadar olduğunu girin; örneğin EUR için 0.05. Ücretler bununla dönüştürülür ve ürün fiyatları Bob Go'ya ZAR olarak gönderilir. Para biriminizde Bob Go canlı ücretlerini kullanmamak için boş bırakın (sabit fiyatlar yine çalışır). Mağaza para biriminiz ZAR ise boş bırakın. Ondalık ayırıcı olarak hem nokta hem virgül kabul edilir.

Delivery dates: Bob Go'dan gelen tahmini teslimat tarih aralığını ücret adında gösterir. Tahmin her zaman siparişle birlikte kaydedilir ve sipariş ekranında görünür.

Gönderici (çıkış adresi)

Çıkış adresi, her ücret isteğiyle birlikte Bob Go'ya gönderilir. WooCommerce > Settings > General altındaki mağaza adresiniz aynı ülkedeyse, boş alanlar oradan doldurulur.

Origin country: gönderim yaptığınız ülke. Varsayılan: Güney Afrika. Bob Go yalnızca Güney Afrika içinde gönderim yapar.

Origin province: bir Güney Afrika eyaleti veya Store province (if in South Africa).

Origin city / suburb: gönderim yaptığınız şehir veya semt, örneğin Johannesburg.

Origin postal code: gönderim yaptığınız posta kodu, örneğin 2001.

Origin street address: gönderim yaptığınız cadde adresi.

Sabit fiyatlar (sabit modda ve Bob Go ücret döndürmediğinde yedek olarak kullanılır)

Price per country: ülke başına bir satır: 2 harfli ülke kodu, eşittir işareti ve mağaza para biriminizdeki fiyat; örneğin ZA=99.99. Diğer tüm ülkeler için * kullanın; örneğin *=199.99. Başka biçimdeki satırlar kaydederken silinir.

Flat price: yukarıda satırı olmayan ülkeler için mağaza para biriminizdeki fiyat. Bu ülkeler için yöntemi gizlemek üzere boş bırakın.

Fixed price applies: Per order fiyatı bir kez alır. Per item (price × quantity) ise fiyatı sepetteki ürün adediyle çarpar. Bob Go canlı ücretleri her zaman tüm gönderi içindir.

Koşullar

Minimum weight (kg): sepet ağırlığı bunun altındaysa yöntemi gizler. 0 sınır olmadığı anlamına gelir.

Maximum weight (kg): sepet ağırlığı bunun üstündeyse yöntemi gizler. 0 sınır olmadığı anlamına gelir (varsayılan).

Minimum order amount: yöntemi yalnızca sepet ara toplamı (indirimler sonrası, vergiden önce) bu tutara eşit veya üstündeyse gösterir. Her zaman göstermek için boş bırakın.

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

Free shipping: aşağıda belirtilen sipariş tutarına ulaşıldığında ücretsiz kargoyu açar.

Free shipping from: ücretsiz kargo için sepet ara toplamı (indirimler sonrası, vergiden önce). Yalnızca Free shipping açıkken kullanılır. Bu durumda Bob Go'dan ücret istenmez.

Tax status: Taxable WooCommerce vergisini kargo ücretine ekler, None eklemez. Bob Go ücretleri genellikle KDV'yi zaten içerir. Bu durumda vergi iki kez alınmasın diye None seçin.

Kargo bölgesi olmadan kullanılabilirlik

Ignore shipping zones: Bob Go bir kargo bölgesine eklenmemiş olsa bile aşağıdaki ülkeler için sunulur.

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

Gelişmiş

Debug log: ücret hesaplamalarını ve Bob Go isteklerini WooCommerce > Status > Logs içinde, "vfd_bob_go" kaynağıyla günlüğe yazar. Müşteri adresleri günlüğe yazılmaz. API hataları bu seçenek kapalıyken de günlüğe yazılır.

Remove data on uninstall: açıksa eklentiyi silmek tüm Bob Go ayarlarını, bölge yöntemlerini ve önbelleğe alınmış ücretleri kaldırır. Eklentiyi devre dışı bırakmak hiçbir şeyi silmez.

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

Müşteri bir teslimat adresi girdiğinde eklenti sepet ağırlığını, Minimum order amount değerini ve Excluded shipping classes ayarını kontrol eder. Ücretsiz kargo geçerliyse müşteri yöntemi Bob Go (free) olarak görür ve Bob Go'ya hiçbir istek gönderilmez.

Canlı modlarda eklenti, Bob Go'ya mağaza alan adınızı, çıkış ve teslimat adreslerini ve sepet ürünlerini ürün fiyatlarıyla birlikte ZAR olarak gönderir. Canlı ücretler yalnızca müşteri bir şehir veya posta kodu girdikten sonra istenir. Bob Go'nun döndürdüğü her hizmet, Bob Go adıyla ayrı bir kargo seçeneği olarak gösterilir ve Delivery dates açıksa tahmini teslimat tarihleriyle birlikte gösterilir. Mağaza para biriminiz ZAR değilse ZAR cinsinden ücretler ZAR conversion rate ile dönüştürülür.

Ücretler sepet ve adres başına 1 saat önbelleğe alınır, böylece aynı sepet yeni bir istek tetiklemez. Başarısız bir istek 5 dakika önbelleğe alınır ve zaman aşımı 12 saniyedir; böylece bir Bob Go kesintisi her ödeme sayfası güncellemesini yavaşlatmaz. Başarısız bir istek ödeme sayfasını asla bozmaz: yöntem gizlenir veya yedek modda sabit fiyat kullanılır. Nedeni WooCommerce günlüğüne yazılır.

Seçilen Bob Go hizmet kodu ve teslimat tahmini, siparişin kargo satırıyla birlikte kaydedilir ve sipariş ekranında Bob Go service ve Estimated delivery olarak gösterilir.

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

Eklenti yalnızca ücret gösterir. Gönderi, irsaliye veya etiket oluşturmaz, paketleri takip etmez, siparişleri Bob Go ile senkronize etmez ve e-posta bildirimleri göndermez. Sipariş karşılama için Bob Go panosunu (veya Bob Go'nun kendi sipariş senkronizasyonunu) kullanın. Teslim noktası veya otomat seçimi (Bob Box, Pargo) ve ödeme sayfasında ek semt alanı yoktur. Bob Go yalnızca Güney Afrika içinde gönderim yapar.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bölümü WooCommerce > Settings > Shipping > VibeFox Bob Go sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bölüm durumu gösterir; örneğin lisansın hangi tarihe kadar etkin olduğunu 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 yalnızca bir alan adında çalışır. Anahtarı bir siteden kaldırmak, o sitenin alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Bob Go, ödeme sayfasında müşterilere gösterilmez. Oturum açmış mağaza yöneticileri yine de görür; (unlicensed — visible to admins only) ibaresiyle işaretlenir. Böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Plugins sayfasında ve WooCommerce sayfalarında bir hatırlatma çıkar. 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

Bob Go ö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). Ağırlık sınırlarını, Minimum order amount ve Excluded shipping classes ayarlarını kontrol edin. Sabit modda, ülke, * veya Flat price için bir fiyat olduğundan emin olun.

Hiçbir Bob Go ücreti gösterilmiyor: eklenti ayarlarını açın. Bob Go account bölümü Bob Go'dan gelen son yanıtı gösterir. "Channel is not installed" (HTTP 404), mağaza alan adının Bob Go'da bir satış kanalı olmadığı anlamına gelir: Store domain alanını kontrol edin. "Rates at checkout is not enabled" (HTTP 401) ise bu kanal için özelliğin kapalı olduğu anlamına gelir. Ayrıca müşterinin bir şehir veya posta kodu girdiğinden ve ZAR dışı mağazalarda ZAR conversion rate değerinin ayarlandığından emin olun. Ayrıntılar için Debug log seçeneğini açın ve WooCommerce > Status > Logs sayfasında ("vfd_bob_go" kaynağı) bakın. Bob Go live rates, fixed prices if Bob Go returns no rates seçeneğiyle, sorunu çözerken müşteriler yine sabit fiyatı alır.

Mağazam randta değil: Bob Go ZAR cinsinden fiyat verir. 1 ZAR'ın mağaza para biriminizde ne kadar olduğunu girin (örneğin EUR için 0.05). Bu olmadan eklenti Bob Go'dan ücret istemez. Sabit fiyatlar yine çalışır.

Kargoda vergi iki kez alınıyor: Bob Go ücretleri normalde KDV'yi içerir. Tax status değerini None olarak ayarlayın.

Bir değişiklikten sonra ücretler eski görünüyor: ayarlar sayfasını kaydedin. Bu, önbelleğe alınmış Bob Go ücretlerini temizler. Bob Go hesabınızdaki değişiklikler 1 saatlik önbellekten sonra veya ayarları kaydettiğinizde alınır.

Lisans bölümü bir hata gösteriyor: bölümdeki mesajı takip edin. Örneğin anahtar başka bir alan adında zaten kullanılıyorsa, vibefox.net hesabınızda bir yuvayı 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şılamıyorsa eklenti son bilinen durumla çalışmaya devam eder.

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için Plugins sayfasında devre dışı bırakın ve silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ayarlar, bölge yöntemleri ve önbelleğe alınmış ücretler yalnızca Remove data on uninstall açıksa kaldırılır. Aksi halde sonraki yeniden kurulum için saklanır. Mevcut siparişler kargo satırlarını korur.

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