VibeFox Cargoson for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 üzerinde test edildi) veya 4.0.2 ve sonrası (4.1.0.3 üzerinde test edildi).

PHP: 8.0 veya üzeri.

Cargoson hesabı (yalnızca anlık fiyatlar için): anlık fiyatlar Cargoson navlun fiyat API'sini kullanır. Navlun fiyat sorguları, API erişimi olan bir Cargoson aboneliği gerektirir (bu metin yazılırken Advanced planı veya üzeri). API anahtarı Cargoson hesabınızda verilir; planınız API ayarlarını göstermiyorsa Cargoson desteğinden yardım isteyin. Fiyatlar bu hesaba bağlı taşıyıcılardan ve fiyat listelerinden gelir. Yalnızca sabit fiyat 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

İndirme paketi, 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_cargoson-oc3-(sürüm).ocmod.zip ve OpenCart 4 paketi vfd_cargoson.ocmod.zip bulunur. Yalnızca kullandığınız OpenCart sürümünün paketini 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_cargoson-oc3-(sürüm).ocmod.zip dosyasını seçin. Uzantı OCMOD değişikliği eklemez, bu nedenle Extensions > Modifications sayfası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 uzantı türü olarak Shipping seçin. VibeFox Cargoson uzantısını bulun ve Install düğmesine tıklayın (yeşil + düğmesi).

3. Ayarlar sayfasını açmak için Edit düğmesine (kalem simgeli düğme) tıklayın.

4. VibeFox lisans anahtarınızı, Edit sayfasının üstündeki lisans bloğunda bulunan License key alanına girin ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

5. Kargo ücretinin nasıl hesaplanacağını seçin ve ilgili bölümleri doldurun: sabit fiyatlar ve anlık fiyatlar için API anahtarı ile toplama posta kodu (bkz. Yapılandırma). Enable Cargoson 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_cargoson.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4 uzantı kodunu dosya adından alır ve yeniden adlandırılmış bir paket çalışmaz.

2. Paket, aynı sayfadaki kurulu uzantılar listesinde görünür. Yanındaki Install düğmesine (yeşil + düğmesi) tıklayın.

3. Extensions > Extensions sayfasına gidin ve uzantı türü olarak Shipping seçin. VibeFox Cargoson uzantısını bulun, Install düğmesine (yeşil + düğmesi) ve ardından Edit düğmesine (kalem simgeli düğme) tıklayın.

4. Lisans anahtarını ve ayarları OpenCart 3 için 4. ve 5. adımlarda olduğu gibi girin. Ayarlar sayfası ve alanları iki sürümde de aynıdır.

Enable Cargoson seçeneğini açıp kaydedene kadar kurulumdan sonra yöntem kapalı kalır. Uzantıyı kaldırdıktan sonra yeniden kurarsanız, sakladığınız Cargoson ayarları tekrar kullanılır.

Yapılandırma

Tüm ayarlar uzantı sayfasındadır: Extensions > Extensions > Shipping > VibeFox Cargoson > Edit. Bölümler solda listelenir. Sayfanın altındaki tek bir Save düğmesi tüm sayfayı yeniden yüklemeden kaydeder. Kaydettikten sonra Settings saved. Cached Cargoson prices were cleared. mesajını görürsünüz. Ondalık sayılar nokta ya da virgülle girilebilir. Method title boşsa ya da 64 karakterden uzunsa, bir sayısal alan metin ya da negatif sayı içeriyorsa, Currency conversion rate 0 ise, Minimum weight (kg) Maximum weight (kg) değerinden büyükse, Price currency 3 harfli bir kod değilse, fiyat tablosunun bir satırında geçersiz bir ülke veya fiyat varsa ya da Sort order tam sayı değilse hiçbir şey kaydedilmez ve sayfa hataları listeler. Mağazanın ağırlık birimi uzantı tarafından tanınmıyorsa, kaydettikten sonra ürün ağırlıklarının kilogram olarak alındığını belirten bir uyarı görünür; System > Localisation > Weight Classes altında birimi kg olan bir ağırlık sınıfı ekleyin. Ayarları yalnızca bu uzantı için değiştirme yetkisine sahip yönetici kullanıcılar kaydedebilir.

Genel

Müşteri tek bir Cargoson fiyatı görür. Availability altında yöntemi bir geo bölgesi ya da ülkelerle sınırlayabilirsiniz.

