VibeFox Mondial Relay for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

WooCommerce: 7.0 veya üzeri, kurulu ve etkin. Eklenti, WooCommerce olmadan etkinleşmez.

PHP: 8.0 veya üzeri.

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 ya da satış temsilcinize bakın. Harita seçicisi yalnızca marka kodunu gerektirir. En yakın noktalar listesi ikisini de gerektirir. Test 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 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_mondialrelay 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 Mondial Relay ya da Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

4. VibeFox lisans anahtarınızı sayfanın üstündeki lisans bloğuna girin ve Activate düğmesine tıklayın.

5. Marka kodunuzu (Enseigne) ve liste modu için Private Key'i girin. Country prices alanını doldurun.

6. WooCommerce > Settings > Shipping > Shipping zones bölümünde, teslimat yaptığınız ülkelerin kargo bölgelerine VibeFox Mondial Relay ekleyin ya da Ignore shipping zones seçeneğini açın.

Yapılandırma

Tüm ayarlar tek bir sayfada: WooCommerce > Settings > Shipping > VibeFox Mondial Relay. Tüm kargo bölgeleri için geçerlidir. Yöntemi bir bölgeye eklediğinizde, bölge penceresinde yalnızca bir alan bulunur:

Title (zone): ödeme sayfasındaki bu seçeneğin adı. Genel Name değerini kullanmak için boş bırakın.

Sayfanın üstündeki uyarılar, yöntemi gizleyen sorunları gösterir: marka kodunun eksik olması, liste modunda Private Key'in eksik olması ve Fransa, Belçika veya İspanya için fiyat olmaması.

Genel

Enable/Disable: Mondial Relay'i genel olarak açar veya kapatır.

Name: ödeme sayfasında müşterilere gösterilen kargo yönteminin adı. Varsayılan: Mondial Relay Point Relais.

Tax status: Taxable kargo ücretine WooCommerce vergisini ekler, None eklemez.

Mondial Relay hesabı

Brand code (Enseigne): zorunlu, en fazla 8 karakter; 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, bu nedenle yöntem ödeme sayfasında gösterilmez.

Private Key: yalnızca List of nearest points seçicisi için gereklidir. Marka kodu ve Private Key ayarlandığında, ayarları her kaydettiğinizde Mondial Relay Web Service bağlantısı test edilir ve bir mesaj bunların geçerli olup olmadığını gösterir.

Teslim noktası seçicisi

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

Ücretler (mağaza para biriminizde)

Country prices: hedef ülke ve paket ağırlığına göre fiyat. Yeni satır eklemek için + Add country düğmesine, bir satırı kaldırmak için çarpı işaretine tıklayın. Diğer tüm ülkeler için * Default satırını kullanın. Her satırda bir Price ve 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 üzeri. Boş ya da 0 olan bir ağırlık sütunu Price sütununu kullanır. Ondalık ayırıcı olarak nokta ya da virgül (4.90 veya 4,90). Kaydederken hiçbir fiyatı olmayan satırlar 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 hesaplanacağı.

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

Kullanılabilirlik

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

Max weight (kg): sepet bundan ağırsa 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.

Minimum subtotal: yöntemi yalnızca sepet ara toplamı bu tutara en az ulaştığında gösterir. Her zaman göstermek için boş bırakın.

Disabled shipping classes: sepette bu WooCommerce kargo sınıflarından ürün varsa yöntemi gizler.

Ignore shipping zones: yöntemi aşağıdaki ülkeler için sunar; liste boşsa, hiçbir kargo bölgesi onları içermese bile desteklenen tüm ülkeler için sunar.

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

Gelişmiş

Debug log: fiyat hesaplamasını ve Web Service çağrılarını WooCommerce > Status > Logs sayfasına (kaynak vfd-mondialrelay) kaydeder. Hatalar bu seçenek kapalı olsa bile her zaman kaydedilir. Anahtarlar ve müşteri verileri kaydedilmez.

Remove data on uninstall: açıkken eklentiyi silmek, ayarları ve bölge yöntemlerini kaldırır. Devre dışı bırakma hiçbir şeyi silmez. Siparişlerde kayıtlı teslim noktaları korunur.

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

