VibeFox Packeta for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

WooCommerce: 7.0 veya üzeri, kurulu ve etkin olmalıdır. WooCommerce olmadan eklenti etkinleştirilemez.

PHP: 8.0 veya üzeri.

Packeta API anahtarı: Packeta müşteri bölümünde (client.packeta.com), Client support altında bulabilirsiniz. 16 harf ve rakamdan oluşur. Widget'ın ödeme sayfasında açılması için buna ihtiyaç duyar; bu nedenle kargo yöntemi müşterilere yalnızca API anahtarı girildikten sonra gösterilir.

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 sayfasına gidin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. vfd_packeta 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 Packeta veya 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. Packeta API key değerinizi ve fiyatlarınızı girin: en az bir Country prices satırı (örneğin * Default) veya bir Fallback cost. Kaydedin. Sayfa, Packeta'nın anahtarı kabul edip etmediğini gösterir.

6. WooCommerce > Settings > Shipping > Shipping zones altında, Çek Cumhuriyeti, Slovakya, Macaristan veya Romanya için VibeFox Packeta yöntemini kargo bölgelerinize ekleyin ya da Ignore shipping zones seçeneğini açın.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Shipping > VibeFox Packeta. 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ölgedeki müşterilerin gördüğü ad. Genel Name ayarını kullanmak için boş bırakın.

Yöntem yalnızca Packeta'nın kendi teslim noktası ağındaki ülkeler için sunulur: CZ, SK, HU ve RO. Ayarların üstünde sayfa, API anahtarı kontrolünün sonucunu ve sorunlara ilişkin uyarıları gösterir; örneğin API anahtarı yoksa, fiyat yoksa veya seçilen ülkeler Packeta ağının dışındaysa.

Tüm fiyat ve sınırlar ondalık ayırıcı olarak virgül veya nokta kabul eder (4,99 veya 4.99). Geçersiz bir sayı bir mesajla reddedilir ve önceki değer korunur.

Genel

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

Name: müşteriye gösterilen kargo yönteminin adı. Bir bölge, kendi Title değeriyle bunu geçersiz kılabilir. Varsayılan: Packeta pickup point.

API key: client.packeta.com > Client support bölümündeki Packeta API anahtarınız. 32 karakterlik API şifresini de yapıştırabilirsiniz: yalnızca API anahtarı olan ilk 16 karakter kaydedilir. API anahtarı herkese açıktır: widget'ı açmak için müşterinin tarayıcısına gönderilir. Yeni bir anahtar kaydettiğinizde Packeta taşıyıcı akışıyla kontrol edilir ve sayfa Packeta API key verified mesajını ya da Packeta'nın anahtarı reddettiğini gösterir. Kontrol yapılamazsa anahtar kaydedilir ve bir sonraki kaydetmenizde yeniden kontrol edilir.

Widget language: teslim noktası widget'ının dili. Store / visitor language (varsayılan) sayfanın dilini izler. Dili Çekçe, Slovakça, Macarca, Rumence, İngilizce, Almanca, Lehçe veya Ukraynaca olarak sabitleyebilirsiniz.

Pickup point types: widget'ın sunduğu Packeta noktaları.

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

Fiyatlar

Packeta'nın herkese açık bir ücret API'si yoktur. Fiyatlar bu tablodan gelir ve mağaza para biriminde girilir.

Calculation type: Per order ücreti bir kez alır. Per item (price x quantity) ücreti sepetteki kargolanabilir ürün sayısıyla çarpar.

Country prices: hedef ülke ve koli ağırlığı başına bir fiyat. Satır eklemek için + Add country, satır silmek için çarpı işaretine tıklayın. Her satırda bir Price ve ağırlık sütunları vardır: XS 1 kg'a kadar, S 1–2 kg, M 2–3 kg, L 3–5 kg ve XL 5 kg'ın üzeri. Değeri 0 bırakılan bir ağırlık sütunu Price sütununu kullanır. * Default satırı, kendi satırı olmayan ülkeler için kullanılır. Yeni bir satır, tüm fiyatları 0 olan bir * Default olarak başlar; bu da ücretsiz kargo anlamına gelir. Kaydetmeden önce ülkeyi seçin ve fiyatları girin ya da satırı silin. Aynı ülke iki satırda varsa, kaydederken yalnızca ilki tutulur.

