VibeFox Australia Post for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

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

PHP: 8.0 veya üzeri.

Australia Post PAC API anahtarı (yalnızca gerçek zamanlı tarifeler için): gerçek zamanlı tarifeler Australia Post Postage Assessment Calculator (PAC) API'sini kullanır. Anahtar ücretsizdir: PAC API anahtarı almak için Australia Post Developer Centre (developers.auspost.com.au) sitesine kaydolun. Ayrıca gönderdiğiniz yerin 4 haneli Avustralya posta koduna ihtiyacınız vardır. Yalnızca ülke başına sabit fiyatları kullanıyorsanız API anahtarına gerek 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 yoluna gidin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. Ayrıca vfd_australia_post 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 Australia Post yolunu izleyin veya 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. Rate source seçeneğini belirleyin. Gerçek zamanlı tarifeler için PAC API anahtarını, gönderen posta kodunuzu ve mağaza para biriminiz AUD değilse AUD dönüşüm oranını girin (bkz. Yapılandırma).

6. WooCommerce > Settings > Shipping > Shipping zones bölümünden VibeFox Australia Post yöntemini bir kargo bölgesine 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 Australia Post. Ayarlar tüm kargo bölgeleri için geçerlidir. Yöntemi bir bölgeye eklediğinizde bölge penceresinde yalnızca tek 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 Australia Post tarife önbelleği temizlenir. Gerçek zamanlı tarifeler seçili olup API anahtarı, gönderen posta kodu veya AUD oranı eksikse, kaydettikten sonra bir uyarı gösterilir.

General

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

Method title: müşterinin ödeme sayfasında gördüğü kargo yöntemi adı. Bir bölge bunu kendi başlığıyla değiştirebilir. Varsayılan: Australia Post.

Tax status: Taxable seçeneği kargo ücretine WooCommerce vergisini ekler, None seçeneği eklemez.

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

Hata ayrıntıları günlüğe yazılır, müşteriye asla gösterilmez.

Australia Post API (gerçek zamanlı tarifeler) (sabit fiyatlar için gerekli değildir)

PAC API key: ücretsiz Australia Post PAC API anahtarınız. AUTH-KEY üstbilgisinde Australia Post'a gönderilir.

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 (22 kg'a ve kenar başına 105 cm'ye kadar): Parcel Post (varsayılan) veya Express Post.

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

Remove GST: yurt içi API fiyatlarını 1,1'e böler. Australia Post yurt içi fiyatları %10 GST içerir. WooCommerce kargoya vergiyi kendisi eklediğinde (Tax status = Taxable) bu seçeneği açın; böylece GST iki kez alınmaz. Uluslararası posta ücreti GST'den muaftır ve hiçbir zaman değiştirilmez.

AUD → (your currency) rate: Australia Post fiyatları AUD cinsindendir. Mağaza para biriminiz AUD değilse, 1 AUD'nin kaç birim sizin para biriminize eşit olduğunu girin, örneğin 0.61. Bu değer olmadan gerçek zamanlı tarifeler kullanılmaz. Mağaza para biriminiz AUD ise alanı boş bırakın. Ondalık ayırıcı olarak hem nokta hem virgül kabul edilir.

Gerçek zamanlı tarifeler için paket

Sepet tek bir paket olarak gönderilir. Ürün ağırlıkları ve boyutları mağazanızın birimlerinden kg ve cm'ye 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 / Max cart weight 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.

Sabit fiyatlar (sabit fiyatlarla ve gerçek zamanlı tarifelerin yedek seçeneği olarak kullanılır)

Country prices: 2 harfli ülke kodlarından (AU, NZ, US vb.) ve mağaza para biriminizdeki fiyatlardan oluşan bir tablo. Bir ülke eklemek için + Add row düğmesine, birini silmek için silme düğmesine tıklayın. Diğer tüm ülkeler için * kullanın. Fiyatı olmayan (ve * satırı da bulunmayan) bir ülke için sabit tarife yoktur, bu nedenle yöntem o ülke için gizlenir. Fiyat eklenene kadar tablo boştur.

Fixed price per: Order fiyatı bir kez alır. Item (price × quantity) fiyatı sepetteki ürün adediyle çarpar. Bu yalnızca sabit fiyatlar için geçerlidir. Gerçek zamanlı tarifeler her zaman tüm paket için hesaplanır.

Koşullar

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

Max cart weight (kg): yöntemi bu sepet ağırlığının üstünde gizler. Varsayılan: 22. 0 sınır olmadığı anlamına gelir. Australia Post paketleri: yurt içi 22 kg, uluslararası 20 kg.

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

Excluded shipping classes: sepetteki herhangi bir ürün bu WooCommerce kargo sınıflarından birine sahipse yöntemi gizler.

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

Free shipping from: kargonun ücretsiz olduğu sepet ara toplamı. Bu durumda API'ye istek gönderilmez.

Kargo bölgesi olmadan kullanılabilirlik

