VibeFox Loggi for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 üzerinde test edildi) veya 4.0.2 ve sonraki sürümler (4.1.0.3 üzerinde test edildi).

PHP: 8.0 veya üzeri.

Loggi hesabı (yalnızca anlık fiyatlar için): anlık fiyat, Loggi'nin işletme hesaplarına verdiği bir API anahtarıyla Loggi GraphQL API'sini kullanır. Bunu Loggi hesap yöneticinizden veya Loggi entegrasyon desteğinden (integracoes@loggi.com) isteyin; ayrıca docs.api.loggi.com adresindeki Loggi API belgelerine bakın. Üç değere ihtiyacınız vardır: Loggi hesabınızın e-postası, API anahtarı ve mağazanızın sayısal kimliği. Loggi hesabınızda yalnızca yeni Loggi REST platform API'si için kimlik bilgileri (istemci kimliği ve gizli anahtar) varsa anlık fiyat kullanılamaz ve sabit fiyatlar kullanılır. Yalnızca sabit fiyatları kullanıyorsanız Loggi hesabına ihtiyacınız yoktur.

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_loggi-oc3-(version).ocmod.zip ve OpenCart 4 paketi vfd_loggi.ocmod.zip bulunur. Yalnızca OpenCart sürümünüz için olan paketi kurun. Lisans anahtarı iki sürüm için de aynıdır.

OpenCart 3

1. Yönetici panelinde Extensions > Installer sayfasına gidin, Upload düğmesine tıklayın ve vfd_loggi-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 bu paketteki upload klasörünün içeriğini mağazanızın kök klasörüne de kopyalayabilirsiniz.

2. Extensions > Extensions sayfasına gidin ve eklenti türü olarak Shipping seçin. VibeFox Loggi öğesini 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 bulunan License key alanına girin ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

5. Loggi API e-postasını, API anahtarını, Mağaza Kimliğini ve teslim alma adresini girin; mağazanızın varsayılan para birimi BRL değilse BRL döviz kurunu da girin. Güvenlik ağı olarak sabit fiyatlar ekleyin (bkz. Configuration), Enable Loggi seçeneğini açın ve Save düğmesine tıklayın.

OpenCart 4

1. Yönetici panelinde Extensions > Installer sayfasına gidin, Upload düğmesine tıklayın ve vfd_loggi.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 yüklü eklentiler listesinde görünür. Yanındaki Install düğmesine (yeşil + düğmesi) tıklayın.

3. Extensions > Extensions sayfasına gidin ve eklenti türü olarak Shipping seçin. VibeFox Loggi öğesini bulun, Install düğmesine (yeşil + düğmesi) tıklayın, 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ımlardaki gibi girin. Ayarlar sayfası ve alanları iki sürümde de aynıdır.

Kurulumda eklenti, önbelleğe alınmış Loggi fiyatları için küçük bir tablo oluşturur. Enable Loggi seçeneğini açıp kaydedene kadar yöntem kapalı kalır. Eklentiyi kaldırdıktan sonra yeniden kurarsanız, sakladığınız Loggi ayarları yeniden kullanılır.

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Shipping > VibeFox Loggi > Edit. Bölümler solda listelenir. Tüm coğrafi bölgeler için geçerlidirler. Sayfanın altındaki tek Save düğmesi tüm sayfayı yeniden yüklemeden kaydeder. Her kayıt ayrıca önbelleğe alınmış Loggi fiyatlarını temizler. Bir değer geçersizse, örneğin negatif bir sayı, hatalı bir e-posta veya sayı olmayan bir Mağaza Kimliği, sayfa bir hata gösterir ve hiçbir şey kaydedilmez. Ayarları yalnızca bu eklenti için değiştirme yetkisi olan yönetici kullanıcılar kaydedebilir.

