VibeFox Loggi for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

WooCommerce: 5.0 veya üzeri, kurulu ve etkin. Eklenti WooCommerce olmadan etkinleştirilemez.

PHP: 8.0 veya üzeri.

Loggi hesabı (yalnızca canlı fiyatlar için): canlı fiyat, Loggi'nin iş hesaplarına verdiği bir API anahtarıyla Loggi GraphQL API'sini kullanır. Loggi hesap yöneticinize veya Loggi entegrasyon desteğine (integracoes@loggi.com) başvurun; ayrıca docs.api.loggi.com adresindeki Loggi API belgelerine bakın. Üç değere ihtiyacınız var: Loggi hesabınızın e-posta adresi, API anahtarı ve mağazanızın sayısal ID'si. Loggi hesabınızda yalnızca yeni Loggi REST platform API'si için kimlik bilgileri (client ID ve secret) varsa canlı fiyat kullanılamaz ve sabit fiyatlar kullanılır. Yalnızca sabit fiyat 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

1. WordPress'te Plugins > Add New > Upload Plugin yolunu izleyin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. vfd_loggi klasörünü FTP ile /wp-content/plugins/ dizinine de yükleyebilirsiniz.

2. Activate düğmesine tıklayın.

3. Ayarları açın: WooCommerce > Settings > Shipping > VibeFox Loggi veya Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

4. VibeFox lisans anahtarınızı sayfanın üst kısmındaki lisans bloğuna girin ve Activate düğmesine tıklayın.

5. Loggi API e-postasını, API anahtarını, Shop ID'yi ve teslim alma adresini girin; mağaza para biriminiz BRL değilse BRL döviz kurunu da girin. Güvenlik ağı olarak sabit fiyatlar ekleyin (bkz. Yapılandırma).

6. Brezilya için bir kargo bölgesine VibeFox Loggi ekleyin: WooCommerce > Settings > Shipping > Shipping zones yolunda, ya da Ignore shipping zones seçeneğini açın ve ülkeleri seçin.

Yapılandırma

Tüm ayarlar tek bir sayfada bulunur: WooCommerce > Settings > Shipping > VibeFox Loggi. Ayarlar tüm kargo bölgeleri için geçerlidir. Yöntemi bir bölgeye eklediğinizde bölge penceresinde yalnızca bir alan bulunur:

Title (zone): müşterilerin bu bölge için gördüğü ad. Genel Method title değerini kullanmak için boş bırakın.

Sayfanın üstündeki uyarılar eksik kurulumu gösterir: API kimlik bilgisi yok, teslim alma adresi yok veya BRL döviz kuru yok. Ayarları her kaydettiğinizde önbellekteki Loggi fiyatları temizlenir.

Genel

Enable/Disable: yöntemi tüm bölgelerde aynı anda açar veya kapatır.

Method title: sepette ve ödeme sayfasında gösterilen kargo yöntemi adı. Bir bölge bunu geçersiz kılabilir. Varsayılan: Loggi.

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

API e-mail: Loggi hesabınızın e-posta adresi. API anahtarı bu hesaba aittir.

API key: Loggi API anahtarınız. Yalnızca Loggi'ye gönderilir ve asla günlüğe kaydedilmez.

Shop ID: Loggi panelindeki mağazanızın sayısal ID'si (pk). Yalnızca pozitif bir sayı kabul edilir. Başka bir değer bir hatayla reddedilir ve kayıtlı değer korunur.

Staging: test kimlik bilgileriyle Loggi staging ortamını kullanır. Staging ve üretim farklı hesaplara ve anahtarlara sahiptir. Varsayılan: kapalı.

Pickup address: Loggi'nin paketleri aldığı yer; tek satırda: sokak ve bina numarası, mahalle, şehir, eyalet ve CEP, örneğin Rua Example, 123 - Bairro, São Paulo - SP, 01310-100. Mağaza adresi Brezilya'daysa WooCommerce > Settings > General içindeki mağaza adresini kullanmak için boş bırakın. Teslim alma adresi olmadan Loggi tahmin yapamaz ve yalnızca sabit fiyatlar kullanılır.