Enable Cargoson: Cargoson'u ödeme sayfasında gösterir ya da gizler. Varsayılan: kapalı.

Method title: sepette ve ödeme sayfasında müşteriye gösterilen kargo yöntemi adı, en fazla 64 karakter. Varsayılan: Cargoson. Zorunlu.

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

Anlık fiyatın eksik olmasının nedeni hata ayıklama günlüğüne yazılır. Müşteriye hiçbir zaman gösterilmez.

Sort order: ödeme sayfasında Cargoson'un kargo yöntemleri arasındaki sırası. Tam sayı.

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

API key: Cargoson hesabınızdaki API anahtarı. Yalnızca Cargoson'a gönderilir; müşterilere hiçbir zaman gösterilmez ve günlüğe yazılmaz. Kaydettikten sonra alan boş kalır ve Saved — leave empty to keep it. ifadesini gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin.

Remove the saved API key: kayıtlı anahtarı silmek için açın ve kaydedin.

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

Package type code: fiyat sorgusuyla gönderilen Cargoson paket türü. Varsayılan: CLL. Cargoson API örnekleri EUR (EUR paleti) ve FIN (FIN paleti) kullanır. Paketler 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ğazanızın varsayılan para biriminden farklıysa gerekir: Cargoson para biriminin 1 birimi = varsayılan para biriminin X birimi. Bu tür fiyatları reddetmek için boş bırakın; böylece müşteri asla yanlış para biriminde ücretlendirilmez.

Gönderim adresi (toplama adresi) (anlık fiyatlar için)

Collection country: gönderim yaptığınız ülke. İlk seçenek olan Store country, mağazanızın ülkesini kullanır.

Collection postcode: gönderim yaptığınız posta kodu. Cargoson anlık fiyatlar için bunu zorunlu tutar. OpenCart'taki mağaza adresi serbest metin olduğundan posta kodu oradan asla alınmaz: bunu burada girin.

Cargoson'a gönderilen toplama tarihi, mağaza saat diliminde bugündür; hafta sonları ise bir sonraki Pazartesi'dir.

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

Price per country and size: Country, Price ve mağazanın varsayılan para biriminde, vergi hariç, sepet ağırlığına göre fiyatlardan oluşan satırların listesi: XS 1 kg'a kadar, S 2 kg'a kadar, M 3 kg'a kadar, L 5 kg'a kadar, XL 5 kg'ın üzerinde. Boş ya da 0 olan bir boyut fiyatı Price sütununu kullanır; boş bir Price o boyut için sabit fiyat olmadığı anlamına gelir. Satır eklemek için Add country düğmesine tıklayın. Kendi satırı olmayan tüm ülkelerde geçerli fiyatlar için * All other countries seçin. Satırı olmayan ülkelerin (* satırı yoksa) sabit fiyatı yoktur, bu nedenle yöntem onlar için gizlenir. Fiyatlar 0 veya daha büyük sayılar olmalıdır. Boş satır yok sayılır.

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

Koşullar

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

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

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: aşağıdaki tutardan itibaren Cargoson ücretsiz kargoyu açar.

Free shipping from: kargo gerektiren ürünlerin ara toplamı (kupon sonrası, vergi öncesi), bu tutardan itibaren teslimat ücretsiz olur. Yalnızca Free shipping açıkken kullanılır.

Tax class: kargo ücretinin vergi sınıfı ya da No tax (varsayılan). Cargoson'daki taşıyıcı fiyatları genellikle nettir (KDV hariç). Fiyatlarınız zaten vergi içeriyorsa No tax seçin.

Kullanılabilirlik

Geo zone: Cargoson'u yalnızca bu geo bölgesindeki adreslere sunar. All zones (varsayılan) sınır olmadığı anlamına gelir. Geo bölgeleri System > Localisation > Geo Zones altında yönetilir.

Ignore shipping zones: geo bölgesini kontrol etmez; aşağıdaki ülke listesi belirleyici olur.

Countries: bu mod için hedef ülkeler. 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: her fiyat hesaplamasını storage/logs/vfd_cgs_debug.log.php dosyasına kaydeder. Dosya web üzerinden okunamaz. API hataları ve reddedilen fiyatlar bu seçenek kapalı olsa bile her zaman kaydedilir. API anahtarı ve müşteri posta kodu hiçbir zaman kaydedilmez. Dosya 5 MB'a ulaştığında vfd_cgs_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 son kayıtlarını gösterir. Temizlemek için Clear log düğmesine tıklayın.

