VibeFox Packeta 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 temanın varsayılan ödeme sayfasıyla.

PHP: 8.0 veya üzeri.

Packeta API anahtarı: Packeta müşteri bölümünde (client.packeta.com) Client support altında bulabilirsiniz. 16 harf ve rakamdan oluşur. Widget'ın ödeme sayfasında açılması için bu anahtara ihtiyaç vardır; bu nedenle yöntem, müşterilere yalnızca API anahtarı girildikten sonra gösterilir.

Ülkeler: Çek Cumhuriyeti, Slovakya, Macaristan veya Romanya mağazanızda etkin ülkeler olarak bulunmalıdır. Bunlar OpenCart'ın standart verilerinde yer alır. Macaristan'ın OpenCart'ta bölgesi yoktur, bu nedenle adresin bölge alanı boş kalır; bunun bir önemi yoktur.

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

Kurulum

İndirme dosyası, 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_packeta-oc3-(version).ocmod.zip ve OpenCart 4 paketi vfd_packeta.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_packeta-oc3-(version).ocmod.zip dosyasını seçin. Eklenti OCMOD değişiklikleri eklemez, bu nedenle Extensions > Modifications bölümünü yenilemeniz gerekmez. Installer yerine, paketteki 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 Packeta eklentisini 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ı License key alanına, Edit sayfasının üstündeki lisans bloğuna girin ve Activate düğmesine tıklayın (bkz. License key).

5. Packeta API key değerinizi ve fiyatlarınızı girin: en az bir Country prices satırı (örneğin * Default) veya bir Fallback cost. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Sayfa, Packeta'nın anahtarı kabul edip etmediğini gösterir.

OpenCart 4

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve vfd_packeta.ocmod.zip dosyasını seçin. Dosya adını değiştirmeyin: OpenCart 4 eklenti kodunu dosya adından alır, adı değiştirilmiş 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 sayfasına gidin ve eklenti türü olarak Shipping seçin. VibeFox Packeta eklentisini bulun, Install düğmesine (yeşil +) ve sonra Edit düğmesine (kalem düğmesi) tıklayın.

4. Lisans anahtarını, API anahtarını ve fiyatları OpenCart 3'teki 4. ve 5. adımlarda olduğu gibi girin. Ayar 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. Eklentiyi kaldırdıktan sonra yeniden kurarsanız, sakladığınız Packeta ayarları yeniden kullanılır.

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Shipping > VibeFox Packeta > 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 eklenti için değiştirme yetkisi olan yönetici kullanıcılar kaydedebilir.

Yöntem yalnızca Packeta'nın kendi teslim alma noktası ağındaki ülkeler için sunulur: CZ, SK, HU ve RO. Ayarların üstünde sayfa, API anahtarı kontrolünün sonucunu ve sorunlarla ilgili uyarıları gösterir: API anahtarı yok, fiyat yok, Packeta ağının dışındaki seçili ülkeler veya eklentinin tanımadığı bir mağaza ağırlık birimi. Uyarılar her kaydetmeden sonra güncellenir.

Tüm fiyatlar ve sınırlar ondalık ayracı olarak virgül veya nokta kabul eder (4,99 veya 4.99). Geçersiz veya negatif bir sayı bir mesajla reddedilir, o alanın önceki değeri korunur; diğer alanlar kaydedilir.

Genel

Enable/Disable: ödeme sayfasında Packeta'yı açar veya kapatır. Varsayılan: kapalı.

Name: müşterinin gördüğü kargo yöntemi adı. Varsayılan: Packeta pickup point. Zorunlu, en fazla 64 karakter.

API key: client.packeta.com > Client support bölümündeki Packeta API anahtarınız. 32 karakterlik API şifresini de yapıştırabilirsiniz: yalnızca API anahtarı olan ilk 16 karakteri kaydedilir. API anahtarı herkese açıktır: widget'ı açmak için müşterinin tarayıcısına gönderilir. Yeni bir anahtar kaydettiğinizde, Packeta taşıyıcı akışıyla kontrol edilir ve sayfa Packeta API key verified mesajını ya da Packeta'nın anahtarı reddettiğini gösterir. Kontrol yapılamazsa anahtar kaydedilir ve bir sonraki kaydetmenizde yeniden kontrol edilir.

Widget language: teslim alma noktası widget'ının dili. Store / visitor language (varsayılan) sayfanın dilini izler. Ayrıca Çekçe, Slovakça, Macarca, Rumence, İngilizce, Almanca, Lehçe veya Ukraynaca olarak sabitleyebilirsiniz.

Pickup point types: widget'ın sunduğu Packeta noktaları.

Tax status: kargo ücretine uygulanan OpenCart vergi sınıfı veya None (no tax on shipping) (varsayılan).