Fallback cost: ülke tablosunda hedef için satır yoksa ve * Default satırı da yoksa kullanılır. Yöntemin orada sunulmaması için boş bırakın.

Free shipping from: Packeta teslimatının ücretsiz olduğu sepet ara toplamı (indirimler sonrası, vergi hariç). Yalnızca bir fiyatın tanımlı olduğu yerlerde geçerlidir: bir ülke satırı, * Default satırı veya yedek ücret. Hiçbir zaman ücretsiz kargo sunulmaması için boş bırakın.

Kullanılabilirlik

Minimum weight (kg): sepet bundan hafifse yöntemi gizler. Sepet ağırlığı mağazanızın ağırlık biriminden dönüştürülür. Boş veya 0, sınır olmadığı anlamına gelir.

Maximum weight (kg): sepet bundan ağırsa yöntemi gizler. Varsayılan: 15. Packeta teslim noktaları ve Z-BOX'lar genellikle 15 kg'a kadar paketleri kabul eder; Packeta sözleşmenizi kontrol edin. Boş veya 0, sınır olmadığı anlamına gelir.

Minimum cart subtotal: yöntemi yalnızca sepet ara toplamı (indirimler sonrası, vergi hariç) bu tutara ulaştığında sunar.

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

Ignore shipping zones: açıkken yöntem, uygun kargo bölgesine eklenmemiş olsa bile aşağıda seçilen ülkeler için sunulur. Kapalıyken yöntem yalnızca eklendiği bölgelerde sunulur.

Countries (ignore zones mode): bu mod için hedef ülkeler. Tüm Packeta ülkelerini kullanmak için boş bırakın. Packeta teslim noktası ağının dışındaki ülkeler atlanır. Bu alan yalnızca Ignore shipping zones açıkken kullanılır.

Gelişmiş

Debug log: tarife hesaplamalarını ve teslim noktası seçimlerini WooCommerce > Status > Logs altına (kaynak "vfd-packeta") yazar. Müşterilerin kişisel verileri ve API anahtarı günlüğe yazılmaz. Başarısız API anahtarı kontrolleri her zaman günlüğe yazılır. İşiniz bittiğinde günlüğü kapatın.

Remove data on uninstall: açıkken eklentiyi silmek, ayarları ve bu yöntemin bölge örneklerini kaldırır. Eklentiyi devre dışı bırakmak hiçbir şeyi silmez. Siparişlerde kaydedilen teslim noktası her zaman korunur.

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

Müşteri bir teslimat adresi girdiğinde WooCommerce eklentiden bir tarife ister. Eklenti koşulları kontrol eder: teslimat ülkesi Packeta ağında mı, API anahtarı, sepet ağırlığı, minimum sepet ara toplamı ve hariç tutulan kargo sınıfları. Fiyat önce ülke tablosundan, sonra yedek ücretten alınır. Fiyat yoksa yöntem gizlenir. Ücretsiz kargo geçerliyse müşteri yöntemi ücretsiz olarak görür.

Müşteri Packeta yöntemini seçtiğinde, altında Choose pickup point düğmesi belirir. Bu düğme, müşterinin tarayıcısında resmi Packeta widget'ını hedef ülke, sepet ağırlığı, seçilen nokta türleri ve widget dili ile açar. Müşteri bir nokta seçtikten sonra noktanın adı ve adresi yöntemin altında gösterilir ve düğme Change pickup point olarak değişir. Seçim, ödeme sayfası yenilendiğinde veya sayfa yeniden yüklendiğinde müşterinin oturumunda hatırlanır.

Sunucunuz ödeme sırasında Packeta'dan hiçbir şey istemez. Widget betiği widget.packeta.com adresinden yüklenir. Betik engellenirse (bir reklam veya gizlilik engelleyici, bir içerik güvenlik politikası ya da bir Packeta kesintisi nedeniyle), müşteri şu mesajı görür: "The Packeta pickup point widget could not be loaded. Please reload the page or choose another shipping method."

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

