VibeFox Omniva 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.

Omniva: bir API hesabı gerekmez. Omniva'nın herkese açık bir fiyat API'si yoktur. Omniva OMX API'si yalnızca sözleşmeli müşterilere açıktır ve bu eklenti tarafından kullanılmaz; bu nedenle kendi (sözleşmeli) fiyatlarınızı girersiniz. Paketleri Omniva iş hesabınıza kaydedin.

Parcel machine list: eklenti, açık Omniva konum dosyasını omniva.ee adresinden indirir (anahtar veya sözleşme gerekmez). Sunucunuz www.omniva.ee adresine giden HTTPS isteklerini yapabilmelidir.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar 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_omniva klasörünü FTP ile /wp-content/plugins/ dizinine de yükleyebilirsiniz.

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

3. Ayarları açın: WooCommerce > Settings > Shipping > VibeFox Omniva; 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 (bkz. Lisans anahtarı).

5. Ülke ve paket boyutuna göre fiyatları, paket boyutlarını ve Parcel machine list durum satırını kontrol edin.

6. VibeFox Omniva eklentisini WooCommerce > Settings > Shipping > Shipping zones altında Estonya, Letonya ve/veya Litvanya bölgenize 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 Omniva. 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ölge için müşterinin gördüğü ad. Genel Method title değerini kullanmak için boş bırakın.

Sayfanın üstünde bildirimler sorunları gösterir. Hiçbir fiyat ayarlanmadığında veya paket otomatı listesi indirilemeyip kayıtlı bir kopya yoksa kırmızı bir bildirim görünür; bu durumda yöntem ödeme sayfasında gösterilmez. Liste o anda güncellenemediğinde ve kayıtlı kopya kullanıldığında sarı bir bildirim görünür. Okunamayan sayılar kaydetmeden sonra bildirilir ve kaydedilmez.

Genel

Enable/Disable: Omniva'yı tüm bölgelerde birlikte açar veya kapatır.

Method title: müşterilere gösterilen kargo yöntemi adı. Bir bölge yönteminin Title değeri bunun yerine geçer. Varsayılan: Omniva parcel machine.

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

Fiyatlar (mağaza para biriminizde; ondalıklar 3.50 veya 3,50 olarak yazılabilir)

Price by parcel size: Estonya, Letonya ve Litvanya için birer satır; S, M, L, XL ve Free from sütunlarıyla. Hedef ülke için her Omniva paket boyutunun fiyatını girin. Boş bir hücre, o boyutun ülke için sunulmadığı anlamına gelir: paket bu boyuta ihtiyaç duyduğunda yöntem gizlenir. 0 ücretsiz anlamına gelir. Free from, o ülkeye teslimatın ücretsiz olduğu sepet tutarıdır (indirimlerden sonra, sepette gösterildiği gibi); ücretsiz kargo yoksa boş bırakın. Kendi fiyatlarınızı kaydedene kadar tablo Estonya için 3.50, Letonya ve Litvanya için 4.00 ile başlar. WooCommerce vergileri açıkken her fiyatın yanındaki küçük -% düğmesi, girilen fiyattan mağaza ülkenizin KDV'sini çıkarır (KDV dahil bildiğiniz fiyatlar için).

Calculation: paket boyutunun ve fiyatın nasıl belirlendiği.

Parcel sizes (cm): her boyutun en büyük ölçüleri; Smallest side, Middle side ve Largest side olarak. Ürün ölçüleri aynı şekilde sıralanır ve yan yana karşılaştırılır; değerler kaydedilirken sıralanır. Ürün ölçüleri mağaza biriminden cm'ye dönüştürülür. Ölçüsü olmayan ürünler S boyutuna sığar. Hiçbir boyut uymazsa yöntem gizlenir. Varsayılanlar: S 9 x 38 x 64, M 19 x 38 x 64, L 38 x 39 x 64, XL 39 x 64 x 64. Bunları güncel Omniva paket boyutlarıyla karşılaştırın.

Kullanılabilirlik

Minimum weight (kg): sepet bundan hafifse yöntemi gizler. Boş veya 0 sınır olmadığı anlamına gelir.

Maximum weight (kg): sepet (veya Per item ile tek bir ürün) bundan ağırsa yöntemi gizler. Omniva paket otomatları 30 kg'a kadar paketleri kabul eder. Varsayılan: 30. 0 sınır olmadığı anlamına gelir. Mağazanın ağırlık birimi kg'a dönüştürülür.