Sort order: ödeme sayfasındaki kargo yöntemleri arasında Packeta'nın konumu. Tam sayı.

Fiyatlar

Packeta herkese açık bir ücret API'si sunmaz. Fiyatlar bu tablodan gelir ve mağazanızın varsayılan para biriminde, vergi hariç girilir. Başka bir para birimiyle ödeme yapan müşteriler dönüştürülmüş fiyatı görür.

Calculation type: Per order (varsayılan) ücreti bir kez alır. Per item (price x quantity) ise ücreti kargo gerektiren ürünlerin adediyle çarpar.

Country prices: hedef ülke ve paket ağırlığı başına bir fiyat. Satır eklemek için Add country düğmesine, satır silmek için × düğmesine tıklayın. Her satırda bir Price ve ağırlık sütunları vardır: XS 1 kg'a kadar, S 1–2 kg, M 2–3 kg, L 3–5 kg ve XL 5 kg'ın üzeri. 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. Yeni bir satır, tüm fiyatları 0 olan bir * Default olarak başlar; bu da ücretsiz kargo anlamına gelir. Kaydetmeden önce ülkeyi seçin ve fiyatları girin ya da satırı silin. Aynı ülke (veya * Default) iki satırda varsa, kaydedildiğinde yalnızca ilki tutulur. Tablodaki bir değer 0 veya daha büyük bir sayı değilse, tablo kaydedilmez ve sayfa hatalı değerleri listeler.

Fallback cost: ülke tablosunda hedef için satır ve * Default satırı yoksa kullanılır. Yöntemin orada sunulmaması için boş bırakın.

Free shipping from: Packeta teslimatının ücretsiz olduğu sepet ara toplamı (kupon sonrası, vergi hariç). Fiyat tablosundan önce kontrol edilir: bu tutardan itibaren, yöntemin sunulduğu her Packeta ülkesinde teslimat ücretsizdir; ülke satırı veya yedek maliyeti olmayan bir ülkede bile. Hiçbir zaman ücretsiz kargo sunulmaması için boş bırakın.

Erişilebilirlik

Minimum weight (kg): sepet daha hafif olduğunda yöntemi gizler. Ürün ağırlıkları OpenCart ağırlık sınıflarından dönüştürülür. Boş veya 0 sınır olmadığı anlamına gelir.

Maximum weight (kg): sepet daha ağır olduğunda yöntemi gizler. Varsayılan: 15. Packeta teslim alma noktaları ve Z-BOX'lar genellikle 15 kg'a kadar paketleri kabul eder; Packeta sözleşmenizi kontrol edin. Boş veya 0 sınır olmadığı anlamına gelir. Maksimum değerden büyük bir minimum ağırlık kaydedilirken reddedilir ve önceki iki değer korunur.

Minimum cart subtotal: yöntemi yalnızca sepet ara toplamı (kupon sonrası, vergi hariç) bu tutara ulaştığında sunar.

Geo zone: Packeta'yı yalnızca bu coğrafi bölgedeki adresler için sunar. All zones (varsayılan) sınır olmadığı anlamına gelir. Ignore shipping zones açıkken kontrol edilmez. 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 ve yöntem aşağıda seçilen ülkeler için sunulur. Kapalıyken (varsayılan) yalnızca yukarıdaki coğrafi bölgede sunulur.

Countries (ignore zones mode): bu mod için hedef ülkeler. Tüm Packeta ülkelerini kullanmak için boş bırakın. Packeta teslim alma noktası ağının dışındaki ülkeler atlanır. Bu alan yalnızca Ignore shipping zones açıkken kullanılır.

Gelişmiş

Debug log: ücret hesaplamalarını ve teslim alma noktası seçimlerini storage/logs/vfd_pckt_debug.log.php dosyasına yazar. Dosya web üzerinden okunamaz. Müşterilerin kişisel verileri ve API anahtarı günlüğe yazılmaz. Hatalar ve başarısız API anahtarı kontrolleri her zaman günlüğe yazılır. İşiniz bittiğinde günlüğü kapatın. Dosya 5 MB'a ulaştığında vfd_pckt_debug.old.log.php dosyasına taşınır ve yeni bir günlük başlatılır.

Log (last lines): hata ayıklama günlüğünü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 eklentiyi kaldırmak ayarları ve günlüğü siler. Kapalıyken (varsayılan) ayarlar yeniden kurulum için korunur. Siparişlerde kaydedilen teslim alma noktası her zaman korunur.

İçe / Dışa Aktarma

Dışa aktarma: ayarları, herkese açık olan API anahtarı dahil, bir JSON dosyası olarak kaydetmek için Download JSON düğmesine tıklayın.

İçe aktarma: 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. Değerler normal bir kaydetmedeki gibi kontrol edilir.

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

