VibeFox Australia Post for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 sürümünde test edildi) veya 4.0.2 ve üzeri (4.1.0.3 sürümünde test edildi).

PHP: 8.0 veya üzeri.

Australia Post PAC API anahtarı (yalnızca canlı tarifeler için): canlı tarifeler, Australia Post'un Postage Assessment Calculator (PAC) API'sini kullanır. Anahtar ücretsizdir: Australia Post Developer Centre (developers.auspost.com.au) üzerinden bir PAC API anahtarı için kaydolun. Ayarlar sayfası kayıt sayfasına bağlantı verir. Ayrıca gönderdiğiniz yerin 4 haneli Avustralya posta kodunu da bilmeniz gerekir. Yalnızca ülke başına sabit fiyatları kullanıyorsanız API anahtarı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, 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_australia_post-oc3-(version).ocmod.zip ve OpenCart 4 paketi vfd_australia_post.ocmod.zip bulunur. Yalnızca OpenCart sürümünüze uygun paketi kurun. Lisans anahtarı iki sürüm için de aynıdır.

OpenCart 3

1. Yönetim panelinde Extensions > Installer sayfasına gidin, Upload düğmesine tıklayın ve vfd_australia_post-oc3-(version).ocmod.zip dosyasını seçin. Eklenti 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 eklenti türü olarak Shipping seçin. VibeFox Australia Post eklentisini bulun ve Install düğmesine tıklayın (yeşil + düğmesi).

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

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

5. Rate source (tarife kaynağı) seçin. Sabit fiyatlar için Country prices tablosuna satır ekleyin. Canlı tarifeler için PAC API anahtarını, gönderici posta kodunu ve mağazanızın varsayılan para birimi AUD değilse AUD dönüşüm kurunu girin (bkz. Yapılandırma). Enable Australia Post seçeneğini açın ve Save düğmesine tıklayın.

OpenCart 4

1. Yönetim panelinde Extensions > Installer sayfasına gidin, Upload düğmesine tıklayın ve vfd_australia_post.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4 eklenti kodunu dosya adından alır ve yeniden adlandırılmış bir paket çalışmaz.

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

3. Extensions > Extensions sayfasına gidin ve eklenti türü olarak Shipping seçin. VibeFox Australia Post eklentisini bulun, Install düğmesine (yeşil + düğmesi) ve ardından Edit düğmesine (kalem simgesi) tıklayın.

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

Kurulumdan sonra, Enable Australia Post seçeneğini açıp kaydedene kadar yöntem kapalı kalır. Eklentiyi kaldırdıktan sonra yeniden kurarsanız, sakladığınız Australia Post ayarları yeniden kullanılır.

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Shipping > VibeFox Australia Post > Edit. Bölümler solda listelenir. Tek bir Save düğmesi tüm sayfayı yeniden yüklemeden kaydeder. Her kayıt, önbelleğe alınmış Australia Post tarifelerini de temizler. Yalnızca bu eklenti için değiştirme yetkisi olan yönetici kullanıcılar ayarları kaydedebilir.

Bazı hatalar kaydetmeyi durdurur ve bu durumda hiçbir şey kaydedilmez: 64 karakterden uzun bir Method title, tam sayı olmayan bir Sort order ya da bilinmeyen bir vergi sınıfı veya coğrafi bölge. Diğer sorunlar panelin üstünde uyarı olarak gösterilir ve ayarların geri kalanı kaydedilir. Sayı olmayan ya da negatif bir değer içeren sayısal bir alan önceki değerini korur ve uyarı alanı adıyla belirtir. Sayısal alanlar ondalık ayırıcı olarak nokta veya virgül kabul eder.

