VibeFox GLS ParcelShop for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 - 9.x. ParcelShop seçimi Classic ve Hummingbird temalarında çalışır.

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

GLS: modül GLS hesabı veya API anahtarı kullanmaz ve bunlara ihtiyaç duymaz. ParcelShop haritası herkese açıktır. Paketleri seçilen ParcelShop'lara göndermek için GLS ile bir sözleşmeniz olmalıdır.

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 sayfasına gidin ve Upload a module düğmesine tıklayın. Modülün ZIP dosyasını seçin.

2. Yükleme tamamlandığında Configure düğmesine tıklayın veya daha sonra modül listesinde VibeFox GLS ParcelShop modülünü 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. Fiyatlarınızı belirleyin: en az bir Country prices satırı (örneğin * Default) veya bir Fallback cost (bkz. Yapılandırma) girin ve Save düğmesine tıklayın.

Kurulumda modül, Delivery to a GLS ParcelShop of your choice teslimat süresi metniyle GLS ParcelShop taşıyıcısını oluşturur. Taşıyıcı tüm müşteri gruplarına ve GLS haritasındaki ülkelerin bölgelerine atanır (standart bir mağazada genellikle Europe ve Europe (non-EU)). Bölgeleri, müşteri gruplarını, teslimat süresi metnini ve logoyu Shipping > Carriers bölümünden 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 GLS ParcelShop > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder.

Sayfanın üstündeki uyarılar yapılandırma sorunlarına işaret eder: taşıyıcı bulunamadı, mağazanın ağırlık birimi modül tarafından tanınmıyor (International > Localization bölümünde, Local units altında kg, g, lb veya oz belirleyin), hiç fiyat ayarlanmadı ya da seçili Countries (ignore zones mode) ülkelerinin bir kısmı veya tamamı GLS haritası tarafından kapsanmıyor. Geçersiz veya negatif bir sayı, alanın adını belirten bir mesajla reddedilir ve önceki değer korunur. Diğer alanlar yine de kaydedilir.

General

Bu bölümde GLS haritasının kapsadığı ülkeler listelenir. Taşıyıcı diğer hedef ülkeler için sunulmaz.

Enable/Disable: GLS ParcelShop'u açar veya kapatır. Bu, Shipping > Carriers bölümündeki taşıyıcı durumuyla aynı anahtardır.

Name: müşteriye gösterilen kargo yönteminin adı (taşıyıcının adı). Varsayılan: GLS ParcelShop. Zorunludur, en fazla 64 karakter.

Tax status: taşıyıcının vergi kuralı. None, kargonun vergilendirilmediği anlamına gelir. Kargoyu vergilendirmek için bir vergi kuralı seçin.

Prices

Fiyatlar mağazanızın varsayılan para biriminde, vergi hariç girilir. Ondalık ayırıcı olarak virgül veya nokta kullanılabilir (4,99 veya 4.99). Fiyat müşteriye sepetin para biriminde gösterilir.

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

Country prices: her hedef ülke için bir satırın bulunduğu bir tablo. Satır eklemek için Add country düğmesine, bir satırı kaldırmak için çöp kutusu simgesine tıklayın. Her satırda bir Country, bir Price ve beş ağırlık sütunu bulunur: XS 1 kg'a kadar, S 1-2 kg, M 2-3 kg, L 3-5 kg ve XL 5 kg üzeri. Sepetin ağırlığına karşılık gelen sütun kullanılır. 0 bırakılan bir ağırlık sütunu Price sütununu kullanır. Kendi satırı olmayan ülkeler için * Default satırı kullanılır. Yeni satırlar * Default ile başlar ve tüm sütunları 0'dır; tüm fiyatları 0 olan bir satır ücretsiz teslimat sağlar, bu yüzden kaydetmeden önce ülkeyi seçip fiyatları doldurun. Tablodaki bir değer geçerli bir sayı değilse tablonun tamamı kaydedilmez ve mesaj hatalı değerleri listeler.

Fallback cost: tabloda hedef ülke için satır yoksa ve * Default satırı yoksa kullanılan fiyat. Bu ülkeler için taşıyıcıyı gizlemek istiyorsanız boş bırakın.

Free shipping from: GLS ParcelShop teslimatının ücretsiz olduğu sepet ara toplamı (indirimlerden sonra, vergi hariç). Teslimat hiçbir zaman ücretsiz olmayacaksa boş bırakın.

Availability

Minimum weight (kg): sepet bundan hafif olduğunda taşıyıcıyı gizler. Ağırlık, mağazanızın ağırlık biriminden çevrilir. Boş veya 0, sınır olmadığı anlamına gelir.

