VibeFox DPD Pickup for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 üzerinde test edildi) veya 4.0.2 ve sonrası (4.1.0.3 üzerinde test edildi).

PHP: 8.0 veya üzeri.

DPD Baltic kimlik bilgileri (Litvanya, Letonya, Estonya): teslim alma noktası listesi DPD Baltic web hizmetinden gelir. DPD'nin kurumsal müşterilerine verdiği API kullanıcı adına ve parolaya ihtiyacınız var. Bunları DPD hesap yöneticinizden veya ülkenizdeki DPD müşteri hizmetlerinden isteyin. Tek bir DPD Baltic hesabı, Litvanya, Letonya ve Estonya'nın teslim alma noktalarını listeler.

DPD Slovakia: DPD Slovakia'nın herkese açık parcelshop araması kimlik bilgisi gerektirmez.

Ağırlık sınıfı: ürün ağırlıkları kg'a çevrilir. Mağazanızda System > Localisation > Weight Classes bölümünde birimi kg olan bir ağırlık sınıfı bulunmalıdır (OpenCart varsayılan olarak bir tane içerir).

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar bir alan adında çalışır.

Kurulum

İndirme, her iki OpenCart sürümünün paketlerini içeren tek bir zip dosyasıdır. Bilgisayarınızda açın. İçinde README.txt, OpenCart 3 paketi vfd_dpd_pickup-oc3-(version).ocmod.zip ve OpenCart 4 paketi vfd_dpd_pickup.ocmod.zip bulunur. Yalnızca kullandığınız OpenCart sürümünün paketini kurun. Lisans anahtarı iki sürüm için de aynıdır.

OpenCart 3

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve vfd_dpd_pickup-oc3-(version).ocmod.zip dosyasını seçin. Eklenti OCMOD değişikliği eklemez, bu yüzden Extensions > Modifications bölümünü yenilemeniz gerekmez. Installer yerine, bu paketin upload klasörünün içeriğini mağazanızın kök klasörüne de kopyalayabilirsiniz.

2. Extensions > Extensions bölümüne gidin, eklenti türü olarak Shipping seçin. VibeFox DPD Pickup eklentisini bulun ve Install düğmesine tıklayın (yeşil + düğmesi).

3. Ayarlar sayfasını açmak için Edit düğmesine (kalem düğmesi) tıklayın.

4. Edit sayfasının üst kısmındaki lisans bloğunda, License key alanına VibeFox lisans anahtarınızı yapıştırın ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

5. DPD API'nizi seçin. DPD Litvanya, Letonya veya Estonya için API kullanıcı adını ve parolasını girin. Ülke başına fiyatları kontrol edin, Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Ardından bağlantıyı kontrol etmek için Refresh pickup points düğmesine tıklayın (bkz. Yapılandırma).

OpenCart 4

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve vfd_dpd_pickup.ocmod.zip dosyasını seçin. Dosya adını değiştirmeyin: OpenCart 4 eklenti kodunu dosya adından alır ve yeniden adlandırılmış paket çalışmaz.

2. Paket, aynı sayfada kurulu eklentilerin listesinde görünür. Yanındaki Install düğmesine (yeşil + düğmesi) tıklayın.

3. Extensions > Extensions bölümüne gidin, eklenti türü olarak Shipping seçin. VibeFox DPD Pickup eklentisini bulun, Install düğmesine (yeşil + düğmesi) tıklayın, ardından Edit düğmesine (kalem düğmesi) tıklayın.

4. Adım 4 ve 5'teki gibi, lisans anahtarını ve ayarları OpenCart 3 için olduğu gibi girin. Ayarlar sayfası ve alanları iki sürümde de aynıdır.

Kurulumdan sonra, Enable/Disable seçeneğini açıp kaydedene kadar yöntem kapalı kalır. Eklentiyi kaldırdıktan sonra yeniden kurarsanız, sakladığınız ayarlar tekrar kullanılır.

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Shipping > VibeFox DPD Pickup > Edit. Bölümler solda listelenir. Tek bir Save düğmesi, tüm sayfayı yeniden yüklemeden kaydeder. Her kayıt, önbelleğe alınmış teslim alma noktası listelerini de temizler. Yalnızca bu eklenti için değiştirme yetkisi olan yönetici kullanıcılar ayarları kaydedebilir, teslim alma noktalarını yenileyebilir veya günlüğü temizleyebilir.

