VibeFox EasyPost for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

WooCommerce: 7.0 veya üzeri, kurulu ve etkin. WooCommerce olmadan eklenti etkinleştirilemez.

PHP: 8.0 veya üzeri.

EasyPost hesabı (yalnızca canlı tarifeler için): EasyPost web sitesinde bir hesap oluşturun, kargo firması hesaplarınızı (USPS, UPS, FedEx ve diğerleri) EasyPost panelinde bağlayın ve API anahtarını EasyPost Dashboard > Account Settings > API Keys bölümünden kopyalayın. EasyPost, tarife istekleri için değil, satın alınan etiketler için ücret alır. Yalnızca yedek fiyatları kullanıyorsanız EasyPost hesabına ihtiyacınız yoktur.

Ürünler: ürünlerin ağırlığı ve daha iyisi boyutları olmalıdır.

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. vfd_easypost klasörünü FTP ile /wp-content/plugins/ konumuna da yükleyebilirsiniz.

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

3. Ayarları açın: WooCommerce > Settings > Shipping > VibeFox EasyPost, 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. EasyPost API anahtarınızı yapıştırın ve Ship from adresini doldurun. Canlı tarifeler için posta kodu zorunludur.

6. Mağaza para biriminiz USD değilse USD exchange rate alanına kur değerini girin. İsterseniz yedek fiyatları da girin (bkz. Yapılandırma).

7. WooCommerce > Settings > Shipping > Shipping zones bölümünde VibeFox EasyPost yöntemini bir kargo bölgesine ekleyin ya da 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 EasyPost. Tüm kargo bölgeleri için geçerlidirler. Yöntemi bir bölgeye eklediğinizde, bölge penceresinde yalnızca bir alan bulunur:

Title (zone): bu bölgedeki müşterilerin gördüğü kargo yöntemi adı. Genel Name değerini kullanmak için boş bırakın.

Sayfanın üst kısmında, canlı tarifeler kullanılamadığında eklenti uyarılar gösterir: API anahtarı yok, gönderen posta kodu veya ülkesi yok ya da kur olmadan USD dışında bir mağaza para birimi. Test API anahtarı ayarlandığında da bir not görünür. Ayarları her kaydettiğinizde önbelleğe alınmış EasyPost tarifeleri temizlenir.

Genel

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

Name: sepette ve ödeme sayfasında gösterilen kargo yöntemi adı. Bir bölge, kendi Title değeriyle bunu geçersiz kılabilir. Varsayılan: EasyPost Shipping.

EasyPost hesabı

API key: EasyPost Dashboard > Account Settings > API Keys bölümündeki EasyPost API anahtarınız. Üretim anahtarı (EZAK ile başlar) gerçek tarifeler döndürür. Test anahtarı (EZTK ile başlar) EasyPost test tarifeleri döndürür; yalnızca test için kullanın.

Allowed carriers / services: isteğe bağlı, virgülle ayrılmış. EasyPost'un adlandırdığı şekliyle bir kargo firması (USPS) veya bir kargo firması ve hizmet (USPS:Priority, UPS:Ground) girin. İzin verilen en ucuz tarife gösterilir. Herhangi bir kargo firmasının en ucuz tarifesini göstermek için boş bırakın.

Gönderim yeri

Paketlerinizin gönderildiği adres. Country mağazanızın ülkesiyse, boş alanlar WooCommerce > Settings > General altındaki mağaza adresinden doldurulur (gönderen adı da site başlığından alınır).

Sender name / company: gönderenin adı veya şirket adı.

Street address: gönderim adresinin sokağı.

City: gönderim şehri.

State: iki harfli eyalet kodu, örneğin CA veya NY.

ZIP code: gönderim posta kodu. Canlı tarifeler için zorunludur.

Country: gönderim yaptığınız ülke. Varsayılan: United States.

Tarifeler

Parcels: sepetin EasyPost'a nasıl gönderileceği.

Ağırlıklar mağaza birimindeki değerden ons'a (en az 1 oz) ve boyutlar inç'e dönüştürülür. Bir üründe boyut yoksa paket yalnızca ağırlığa göre tarifelendirilir.

