nopCommerce Dokumentace

Jak naprogramovat vlastní metodu výpočtu ceny dopravy

Pokud mají zákazníci v košíku produkty, které lze odeslat, mohou si během pokladny zvolit možnost dopravy. Tyto možnosti dopravy vracejí metody výpočtu ceny dopravy (například UPS, USPS, FedEx atd.). Metody výpočtu ceny dopravy jsou v nopCommerce implementovány jako pluginy. Než začnete programovat novou metodu výpočtu ceny dopravy, doporučujeme přečíst si článek Jak napsat plugin pro nopCommerce 5.00. Článek vysvětluje kroky potřebné k vytvoření pluginu. Metoda výpočtu ceny dopravy je tedy ve skutečnosti běžný plugin, který implementuje rozhraní IShippingRateComputationMethod (jmenný prostor Nop.Services.Shipping). Přidejte tedy do řešení nový projekt pluginu dopravy (knihovnu tříd) a můžeme začít.

Controllery, view, modely

Přidejte controller s odpovídající metodou akce Configure a view. Ty určují, jak majitel obchodu uvidí možnosti konfigurace v administraci Systém → Konfigurace → Doprava → Poskytovatelé dopravy (System → Configuration → Shipping → Shipping providers). Tento článek nevysvětluje, jak pluginy konfigurovat, ale další informace o tom najdete zde.

shipping-plugin_1

Po dokončení tohoto kroku můžete začít přidávat potřebnou obchodní logiku pro získávání možností dopravy.

Získávání možností dopravy

Nyní musíte vytvořit třídu, která implementuje rozhraní IShippingRateComputationMethod. Tato třída bude vykonávat veškerou skutečnou práci. Když nopCommerce počítá celkovou cenu dopravy nebo potřebuje získat seznam dostupných možností dopravy, zavolají se metody GetShippingOptionsAsync nebo GetFixedRateAsync vaší třídy. Takto je definována třída UPSComputationMethod (metoda „UPS“):

public class UPSComputationMethod : BasePlugin, IShippingRateComputationMethod

Rozhraní IShippingRateComputationMethod má několik metod a vlastností, které je nutné implementovat.

  • GetShippingOptionsAsync. Tato metoda se volá vždy, když si zákazník během pokladny volí možnost dopravy. Metoda vrací GetShippingOptionResponse, který obsahuje seznam objektů ShippingOption. Každý objekt ShippingOption obsahuje informace o určité možnosti dopravy, jako je název možnosti (například „Po zemi“), její cena (například 10 USD) a další informace. Sem umístěte veškerou svou logiku (získejte ceny z databáze nebo si je vyžádejte od externího webu, například UPS).
  • GetFixedRateAsync. Jak již víte, GetShippingOptionsAsync se používá k získání možností dopravy během pokladny (na stránce „Výběr způsobu dopravy“). Někdy však potřebujeme znát cenu dopravy ještě předtím, než je možnost dopravy zvolena (například na stránce nákupního košíku). V takovém případě můžete vrátit pevnou cenu. Například vaše metoda výpočtu ceny dopravy poskytuje pouze jednu možnost dopravy a není nutné čekat, až ji zákazník zvolí na stránce „Výběr způsobu dopravy“. Pokud pevné ceny nejsou podporovány, vrátí se null. V takovém případě zákazníci v nákupním košíku uvidí vedle položky „Doprava celkem“ následující zprávu: „Vypočteno během pokladny“.
  • GetShipmentTrackerAsync. Tato metoda slouží k získání přidruženého sledovače zásilek. Výsledkem je IShipmentTracker, který obsahuje URL stránky pro zobrazení informací o sledování (stránka sledování třetí strany) a také všechny informace o událostech zásilky.

Závěr

Doufáme, že vám to pomůže začít s přidáváním nové metody výpočtu ceny dopravy.