VibeFox Cargoson for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

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

PHP: 8.0 veya üzeri.

Cargoson hesabı (yalnızca canlı fiyatlar için): canlı fiyatlar Cargoson navlun fiyat API'sini kullanır. Navlun fiyat sorguları, API erişimi olan bir Cargoson aboneliği gerektirir (yazım tarihinde Advanced planı veya üstü). API anahtarı Cargoson hesabınızda verilir; planınızda API ayarları görünmüyorsa Cargoson desteğine başvurun. Fiyatlar, bu hesaba bağlı taşıyıcılardan ve fiyat listelerinden gelir. Yalnızca sabit fiyatları kullanıyorsanız Cargoson hesabına 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. Ayrıca vfd_cargoson klasörünü FTP ile /wp-content/plugins/ dizinine yükleyebilirsiniz.

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

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

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

5. Kargo ücretinin nasıl hesaplanacağını seçin ve ilgili bölümleri doldurun: sabit fiyatlar ve canlı fiyatlar için API anahtarı ile toplama posta kodu (bkz. Yapılandırma).

6. WooCommerce > Settings > Shipping > Shipping zones bölümünde bir kargo bölgesine VibeFox Cargoson 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 Cargoson. Bunlar 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): bu bölge için müşteriye gösterilen ad. Genel Method title değerini kullanmak için boş bırakın.

Ayarları her kaydettiğinizde önbelleğe alınmış Cargoson fiyatları temizlenir. Ondalıklı sayılar nokta ya da virgülle girilebilir.

General

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ı. Varsayılan: Cargoson. Bir bölge bunu geçersiz kılabilir.

Shipping cost: fiyatın nasıl hesaplanacağı.

Canlı fiyatın eksik olmasının nedeni WooCommerce günlüğüne yazılır. Müşteriye hiçbir zaman gösterilmez.

Cargoson API (yalnızca canlı fiyatlar için gerekli)

API key: Cargoson hesabınızdaki API anahtarı. Yalnızca cargoson.com adresine gönderilir; müşterilere hiçbir zaman gösterilmez ve günlüğe yazılmaz.

Carrier: hangi fiyatların kullanılacağı. Müşteri tek bir ücret görür.

Package type code: fiyat sorgusuyla birlikte gönderilen Cargoson paket türü. Varsayılan: CLL. Cargoson API örneklerinde EUR (EUR paleti) ve FIN (FIN paleti) kullanılır. Koliler için Cargoson hesabınızın paket kodunu kullanın. Sipariş, sepetin toplam ağırlığıyla tek bir paket olarak gönderilir.

Price currency: Cargoson hesabınızdaki fiyatların para birimi, 3 harfli kod olarak. Varsayılan: EUR. API, para birimi kodu olmadan tutar döndürür.

Currency conversion rate: yalnızca fiyat para birimi mağaza para biriminizden farklıysa gerekir: 1 Cargoson para birimi birimi = X mağaza para birimi birimi. Bu tür fiyatları reddetmek için boş bırakın; böylece müşteri hiçbir zaman yanlış para biriminde ödeme yapmaz.

Ship from (collection address) (canlı fiyatlar için kullanılır)

Collection country: gönderim yaptığınız ülke. Varsayılan olarak mağazanızın ülkesi.

Collection postcode: gönderim yaptığınız posta kodu. Cargoson bunu zorunlu tutar. Boşsa ve toplama ülkesi mağaza ülkeniz ise, WooCommerce > Settings > General bölümündeki mağaza posta kodu kullanılır.

Cargoson'a gönderilen toplama tarihi bugündür; hafta sonlarında ise bir sonraki Pazartesi.

Fixed prices (Shipping cost Fixed prices olduğunda ve canlı fiyatlar için yedek olarak kullanılır)

Price per country and size: ülkelerin bulunduğu ve Price sütunu olan bir tablo; mağaza para biriminde sepet ağırlığına göre fiyatlar: XS 1 kg'a kadar, S 2 kg'a kadar, M 3 kg'a kadar, L 5 kg'a kadar, XL 5 kg üzeri. Boş veya 0 olan boyut fiyatı Price sütununu kullanır; boş bir Price sütunu, o boyut için sabit ücret olmadığı anlamına gelir. Satır eklemek için Add country, satır silmek için çarpı işaretine tıklayın. * Default satırı, kendi satırı olmayan tüm ülkelere uygulanır. Satırı olmayan ülkelere (* satırı yoksa) sabit ücret uygulanmaz; bu nedenle yöntem onlar için gizlenir.

Fixed price applies: Per order ücreti bir kez alır. Per item (price × quantity) ücreti sepetteki ürün adediyle çarpar. Cargoson canlı fiyatları her zaman gönderi başınadır.

Conditions

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

Maximum weight (kg): bu sepet ağırlığının üstünde yöntemi gizler. Varsayılan: 25. 0 sınır olmadığı anlamına gelir.

Minimum order amount: yöntemi yalnızca sepet ara toplamı (indirimlerden sonra, vergiden önce) bu tutarın en az üstündeyse gösterir. Her zaman göstermek 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.

Free shipping: aşağıdaki sipariş tutarına ulaşıldığında ücretsiz teslimatı açar.

Free shipping from: teslimatın ücretsiz olduğu sepet ara toplamı (indirimlerden sonra, vergiden önce). Yalnızca Free shipping açıkken kullanılır.