Canlı bir tarife kaynağı seçilmiş ancak API anahtarı, 4 haneli gönderici posta kodu veya AUD dönüşüm kuru eksikse, kaydettikten sonra bir uyarı gösterilir. Uyarı ayrıca düzeltene kadar ne olacağını da belirtir: yöntem ödeme sayfasında gizlenir ya da yedek modda ülke başına sabit fiyatlar kullanılır. Sayfa ayrıca mağazanızda kg birimli bir ağırlık sınıfı ya da cm birimli bir uzunluk sınıfı yoksa da uyarır. Bu durumda ürün ağırlıkları ve boyutları sınıflarının birimine göre (kg, g, lb, oz; cm, mm, m, in) dönüştürülür, diğer birimler kg ve cm olarak okunur.

Genel

Ayarlar tüm coğrafi bölgeler için geçerlidir. Yöntemi Conditions içinde bir coğrafi bölgeyle, ya da Availability without shipping zones içinde bir ülke listesiyle sınırlayabilirsiniz.

Enable Australia Post: Australia Post'u ödeme sayfasında gösterir veya gizler. Varsayılan: kapalı.

Method title: müşterinin sepette ve ödeme sayfasında gördüğü kargo yönteminin adı. Varsayılan: Australia Post. En fazla 64 karakter: daha uzun bir başlık reddedilir ve hiçbir şey kaydedilmez. Alan boşsa bir uyarı gösterilir ve Australia Post kullanılır.

Rate source: fiyatın nasıl hesaplandığı.

Hata ayrıntıları müşteriye değil, günlüğe gider.

Sort order: Australia Post'un ödeme sayfasındaki kargo yöntemleri arasındaki konumu. Tam sayı.

Australia Post API'si (canlı tarifeler) (sabit fiyatlar için gerekli değildir)

PAC API key: ücretsiz Australia Post PAC API anahtarınız. Anahtar, AUTH-KEY başlığında Australia Post'a gönderilir. Kaydettikten sonra alan boş kalır ve Saved — leave empty to keep it. ibaresini 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. Bundan sonra canlı tarifeler çalışmaz.

Ship-from postcode: paketlerin gönderildiği 4 haneli Avustralya posta kodu, örneğin 2000.

Domestic service: Avustralya içindeki teslimatlar için kullanılır (kenar başına en fazla 22 kg, 105 cm): Parcel Post (varsayılan) veya Express Post.

International service: Avustralya dışındaki teslimatlar için kullanılır (en fazla 20 kg): International Standard (varsayılan), International Express veya International Courier.

Remove GST: API'nin yurt içi fiyatlarını 1,1'e böler. Australia Post yurt içi fiyatları %10 GST içerir. Kargoya OpenCart'ın kendisi vergi eklediğinde (bir Tax class seçili olduğunda) bunu açın; böylece GST iki kez tahsil edilmez. Uluslararası posta GST'den muaftır ve asla değiştirilmez.

AUD → (your currency) rate: etiket, mağazanızın varsayılan para birimini gösterir. Australia Post fiyatları AUD cinsindendir. Varsayılan para biriminiz AUD değilse, bir AUD'nin kaç birim sizin para biriminize eşit olduğunu girin, örneğin 0,61. Kur 0'dan büyük olmalıdır. Bu olmadan canlı tarifeler kullanılmaz. Varsayılan para biriminiz AUD ise alan dönüşüm gerekmediğini belirtir: boş bırakın.

Canlı tarifeler için paket

Sepet tek bir paket olarak gönderilir. Ürün ağırlıkları ve boyutları OpenCart ağırlık ve uzunluk sınıflarından kg ve cm birimine dönüştürülür. Aşağıdaki değerler ağırlığı veya boyutu olmayan ürünler için kullanılır.

Default product weight (kg): ağırlığı olmayan her ürün için, Australia Post isteğinde ve Min cart weight (kg) / Max cart weight (kg) kontrolünde kullanılır. Varsayılan: 1.

Default parcel length (cm): sepetteki hiçbir ürünün boyutu yoksa kullanılır. Varsayılan: 22.

Default parcel width (cm): sepetteki hiçbir ürünün boyutu yoksa kullanılır. Varsayılan: 16.

Default parcel height (cm): sepetteki hiçbir ürünün boyutu yoksa kullanılır. Varsayılan: 8.