Sayfanın üst kısmındaki uyarılar; DPD Baltic kullanıcı adı veya parolasının boş olduğunu ya da hiçbir fiyatın ayarlanmadığını (her iki durumda da yöntem ödeme sayfasında gösterilmez) ve mağazada birimi kg olan bir ağırlık sınıfı bulunmadığını bildirir (ürün ağırlıkları bu durumda birim adına göre okunur, bilinmeyen birimler kg kabul edilir). Bazı değerler kaydetmeyi engeller ve bu durumda hiçbir şey kaydedilmez: boş bir Name veya 64 karakterden uzun bir ad, tam sayı olmayan bir Sort order ve Max weight (kg) değerinden büyük bir Min weight (kg). Bir tutar veya ağırlık alanındaki sayı olmayan ya da negatif bir değer kaydedilmez: alan boşalır ve bir uyarı bunu belirtir, diğer ayarlar ise kaydedilir. CC:PRICE biçiminde olmayan Country prices satırları bir uyarıda listelenir ve yok sayılır.

Genel

Yöntem, Availability bölümünde ayarlanan coğrafi bölgede sunulur (hiçbiri ayarlanmamışsa tüm bölgeler) veya orada seçilen ülkelerde Ignore shipping zones ile sunulur.

Enable/Disable: DPD Pickup'ı ödeme sayfasında gösterir veya gizler. Varsayılan: kapalı.

Name: müşterinin ödeme sayfasında gördüğü kargo yöntemi adı. Varsayılan: DPD Pickup Point. Zorunlu, en fazla 64 karakter.

Tax class: kargo ücretine uygulanan vergi sınıfı veya vergi olmaması için None (varsayılan).

Sort order: yöntemin kargo yöntemleri listesindeki konumu. Tam sayı.

DPD teslim alma noktası listesi

Teslim alma noktaları DPD'den yüklenir ve önbelleğe alınır (bkz. Ödeme sayfasında nasıl çalışır).

DPD API: hesabınızın bulunduğu DPD şirketi. Baltic hesapları kendi ülkelerinin web hizmetini kullanır.

API username (Baltic): DPD Baltic web hizmeti kullanıcı adınız. DPD Slovakia için gerekli değildir. Bunu temizlemek, kayıtlı parolayı da temizler.

API password (Baltic): DPD Baltic web hizmeti parolanız. DPD Slovakia için gerekli değildir. Kaydettikten sonra alan boş kalır ve Saved - leave empty to keep it. ifadesini gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin.

Pickup points: Refresh pickup points düğmesi önbelleği temizler ve teslim alma noktalarını hemen DPD'den yükler: Baltic API için Litvanya, Letonya ve Estonya ve DPD Slovakia için Bratislava'da bir deneme araması. Ülke başına teslim alma noktası sayısını veya hatayı gösterir. Önce ayarları kaydedin.

Fiyatlar

Kargo ücretleri ülke başına sabittir, mağazanızın varsayılan para biriminde ve vergi hariç yazılır. DPD fiyatları API'den istenmez.

Country prices: ülke başına bir satır: CC:fiyat, örneğin EE:3.50. Ondalık virgül kabul edilir. Varsayılan: SK:3.50, LT:4.00, LV:4.00, EE:4.00.

Fallback cost: Country prices içinde olmayan ülkeler için fiyat. Varsayılan: 5.00. Yöntemi yalnızca listelenen ülkelerde sunmak için boş bırakın.

Calculation type: Per order (varsayılan) fiyatı bir kez alır. Per item (price x quantity) ise fiyatı sepetteki ürün adediyle çarpar.

Free shipping from: sipariş ara toplamı (indirimlerden sonra, vergiden önce) bu tutara ulaştığında kargo ücretsizdir. Kapatmak için boş bırakın.

Kullanılabilirlik

Müşterinin adresi için DPD teslim alma noktası döndürmediğinde veya DPD API'sine ulaşılamadığında da yöntem gizlenir, çünkü bir sipariş teslim alma noktası olmadan teslim edilemez.

Min weight (kg): minimum sepet ağırlığı. Ürün ağırlıkları, ağırlık sınıflarından çevrilir. Boş veya 0, sınır olmadığı anlamına gelir.

Max weight (kg): daha ağır sepetler yöntemi görmez. Varsayılan: 31.5. Boş veya 0, sınır olmadığı anlamına gelir. Ülkenizdeki DPD Pickup teslim alma noktaları ve dolapları için paket sınırlarını kontrol edin.

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

