VibeFox LP Express for PrestaShop — Yardım
Gereksinimler
PrestaShop: 8.0 ila 9.x.
PHP: 8.0 veya üzeri. Modül, eski PHP sürümlerine kurulmayı reddeder.
LP Express: API hesabı gerekmez. LP Express'in herkese açık bir fiyat API'si yoktur ve modül Unisend API'sini kullanmaz; bu nedenle kendi (sözleşmeli) fiyatlarınızı girersiniz. Paketleri Unisend ("Mano siuntos") hesabınızda oluşturun.
Paket terminali listesi: modül açık LP Express terminal listesini kullanır (https://www.lpexpress.lt/index.php?cl=terminals&fnc=getTerminals). Anahtar gerekmez. Bu çevrim içi liste kullanılamazsa, varsa son indirilen kopya, yoksa kendi listeniz kullanılır. Kendi listenizi girmeye hazır olun (bkz. Yapılandırma).
VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar bir alan adında çalışır.
Kurulum
1. Yönetici 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 bittiğinde Configure düğmesine tıklayın ya da daha sonra modül listesinde VibeFox LP Express 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ı yapıştırın ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).
4. Fiyat tablosunu (en az bir satır) ya da yedek maliyeti doldurun. Sayfanın üstündeki paket terminalleri durum satırını kontrol edin ve çevrim içi liste kullanılamıyorsa kendi terminal listenizi ekleyin. Save düğmesine tıklayın.
Kurulumda modül, LP Express parcel terminal taşıyıcısını Delivery to an LP Express parcel terminal teslimat süresi metniyle oluşturur. Taşıyıcı Litvanya bölgesine ve tüm müşteri gruplarına atanır. Bölge ekleyebilir; müşteri gruplarını, teslimat süresini, logoyu ve boyut sınırlarını Shipping > Carriers üzerinden değiştirebilirsiniz. Orada fiyat belirlemeyin: fiyat her zaman modülden gelir.
Yapılandırma
Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox LP Express > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Her kayıtta terminal listesi de yeniden yüklenir.
Sayfanın üstündeki bildirimler sorunları ve terminal durumunu gösterir. Hiç fiyat ayarlanmamışsa ya da hiç paket terminali kullanılamıyorsa uyarı görünür; çünkü bu durumda taşıyıcı ödeme sayfasında gösterilmez. Uyarı ayrıca taşıyıcı silindiğinde ve mağazanın ağırlık birimi modülün tanıdığı birimlerden (kg, g, lb, oz) biri değilse de görünür; çünkü bu durumda ürün ağırlıkları kg olarak okunur. Bilgi satırı, kaç şehirde kaç paket terminalinin ve hangi kaynaktan kullanılabildiğini gösterir: çevrim içi liste, çevrim içi listenin kayıtlı kopyası (tarihiyle birlikte) veya kendi listeniz.
Kaydetme sırasında boş olan ya da taşıyıcı adı olarak geçerli olmayan bir yöntem başlığı Enter a valid method title. mesajıyla reddedilir; 64 karakterden uzun başlık da reddedilir. Her iki durumda da hiçbir şey kaydedilmez. Sayı olmayan (ya da negatif) bir tutar veya ağırlık bildirilir ve önceki değer korunur. Maksimum boşken 30 kg olan Maximum weight (kg) değerinden büyük bir Minimum weight (kg) da bildirilir; çünkü taşıyıcı hiç gösterilmez ve iki ağırlık da önceki değerlerini korur. Tablodaki sayı olmayan fiyatlar bildirilir ve boş bırakılır.
Genel
Enable/Disable: LP Express'i açar veya kapatır. Bu, Shipping > Carriers altındaki taşıyıcı durumuyla aynı anahtardır.
Method title: müşterilere sepette ve ödeme sayfasında gösterilen taşıyıcı adı. Varsayılan: LP Express parcel terminal. Zorunlu.
Tax status: None, aşağıdaki fiyatların kesin olduğu anlamına gelir. Bir vergi kuralıyla birlikte Taxable (mağazanızın her vergi kuralı için bir seçenek), PrestaShop'un bu kargo vergisini aşağıdaki fiyatların üzerine eklediği anlamına gelir. Bu, taşıyıcının vergi kuralıdır.
Fiyatlar (mağazanızın varsayılan para biriminde; ondalıklar 2.99 veya 2,99 biçiminde yazılabilir)
Price table: hedef ülke başına bir satır. Satır eklemek için + Add country, satır silmek için çöp kutusu simgesine tıklayın. Kendi satırı olmayan tüm ülkeler için * Any other country seçin. Her satırda bir Base price ve ağırlık sütunları vardır: XS (≤1 kg), S (≤2 kg), M (≤3 kg), L (≤5 kg) ve XL (>5 kg). Ağırlık, sepet ağırlığıdır; Per item seçiliyse tek bir ürünün ağırlığıdır. Boş sütun, satırın temel fiyatını kullanır. 0, ücretsiz anlamına gelir.
Fallback cost: fiyat tablosunda hedef ülke için satır yoksa kullanılır. Bu ülkelerde taşıyıcıyı gizlemek için boş bırakın.
Calculation: fiyatın nasıl hesaplandığı.
Free shipping from: bu tutardan itibaren LP Express'in ücretsiz olduğu sepet toplamı (kargoya ihtiyaç duyan ürünler, indirimlerden sonra, vergi hariç). Ücretsiz kargo olmasın istiyorsanız boş bırakın.
Kullanılabilirlik
Minimum weight (kg): sepet bundan hafifse taşıyıcıyı gizler. Boş veya 0 sınır olmadığı anlamına gelir.
Maximum weight (kg): sepet bundan ağırsa taşıyıcıyı gizler. LP Express terminalleri 30 kg'a kadar paket kabul eder. Varsayılan: 30. 0 sınır olmadığı anlamına gelir. Boş, taşıyıcının bölgelerinde 30 kg anlamına gelir; sınır yalnızca bu bölgelerin dışında kalan Ignore shipping zones ülkeleri için yoktur.
Minimum cart total: taşıyıcıyı yalnızca bu sepet toplamından itibaren gösterir (kargoya ihtiyaç duyan ürünler, indirimlerden sonra, vergi hariç). Her zaman göstermek için boş bırakın.
Ignore shipping zones: bölgeleri kendiniz ayarlamadan LP Express'i aşağıdaki ülkeler için sunar. Taşıyıcı o zaman her aktif bölgeye bağlanır (sonradan oluşturulan bölgelere de). Taşıyıcının önceden sahip olduğu bölgeler, tüm ülkeleri için izinli kalır. Seçeneği tekrar kapattığınızda taşıyıcı, daha önce sahip olduğu bölgeleri geri alır. Kapalıyken ülkeler, Shipping > Carriers altındaki taşıyıcının bölgeleriyle belirlenir. Bu önerilen ayardır.
Countries (without zones): bu mod için hedef ülkeler. Bu alan yalnızca Ignore shipping zones açıkken kullanılır. Taşıyıcıyı tüm ülkeler için sunmak istiyorsanız boş bırakın.
Paket terminalleri
Terminal list: terminallerin kaynağı.
Own terminal list: her satırda bir terminal, ID | Name | City | Address | ZIP biçiminde; örneğin 1234 | LP EXPRESS Akropolis | Vilnius | Ozo g. 25 | LT-07150. ID ve City zorunludur. # ile başlayan satırlar yok sayılır. Unisend hesabınızın beklediği terminal kimliklerini kullanın.
Gelişmiş
Debug log: fiyat hesaplama ve terminal listesi ayrıntılarını modül klasöründeki logs/vfd_lpex_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Kullanılamayan terminal listesi gibi hatalar her zaman kaydedilir. Müşteri verileri 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çıkken modülü kaldırmak ayarları, taşıyıcıyı ve kayıtlı terminal listesini siler. Kapalıyken kaldırma yalnızca taşıyıcıyı kapatır. Siparişlerde kayıtlı terminal her zaman korunur.
Ödeme sayfasında nasıl çalışır
Kargo adımında PrestaShop, LP Express fiyatını modülden ister. Yalnızca fiziksel ürünler sayılır: sanal ürünler ağırlık eklemez ve sepet toplamına dahil edilmez. Modül, Ignore shipping zones ülkelerini, sepet ağırlığını ve minimum sepet toplamını denetler. Ücretsiz kargo uygulanırsa fiyat 0 olur. Aksi halde fiyat, ülkenin satırından (ya da * satırından) gelir: ağırlık sütunu; yoksa temel fiyat; yoksa yedek maliyet. Fiyat yoksa ya da hiç paket terminali kullanılamıyorsa taşıyıcı gizlenir; böylece müşteri asla tamamlanamayacak bir ödeme sayfası görmez.
Fiyatlar ve tutarlar mağazanızın varsayılan para birimindedir. Fiyat, PrestaShop döviz kuru kullanılarak müşterinin sepet para biriminde gösterilir.
Çevrim içi terminal listesi 24 saat önbellekte tutulur. Başarısız bir indirme 15 dakika hatırlanır; böylece ödeme sayfası her yenilemede listeyi beklemez. İndirme zaman aşımı 10 saniyedir. Listedeki yalnızca aktif terminaller sunulur.
Taşıyıcıyı, siparişleri olduktan sonra Shipping > Carriers altında 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 LP Express veya Unisend fiyatlarını sorgulamaz, gönderi oluşturmaz, etiket basmaz, kurye çağırmaz ve paketleri takip etmez. Paketleri Unisend ("Mano siuntos") hesabınızda oluşturun. Kurye (kapıya teslimat) bu taşıyıcının bir parçası değildir.
Teslim noktaları
Müşteri LP Express'i seçtiğinde, taşıyıcının altında iki listeli LP Express parcel terminal bloğu görünür: -- Select city -- ve -- Select parcel terminal --. Teslimat adresinin şehri, listedeki bir şehirle eşleşirse önceden seçilir. Her terminal adı, adresi ve posta koduyla gösterilir. Seçim hemen sepete kaydedilir; böylece ödeme sayfası yenilendiğinde kaybolmaz. Classic ve Hummingbird temalarıyla çalışır.
Terminal seçimi zorunludur. Terminal seçilmezse kargo adımındaki Continue ve Place order, Please select an LP Express parcel terminal. mesajını gösterir. Müşteri Continue düğmesine tıkladığında sunucu terminali listeye karşı yeniden denetler; bu yüzden sahte veya güncel olmayan bir terminal kimliği The selected LP Express parcel terminal is not available any more. Please select a parcel terminal again. mesajıyla reddedilir.
Terminal kimliği, adı ve şehri siparişle birlikte kaydedilir. Bunlar, yönetici panelindeki sipariş sayfasında LP Express parcel terminal bloğunda (Terminal ID ile birlikte), sipariş onay sayfasında ve müşterinin sipariş ayrıntılarında gösterilir. Sipariş onay e-postasında ve satıcıya giden yeni sipariş e-postasında, taşıyıcı adına LP Express parcel terminal: olarak eklenir ve ardından terminal gelir. Siparişte terminal yoksa yönetici panelindeki sipariş sayfası No parcel terminal was chosen for this order. mesajını gösterir.
Lisans anahtarı
Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox LP Express lisans bloğu, Modules > Module Manager > VibeFox LP Express > 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 tarihi 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: presta-shipping-lp-express satırı ve vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca modül için Configure yetkisine sahip çalışanlar değiştirebilir. Bloğun metinleri yönetici paneli 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 tarihli 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 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 yoksa LP Express taşıyıcısı ödeme sayfasında müşterilere gösterilmez ve hiçbir fiyat hesaplanmaz. PrestaShop vitrini, yönetici paneline giriş yaptığınızı bilmediği için taşıyıcı sizden de gizlenir: modülü anahtarı satın almadan önce ayarlayabilirsiniz, ancak ödeme sayfasında test edemezsiniz. Modules > Module Manager içinde Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez.
Lisansın süresi dolduğunda modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetici panelinde ç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
LP Express ö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 altında, taşıyıcının müşterinin ülkesinin bölgesini ve müşterinin grubunu kapsadığını kontrol edin (ya da Ignore shipping zones açık olup ülkenin izinli olduğunu). Modül sayfasını açın: hiç fiyat ayarlanmamışsa ya da hiç paket terminali kullanılamıyorsa bir uyarı nedenini açıklar. Ağırlık sınırlarını ve Minimum cart total değerini de kontrol edin. Ürünler, ürün sayfasında belirli taşıyıcılarla da sınırlanmış olabilir. Debug log açıkken modül sayfasındaki Log alanı, taşıyıcının neden gizlendiğini gösterir.
Paket terminali yok: çevrim içi liste yüklenemedi ve kayıtlı bir kopya ya da kendi listeniz yok. Modül her 15 dakikada bir yeniden dener. Own terminal list alanına kendi listenizi girin ya da Only my own list seçeneğini seçin.
Terminal listesi güncel değil: modül sayfasında Save düğmesine tıklayın. Bu, terminal listesini yeniden yükler. Kendi listenizi kullanıyorsanız satırları kendiniz güncelleyin.
Müşteri devam edemiyor: bir paket terminali seçilmelidir. Müşteri The LP Express parcel terminal list is temporarily unavailable. Please try again later or choose another shipping method. mesajını görüyorsa şu anda hiç terminal kullanılamıyor demektir. Kendi listenizi ekleyin.
Fiyatlar hangi para biriminde: mağazanızın varsayılan para biriminde. Başka bir para birimiyle ödeyen müşteriler, fiyatı PrestaShop döviz kuruyla çevrilmiş olarak görür.
Sayfa LP Express taşıyıcısının bulunamadığını söylüyor: taşıyıcı Shipping > Carriers altında silinmiş. Yeniden oluşturmak için Modules > Module Manager üzerinden modülü sıfırlayın.
Kaldırma
Modules > Module Manager sayfasına gidin, VibeFox LP Express yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı ve lisans durumu her zaman kaldırılır. Önbellekteki terminal listesi her zaman temizlenir. Remove data on uninstall açıksa taşıyıcı silinir (siparişler geçmişini korur) ve ayarlar, günlük ile kayıtlı terminal listesi kaldırılır. Kapalıysa taşıyıcı yalnızca kapatılır ve tüm ayarlar ile kayıtlı kopya korunur. Modülü yeniden kurmak, kayıtlı taşıyıcıya sahip olduğu durumu geri verir. Siparişlerde kayıtlı terminal hiçbir zaman silinmez.
LP Express, ilgili sahibinin ticari markasıdır. Bu modül LP Express ile bağlantılı değildir ve LP Express tarafından onaylanmamıştır.
