VibeFox SmartPost 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, SimpleXML uzantısıyla birlikte (çoğu PHP kurulumunda bulunur).

SmartPost: API hesabı veya anahtarı gerekmez. Teslim alma noktası listesi, açık SmartPost yer listesinden gelir. SmartPost'un herkese açık bir fiyat API'si yoktur, bu nedenle kendi (sözleşmeli) fiyatlarınızı girersiniz. Gönderileri SmartPost (SmartPosti) iş hesabınızda oluşturun.

Ülkeler: SmartPost teslim alma noktaları Estonya, Letonya, Litvanya ve Finlandiya'da bulunur. Diğer hedef ülkeler için yöntem gösterilmez.

VibeFox lisans anahtarı: vibefox.net'ten 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_smartpost 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 SmartPost, 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. Sayfanın üstünde fiyat tablosunu (varsayılan fiyatlar zaten doldurulmuştur), kutu boyutlarını ve teslim alma noktası durumunu kontrol edin.

6. VibeFox SmartPost'u Estonya, Letonya, Litvanya ve/veya Finlandiya içeren bölge veya bölgelere WooCommerce > Settings > Shipping > Shipping zones üzerinden ekleyin ya da Ignore shipping zones seçeneğini açıp ülkeleri seçin.

Yapılandırma

Tüm ayarlar tek bir sayfada bulunur: WooCommerce > Settings > Shipping > VibeFox SmartPost. 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 bölge için müşterilerin gördüğü ad. Genel Method title alanını kullanmak için boş bırakın.

Sayfanın üstünde uyarılar sorunları ve teslim alma noktası durumunu gösterir. Hiçbir fiyat tanımlı değilse kırmızı bir uyarı görünür, çünkü bu durumda yöntem ödeme sayfasında gösterilmez. Pickup points available at checkout bloğu her ülke için kaç teslim alma noktasının kaç şehirde mevcut olduğunu gösterir. Ayrıca SmartPost listesi o an kullanılamadığı için kayıtlı bir kopyanın kullanıldığını, bir ülkenin hiç yüklenemediğini ve bir ülkenin fiyatı olmadığını bildirir. Refresh pickup point lists now düğmesi listeleri yeniden indirir ve yeni sayıları gösterir.

Genel

Enable/Disable: SmartPost'u tüm bölgelerde aynı anda açar veya kapatır.

Method title: müşterilere gösterilen kargo yöntemi adı. Bir bölge yönteminin Title alanı bunun yerine geçer. Varsayılan: SmartPost parcel locker.

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 table: her ülke (Estonya, Letonya, Litvanya, Finlandiya) için bir satır; her kutu boyutu S, M, L ve XL için bir fiyat ve bir Free from sütunu içerir. 0 ücretsiz anlamına gelir. Boş bir hücre, o kutu boyutunun sunulmadığı anlamına gelir: paket o kutuyu gerektirdiğinde yöntem gizlenir. Tüm hücreleri boş olan bir ülkeye hizmet verilmez. Free from, o ülkede SmartPost'un ücretsiz olduğu sepet tutarıdır; ücretsiz kargo yoksa boş bırakın. Sayı olmayan fiyatlar kaydetmeden sonra bildirilir ve boş bırakılır. Varsayılan fiyatlar: Estonya 3.50, Letonya 4.00, Litvanya 4.00, Finlandiya 5.00 (her kutu için).

Box sizes (cm): her kutunun iç ölçüsü, en küçük kenar önce olacak şekilde (Side 1 (smallest), Side 2, Side 3 (largest)). Ürünün kenarları aynı şekilde sıralanır ve yan yana karşılaştırılır; sığan en küçük kutu kullanılır. Boyutları olmayan ürünler S kutusuna sığar. Hiçbir kutuya sığmayan bir paket yöntemi gizler. Ürün boyutları, mağazanın boyut biriminden dönüştürülür. Varsayılan değerler: S 12 x 36 x 60, M 20 x 36 x 60, L 36 x 38 x 60, XL 36 x 60 x 60. Pozitif sayı olmayan boyutlar kaydetmeden sonra bildirilir ve değiştirilmez.

Calculation: fiyatın nasıl hesaplandığı.

Kullanılabilirlik

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

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

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: SmartPost'u aşağıdaki ülkeler için, bir bölgeye eklemeden sunar. Kapalıyken ülkeler, yöntemin eklendiği kargo bölgeleri tarafından belirlenir. Bu seçenek önerilir.