Geo zone: yöntemi yalnızca bu coğrafi bölgedeki adresler için sunar. All zones (varsayılan) sınır olmadığı anlamına gelir. Coğrafi bölgeler System > Localisation > Geo Zones bölümünde yönetilir. Ignore shipping zones ile kullanılmaz.

Ignore shipping zones: açık olduğunda coğrafi bölge kontrol edilmez ve yöntem aşağıdaki ülkelerde sunulur. Kapalı (varsayılan) olduğunda yalnızca yukarıdaki coğrafi bölge kullanılır.

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

Teslim alma noktası seçici

City order: önce büyük şehirleri gösterir (Tallinn, Riga, Vilnius, Bratislava ve diğerleri). Varsayılan olarak açıktır.

City list width: şehir listesinin CSS genişliği, örneğin 100% veya 300px. Varsayılan: 100%.

Pickup point list width: teslim alma noktası listesinin CSS genişliği, örneğin 100% veya 400px. Varsayılan: 100%.

Gelişmiş

Debug log: API isteklerini ve ödeme adımlarını storage/logs/vfd_dpd_debug.log.php dosyasına yazar (OpenCart 4'te system/storage/logs/vfd_dpd_debug.log.php). Dosya web üzerinden okunamaz. API hataları, bu seçenek kapalı olsa bile her zaman kaydedilir. Kimlik bilgileri hiçbir zaman kaydedilmez. Dosya 5 MB'a ulaştığında vfd_dpd_debug.old.log.php dosyasına taşınır ve yeni bir günlük başlatılır.

Log: hata ayıklama günlüğünün boyutunu ve en son girişlerini gösterir. Boşaltmak için Clear log düğmesine tıklayın.

Remove data on uninstall: açık olduğunda, eklentiyi kaldırmak eklentinin ayarlarını, günlüğünü ve tamamlanmamış ödemelerin seçimlerini siler. Siparişlerde kayıtlı teslim alma noktası her zaman korunur.

İçe / Dışa Aktarma

Export: ayarları JSON dosyası olarak kaydetmek için Download JSON düğmesine tıklayın. API parolası dışa aktarılmaz.

Import: daha önce dışa aktarılan JSON'u yapıştırın ve ayarları geri yüklemek için Import düğmesine tıklayın, örneğin başka bir mağazada. Değerler normal bir kayıttaki gibi kontrol edilir. Kayıtlı API parolası korunur.

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

OpenCart kargo yöntemlerini gösterirken eklentiden DPD Pickup fiyatını ister. Bir Geo zone ayarlıysa (ve Ignore shipping zones kapalıysa) ve adres bu bölgenin dışındaysa yöntem sunulmaz. Yalnızca Requires Shipping değeri Yes olarak ayarlanmış ürünler sayılır: diğer ürünler ağırlık eklemez ve ara toplama dahil edilmez. Eklenti ülkeleri (Ignore shipping zones ile), sepet ağırlığını ve minimum ara toplamı kontrol eder, ülke fiyatını (veya yedek maliyeti) alır ve ara toplam yeterince yüksekse ücretsiz kargoyu uygular. Ara toplam, kupon indiriminden sonra ve vergiden önce, kargo gerektiren ürünlerin fiyatıdır.

Ardından adres için DPD teslim alma noktalarını yükler. DPD hiçbir nokta döndürmezse, ulaşılamazsa veya Baltic kimlik bilgileri eksikse yöntem gizlenir. DPD Slovakia ile, şehir veya posta kodu hâlâ eksikken yöntem gösterilir ve adres tamamlandığında noktalar görünür. Fiyat varsayılan para biriminde hesaplanır ve müşteriye, seçilen Tax class vergisiyle kendi para biriminde gösterilir.

Bir teslim alma noktası listesi en fazla 24 saat, boş bir liste en fazla 1 saat önbellekte tutulur; ancak OpenCart önbellek süresinden (varsayılan 1 saat) daha uzun değil. Başarısız bir istek 5 dakika boyunca hatırlanır; böylece bir DPD kesintisi ödeme sayfasını asla yavaşlatmaz. API zaman aşımı 15 saniyedir.

Eklenti DPD fiyatlarını sorgulamaz, DPD gönderileri oluşturmaz, etiket basmaz, manifesto oluşturmaz, kurye alımı talep etmez, kargoları takip etmez ve harita göstermez. Yalnızca DPD Baltic web hizmeti ve DPD Slovakia parcelshop araması desteklenir.

Teslim alma noktaları

Müşteri DPD Pickup'ı seçtiğinde, yöntemin altında bir şehir listesi ve bir teslim alma noktası listesi görünür. Müşterinin adresindeki şehir önceden seçilidir. Seçim, müşteri seçer seçmez kaydedilir. DPD Slovakia ile müşteri, adres tamamlanana kadar Enter your city and postcode to see the DPD pickup points nearby. ifadesini görür, ardından yakındaki noktaları görür. DPD adres için hiç nokta bulamazsa müşteri No DPD pickup points are available for this address right now. Please check the address or choose another shipping method. ifadesini görür.

Bir teslim alma noktası zorunludur. Nokta olmadan müşteri devam edemez ve Please select a DPD pickup point. ifadesini görür. Müşteri Continue düğmesine tıkladığında sunucu, noktanın müşterinin adresi için DPD listesine ait olduğunu kontrol eder. Sahte veya güncel olmayan bir seçim The selected DPD pickup point is not available for this address. Please choose another one. mesajıyla reddedilir. DPD listesi o anda yüklenemezse, müşterinin zaten seçtiği nokta kabul edilir ve sipariş adın yerine kimliğini gösterir.

OpenCart 4'te müşteri, ödeme sayfasının kargo yöntemi bloğunda Choose düğmesine tıklar ve Shipping method options penceresinde DPD Pickup'ı seçer. Şehir listesi ve teslim alma noktası listesi bu pencerede yöntemin altında görünür ve yukarıda anlatıldığı gibi çalışır. Pencerenin Continue düğmesi, teslim alma noktası seçilmeden ilerlemez; aynı mesajlar gösterilir.

Seçilen nokta, siparişin kargo yöntemine eklenir; örneğin varsayılan başlıkla DPD Pickup Point: name, street, postcode city veya kendi başlığınızla My title - DPD pickup point: name, street, postcode city (en fazla 128 karakter). Böylece yönetici siparişinde, müşterinin sipariş geçmişinde, sipariş e-postalarında ve faturada görünür. Siparişe kaydedilen ad tarayıcıdan değil, DPD'den gelir.

OpenCart 4'te kargo yönteminin metni en fazla 255 karakter olabilir. OpenCart 4, ödeme için tek bir sipariş tutar ve müşteri her onayladığında onu günceller; siparişin teslim alma noktası da onunla birlikte güncellenir.

Yönetici sipariş sayfasında (Sales > Orders), geçmişin üstündeki DPD pickup point paneli noktanın adını, kimliğini ve ülkesini gösterir. Edit düğmesine tıklayın, bir şehir ve başka bir nokta seçin ve Save düğmesine tıklayın. Nokta, sipariş adresi için DPD listesine göre kontrol edilir ve panel Pickup point updated. veya Pickup point not found for the order address. ifadesini gösterir. Siparişin kargo yöntemi metni güncellenir ve sipariş geçmişine, eski nokta, yeni nokta ve yönetici kullanıcısıyla birlikte bir not eklenir (müşteriye gönderilmez). Noktayı değiştirmek için eklenti ayarlarına erişim değil, sipariş değiştirme yetkisi gerekir. DPD Slovakia ile siparişte bir kargo şehri ve posta kodu olmalıdır; aksi halde panel Add the shipping city and postcode to change the pickup point. ifadesini gösterir. Noktasız verilen bir sipariş No pickup point was selected for this order. ifadesini gösterir ve hata ayıklama günlüğünde bu sipariş için bir hata bulunur. Panel ve Edit, eklenti kapatıldıktan sonra da çalışır.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu License — VibeFox DPD Pickup, Extensions > Extensions > Shipping > VibeFox DPD Pickup > Edit sayfasında, ayarların üstünde ilk bloktur. Anahtarı License key alanına girin ve Activate düğmesine tıklayın. Bundan sonra blok anahtarı maskeli olarak gösterir; durumu (örneğin lisansın hangi tarihe kadar etkin olduğunu ve alan adınızı) ile Check now (durumu yeniden kontrol eder), Change key (başka bir anahtar girer) ve Remove key (anahtarı bu mağazadan kaldırır) düğmelerini gösterir. Bunların altında Product: opencart-shipping-dpd-pickup satırı ve Manage licenses and domains in your account bağlantısı bulunur; bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca eklenti için Modify yetkisi olan yönetici kullanıcılar değiştirebilir. Bloğun metinleri yönetici dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini gösterir; örneğin Key not found, This key belongs to another product, Domain limit reached veya License expired on ve bir tarih. Mağaza adresi değiştikten sonra veya hesabınızda bir alan adı yuvası boşalttıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Bir anahtar bir alan adında çalışır: OpenCart yapılandırmasındaki mağaza adresi. Anahtarı mağazadan kaldırmak alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan DPD Pickup kargo yöntemi ödeme sayfasında müşterilere gösterilmez ve hiçbir ücret hesaplanmaz. Yönetici paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, yöntemi yine de mağazada (unlicensed — visible to admins only) işaretiyle görür; böylece anahtarı satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu önizleme yoktur: mağaza yönetici girişini görmez, bu nedenle etkin anahtar olmadan yöntem herkesten gizlenir. Edit sayfasını bir kez açtıktan sonra yönetici Dashboard sayfasında bir hatırlatma belirir. Bunu × ile kapatırsanız 7 gün gizlenir. 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, yönetici Dashboard sayfasını veya Edit sayfasını açtığınızda otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, ardından haftada bir. Cron işi gerekmez. Eklentiyi kaldırmak, lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

DPD Pickup ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable/Disable seçeneğinin açık olduğunu kontrol edin. Geo zone (veya Ignore shipping zones ve Countries), ağırlık ve ara toplam sınırlarını ve ülkenin bir fiyatı (veya yedek maliyeti) olup olmadığını kontrol edin. Eklenti sayfasının üst kısmındaki uyarılara bakın ve Refresh pickup points düğmesine tıklayın. Ürünlerin Requires Shipping değerinin Yes olduğunu kontrol edin.

Refresh pickup points sonrasında bir hata: sonuç, ülke başına DPD hatasını gösterir. Örneğin "Login failed", DPD'nin Baltic kimlik bilgilerini reddettiği anlamına gelir; bu nedenle hiçbir teslim alma noktası yüklenemez. API kullanıcı adını ve parolasını DPD ile kontrol edin.

DPD Slovakia nokta göstermiyor: noktalar, müşteri şehri ve posta kodunu girdikten sonra görünür. DPD yalnızca bu adresin 50 km içindeki noktaları listeler.

Nedeni bulmak için: Debug log seçeneğini açın, ödeme sayfasını yeniden yükleyin ve eklenti sayfasındaki Log alanına bakın. API hataları her zaman kaydedilir. API kullanıcı adları ve parolaları günlüğe asla yazılmaz.

Bir değişiklikten sonra teslim alma noktaları eski görünüyor: eklenti sayfasında Save veya Refresh pickup points düğmesine tıklayın. İkisi de önbelleğe alınmış listeleri temizler.

Sayfa "Warning: You do not have permission to modify VibeFox DPD Pickup!" diyor: yönetici kullanıcı grubunuz ayarları yalnızca görüntüleyebiliyor olabilir. Gruba, System > Users > User Groups bölümünde extension/shipping/vfd_dpd_pickup (OpenCart 3) veya extension/vfd_dpd_pickup/shipping/vfd_dpd_pickup (OpenCart 4) için değiştirme yetkisi verin.

Geliştiriciler için: DPD Slovakia arama yarıçapı, OpenCart olayı vfd_dpd_pickup/sk_search_radius ile başka bir eklenti tarafından değiştirilebilir.

Kaldırma

Extensions > Extensions bölümüne gidin, Shipping türünü seçin ve VibeFox DPD Pickup yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. OpenCart her zaman Enable/Disable, Sort order, Tax class ve Geo zone değerlerini sıfırlar. Eklenti her zaman kendi olaylarını ve önbelleğe alınmış teslim alma noktası listelerini kaldırır. Remove data on uninstall açıksa, diğer ayarlar, hata ayıklama günlüğü ve tamamlanmamış ödemelerin seçimleri de silinir. Kapalıysa ayarlar korunur ve eklentiyi yeniden kurduğunuzda tekrar kullanılır. Siparişlerde kayıtlı teslim alma noktası hiçbir zaman silinmez ve mevcut siparişler kargo yöntemlerini ve maliyetlerini korur.

OpenCart 4'te, eklentinin dosyalarını da kaldırmak için kaldırdıktan sonra Extensions > Installer bölümüne gidin ve kurulu eklentiler listesinde VibeFox DPD Pickup yanındaki Uninstall düğmesine (turuncu − düğmesi) tıklayın, ardından yüklenen paketi silmek için Delete düğmesine (kırmızı çöp kutusu düğmesi) tıklayın.

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