Minimum cart total: yöntemi yalnızca bu sepet tutarından itibaren gösterir. Her zaman göstermek için boş bırakın.

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

Ignore shipping zones: Omniva'yı bir bölgeye eklemeden aşağıdaki ülkeler için sunar. Kapalıyken ülkeler, yöntemin eklendiği kargo bölgeleri tarafından belirlenir. Kapalı tutulması önerilir.

Countries (without zones): bu mod için hedef ülkeler. Bu alan yalnızca Ignore shipping zones açıkken kullanılır. Tüm kargo ülkeleri için boş bırakın. Her modda Omniva yalnızca paket otomatı bulunan yerlerde sunulur: Estonya, Letonya ve Litvanya.

Paket otomatları

Post offices: aynı listede Omniva postanelerini de sunar. Omniva, Estonya için postane listeler. Varsayılan olarak kapalıdır.

City order: önce en büyük şehirleri (Tallinn, Riga, Vilnius ve diğerleri), ardından kalanları alfabetik olarak gösterir. Varsayılan olarak açıktır. Kapalıyken şehirler alfabetik sıralanır.

Parcel machine list: ülkelere göre paket otomatı sayısını (etkinse postane sayısını da) ve omniva.ee'den son indirme zamanını gösteren bir durum satırı. Listeyi hemen indirmek için Update the list now düğmesine tıklayın; omniva.ee yanıt vermezse kayıtlı kopya korunur.

Gelişmiş

Debug log: fiyat hesaplama ve paket otomatı listesi ayrıntılarını WooCommerce > Status > Logs (kaynak vfd-omniva) içine kaydeder. Kullanılamayan paket otomatı listesi gibi hatalar her zaman kaydedilir. Müşteri verileri kaydedilmez.

Remove data on uninstall: açıkken eklentiyi silmek ayarları, bölge yöntemlerini ve kayıtlı paket otomatı listesini kaldırır. Eklentiyi devre dışı bırakmak hiçbir zaman ayarları silmez. Siparişlerde kayıtlı paket otomatı korunur.

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

Müşteri Estonya, Letonya veya Litvanya'da bir teslimat adresi girdiğinde WooCommerce eklentiden bir ücret ister. Eklenti sepet ağırlığını, minimum sepet tutarını ve hariç tutulan kargo sınıflarını kontrol eder, ardından paket boyutunu ürün ölçülerinden belirler. Paket hiçbir boyuta sığmazsa, boyutun ülke için fiyatı yoksa veya uygun bir paket otomatı yoksa yöntem gizlenir; böylece müşteri asla tamamlanamayacak bir ödeme sayfası görmez. Sepet tutarı ülkenin Free from değerine ulaşırsa fiyat 0 olur. Paket boyutu siparişin kargo satırına Omniva parcel size olarak kaydedilir.

Paket otomatı listesi günde bir kez omniva.ee'den indirilir ve eklenti klasöründe değil WordPress veritabanında saklanır. İndirme başarısız olursa kayıtlı kopya çalışmaya devam eder ve bir sonraki deneme 15 dakika sonra yapılır; böylece ödeme sayfası her yenilemede omniva.ee'yi beklemez. İndirme zaman aşımı 15 saniyedir.

Yöntem klasik ödeme sayfasında ve Sepet ile Ödeme bloklarında çalışır. WooCommerce High-Performance Order Storage (HPOS) ile uyumludur. Fiyatlar mağaza para biriminizdedir. Eklenti para birimlerini dönüştürmez.

Eklenti Omniva fiyatlarını sorgulamaz, gönderi kaydetmez, etiket basmaz, kurye çağırmaz veya paketleri takip etmez. Paketleri Omniva iş hesabınıza kaydedin. Kapıya kurye teslimatı bu yöntemin parçası değildir.

Paket noktaları

Müşteri Omniva'yı seçtiğinde yöntemin altında iki liste görünür: -- Select city -- ve -- Select parcel machine --. Yalnızca teslimat ülkesinin şehirleri ve paket otomatları gösterilir; müşteri ülkeyi değiştirdiğinde listeler de değişir. Estonya'da şehirler ilçelerdir ve Tallinn, Tartu ve Pärnu ayrı olarak listelenir; Letonya ve Litvanya'da şehirler ve belediyeler yer alır. Teslimat adresindeki şehir, listedeki bir şehirle eşleşirse önceden seçilir. Her paket otomatı adı ve adresiyle gösterilir. Seçim ödeme sürecinde hatırlanır, bu nedenle ödeme sayfası yenilendiğinde kaybolmaz.

