VibeFox Bob Go for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

PHP: 8.0 veya üzeri. Modül, eski PHP sürümlerine kurulmayı reddeder.

Bob Go hesabı (yalnızca canlı ücretler için): Bob Go API anahtarı kullanmaz. Bir Bob Go hesabına (bobgo.co.za), Bob Go hesabınızda (Sales channels) WooCommerce satış kanalı olarak kurulu mağazanıza ve bu kanal için etkin "Rates at checkout" özelliğine ihtiyacınız vardır. Hizmetler, fiyatlar ve kurallar Bob Go üzerinden ayarlanı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 bir alan adında çalışır.

Kurulum

1. Yönetici panelinde Modules > Module Manager bölümüne gidin ve Upload a module düğmesine tıklayın. Modülün ZIP dosyasını seçin.

2. Yükleme bittiğinde Configure düğmesine tıklayın veya daha sonra modül listesinde VibeFox Bob Go öğesini bulup Configure düğmesine tıklayın.

3. Configure sayfasının üstündeki lisans bloğunda, VibeFox lisans anahtarınızı License key alanına girin ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

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

5. Configure sayfasında mağaza alan adını, çıkış adresini (nereden gönderdiğiniz) ve mağazanızın para birimi ZAR değilse ZAR dönüşüm oranını kontrol edin (bkz. Yapılandırma). Mağazanızdaki Güney Afrika adreslerinde il yoksa Add South African provinces düğmesine tıklayın. Save düğmesine tıklayın.

Kurulumda modül, Courier delivery (South Africa) teslimat süresi metniyle Bob Go taşıyıcısını oluşturur. Taşıyıcı etkindir, tüm bölgelere ve tüm müşteri gruplarına atanır ve varsayılan olarak Bob Go canlı ücretlerini kullanır. Bölgeleri, müşteri gruplarını, teslimat süresini, logoyu ve boyut sınırlarını Shipping > Carriers bölümünde değiştirebilirsiniz. Orada fiyat belirlemeyin: fiyat her zaman modülden gelir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Bob Go > Configure. Taşıyıcının tüm bölgelerinde geçerlidir. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Her kayıt, önbelleğe alınmış Bob Go ücretlerini de temizler. Sayılarda ondalık ayırıcı olarak nokta veya virgül kullanılabilir. Bir değer hatalıysa sayfa bir hata gösterir ve hiçbir şey kaydedilmez: sayı olmayan bir değer ("…" must be a number.), negatif bir tutar veya ağırlık ("…" must be a number of 0 or more.), 0 veya daha küçük bir ZAR conversion rate, Maximum weight değerinden büyük bir Minimum weight, ya da 64 karakterden uzun bir Method title.

Formun üstünde sayfa, canlı ücretlerin çalışamayacağı durumlarda uyarır: Live rates are not requested: your store currency is … — set the "ZAR conversion rate"., Güney Afrika adreslerinde il yoksa (aşağıdaki Güney Afrika illeri bölümüne bakın) veya mağazanın ağırlık ya da boyut birimi tanınmıyor ve kg ya da cm olarak işleniyorsa. Birimleri International > Localization (Local units) bölümünde ayarlayın.

Genel

Enable Bob Go: taşıyıcıyı açar veya kapatır. Bu, Shipping > Carriers bölümündeki taşıyıcı durumuyla aynı anahtardır.

Method title: müşterinin gördüğü taşıyıcı adı. Bob Go hizmetleri, örneğin "The Courier Guy - Economy", ödeme sayfasında bunun altında Bob Go'dan gelen adlarıyla listelenir. Varsayılan: Bob Go. Zorunlu, en fazla 64 karakter.

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

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

Bob Go hesabı

Bu bölüm Bob Go'da neye ihtiyacınız olduğunu açıklar ve 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), ya da hata koduyla birlikte request failed veya no connection.

Store domain: Bob Go mağazanızı alan adına göre tanır. Mağazanızın alan adını kullanmak için boş bırakın; alan adı yer tutucu olarak gösterilir. Bob Go'daki kanalınız farklı bir adreste kuruluysa başka bir alan adı girin; örneğin bir alt klasördeki mağaza için example.co.za/shop. Şema ve sondaki eğik çizgi kaldırılır.

