VibeFox 99Minutos for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

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

PHP: 8.0 veya üzeri.

99minutos API anahtarı (yalnızca kapsam kontrolü için): 99minutos hesap yöneticinizden veya 99minutos geliştirici portalından (developers.99minutos.com) alın. Sandbox ve canlı anahtarlar farklıdır. Yalnızca fiyat matrisini 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

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_99minutos 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 99Minutos 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. Price matrix alanını doldurun (en az bir satır, örneğin "* Default") ve isteğe bağlı olarak API anahtarını ve kapsam kontrolü modunu girin (bkz. Yapılandırma bölümü).

6. WooCommerce > Settings > Shipping > Shipping zones bölümünde Meksika, Kolombiya, Şili veya Peru'yu kapsayan bir kargo bölgesine VibeFox 99Minutos ekleyin.

Yapılandırma

Tüm ayarlar tek bir sayfada bulunur: WooCommerce > Settings > Shipping > VibeFox 99Minutos. Tüm kargo bölgelerinde geçerlidirler. Yöntemi bir bölgeye eklediğinizde bölge penceresinde yalnızca bir alan bulunur:

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

Ayarları kaydettiğinizde, fiyat matrisi boşsa veya API anahtarı olmadan bir kapsam kontrolü modu seçilmişse sayfa sizi uyarır.

Genel

Enable/Disable: 99Minutos'u tüm kargo bölgelerinde bir kerede etkinleştirir. Yöntemin ayrıca Meksika, Kolombiya, Şili veya Peru'yu kapsayan bir kargo bölgesine eklenmesi gerekir. Varsayılan: açık.

Method title: ödeme sayfasında müşteriye gösterilen kargo yöntemi adı. Bir bölge bunu geçersiz kılabilir. Varsayılan: 99Minutos.

Tax status: Taxable kargo ücretine WooCommerce vergisi ekler, None eklemez.

99minutos API (kapsam kontrolü) (isteğe bağlı)

API yalnızca 99minutos'un müşterinin posta koduna teslimat yapıp yapmadığını kontrol etmek için kullanılır. Fiyat her zaman matristen gelir.

Coverage check: posta kodunun kontrol edilip edilmeyeceği ve nasıl kontrol edileceği.

Kapsam kontrolü ile yöntem, müşteri bir posta kodu girdikten sonra görünür. Sonuçlar önbelleğe alınır: kapsanan 6 saat, kapsanmayan 30 dakika, API hatası 5 dakika. 99minutos'a yalnızca posta kodu gönderilir.

API key: 99minutos API anahtarınız; 99minutos kapsam uç noktasına Bearer belirteci olarak gönderilir. Kapsam kontrolü açıkken zorunludur. Alan maskelenmiştir.

Environment: Sandbox (test) (varsayılan) veya Production. Sandbox ve canlı ortamlar farklı API anahtarları kullanır; anahtarınızla eşleşen ortamı seçin.

Ücretler

Fiyatlar mağaza para biriminizdedir ve girildiği gibi, dönüştürme yapılmadan kullanılır.