Ürünlerin boyutları olduğunda paket, aralarındaki en büyük uzunluğu ve genişliği alır; yükseklik ise paket tüm ürünlerin hacmini alana kadar artar.

Sabit fiyatlar (sabit fiyatlarla ve canlı tarifelerin yedeği olarak kullanılır)

Country prices: mağazanızın varsayılan para biriminde, vergi hariç ülkeler ve fiyatların listesi. Satır eklemek için Add row düğmesine, bir satırı silmek için × düğmesine tıklayın. Kendi satırı olmayan her ülke için kullanılacak fiyat için * All other countries seçeneğini seçin. Fiyatı olmayan bir ülke (ve * satırı yoksa) sabit tarife almaz, bu nedenle yöntem o ülke için gizlenir. Fiyatı olmayan satırlar kaydedilirken atılır. Fiyat eklemeden tablo boş kalır.

Fixed price per: Order (varsayılan) fiyatı bir kez alır. Item (price × quantity) ise fiyatı sepetteki ürün adedi ile çarpar. Bu yalnızca sabit fiyatlar için geçerlidir. Canlı tarifeler her zaman tüm paket için hesaplanır.

Koşullar

Min cart weight (kg): sepet ağırlığı bu değerin altındaysa yöntemi gizler. 0 sınır olmadığı anlamına gelir (varsayılan).

Max cart weight (kg): sepet ağırlığı bu değerin üzerindeyse yöntemi gizler. Varsayılan: 22. 0 sınır olmadığı, boş alan ise 22 kg anlamına gelir. Australia Post paketleri: yurt içi 22 kg, uluslararası 20 kg. Min cart weight (kg) maksimumdan büyükse yöntem hiç gösterilmez: bir uyarı çıkar ve her iki ağırlık da önceki değerlerini korur.

Minimum order amount: yöntemi yalnızca kargo gerektiren ürünlerin ara toplamı (kupon sonrası, vergi hariç, mağazanızın varsayılan para biriminde) bu tutara ulaştığında gösterir. Her zaman göstermek için alanı boş bırakın.

Free shipping: aşağıdaki tutardan itibaren ücretsiz kargoyu açar.

Free shipping from: kargo gerektiren ürünlerin ara toplamı (kupon sonrası, vergi hariç); bu tutardan itibaren kargo ücretsizdir. Bu durumda API'ye istek yapılmaz. Yalnızca Free shipping açıkken kullanılır.

Tax class: kargo ücretinin vergi sınıfı veya No tax (varsayılan). Australia Post yurt içi fiyatları GST içerir: bir vergi sınıfı seçiliyse Remove GST seçeneğini açın.

Geo zone: Australia Post'u yalnızca bu coğrafi bölgedeki adresler için sunun. All zones (varsayılan) sınır olmadığı anlamına gelir. Coğrafi bölgeler System > Localisation > Geo Zones altında yönetilir. Ignore shipping zones ile kullanılmaz.

Kargo bölgeleri olmadan kullanılabilirlik

Normalde yöntem, Conditions içinde seçilen coğrafi bölgede sunulur (All zones her yerde anlamına gelir).

Ignore shipping zones: coğrafi bölgeye bakılmaksızın yöntemi aşağıdaki ülkeler için sunar.

Countries: bu mod için hedef ülkeler. Aramak için yazın ve birden fazla seçin. Mağazanın etkin tüm ülkelerine izin vermek için boş bırakın. Yalnızca Ignore shipping zones ile kullanılır.

Gelişmiş

Debug log: tarife hesaplamalarını storage/logs/vfd_ap.log.php dosyasına kaydeder. Dosya web üzerinden okunamaz. API hataları her zaman kaydedilir. API anahtarı ve müşteri posta kodları kaydedilmez. İşiniz bittiğinde günlüğü kapatın. Dosya 5 MB'a ulaştığında vfd_ap.old.log.php dosyasına taşınır ve yeni bir günlük başlatılır.