Yöntem yalnızca Points Relais bulunan ülkeler için sunulur: Fransa, Belçika, Lüksemburg, İspanya, Portekiz ve Hollanda. Müşteri bir nokta seçemeyecekse gizlenir: marka kodu yoksa ya da liste modunda Private Key yoksa.

Müşteri bir teslimat adresi girdiğinde WooCommerce eklentiden bir fiyat ister. Eklenti sepet ağırlığını, minimum ara toplamı ve hariç tutulan kargo sınıflarını 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. Fiyat yoksa yöntem gizlenir. Ara toplam Free shipping from değerine ulaşırsa fiyat 0 olur.

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

Eklenti 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ı

Harita modu: müşteri Mondial Relay'i seçtiğinde, yöntemin altında Choose a Point Relais düğmesi görünür. Bu düğme teslimat ülkesi, posta kodu ve paket ağırlığı için resmî Mondial Relay haritasını açar. Müşteri bir nokta seçtikten sonra nokta Selected: olarak gösterilir ve düğme Change Point Relais olur. 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ı mesafeleriyle 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. Liste kullanılamazsa müşteri "The list of pickup points is not available right now. Please use the map." mesajını görür ve harita sunulur.

Bir nokta zorunludur. Nokta olmadan müşteri Please choose a Mondial Relay pickup point. mesajını görür ve sipariş verilmez. Teslimat adresinden farklı bir ülkedeki nokta reddedilir. Liste modunda nokta, adres için oluşturulan listeyle de kontrol edilir.

Point Relais numarası, ülke, ad ve adres siparişe kaydedilir. Bunlar sipariş ekranında teslimat adresinin altında (Point Relais numarasıyla birlikte), teşekkür sayfasında, My account > Orders bölümünde ve sipariş e-postalarında (HTML ve düz metin) Mondial Relay pickup point olarak gösterilir.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Shipping > VibeFox Mondial Relay sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blok 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 düğmesini 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, o sitenin alan adı hakkını serbest bırakmaz. Hakkı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Mondial Relay ödeme sayfasında müşterilere gösterilmez. Oturum açmış mağaza yöneticileri yine de onu (unlicensed — visible to admins only) etiketiyle görür; böylece bir anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Plugins 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

Mondial Relay ö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 (ya da Ignore shipping zones açıksa ve ülke izinliyse). Ayarlar sayfasının üstündeki uyarılara bakın: yöntem; marka kodu yoksa, liste modunda Private Key yoksa, fiyatı olmayan bir ülke için, ağırlık ve ara toplam sınırlarının dışında kalan siparişlerde ve Points Relais bulunmayan ülkeler için gizlenir.

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 güvenlik anahtarı. Marka kodunu ve Private Key'i Mondial Relay ile kontrol edin.

Nokta listesi boş ya da kullanılamıyor: müşterinin önce bir posta kodu girmesi gerekir. Web Service çalışmazsa bunun yerine harita sunulur. Nedenini görmek için Debug log seçeneğini açın ve WooCommerce > Status > Logs sayfasını (kaynak vfd-mondialrelay) açın.

Harita açılmıyor: harita widget.mondialrelay.com ve unpkg.com'dan yüklenir. Bir gizlilik ya da betik engelleyicinin bunları engellemediğini kontrol edin. Geliştiriciler betik URL'lerini vfd_mrel_widget_script_url, vfd_mrel_leaflet_script_url ve vfd_mrel_leaflet_style_url filtreleriyle değiştirebilir. Desteklenen ülke listesi vfd_mrel_supported_countries filtresiyle değiştirilebilir.

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. Yalnızca önbelleğe alınmış teslim noktası listeleri temizlenir. Kaldırmak için eklentiyi devre dışı bırakın ve Plugins sayfasında silin. Bu eklentinin lisans anahtarı, lisans durumu ve önbellekler her zaman silinir. Ayarlar ve bölge yöntemleri yalnızca Remove data on uninstall açıksa silinir; aksi halde sonraki bir yeniden kurulum için saklanır. Siparişlerde kayıtlı teslim noktaları korunur ve mevcut siparişler kargo satırlarını korur.

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