OpenCart kargo yöntemlerini gösterdiğinde, Packeta fiyatını eklentiden ister. Bir Geo zone ayarlıysa (ve Ignore shipping zones kapalıysa) ve adres bunun dışındaysa, Packeta sunulmaz. Yalnızca Requires Shipping değeri Yes olan ürünler sayılır: diğer ürünler ağırlık eklemez ve ara toplama dahil edilmez. Eklenti koşulları kontrol eder: teslimat ülkesinin Packeta ağında olması, API anahtarı, bölgeleri yok sayma modundaki ülke listesi, sepet ağırlığı ve minimum sepet ara toplamı. Ara toplam, kupon indiriminden sonra ve vergi hariç, kargo gerektiren ürünlerin fiyatıdır. Hediye sertifikaları, puan ödülleri ve mağaza kredisi dikkate alınmaz. Ücretsiz kargo uygulanıyorsa fiyat 0'dır. Aksi halde fiyat önce ülke tablosundan, ardından yedek maliyetten alınır. Fiyat yoksa yöntem gizlenir. Fiyat, müşteriye seçili Tax status vergisiyle birlikte kendi para biriminde gösterilir.

Kargo yöntemi adımındaki Packeta seçeneğinin altında Choose pickup point düğmesi bulunur. Bu düğme, müşterinin tarayıcısında resmi Packeta widget'ını hedef ülke, sepet ağırlığı, seçilen nokta türleri ve widget dili ile açar. Müşteri bir nokta seçtikten sonra, adı ve adresi yöntemin altında gösterilir ve düğme Change pickup point olarak değişir. Nokta, ödeme oturumu için kaydedilir ve sayfa yeniden yüklendiğinde korunur. Teslimat adresi başka bir ülkeye değiştirildiğinde, başka bir ülke için seçilmiş bir nokta kullanılmaz.

Sunucunuz ödeme sırasında Packeta'dan hiçbir şey istemez. Widget betiği yalnızca ödeme sayfasında widget.packeta.com'dan yüklenir. Engellenirse (bir reklam veya gizlilik engelleyicisi, bir içerik güvenlik politikası veya Packeta kesintisi nedeniyle), müşteri şu mesajı görür: "The Packeta pickup point widget could not be loaded. Please reload the page or choose another shipping method."

Packeta fiyatları canlı olarak sorgulanmaz; tablonuzdan gelir. Eklenti Packeta gönderileri oluşturmaz, etiket yazdırmaz veya paketleri takip etmez; ayrıca varsayılan olarak adrese teslimat veya iş ortağı taşıyıcı teslim alma noktaları sunmaz. Siparişteki teslim alma noktası kimliğini Packeta'ya her zamanki yönteminizle, örneğin client.packeta.com üzerinden içe aktarma ile iletin. Teslim alma noktası düğmesi, varsayılan temanın standart OpenCart ödeme sayfasıyla çalışır.

OpenCart 4'te müşteri, ödeme sayfasındaki kargo yöntemi bloğunda Choose düğmesine tıklar ve Shipping method options penceresinde Packeta seçeneğini seçer. Choose pickup point düğmesi ve seçilen nokta, Packeta seçeneğinin altında bu pencerede görünür ve Packeta widget'ı bunun üzerinde açılır. Fiyatlar OpenCart 3'tekiyle aynıdır.

Teslim alma noktaları

Teslim alma noktası zorunludur. Müşteri kargo yöntemi adımında bir nokta seçmeden Continue düğmesine tıklarsa, adım tamamlanmaz ve müşteri "Please choose a Packeta pickup point." mesajını görür. Seçilen nokta teslimat adresinden farklı bir ülkedeyse, müşteri "The selected Packeta pickup point is not in your shipping country. Please choose a pickup point again." mesajını görür. Eklenti nokta kimliğini Packeta ile doğrulamaz; yalnızca bir noktanın seçildiğini ve ülkesinin eşleştiğini kontrol eder.

Nokta, sipariş oluşturulduğunda siparişe eklenir:

Siparişin kargo yöntemi: noktanın adı ve adresi yöntem adına eklenir, örneğin Packeta pickup point: <point> (128 karakterye kadar). Müşteri bunu sipariş geçmişinde ve sipariş e-postasında görür; faturada da yazdırılır. OpenCart'ın sipariş başarı sayfası kargo yöntemini göstermez.

Yönetici sipariş sayfası: siparişi Sales > Orders bölümünde açın. Bir Packeta pickup point paneli adı ve adresi, Pickup point ID değerini ve ülkeyi gösterir. Bir Packeta siparişinde nokta yoksa, panel "No pickup point was selected for this order." mesajını gösterir.

