VibeFox Mondial Relay for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0'da test edildi) veya 4.0.2 ve üzeri (4.1.0.3'te test edildi), varsayılan tema ile.

PHP: 8.0 veya üzeri.

Mondial Relay hesabı: marka kodu (Enseigne) ve özel anahtar, bir Mondial Relay işletme hesabıyla birlikte verilir: mondialrelay.fr üzerindeki profesyoneller bölümüne, "Connect" müşteri alanınıza ya da satış irtibat kişinize bakın. Harita seçicisi yalnızca marka kodunu gerektirir. En yakın noktalar listesi ise ikisini de gerektirir. Testler için Mondial Relay, PrivateK özel anahtarıyla birlikte BDTEST13 marka kodunu sağlar.

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

Kurulum

İndirme dosyası, her iki OpenCart sürümü için paketleri içeren tek bir zip dosyasıdır. Bilgisayarınızda açın. İçinde README.txt, OpenCart 3 paketi vfd_mondialrelay-oc3-(version).ocmod.zip ve OpenCart 4 paketi vfd_mondialrelay.ocmod.zip bulunur. Yalnızca kullandığınız OpenCart sürümünün paketini kurun. Lisans anahtarı iki sürüm için de aynıdır.

OpenCart 3

1. Yönetici panelinde Extensions > Installer sayfasına gidin, Upload düğmesine tıklayın ve vfd_mondialrelay-oc3-(version).ocmod.zip dosyasını seçin. Uzantı OCMOD değişiklikleri eklemez, bu yüzden Extensions > Modifications sayfasını yenilemeniz gerekmez. Installer yerine, paketin upload klasörünün içeriğini mağazanızın kök klasörüne de kopyalayabilirsiniz.

2. Extensions > Extensions sayfasına gidin ve uzantı türü olarak Shipping seçin. VibeFox Mondial Relay uzantısını bulun ve Install düğmesine (yeşil + düğmesi) tıklayın.

3. Ayarlar sayfasını açmak için Edit düğmesine (kalem düğmesi) tıklayın.

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

5. Marka kodunuzu (Enseigne) ve liste modu için özel anahtarı girin. Country prices alanını doldurun (örneğin Fransa için bir satır) ya da bir Fallback cost girin, Enable/Disable seçeneğini açın ve Save düğmesine tıklayın.

OpenCart 4

1. Yönetici panelinde Extensions > Installer sayfasına gidin, Upload düğmesine tıklayın ve vfd_mondialrelay.ocmod.zip dosyasını seçin. Dosya adını değiştirmeyin: OpenCart 4 eklenti kodunu dosya adından alır, adı değiştirilmiş paket çalışmaz.

2. Paket, aynı sayfadaki kurulu eklentiler listesinde görünür. Yanındaki Install düğmesine (yeşil +) tıklayın.

3. Extensions > Extensions sayfasına gidin ve eklenti türü olarak Shipping seçin. VibeFox Mondial Relay eklentisini bulun, Install düğmesine (yeşil +) ve sonra Edit düğmesine (kalem düğmesi) tıklayın.

4. Lisans anahtarını ve ayarları OpenCart 3'teki 4. ve 5. adımlarda olduğu gibi girin. Ayar sayfası ve alanları iki sürümde de aynıdır.

Kurulumdan sonra, Enable/Disable seçeneğini açıp kaydedene kadar yöntem kapalı kalır. Uzantıyı kaldırdıktan sonra yeniden kurarsanız, sakladığınız ayarlar yeniden kullanılır.

Yapılandırma

Tüm ayarlar uzantı sayfasındadır: Extensions > Extensions > Shipping > VibeFox Mondial Relay > Edit. Bölümler solda listelenir. Tek bir Save düğmesi tüm sayfayı yeniden yüklemeden kaydeder. Her kayıt ayrıca önbelleğe alınmış nokta listelerini temizler. Ayarları yalnızca bu uzantı için değiştirme yetkisine sahip yönetici kullanıcılar kaydedebilir.

