VibeFox Frenet for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

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

PHP: 8.0 veya üzeri.

Frenet hesabı (yalnızca canlı teklifler için): Frenet panelinde ücretsiz bir hesap oluşturun (painel.frenet.com.br), kullandığınız kargo firmalarını etkinleştirin ve API jetonunuzu kopyalayın. Yalnızca sabit fiyat kullanıyorsanız Frenet hesabına ihtiyacınız yoktur.

Ürünler: doğru fiyatlar için ağırlık ve boyutları doldurun. Bunlar olmayan ürünler 0,3 kg ve 16 × 11 × 2 cm olarak teklif edilir (en küçük Correios kutusu).

VibeFox lisans anahtarı: vibefox.net'ten satın alınır. Bir anahtar bir domainde ç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_frenet 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 Frenet, ya da Plugins 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. API jetonunu yapıştırın ve çıkış CEP'ini girin. Mağaza para biriminiz BRL değilse BRL döviz kurunu girin. İsteğe bağlı olarak sabit fiyatlar ve bir yedek ücret ekleyin.

6. Brezilya için bir kargo bölgesine VibeFox Frenet yöntemini ekleyin: WooCommerce > Settings > Shipping > Shipping zones. Alternatif olarak Ignore shipping zones seçeneğini açın ve ülkeleri seçin.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Shipping > VibeFox Frenet. Bunlar 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): müşterilerin bu bölge için gördüğü ad. Genel Method title değerini kullanmak için boş bırakın.

Sayfanın üstünde eklenti uyarılar gösterir: API jetonu yoksa (yalnızca sabit fiyatlar kullanılır veya sabit fiyat da yoksa yöntem hiç gösterilmez), 8 haneli çıkış CEP'i yoksa ya da mağaza para birimi BRL değilse ve döviz kuru girilmemişse. Ayarları her kaydettiğinizde önbelleğe alınmış teklifler temizlenir. Fiyat alanları ondalık ayırıcı olarak hem nokta hem virgül kabul eder.

Genel

Enable/Disable: yöntemi tüm bölgelerde aynı anda kapatır. Varsayılan: on.

Method title: sepette ve ödeme sayfasında gösterilen kargo yöntemi adı. Bir bölge bunu değiştirebilir. Varsayılan: Frenet.

Canlı Frenet teklifleri

Frenet, Frenet hesabınızda etkin olan kargo firmalarını karşılaştırır ve sepet için fiyatlarını döndürür. Canlı teklifler yalnızca tam 8 haneli CEP'e sahip Brezilya adresleri için istenir.

API token: Frenet panelinizden aldığınız Frenet API jetonu. Yalnızca sabit fiyat kullanmak için boş bırakın.

Origin CEP: paketlerin gönderildiği posta kodu (CEP), örneğin 00000-000. Mağaza adresi Brezilya'daysa mağaza posta kodunu kullanmak için boş bırakın. 8 haneli olmayan bir CEP kaydetme sırasında bildirilir.

Service to offer: Cheapest service (varsayılan) veya Fastest service. Frenet birden fazla hizmet döndürür ve yöntem tek bir fiyat gösterir.

BRL exchange rate: Frenet, Brezilya reali üzerinden teklif verir. Mağaza para biriminiz BRL değilse, 1 BRL'nin mağaza para biriminizde ne kadar olduğunu girin, örneğin 0.16. Teklif ve beyan edilen sipariş tutarı bu kurla çevrilir. Bu olmadan canlı teklifler kullanılmaz. Mağaza para birimi BRL ise gerekmez.

Sabit fiyatlar

API jetonu yoksa, Frenet'in hizmet vermediği ülkeler için ve Frenet fiyat döndürmediğinde (API çalışmıyor, CEP hizmet verilmiyor) kullanılır.

Price per country: Country, Price, XS, S, M, L ve XL sütunlarından oluşan bir tablo; fiyatlar mağaza para biriminizdedir. Satır eklemek için + Add country, satır silmek için çarpı (×) işaretine tıklayın. Boyut sütunları sepet ağırlığına bağlıdır: XS 1 kg'a kadar, S 2 kg'a kadar, M 3 kg'a kadar, L 5 kg'a kadar, XL 5 kg'ın üzerinde. Boyut sütunu boşsa Price kullanılır. Price değeri 0 ise o ülke için ücretsiz kargo anlamına gelir. Diğer tüm ülkeler için * Default kullanın. Hiçbir fiyatı olmayan satırlar kaydetme sırasında kaldırılır.

Fallback cost: Frenet ve tablo fiyat vermediğinde kullanılır. Yöntemi gizlemek için boş bırakın.

Fixed price applies: Per order fiyatı bir kez uygular. Per item (price × quantity) ise fiyatı ürün adediyle çarpar. Bu yalnızca sabit fiyatlar ve yedek ücret için geçerlidir. Frenet teklifleri zaten tüm sepeti kapsar.

Koşullar

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

Maximum weight (kg): sepet ağırlığı bu değerin üzerindeyse yöntemi gizler. Varsayılan: 30. 0 sınır olmadığı anlamına gelir.