Ignore shipping zones: hangi bölge eşleşirse eşleşsin, yöntemi aşağıdaki ülkeler için sunar.

Countries: bu mod için hedef ülkeler. Mağazanızın gönderim yaptığı tüm ülkeleri kullanmak için boş bırakın. Yalnızca Ignore shipping zones ile kullanılır.

Gelişmiş

Debug log: tarife hesaplamalarını WooCommerce > Status > Logs bölümüne, «vfd-australia-post» kaynağıyla kaydeder. API hataları her zaman kaydedilir. API anahtarı ve müşteri posta kodları kaydedilmez.

Remove data on uninstall: açıksa, eklentiyi silmek ayarlarını, bölge yöntemlerini ve önbellekteki tarifeleri 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 tarife ister. Eklenti önce sepet ağırlığını, Minimum order amount ve Excluded shipping classes ayarlarını kontrol eder. Ücretsiz kargo geçerliyse tarife 0 olur ve Australia Post'a istek gönderilmez.

Sabit fiyat modunda fiyat tablodan alınır. Gerçek zamanlı tarife modlarında eklenti Australia Post'a paketin ağırlığını gönderir; yurt içi teslimatlarda gönderen ve teslimat posta kodlarını ile paket boyutunu, uluslararası teslimatlarda ise hedef ülkeyi gönderir. Yurt içi gerçek zamanlı tarife, müşteri 4 haneli bir posta kodu girdikten sonra istenir. Paket Australia Post sınırlarını aşıyorsa (yurt içinde 22 kg veya 105 cm, uluslararasında 20 kg) istek gönderilmez. AUD fiyatı sizin oranınızla dönüştürülür ve Remove GST açıksa yurt içi fiyatlardan GST çıkarılır.

Başarılı her yanıt 1 saat önbellekte tutulur, böylece aynı sepet yeni bir istek tetiklemez. Başarısız bir istek 10 dakika önbellekte tutulur, böylece ödeme sayfası her yenilemede Australia Post'u beklemez. API hataları müşteriye asla gösterilmez: 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 tarife hesaplar. Kargo etiketi, eParcel veya MyPost Business gönderisi ya da manifesto oluşturmaz, paketleri takip etmez ve müşterilerin paket dolapları veya Postane şubeleri seçmesine izin vermez. Sepet her zaman tek bir paket olarak fiyatlandırılır. Mektuplar, satchel'ler ve sözleşmeli (eParcel) tarifeler dahil değildir.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Shipping > VibeFox Australia Post sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blokta durum gösterilir; örneğin lisansın hangi tarihe kadar geçerli olduğu 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 alan adı hakkını serbest bırakmaz. Hakkı vibefox.net hesabınızdan serbest bırakın.

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

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

Australia Post ö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 olup ülkeye izin veriliyor olmalıdır). Sepet ağırlığı sınırlarını, Minimum order amount ve Excluded shipping classes ayarlarını kontrol edin. Sabit fiyat modunda ülkenin veya * satırının bir fiyatı olup olmadığını kontrol edin.

Gerçek zamanlı tarifeler görünmüyor: Debug log seçeneğini açın, ödeme sayfasını yenileyin ve WooCommerce > Status > Logs bölümünü açın («vfd-australia-post» kaynağı). Nedeni orada görürsünüz: API anahtarı veya gönderen posta kodu yok, henüz 4 haneli teslimat posta kodu girilmedi, paket sınırların üzerinde, AUD dönüşüm oranı yok ya da Australia Post hata mesajı var. Live rates, fixed price if the API gives no rate seçeneğiyle, sorunu çözerken müşteriler yine sabit fiyatı görür.

Mağazam AUD değil: dönüşüm oranını (1 AUD'nin kaç birim sizin para biriminize eşit olduğunu) AUD → (your currency) rate alanına girin. Sabit fiyatlar her zaman mağaza para biriminde kalır.

Kargoda GST iki kez alınıyor: Australia Post yurt içi fiyatları %10 GST içerir. Tax status Taxable ise Remove GST seçeneğini açın.

Fiyat çok yüksek veya çok düşük: ürün ağırlıklarını ve boyutlarını ile Parcel for live rates bölümündeki varsayılan değerleri kontrol edin. Item (price × quantity) seçildiğinde sabit fiyatlar ürün adediyle çarpılır.

Bir değişiklikten sonra tarifeler eski görünüyor: ayarlar sayfasını kaydedin. Bu, Australia Post tarife önbelleğini 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 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 Plugins sayfasında devre dışı bırakıp silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ayarlar, bölge yöntemleri ve önbellekteki tarifeler yalnızca Remove data on uninstall açıksa kaldırılır. Aksi halde, sonraki yeniden kurulum için saklanır. Mevcut siparişler kargo satırlarını korur.

Australia Post, ilgili sahibinin ticari markasıdır. Bu eklenti Australia Post ile bağlantılı değildir ve onayı yoktur.