Sayfanın üst kısmındaki uyarılar, kargo yöntemini gizleyen sorunları gösterir: marka kodu eksik, liste modunda özel anahtar eksik, Fransa, Belçika ya da İspanya için fiyat yok ve uzantının tanımadığı bir mağaza ağırlık birimi (bu durumda ürün ağırlıkları kg olarak alınır). Name boşsa, 64 karakterden uzunsa ya da < > ; = # { } karakterlerinden birini içeriyorsa, Min weight (kg), Max weight (kg) değerinden büyükse veya marka kodu geçerli değilse, sayfa bir hata gösterir ve hiçbir şey kaydedilmez. Sayı olmayan (ya da negatif) bir değer içeren bir sayı alanı, Save sonrasında bildirilir ve önceki değerini korur; diğer ayarlar kaydedilir.

Genel

Fransa, Belçika, Lüksemburg, İspanya, Portekiz ve Hollanda için Mondial Relay Point Relais teslimatı. Yöntem, coğrafi bölgesinde (bkz. Availability) ya da Ignore shipping zones açıkken listelenen ülkelerde sunulur.

Enable/Disable: ödeme sayfasında Mondial Relay'i gösterir veya gizler. Varsayılan: kapalı.

Name: sepette ve ödeme sayfasında müşterilere gösterilen kargo yöntemi adı. Varsayılan: Mondial Relay Point Relais. Zorunlu, en fazla 64 karakter.

Tax status: None (varsayılan), tablodaki fiyatların nihai olduğu anlamına gelir. Bir vergi sınıfı adı içeren Taxable seçeneği, OpenCart'ın o vergi sınıfının kargo vergisini fiyatların üzerine eklemesi anlamına gelir.

Sort order: ödeme sayfasındaki kargo yöntemleri arasında Mondial Relay'in konumu. Tam sayı.

Mondial Relay hesabı

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

Private Key: yalnızca List of nearest points seçicisi için gereklidir. Kaydettikten sonra alan boş kalır ve Saved - leave empty to keep it. ifadesini gösterir. Yalnızca değiştirmek için yeni bir değer girin. Kayıtlı anahtarı silmek için Remove the saved Private Key seçeneğini işaretleyin ve Save düğmesine tıklayın. Marka kodu ve özel anahtar 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.

Nokta seçici

Müşteri, ödeme adımına geçmeden önce bir Point Relais seçmelidir. Nokta siparişe kaydedilir.

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

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

Mondial Relay'in herkese açık bir tarife API'si yoktur: fiyat bu tablodan gelir.

Country prices: hedef ülke ve paket ağırlığına göre fiyat. Bir satır eklemek için Add country düğmesine, bir satırı silmek için silme düğmesine tıklayın. Diğer tüm ülkeler için ülke olarak * Default seçin. Her satırın bir Price alanı ve ağırlık sütunları vardır: 1 kg'a kadar XS, 1-2 kg S, 2-3 kg M, 3-5 kg L ve 5 kg'ın üzerinde XL. 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ıyorsanız Price alanını doldurun. Ondalık sayılar nokta veya virgülle yazılabilir (4.90 veya 4,90). Hiçbir fiyatı olmayan satırlar ve bilinmeyen ülkeli satırlar kaydederken silinir; sayı olmayan değerler bildirilir ve boş bırakılır.

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

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

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

Uygunluk

Min weight (kg): sepet daha hafif olduğunda yöntemi gizler. 0, sınır olmadığı anlamına gelir (varsayılan).

Max weight (kg): sepet daha ağır olduğunda yöntemi gizler. Mondial Relay, Points Relais'lerde 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.

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

Geo zone: yöntemi yalnızca bu coğrafi bölgedeki adresler için sunar. All zones (varsayılan) her yer anlamına gelir. Coğrafi bölgeler System > Localisation > Geo Zones bölümünde yönetilir. Ignore shipping zones açıkken kontrol edilmez.