Minimum order amount: yöntemi yalnızca sepet ara toplamı (indirimlerden sonra, vergiden önce) bu tutarın en az olduğunda gösterir. Her zaman göstermek için boş bırakın.

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

Free shipping from: kargonun ücretsiz olduğu sepet ara toplamı (indirimlerden sonra, vergiden önce). Asla ücretsiz kargo vermemek için boş bırakın.

Tax status: Taxable kargo ücretine WooCommerce vergisini ekler, None eklemez. Frenet fiyatları kargo firmasının nihai fiyatlarıdır; WooCommerce'in bunlara vergi eklemesini istemiyorsanız None seçin.

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

Kargo bölgeleri olmadan kullanılabilirlik

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

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

Gelişmiş

Debug log: her teklif isteğini ve yanıtını WooCommerce > Status > Logs altına, kaynak vfd-frenet olarak kaydeder. API hataları her zaman kaydedilir. Jeton hiçbir zaman kaydedilmez ve müşterinin CEP'i kısaltılır. İşiniz bittiğinde kapatın.

Remove data on uninstall: açıksa eklentiyi silmek tüm Frenet ayarlarını ve bölge yöntemlerini kaldırır. Eklentiyi devre dışı bırakmak ayarları asla silmez. Önbelleğe alınmış teklifler her zaman kaldırılır.

Ö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 sipariş tutarını ve hariç tutulan kargo sınıflarını kontrol eder. Ücretsiz kargo uygulanıyorsa yöntem sıfır fiyatla gösterilir ve Frenet'e istek gönderilmez.

Tam 8 haneli CEP'e sahip bir Brezilya adresi için eklenti Frenet'e çıkış ve varış CEP'lerini, her sepet ürününü (kg cinsinden ağırlık, cm cinsinden boyutlar, adet, SKU ve kategoriler), BRL cinsinden sipariş tutarını ve uygulanan ilk kuponu gönderir. CEP eksik olduğu sürece istek yapılmaz. Frenet, etkin kargo firmalarınızın hizmetlerini döndürür. Hata veren veya fiyatı olmayan hizmetler atlanır. Eklenti en ucuz veya en hızlı hizmeti seçer ve fiyatı mağaza para biriminize çevirir. Kargo firması, hizmet ve teslimat süresi siparişin kargo satırıyla birlikte kaydedilir ve yönetici sipariş ekranında gösterilir.

Her yanıt aynı sepet ve adres için 1 saat önbelleğe alınır. Başarısız bir istek ya da hiçbir etkin kargo firmasının hizmet vermediği bir CEP 10 dakika hatırlanır. API zaman aşımı 10 saniyedir. Bu durumlarda müşteri hata görmez: sabit fiyat veya yedek ücret kullanılır ya da ikisi de yoksa yöntem gizlenir. Brezilya dışındaki adresler için yalnızca sabit fiyatlar 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 tarifeleri hesaplar. Gönderi oluşturmaz, etiket basmaz veya paketleri takip etmez; Frenet bu özellikleri kendi panelinde sunar. Sepet başına bir Frenet hizmeti gösterir, birden fazla değil, ve teslim noktası ya da dolap sunmaz. Frenet yalnızca Brezilya içinde teklif verir; diğer ülkeler için sabit fiyatları kullanın.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Shipping > VibeFox Frenet 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 etkin olduğu tarihi ve domaininizi. 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 bir domainde çalışır. Anahtarı bir siteden kaldırmak, o domain'in yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Frenet müşterilere ödeme sayfasında gösterilmez. Oturum açmış mağaza yöneticileri ise onu (unlicensed — visible to admins only) etiketiyle görmeye devam eder; 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ı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

Frenet ö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çık ve ülke izinliyse). Ayarlar sayfasının üstündeki uyarılara, ağırlık sınırlarına, Minimum order amount ve Excluded shipping classes ayarlarına bakın. Yaygın nedenler: müşteri henüz tam 8 haneli bir CEP girmedi ve sabit fiyat yok, ya da Frenet bu rota için hizmet döndürmedi ve sabit fiyat yok.

Canlı teklifler görünmüyor: Debug log seçeneğini açın, ödeme sayfasını yenileyin ve WooCommerce > Status > Logs sayfasını, kaynak vfd-frenet olacak şekilde açın. Nedeni orada görürsünüz: reddedilen jeton (HTTP 401 veya 403), çıkış CEP'i olmaması, BRL döviz kurunun olmaması, Frenet panelinde etkin kargo firması olmaması veya atlanan hizmetlerin mesajları.

Mağazam euro veya dolar ile satış yapıyor: Frenet BRL cinsinden yanıt verir. BRL exchange rate değerini girin (1 BRL mağaza para biriminizde ne kadar?).

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

Lisans bloğu bir hata gösteriyor: bloktaki mesajı izleyin. Örneğin anahtar başka bir domainde zaten 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, anahtarı yeni domain 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 önbelleğe alınmış teklifleri temizler. Kaldırmak için Plugins sayfasında devre dışı bırakın ve silin. Bu eklentinin lisans anahtarı ve lisans durumu, önbelleğe alınmış teklifler ile 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 Frenet kargo firmasıyla olan kargo satırlarını korur.

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