Ayarların üstündeki uyarılar (her kayıttan sonra yeniden gösterilir) eksik bir yapılandırmaya işaret eder: API kimlik bilgisi yok (yalnızca sabit fiyatlar kullanılır), API kimlik bilgisi ve sabit fiyat yok (yöntem asla gösterilmez), teslim alma adresi yok veya BRL döviz kuru yok. Mağazada kg birimli bir ağırlık sınıfı veya cm birimli bir uzunluk sınıfı yoksa ve varsayılan sınıfın birimi tanınmıyorsa başka bir uyarı görünür. Bu durumda ürün ağırlıkları kg, boyutlar cm olarak sayılır. Sınıfları System > Localisation > Weight Classes ve Length Classes bölümünde ekleyin.

Genel

Enable Loggi: ödeme sayfasında Loggi'yi gösterir veya gizler. Varsayılan: kapalı.

Method title: sepette ve ödeme sayfasında müşteriye gösterilen kargo yöntemi adı. Varsayılan: Loggi. Zorunlu, en fazla 64 karakter, < > ; = # { } karakterleri olmadan.

Sort order: Loggi'nin ödeme sayfasındaki kargo yöntemleri arasındaki konumu. Tam sayı.

Loggi API (anlık fiyat) (yalnızca sabit fiyatları kullanmak için kimlik bilgilerini boş bırakın)

API e-mail: Loggi hesabınızın e-postası. API anahtarı bu hesaba aittir. Geçerli bir e-posta adresi olmalıdır. Temizlenmesi kayıtlı API anahtarını da temizler.

API key: Loggi API anahtarınız. Yalnızca Loggi'ye gönderilir ve asla günlüğe yazılmaz. Kaydettikten sonra alan boş kalır ve Saved — leave empty to keep it; clear the API e-mail to remove it. ifadesini gösterir. Yalnızca değiştirmek için yeni bir değer girin. API e-mail değerini değiştirirseniz, yeni e-posta için API anahtarını da girin; aksi halde sayfa bir hata gösterir ve hiçbir şey kaydedilmez.

Shop ID: Loggi panelindeki mağazanızın sayısal kimliği (pk), örneğin 12345. Başka bir değer hatayla reddedilir.

Staging: test kimlik bilgileriyle Loggi test ortamını (staging) kullanın. Test ve üretim ortamlarının hesapları ve anahtarları farklıdır. Varsayılan: kapalı.

Pickup address: Loggi'nin paketleri aldığı yer, tek satırda: sokak ve numara, mahalle, şehir, eyalet ve CEP, örneğin Rua Example, 123 - Bairro, São Paulo - SP, 01310-100. Anlık fiyatlar için zorunludur: OpenCart'taki mağaza adresi serbest metindir, bu yüzden asla onun yerine kullanılmaz. Teslim alma adresi olmadan Loggi tahmin yapamaz ve yalnızca sabit fiyatlar kullanılır.

BRL exchange rate: Loggi fiyatları Brezilya reali cinsindendir. Mağazanızın varsayılan para birimi BRL ise bu alan gerekli değildir ve sayfa bunu belirtir. Aksi halde 1 BRL'nin mağaza para biriminizde ne kadar olduğunu girin, örneğin 0.16. Bu olmadan anlık fiyatlar kullanılmaz. Yalnızca pozitif bir sayı kabul edilir. Ondalık ayırıcı olarak hem nokta hem virgül kabul edilir.

Sabit fiyatlar (mağazanızın varsayılan para biriminde, vergi hariç)

Sabit fiyatlar, Loggi API yapılandırılmadığında, Brezilya dışındaki veya tam CEP'i olmayan hedefler için ve Loggi fiyat döndürmediğinde (API kullanılamıyor, anahtar reddedildi, adres kapsama alanı dışında) kullanılır.

Price table: hedef ülke başına bir satır. Satır eklemek için Add country düğmesine, bir satırı silmek için silme düğmesine tıklayın. Kendi satırı olmayan tüm ülkeler için * All other countries seçin. Her satırın bir Base price değeri ve ağırlık sütunları vardır: XS 1 kg'a kadar, S 2 kg'a kadar, M 3 kg'a kadar, L 5 kg'a kadar ve XL 5 kg'ın üzeri. Boş (veya 0) bir ağırlık sütunu temel fiyatı kullanır. Temel fiyat 0 ücretsiz kargo anlamına gelir. Hem "9.99" hem de "9,99" kabul edilir. Boş satırlar ve aynı ülke için ikinci bir satır kaydederken silinir.

