VibeFox GIG Logistics for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

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

PHP: 8.0 veya üzeri.

GIG Logistics API kimlik bilgileri (yalnızca canlı fiyatlar için): canlı fiyatlar GIG Logistics üçüncü taraf API'sini kullanır. GIG Logistics, kurumsal müşterilerine bir API kullanıcı adı (genellikle bir e-posta adresi) ve şifre verir. Bunları GIG Logistics geliştirici sayfasından (giglogistics.com/developer) talep edin. Test kimlik bilgileri yalnızca test API'sinde çalışır. Yalnızca fiyat tablosu ve yedek ücret kullanıyorsanız API kimlik bilgilerine ihtiyacınız yoktur.

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

Kurulum

1. WordPress'te Plugins > Add New > Upload Plugin bölümüne gidin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. vfd_gig_logistics 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 GIG Logistics ya da Eklentiler 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ündeki lisans bloğuna girin ve Activate düğmesine tıklayın.

5. Fiyat tablosunu ve/veya yedek ücreti doldurun. Canlı fiyatlar için ayrıca API kullanıcı adı ve şifresini, gönderici telefonunu, alım şehri ve eyaletini, mağaza para biriminiz NGN değilse para birimi dönüşüm oranını girin (bkz. Yapılandırma).

6. WooCommerce > Settings > Shipping > Shipping zones bölümünde Nijerya için bir kargo bölgesine VibeFox GIG Logistics ekleyin veya Ignore shipping zones seçeneğini açıp ülkeleri seçin.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Shipping > VibeFox GIG Logistics. 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.

Alanların üstünde, canlı fiyatlar kullanılamadığında sayfa uyarılar gösterir: API kullanıcı adı ve şifresinden yalnızca biri girilmiş, Sender phone veya alım şehri ve eyaleti eksik ya da mağaza para birimi NGN değil ve bir Currency conversion rate ayarlanmamış. Ayarları her kaydettiğinizde önbelleğe alınmış fiyatlar ve API jetonları temizlenir.

General

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

Method title: sepette ve ödeme sayfasında gösterilen kargo yöntemi adı. Varsayılan: GIG Logistics. Bölge başlığı bunun yerine geçer.

Tax status: Taxable mağazanızın kargo vergisini ücrete ekler, None eklemez. GIG fiyatı tahsil etmek istediğiniz her şeyi zaten içeriyorsa None seçin.

GIG Logistics API (canlı fiyatlar) (isteğe bağlı)

API kimlik bilgileriyle, her Nijerya adresi için fiyat GIG Logistics'ten istenir. Kimlik bilgisi yoksa veya API fiyat vermezse fiyat tablosu ve yedek ücret kullanılır.

API username: GIG Logistics üçüncü taraf API kullanıcı adınız, genellikle e-posta adresiniz.

API password: GIG Logistics üçüncü taraf API şifreniz. Yalnızca API'ye giriş yapmak için kullanılır ve asla günlüğe yazılmaz.

Test mode: GIG Logistics test (dev) API'sini kullanır. Test kimlik bilgileri yalnızca test API'sinde çalışır. Gerçek fiyatlar için kapatın. Varsayılan: kapalı.

Currency conversion rate: GIG Logistics fiyatları NGN cinsinden verir. Mağaza para biriminiz NGN değilse, bir NGN'nin mağaza para biriminizde ne kadar ettiğini girin (1 NGN = ? para biriminiz, örneğin 0.0006). Bu olmadan canlı GIG fiyatları kullanılmaz. Mağaza para biriminiz NGN ise bu alana gerek yoktur. Ondalık ayracı olarak hem nokta hem virgül kabul edilir.

Alım (gönderici) adresi

GIG Logistics'in Nijerya'da paketleri aldığı yer. Mağazanız Nijerya'daysa, boş bırakılan cadde, şehir ve eyalet alanları WooCommerce > Settings > General bölümündeki mağaza adresini kullanır.

Sender name: GIG Logistics'e gönderilen gönderici adı. Boşsa site adı kullanılır.

Sender phone: telefon numaranız, örneğin 08030000000. Canlı fiyatlar için GIG Logistics tarafından gereklidir.

Street address: alım cadde adresi.

City / area: alım şehri veya bölgesi, örneğin Victoria Island. Canlı fiyatlar için gereklidir.

State: alım adresinin Nijerya eyaleti. Varsayılan olarak mağaza eyaleti kullanılır. Canlı fiyatlar için gereklidir.

Pickup latitude: haritadaki alım noktasının isteğe bağlı enlemi, örneğin 6.4281. GIG Logistics fiyatı mesafeye göre belirler. Boşsa koordinatlar adresten bulunur.

