VibeFox Estafeta for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

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

PHP: 8.0 veya üzeri.

DrEnvio hesabı (yalnızca anlık fiyatlar için): Estafeta'nın anlık fiyatları, Meksika'daki bir Estafeta ortağı olan DrEnvio'dan gelir. drenvio.com adresinde bir hesap oluşturun, Estafeta'yı etkinleştirin, orada toplama adresinizi ayarlayın ve DrEnvio panelinden API anahtarını kopyalayın. Resmi DrEnvio eklentisinin kullandığı anahtarın aynısıdır. Yalnızca kendi fiyatlarınızı kullanıyorsanız DrEnvio hesabına ihtiyacınız yoktur.

Ürünler: anlık fiyatlar için ürünlerin ağırlık bilgisi 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 yolunu izleyin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. Ayrıca vfd_estafeta 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 Estafeta, veya Eklentiler sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

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

5. DrEnvio API anahtarını ve isteğe bağlı olarak çıkış posta kodunu girin. Mağaza para biriminiz MXN değilse MXN exchange rate değerini girin. DrEnvio fiyat vermediğinde yöntemin görünür kalmasını istiyorsanız MX için bir ülke fiyatı veya yedek ücret belirleyin.

6. VibeFox Estafeta yöntemini, WooCommerce > Settings > Shipping > Shipping zones bölümündeki Meksika bölgenize 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 Estafeta. Ayarlar 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 seçeneğin ödeme sayfasındaki adı. Genel Name değerini kullanmak için boş bırakın.

Sayfanın üstünde eklenti uyarılar gösterir: DrEnvio API anahtarı yoksa, mağaza para birimi MXN dışındaysa ve döviz kuru yoksa veya MX için ülke fiyatı ile yedek ücret yoksa (bu durumda anlık fiyat yoksa yöntem gizlenir). Ayarları her kaydettiğinizde, önbellekteki DrEnvio fiyatları temizlenir. Sayısal alanlar ondalık nokta veya virgül kabul eder. Geçerli bir sayı olmayan bir değer silinir ve kaydederken bildirilir.

Genel

Enable/Disable: Estafeta kargoyu tüm bölgelerde birlikte açar veya kapatır. Varsayılan: açık.

Name: ödeme sayfasında müşteriye gösterilen kargo yöntemi adı. Varsayılan: Estafeta.

Tax status: Taxable, WooCommerce'in kargo ücretine vergi eklemesine izin verir; None eklemez. DrEnvio fiyatlarının IVA içerip içermediği DrEnvio hesabınıza bağlıdır. Zaten IVA içeriyorlarsa None seçin. Varsayılan: Taxable.

Anlık fiyatlar (DrEnvio API)

Adres için en ucuz Estafeta hizmeti sunulur. Anahtar yoksa bir sonraki bölümdeki fiyatlar kullanılır.

DrEnvio API key: DrEnvio panelinizdeki API anahtarı.

Origin country: toplama adresinin iki harfli ülke kodu. Varsayılan: MX. Yalnızca çıkış posta koduyla birlikte gönderilir.

Origin postcode: toplama adresinin 5 haneli posta kodu. DrEnvio hesabınızda kayıtlı çıkış adresini kullanmak için boş bırakın. 5 haneden oluşmayan bir posta kodu kaydederken silinir.

MXN exchange rate: DrEnvio, Meksika pesosu cinsinden teklif verir. Yalnızca mağaza para biriminiz MXN değilse gerekir: 1 MXN'nin mağaza para birimindeki değeri, örneğin 0.05. Bu olmadan anlık fiyatlar kullanılmaz.

Anlık fiyat olmayan fiyatlar

API anahtarı yoksa veya DrEnvio bir Estafeta fiyatı döndürmezse kullanılır (API kullanılamıyor, bilinmeyen posta kodu, henüz posta kodu girilmemiş). Fiyatlar mağaza para biriminizdedir.

Country prices: satır başına bir hedef ülke, CC:PRICE biçiminde, örneğin MX:150. Ondalık nokta veya virgül kullanın, binlik ayırıcı kullanmayın. Farklı biçimdeki bölümler yok sayılır ve kaydederken bildirilir.

Fallback cost: anlık fiyat ve ülke fiyatı yokken uygulanan fiyat. Yöntemi gizlemek için boş bırakın; 0 ücretsiz kargo anlamına gelir.

Calculation type: Per order fiyatı bir kez alır. Per item (price x number of items) fiyatı gönderilebilir ürün sayısıyla çarpar. Bu, Country prices ve Fallback cost için geçerlidir. DrEnvio anlık fiyatı her zaman tüm paketin fiyatıdır.

Koşullar

Free shipping from: sepet ara toplamı bu tutara ulaştığında kargo ücretsizdir. Bu durumda DrEnvio'ya istek gönderilmez. Hiçbir zaman ücretsiz kargo sunmamak için boş bırakın.

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

Min weight (kg): yöntemin görünmesi için gereken minimum sepet ağırlığı. 0 sınır olmadığı anlamına gelir.

Max weight (kg): maksimum sepet ağırlığı. Aşıldığında yöntem gizlenir. Varsayılan: 30. 0 sınır olmadığı anlamına gelir.

