VibeFox GLS ParcelShop for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 sürümünde test edilmiştir) veya 4.0.2 ve üzeri (4.1.0.3 sürümünde test edilmiştir), varsayılan tema ve tek sayfalık ödeme adımıyla.

PHP: 8.0 veya üzeri.

GLS: uzantı bir 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 sözleşmeniz olmalıdır.

İçerik güvenlik politikası: mağazanız bir içerik güvenlik politikası (Content Security Policy) gönderiyorsa, GLS harita betiğinin yüklendiği map.gls-croatia.com adresine izin verin.

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

Kurulum

İndirme, 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_gls_parcelshop-oc3-(version).ocmod.zip ve OpenCart 4 paketi vfd_gls_parcelshop.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 bölümüne gidin, Upload düğmesine tıklayın ve vfd_gls_parcelshop-oc3-(version).ocmod.zip dosyasını seçin. Uzantı OCMOD değişikliği eklemez, bu nedenle Extensions > Modifications bölümünü yenilemeniz gerekmez. Installer yerine bu paketin upload klasörünün içeriğini mağazanızın kök klasörüne de kopyalayabilirsiniz.

2. Extensions > Extensions bölümüne gidin ve uzantı türü olarak Shipping seçin. VibeFox GLS ParcelShop 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ı Edit sayfasının üst kısmındaki lisans bloğunda License key alanına girin ve Activate düğmesine tıklayın (bkz. License key).

5. Fiyatlarınızı belirleyin: en az bir Country prices satırı (örneğin * Default) veya bir Fallback cost girin (bkz. Yapılandırma). Enable/Disable seçeneğini açın ve Save düğmesine tıklayın.

OpenCart 4

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve vfd_gls_parcelshop.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4 uzantı kodunu dosya adından alır ve adı değiştirilmiş paket çalışmaz.

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

3. Extensions > Extensions bölümüne gidin ve uzantı türü olarak Shipping seçin. VibeFox GLS ParcelShop uzantısını bulun, Install düğmesine (yeşil + düğmesi) ve ardından Edit düğmesine (kalem düğmesi) tıklayın.

4. Lisans anahtarını ve ayarları OpenCart 3 için 4. ve 5. adımlarda olduğu gibi girin. Ayarlar 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 GLS ParcelShop > Edit. Bölümler solda listelenir. Sayfanın altındaki tek bir Save düğmesi tüm sayfayı yeniden yüklemeden kaydeder. Ayarları yalnızca bu uzantı için değiştirme yetkisine sahip yönetici kullanıcılar kaydedebilir.

Sayfanın üstündeki ve her kayıttan sonra yeniden görünen uyarılar yapılandırma sorunlarını gösterir: hiçbir fiyat ayarlanmamış, seçilen Countries (ignore zones mode) ülkelerinin bir kısmı veya tamamı GLS haritasında yer almıyor ya da mağazanın ağırlık birimi uzantı tarafından tanınmıyor ve kg birimli bir ağırlık sınıfı yok (System > Localisation > Weight Classes bölümünden ekleyin). Geçersiz veya negatif bir sayı, alanı belirten bir mesajla reddedilir; örneğin Fallback cost: "abc" is not a valid number of 0 or more - the previous value was kept. Diğer alanlar yine de kaydedilir. Geçersiz bir Name, sıralama, vergi sınıfı veya coğrafi bölge de aynı şekilde reddedilir.

Genel

Bu bölüm GLS haritasının kapsadığı ülkeleri listeler: Avusturya, Belçika, Bulgaristan, Hırvatistan, Çekya, Danimarka, Finlandiya, Fransa, Almanya, Yunanistan, Macaristan, İtalya, Lüksemburg, Hollanda, Polonya, Portekiz, Romanya, Sırbistan, Slovakya, Slovenya ve İspanya. Yöntem diğer hedef ülkeler için sunulmaz.

Enable/Disable: GLS ParcelShop'un ödeme sırasında gösterilip gösterilmeyeceğini belirler. Varsayılan: kapalı.