Pickup longitude: haritadaki alım noktasının isteğe bağlı boylamı, örneğin 3.4219.

Address lookup: adreslerin harita koordinatlarını OpenStreetMap (Nominatim) ile bulur. GIG Logistics fiyatı alım ve teslimat koordinatlarından hesaplar. Müşterinin cadde, şehir ve eyaleti nominatim.openstreetmap.org adresine gönderilir ve sonuçlar 30 gün önbelleğe alınır. Bu seçenek kapalıysa yalnızca adres metni gönderilir ve GIG Logistics fiyat döndürmeyebilir. Varsayılan: açık.

Fiyat tablosu ve yedek ücret

Diğer ülkeler için, canlı fiyatlar yapılandırılmamışsa veya GIG Logistics fiyat vermezse kullanılır. Fiyatlar mağaza para biriminizdedir.

Country prices: ülke başına temel fiyat içeren bir tablo. 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 * Any other country seçin. 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) sütunları isteğe bağlı ağırlık kademesi fiyatlarıdır: 0'dan büyük bir kademe fiyatı, o kademedeki sepetler için temel fiyatın yerine geçer. 0 fiyatı ücretsiz kargo anlamına gelir. Boş fiyat hücreleri 0 olarak kaydedilir, bu yüzden eklediğiniz her satır için temel fiyatı doldurun. Satırı olmayan ülkeler (* satırı yoksa) tablo fiyatı almaz.

Fallback cost: ne GIG Logistics ne de tablo fiyat verdiğinde kullanılır. Boş bırakılırsa, bu durumda yöntem gizlenir.

Table / fallback price is: Per order ücreti bir kez alır. Per item (multiplied by the number of items) ücreti sepetteki ürün sayısıyla çarpar. Canlı GIG fiyatları her zaman tüm sipariş içindir.

Koşullar

Free shipping from: kargonun ücretsiz olduğu sepet ara toplamı. Boş bırakılırsa hiçbir zaman ücretsiz olmaz.

Minimum subtotal: yöntemi yalnızca sepet ara toplamı bu tutara ulaştığında gösterir. Boş bırakılırsa her zaman gösterilir.

Min weight (kg): sepetin kg cinsinden minimum ağırlığı. Ürün ağırlıkları mağazanızın ağırlık biriminden dönüştürülür. 0 sınır olmadığı anlamına gelir.

Max weight (kg): sepetin kg cinsinden maksimum ağırlığı. Varsayılan: 30. 0 sınır olmadığı anlamına gelir.

Excluded shipping classes: sepette bu WooCommerce kargo sınıflarına ait ürünler varsa yöntemi gizler.

Kargo bölgesi olmadan kullanılabilirlik

Ignore shipping zones: yöntem bir bölgeye eklenmemiş olsa bile aşağıdaki ülkeler için sunar. Kapalıyken yöntem yalnızca eklendiği kargo bölgelerinde görünür.

Countries: bu mod için hedef ülkeler. Boşsa, kargo gönderdiğiniz tüm ülkeler kullanılır. Yalnızca Ignore shipping zones ile kullanılır.

Gelişmiş

Debug log: fiyat hesaplamalarını WooCommerce > Status > Logs bölümüne, kaynak vfd-gig-logistics olarak kaydeder. API hataları günlük kapalı olsa bile her zaman kaydedilir. Şifreler, jetonlar veya müşteri adresleri yazılmaz.

Remove data on uninstall: açıksa, eklentiyi silmek ayarlarını, bölge yöntemlerini ve önbellekleri kaldırır. Eklentiyi devre dışı bırakmak hiçbir şeyi 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 ara toplam ve hariç tutulan kargo sınıfları. Ara toplam Free shipping from değerine ulaşırsa yöntem 0 fiyatla gösterilir, ancak yalnızca ülkenin bir fiyatı varsa: Country prices içinde bir satır, bir Fallback cost veya canlı bir GIG Logistics fiyatı. GIG Logistics yalnızca tablo ve yedek ücret fiyat vermediğinde sorgulanır.

Ardından fiyat, fiyat verebilen ilk kaynaktan alınır. Önce, API kimlik bilgileri girilmişse, adres Nijerya'daysa, müşteri bir şehir veya eyalet girmişse, alım telefonu, şehri ve eyaleti ayarlıysa ve NGN dışındaki mağazalar için bir dönüşüm oranı ayarlıysa canlı GIG Logistics fiyatı. Eklenti GIG Logistics API'sine giriş yapar ve alım ile teslimat adreslerini ve koordinatlarını, sepet ürünlerini adları, adetleri, ağırlıkları ve değerleriyle birlikte gönderir. Ağırlığı olmayan ürünler 1 kg olarak gönderilir. Fiyat bike teslimatı için istenir. İkinci olarak Country prices tablosu. Üçüncü olarak Fallback cost. Hiçbir kaynak fiyat vermezse yöntem o sepet için gizlenir.