OpenCart 4'te Shipping method options penceresindeki Continue düğmesi, noktası olmadan ilerlemez; mesajlar aynıdır. OpenCart 4 ödeme için tek bir sipariş tutar ve müşteri her onaylamada onu günceller; siparişin noktası onunla birlikte güncellenir. Yönetici sipariş sayfasındaki Packeta pickup point paneli History bölümünün üzerinde gösterilir.

Nokta, eklentinin kendi tablosu olan vfd_pckt_point içinde saklanır (ödeme oturumu, sipariş, nokta kimliği, ad ve adres, ülke).

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Packeta lisans bloğu, Extensions > Extensions > Shipping > VibeFox Packeta > 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ı maskeli olarak, durumu (örneğin lisansın geçerli olduğu tarihi ve alan adınızı), Check now düğmesini (durumu yeniden kontrol eder), Change key düğmesini (başka bir anahtar girer) ve Remove key düğmesini (anahtarı bu mağazadan kaldırır) gösterir. Bunların altında Product: opencart-shipping-packeta 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 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 ya da hesabınızda bir alan adı yuvasını boşalttıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Bir anahtar tek 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 Packeta ödeme sayfasında müşterilere gösterilmez ve tarife hesaplanmaz. Yönetici paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, yöntemi yine de mağazada görür; yöntem (unlicensed — visible to admins only) ile işaretlenir. Böylece anahtarı satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu önizleme yoktur: mağaza yönetici girişini görmez, bu nedenle etkin bir anahtar yoksa yöntem herkesten gizlenir. Edit sayfasını bir kez açtıktan sonra yönetici Dashboard ekranında bir hatırlatma görünür. Bunu × ile kapatırsanız 7 gün gizlenir. 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, yönetici Dashboard ekranını veya Edit sayfasını açtığınızda otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonrasında haftada bir. Cron işi gerekmez. Eklentiyi kaldırmak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

Packeta ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, API key değerinin girildiğini ve teslimat ülkesinin CZ, SK, HU veya RO olduğunu kontrol edin. Ülke için bir fiyatın ayarlandığını kontrol edin (ülke satırı, * Default satırı veya Fallback cost), ağırlık ve ara toplam sınırlarını ve Geo zone ayarını (veya Ignore shipping zones ve ülkelerini). Ürünlerde Requires Shipping değerinin Yes olduğunu kontrol edin. Ayarlar sayfası yapılandırma sorunlarını en üstte listeler. Nedeni Log (last lines) içinde görmek için Debug log seçeneğini açın.

Packeta API anahtarını reddetti: API anahtarını client.packeta.com > Client support bölümünden yeniden kopyalayın ve kaydedin. O zamana kadar widget ödeme sayfasında açılamaz.

Widget açılmıyor: Packeta betiği bir reklam veya gizlilik engelleyicisi, bir içerik güvenlik politikası veya Packeta kesintisi tarafından engellenmiş. İçerik güvenlik politikanızda widget.packeta.com alan adına izin verin.

Kargo yanlışlıkla ücretsiz: Country prices içinde Price değeri 0 olan satırları kontrol edin; özellikle Add country ile eklenmiş ve doldurulmamış bir * Default satırını ve Free shipping from değerini kontrol edin.

Ağırlık sınırları veya ağırlık sütunları yanlış görünüyor: sayfa mağazanın ağırlık birimi hakkında uyarı veriyorsa, kg, g, lb veya oz birimine sahip ağırlık sınıfları kullanın ve System > Settings bölümündeki Local sekmesinde varsayılan ağırlık sınıfını ayarlayın. Diğer birimler kilogram olarak okunur.

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

Geliştiriciler için: diğer eklentiler ülke ekleyebilir, widget'a taşıyıcı kimlikleri gibi seçenekler iletebilir, widget betiğinin URL'sini veya dilini vfd_packeta/countries, vfd_packeta/widget_options, vfd_packeta/widget_url ve vfd_packeta/widget_language OpenCart olaylarıyla değiştirebilir (önekli catalog/ tetikleyicileri, örneğin catalog/vfd_packeta/widget_options).

Kaldırma

Extensions > Extensions bölümüne gidin, Shipping türünü seçin ve VibeFox Packeta yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Bu eklentinin 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. Kaydedilmiş API anahtarı kontrolü her zaman kaldırılır ve teslim alma noktası düğmesi ile sipariş paneli artık gösterilmez. Remove data on uninstall açıksa, ayarlar, günlük ve hiçbir zaman siparişe dönüşmemiş ödemelerin teslim alma noktaları silinir. Kapalıysa diğer ayarlar korunur ve eklentiyi yeniden kurduğunuzda tekrar kullanılır. Mevcut siparişler her zaman kaydedilmiş teslim alma noktasını ve kargo yöntemindeki noktayı korur.

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

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