Name: müşteriye gösterilen kargo yöntemi adı. Varsayılan: GLS ParcelShop. Zorunludur, en fazla 64 karakter olabilir ve < > ; = # { } karakterlerini içeremez.

Tax status: None (shipping is not taxed) veya kargo vergilendirildiğinde uygulanacak vergi sınıfı.

Sort order: ödeme sırasında kargo yöntemleri arasındaki konum. Bir tam sayıdır.

Fiyatlar

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

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

Country prices: hedef ülke başına bir satırdan oluşan bir tablo. Satır eklemek için Add country düğmesine 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'dan fazla. 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. * Default satırı, kendi satırı olmayan ülkeler için kullanılır. Tüm fiyatları 0 olan bir satır ücretsiz teslimat anlamına gelir; bu nedenle kaydetmeden önce ülkeyi seçin ve fiyatları doldurun. Tablodaki bir değer 0 veya daha büyük geçerli bir sayı değilse tablonun tamamı kaydedilmez ve mesaj hatalı değerleri listeler.

Fallback cost: tabloda hedef ülke için satır ve * Default satırı yoksa kullanılan fiyat. Bu ülkeler için yöntemi gizlemek üzere 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.

Kullanılabilirlik

Minimum weight (kg): sepet bundan hafifse yöntemi gizler. Ağırlık, ürünlerin ağırlık sınıflarından hesaplanır. Boş veya 0 sınır olmadığı anlamına gelir.

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

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

Geo zone: yöntemi yalnızca bu coğrafi bölgedeki adresler için sunar. All zones sınır olmadığı anlamına gelir. Ignore shipping zones açıkken kullanılmaz. Coğrafi bölgeler System > Localisation > Geo Zones bölümünde yönetilir.

Ignore shipping zones: açıkken yöntem, coğrafi bölgeden bağımsız olarak aşağıda seçilen ülkeler için sunulur (liste boşsa GLS haritasındaki tüm ülkeler). Kapalıyken yalnızca yukarıdaki coğrafi bölgede sunulur. Varsayılan: kapalı.

Countries (ignore zones mode): bu mod için hedef ülkeler. GLS haritasındaki tüm ülkeleri kullanmak için boş bırakın. GLS haritasının kapsamadığı ülkeler atlanır. Bu alan yalnızca Ignore shipping zones açıkken kullanılır.

Gelişmiş