Log: günlüğün boyutunu ve en son kayıtlarını gösterir. Temizlemek için Clear log düğmesine tıklayın.

Remove data on uninstall: açıksa, eklentiyi kaldırmak ayarları, önbelleğe alınmış tarifeleri ve günlüğü siler. Kapalıysa (varsayılan), yeniden kurulum için saklanırlar.

İçe / dışa aktarma

Dışa aktarma: ayarları bir JSON dosyası olarak kaydetmek için Download JSON düğmesine tıklayın. API anahtarı dışa aktarılmaz.

İçe aktarma: 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ıttaki gibi kontrol edilir. Kayıtlı API anahtarı korunur.

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

OpenCart kargo yöntemlerini gösterirken, Australia Post fiyatını eklentiden ister. Bir Geo zone ayarlıysa (ve Ignore shipping zones kapalıysa) ve adres bunun dışındaysa Australia Post sunulmaz. Ignore shipping zones açıksa Countries listesi belirleyici olur. Yalnızca Requires Shipping değeri Yes olan ürünler sayılır: diğer ürünler ağırlık eklemez ve sipariş tutarına dahil edilmez. Eklenti ardından sepet ağırlığını ve Minimum order amount değerini kontrol eder. Sipariş tutarı, kargo gerektiren ürünlerin kupon indirimi sonrası ve vergi öncesi fiyatıdır. Hediye sertifikaları, ödül puanları ve mağaza kredisi dikkate alınmaz. Ücretsiz kargo uygulanırsa fiyat 0 olur ve Australia Post'a istek gönderilmez.

Sabit fiyat modunda fiyat tablodan alınır. Canlı tarife modlarında eklenti, Australia Post'a paketin ağırlığını ve Avustralya içindeki teslimatlar için gönderici ve teslimat posta kodlarını ile paket boyutunu; uluslararası gönderiler için hedef ülkeyi gönderir. Yurt içi canlı tarife yalnızca teslimat adresinde 4 haneli posta kodu varsa istenir. Paket Australia Post sınırlarını aşarsa (yurt içi 22 kg veya 105 cm, uluslararası 20 kg), istek gönderilmez. AUD fiyatı kendi kurunuzla çevrilir ve Remove GST açıksa yurt içi fiyatlardan GST çıkarılır. Fiyat, mağazanızın varsayılan para biriminde hesaplanır, ondalık basamaklarına yuvarlanır ve seçili Tax class vergisiyle birlikte müşteriye kendi para biriminde gösterilir.

Başarılı 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 güncellemede Australia Post'u beklemez. API zaman aşımı 10 saniyedir. API hataları müşteriye asla gösterilmez: yöntem gizlenir ya da yedek modda sabit fiyat kullanılır. Nedeni günlüğe yazılır.

Eklenti yalnızca tarifeleri hesaplar. eParcel veya MyPost Business etiketleri, gönderileri ya da manifestoları oluşturmaz, paketleri takip etmez ve müşterilerin paket dolabı veya postane seçmesine izin vermez. Siparişlere hiçbir şey eklemez: sipariş, diğer tüm OpenCart kargo yöntemlerinde olduğu gibi yöntemin adını ve kargo ücretini gösterir. Sepet her zaman tek bir paket olarak fiyatlandırılır. Mektuplar, zarflar ve sözleşmeli (eParcel) tarifeler dahil değildir.

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

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Australia Post lisans bloğu, Extensions > Extensions > Shipping > VibeFox Australia Post > Edit sayfasında ayarların üstünde yer alan ilk bloktur. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bundan sonra blok, anahtarı maskeli olarak, durumu (örneğin lisansın geçerli olduğu tarih ve alan adınız) ve Check now (durumu yeniden kontrol eder), Change key (başka bir anahtar girer) ve Remove key (anahtarı bu mağazadan kaldırır) düğmelerini gösterir. Bunların altında Product: opencart-shipping-australia-post satırı ve Manage licenses and domains in your account bağlantısı bulunur; bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca eklenti için Modify yetkisi olan yönetici kullanıcılar değiştirebilir. Bloktaki metinler 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 tarihli License expired on. Mağaza adresi değiştikten sonra ya da hesabınızda bir alan adı yuvasını serbest bıraktıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Bir anahtar tek 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ızdan serbest bırakın.

