VibeFox Mondial Relay for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ile 9.x. Ödeme, Classic ve Hummingbird temalarıyla çalışır.

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

Mondial Relay hesabı: marka kodu (Enseigne) ve Private Key, bir Mondial Relay iş hesabıyla birlikte verilir: mondialrelay.fr üzerindeki profesyoneller bölümüne, "Connect" müşteri alanınıza veya satış temsilcinize bakın. Harita seçici yalnızca marka kodunu gerektirir. En yakın noktalar listesi ikisini de gerektirir. Testler için Mondial Relay, Private Key PrivateK ile birlikte BDTEST13 marka kodunu sağlar.

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

Kurulum

1. Yönetim 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 Mondial Relay öğesini bulup Configure düğmesine tıklayın.

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

4. Marka kodunuzu (Enseigne) ve liste modu için Private Key'i girin. Country prices alanını doldurun ve Save düğmesine tıklayın.

Kurulumda modül, Delivery to a Mondial Relay Point Relais of your choice teslimat süresi metniyle Mondial Relay Point Relais taşıyıcısını oluşturur. Taşıyıcı tüm müşteri gruplarına ve Fransa, Belçika, Lüksemburg, İspanya, Portekiz ve Hollanda bölgelerine atanır. Bölgeleri, müşteri gruplarını, teslimat süresini, logoyu ve boyut sınırlarını Shipping > Carriers üzerinden değiştirebilirsiniz. Fiyatları orada ayarlamayın: fiyat her zaman modülden gelir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Mondial Relay > Configure. 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ış nokta listelerini de temizler.

Sayfanın üstündeki uyarılar, taşıyıcıyı gizleyen sorunları gösterir: marka kodunun eksik olması, liste modunda Private Key'in eksik olması, Fransa, Belçika veya İspanya için fiyat olmaması ya da taşıyıcının silinmiş olması. Kaydedilemeyen değerler Save sonrasında bildirilir: sayı olmayan (veya negatif) bir değer içeren sayısal alan önceki değerini korur. 64 karakterden uzun bir ad veya Max weight (kg) değerinden büyük bir Min weight (kg) reddedilir ve hiçbir şey kaydedilmez. Mağazanın ağırlık birimi modülün bildiği birimlerden biri değilse, bir uyarı ürün ağırlıklarının kg olarak alındığını belirtir.

Genel

Enable/Disable: Mondial Relay'i açar veya kapatır. Bu, Shipping > Carriers içindeki taşıyıcı durumuyla aynı anahtardır.

Name: ödeme sırasında müşterilere gösterilen taşıyıcı adı. Varsayılan: Mondial Relay Point Relais. Zorunlu, en fazla 64 karakter.

Tax status: None tablodaki fiyatların kesin olduğu anlamına gelir. Bir vergi kuralı adıyla birlikte Taxable seçeneği, PrestaShop'un o kuralın kargo vergisini fiyatların üzerine eklediği anlamına gelir.

Mondial Relay hesabı

Brand code (Enseigne): zorunlu, en fazla 8 harf ve rakam; testler için örneğin BDTEST13. Teslim noktası haritası ve Web Service tarafından kullanılır. Bu olmadan müşteriler bir Point Relais seçemez ve taşıyıcı ödeme sırasında gösterilmez.

Private Key: yalnızca List of nearest points seçici için gereklidir. Kaydettikten sonra alan 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ı anahtarı silmek için Remove the saved Private Key kutusunu işaretleyin ve Save düğmesine tıklayın. Marka kodu ve Private Key ayarlandığında, Mondial Relay Web Service bağlantısı ayarları her kaydettiğinizde test edilir ve bir mesaj, bunların geçerli olup olmadığını gösterir.

Teslim noktası seçici

Selector: müşterinin bir Point Relais'i nasıl seçtiği.

Ücretler (mağazanızın varsayılan para biriminde, vergi hariç)

Country prices: hedef ülkeye ve paket ağırlığına göre fiyat. Satır eklemek için + Add country düğmesine, bir satırı kaldırmak için çöp kutusu simgesine tıklayın. Diğer tüm ülkeler için ülke olarak * Default seçin. Her satırda bir Price sütunu ile ağırlık sütunları bulunur: XS 1 kg'a kadar, S 1-2 kg, M 2-3 kg, L 3-5 kg ve XL 5 kg üzerinde. Boş veya 0 olan bir ağırlık sütunu Price sütununu kullanır. Price de boşsa, o ağırlık için teslimat ücretsizdir; bu yüzden yalnızca bazı ağırlık sütunlarını kullanırken Price alanını doldurun. Ondalık ayırıcı olarak nokta veya virgül (4.90 veya 4,90). Hiçbir fiyatı olmayan satırlar kaydetmede atılır, sayı olmayan değerler bildirilir ve boş bırakılır.

Fallback cost: tabloda satırı olmayan ülkeler için kullanılır. Bu ülkelerde taşıyıcıyı gizlemek için boş bırakın.

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