Debug log: ücret hesaplamalarını ve ParcelShop seçimlerini storage/logs/vfd_glps_debug.log.php (OpenCart 4'te system/storage/logs/vfd_glps_debug.log.php) dosyasına yazar. Dosya web üzerinden okunamaz. Hatalar her zaman kaydedilir. Müşterilerin kişisel verileri kaydedilmez. İşiniz bittiğinde günlüğü kapatın. Dosya 5 MB'a ulaştığında vfd_glps_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 en son kayıtlarını gösterir. Temizlemek 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 her şey yeniden kurulum için saklanır. Siparişlerde kaydedilen ParcelShop her zaman korunur.

İçe / Dışa Aktarma

Export: ayarları 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. Geçersiz değerler bildirilir ve içe aktarılmaz.

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

OpenCart kargo yöntemlerini gösterirken uzantıdan GLS ParcelShop fiyatını ister. Bir Geo zone ayarlıysa (ve Ignore shipping zones kapalıysa) ve adres bu bölgenin dışındaysa yöntem sunulmaz. Yalnızca Requires Shipping değeri Yes olan ürünler sayılır: diğer ürünler ağırlığa eklenmez ve sepet ara toplamına dahil edilmez. Ara toplam, bu ürünlerin kupon indirimi sonrasındaki, vergi hariç fiyatıdır. Ardından uzantı koşulları kontrol eder: teslimat ülkesinin GLS haritasında olması (ve bu mod açıksa Countries (ignore zones mode) içinde seçili olması), sepet ağırlığı ve minimum sepet ara toplamı. Sepet ara toplamı Free shipping from tutarına ulaşırsa teslimat ücretsizdir. Aksi halde fiyat, ülkenin satırından (veya * Default satırından) ve ağırlık sütunundan ya da Fallback cost değerinden alınır. Fiyat bulunamazsa yöntem gizlenir. Fiyat, varsayılan para biriminizin ondalık basamaklarına yuvarlanır ve seçilen Tax status vergisiyle gösterilir.

Müşteri GLS ParcelShop'u seçtiğinde, yöntemin altında Select GLS ParcelShop düğmesinin bulunduğu bir GLS ParcelShop kutusu görünür. Bu düğme, teslimat ülkesi için resmi GLS ParcelShop haritasını açar. Başka bir ülkedeki bir ParcelShop hemen reddedilir. Bir ParcelShop seçildikten sonra adı ve adresi gösterilir ve düğme Change ParcelShop olarak değişir. Seçim müşterinin oturumunda tutulur, bu nedenle kargo adımı yeniden yüklendiğinde de kalır. Teslimat adresi başka bir ülkeye değişirse müşterinin yeniden bir ParcelShop seçmesi gerekir.

Müşteri teslimat yöntemi adımında Continue düğmesine tıkladığında uzantı, 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 o adımda 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 The GLS ParcelShop map could not be loaded. Please reload the page or choose another shipping method. mesajını görür.

OpenCart 4'te müşteri, ödeme sayfasındaki kargo yöntemi bloğunda Choose düğmesine tıklar ve Shipping method options penceresinde GLS ParcelShop'u seçer. Bu pencerede, yöntemin altında Select GLS ParcelShop düğmesi bulunan GLS ParcelShop kutusu görünür ve GLS haritası pencerenin üzerinde açılır. Pencerenin Continue düğmesi geçerli bir ParcelShop olmadan ilerlemez; aynı mesajlar gösterilir. OpenCart 4 ödeme için tek bir sipariş tutar ve müşteri her onayladığında bu siparişi günceller; siparişteki ParcelShop de onunla birlikte güncellenir.

GLS haritası müşterinin tarayıcısında çalışır. Ödeme sayfasında uzantı GLS harita betiğini map.gls-croatia.com adresinden yükler ve harita GLS'den ParcelShop verilerini ve harita karolarını alır. GLS, ziyaretçinin olağan istek verilerini (IP adresi, tarayıcı) alır. Sunucunuzdan GLS'e hiçbir veri gönderilmez. Uzantıdaki bir hata, diğer kargo yöntemleri için ödemeyi hiçbir zaman kesmez; günlüğe yazılır.

Uzantı canlı GLS tarifelerini almaz, GLS gönderileri oluşturmaz, etiket yazdırmaz ve kargoları takip etmez. Sunucunuzda ParcelShop listesi bulunmadığı için ParcelShop kimliğini GLS'e karşı doğrulayamaz. Siparişteki ParcelShop kimliğini her zamanki yönteminizle GLS'e iletin (MyGLS, GLS yazılımınız veya başka bir uzantı).

Teslim alma noktaları

Sipariş verildiğinde ödeme sırasında seçilen ParcelShop siparişle birlikte kaydedilir: kimliği, adı ve adresi ile ülkesi. Sipariş tamamlandıktan sonra seçim temizlenir, böylece bir sonraki sepet ParcelShop olmadan başlar.

Shipping method name: ParcelShop, siparişteki kargo yönteminin adına eklenir; örneğin GLS ParcelShop: name, address (önce yöntem adı, ardından ParcelShop) (OpenCart 3 bu addan en fazla 128 karakter, OpenCart 4 ise en fazla 255 karakter saklar). Böylece ParcelShop, müşteriye giden sipariş onay e-postasında, müşterinin Order History bölümündeki sipariş sayfasında ve Sales > Orders bölümünde görünür. OpenCart kargo yöntemini sipariş başarı sayfasında göstermez.

Admin order page: Sales > Orders bölümünde bir GLS ParcelShop paneli, ParcelShop adını ve adresini, ParcelShop ID ve ülkeyle birlikte gösterir. ParcelShop'u olmayan bir GLS ParcelShop siparişinde panel No ParcelShop was selected for this order. mesajını gösterir. Panel yalnızca ParcelShop'u gösterir; orada değiştirilemez.

Satıcı e-postası: mağazaya giden yeni sipariş bildirim e-postası, ParcelShop'u yorum bloğunda ParcelShop ID ile birlikte içerir.

Lisans anahtarı

Uzantı, vibefox.net üzerinden alınmış bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu License — VibeFox GLS ParcelShop, Extensions > Extensions > Shipping > VibeFox GLS ParcelShop > Edit 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ı gizli olarak, durumu (örneğin lisansın hangi tarihe kadar etkin olduğunu ve alan adınızı) ve Check now, Change key ve Remove key düğmelerini gösterir; bunlar sırasıyla durumu yeniden kontrol etmeyi, başka bir anahtar girmeyi ve anahtarı bu mağazadan kaldırmayı sağlar. Bunların altında Product: opencart-shipping-gls-parcelshop satırı ve vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. 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 izler (İ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 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 uzantı son bilinen durumla çalışmaya devam eder.

Bir anahtar tek bir alan adında çalışır: OpenCart yapılandırmasındaki mağaza adresinde. 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, ödeme sırasında müşterilere gösterilmez ve ücret hesaplanmaz. Mağazanın yönetici paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, yöntemi (unlicensed — visible to admins only) işaretiyle mağazada yine görür; böylece bir anahtar satın almadan önce uzantıyı kurup test edebilirsiniz. OpenCart 4'te bu önizleme kullanılamaz: mağaza yönetici girişini görmez, bu nedenle etkin bir anahtar olmadan yöntem herkesten gizlenir. Edit sayfasını bir kez açtıktan sonra yönetici Dashboard sayfasında bir hatırlatma görünür. Bunu × ile kapatarak 7 gün boyunca gizleyebilirsiniz. Mevcut siparişler etkilenmez.

Bir lisansın süresi dolduğunda uzantı çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetici Dashboard veya Edit sayfasını açtığınızda 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. Uzantıyı kaldırmak 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. Geo zone ayarını veya Ignore shipping zones ile Countries (ignore zones mode) ayarını kontrol edin. Hedef ülkenin GLS haritasındaki ülkelerden biri olduğunu ve bir fiyatı bulunduğunu (bir ülke satırı, * Default satırı veya Fallback cost) kontrol edin. Ağırlık sınırlarını ve Minimum cart subtotal değerini kontrol edin ve ürünlerin Requires Shipping değerinin Yes olduğunu doğrulayın. 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, bir içerik güvenlik politikası ya da bir GLS kesintisi nedeniyle 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.

ParcelShop kutusu yöntemin altında görünmüyor: uzantı varsayılan OpenCart teması ve ödeme sayfasıyla test edilmiştir. Kargo yöntemi adımını değiştiren bir tema veya ödeme uzantısı kutuyu göstermeyebilir.

Bir ülke için teslimat yanlışlıkla ücretsiz: Country prices içindeki 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 0 veya daha büyük geçerli bir sayı değil. Sayfanın üstündeki mesaj değeri belirtir. Ondalık ayırıcı olarak virgül veya nokta ile rakamları kullanın.

Bir sipariş No ParcelShop was selected for this order mesajını gösteriyor: sipariş, teslimat ülkesinden bir ParcelShop olmadan verilmiş. Neden günlüğe yazılmıştır. Müşteriden ParcelShop'u isteyin ve GLS'e elle iletin.

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

Geliştiriciler için: GLS harita betiğinin adresi vfd_glps_widget_url ayarıyla değiştirilebilir; ayarlar sayfasında bunun bir alanı yoktur.

Kaldırma

Extensions > Extensions bölümüne gidin, Shipping türünü seçin ve VibeFox GLS ParcelShop satırının yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Bu uzantının 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. Uzantı kendi olaylarını her zaman kaldırır. Remove data on uninstall açıksa diğer ayarlar ve hata ayıklama günlüğü de silinir. Kapalıysa bunlar korunur ve uzantıyı yeniden kurduğunuzda tekrar kullanılır. Açık bir sepette seçilen ParcelShop, süresi dolana kadar müşterinin oturumunda kalır. Siparişlerde kaydedilen ParcelShop her zaman korunur ve mevcut siparişler kargo yöntemini ve maliyetini korur.

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

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