VibeFox DHL Packstation for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

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

PHP: 8.0 veya üzeri.

DHL API key: teslim noktaları listesi, ücretsiz DHL Location Finder API'sinden gelir. DHL geliştirici portalına (developer.dhl.com) kaydolun, bir uygulama oluşturun, "Location Finder - Unified" API'sini ekleyin ve uygulamanın API anahtarını kopyalayın. Bu API için DHL ile ticari sözleşme gerekmez. Anahtar olmadan yöntem ödeme sayfasında gizlenir. DHL uygulamanızın istek sınırına dikkat edin: her yeni posta kodu veya şehir araması bir API isteğidir.

VibeFox license key: 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_dhl_packstation 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 > DHL Packstation, 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. DHL API anahtarını yapıştırın, kaydedin, Test API key düğmesine tıklayın, teslim noktası türlerini seçin ve ülke fiyatlarını girin (bkz. Yapılandırma).

6. WooCommerce > Settings > Shipping > Shipping zones bölümünde DHL Packstation yöntemini bir kargo bölgesine (örneğin Almanya) ekleyin ya da Ignore shipping zones seçeneğini açın.

Yapılandırma

Tüm ayarlar tek bir sayfada bulunur: WooCommerce > Settings > Shipping > DHL Packstation. Bu ayarlar tüm kargo bölgelerinde geçerlidir. Yöntemi bir bölgeye eklediğinizde, bölge penceresinde yalnızca bir alan bulunur:

Title (zone): bu bölge için ödeme sayfasında görünen kargo seçeneğinin adı. Genel Name değerini kullanmak için boş bırakın.

Ayarların üstündeki uyarılar, DHL API anahtarının boş olduğunu ve ülke fiyat girişlerinin doğru biçimde olmadığını bildirir. Ayarları her kaydettiğinizde teslim noktası önbelleği temizlenir.

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ı. Varsayılan: DHL Packstation. Bir bölge, kendi Title değeriyle bunu değiştirebilir.

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

DHL Location Finder API

DHL API key: developer.dhl.com üzerindeki uygulamanızın API anahtarı. Anahtar olmadan yöntem ödeme sayfasında gizlenir.

Connection test: Test API key düğmesi, kayıtlı anahtarla 53113 Bonn yakınındaki teslim noktalarını arar ve teslim noktası önbelleğini temizler. Önce ayarları kaydedin. Bulunan teslim noktası sayısını veya DHL'in anahtarı reddettiğini (401/403) gösterir.

Teslim noktaları

Location types: müşterinin seçebileceği DHL teslim noktaları: Packstation (parcel locker), Post Office (Postfiliale) ve DHL Parcel Shop (Paketshop). Varsayılan olarak üçü de seçilidir. Hiçbiri seçilmezse yöntem gizlenir. Packstation için müşterinin DHL Postnummer numarasını girmesi gerekir.

Search radius (meters): aranan posta kodu veya şehir çevresindeki yarıçap. Varsayılan: 5000. DHL en fazla 25000 m'ye izin verir.

Max results: her aramada gösterilen en fazla teslim noktası sayısı. Varsayılan: 20. DHL en fazla 50'ye izin verir.

Shipping address: seçilen teslim noktasını siparişin teslimat adresi olarak kullanır. Varsayılan olarak açıktır. Adres satırı 1 örneğin "Packstation 105" olur, satır 2 ise numarasıyla birlikte "Postnummer" olur; ayrıca teslim noktasının posta kodu ve şehri eklenir. Böylece siparişten yazdırılan etiketler doğru yere gider. Postnummer ayrıca _shipping_dhl_postnum olarak kaydedilir; bu, resmi "DHL Shipping Germany for WooCommerce" eklentisinin okuduğu alandır.

Fiyatlar

Country prices: mağaza para biriminde, hedef ülke başına fiyat; CC:FİYAT biçiminde, virgül veya satır sonu ile ayrılmış. Varsayılan: DE:4.99, AT:5.99. Ondalık virgül de kullanılabilir (DE:4,99).

Other countries: Country prices içinde bulunmayan bir hedef ülke için fiyat. Varsayılan: 5.99. Bu ülkeler için yöntemi gizlemek üzere boş bırakın.

Calculation: Per order fiyatı bir kez tahsil eder. Per item (price x quantity) fiyatı sepetteki ürün sayısıyla çarpar.

Free shipping from: bu kargonun ücretsiz olduğu sepet ara toplamı. Hiçbir zaman ücretsiz olmasın istiyorsanız boş bırakın.

Erişilebilirlik

Min weight (kg): minimum sepet ağırlığı. Ürün ağırlıkları mağazanızın birimine göre dönüştürülür. 0, sınır olmadığı anlamına gelir.

Max weight (kg): sepet ağırlığı bu değerin üstündeyse yöntem gizlenir. Varsayılan: 31.5, çünkü bir Packstation 31,5 kg'a kadar paket kabul eder. 0, sınır olmadığı anlamına gelir.

Minimum subtotal: yöntemi yalnızca sepet ara toplamı en az bu değerdeyse 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öntem gizlenir.

Ignore shipping zones: ilgili bölge yöntemi içermese bile, yöntemi aşağıdaki ülkeler için sunar.

Countries (ignore zones): bu mod için hedef ülkeler. Tüm ülkeler için boş bırakın. Yalnızca Ignore shipping zones ile birlikte kullanılır.