Price for countries not in the table: Loggi'den anlık fiyat yoksa ve tabloda hedef ülke için satır yoksa (ve * satırı yoksa) kullanılır. Bu durumda yöntemi gizlemek için boş bırakın.

Fixed price applies: sabit fiyatların nasıl hesaplandığı. Loggi anlık fiyatı zaten tüm sepeti kapsar ve asla çarpılmaz.

Koşullar

Minimum weight (kg): sepet bu ağırlığın altındaysa yöntemi gizler. 0 sınır olmadığı anlamına gelir (varsayılan).

Maximum weight (kg): sepet bu ağırlığın üzerindeyse yöntemi gizler. Varsayılan: 30. 0 sınır olmadığı anlamına gelir. Minimum weight, Maximum weight değerinden büyük olamaz.

Minimum order amount: yöntemi yalnızca kargo gerektiren ürünlerin ara toplamı (kupon sonrası, vergi öncesi) bu tutara ulaştığında gösterir. Her zaman göstermek için boş bırakın.

Free shipping from: Loggi teslimatının ücretsiz olduğu, kargo gerektiren ürünlerin ara toplamı (kupon sonrası, vergi öncesi). Ücretsiz kargo yoksa boş bırakın.

Tax class: kargo ücretinin vergi sınıfı veya No tax (varsayılan). Fiyatlarınız ve Loggi fiyatı zaten vergi içeriyorsa No tax seçin.

Geo zone: Loggi'yi yalnızca bu coğrafi bölgedeki adresler için sunun. All zones (varsayılan) sınır olmadığı 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.

Ağırlık sınırları ve ağırlık sütunları için, ağırlığı olmayan bir ürün 0 kg sayılır.

Ülkeler

OpenCart'ta taşıyıcı bölgeleri yoktur: Geo zone, yöntemi bir coğrafi bölgenin adresleriyle sınırlar. Bunun yerine Ignore shipping zones seçeneğini açıp bir ülke listesi seçebilirsiniz.

Ignore shipping zones: Geo zone ne olursa olsun, Loggi'yi aşağıdaki ülkeler için sunar. Bu modda coğrafi bölge kontrol edilmez. Varsayılan: kapalı.

Countries: bu mod için hedef ülkeler. Mağazada etkin olan tüm ülkelere izin vermek için boş bırakın. Bu alan yalnızca Ignore shipping zones açıkken kullanılır.

Gelişmiş