GIG'in her yanıtı 1 saat önbelleğe alınır, böylece aynı sepet yeni bir istek tetiklemez. Başarısız bir istek veya başarısız bir giriş 10 dakika önbelleğe alınır, böylece ödeme sayfası her yenilemede GIG Logistics'i beklemez. Giriş jetonu 30 dakika tutulur ve GIG reddettiğinde otomatik olarak yenilenir. API zaman aşımı 10 saniye, adres arama zaman aşımı 5 saniyedir.

GIG Logistics bir hata veya sıfır fiyat döndürürse müşteri hiçbir hata görmez. Tablo veya yedek fiyat kullanılır ve hata günlüğe yazılır.

Yöntem klasik ödeme sayfasında ve Sepet ve Ödeme bloklarında çalışır. WooCommerce Yüksek Performanslı Sipariş Depolama (HPOS) ile uyumludur.

Eklenti yalnızca fiyat hesaplar. GIG Logistics gönderileri, sevk belgeleri veya etiketleri oluşturmaz, kurye alımı ayarlamaz, paketleri takip etmez ve müşterilerin bir hizmet merkezi seçmesine izin vermez. Siparişler her zamanki gibi GIG Logistics hesabınız üzerinden gönderilir. Canlı fiyatlar yalnızca Nijerya adresleri için istenir. Diğer ülkeler için fiyat tablosunu kullanın.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Shipping > VibeFox GIG Logistics sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blok durumu gösterir; örneğin lisansın hangi tarihe kadar etkin olduğunu 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 tek 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ızda serbest bırakın.

Etkin bir anahtar olmadan GIG Logistics ödeme sayfasında müşterilere gösterilmez. Oturum açmış mağaza yöneticileri ise yine de (unlicensed — visible to admins only) ibaresiyle görür; böylece bir 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.

Lisans sona erdiğinde eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum arka planda otomatik olarak yeniden kontrol edilir.

Sorun giderme

GIG Logistics ö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 kontrol edin (veya Ignore shipping zones açık ve ülke izinli olmalıdır). Ağırlık sınırlarını, Minimum subtotal ve Excluded shipping classes ayarlarını kontrol edin. Tablonun (ülke veya *) ya da Fallback cost değerinin o ülke için fiyat verdiğini doğrulayın.

Fiyat GIG Logistics'ten değil, tablodan geliyor: canlı fiyatlar için API kullanıcı adı ve şifresi, Sender phone, alım şehri ve eyaleti, şehir veya eyalet içeren bir Nijerya teslimat adresi ve NGN dışındaki mağazalar için Currency conversion rate gerekir. Ayarlar sayfasının üstündeki uyarılara bakın. Debug log seçeneğini açın, ödeme sayfasını yenileyin ve nedeni görmek için WooCommerce > Status > Logs bölümünü, kaynak vfd-gig-logistics olarak açın. Başarısız bir istek 10 dakika sonra yeniden denenir.

Günlükte Login failed: GIG Logistics API kullanıcı adını veya şifresini reddetti. Bunları kontrol edin ve Test mode seçeneğine bakın: test kimlik bilgileri yalnızca test API'sinde çalışır. Hemen yeniden denemek için ayarları kaydedin.

GIG Logistics fiyat döndürmüyor: GIG fiyatları mesafeye göre belirler. Address lookup seçeneğini açık tutun veya Pickup latitude ve Pickup longitude değerlerini girin. Canlıya geçmeden önce fiyatları GIG Logistics hesabınızla doğrulayın.

Vergi GIG fiyatının üzerine ekleniyor: GIG fiyatı tahsil etmek istediğiniz her şeyi zaten içeriyorsa Tax status değerini None yapın.

Bir değişiklikten sonra fiyatlar eski görünüyor: ayarlar sayfasını kaydedin. Bu, önbelleğe alınmış fiyatları ve jetonları temizler.

Kendi geocoder'ı: geliştiriciler vfd_gigl_pre_geocode filtresiyle kendi adres aramasını sağlayabilir.

Lisans bloğu bir hata gösteriyor: bloktaki mesaja uyun. Ö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, yeni alan adı için anahtarı 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 verileri korur. Kaldırmak için eklentiyi devre dışı bırakın ve Plugins sayfasından silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ayarlar, bölge yöntemleri, önbelleğe alınmış fiyatlar, jetonlar ve adres aramaları yalnızca Remove data on uninstall açıksa kaldırılır. Aksi halde sonraki bir yeniden kurulum için saklanır. Mevcut siparişler kargo satırlarını korur.

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