Gelişmiş

Debug log: API isteklerini ve ödeme adımlarını WooCommerce > Status > Logs altında, kaynak vfd-dhl-packstation olarak kaydeder. API hataları bu seçenek kapalı olsa bile her zaman kaydedilir. API anahtarı, Postnummer ve müşteri adresleri hiçbir zaman kaydedilmez.

Remove data on uninstall: açıksa eklentiyi silmek, ayarlarını ve bölge yöntemlerini kaldırır. Devre dışı bırakmak hiçbir şeyi silmez. Seçilen teslim noktaları siparişlerde kalır.

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

Müşteri bir teslimat adresi girdiğinde WooCommerce, eklentiden bir fiyat ister. Eklenti sepet ağırlığını, minimum ara toplamı ve hariç tutulan kargo sınıflarını kontrol eder, hedef ülkenin fiyatını (ya da diğer ülkeler için fiyatı) alır ve ara toplam yeterince yüksekse ücretsiz kargo uygular.

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

Eklenti DHL gönderisi oluşturmaz, etiket yazdırmaz ve kargoları takip etmez. DHL iş müşterisi portalını veya bir etiket eklentisini kullanın: sipariş zaten Packstation adresini ve beklenen biçimdeki Postnummer'ı içerir. Eklenti canlı DHL tarifelerini hesaplamaz ve harita göstermez. DHL API'sine ulaşılamazsa müşteri bir mesaj görür ve API tekrar çalışana kadar bu yöntemi kullanamaz. Packstation numarasının elle girilmesi desteklenmez.

Teslim noktaları

Müşteri DHL Packstation seçtiğinde, kargo seçeneğinin altında bir seçici belirir. Teslimat posta kodu veya şehri çevresindeki DHL teslim noktaları yüklenir. Müşteri başka bir posta kodu veya şehir arayabilir. Teslim noktaları türe göre (Packstation, Post Office, Parcel Shop) gruplanır ve mesafeye göre sıralanır.

Packstation için müşterinin DHL Postnummer numarasını girmesi gerekir; bu, DHL uygulamasından veya DHL hesabından alınabilen, 6-12 haneli DHL müşteri numarasıdır. Diğer teslim noktaları için isteğe bağlıdır. Teslim noktası olmadan veya geçersiz bir Postnummer ile sipariş verilemez. Bu kontrol sunucuda yapılır; blok ödeme sayfası için de geçerlidir.

Arama sonuçları 12 saat önbellekte tutulur. Başarısız bir arama 10 dakika önbelleğe alınır; böylece ödeme sayfası her yenilemede DHL'i beklemez. API zaman aşımı 12 saniyedir.

Teslim noktası (ID, tür, numara, ad, adres) ve Postnummer siparişe kaydedilir. Bunlar sipariş ekranında teslimat adresinin altında, teşekkür sayfasında, My account > Orders bölümünde ve sipariş e-postalarında (HTML ve düz metin) DHL pickup location ve DHL Postnummer olarak gösterilir.

Sipariş ekranında teslim noktasının yanındaki Edit düğmesine tıklayın, posta kodu veya şehre göre arayın, başka bir teslim noktası seçin, Postnummer'ı değiştirin ve Save location düğmesine tıklayın. Her değişiklik siparişe bir not ekler. Shipping address açıksa teslimat adresi de güncellenir. Görmek için sayfayı yeniden yükleyin.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu, WooCommerce > Settings > Shipping > DHL Packstation sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blokta durum görünür; örneğin lisansın hangi tarihe kadar etkin olduğu 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, o alan adı hakkını serbest bırakmaz. Hakkı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar yoksa DHL Packstation, ödeme sayfasında müşterilere gösterilmez. Oturum açmış mağaza yöneticileri ise yöntemi (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

DHL Packstation ö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). DHL API key alanının dolu olduğunu, en az bir teslim noktası türünün seçili olduğunu, hedef ülkenin bir fiyatının bulunduğunu (ya da Other countries ayarlandığını) ve ağırlık, ara toplam ve kargo sınıfı kurallarının yöntemi gizlemediğini kontrol edin.

Hiç teslim noktası gösterilmiyor: Test API key düğmesine tıklayın. DHL anahtarı reddederse (401/403), anahtarı ve uygulamanızda "Location Finder - Unified" API'sinin bulunduğunu kontrol edin. Debug log seçeneğini açın ve WooCommerce > Status > Logs bölümünü, kaynak vfd-dhl-packstation olacak şekilde açın. DHL uygulamanızın istek sınırına ulaşılmadığını kontrol edin.

Bir adrese yakın teslim noktası yok: Search radius (meters) veya Max results değerini artırın ya da müşterinin başka bir posta kodu veya şehir aramasına izin verin.

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, 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ı korur. Yalnızca teslim noktası önbelleğini temizler. Eklentiyi kaldırmak için devre dışı bırakın ve Plugins sayfasında silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman, teslim noktası önbelleği gibi kaldırılır. Ayarlar ve bölge yöntemleri yalnızca Remove data on uninstall açıksa kaldırılır. Aksi halde, daha sonraki bir yeniden kurulum için saklanır. Seçilen teslim noktaları siparişlerde kalır ve mevcut siparişler kendi kargo satırlarını korur.

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