Remove data on uninstall: açıksa uzantıyı kaldırdığınızda Cargoson ayarları, önbelleğe alınmış fiyatlar ve günlük silinir. Kapalıysa (varsayılan) yeniden kurulum için korunur. Yapılmış siparişlerin Cargoson teklifleri her zaman korunur.

İç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ıtta olduğu gibi kontrol edilir. Kayıtlı API anahtarı korunur.

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

OpenCart kargo yöntemlerini gösterdiğinde, uzantıdan Cargoson fiyatını ister. Bir Geo zone ayarlıysa, Ignore shipping zones kapalıysa ve adres bu bölgenin dışındaysa Cargoson sunulmaz. Yalnızca Requires Shipping değeri Yes olarak ayarlanmış ürünler sayılır: diğer ürünler ağırlık eklemez ve sipariş tutarına dahil edilmez. Ürün ağırlıkları, ağırlık sınıflarından kilograma dönüştürülür. Ardından uzantı koşulları kontrol eder: izin verilen ülkeler, sepet ağırlığı ve en düşük sipariş tutarı. Sipariş tutarı, kupon indiriminden sonra ve vergiden önce, kargo gerektiren ürünlerin fiyatıdır. Hediye kartları, ödül puanları ve mağaza kredisi dikkate alınmaz. Ücretsiz kargo uygulanırsa fiyat 0 olur ve Cargoson'a istek gönderilmez.

Sabit modda fiyat tablodan alınır. Anlık modlarda uzantı Cargoson'a toplama tarihini, toplama ülkesini ve posta kodunu, teslimat ülkesini ve posta kodunu, ayrıca paket türü kodu ve toplam sepet ağırlığı (en az 0,1 kg) içeren bir paket gönderir. Anlık fiyat yalnızca teslimat adresinde posta kodu varsa istenir. Cargoson taşıyıcılarınızın fiyatlarını döndürür; uzantı en ucuzunu seçer (seçili taşıyıcının, varsa) ve gerekirse varsayılan para biriminize çevirir. Fiyat varsayılan para biriminde hesaplanır, ondalık basamaklarına yuvarlanır ve müşteriye kendi para biriminde, seçilen Tax class vergisiyle gösterilir.

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 yenilendiğinde Cargoson'u beklemek zorunda kalmaz. API zaman aşımı 10 saniyedir. Cargoson bir hata, rota için fiyat ya da 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 ya da yedek modda sabit fiyat kullanılır.

Uzantı yalnızca fiyat hesaplar. Cargoson'da gönderi ya da rezervasyon oluşturmaz, etiket basmaz ve paketleri izlemez; müşteriler paket makinesi ya da teslim noktası seçemez. Sepet, toplam ağırlıkla tek bir paket olarak fiyatlandırılır; paket boyutları gönderilmez. Taşıyıcılardan oluşan bir liste değil, yalnızca en düşük fiyat gösterilir.

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

Siparişler

Müşteri Cargoson ile sipariş verdiğinde, ödeme sayfasında hesaplanan fiyat siparişle birlikte kaydedilir. Sales > Orders altında sipariş sayfası bir Cargoson shipping paneli gösterir:

Carrier, Service ve Cargoson service ID: anlık fiyat kullanıldığında gösterilen, teklif edilen Cargoson taşıyıcısı ve hizmeti.

Price source: Cargoson live price, Fixed price veya Free shipping threshold.

Calculated price (excl. tax): mağazanızın varsayılan para birimindeki fiyat.

Panel, yöntem kapalıyken de gösterilir. OpenCart 4'te sipariş, onay adımında bir kez oluşturulur ve müşteri bu adıma her döndüğünde güncellenir; bu nedenle kayıtlı teklif, ödeme sayfasında en son hesaplanan tekliftir. Müşteri başka bir kargo yöntemine geçerse, siparişin Cargoson teklifi kaldırılır. Yönetici panelinde siparişi değiştirmek teklifi değiştirmez; teklif sonradan da değişmez. Gönderiyi Cargoson'da ya da kendi entegrasyonlarıyla rezerve edin.

Lisans anahtarı