Packeta fiyatları anlık olarak sorgulanmaz; tablonuzdan gelir. Eklenti Packeta gönderileri oluşturmaz, etiket yazdırmaz veya koli takibi yapmaz; ayrıca varsayılan olarak adrese teslimat veya iş ortağı taşıyıcıların teslim noktalarını sunmaz. Siparişteki teslim noktası kimliğini, alışık olduğunuz yöntemle, örneğin client.packeta.com üzerinden içe aktarma ile Packeta'ya iletin.

Teslim noktaları

Teslim noktası zorunludur. Müşteri bir nokta seçmeden siparişi verirse ödeme "Please choose a Packeta pickup point." mesajıyla durdurulur. Seçilen nokta teslimat adresinden farklı bir ülkedeyse ödeme "The selected Packeta pickup point is not in your shipping country. Please choose a pickup point again." mesajıyla durdurulur. Her iki kontrol de klasik ve blok ödeme sayfasında sunucuda çalışır. Eklenti nokta kimliğini Packeta ile doğrulamaz; yalnızca bir noktanın seçilip seçilmediğini ve ülkesinin eşleşip eşleşmediğini kontrol eder.

Nokta, sipariş oluşturulduğunda siparişle birlikte kaydedilir:

Yönetici sipariş ekranı: teslimat adresinin altında, Packeta pickup point başlığıyla nokta adı, adresi, Pickup point ID ve ülke. Packeta siparişinde nokta yoksa ekran "No pickup point was selected for this order." mesajını gösterir.

Teşekkür sayfası ve sipariş görünümü: Packeta pickup point: ile nokta adı ve adresi.

Sipariş e-postaları: HTML ve düz metin e-postalarında nokta adı ve adresi. Yönetici e-postaları ayrıca Pickup point ID bilgisini de içerir.

Veritabanında nokta, _vfd_pckt_point_id, _vfd_pckt_point_name (ad ve adres) ve _vfd_pckt_point_country sipariş meta verilerinde saklanır.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Shipping > VibeFox Packeta 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 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 Packeta ödeme sayfasında müşterilere gösterilmez. Oturum açmış mağaza yöneticileri ise yöntemi (unlicensed — visible to admins only) işaretiyle görmeye devam eder; 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

Packeta ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, API key alanının girildiğini ve hedef ülkenin CZ, SK, HU veya RO olduğunu kontrol edin. Ülke için bir fiyat tanımlı mı (ülke satırı, * Default satırı veya Fallback cost), ağırlık ve ara toplam sınırları, Excluded shipping classes ve yöntemin uygun bölgeye eklenip eklenmediğini (ya da Ignore shipping zones seçeneğinin açık olup olmadığını) kontrol edin. Ayarlar sayfası yapılandırma sorunlarını en üstte listeler. Nedenini WooCommerce > Status > Logs altında görmek için Debug log seçeneğini açın.

Packeta API anahtarını reddetti: client.packeta.com > Client support bölümünden API anahtarını yeniden kopyalayın ve kaydedin. Bu yapılana kadar widget ödeme sayfasında açılamaz.

Widget açılmıyor: Packeta betiği bir reklam veya gizlilik engelleyici, bir içerik güvenlik politikası ya da bir Packeta kesintisi tarafından engelleniyor. İçerik güvenlik politikanızda widget.packeta.com adresine izin verin. Geliştiriciler, vfd_pckt_widget_url filtresiyle betik URL'sini değiştirebilir.

Kargo yanlışlıkla ücretsiz görünüyor: Country prices içinde Price değeri 0 olan satırları kontrol edin; özellikle + Add country ile eklenmiş ve doldurulmamış bir * Default satırını.

Diğer ülkeler veya taşıyıcılar: varsayılan olarak yöntem CZ, SK, HU ve RO için çalışır. Geliştiriciler vfd_pckt_countries filtresiyle ülke ekleyebilir ve vfd_pckt_widget_options filtresiyle widget'a taşıyıcı kimliklerini iletebilir.

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 verileri korur. Eklentiyi tamamen kaldırmak için devre dışı bırakın ve Plugins sayfasından silin. Bu eklentinin lisans anahtarı ve lisans durumu, kayıtlı API anahtarı kontrolüyle birlikte 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 kargo satırlarını ve kayıtlı teslim noktasını korur.

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