ZAR conversion rate: Bob Go, ücretleri Güney Afrika randı (ZAR) cinsinden verir. Mağazanızın varsayılan para birimi ZAR değilse, 1 ZAR'ın para biriminizde ne kadar olduğunu girin; örneğin 0.05. Ücretler bu oranla dönüştürülür ve ürün fiyatları Bob Go'ya ZAR olarak gönderilir. Para biriminizde Bob Go canlı ücretlerini kullanmak istemiyorsanız boş bırakın (sabit fiyatlar çalışmaya devam eder). Oran 0'dan büyük olmalıdır. Mağaza para biriminiz ZAR ise boş bırakın.

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

Gönderim yeri (çıkış adresi)

Çıkış adresi, her ücret isteğiyle birlikte Bob Go'ya gönderilir. Shop Parameters > Contact > Stores bölümündeki mağaza adresi 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 ili 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.

Güney Afrika illeri: PrestaShop'ta Güney Afrika için il yoktur; bu nedenle oradaki müşteri adreslerinde il bulunmaz, oysa Bob Go bir il bekler. Güney Afrika'nın eyaleti olarak 9 ili (kodlar EC, FS, GP, KZN, LP, MP, NC, NW, WC) eklemek ve Güney Afrika adreslerinde eyalet alanını göstermek için Add South African provinces düğmesine tıklayın. Kod veya ad bakımından zaten bulunan iller yeniden eklenmez. Düğmeye tıklayana kadar hiçbir şey değişmez. İller eklendiğinde alan, sayısıyla birlikte South African addresses have a province gösterir.

Sabit fiyatlar (Shipping cost Fixed prices (below) olduğunda ve Bob Go ücret döndürmediğinde yedek olarak kullanılır)

Price per country: her ülke için bir satır: 2 harfli ülke kodu, eşittir işareti ve mağaza varsayılan para biriminde, vergi hariç fiyat; örneğin ZA=99.99. Diğer tüm ülkeler için * kullanın; örneğin sonraki satırda *=199.99. Başka biçimdeki satırlar kaydedilirken silinir ve sayfa bunları bir uyarıda listeler.

Flat price: yukarıda satırı olmayan ülkeler için fiyat. Bu ülkelerde taşıyıcıyı gizlemek için boş bırakın.

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

Koşullar

Minimum weight: sepet ağırlığı bunun altındayken taşıyıcıyı gizler (kg cinsinden). 0, sınır olmadığı anlamına gelir (varsayılan).

Maximum weight: sepet ağırlığı bunun üstündeyken taşıyıcıyı gizler (kg cinsinden). 0, sınır olmadığı anlamına gelir (varsayılan). İki sınır da ayarlanmışsa minimum, maksimumdan büyük olamaz.

Minimum order amount: taşıyıcıyı yalnızca sepet ara toplamı (kargo gerektiren ürünler, indirimlerden sonra, vergilerden önce) bu tutarın en az üstündeyse gösterir. Her zaman göstermek için boş bırakın.

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

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

Tax: taşıyıcının vergi kuralı veya No tax (varsayılan). Bob Go ücretleri genellikle KDV'yi zaten içerir. Bu durumda vergiyi iki kez almamak için No tax seçili kalmalıdır.

Kargo bölgeleri olmadan kullanılabilirlik

Ignore shipping zones: açıkken taşıyıcı, daha sonra oluşturulanlar dahil tüm bölgelere bağlanır ve aşağıdaki ülkeler için sunulur. Kapalıyken yalnızca Shipping > Carriers bölümündeki taşıyıcı bölgelerinde sunulur; daha önce sahip olduğu bölgeler geri verilir.

Countries: bu mod için hedef ülkeler. Gönderim yaptığınız tüm ülkelere izin vermek 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 modül klasöründeki logs/vfd_bobg_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. Müşteri adresleri kaydedilmez. Bob Go hataları, bu kapalı olsa bile kaydedilir. İşiniz bittiğinde kapatın.

Log: günlüğün boyutunu ve son kayıtlarını gösterir. Temizlemek için Clear log düğmesine tıklayın.