Countries (without zones): bu mod için hedef ülkeler; Estonya, Letonya, Litvanya ve Finlandiya arasından seçilir. Bu alan yalnızca Ignore shipping zones açıkken kullanılır. Yöntemi dört ülkede de sunmak için boş bırakın.

Teslim alma noktaları

Pickup point types: müşterinin seçebileceği SmartPost noktaları: Parcel lockers (APT), Parcel boxes (IPB), Parcel shops (PUDO) ve Posti post offices (Finland). Dolapları, kutuları ve paket noktalarını sunmak için boş bırakın (varsayılan). Hangi türlerin bulunduğu ülkeye göre değişir: örneğin Letonya'da yalnızca paket kutuları vardır ve postaneler yalnızca Finlandiya'da bulunur.

City order: açıkken büyük şehirler önce gelir (Tallinn, Riga, Vilnius, Helsinki ve diğer büyük şehirler), ardından kalanlar alfabetik sıralanır. Kapalıyken tüm şehirler alfabetik sıralanır.

Gelişmiş

Debug log: fiyat hesaplamasının ve teslim alma noktası listesinin ayrıntılarını WooCommerce > Status > Logs altına (kaynak vfd-smartpost) kaydeder. Kullanılamayan teslim alma noktası listesi gibi hatalar her zaman kaydedilir. Müşteri verileri kaydedilmez.

Remove data on uninstall: açıkken eklentiyi silmek ayarları, bölge yöntemlerini ve önbelleğe alınmış teslim alma noktalarını kaldırır. Eklentiyi devre dışı bırakmak ayarları asla silmez. Siparişlerde kayıtlı teslim alma noktası korunur.

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

Müşteri bir teslimat adresi girdiğinde WooCommerce eklentiden bir tarife ister. Eklenti yalnızca Estonya, Letonya, Litvanya ve Finlandiya için çalışır. Sepetin ağırlığını, minimum sepet tutarını ve hariç tutulan kargo sınıflarını kontrol eder, paket için kutuyu bulur ve fiyatını gönderim ülkesinin satırından alır. Kutunun fiyatı yoksa ya da paket hiçbir kutuya sığmıyorsa yöntem gizlenir. Ülkenin teslim alma noktası yoksa (liste yüklenemedi ve kayıtlı bir kopya yok), yöntem yine gizlenir; böylece müşteri asla tamamlanamayacak bir ödeme sayfası görmez. Sepet tutarı ülkenin Free from değerine ulaşırsa fiyat 0 olur.

Her ülkenin teslim alma noktası listesi 24 saat önbellekte tutulur ve son başarılı listenin bir kopyası saklanır. Başarısız bir indirme 15 dakika hatırlanır; böylece ödeme sayfası her yenilemede listeyi beklemez. İndirme zaman aşımı 15 saniyedir. Aynı şehrin farklı yazımları (örneğin Riga ve Rīga) tek bir şehir olarak gösterilir.

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 birimi dönüşümü yapmaz.

Eklenti SmartPost fiyatlarını sorgulamaz, gönderi oluşturmaz, etiket yazdırmaz, kurye çağırmaz ve paketleri izlemez. Gönderileri SmartPost (SmartPosti) iş hesabınızda oluşturun. Kapıya kurye teslimatı bu yöntemin parçası değildir ve harita görünümü yoktur.

Teslim alma noktaları

Müşteri SmartPost'u seçtiğinde yöntemin altında iki liste görünür: -- Select city -- ve -- Select pickup point --. Listeler her zaman gönderim ülkesine aittir. Klasik ödeme sayfasında bu, teslimat adresinin ülkesidir; sipariş farklı bir adrese gönderilmiyorsa fatura adresinin ülkesidir. Ülke değiştiğinde listeler yeniden oluşturulur. Blok ödeme sayfasında listeler teslimat adresinin ülkesini izler. Teslimat adresindeki şehir, listedeki bir şehirle eşleştiğinde önceden seçilir. Her nokta adı ve adresiyle gösterilir. Seçim ödeme sayfası boyunca hatırlanır, bu nedenle ödeme sayfası yenilendiğinde kaybolmaz.

