VibeFox LP Express for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 üzerinde test edildi) veya 4.0.2 ve üzeri (4.1.0.3 üzerinde test edildi), varsayılan tema ve standart OpenCart ödeme sayfasıyla.

PHP: 8.0 veya üzeri.

LP Express: API hesabı gerekmez. LP Express'in herkese açık bir fiyat API'si yoktur ve eklenti Unisend API'sini kullanmaz, bu yüzden kendi (sözleşmeli) fiyatlarınızı girersiniz. Gönderileri Unisend hesabınızda ("Mano siuntos") oluşturun.

Paket terminali listesi: eklenti, LP Express'in açık terminal listesini kullanır (https://www.lpexpress.lt/index.php?cl=terminals&fnc=getTerminals). Anahtar gerekmez. Bu çevrimiçi liste kullanılamazsa, eklenti varsa son indirilen kopyayı, yoksa kendi listenizi kullanır. Kendi listenizi girmeye hazır olun (bkz. Yapılandırma).

Litvanya: ülke, System > Localisation > Countries bölümünde etkinleştirilmiş olmalıdır.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar 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_lp_express-oc3-(version).ocmod.zip ve OpenCart 4 paketi vfd_lp_express.ocmod.zip bulunur. Yalnızca OpenCart sürümünüzü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_lp_express-oc3-(version).ocmod.zip dosyasını seçin. Eklenti OCMOD değişikliği eklemez, bu yüzden Extensions > Modifications bölümü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 bölümüne gidin ve eklenti türü olarak Shipping seçin. VibeFox LP Express eklentisini bulun ve Install düğmesine (yeşil +) tıklayın.

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

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