Remove data on uninstall: açıkken modülü kaldırmak Bob Go ayarlarını, taşıyıcıyı, önbelleğe alınmış ücretleri ve günlükleri siler. Siparişlerle kaydedilen Bob Go hizmeti korunur. Kapalıyken yeniden kurulum için her şey korunur.

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

Kargo adımında PrestaShop, modülden Bob Go fiyatını ister. Yalnızca fiziksel ürünler sayılır: sanal ürünler ağırlık eklemez ve sipariş tutarına dahil edilmez. Modül önce hedef ülkeyi (Ignore shipping zones ile), sepet ağırlığını ve Minimum order amount değerini kontrol eder. Ücretsiz kargo uygulanırsa taşıyıcı ücretsiz olarak gösterilir ve Bob Go'ya istek gönderilmez.

Canlı modlarda modül, Bob Go'ya mağaza alan adınızı, çıkış ve teslimat adreslerini (il bilgisiyle) ve sepet ürünlerini, ürün fiyatları ZAR cinsinden olacak şekilde gönderir. Canlı ücretler, müşteri bir şehir veya posta kodu girdikten sonra istenir. Mağaza para biriminiz ZAR değilse ZAR'daki ücretler ZAR conversion rate ile dönüştürülür. Fiyat, mağazanızın varsayılan para biriminde hesaplanır ve ardından müşterinin sepet para biriminde gösterilir.

Bob Go taşıyıcısının altında müşteri Choose a delivery service: başlığını ve her Bob Go hizmeti için bir seçenek görür; seçenekte hizmet adı, fiyat ve Delivery dates açıksa tahmini teslimat tarihleri bulunur. İlk hizmet varsayılan olarak seçilidir. Müşteri başka bir hizmet seçtiğinde seçim hemen kaydedilir ve taşıyıcı fiyatı ile sepet toplamı güncellenir. Taşıyıcı, seçilen hizmetin ücreti kadar tutar. Hizmet adres için artık sunulmuyorsa müşteri This service is not available for your address any more. Please choose another one. mesajını görür. Kayıt başarısız olursa mesaj The service could not be saved. Please try again. şeklindedir. Hizmet listesi Classic ve Hummingbird temalarıyla çalışır.

Ücretler, her tam istek için 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 Bob Go kesintisi her ödeme sayfası güncellemesini yavaşlatmaz. Başarısız bir istek ödeme sayfasını asla bozmaz: taşıyıcı gizlenir ya da yedek modda sabit fiyat kullanılır. Nedeni günlüğe yazılır.

Taşıyıcıyı, siparişleri olduktan sonra Shipping > Carriers bölümünde düzenlerseniz PrestaShop bunu taşıyıcının yeni bir sürümü olarak kaydeder. Modül yeni sürümü otomatik olarak izler.

Modül yalnızca ücret gösterir. Gönderi, irsaliye veya etiket oluşturmaz, paketleri takip etmez, siparişleri Bob Go ile senkronize etmez ve bildirim göndermez. Sipariş yerine getirme için Bob Go panelini kullanın. Teslim noktası veya otomat seçeneği yoktur. Bob Go yalnızca Güney Afrika içinde gönderim yapar.

Siparişler

Sipariş verildiğinde seçilen Bob Go hizmeti, kodu ve teslimat tahmini siparişle birlikte kaydedilir. Sepetteki veya Bob Go fiyatlarındaki sonraki değişiklikler bunları değiştirmez.