Debug log: fiyat hesaplamalarını ve Loggi isteklerini storage/logs/vfd_lggi_debug.log.php dosyasına yazar (OpenCart 4'te system/storage/logs/vfd_lggi_debug.log.php). Dosya web'den okunamaz. Bu seçenek kapalı olsa bile API hataları her zaman günlüğe yazılır. API anahtarı ve müşteri adresleri asla günlüğe yazılmaz. Dosya 5 MB'a ulaştığında vfd_lggi_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 girişlerini gösterir. Temizlemek için Clear log düğmesine tıklayın.

Remove data on uninstall: açıksa, eklentiyi kaldırmak Loggi ayarlarını ve günlüğü siler. Kapalıysa (varsayılan), yeniden kurulum için ayarlar saklanır. Önbelleğe alınmış fiyatlar her zaman silinir.

İçe / Dışa Aktarma

Export: ayarları JSON dosyası olarak kaydetmek için Download JSON düğmesine tıklayın. API anahtarı dışa aktarılmaz.

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. Değerler normal bir kayıt gibi kontrol edilir. Kaydedilmiş API anahtarı korunur.

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

OpenCart kargo yöntemlerini gösterdiğinde, eklentiden Loggi fiyatını ister. Bir Geo zone ayarlıysa, Ignore shipping zones kapalıysa ve adres coğrafi bölgenin dışındaysa, Loggi sunulmaz. Yalnızca Requires Shipping değeri Yes olarak ayarlanmış ürünler sayılır: diğer ürünler ağırlığa eklenmez ve sipariş tutarına dahil edilmez. Eklenti ardından koşulları kontrol eder: izin verilen ülkeler (Ignore shipping zones ile), sepet ağırlığı ve minimum sipariş tutarı. Sipariş tutarı, kargo gerektiren ürünlerin kupon indiriminden sonra ve vergi öncesi fiyatıdır. Hediye sertifikaları, ödül puanları ve mağaza kredisi dikkate alınmaz. Ücretsiz kargo geçerliyse fiyat 0 olur ve Loggi'ye hiçbir istek gönderilmez.

Tam 8 haneli CEP'e sahip bir Brezilya adresi için eklenti Loggi paketleri oluşturur: her ürün, en kısa kenarı yükseklik olacak şekilde döndürülür ve ürünler 55 × 55 × 55 cm ve 20 kg sınırında kaldığı sürece tek bir pakette istiflenir. Ağırlığı veya boyutları olmayan ürünler kenar başına 1 cm sayılır ve her paket en az 100 g ağırlığındadır. Loggi tahmin başına 2 paket kabul eder, bu yüzden daha büyük sepetler birden fazla istekle gönderilir ve toplamlar eklenir. Eklenti Loggi'ye Mağaza Kimliğinizi, teslim alma adresini, teslimat adresini (sokak, şehir, eyalet ve CEP) ve paketleri gönderir ve Loggi toplamını BRL'den mağazanızın varsayılan para birimine çevirir. Fiyat, o para biriminin ondalık basamaklarına yuvarlanır ve seçilen Tax class vergisiyle müşteriye kendi para biriminde gösterilir.

Her Loggi fiyatı, aynı sepetin yeni bir istek tetiklememesi için sepet, adres, hesap ve ortam başına 1 saat önbelleğe alınır. Başarısız bir tahmin 10 dakika önbelleğe alınır. Loggi hiç ulaşılamazsa, ödeme sayfası her yenilemede Loggi'yi beklemesin diye istekler 2 dakika duraklatılır. API zaman aşımı 10 saniyedir.

Sabit fiyatlar, API yapılandırılmadığında, adres Brezilya dışındaysa veya henüz tam CEP'i yoksa, BRL döviz kuru eksikse, teslim alma adresi yoksa, bir ürün bir Loggi paketinden büyükse, sepet 10'dan fazla paket gerektiriyorsa veya Loggi bir hata, reddedilen bir paket, kapsama alanı dışında bir adres ya da sıfır toplam döndürürse kullanılır. Sabit fiyat da yoksa yöntem gizlenir. Müşteri asla bir API hatası görmez. Neden hata ayıklama günlüğüne yazılır.

OpenCart 4'te müşteri, ödeme sayfasındaki kargo yöntemi bloğunda Choose düğmesine tıklar ve Shipping method options penceresinde Loggi'yi seçer. Yöntem, OpenCart 3'teki ile aynı şekilde çalışır.

Eklenti yalnızca fiyatları hesaplar. Loggi siparişleri veya gönderileri oluşturmaz, etiket basmaz, paketleri takip etmez, ödeme sayfasında teslimat süresini göstermez ve teslim noktası ya da dolap sunmaz. Siparişlere hiçbir şey eklemez: sipariş, diğer OpenCart kargo yöntemlerinde olduğu gibi yöntem adını ve kargo ücretini gösterir. Gönderileri Loggi panelinde oluşturun. Loggi yalnızca Brezilya içinde teslimat yapar. Diğer ülkeler için sabit fiyatları kullanın.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Loggi lisans bloğu, Extensions > Extensions > Shipping > VibeFox Loggi > Edit sayfasında ayarların üstünde ilk bloktur. Anahtarı License key alanına girin ve Activate düğmesine tıklayın. Bundan sonra blok, anahtarı maskelenmiş olarak, durumu (örneğin lisansın geçerli olduğu son tarih ve alan adınız) ve Check now düğmesini gösterir: durumu yeniden kontrol eder; Change key başka bir anahtar girmenizi sağlar; Remove key ise anahtarı bu mağazadan kaldırır. Bunların altında Product: opencart-shipping-loggi 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 eklenti için Modify 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 tarihli License expired on. Mağaza adresi değiştikten 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 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 Loggi 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 hâlâ görür; yöntem (unlicensed — visible to admins only) olarak işaretlenir. Böylece anahtarı satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu önizleme kullanılamaz: mağaza yönetici girişini görmez, bu yüzden etkin bir anahtar olmadan yöntem herkes için gizlenir. Edit sayfasını bir kez açtıktan sonra, yönetici paneli Dashboard sayfasında bir hatırlatma görünür. Bunu × ile kapatarak 7 gün gizleyebilirsiniz. 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. Yönetici paneli Dashboard sayfasını 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, ardından haftada bir kez. Cron işi gerekmez. Eklentiyi kaldırmak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

Loggi ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable Loggi seçeneğinin açık olduğunu kontrol edin. Geo zone, Ignore shipping zones ve Countries değerlerini, eklenti sayfasının üstündeki uyarıları, ağırlık sınırlarını ve Minimum order amount değerini kontrol edin. Müşteri henüz tam bir CEP girmediyse veya Loggi fiyat döndürmüyorsa, yöntem sabit bir fiyata ihtiyaç duyar: ülke için bir satır, bir * satırı veya Price for countries not in the table. Ürünlerde Requires Shipping değerinin Yes olarak ayarlı olduğunu kontrol edin.

Yalnızca sabit fiyatlar gösteriliyor: eklenti sayfasındaki Log alanına bakın. Hatalar her zaman günlüğe yazılır. Her adım için Debug log seçeneğini açın ve ödeme sayfasını yeniden yükleyin. Yaygın nedenler: API e-postası, anahtarı veya Mağaza Kimliği eksik, teslim alma adresi yok, BRL dışındaki bir mağaza para birimi için BRL exchange rate yok, henüz tam 8 haneli CEP yok, 55 cm'den büyük veya 20 kg'dan ağır bir ürün ya da Loggi kapsama alanı dışında bir adres.

Günlükte HTTP 401 veya 403: Loggi API e-postasını veya anahtarını reddetti. Bunları Loggi ile kontrol edin ve Staging seçeneğinin kimlik bilgilerine uyduğunu doğrulayın: test ve üretim anahtarları farklıdır.

Mağazam euro veya dolar cinsinden satış yapıyor: Loggi BRL cinsinden yanıt verir. BRL exchange rate değerini girin (1 BRL, mağazanızın varsayılan para biriminde ne kadar eder). Sabit fiyatlar her zaman mağazanın varsayılan para birimindedir.

Fiyatlar doğru değil: ürünlerinizin ağırlığını ve boyutlarını doldurun. Bunlar olmadan ürünler kenar başına 1 cm, her paket ise en az 100 g sayılır.

Ürün başına Loggi fiyatını çarpmıyor: bu bilerek böyle yapılmıştır. Loggi anlık fiyatı tüm sepeti kapsar. Per item yalnızca sabit fiyatlar için geçerlidir.

Bir değişiklikten sonra fiyatlar eski görünüyor: eklenti sayfasında Save düğmesine tıklayın. Bu, önbelleğe alınmış Loggi fiyatlarını temizler.

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

Geliştiriciler için: Loggi API adresi, vfd_lggi_api_url ayarıyla (testler için) değiştirilebilir; ayarlar sayfasında bunun bir alanı yoktur.

Kaldırma

Extensions > Extensions sayfasına gidin, Shipping türünü seçin ve VibeFox Loggi 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 Loggi, Sort order, Tax class ve Geo zone değerlerini sıfırlar. Önbelleğe alınmış Loggi fiyatları (tablosuyla birlikte) her zaman silinir. Remove data on uninstall açıksa Loggi ayarları ve hata ayıklama günlüğü de silinir. Kapalıysa diğer ayarlar korunur ve eklentiyi yeniden kurduğunuzda tekrar kullanılır. Mevcut siparişler kargo yöntemlerini ve ücretlerini korur.

OpenCart 4'te eklentinin dosyalarını da kaldırmak için kaldırma işleminden sonra Extensions > Installer sayfasına gidin, yüklü eklentiler listesinde VibeFox Loggi 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.

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