BRL exchange rate: Loggi fiyatları Brezilya reali cinsindendir. Mağaza para biriminiz BRL ise bu alan gerekmez. Aksi halde, mağaza para biriminizde 1 BRL'nin değerini girin, örneğin 0.16. Bu olmadan canlı fiyatlar kullanılmaz. Ondalık ayırıcı olarak hem nokta hem virgül kabul edilir.

Sabit fiyatlar (mağaza para biriminizde)

Sabit fiyatlar, Loggi API yapılandırılmadığında, Brezilya dışındaki hedefler için veya tam CEP olmadığında ve Loggi fiyat döndürmediğinde (API çalışmı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, satır silmek için çarpı işaretine tıklayın. Kendi satırı olmayan tüm ülkeler için * All other countries 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. Boş (veya 0) bir ağırlık sütunu temel fiyatı kullanır. Temel fiyat 0 ise ücretsiz kargo anlamına gelir. Hem "9.99" hem de "9,99" kabul edilir. Boş satırlar ve aynı ülke için ikinci satır kaydedilirken silinir.

Price for countries not in the table: canlı Loggi fiyatı yoksa ve tabloda hedef ülke için satır (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 hesaplanacağı. Canlı bir Loggi fiyatı zaten tüm sepeti kapsar ve asla çarpılmaz.

Koşullar

Minimum weight (kg): sepet bundan az ağırlıktaysa yöntemi gizler. 0 sınır olmadığı anlamına gelir.

Maximum weight (kg): sepet bundan fazla ağırlıktaysa yöntemi gizler. Varsayılan: 30. 0 sınır olmadığı anlamına gelir.

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

Free shipping from: Loggi kargosunun ücretsiz olduğu sepet ara toplamı (indirimler sonrası, vergi öncesi). Ücretsiz kargo olmaması için boş bırakın.

Excluded shipping classes: sepette bu WooCommerce kargo sınıflarından herhangi birine ait bir ürün varsa yöntemi gizler.

Tax status: Taxable WooCommerce vergisini kargo maliyetine ekler, None eklemez. Fiyatlarınız ve Loggi fiyatı vergileri zaten içeriyorsa None seçin.

Kargo bölgeleri olmadan kullanılabilirlik

Ignore shipping zones: yöntem hiçbir kargo bölgesine eklenmemiş olsa bile aşağıdaki ülkeler için Loggi sunar.

Countries: bu mod için hedef ülkeler. Gönderim yaptığınız tüm ülkeleri kullanmak için boş bırakın. Bu alan yalnızca Ignore shipping zones açıkken kullanılır.

Gelişmiş

Debug log: her kargo hesaplamasını ve Loggi isteğini WooCommerce > Status > Logs altına (kaynak vfd-loggi) kaydeder. API hataları bu seçenek kapalı olsa bile her zaman kaydedilir. API anahtarı ve müşteri adresleri asla kaydedilmez.

Remove data on uninstall: açıksa eklentiyi silmek tüm Loggi ayarlarını ve bölge yöntemlerini kaldırır. Eklentiyi devre dışı bırakmak ayarları asla silmez.

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

Müşteri bir teslimat adresi girdiğinde WooCommerce eklentiden bir fiyat ister. Eklenti önce koşulları kontrol eder: teslimat ülkesi, sepet ağırlığı, minimum sipariş tutarı ve hariç tutulan kargo sınıfları. Ücretsiz kargo geçerliyse müşteri yöntemi ücretsiz görür ve Loggi'ye istek gönderilmez.

Tam 8 haneli CEP'e sahip bir Brezilya adresi için eklenti Loggi paketlerini 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ırları içinde kaldığı sürece tek bir pakette üst üste yerleştirilir. Ağırlığı veya boyutu olmayan ürünler kenar başına 1 cm sayılır ve her paket en az 100 g ağırlığındadır. Loggi bir tahminde 2 paket kabul eder; bu nedenle daha büyük sepetler birden fazla istekle gönderilir ve toplamlar eklenir. Eklenti Loggi'ye Shop ID'nizi, teslim alma adresini, teslimat adresini ve paketleri gönderir, Loggi toplamını BRL'den mağaza para biriminize çevirir ve gösterir.

Her Loggi fiyatı sepet, adres, hesap ve ortam başına 1 saat önbellekte tutulur; böylece aynı sepet yeni bir istek tetiklemez. Başarısız bir tahmin 10 dakika önbellekte tutulur. Loggi tamamen erişilemezse, ödeme sayfası her güncellemede Loggi'yi beklemesin diye istekler 2 dakika duraklatılır. API zaman aşımı 10 saniyedir.

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

Yöntem klasik ödeme sayfasında ve Sepet ve Ödeme bloklarında çalışır. WooCommerce High-Performance Order Storage (HPOS) ile uyumludur.

Eklenti yalnızca fiyat hesaplar. Loggi siparişleri veya gönderileri oluşturmaz, etiket yazdırmaz, paketleri takip etmez, ödeme sayfasında teslimat süresini göstermez ve teslim alma noktaları veya dolap (locker) sunmaz. 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. Lisans bloğu WooCommerce > Settings > Shipping > VibeFox Loggi sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blokta durum görünür; örneğin lisansın hangi tarihe kadar etkin olduğu ve alan adınız. Durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu siteden kaldırmak için Remove key kullanın. Manage licenses and domains in your account bağlantısı vibefox.net hesabınızı açar.

Bir anahtar bir alan adında çalışır. Anahtarı bir siteden kaldırmak o sitenin alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Loggi, ödeme sayfasında müşterilere gösterilmez. Oturum açmış mağaza yöneticileri hâlâ bunu görür; (unlicensed — visible to admins only) olarak işaretlenir, böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Eklentiler sayfasında ve WooCommerce sayfalarında bir hatırlatma görünür. 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 arka planda otomatik olarak yeniden kontrol edilir.

Sorun giderme

Loggi ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve yöntemin müşterinin ülkesinin bölgesine eklendiğini (ya da Ignore shipping zones açık ve ülke izinliyse) kontrol edin. Ayarlar sayfasının üstündeki uyarıları, ağırlık sınırlarını, Minimum order amount ve Excluded shipping classes değerlerini kontrol edin. Müşteri henüz tam CEP girmediyse veya Loggi fiyat döndürmüyorsa yöntemin sabit fiyata ihtiyacı vardır: ülke için bir satır, bir * satırı veya Price for countries not in the table.

Yalnızca sabit fiyatlar gösteriliyor: WooCommerce > Status > Logs sayfasını açın, kaynak vfd-loggi. Hatalar her zaman kaydedilir. Her adımı görmek için Debug log seçeneğini açın. Olası nedenler: API e-postası, anahtarı veya Shop ID 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 bilgileriyle eşleştiğinden emin olun: staging ve üretim anahtarları farklıdır.

Mağazam euro veya dolar ile satış yapıyor: Loggi BRL cinsinden yanıt verir. BRL exchange rate değerini girin (mağaza para biriminizde 1 BRL'nin değeri). Sabit fiyatlar her zaman mağaza para biriminizdedir.

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 en az 100 g sayılır.

Per item, Loggi fiyatını çarpmıyor: bu beklenen bir davranıştır. Canlı bir Loggi fiyatı tüm sepeti kapsar. Per item yalnızca sabit fiyatlara uygulanır.

Bir değişiklikten sonra fiyatlar eski görünüyor: ayarlar sayfasını kaydedin. Bu, önbellekteki Loggi fiyatlarını temizler.

Lisans bloğu bir hata gösteriyor: bloktaki mesajı izleyin. Örneğin anahtar başka bir alan adında zaten kullanılıyorsa vibefox.net hesabınızda bir yuva serbest bırakın ve Check now düğmesine tıklayın. Site adresi değiştiyse, anahtarı yeni alan adı için etkinleştirmek üzere Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamıyorsa eklenti son bilinen durumla çalışmaya devam eder.

Kaldırma

Eklentiyi devre dışı bırakmak tüm ayarları korur. Yalnızca önbellekteki Loggi fiyatları temizlenir. Kaldırmak için devre dışı bırakın ve Plugins sayfasında silin. Bu eklentinin lisans anahtarı ve lisans durumu ile önbellekteki fiyatlar her zaman kaldırılır. Ayarlar ve bölge yöntemleri yalnızca Remove data on uninstall açıksa kaldırılır. Aksi halde, daha sonraki yeniden kurulum için saklanırlar. Mevcut siparişler kargo satırlarını korur.

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