VibeFox The Courier Guy for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

WooCommerce: 7.0 veya üzeri, kurulu ve etkin. Eklenti WooCommerce olmadan etkinleştirilmez.

PHP: 8.0 veya üzeri.

ShipLogic API anahtarı (anlık tarifeler ve locker'lar için): The Courier Guy, ShipLogic platformu üzerinde çalışır. The Courier Guy kurye portalınızda Settings > API Keys altında bir API anahtarı oluşturun (kurumsal hesap). Anahtar olmadan yalnızca fiyat tablosu kullanılır ve locker teslimatı sunulamaz.

Güney Afrika'ya gönderim: anlık tarifeler ve locker'lar yalnızca Güney Afrika adresleri içindir. Mağazanız Güney Afrika'ya gönderim yapmalıdır (WooCommerce > Settings > General > Shipping location(s)).

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 bölümüne gidin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. vfd_the_courier_guy klasörünü FTP ile /wp-content/plugins/ klasörüne de yükleyebilirsiniz.

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

3. Ayarları açın: WooCommerce > Settings > Shipping > VibeFox The Courier Guy yolunu izleyin ya da 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ündeki lisans bloğuna girin ve Activate düğmesine tıklayın.

5. ShipLogic API key değerini girin. Anlık tarifeler için gönderici adresini (cadde, şehir, il, posta kodu) doldurun; mağaza para biriminiz ZAR değilse ZAR conversion rate değerini de girin.

6. Fiyat tablosunu ve/veya yedek ücreti doldurun.

7. WooCommerce > Settings > Shipping > Shipping zones bölümünde, Güney Afrika için bir kargo bölgesine VibeFox The Courier Guy ekleyin, Delivery type seçeneğini (courier veya TCG locker) belirleyin ve isterseniz bir başlık girin. Diğer teslimat türü için yöntemi bir kez daha ekleyin.

Yapılandırma

Ana ayarlar tek bir sayfadadır: WooCommerce > Settings > Shipping > VibeFox The Courier Guy. Bu ayarlar tüm kargo bölgeleri için geçerlidir. Yöntemi bir bölgeye eklediğinizde, bölge penceresinde iki alan bulunur:

Title (zone): bu bölgede, ödeme sayfasında görünecek bu tarifenin adı. Genel Method name değerini kullanmak için boş bırakın.

Delivery type (zone): Courier to the door (varsayılan) veya TCG locker (customer chooses a locker). İkisini de sunmak için yöntemi iki kez ekleyin. Locker'lar ShipLogic API anahtarı gerektirir ve yalnızca Güney Afrika'da kullanılabilir.

Ayarları her kaydettiğinizde önbellekteki tarifeler ve locker'lar temizlenir. Ayarların üstündeki uyarılar; mağazanın Güney Afrika'ya gönderim yapmadığını, API anahtarının eksik olduğunu, ZAR dönüşüm kurunun veya gönderici adresinin eksik olduğunu, fiyat tablosu ile yedek ücretin ikisinin de bulunmadığını ya da ShipLogic'e yapılan son isteğin hata verdiğini (tarih ve hata mesajıyla birlikte) bildirir.

Genel

Enable/Disable: yöntemi kargo bölgeleri dahil her yerde kapatır.

Method name: ödeme sayfasında gösterilen ad. Locker teslimatı için ada "locker" eklenir, örneğin "The Courier Guy locker". Bir bölge bunu kendi başlığıyla değiştirebilir. Varsayılan: The Courier Guy.

Tax status: Taxable: anlık tarifeler KDV hariç alınır ve WooCommerce kendi vergisini ekler. None: anlık tarifeler KDV dahil alınır.

ShipLogic API (anlık tarifeler ve locker'lar)

API key: The Courier Guy portalındaki ShipLogic API anahtarınız.

Account ID: isteğe bağlı. Yalnızca anahtarınız birden fazla hesaba erişebiliyorsa kullanılacak sayısal ShipLogic hesap kimliği.

Anlık tarifeler (Güney Afrika adresleri için; anlık tarife yoksa fiyat tablosu kullanılır)

Price source: fiyatın nereden geldiği.

ZAR conversion rate: ShipLogic, Güney Afrika randı (ZAR) cinsinden fiyat verir. Mağaza para biriminiz ZAR değilse, 1 ZAR'ın mağaza para biriminizde kaç değer olduğunu girin, örneğin 0.05. Bu değer olmadan anlık tarifeler kullanılmaz ve fiyat tablosu uygulanır. Mağaza para biriminiz ZAR ise boş bırakın. Kur otomatik olarak güncellenmez.

Gönderici adresi (anlık tarifeler için) (The Courier Guy'ın Güney Afrika'da paketleri aldığı adres; anlık tarifeler için cadde, şehir, il ve posta kodu gerekir)

Sender company: şirketinizin adı.

Sender street address: örneğin 12 My Road.

Sender suburb: gönderici adresinin semti.

Sender city: gönderici adresinin şehri.

Sender province: listeden Güney Afrika ilini seçin.

Sender postal code: gönderici adresinin posta kodu.

Fiyat tablosu (mağaza para biriminde kendi fiyatlarınız: Price table only ile, Güney Afrika dışında ve anlık tarife olmadığında kullanılır; ondalık virgül veya nokta kabul edilir)

Calculation type: yalnızca fiyat tablosu için geçerlidir. Anlık tarife her zaman tüm sipariş içindir.

Prices by weight: bir Price sütunu ve 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) ağırlık aralıklarına sahip ülke tablosu. Satır eklemek için + Add row düğmesine tıklayın (yeni satır Güney Afrika ile başlar), kaldırmak için çarpıya tıklayın. Boş veya 0 olan bir aralık Price sütununu kullanır. 0 fiyat ücretsiz kargo anlamına gelir. * Any country satırı, kendi satırı olmayan ülkeler ile hiçbir fiyatı olmayan ülke satırı için geçerlidir.

Fallback cost: ne anlık tarife ne de tablo fiyatı olduğunda kullanılır. Bu durumda yöntemi gizlemek için boş bırakın.

Koşullar

Min weight (kg): sepet ağırlığı bunun altındayken yöntemi gizler. 0 sınır olmadığı anlamına gelir.

Max weight (kg): sepet ağırlığı bunun üstündeyken yöntemi gizler. Varsayılan: 30. 0 sınır olmadığı anlamına gelir.

Minimum order amount: yöntemi yalnızca bu sepet ara toplamından itibaren gösterir. Her zaman göstermek için boş bırakın.

Free shipping from: bu yöntemin ücretsiz olduğu sepet ara toplamı. Ücretsiz kargo yalnızca yöntemin hedef için bir fiyatı olduğunda sunulur: anlık tarife, tablo fiyatı veya Fallback cost. Tabloda veya Fallback cost alanında bir fiyat varsa, tarife için ShipLogic'e istek gönderilmez. Hiçbir zaman ücretsiz kargo sunulmaması için boş bırakın.

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

Kargo bölgeleri olmadan kullanılabilirlik

Ignore shipping zones: yöntemi, hiçbir bölgede yer almasa bile aşağıdaki ülkeler için sunar.

Delivery type without zones: bu mod için courier veya TCG locker. Yalnızca Ignore shipping zones ile kullanılır.

Countries: bu mod için hedef ülkeler. Gönderim yaptığınız tüm ülkeleri kullanmak için boş bırakın. Locker'lar yalnızca Güney Afrika'da sunulur.

Gelişmiş

Debug log: hata ayıklama mesajlarını WooCommerce > Status > Logs altına, kaynak vfd-the-courier-guy olarak yazar. API hataları bu seçenek kapalı olsa bile her zaman kaydedilir. API anahtarı ve müşteri verileri hiçbir zaman kaydedilmez.

Remove data on uninstall: açıksa eklentiyi silmek bu yöntemin ayarlarını ve bölge tarifelerini kaldırır. Eklentiyi devre dışı bırakmak ayarları hiçbir zaman silmez. Siparişlerde kaydedilmiş locker'lar ve takip bilgileri korunur.

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

Müşteri bir teslimat adresi girdiğinde WooCommerce eklentiden bir tarife ister. Eklenti önce koşulları kontrol eder: sepet ağırlığı, minimum sipariş tutarı ve hariç tutulan kargo sınıfları. Ücretsiz kargo geçerliyse ve hedefin bir fiyatı varsa, yöntem 0 fiyatla gösterilir.

Courier to the door: eklenti, gönderici adresinizden müşterinin adresine kadar en ucuz hizmeti ShipLogic'ten ister. Müşterinin cadde, şehir, il ve posta kodu önce doldurulmuş olmalıdır. O zamana kadar fiyat tablosundaki fiyat gösterilir.

TCG locker: anlık tarife, kapıdan locker'a en ucuz hizmettir ve müşterinin şehrine en yakın locker'a kadar hesaplanır. Müşterinin seçtiği locker için yeniden hesaplanmaz.

Sipariş tek bir paket olarak fiyatlandırılır: toplam ağırlık, en uzun uzunluk ve genişlik ile üst üste konan yükseklikler. Boyutu olmayan ürünler 10 cm'lik küp sayılır. Rand tutarı mağaza para biriminize çevrilir. Hizmet seviyesi, örneğin ECO, kargo satırında saklanır.

ShipLogic istekleri 12 saniye sonra zaman aşımına uğrar. Tarifeler 1 saat, locker'lar 6 saat ve hatalar 10 dakika önbelleğe alınır; böylece yavaş bir API her ödeme sayfası yenilemesini yavaşlatmaz. Anlık tarife yoksa fiyat tablodan, ardından Fallback cost değerinden alınır. Hiçbiri geçerli değilse yöntem gizlenir.

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

Eklenti gönderi, taşıma belgesi veya etiket oluşturmaz ve takip bilgisini otomatik olarak güncellemez. Bir locker haritası yoktur: locker'lar bir listeden seçilir. Anlık tarifeler ve locker'lar yalnızca Güney Afrika içindir. Diğer ülkeler fiyat tablosunu kullanır. Her bölge örneği için yalnızca bir tarife gösterilir (en ucuz hizmet seviyesi); ödeme sayfasında hizmet seviyesi, sigorta veya ek hizmet seçimi yoktur.

Teslim noktaları

Müşteri klasik veya blok ödeme sayfasında bir TCG locker tarifesi seçtiğinde, bunun altında bir locker seçici görünür. Seçici, teslimat adresinin şehri için ShipLogic'in döndürdüğü locker'ları en yakından başlayarak listeler. Müşteri başka bir şehir, semt veya posta kodu yazabilir ve Search düğmesine tıklayabilir. Siparişin verilebilmesi için bir locker seçilmelidir.

Locker, ShipLogic'in listesine karşı sunucuda yeniden doğrulanır. Adı ve sağlayıcısı tarayıcıdan değil, ShipLogic'ten alınır. Seçim, ödeme sayfası yenilemelerinde korunur ve adres değiştiğinde sıfırlanır.

ShipLogic'e ulaşılamazsa seçici locker'ların yüklenemediğini bildirir ve sipariş locker olmadan verilebilir. Bu durumda sipariş işaretlenir: "Not chosen — ShipLogic was unavailable at checkout. Agree the locker with the customer." (Seçilmedi: Ödeme sırasında ShipLogic kullanılamıyordu. Locker'ı müşteriyle birlikte kararlaştırın.)

Siparişler

Seçilen locker (ad, kimlik ve sağlayıcı) siparişe kaydedilir. Yönetici sipariş ekranında, "Teşekkürler" ve "Hesabım" sipariş sayfalarında ve sipariş e-postalarında (HTML ve düz metin) gösterilir. Yönetici e-postası ayrıca locker kimliğini gösterir.

Yönetici sipariş ekranında bu yönteme ait siparişlerde The Courier Guy tracking reference alanı bulunur. The Courier Guy portalınızdaki referansı girin ve Save düğmesine tıklayın. Referans, müşteriye sipariş sayfasında ve bundan sonra gönderilen e-postalarda gösterilir.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Shipping > VibeFox The Courier Guy 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 düğmesini 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ı hakkını serbest bırakmaz. Yeri vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar yoksa The Courier Guy ödeme sayfasında müşterilere gösterilmez. Oturum açmış mağaza yöneticileri yine de yöntemi (unlicensed — visible to admins only) etiketiyle 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.

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

The Courier Guy ö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 (ya da Ignore shipping zones açık ve ülke izinliyse). Ağırlık sınırlarını, Minimum order amount değerini ve Excluded shipping classes ayarını kontrol edin. Tablonun veya Fallback cost alanının bir fiyatı olduğunu doğrulayın. Locker tarifeleri yalnızca Güney Afrika adreslerinde görünür.

Müşteriler locker listesini görmüyor: locker'lar için API anahtarı, Delivery type değeri "TCG locker" olan bir bölge yöntemi ve Güney Afrika teslimat adresi gerekir. Ayarlar sayfası, varsa ShipLogic'in son hatasını gösterir; örneğin reddedilen bir anahtar gibi.

Fiyat her zaman tablo fiyatı: ayarlar sayfasındaki uyarıları kontrol edin. Anlık tarife için API anahtarı, eksiksiz gönderici adresi ve ZAR dışı para birimi kullanan mağazalarda ZAR dönüşüm kuru gerekir. Kapıya kurye teslimatı için müşterinin cadde, şehir, il ve posta kodu doldurulmuş olmalıdır. Locker'lar için ShipLogic, müşterinin şehrine yakın bir locker bulmalıdır. Debug log seçeneğini açın ve WooCommerce > Status > Logs sayfasını, kaynak vfd-the-courier-guy olacak şekilde açın.

ShipLogic kullanılamıyor: tablo veya yedek fiyat gösterilir. Locker'lı siparişler locker olmadan verilebilir ve siparişte işaretlenir.

Bir değişiklikten sonra tarifeler eski görünüyor: ayarlar sayfasını kaydedin. Bu, önbellekteki tarifeleri ve locker'ları 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 yeri 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 ayarları korur ve yalnızca önbellekteki tarifeleri ve locker'ları temizler. Kaldırmak için eklentiyi devre dışı bırakın ve Plugins sayfasından silin. Bu eklentinin lisans anahtarı ve lisans durumu, önbellekteki tarifeler ve locker'lar ile son hata her zaman kaldırılır. Ayarlar ve bölge tarifeleri yalnızca Remove data on uninstall açıksa silinir. Aksi halde sonraki bir yeniden kurulum için saklanır. Siparişlerde kaydedilmiş locker'lar ve takip referansları hiçbir zaman silinmez; mevcut siparişler kendi kargo satırlarını korur.

The Courier Guy ve ShipLogic, ilgili sahiplerinin ticari markalarıdır. Bu eklenti The Courier Guy veya ShipLogic ile bağlantılı değildir ve bunlar tarafından onaylanmamıştır.