5. Fiyat tablosunu doldurun (en az bir satır; ilk yeni satır Litvanya'dır) ya da bir yedek maliyet girin. Sayfanın üstündeki paket terminalleri durum satırını kontrol edin ve çevrimiçi liste kullanılamıyorsa kendi terminal listenizi ekleyin. 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_lp_express.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4 eklenti kodunu dosya adından alır ve adı değiştirilmiş bir 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 bölümüne gidin ve eklenti türü olarak Shipping seçin. VibeFox LP Express eklentisini bulun, Install düğmesine (yeşil +) ve ardından Edit düğmesine (kalem simgesi) tıklayın.

4. Lisans anahtarını ve ayarları OpenCart 3 için 4. ve 5. adımlardaki gibi girin. Ayar sayfası ve alanları iki sürümde de aynıdır.

Kurulumda eklenti iki küçük tablo oluşturur (seçilen terminaller ve önbelleğe alınmış terminal listesi) ve ödeme sayfası ile sipariş sayfası için OpenCart olaylarını kaydeder. Enable/Disable seçeneğini açıp kaydedene kadar yöntem kapalı kalır. Eklentiyi kaldırdıktan sonra yeniden kurarsanız, sakladığınız ayarlar tekrar kullanılır.

Yapılandırma

Tüm ayarlar eklentinin sayfasındadır: Extensions > Extensions > Shipping > VibeFox LP Express > Edit. Bölümler solda listelenir. Sayfanın altındaki tek bir Save düğmesi tüm sayfayı yeniden yüklemeden kaydeder. Her kayıt ayrıca terminal listesini yeniden yükler. Ayarları yalnızca bu eklenti için değiştirme yetkisi olan yönetici kullanıcılar kaydedebilir.

Sayfanın üst kısmında bildirimler sorunları ve terminal durumunu gösterir. Hiç fiyat ayarlanmamışsa veya kullanılabilir paket terminali yoksa, yöntem ödeme sayfasında gösterilmediği için bir uyarı çıkar. Ayrıca mağazada kg birimli bir ağırlık sınıfı yoksa uyarı verilir: bu durumda ürün ağırlıkları birim adlarına (kg, g, lb, oz) göre okunur ve kg dışındaki her birim kg olarak kabul edilir. Bir bilgi satırı, kaç şehirde kaç paket terminalinin ve hangi kaynaktan (çevrimiçi liste, çevrimiçi listenin kayıtlı kopyası (tarihiyle) veya kendi listeniz) kullanılabilir olduğunu gösterir.

Kaydederken, boş olan veya < > ; = # { } karakterlerinden birini içeren bir yöntem başlığı Enter a valid method title. uyarısıyla reddedilir; 64 karakterden uzun bir başlık da reddedilir. Tam sayı olmayan bir sıralama düzeni de reddedilir. Bu durumlarda hiçbir şey kaydedilmez. Sayı olmayan (veya negatif) bir tutar ya da ağırlık bildirilir ve önceki değeri korunur. Maximum weight (kg) değerinden büyük bir Minimum weight (kg) (maksimum boşsa 30 kg) da bildirilir, çünkü yöntem hiç gösterilmez; her iki ağırlık da önceki değerlerini korur. Tablodaki sayı olmayan fiyatlar bildirilir ve boş bırakılır. Diğer değerler kaydedilir.

Genel

Enable/Disable: LP Express'i ödeme sayfasında gösterir veya gizler (bu eklentinin durumu). Varsayılan: off.

Method title: sepette ve ödeme sayfasında müşterilere gösterilen kargo yöntemi adı. Varsayılan: LP Express parcel terminal. Zorunlu, en fazla 64 karakter.

Tax class: --- None --- (varsayılan) aşağıdaki fiyatların nihai olduğu anlamına gelir. Bir vergi sınıfıyla OpenCart, kargo vergisini aşağıdaki fiyatların üzerine ekler.

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

Fiyatlar (mağazanızın varsayılan para biriminde, bölüm başlığında gösterilir; ondalıklar 2.99 veya 2,99 olarak yazılabilir)

Price table: hedef ülke başına bir satır. Satır eklemek için Add country düğmesine, satır silmek için kaldır düğmesine tıklayın. Kendi satırı olmayan her ülke için * Any other country seçin. Her satırda bir Base price ve ağırlık sütunları vardır: 1 kg'a kadar XS, 2 kg'a kadar S, 3 kg'a kadar M, 5 kg'a kadar L ve 5 kg üzerinde XL. Ağırlık sepetin ağırlığıdır; Per item seçiliyse tek bir ürünün ağırlığıdır. Boş bir sütun satırın temel fiyatını kullanır. 0 ücretsiz anlamına gelir. Hiçbir fiyatı olmayan satır kaydedilmez.

Fallback cost: fiyat tablosunda hedef ülke için satır (veya fiyat) yoksa kullanılır. Bu ülkelerde yöntemi gizlemek için boş bırakın.

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

Per order (tier by total cart weight): sepet için tek bir fiyat; ağırlık sütunu sepetin toplam ağırlığına göre seçilir. Bu varsayılandır.

Per item (each item priced by its own weight x quantity): her ürün kendi ağırlığının miktarla çarpımına göre fiyatlandırılır ve fiyatlar toplanır.

Free shipping from: LP Express'in ücretsiz olduğu sepet tutarı (kargo gerektiren ürünler, indirimlerden sonra, vergi hariç). Fiyat tablosundan önce uygulanır, bu yüzden kendi satırı olmayan ülkeleri de kapsar. Ücretsiz kargo yoksa boş bırakın.

Erişilebilirlik

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

Maximum weight (kg): sepet bundan ağırsa yöntemi gizler. LP Express terminalleri 30 kg'a kadar paket kabul eder. Varsayılan: 30. 0 sınır olmadığı anlamına gelir. Boş, 30 kg anlamına gelir; Ignore shipping zones açıksa sınır olmaz.

Minimum cart total: yöntemi yalnızca bu sepet tutarından itibaren gösterir (kargo gerektiren ürünler, indirimlerden sonra, vergi hariç). Her zaman göstermek için boş bırakın.

Geo zone: yöntem yalnızca bu coğrafi bölgedeki adresler için sunulur. 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 coğrafi bölge kontrol edilmez.

Ignore shipping zones: coğrafi bölge ne olursa olsun, LP Express'i aşağıda listelenen ülkeler için sunar. Bu modda coğrafi bölge kontrol edilmez. Kapalıyken ülkeler coğrafi bölgeyle belirlenir. Bu seçenek önerilir. Varsayılan: off.

Countries (without zones): bu mod için hedef ülkeler. Bu alan yalnızca Ignore shipping zones açıkken kullanılır. Yöntemi tüm ülkelerde sunmak için boş bırakın.

Paket terminalleri

Terminal list: terminallerin nereden geldiği.

LP Express online list: çevrimiçi liste günde bir kez indirilir. Yüklenemezse, son indirilen kopya kullanılır, ardından aşağıdaki kendi listeniz. Bu varsayılandır.

Only my own list: yalnızca aşağıya girdiğiniz terminaller sunulur.

Gelişmiş

Debug log: fiyat hesaplaması ve terminal listesi ayrıntılarını storage/logs/vfd_lpex_debug.log.php (OpenCart 4'te system/storage/logs/vfd_lpex_debug.log.php) dosyasına yazar. Dosya web üzerinden okunamaz. Kullanılamayan bir terminal listesi veya terminalsiz bir sipariş gibi hatalar her zaman kaydedilir. Müşteri verileri kaydedilmez. Dosya 5 MB'a ulaştığında yeni bir günlük başlatılır.

Log: günlüğü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 eklentiyi kaldırmak ayarları, kayıtlı terminal listesini, günlüğü ve tamamlanmamış ödemelerin terminallerini siler. Kapalıyken (varsayılan) ayarlar yeniden kurulum için korunur. Siparişlerde kaydedilen terminal 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ılan 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. Değerler normal bir kayıttaki gibi kontrol edilir.

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

OpenCart kargo yöntemlerini gösterirken eklentiden LP Express fiyatını ister. Bir Geo zone ayarlanmışsa ve adres bunun dışındaysa LP Express sunulmaz. Ignore shipping zones ile coğrafi bölge kontrol edilmez: LP Express yalnızca listelenen ülkeler için sunulur (liste boşsa tüm ülkeler için). Yalnızca Requires Shipping değeri Yes olarak ayarlanmış ürünler sayılır: diğer ürünler ağırlık eklemez ve sepet tutarına dahil edilmez. Sepet tutarı, bu ürünlerin kupon indiriminden sonra ve vergiden önceki fiyatıdır. Hediye sertifikaları, ödül puanları ve mağaza kredisi dikkate alınmaz.

Eklenti sepet ağırlığını ve asgari sepet tutarını kontrol eder. Ücretsiz kargo uygulanırsa fiyat 0 olur. Aksi halde fiyat ülke satırından (veya * satırından) gelir: ağırlık sütunu, yoksa temel fiyat, yoksa yedek maliyet. Fiyat yoksa veya kullanılabilir paket terminali yoksa yöntem gizlenir; böylece müşteri asla tamamlanamayacak bir ödeme sayfası görmez.

Fiyatlar ve tutarlar mağazanızın varsayılan para birimindedir. Fiyat kendi ondalık basamaklarına yuvarlanır ve müşteriye, seçilen Tax class vergisiyle birlikte kendi para biriminde gösterilir.

Çevrimiçi terminal listesi 24 saat önbelleğe alınır. 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 etkin terminaller sunulur. Şehri olmayan terminaller Other altında listelenir.

OpenCart 4'te müşteri, ödeme sayfasının teslimat yöntemi bloğunda Choose düğmesine tıklar ve Shipping method options penceresinde LP Express'i seçer. Fiyatlar OpenCart 3 ile aynıdır.

Eklenti LP Express veya Unisend fiyatlarını sorgulamaz, gönderi oluşturmaz, etiket basmaz, kurye çağırmaz ve paketleri takip etmez. Gönderileri Unisend hesabınızda ("Mano siuntos") oluşturun. Kapıya kurye teslimatı bu yöntemin parçası değildir.

Teslim noktaları

Müşteri teslimat yöntemi adımında LP Express seçtiğinde, altında iki listeyle birlikte LP Express parcel terminal bloğu görünür: -- Select city -- ve -- Select parcel terminal --. Terminal listesi yalnızca LP Express seçildiğinde yüklenir. Teslimat adresindeki şehir, listedeki bir şehirle eşleşirse önceden seçilir. Her terminal adı, adresi ve posta koduyla gösterilir. Seçim hemen ödeme için kaydedilir; böylece ödeme sayfası yenilendiğinde kaybolmaz.

Bir terminal zorunludur. Müşteri Continue düğmesine tıkladığında sunucu terminali listeye karşı yeniden kontrol eder. Terminal yoksa ödeme sayfası Please select an LP Express parcel terminal. mesajını gösterir. 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. Hiçbir terminal yüklenemezse müşteri The LP Express parcel terminal list is temporarily unavailable. Please try again later or choose another shipping method. mesajını görür.

OpenCart 4'te müşteri LP Express'i seçtiğinde, Shipping method options penceresinde LP Express seçeneğinin altında iki listeyle birlikte LP Express parcel terminal bloğu görünür. Pencerenin Continue düğmesi geçerli bir terminal olmadan ilerlemez; mesajlar aynıdır.

Terminal kimliği, adı ve şehir siparişle birlikte kaydedilir. Yönetici sipariş sayfasındaki LP Express parcel terminal paneli (Sales > Orders, sipariş bilgisi) şehri, terminali ve Terminal ID değerini gösterir. Siparişin kargo yöntemi, yöntem başlığını, iki noktayı, şehri ve terminali gösterir (örneğin LP Express parcel terminal: Kaunas, …); böylece müşterinin sipariş ayrıntılarında, sipariş e-postalarında ve faturada görünür. Bir siparişte terminal yoksa yönetici sipariş sayfası No parcel terminal was chosen for this order. mesajını gösterir. Eklenti devre dışıyken verilen siparişler için de panel gösterilir. OpenCart 4'te panel History bölümünün üstünde gösterilir. OpenCart 4, ödeme için tek bir sipariş tutar ve müşteri her onayladığında bunu günceller; siparişin terminali de onunla birlikte güncellenir. Müşteri bu siparişi başka bir kargo yöntemine geçirirse, terminali kaldırılır.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox LP Express lisans bloğu, Extensions > Extensions > Shipping > VibeFox LP Express > Edit sayfasının ayarların üstündeki ilk bloğudur. 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 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-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 bu eklenti için Modify yetkisi olan 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 tarihiyle birlikte 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 eklenti son bilinen durumla çalışmaya devam eder.

Bir anahtar bir alan adında çalışır: OpenCart yapılandırmasındaki mağaza adresi. Anahtarı mağazadan kaldırmak alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızda serbest bırakın.

Etkin bir anahtar olmadan LP Express kargo yöntemi ödeme sayfasında müşterilere gösterilmez ve hiçbir fiyat hesaplanmaz. Yönetici paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, yöntemi mağazada (unlicensed — visible to admins only) işaretiyle hâlâ görür; böylece bir anahtar satın almadan önce eklentiyi kurabilir ve test edebilirsiniz. OpenCart 4'te bu önizleme kullanılamaz: mağaza yönetici girişini görmez, bu yüzden etkin anahtar olmadan yöntem herkesten gizlenir. Edit sayfasını bir kez açtıktan sonra, yönetici Dashboard ekranında bir hatırlatma belirir. 7 gün gizlemek için × ile kapatın. Mevcut siparişler etkilenmez.

Bir lisans sona erdiğinde eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetici Dashboard ekranını veya Edit sayfasını açtığınızda durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonra haftada bir. Cron işi gerekmez. Eklentiyi kaldırmak lisans anahtarını ve lisans durumunu her zaman 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. Geo zone değerini kontrol edin (veya Ignore shipping zones açık ve ülke izinli mi bakın). Eklenti sayfasını açın: bir uyarı, fiyat ayarlanmamışsa veya kullanılabilir paket terminali yoksa bunu açıklar. Ayrıca ağırlık sınırlarını ve Minimum cart total değerini, ürünlerde Requires Shipping değerinin Yes olduğunu kontrol edin. Debug log açıkken eklenti sayfasındaki Log alanı yöntemin neden gizlendiğini gösterir.

Paket terminali yok: çevrimiçi liste yüklenemedi ve kayıtlı bir kopya veya kendi listeniz yok. Eklenti her 15 dakikada bir yeniden dener. Own terminal list alanına kendi listenizi girin veya Only my own list seçeneğini belirleyin.

Terminal listesi güncel değil: eklenti sayfasında Save düğmesine tıklayın. Bu, terminal listesini yeniden yükler. Kendi listenizle çalışıyorsanız satırları kendiniz güncelleyin.

Müşteri devam edemiyor: bir paket terminali seçilmelidir. Müşteri terminal listesinin geçici olarak kullanılamadığı mesajını görüyorsa, şu anda kullanılabilir terminal yoktur. Kendi listenizi ekleyin.

Terminal seçici görünmüyor: seçici, OpenCart'ın standart ödeme sayfasının teslimat yöntemi adımına eklenir (OpenCart 4'te Shipping method options penceresinde) ve varsayılan temayla test edilmiştir. Çok değiştirilmiş bir tema veya üçüncü taraf bir ödeme eklentisi onu göstermeyebilir.

Fiyatlar hangi para biriminde: mağazanızın varsayılan para biriminde. Başka bir para birimiyle ödeme yapan müşteriler, fiyatı OpenCart döviz kuruyla çevrilmiş olarak görür.

Sayfada "Warning: You do not have permission to modify VibeFox LP Express!" 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_lp_express (OpenCart 3) veya extension/vfd_lp_express/shipping/vfd_lp_express (OpenCart 4) için değiştirme yetkisi verin.

Geliştiriciler için: terminal listesinin adresi vfd_lpex_feed_url ayarıyla değiştirilebilir (testler için); ayar sayfasında bunun bir alanı yoktur.

Kaldırma

Extensions > Extensions bölümüne gidin, Shipping türünü seçin ve VibeFox LP Express yanındaki Uninstall düğmesine (kırmızı −) tıklayın. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. OpenCart her zaman Enable/Disable, Sort order, Tax class ve Geo zone değerlerini sıfırlar. Eklentinin olayları her zaman kaldırılır ve önbelleğe alınmış terminal listesi temizlenir. Remove data on uninstall açıksa ayarlar, günlük, kayıtlı terminal listesi kopyası ve tamamlanmamış ödemelerin terminalleri de kaldırılır. Kapalıysa diğer ayarlar ve kayıtlı kopya korunur ve eklentiyi yeniden kurduğunuzda tekrar kullanılır. Siparişlerde kaydedilen terminal hiçbir zaman silinmez ve mevcut siparişler terminali kendi kargo yönteminde tutmaya devam eder.

OpenCart 4'te eklenti dosyalarını da kaldırmak için, kaldırmadan sonra Extensions > Installer bölümüne gidin, kurulu eklentiler listesinde VibeFox LP Express 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.

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