Tax status: Taxable, WooCommerce vergi ayarlarınıza göre kargo vergisi ekler; None eklemez. Cargoson'daki taşıyıcı fiyatları genellikle KDV hariçtir. Fiyatlarınız zaten vergi içeriyorsa None seçin.

Availability without shipping zones

Ignore shipping zones: Cargoson'u bir kargo bölgesine eklenmemiş olsa bile aşağıdaki ülkeler için sunar.

Countries: bu mod için hedef ülkeler. Teslimat 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.

Advanced

Debug log: her fiyat hesaplamasını WooCommerce > Status > Logs altında, vfd_cargoson kaynağıyla kaydeder. API hataları bu seçenek kapalı olsa bile her zaman kaydedilir. API anahtarı ve müşteri posta kodu hiçbir zaman kaydedilmez.

Remove data on uninstall: açıksa eklentiyi silmek tüm Cargoson ayarlarını, bölge yöntemlerini ve önbelleğe alınmış fiyatları 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 sipariş tutarı ve hariç tutulan kargo sınıfları. Ücretsiz kargo geçerliyse müşteri ücretsiz fiyat alır ve Cargoson'a istek gönderilmez.

Sabit fiyat modunda fiyat tablodan alınır. Canlı modlarda eklenti Cargoson'a toplama tarihini, toplama ülkesini ve posta kodunu, teslimat ülkesini ve posta kodunu ile paket türü kodu ve sepetin toplam ağırlığını içeren bir paket gönderir (en az 0,1 kg). Ürün ağırlıkları mağazanızın birimlerinden kilograma çevrilir. Canlı fiyat, müşteri bir posta kodu girdikten sonra istenir. Cargoson taşıyıcılarınızın fiyatlarını döndürür; eklenti en ucuzunu seçer (seçili taşıyıcının ise onu) ve gerekirse mağaza para birimine çevirir.

Her yanıt 1 saat önbelleğe alınır; böylece aynı sepet yeni bir istek tetiklemez. Başarısız bir istek 10 dakika önbelleğe alınır; böylece ödeme sayfası her yenilemede Cargoson'u beklemez. API zaman aşımı 10 saniyedir. Cargoson bir hata, rota için fiyat veya dönüşüm kuru olmadan başka bir para biriminde fiyat döndürürse müşteri hiçbir hata görmez. Yöntem gizlenir veya yedek modda sabit fiyat kullanılır.

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

Eklenti yalnızca fiyat hesaplar. Cargoson'da gönderi veya rezervasyon oluşturmaz, etiket yazdırmaz ve paketleri takip etmez; müşteriler paket noktası veya teslim alma noktası seçemez. Sepet, toplam ağırlıklı tek bir paket olarak fiyatlandırılır; paket boyutları gönderilmez. Yalnızca en ucuz fiyat gösterilir, taşıyıcı listesi değil.

Siparişler

Canlı fiyat kullanıldığında, siparişin kargo satırı teklif edilen Carrier, Service ve Cargoson service ID bilgilerini kaydeder. Bunlar sipariş düzenleme ekranında gösterilir; böylece Cargoson'da neyi rezerve etmeniz gerektiğini bilirsiniz. Gönderiyi Cargoson'da veya kendi entegrasyonlarıyla rezerve edin.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu, WooCommerce > Settings > Shipping > VibeFox Cargoson sayfasının üst kısmındadır. 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 aktif 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ı hakkını serbest bırakmaz. Hakkı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Cargoson ödeme sayfasında müşterilere gösterilmez. Oturum açmış mağaza yöneticileri ise yine de onu (unlicensed — visible to admins only) işaretiyle görür; böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Plugins 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

Cargoson ö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 olmalı ve ülke izinli olmalıdır). Ağırlık sınırlarını, Minimum order amount ve Excluded shipping classes ayarlarını kontrol edin. Sabit fiyat modunda, ülkenin veya * Default satırının sepet boyutu için bir fiyatı olduğunu doğrulayın.

Canlı fiyatlar görünmüyor: WooCommerce > Status > Logs bölümünü açın, kaynak vfd_cargoson. API hataları her zaman kaydedilir; her hesaplamayı görmek için Debug log seçeneğini açın. Yaygın nedenler: henüz teslimat posta kodu girilmemiş, toplama posta kodu yok, API anahtarı reddedilmiş (yanlış ya da süresi dolmuş anahtar veya Cargoson planınızda API erişimi yok), rota veya ağırlık için taşıyıcı yok ya da başka bir para biriminde fiyat. Cargoson live prices, fixed prices if the API fails seçeneğiyle, siz sorunu çözerken müşteriler yine sabit fiyatı alır.

Cargoson paket türünü reddediyor: Cargoson hesabınızın Package type code alanında kullandığı paket kodunu kullanın. Neden günlükte görünür.

Başka bir para birimindeki fiyat reddediliyor: Price currency alanını Cargoson fiyatlarınızın para birimine ayarlayın ve Currency conversion rate değerini girin.

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

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 hak 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şılamazsa 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 ve önbelleğe alınmış fiyatlar yalnızca Remove data on uninstall açıksa kaldırılır. Aksi halde daha sonra yeniden kurulum için saklanır. Mevcut siparişler kargo satırlarını korur.

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