Paket otomatı zorunludur. Klasik ödeme sayfasında müşteri Please select an Omniva parcel machine. mesajını görür. Blok ödeme sayfasında, bir paket otomatı seçilene kadar Place order engellenir. Her iki ödeme sayfasında da sunucu paket otomatını listeye karşı yeniden kontrol eder; bu nedenle sahte bir kimlik veya başka bir ülkenin paket otomatı reddedilir.

Paket otomatının kimliği, adı, şehri ve ülkesi siparişe kaydedilir. Bunlar sipariş ekranında teslimat adresinin altında (paket otomatı kimliğiyle), sipariş alındı sayfasında, My account > Orders bölümünde ve sipariş e-postalarında (HTML ve düz metin) Omniva parcel machine olarak gösterilir.

Bir siparişin paket otomatını değiştirmek için siparişi WooCommerce > Orders bölümünde açın, paket otomatının yanındaki Change düğmesine tıklayın, siparişin teslimat ülkesinde bir şehir ve paket otomatı seçin ve Save parcel machine düğmesine tıklayın. Bir sipariş notu eski ve yeni paket otomatını kaydeder.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloku WooCommerce > Settings > Shipping > VibeFox Omniva 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 düğmesini 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ın bir siteden kaldırılması, o sitenin alan adı hakkını serbest bırakmaz. Hakkı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Omniva ö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 sona erdiğinde eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum arka planda otomatik olarak yeniden kontrol edilir.

Sorun giderme

Omniva ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, teslimat ülkesinin Estonya, Letonya veya Litvanya olduğunu ve yöntemin müşterinin ülkesinin bölgesine eklendiğini kontrol edin (veya Ignore shipping zones açık olmalı ve ülke izinli olmalıdır). Ayarlar sayfasını açın: kırmızı bir bildirim, hiçbir fiyat ayarlanmadığını ya da paket otomatı listesinin bulunmadığını açıklar. Ayrıca ürün ölçülerini (XL boyutundan büyük bir paket veya fiyat hücresi boş bir boyut yöntemi gizler), ağırlık sınırlarını, Minimum cart total ve Excluded shipping classes ayarlarını kontrol edin. Debug log açıkken WooCommerce > Status > Logs (kaynak vfd-omniva), yöntemin neden gizlendiğini gösterir.

Paket otomatı yok: liste omniva.ee'den indirilemedi ve kayıtlı bir kopya yok. Eklenti her 15 dakikada bir yeniden dener. Update the list now düğmesine tıklayın; başarısız olursa sunucunuzun www.omniva.ee adresine erişebildiğini kontrol edin ve hatayı WooCommerce > Status > Logs bölümünde görün.

Yeni bir paket otomatı eksik: liste günde bir kez güncellenir. Hemen indirmek için Update the list now düğmesine tıklayın.

Yanlış fiyat alınıyor: fiyat, ürün ölçülerinden belirlenen paket boyutuna bağlıdır. Ürün ölçülerini, Calculation ve Parcel sizes (cm) ayarlarını kontrol edin. Debug log açıkken günlük seçilen boyutu ve fiyatı gösterir.

Müşteri siparişi tamamlayamıyor: bir paket otomatı seçilmelidir. Müşteri «The Omniva parcel machine list is temporarily unavailable» mesajını görüyorsa, şu anda kullanılabilir paket otomatı yoktur; bkz. «Paket otomatı yok».

Fiyatlar hangi para biriminde: mağaza para biriminizde. Eklenti para birimlerini dönüştürmez.

Geliştiriciler için: vfd_omniva_locations_url filtresi konum dosyasının adresini (Omniva biçiminde CSV) değiştirir, vfd_omniva_countries filtresi hedef ülkeler listesini değiştirir (varsayılan EE, LV, LT).

Lisans bloku 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, 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ı ve kayıtlı paket otomatı listesini korur. Kaldırmak için eklentiyi devre dışı bırakın ve Plugins sayfasında silin. Bu eklentinin lisans anahtarı, lisans durumu ve önbellekler her zaman kaldırılır. Ayarlar, bölge yöntemleri ve kayıtlı paket otomatı listesi yalnızca Remove data on uninstall açıksa kaldırılır. Aksi halde sonraki bir yeniden kurulum için saklanırlar. Siparişlerde kayıtlı paket otomatı asla silinmez ve mevcut siparişler kargo satırlarını korur.

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