USD exchange rate: EasyPost tarifeleri USD cinsindendir. 1 USD'nin mağaza para biriminizdeki fiyatını girin, örneğin 0.92. Bu değer olmadan canlı tarifeler kullanılmaz, yalnızca yedek fiyatlar kullanılır. Mağaza para birimi USD ise gerekmez. USD ve CAD mağazaları, EasyPost'tan kendi para biriminde teklif ister. Ondalık ayırıcı olarak hem nokta hem virgül kabul edilir.

Tax status: Taxable seçildiğinde WooCommerce vergi kurallarınıza göre kargoya vergi ekler; None seçildiğinde eklemez. EasyPost tarifeleri satış vergisini içermez. Varsayılan: Taxable.

Yedek fiyatlar

Canlı tarife olmadığında kullanılır: API anahtarı yoksa, EasyPost'a ulaşılamazsa, anahtar reddedilirse veya hiçbir kargo firması adres için tarife vermezse. Fiyatlar mağaza para biriminde girilir. Bu durumda yöntemi gizlemek için iki alanı da boş bırakın.

Country prices: ülke başına bir satır: iki harfli ülke kodu, iki nokta üst üste ve fiyat, örneğin US:9.99. Başka biçimdeki satırlar yok sayılır ve kaydederken bir hata mesajında listelenir.

Other countries: yukarıdaki listede olmayan ülkeler için fiyat. Bu ülkeler için yöntemi gizlemek üzere boş bırakın.

Koşullar

Free shipping from: kargonun ücretsiz olduğu sepet ara toplamı. Bu durumda EasyPost'a istek gönderilmez. Kapatmak için boş bırakın.

Minimum subtotal: yöntemi yalnızca sepet ara toplamı bu tutarın en az üzerindeyse gösterir. Her zaman göstermek için boş bırakın.

Minimum weight: sepet mağaza ağırlık biriminde bu değerden hafifse yöntemi gizler. 0 sınır olmadığı anlamına gelir.

Maximum weight: sepet mağaza ağırlık biriminde bu değerden ağırsa yöntemi gizler. 0 sınır olmadığı anlamına gelir.

Disabled shipping classes: sepette bu WooCommerce kargo sınıflarından birine ait bir ürün varsa yöntemi gizler.

Kargo bölgesi olmadan kullanılabilirlik

Ignore shipping zones: yöntem bir bölgeye eklenmiş olsun ya da olmasın, aşağıdaki ülkeler için yöntemi sunar.

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

Gelişmiş

Debug log: EasyPost isteklerini WooCommerce > Status > Logs altına, kaynak vfd-easypost olarak yazar. API hataları bu seçenek kapalı olsa bile her zaman kaydedilir. API anahtarı ve müşteri adresleri hiçbir zaman kaydedilmez.

Remove data on uninstall: açıksa, eklentiyi silmek ayarlarını ve bölge yöntemlerini kaldırır. Eklentiyi devre dışı bırakmak ayarları hiçbir zaman silmez.

Ö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: teslimat ülkesi, sepet ağırlığı, minimum ara toplam ve devre dışı kargo sınıfları. Ücretsiz kargo geçerliyse yöntem sıfır fiyatla gösterilir ve EasyPost'a istek gönderilmez.

Aksi takdirde eklenti EasyPost'a gönderici adresini, teslimat adresini ve paketi gönderir; tüm kargo firması hesaplarınızın tarifelerini alır. İzin verilen en ucuz tarifeyi seçer, mağaza para birimine çevirir ve yöntem adınızın altında gösterir. Posta kodu gerektiren ülkelerde istek, müşteri posta kodunu girdikten sonra gönderilir.

Her yanıt aynı adres ve aynı paket için 1 saat önbelleğe alınır. Kullanılabilir tarifesi olmayan bir adres 10 dakika hatırlanır. Zaman aşımı, reddedilen anahtar, hız sınırı (rate limit) veya bir EasyPost sunucu hatasından sonra 5 dakika boyunca istek gönderilmez. API zaman aşımı 10 saniyedir. Bu durumların hiçbirinde müşteri hata görmez: yedek fiyat kullanılır veya yedek fiyat yoksa yöntem gizlenir.