Maximum weight (kg): sepet bundan ağır olduğunda taşıyıcıyı gizler. Varsayılan: 20. GLS ParcelShop'lar genellikle 20 kg'a kadar paketleri kabul eder, bu yüzden GLS sözleşmenizi kontrol edin. Boş veya 0, sınır olmadığı anlamına gelir. Minimum, maksimumdan büyükse iki ağırlık da bir mesajla reddedilir ve önceki değerler korunur.

Minimum cart subtotal: taşıyıcıyı yalnızca sepet ara toplamı (indirimlerden sonra, vergi hariç) bu tutara ulaştığında sunar. Minimum yoksa boş bırakın.

Ignore shipping zones: açıkken taşıyıcı, devre dışı olanlar dahil tüm bölgelere bağlanır ve aşağıda seçilen ülkeler için, bu ülkeler taşıyıcının bölgelerinde olmasa bile sunulur. Daha sonra oluşturulan bölgeler de bağlanır. Kapatıldığında taşıyıcı daha önce sahip olduğu bölgeleri geri alır ve yalnızca bu bölgelerde sunulur. Varsayılan: kapalı.

Countries (ignore zones mode): bu mod için hedef ülkeler. Tüm GLS haritası ülkelerini kullanmak için boş bırakın. GLS haritası tarafından kapsanmayan ülkeler atlanır. Bu alan yalnızca Ignore shipping zones açıkken kullanılır.

Advanced

Debug log: fiyat hesaplamalarını ve ParcelShop seçimlerini modül klasöründeki logs/vfd_glps_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Hatalar her zaman kaydedilir. Müşterinin kişisel verileri kaydedilmez. İşiniz bittiğinde günlüğü kapatın.

Log: hata ayıklama günlüğünün boyutunu ve en 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 ayarları, taşıyıcıyı ve günlüğü siler. Kapalıyken her şey yeniden kurulum için saklanır. Siparişlerde kayıtlı ParcelShop her zaman korunur.

Ödeme sırasında nasıl çalışır

PrestaShop teslimat adımını gösterdiğinde, modülden GLS ParcelShop fiyatını ister. Yalnızca fiziksel ürünler sayılır: sanal ürünler ağırlık eklemez ve sepet ara toplamına dahil edilmez. Modül önce koşulları kontrol eder: teslimat ülkesi GLS haritası tarafından kapsanıyor mu (ve bu mod açıksa Countries (ignore zones mode) içinde seçili mi), sepet ağırlığı ve minimum sepet ara toplamı. Sepet ara toplamı Free shipping from tutarına ulaşırsa teslimat ücretsizdir. Aksi halde fiyat, ülke satırından (veya * Default satırından) ve ağırlık sütunundan ya da Fallback cost alanından alınır. Hiç fiyat bulunamazsa taşıyıcı gizlenir.

Müşteri GLS ParcelShop'u seçtiğinde, taşıyıcının altında Select GLS ParcelShop düğmesi bulunan bir GLS ParcelShop kutusu görünür. Bu düğme, teslimat ülkesi için resmi GLS ParcelShop haritasını açar. Bir ParcelShop seçildikten sonra adı ve adresi gösterilir ve düğme Change ParcelShop olarak değişir. Seçim sepette saklanır, bu yüzden teslimat adımı yenilendiğinde veya sayfa yeniden yüklendiğinde korunur. Teslimat adresi başka bir ülkeye değişirse müşterinin yeniden bir ParcelShop seçmesi gerekir.

Müşteri teslimat adımında Continue düğmesine tıkladığında modül, bir ParcelShop seçilip seçilmediğini ve teslimat ülkesinde olup olmadığını kontrol eder. Aksi halde müşteri Please select a GLS ParcelShop. veya The selected GLS ParcelShop is not in your shipping country. Please choose a ParcelShop again. mesajını görür ve teslimat adımında kalır. ParcelShop kaydedilemezse müşteri The ParcelShop could not be saved. Please try again. mesajını görür. GLS harita betiği yüklenemezse müşteri sayfayı yeniden yüklemesi veya başka bir kargo yöntemi seçmesi gerektiğini belirten bir mesaj görür.

GLS haritası müşterinin tarayıcısında çalışır. Ödeme sayfasında modül harita betiğini map.gls-croatia.com adresinden yükler; harita da ParcelShop verilerini ve harita karolarını GLS'ten alır. GLS, ziyaretçinin olağan istek verilerini (IP adresi, tarayıcı) alır. Sunucunuzdan GLS'e hiçbir veri gönderilmez.

Taşıyıcının 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, GLS'ten canlı ücretler almaz, GLS gönderileri oluşturmaz, etiket yazdırmaz ve paketleri takip etmez. Sunucunuzda ParcelShop listesi bulunmadığından ParcelShop kimliğini GLS ile doğrulayamaz. Siparişteki ParcelShop kimliğini olağan yönteminizle GLS'e iletin (MyGLS, GLS yazılımınız veya başka bir modül).