Free shipping from: teslimatın ücretsiz olduğu sepet ara toplamı (indirimler sonrası, vergi hariç). Ücretsiz kargo yoksa boş bırakın.

Kullanılabilirlik

Min weight (kg): sepet bundan hafifse taşıyıcıyı gizler. 0 sınır olmadığı anlamına gelir.

Max weight (kg): sepet bundan ağırsa taşıyıcıyı gizler. Mondial Relay, Points Relais'te 30 kg'a kadar paketleri kabul eder. Varsayılan: 30. 0 sınır olmadığı anlamına gelir. Boş alan 30 kg anlamına gelir. Min weight (kg) değerinden düşük olamaz.

Minimum subtotal: taşıyıcıyı yalnızca sepet ara toplamı (kargo gerektiren ürünler, indirimler sonrası, vergi hariç) bu tutarın en az üzerindeyse gösterir. Her zaman göstermek için boş bırakın.

Ignore shipping zones: taşıyıcıyı aşağıdaki ülkeler için sunar; liste boşsa, taşıyıcının bölgelerinde bulunmasalar bile desteklenen tüm ülkeler için sunar. Açık olduğu sürece taşıyıcı, daha sonra oluşturacaklarınız dahil her aktif bölgeye bağlanır. Kapattığınızda taşıyıcı, daha önce sahip olduğu bölgeleri geri alır.

Countries (ignore zones): bu mod için hedef ülkeler. Bu alan yalnızca Ignore shipping zones açıkken kullanılır. Liste yalnızca Points Relais bulunan ülkeleri içerir.

Gelişmiş

Debug log: ücret hesaplamalarını ve Web Service çağrılarını modül klasöründeki logs/vfd_mrel_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Hatalar, bu seçenek kapalıyken bile her zaman kaydedilir. Anahtarlar ve müşteri verileri hiçbir zaman kaydedilmez.

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çıksa, modülü kaldırmak ayarları ve taşıyıcıyı siler. Kapalıysa, kaldırmak yalnızca taşıyıcıyı kapatır. Siparişlerde kaydedilmiş teslim noktaları korunur.

Ödemede nasıl çalışır

Taşıyıcı yalnızca Points Relais bulunan ülkeler için sunulur: Fransa, Belçika, Lüksemburg, İspanya, Portekiz ve Hollanda. Müşteriler bir nokta seçemeyecekse gizlenir: marka kodu olmadan veya liste modunda Private Key olmadan.

Kargo adımında PrestaShop fiyat için modülden bilgi ister. Yalnızca fiziksel ürünler sayılır: sanal ürünler ağırlık eklemez ve ara toplama dahil edilmez. Modül sepet ağırlığını ve minimum ara toplamı kontrol eder. Fiyat, ülkenin satırından (veya * satırından) gelir: ağırlık sütunu, yoksa Price. Satır yoksa yedek ücret kullanılır. Fiyat yoksa taşıyıcı gizlenir. Ara toplam Free shipping from değerine ulaşırsa fiyat 0 olur. Fiyat mağazanın varsayılan para biriminde hesaplanır ve ardından müşterinin sepet para biriminde gösterilir.

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

Modül canlı fiyat sorgulamaz: Mondial Relay'in herkese açık bir tarife API'si yoktur. Gönderi oluşturmaz, etiket yazdırmaz ve paketleri takip etmez. Gönderileri, siparişte gösterilen Point Relais numarasını kullanarak Mondial Relay "Connect" alanınızda oluşturun. Ev adresine teslimat (Domicile) sunulmaz.

Teslim noktaları

Müşteri teslimat adımında Mondial Relay taşıyıcısını seçtiğinde, bunun altında bir Mondial Relay pickup point kutusu belirir.

Harita modu: Choose a Point Relais düğmesi, teslimat ülkesi, posta kodu ve paket ağırlığı için resmî Mondial Relay haritasını bir pencerede açar. Müşteri bir nokta seçtikten sonra, nokta Selected: olarak gösterilir ve düğme Change Point Relais olarak değişir. Harita widget'ı widget.mondialrelay.com'dan, harita kütüphanesi ise unpkg.com'dan yalnızca müşteri haritayı açtığında yüklenir. Bunu gizlilik politikanızda belirtin.

Liste modu: - Choose a Point Relais - açılır listesi, teslimat posta kodu için en yakın 10 noktayı mesafesiyle birlikte gösterir. Seçilen nokta çalışma saatleriyle gösterilir. Liste sunucunuz tarafından yüklendiği için tarayıcıda üçüncü taraf bir betik çalışmaz. Listeler 12 saat, boş yanıtlar 1 saat önbelleğe alınır ve başarısız bir istek 5 dakika hatırlanır. Web Service zaman aşımı 10 saniyedir. Posta kodu yoksa müşteri Enter your postcode to see the nearest pickup points. ifadesini görür. Nokta bulunamazsa veya liste kullanılamazsa, müşteri "Teslim noktaları listesi şu anda kullanılamıyor. Lütfen haritayı kullanın." gibi bir mesaj görür ve harita sunulur.