Excluded shipping classes: sepetteki bir ürün bu WooCommerce kargo sınıflarından birine aitse yöntem gizlenir.

Ürün ağırlıkları, mağazanızın birimden kg'a dönüştürülür.

Kargo bölgesi olmadan kullanılabilirlik

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

Countries: bu mod için hedef ülkeler. Tüm ülkeler için boş bırakın. Yalnızca Ignore shipping zones açıkken kullanılır.

Gelişmiş

Debug log: API isteklerini ve fiyat hesaplamasını WooCommerce > Status > Logs altına, kaynak vfd-estafeta olarak kaydeder. API hataları her zaman kaydedilir. API anahtarı ve müşteri adresleri asla kaydedilmez.

Remove data on uninstall: açıksa, eklentiyi silmek tüm eklenti ayarlarını ve bölge yöntemlerini 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 sepet ağırlığını, minimum ara toplamı ve hariç tutulan kargo sınıflarını kontrol eder. Ücretsiz kargo geçerliyse yöntem sıfır fiyatla gösterilir ve DrEnvio'ya istek gönderilmez.

Aksi halde eklenti DrEnvio'ya hedef ülkeyi ve posta kodunu, sepet ağırlığını, ürün sayısını ve ara toplamı gönderir; bir çıkış posta kodu belirlediyseniz onu da ekler. Meksika posta kodları 5 haneli olmalıdır; müşteri bir posta kodu girene kadar istek yapılmaz. DrEnvio, hesabınızdaki tüm kargo firmalarının tekliflerini döndürür. Eklenti yalnızca Estafeta tekliflerini kullanır, sıfır fiyatları yok sayar, en ucuzunu seçer ve mağaza para biriminize çevirir. Estafeta hizmeti ve teslimat süresi siparişin kargo satırıyla birlikte kaydedilir ve yönetici sipariş ekranında gösterilir.

Her yanıt 1 saat önbellekte tutulur. Başarısız bir istek veya Estafeta fiyatı olmayan bir rota 5 dakika hatırlanır; böylece yavaş veya bozuk bir API ödeme sayfasındaki her güncellemeyi yavaşlatmaz. API zaman aşımı 12 saniyedir. Bu durumlarda müşteri hata görmez: ülke fiyatı veya yedek ücret kullanılır, ikisi de ayarlı değilse yöntem gizlenir.

Yöntem klasik ödeme sayfasında ve Sepet ile Ödeme bloklarında çalışır. WooCommerce Yüksek Performanslı Sipariş Depolama (HPOS) ile uyumludur.

Eklenti yalnızca fiyat hesaplar. Gönderi oluşturmaz, etiket (guías) yazdırmaz veya paketleri takip etmez; gönderiyi DrEnvio veya Estafeta hesabınızda oluşturun. Müşteri belirli bir Estafeta hizmeti veya Estafeta şubesi seçemez ve döviz kurları otomatik olarak güncellenmez.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Shipping > VibeFox Estafeta sayfasının üstündedir. 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 etkin 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. Alan adı hakkını vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar yoksa Estafeta ödeme sayfasında müşterilere gösterilmez. Oturum açmış mağaza yöneticileri yine de onu (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.

Lisans 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

Estafeta ö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 ve ülke izinli olmalıdır). Ayarlar sayfasının üstündeki uyarılara, ağırlık sınırlarına, Minimum subtotal ve Excluded shipping classes ayarlarına bakın. API anahtarı yoksa veya DrEnvio bir Estafeta fiyatı döndürmüyorsa, yöntemin hedef için bir ülke fiyatına veya yedek ücrete ihtiyacı vardır.

Anlık fiyatlar görünmüyor: Debug log seçeneğini açın, ödeme sayfasını yenileyin ve WooCommerce > Status > Logs bölümünü, kaynak vfd-estafeta olacak şekilde açın. Nedeni gösterir: API anahtarı yok, MXN dışı bir mağaza için döviz kuru yok, posta kodu eksik veya geçersiz, API anahtarı reddedildi (HTTP 401 veya 403) ya da rota için Estafeta fiyatı yok.

Fiyat IVA'yı içeriyor mu? Bu, DrEnvio hesabınıza bağlıdır. DrEnvio fiyatları zaten IVA içeriyorsa Tax status değerini None yapın.

Bir değişiklikten sonra fiyatlar eski görünüyor: ayarlar sayfasını kaydedin. Bu, önbellekteki DrEnvio fiyatlarını 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 alan adı hakkı 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şılamıyorsa eklenti son bilinen durumla çalışmaya devam eder.

Kaldırma

Eklentiyi devre dışı bırakmak tüm ayarları korur ve yalnızca fiyat önbelleğini temizler. Kaldırmak için eklentiyi devre dışı bırakın ve Plugins sayfasında silin. Bu eklentinin lisans anahtarı ve lisans durumu, önbellekteki fiyatlar 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 kalırlar. Siparişlere asla dokunulmaz ve mevcut siparişler kargo satırlarını korur.

Estafeta ve DrEnvio, ilgili sahiplerinin ticari markalarıdır. Bu eklenti Estafeta veya DrEnvio ile bağlantılı değildir ve onlar tarafından onaylanmamıştır.