Teslim alma noktası zorunludur. Klasik ödeme sayfasında müşteri Please select a SmartPost pickup point in the shipping country. mesajını görür. Blok ödeme sayfasında, bir nokta seçilene kadar Place order engellenir. İki ödeme sayfasında da sunucu noktayı gönderim ülkesinin listesine göre yeniden kontrol eder; bu nedenle sahte veya güncel olmayan bir nokta kimliği ya da başka bir ülkenin noktası reddedilir. Ülkenin listesi geçici olarak kullanılamıyorsa müşteri bir mesaj görür ve başka bir kargo yöntemi seçebilir.

Noktanın kimliği, adı, şehri ve ülkesi siparişe kaydedilir. Bunlar sipariş ekranında teslimat adresinin altında (yer kimliğiyle birlikte), sipariş alındı sayfasında, My account > Orders içinde ve sipariş e-postalarında (HTML ve düz metin) SmartPost pickup point olarak gösterilir.

Bir siparişin noktasını değiştirmek için siparişi açın ve SmartPost pickup point yanındaki Change düğmesine tıklayın. Siparişin gönderim ülkesinden bir şehir ve bir nokta seçin. Yeni nokta hemen kaydedilir ve bir sipariş notu eski ile yeni noktayı kaydeder.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Shipping > VibeFox SmartPost 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, 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ı hakkını serbest bırakmaz. Bu hakkı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar yoksa SmartPost ödeme sayfasında müşterilere gösterilmez. Oturum açmış mağaza yöneticileri yine de görür; bunun yanında (unlicensed — visible to admins only) ibaresi bulunur. 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

SmartPost ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, gönderim ülkesinin Estonya, Letonya, Litvanya veya Finlandiya olduğunu ve yöntemin müşterinin ülkesine ait bölgeye eklendiğini kontrol edin (ya da Ignore shipping zones açıksa ve ülke izinliyse). Ayarlar sayfasını açın: bir uyarı, hiçbir fiyatın tanımlı olmadığını, bir ülkenin fiyatı bulunmadığını veya bir ülkenin teslim alma noktası bulunmadığını açıklar. Ayrıca ağırlık sınırlarını, Minimum cart total, Excluded shipping classes ve kutu boyutlarını kontrol edin: hiçbir kutuya sığmayan bir paket ya da boş fiyat hücreli bir kutu yöntemi gizler. Debug log açıksa, WooCommerce > Status > Logs (kaynak vfd-smartpost) yöntemin neden gizlendiğini gösterir.

Müşteri başka bir ülkenin noktalarını görüyor: listeler teslimat adresini izler. Teslimat adresinde hangi ülkenin girildiğini kontrol edin (ya da sipariş farklı bir adrese gönderilmiyorsa fatura adresinde). Başka bir ülkenin noktası, sipariş verilirken reddedilir.

Bir ülke için teslim alma noktası yok: SmartPost listesi yüklenemedi ve kayıtlı bir kopya yok. Eklenti her 15 dakikada bir yeniden dener. Daha sonra Refresh pickup point lists now düğmesine tıklayın. Ayrıca Pickup point types alanında o ülkede bulunan bir türün seçili olduğunu kontrol edin.

Teslim alma noktası listesi güncel değil: ayarlar sayfasında Refresh pickup point lists now düğmesine tıklayın. Listeler ayrıca her 24 saatte bir yeniden indirilir.

Müşteri siparişi tamamlayamıyor: gönderim ülkesinin bir teslim alma noktası seçilmelidir. Müşteri "The SmartPost pickup point list is temporarily unavailable" mesajını görürse, o ülkenin şu anda kullanılabilir noktası yoktur.

Fiyatlar hangi para biriminde: mağaza para biriminizde. Eklenti para birimi dönüşümü yapmaz.

Geliştiriciler için: vfd_smpt_places_url filtresi bir ülkenin yer listesinin URL'sini değiştirir (argümanlar: URL, ülke kodu); örneğin aynı XML'i döndüren bir yansıya yönlendirmek için kullanılabilir.

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 hak 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şılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Kaldırma

Eklentiyi devre dışı bırakmak tüm ayarları korur. Yalnızca önbelleğe alınmış teslim alma noktası listeleri temizlenir. Kaldırmak için eklentiyi devre dışı bırakın ve Plugins sayfasından silin. Bu eklentinin lisans anahtarı ve lisans durumu ile önbellekler her zaman kaldırılır. Ayarlar, bölge yöntemleri ve teslim alma noktası listelerinin kayıtlı kopyaları 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ı teslim alma noktası asla silinmez ve mevcut siparişler kargo satırlarını korur.

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