Seçilen nokta hemen sepete kaydedilir. Nokta zorunludur. Nokta yoksa müşteri Please choose a Mondial Relay pickup point. uyarısını görür ve ödemeye devam edemez. Teslimat adresinden farklı bir ülkedeki nokta reddedilir. Liste modunda nokta ayrıca adres için listeyle karşılaştırılır.

Sipariş verildiğinde nokta siparişte kalır. Yönetim paneli sipariş sayfasında, nokta adı, adresi ve Point Relais number (örneğin FR-066974) ile birlikte Mondial Relay pickup point bloğu gösterilir. Müşteri noktayı sipariş onay sayfasında ve hesabındaki sipariş ayrıntılarında görür. Sipariş onay e-postasında ve E-posta uyarıları modülünün yeni sipariş e-postasında nokta, taşıyıcı adından sonra eklenir.

Lisans anahtarı

Modül, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Mondial Relay lisans bloğu, Modules > Module Manager > VibeFox Mondial Relay > Configure sayfasında ayarların üstündeki ilk bloktur. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bundan sonra blok, anahtarı maskelenmiş olarak, durumu (örneğin lisansın geçerli olduğu son tarih ve alan adınız) ve şu düğmeleri gösterir: durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu mağazadan kaldırmak için Remove key. Bunların altında Product: presta-shipping-mondialrelay 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 modül için Configure izni olan çalışanlar değiştirebilir. Bloğun metinleri yönetim paneli dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini belirtir; ö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 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 modül son bilinen durumla çalışmaya devam eder.

Bir anahtar yalnızca bir alan adında çalışır: çok mağazalı kurulumda da ana mağazanın alan adında. 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 Mondial Relay taşıyıcısı ödeme sırasında müşterilere gösterilmez ve hiçbir ücret hesaplanmaz. PrestaShop vitrini yönetim 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 sırasında test edemezsiniz. Modules > Module Manager bölümünde 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önetim panelinde çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, sonrasında haftada bir kez. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

Mondial Relay ödeme sırasında görünmüyor: lisansın etkin olduğunu ve Enable/Disable seçeneğinin açık olduğunu kontrol edin. Shipping > Carriers içinde taşıyıcının müşterinin ülkesinin bölgesini ve müşteri grubunu kapsadığını doğrulayın veya Ignore shipping zones seçeneğini açın. Modül sayfasının üstündeki uyarıları kontrol edin: taşıyıcı, marka kodu olmadan, liste modunda Private Key olmadan, fiyatı olmayan bir ülke için, ağırlık ve ara toplam sınırlarının dışında ve Points Relais bulunmayan ülkeler için gizlenir. Ürünler de ürün sayfasında belirli taşıyıcılarla sınırlandırılmış olabilir.

Kaydetmeden sonra Web Service testi başarısız oldu: mesaj Mondial Relay hatasını gösterir; örneğin geçersiz bir marka kodu veya geçersiz bir güvenlik anahtarı. Marka kodunu ve Private Key'i Mondial Relay ile kontrol edin.

Nokta listesi boş veya kullanılamıyor: müşterinin önce bir teslimat posta kodu girmesi gerekir. Web Service çalışmazsa bunun yerine harita sunulur. Debug log seçeneğini açın, ödeme sayfasını yeniden yükleyin ve nedeni modül sayfasındaki Log alanında inceleyin.

Harita açılmıyor: harita widget.mondialrelay.com ve unpkg.com'dan yüklenir. Bir gizlilik veya betik engelleyicinin bunları engellemediğini kontrol edin. Harita yüklenemezse müşteri "Mondial Relay haritası yüklenemedi. Lütfen daha sonra tekrar deneyin veya başka bir kargo yöntemi seçin." mesajını görür.

Sipariş sayfası "No Point Relais was saved for this order" mesajını gösteriyor: sipariş, teslimat ülkesine ait bir nokta olmadan verildi. Neden günlüğe yazılır. Gönderiyi oluşturmadan önce müşteriden Point Relais'i isteyin.

Sayfa Mondial Relay taşıyıcısının bulunamadığını gösteriyor: taşıyıcı Shipping > Carriers içinde silinmiş. Yeniden oluşturmak için Modules > Module Manager içinde modülü sıfırlayın.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Mondial Relay yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı ve lisans durumu her zaman silinir. Önbelleğe alınmış teslim noktası listeleri her zaman silinir. Remove data on uninstall açıksa taşıyıcı silinir (siparişler geçmişini korur), ayarlar, günlük ve siparişi olmayan sepetlerdeki noktalar kaldırılır. Kapalıysa taşıyıcı yalnızca kapatılır ve tüm ayarlar korunur. Modülü yeniden kurmak, taşıyıcının önceki durumunu geri yükler. Siparişlerde kaydedilmiş teslim noktaları her zaman korunur.

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