Ignore shipping zones: açıkken Geo zone kontrol edilmez: yöntem yalnızca aşağıda listelenen ülkelerde ya da liste boşsa desteklenen tüm ülkelerde sunulur.

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'i olan ülkeleri içerir.

Gelişmiş

Debug log: tarife hesaplamalarını, Web Service çağrılarını ve nokta seçimlerini storage/logs/vfd_mrel_debug.log.php dosyasına yazar (OpenCart 4'te system/storage/logs/vfd_mrel_debug.log.php). Dosya web üzerinden okunamaz. Bu seçenek kapalı olsa bile hatalar her zaman günlüğe yazılır. Anahtarlar ve müşteri verileri asla günlüğe yazılmaz. Dosya 5 MB'a ulaştığında vfd_mrel_debug.old.log.php dosyasına taşınır ve yeni bir günlük başlatılır.

Log: hata ayıklama günlüğünün boyutunu ve son girişlerini gösterir. Boşaltmak için Clear log düğmesine tıklayın.

Remove data on uninstall: açıkken uzantıyı kaldırmak ayarları ve günlüğü siler. Kapalıyken (varsayılan) yeniden kurulum için korunur. Önbelleğe alınmış nokta listeleri her zaman silinir. Siparişlerde kayıtlı nokta(lar) korunur.

İçe / Dışa Aktarma

Export: ayarları özel anahtar olmadan bir JSON dosyası olarak kaydetmek için Download JSON düğmesine tıklayın.

Import: daha önce dışa aktarılmış JSON'u yapıştırın ve ayarları geri yüklemek için Import düğmesine tıklayın; örneğin başka bir mağazada. Save ile aynı kontroller uygulanır. Kayıtlı özel anahtar korunur.

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

Yöntem yalnızca Points Relais'i olan ülkeler için sunulur: Fransa, Belçika, Lüksemburg, İspanya, Portekiz ve Hollanda. Müşterilerin bir nokta seçemeyeceği durumlarda gizlenir: marka kodu yoksa ya da liste modunda özel anahtar yoksa. Geo zone ayarlıysa ve adres bölgenin dışındaysa yöntem sunulmaz. Ignore shipping zones açıkken coğrafi bölge kontrol edilmez ve yalnızca o listedeki ülkelere hizmet verilir (liste boşsa desteklenen tüm ülkelere).

OpenCart kargo yöntemlerini gösterdiğinde, uzantıdan fiyat ister. Yalnızca Requires Shipping değeri Yes olarak ayarlanmış ürünler sayılır: diğer ürünler ağırlık eklemez ve ara toplama dahil edilmez. Ürün ağırlıkları, OpenCart ağırlık sınıflarından kg'a çevrilir. Ara toplam, kupon indiriminden sonra ve vergiden önce, kargo gerektiren ürünlerin fiyatıdır. Uzantı sepet ağırlığını ve asgari ara toplamı kontrol eder. Fiyat, ülke satırından (ya da * satırından) gelir: ağırlık sütunu, yoksa Price. Satır yoksa yedek ücret kullanılır. Hiç fiyat yoksa yöntem gizlenir. Ara toplam Free shipping from değerine ulaşırsa fiyat 0 olur. Fiyat mağazanızın varsayılan para biriminde hesaplanır, ondalık basamaklarına yuvarlanır ve seçili Tax status vergisiyle müşterinin para biriminde gösterilir. Fiyatı hesaplamak için Mondial Relay'e istek gönderilmez.

OpenCart 4'te müşteri, ödeme sayfasındaki kargo yöntemi bloğunda Choose düğmesine tıklar ve Shipping method options penceresinde Mondial Relay seçeneğini seçer. Fiyatlar OpenCart 3'tekiyle aynıdır.

Uzantı canlı tarifeleri sorgulamaz: Mondial Relay'in herkese açık bir tarife API'si yoktur. Gönderi oluşturmaz, etiket basmaz 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 alma noktaları

Müşteri kargo yöntemi adımında Mondial Relay seçeneğini seçtiğinde, altında Mondial Relay pickup point kutusu görünür.

Harita modu: Choose a Point Relais düğmesi, teslimat ülkesi, posta kodu ve paket ağırlığı için Mondial Relay'in resmi haritasını bir pencerede açar. Müşteri bir nokta seçtikten sonra, nokta Selected: olarak gösterilir ve düğme Change Point Relais olur. Harita bileşeni widget.mondialrelay.com adresinden, harita kütüphanesi ise unpkg.com adresinden 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ı mesafeleriyle gösterir. Seçilen nokta çalışma saatleriyle gösterilir. Liste sunucunuz tarafından yüklendiği için bu liste için tarayıcıda üçüncü taraf bir komut dosyası ç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. Hiçbir nokta bulunamazsa ya da liste kullanılamazsa, müşteri "Teslim alma noktaları listesi şu anda kullanılamıyor. Lütfen haritayı kullanın." gibi bir mesaj görür ve harita sunulur.

Seçilen nokta, müşterinin oturumu için hemen kaydedilir. Nokta zorunludur. Müşteri Continue düğmesine tıkladığında, mağaza noktayı yeniden kontrol eder. Nokta yoksa müşteri Please choose a Mondial Relay pickup point. ifadesini görür ve ödemeye geçemez. Teslimat adresinden farklı bir ülkedeki bir nokta, noktanın teslimat ülkesinde olmadığını belirten bir mesajla reddedilir. Liste modunda nokta ayrıca adres için listeyle karşılaştırılır. Sipariş verildikten sonra seçim silinir, bu nedenle sonraki sepet yeniden seçim yapar.

OpenCart 4'te Mondial Relay pickup point kutusu, Shipping method options penceresinde Mondial Relay seçeneğinin altında görünür ve harita bu pencerenin içinde açılır. Escape tuşu yalnızca haritayı kapatır. Pencerenin Continue düğmesi, geçerli bir nokta olmadan ilerlemez; mesajlar aynıdır.

Sipariş verildiğinde nokta siparişle birlikte kalır. Siparişin kargo yöntemi, yöntem adını ve ardından noktanın adını, adresini ve numarasını gösterir; örneğin Mondial Relay Point Relais: TABAC DU LOUVRE, 12 RUE DE RIVOLI, 75001 PARIS (FR-066974). Böylece müşteri bunu sipariş e-postasında ve hesabındaki sipariş geçmişinde görür. Mağazaya giden yeni sipariş e-postası, noktayı numarasıyla birlikte yorum bölümünde gösterir. Sales > Orders bölümünde sipariş sayfası, noktanın adı, adresi ve Point Relais numarasıyla birlikte bir Mondial Relay pickup point paneli ya da No Point Relais was saved for this order. mesajını gösterir. OpenCart 4'te panel History bölümünün üzerinde gösterilir. OpenCart 4 ödeme için tek bir sipariş tutar ve müşteri her onaylamada onu günceller; siparişin noktası onunla birlikte güncellenir. Müşteri bu siparişi başka bir kargo yöntemine geçirirse noktası kaldırılır.

Lisans anahtarı

Uzantı, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Mondial Relay lisans bloğu, Extensions > Extensions > Shipping > VibeFox Mondial Relay > Edit sayfasında ayarların üstündeki ilk bloktur. Anahtarı License key alanına girin ve Activate düğmesine tıklayın. Bundan sonra blok anahtarı maskeli olarak, durumu (örneğin lisansın ne zamana kadar etkin olduğu tarih 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: opencart-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 uzantı için değiştirme yetkisine sahip yönetici kullanıcılar değiştirebilir. Bloğun metinleri yönetici dilini takip eder (İ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 sonra ya da hesabınızda bir alan adı yuvasını boşalttıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Bir anahtar tek bir alan adında çalışır: yapılandırmadaki OpenCart mağaza adresi. Anahtarı mağazadan kaldırmak alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan boşaltın.

Etkin bir anahtar olmadan Mondial Relay ödeme sayfasında müşterilere gösterilmez ve tarife hesaplanmaz. Yönetici paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, yöntemi yine de mağazada görür; yöntem (unlicensed — visible to admins only) ile işaretlenir. Böylece anahtarı satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu önizleme yoktur: mağaza yönetici girişini görmez, bu nedenle etkin bir anahtar yoksa yöntem herkesten gizlenir. Edit sayfasını bir kez açtıktan sonra yönetici Dashboard ekranında bir hatırlatma görünür. Bunu × ile kapatırsanız 7 gün gizlenir. 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, yönetici Dashboard ekranını veya Edit sayfasını açtığınızda otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonrasında haftada bir. Cron işi gerekmez. Eklentiyi kaldırmak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

Mondial Relay ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable/Disable seçeneğinin açık olduğunu kontrol edin. Geo zone ayarını ya da Ignore shipping zones seçeneğini ve ülke listesini kontrol edin. Uzantı sayfasının üst kısmındaki uyarıları kontrol edin: yöntem, marka kodu yoksa, liste modunda özel anahtar yoksa, fiyatı olmayan bir ülke için, ağırlık ve ara toplam sınırlarının dışındaysa ve Points Relais olmayan ülkelerde gizlenir. Ürünlerin Requires Shipping değerinin Yes olduğunu kontrol edin.

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

Nokta listesi boş ya da 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ı yenileyin ve nedeni uzantı sayfasındaki Log alanında görün.

Harita açılmıyor: harita widget.mondialrelay.com ve unpkg.com adreslerinden yüklenir. Bir gizlilik ya da betik engelleyicinin veya mağazanızın İçerik Güvenlik Politikası'nın (Content Security Policy) bunları engellemediğini kontrol edin. Harita yüklenemezse müşteri "Mondial Relay haritası yüklenemedi. Lütfen daha sonra tekrar deneyin ya da 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 ülkesinde bir nokta olmadan verildi. Nedeni günlüğe yazılır. Gönderiyi oluşturmadan önce müşteriden Point Relais'i isteyin.

Sayfada "Warning: You do not have permission to modify VibeFox Mondial Relay!" yazıyor: yönetici kullanıcı grubunuz ayarları yalnızca görüntüleyebilir. Gruba System > Users > User Groups bölümünde extension/shipping/vfd_mondialrelay (OpenCart 3) veya extension/vfd_mondialrelay/shipping/vfd_mondialrelay (OpenCart 4) için değiştirme yetkisi verin.

Kaldırma

Extensions > Extensions sayfasına gidin, Shipping türünü seçin ve VibeFox Mondial Relay yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. OpenCart her zaman Enable/Disable, Sort order, Tax status ve Geo zone ayarlarını sıfırlar. Önbelleğe alınmış nokta listeleri her zaman silinir. Remove data on uninstall açıksa diğer ayarlar ve hata ayıklama günlüğü de silinir. Kapalıysa, korunur ve uzantıyı yeniden kurduğunuzda tekrar kullanılır. Siparişlerde kayıtlı teslim alma noktaları her zaman korunur; mevcut siparişler kargo yöntemlerini ve maliyetlerini korur.

OpenCart 4'te eklenti dosyalarını da silmek için kaldırma işleminden sonra Extensions > Installer bölümüne gidin, kurulu eklentiler listesinde VibeFox Mondial Relay yanındaki Uninstall düğmesine (turuncu −) tıklayın, ardından yüklenen paketi silmek için Delete düğmesine (kırmızı çöp kutusu) tıklayın.

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