Uzantı, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Cargoson lisans bloğu, Extensions > Extensions > Shipping > VibeFox Cargoson > Edit sayfasında ayarların üstündeki ilk bloktur. Anahtarı License key alanına girin ve Activate düğmesine tıklayın. Bundan sonra blokta anahtar gizlenmiş olarak, durum (örneğin lisansın geçerli olduğu tarih ve alan adınız) ve şu düğmeler görünür: durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu mağazadan kaldırmak için Remove key. Bunların altında Product: opencart-shipping-cargoson satırı ve vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca bu uzantı 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 tarihle birlikte License expired on. Mağaza adresi değiştikten sonra ya da hesabınızda bir alan adı yuvası boşalttıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa uzantı son bilinen durumla çalışmaya devam eder.

Bir anahtar yalnızca bir alan adında çalışır: OpenCart yapılandırmasındaki mağaza adresi. Anahtarı mağazadan kaldırmak alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızda serbest bırakın.

Etkin bir anahtar olmadan Cargoson ö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 (unlicensed — visible to admins only) işaretiyle mağazada hâlâ görür; böylece bir anahtar satın almadan önce uzantıyı kurup test edebilirsiniz. OpenCart 4'te bu önizleme kullanılamaz: mağaza yönetici girişini görmez, bu yüzden etkin anahtar olmadan yöntem herkes için gizlenir. Edit sayfasını bir kez açtıktan sonra yönetici Dashboard sayfasında bir hatırlatma görünür. Bunu × ile kapatırsanız 7 gün gizlenir. Mevcut siparişler etkilenmez.

Lisans sona erdiğinde uzantı çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetici Dashboard sayfasını ya da Edit sayfasını açtığınızda durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonrasında haftada bir. Cron işi gerekmez. Uzantıyı kaldırmak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

Cargoson ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable Cargoson seçeneğinin açık olduğunu kontrol edin. Geo zone ayarını (ya da Ignore shipping zones ve Countries ayarlarını), ağırlık sınırlarını ve Minimum order amount değerini kontrol edin. Sabit modda, ülkenin ya da * All other countries satırının sepet boyutu için bir fiyatı olduğunu kontrol edin. Ürünlerde Requires Shipping değerinin Yes olduğundan emin olun.

Anlık fiyatlar görünmüyor: uzantı sayfasındaki Log alanına bakın. 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ş, Collection postcode eksik, API anahtarı reddediliyor (yanlış ya da süresi dolmuş anahtar veya Cargoson planınızda API erişimi yok), rota ya da ağırlık için taşıyıcı yok ya da başka bir para biriminde fiyat var. Cargoson live prices, fixed prices if the API fails seçeneğiyle siz sorunu giderirken müşteriler sabit fiyatı almaya devam eder.

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 biriminde fiyat reddediliyor: Price currency değerini Cargoson fiyatlarınızın para birimine ayarlayın ve Currency conversion rate girin.

Kargo için vergi iki kez alınıyor: Cargoson fiyatlarınız zaten KDV içeriyor. Tax class değerini No tax olarak ayarlayın.

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

Sayfa "Warning: You do not have permission to modify VibeFox Cargoson!" diyor: yönetici kullanıcı grubunuz ayarları yalnızca görüntüleyebiliyor olabilir. System > Users > User Groups altında grup için extension/shipping/vfd_cargoson (OpenCart 3) veya extension/vfd_cargoson/shipping/vfd_cargoson (OpenCart 4) değiştirme yetkisi verin.

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

Kaldırma

Extensions > Extensions sayfasına gidin, Shipping türünü seçin ve VibeFox Cargoson yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Bu uzantının lisans anahtarı ve lisans durumu her zaman kaldırılır. OpenCart her zaman Enable Cargoson, Sort order, Tax class ve Geo zone değerlerini sıfırlar. Önbelleğe alınmış fiyatlar her zaman silinir. Remove data on uninstall açıksa Cargoson ayarları ve hata ayıklama günlüğü de silinir. Kapalıysa diğer ayarlar korunur ve uzantıyı yeniden kurduğunuzda tekrar kullanılır. Yapılmış siparişlerin Cargoson teklifleri hiçbir zaman silinmez, mevcut siparişler kargo yöntemlerini ve maliyetlerini korur.

OpenCart 4'te uzantı dosyalarını da kaldırmak için kaldırma işleminden sonra Extensions > Installer sayfasına gidin, kurulu uzantılar listesinde VibeFox Cargoson 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.

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