Seçilen kargo firması ve hizmet ile tek paket modunda tahmini teslimat günleri, siparişin kargo satırında saklanır. Bunları yönetici sipariş ekranında görürsünüz.

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

Eklenti yalnızca tarifeleri hesaplar. Etiket satın almaz, paketleri takip etmez, adresleri doğrulamaz, teslim alma veya bırakma noktaları sunmaz, sigorta ya da imza seçenekleri eklemez. Tek bir seçenek gösterir (izin verilen en ucuz tarife), hizmetlerin listesini göstermez. Ürünleri tek pakette yığmanın ötesinde kutu paketleme yoktur; tarifeye kâr marjı ya da işlem ücreti eklenmez.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Shipping > VibeFox EasyPost 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 etkin olduğu tarih ve alan adınız. Durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key, 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ı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

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

EasyPost ö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çıksa ve ülke izinliyse). Ağırlık sınırlarını, Minimum subtotal ve Disabled shipping classes ayarlarını kontrol edin. Canlı tarife yokken yöntemin, ülke için ya da Other countries için bir yedek fiyata ihtiyacı vardır.

Canlı tarifeler görünmüyor: ayarlar sayfasının üstündeki uyarıları okuyun, ardından Debug log seçeneğini açın, ödeme sayfasını yenileyin ve WooCommerce > Status > Logs sayfasını, kaynak vfd-easypost olacak şekilde açın. Yaygın nedenler: API anahtarı veya gönderen posta kodu yok, USD dışında bir mağaza para birimi ve USD exchange rate yok, müşteri henüz posta kodu girmedi, EasyPost hesabınızdaki hiçbir kargo firması adrese hizmet vermiyor ya da Allowed carriers / services tüm tarifeleri eliyor.

Tarifeler test fiyatları gibi görünüyor: bir test anahtarı (EZTK...) ayarlı. Canlı mağazada bir üretim anahtarı (EZAK...) kullanın.

Tarifeler birkaç dakikalığına durdu: zaman aşımı, reddedilen bir anahtar veya bir EasyPost sunucu hatasından sonra eklenti istekleri 5 dakika duraklatır ve yedek fiyatları kullanır. API anahtarını ve günlüğü kontrol edin.

Vergi dahil mi? EasyPost tarifeleri satış vergisini içermez. Tax status Taxable olduğunda WooCommerce, vergi ayarlarınıza göre kargoya vergi ekler.

Bir değişiklikten sonra tarifeler eski görünüyor: ayarlar sayfasını kaydedin. Bu, önbelleğe alınmış EasyPost tarifelerini temizler.

Geliştirici kancaları: vfd_ep_shipment_request (istek gövdesi), vfd_ep_selected_rate (seçilen tarife), vfd_ep_api_url (API temel URL'si) ve woocommerce_shipping_vfd_easypost_is_available filtreleri eklentiyi özelleştirir.

Lisans bloğu bir hata gösteriyor: bloktaki mesajı izleyin. Örneğin anahtar zaten başka bir alan adında kullanılıyorsa, vibefox.net hesabınızda bir yuva serbest bırakın ve Check now düğmesine tıklayın. Site adresi değiştiyse, yeni alan adı için anahtarı 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 tüm ayarları korur ve yalnızca önbelleğe alınmış tarifeleri temizler. Kaldırmak için eklentiyi devre dışı bırakın ve Plugins sayfasından silin. Bu eklentinin lisans anahtarı ve lisans durumu, önbelleğe alınmış tarifeler ve eski günlük dosyaları her zaman kaldırılır. Ayarlar ve bölge yöntemleri yalnızca Remove data on uninstall açıksa kaldırılır. Aksi halde sonraki bir yeniden kurulum için saklanır. Mevcut siparişler kargo satırlarını korur.

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