Yönetici panelinde sipariş sayfası, Bob Go service (ad ve kod) ve Estimated delivery alanlarını içeren bir Bob Go bloğu gösterir. Müşteri, hesabındaki sipariş ayrıntıları sayfasında Bob Go service ve Estimated delivery bilgilerini görür. Sabit fiyatlı veya ücretsiz kargolu siparişlerde Bob Go hizmeti yoktur.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Bob Go lisans bloğu, ayarların üstünde, Modules > Module Manager > VibeFox Bob Go > Configure sayfasındaki ilk bloktur. Anahtarı License key alanına girin ve Activate düğmesine tıklayın. Bundan sonra blok, anahtarı gizli olarak, durumu (örneğin lisansın hangi tarihe kadar etkin olduğunu 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: presta-shipping-bob-go satırı ve vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca modül için Configure izni olan çalışanlar değiştirebilir. Bloğun metinleri yönetici panelinin diline uyar (İ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 tarihiyle birlikte License expired on. Mağaza adresi değiştikten veya hesabınızda bir alan adı yuvası serbest bıraktıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa modül son bilinen durumla çalışmaya devam eder.

Bir anahtar bir alan adında çalışır: ana mağazanın alan adında, çoklu mağaza kurulumunda da. 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 Bob Go taşıyıcısı ödeme sayfasında müşterilere gösterilmez ve hiçbir ücret hesaplanmaz. PrestaShop'un mağaza ön yüzü yönetici paneline giriş yaptığınızı bilmez; bu yüzden taşıyıcı sizden de gizlenir: modülü bir anahtar satın almadan önce ayarlayabilirsiniz, ancak ödeme sayfasında test edemezsiniz. Modules > Module Manager bölümündeki Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez.

Bir lisansın süresi dolduğunda modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetici panelinde çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonra haftada bir kez. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

Bob Go ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable Bob Go seçeneğinin açık olduğunu kontrol edin. Shipping > Carriers bölümünde taşıyıcının müşterinin ülkesinin bölgesini ve müşterinin grubunu kapsadığını kontrol edin ya da Ignore shipping zones seçeneğini açıp Countries alanını inceleyin. Ağırlık sınırlarını ve Minimum order amount değerini kontrol edin. Sabit fiyat modunda ülkenin, * değerinin veya Flat price değerinin bir fiyatı olduğunu doğrulayın. Ürün sayfasında ürünler belirli taşıyıcılarla da sınırlandırılabilir.

Bob Go ücretleri gösterilmiyor: modül sayfasını açın. Bob Go hesabı bölümü, Bob Go'dan gelen son yanıtı gösterir. "The WooCommerce channel is not installed on Bob Go" (HTTP 404), mağaza alan adınızı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), 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ışı para birimli mağazalarda ZAR conversion rate değerinin ayarlı olduğundan emin olun. Debug log seçeneğini açın, ödeme sayfasını yenileyin ve Log alanına bakın. Bob Go live rates, fixed prices if Bob Go returns no rates seçeneğiyle, sorunu düzeltirken müşteriler yine de sabit fiyatı alır.

Mağazam randla çalışmıyor: Bob Go ücretleri ZAR cinsinden verir. 1 ZAR'ın mağaza para biriminizde ne kadar olduğunu girin. Bu olmadan modül Bob Go'dan ücret istemez. Sabit fiyatlar çalışmaya devam eder.

Sayfa, Güney Afrika adreslerinde il olmadığını uyarıyor: Gönderim yeri (çıkış adresi) bölümündeki Add South African provinces düğmesine tıklayın. Mevcut müşteri adreslerine yalnızca düzenlendiklerinde il eklenir.

Kargoda vergi iki kez alınıyor: Bob Go ücretleri normalde KDV'yi içerir. Tax seçeneğini No tax olarak ayarlayın.

Bir değişiklikten sonra ücretler eski görünüyor: modül sayfasındaki Save düğmesine tıklayın. Bu, önbelleğe alınmış Bob Go ücretlerini temizler. Bob Go hesabınızdaki değişiklikler 1 saatlik önbellek dolduğunda veya ayarları kaydettiğinizde alınır.

Sayfa Bob Go taşıyıcısının bulunamadığını söylüyor: taşıyıcı Shipping > Carriers bölümünde silinmiş. Yeniden oluşturmak için Modules > Module Manager bölümünde modülü sıfırlayın.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Bob Go yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı, lisans durumu ve önbelleğe alınmış ücretler her zaman kaldırılır. Remove data on uninstall açıksa taşıyıcı silinir (siparişler geçmişini korur) ve ayarlar, günlük ile açık sepetlerin hizmet seçimleri kaldırılır. Kapalıysa taşıyıcı yalnızca devre dışı bırakılır ve tüm ayarlar korunur. Modülü yeniden kurmak veya Reset yapmak, kayıtlı taşıyıcıya daha önceki durumunu geri verir: etkin bir taşıyıcı yeniden etkinleşir, devre dışı bir taşıyıcı devre dışı kalır. Siparişlerle kaydedilen Bob Go hizmeti her zaman korunur.

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