Etkin bir anahtar olmadan Australia Post ödeme sayfasında müşterilere gösterilmez ve hiçbir tarife hesaplanmaz. Yönetim paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, yöntemi mağazada hâlâ (unlicensed — visible to admins only) işaretiyle görür; böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu önizleme kullanılamaz: mağaza yönetim paneli girişini görmez, bu yüzden etkin bir anahtar olmadan yöntem herkes için gizlenir. Edit sayfasını bir kez açtıktan sonra yönetim paneli Dashboard sayfasında bir hatırlatma belirir. Bunu × ile kapatırsanız 7 gün gizlenir. 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. Anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, sonrasında haftada bir kez olmak üzere, yönetim paneli Dashboard veya Edit sayfası açıldığında durum otomatik olarak yeniden kontrol edilir. Cron işi gerekmez. Eklentiyi kaldırmak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

Australia Post ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable Australia Post seçeneğinin açık olduğunu kontrol edin. Geo zone (ya da Ignore shipping zones ve Countries), sepet ağırlık sınırlarını ve Minimum order amount değerini inceleyin. Sabit fiyat modunda, ülkenin veya * All other countries seçeneğinin bir fiyatı olduğunu kontrol edin. Ürünlerin Requires Shipping değerinin Yes olduğunu doğrulayın.

Canlı tarifeler görünmüyor: Debug log seçeneğini açın, ödeme sayfasını yenileyin ve eklenti sayfasındaki Log alanına bakın. Nedeni gösterir: API anahtarı ya da gönderici posta kodu eksik, henüz 4 haneli teslimat posta kodu yok, paket sınırların üzerinde, AUD dönüşüm kuru yok ya da Australia Post hata mesajı. Live rates, fixed price if the API gives no rate seçeneğiyle, siz sorunu düzeltirken müşteriler yine sabit fiyatı alır.

Mağazam AUD'de değil: dönüşüm kurunu (varsayılan para biriminizden bir AUD'nin kaç birim olduğunu) AUD → (your currency) rate alanına girin. Sabit fiyatlar her zaman varsayılan para biriminizdedir.

Kargoda GST iki kez alınıyor: Australia Post yurt içi fiyatları %10 GST içerir. Bir Tax class seçiliyse Remove GST seçeneğini açın ya da Tax class değerini No tax olarak ayarlayın.

Fiyat çok yüksek ya da çok düşük: ürün ağırlıklarını ve boyutlarını, bunların ağırlık ve uzunluk sınıflarını ve Parcel for live rates altındaki varsayılan değerleri kontrol edin. Item (price × quantity) seçiliyse sabit fiyatlar ürün adediyle çarpılır.

Değişiklikten sonra tarifeler eski görünüyor: eklenti sayfasında Save düğmesine tıklayın. Bu, önbelleğe alınmış Australia Post tarifelerini temizler.

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

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

Kaldırma

Extensions > Extensions sayfasına gidin, Shipping türünü seçin ve VibeFox Australia Post yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Bu eklentinin lisans anahtarı ve lisans durumu her zaman silinir. OpenCart her zaman Enable Australia Post, Sort order, Tax class ve Geo zone ayarlarını sıfırlar. Önbelleğe alınmış tarifeler her zaman silinir. Remove data on uninstall açıksa Australia Post ayarları ve günlük de silinir. Kapalıysa diğer ayarlar korunur ve eklentiyi yeniden kurduğunuzda tekrar kullanılır. Mevcut siparişler kargo yöntemlerini ve maliyetlerini korur.

OpenCart 4'te eklenti dosyalarını da kaldırmak için kaldırdıktan sonra Extensions > Installer sayfasına gidin, kurulu eklentiler listesinde VibeFox Australia Post 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.

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