Price matrix: hedef ülkeler ve fiyatlardan oluşan bir tablo. Satır eklemek için + Add country düğmesine, satırı kaldırmak için çarpı işaretine tıklayın. Her satırda bir Country, bir Base price ve XS (1 kg'a kadar), S (2 kg'a kadar), M (3 kg'a kadar), L (5 kg'a kadar) ve XL (5 kg'dan fazla) boyutları için fiyatlar bulunur. Boş veya 0 olan boyut fiyatı Base price değerine döner. * Default satırı, kendi satırı olmayan ülkeler için geçerlidir. Ondalık ayırıcı olarak hem nokta hem virgül kabul edilir; negatif fiyatlar 0 olarak kaydedilir. Matriste en az bir satır olana kadar yöntem ödeme sayfasında gösterilmez.

Calculation: Per order — size by the total cart weight (varsayılan) tüm sepetin paket boyutu için tek bir fiyat alır. Per item — each unit priced by its own weight her birimi kendi ağırlığının boyutuna göre fiyatlandırır ve toplar.

Free shipping: sepet ara toplamından itibaren ücretsiz kargoyu etkinleştirir.

Free shipping from: tarifenin 0 olduğu sepet ara toplamı (indirimler sonrası, vergi hariç). Yalnızca Free shipping açıksa kullanılır.

Kısıtlamalar

Min weight (kg): sepet bundan hafifse yöntemi gizler. 0 sınır olmadığı anlamına gelir. Ürün ağırlıkları mağazanızın ağırlık biriminden çevrilir.

Max weight (kg): sepet bundan ağırsa yöntemi gizler. Varsayılan: 25. 0 sınır olmadığı anlamına gelir.

Minimum subtotal: yöntemi yalnızca sepet ara toplamı (indirimler sonrası, vergi hariç) bu tutarın en az aynısı olduğunda gösterir. Her zaman göstermek için boş bırakın.

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

Restrict countries: yöntemi yalnızca aşağıdaki ülkeler için sunar. Bu, kargo bölgelerinin üzerine eklenen ek bir filtredir: yöntemin yine de bir bölgeye eklenmesi gerekir. Bir bölge birden fazla ülkeyi kapsadığında kullanışlıdır.

Countries: 99minutos ülkelerinden seçim (Meksika, Kolombiya, Şili, Peru). Yalnızca Restrict countries açıksa kullanılır. Tüm 99minutos ülkelerine izin vermek için boş bırakın.

Gelişmiş

Debug log: fiyat hesaplamalarını WooCommerce > Status > Logs altına ("vfd-99minutos" kaynağı ile) kaydeder. API hataları, bu seçenek kapalıyken bile kaydedilir. API anahtarları ile müşteri adları ve adresleri hiçbir zaman kaydedilmez.

Remove data on uninstall: açıksa eklentiyi silmek ayarlarını ve kapsam önbelleğini kaldırır. Devre dışı bırakmak hiçbir şeyi silmez. Kargo bölgelerindeki yöntemler ve siparişler her durumda korunur.

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

Yöntem yalnızca teslimat ülkesi Meksika, Kolombiya, Şili veya Peru ise sunulur (ve Restrict countries açıksa Countries listesinde yer almalıdır). Müşteri bir teslimat adresi girdiğinde eklenti sepet ağırlık sınırlarını, Minimum subtotal değerini ve Excluded shipping classes değerini kontrol eder.

Bir kapsam kontrolü modu açıksa eklenti ardından 99minutos API'sine posta kodunun kapsanıp kapsanmadığını sorar. İstek zaman aşımı 10 saniyedir ve yanıt önbelleğe alınır; bu yüzden aynı posta kodu yeni bir istek tetiklemez. API hataları müşteriye hiçbir zaman gösterilmez: Strict modunda yöntem gizlenir, Soft modunda matris fiyatı kullanılır. Ücretsiz kargo, kapsam kontrolünü atlatmaz.

Fiyat, teslimat ülkesinin matris satırından veya * Default satırından alınır. İkisi de yoksa yöntem gizlenir. Free shipping açıksa ve sepet ara toplamı Free shipping from değerine ulaşırsa tarife 0 olur.

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

Eklenti 99minutos'tan canlı kargo ücreti teklifleri almaz: fiyatlar her zaman sizin matrisinizden gelir. 99minutos'ta gönderi veya sipariş oluşturmaz, etiket (guides) yazdırmaz, kargoları takip etmez, Punto99 teslim noktaları sunmaz ve kapıda ödemeyi yönetmez. Gönderileri her zamanki gibi 99minutos hesabınızda oluşturun.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarı ile çalışır. Lisans bloğu WooCommerce > Settings > Shipping > VibeFox 99Minutos 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 geçerli 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 alan adı yuvasını boşaltmaz. Yuvayı vibefox.net hesabınızdan boşaltın.

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

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

99Minutos ö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 adresinin bölgesine eklendiğini kontrol edin. Teslimat ülkesi Meksika, Kolombiya, Şili veya Peru olmalıdır. Price matrix içinde o ülke için veya bir * Default satırının bulunduğunu doğrulayın; ayrıca ağırlık sınırlarını, Minimum subtotal, Excluded shipping classes ve Restrict countries ayarlarını kontrol edin.

Yöntem yalnızca bir posta kodu girildikten sonra görünüyor: kapsam kontrolü ile bu beklenen bir davranıştır. Strict modunda yalnızca API kapsamı onayladığında görünür.

Yöntem Strict modunda her zaman gizli: Debug log seçeneğini açın, ödeme sayfasını yenileyin ve WooCommerce > Status > Logs sayfasını açın ("vfd-99minutos" kaynağı). HTTP 401 veya 403 hatası, API anahtarının reddedildiği anlamına gelir: anahtarı ve Environment ayarının eşleştiğini kontrol edin (sandbox ve canlı anahtarlar farklıdır). API kullanılamazken müşterilerin yine de matris fiyatını görmesi gerekiyorsa Soft modunu kullanın.

Fiyat beklediğiniz gibi değil: Calculation seçeneğini (sipariş başına veya ürün başına), ürün ağırlıklarını ve mağazanızın ağırlık birimini kontrol edin. Boş veya 0 olan boyut fiyatı Base price değerine döner.

Diğer ülkeler: geliştiriciler, desteklenen ülke listesini vfd_99m_supported_countries filtresi ile değiştirebilir.

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 boşaltı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 verileri korur. Kaldırmak için eklentiyi Plugins sayfasında devre dışı bırakın ve silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ayarlar ve kapsam önbelleği yalnızca Remove data on uninstall açıksa kaldırılır. Aksi halde sonraki bir yeniden kurulum için saklanırlar. Kargo bölgelerindeki yöntemler ve mevcut siparişler korunur.

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