Teslim noktaları

Sipariş verildiğinde sepetteki ParcelShop siparişle birlikte kaydedilir: kimliği, adı ve adresiyle birlikte adı ve ülkesi. Bundan sonra sepetle birlikte değişmez.

Yönetici sipariş sayfası: bir GLS ParcelShop bloğu, ParcelShop adını ve adresini, ParcelShop ID ve ülkesiyle birlikte gösterir. ParcelShop'u olmayan bir GLS ParcelShop siparişinde blok No ParcelShop was selected for this order. mesajını gösterir.

Müşteri sayfaları: ParcelShop, sipariş onay sayfasında ve müşteri hesabındaki sipariş ayrıntıları sayfasında gösterilir.

E-postalar: ParcelShop, müşteriye giden sipariş onay e-postasında taşıyıcının adına eklenir. Satıcıya giden yeni sipariş e-postasına (Mail alerts modülü) ParcelShop kimliği de eklenir.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox GLS ParcelShop lisans bloğu, Modules > Module Manager > VibeFox GLS ParcelShop > Configure 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 geçerli olduğu tarihi ve alan adınızı) ve Check now düğmesini (durumu yeniden kontrol etmek için), Change key düğmesini (başka bir anahtar girmek için) ve Remove key düğmesini (anahtarı bu mağazadan kaldırmak için) gösterir. Bunların altında Product: presta-shipping-gls-parcelshop 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 yetkisi olan çalışanlar değiştirebilir. Bloğun metinleri arka ofis dilini takip eder (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedeni gösterir, örneğin Key not found, This key belongs to another product, Domain limit reached veya License expired on ve bir tarih. 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 tek 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 GLS ParcelShop taşıyıcısı ödeme sayfasında müşterilere gösterilmez ve hiçbir ücret hesaplanmaz. PrestaShop vitrini arka ofise giriş yaptığınızı bilmez, bu yüzden taşıyıcı sizden de gizlenir: modülü bir anahtar satın almadan önce kurabilirsiniz, ancak ödeme sayfasında test edemezsiniz. Modules > Module Manager sayfasında 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. Arka ofiste çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, ardından 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

GLS ParcelShop ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable/Disable 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 (ignore zones mode) alanını kontrol edin). Hedef ülkenin GLS haritasının ülkelerinden biri olduğunu ve bir fiyatı olduğunu kontrol edin (bir ülke satırı, * Default satırı veya Fallback cost). Ağırlık sınırlarını ve Minimum cart subtotal değerini kontrol edin. Ürünler, ürün sayfasında belirli taşıyıcılarla da sınırlanmış olabilir. Debug log seçeneğini açın ve nedeni görmek için Log alanına bakın.

Harita açılmıyor: GLS betiği bir reklam veya gizlilik engelleyici, içerik güvenlik politikası (CSP) ya da bir GLS kesintisi tarafından engellendiğinde müşteri "The GLS ParcelShop map could not be loaded..." mesajını görür. İçerik güvenlik politikanızda map.gls-croatia.com adresine izin verin.

Bir ülke için teslimat yanlışlıkla ücretsiz: Country prices bölümünde o ülkenin satırını kontrol edin. Price ve tüm ağırlık sütunları 0 olan bir satır ücretsiz teslimat sağlar.

Tablo veya bir alan kaydedilmedi: bir değer geçerli bir sayı değil. Sayfanın üstündeki mesaj değeri gösterir. Ondalık ayırıcı olarak virgül veya nokta ile rakamlar kullanın.

Sayfa GLS ParcelShop 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ü Reset ile sıfırlayın. Reset, mevcut bir taşıyıcının durumunu korur: devre dışı bir taşıyıcı devre dışı kalır.

Bir siparişte ParcelShop yok ve günlük, sepetin ParcelShop'unun zaten başka bir siparişte kayıtlı olduğunu belirtiyor: bir sepet iki siparişe dönüşmüş. İlk sipariş ParcelShop'u korur. İkinci siparişi GLS'e elle iletin.

Kaldırma

Modules > Module Manager sayfasına gidin, VibeFox GLS ParcelShop yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı ve lisans durumu her zaman kaldırılır.Remove data on uninstall açıksa taşıyıcı silinir (siparişler geçmişini korur), ayarlar, günlük ve siparişi olmayan sepetlerin ParcelShop'ları 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, kayıtlı taşıyıcıya önceki durumunu geri verir. Siparişlerde kayıtlı ParcelShop her zaman korunur.

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