# nopCommerce – Dokumentace (Čeština) --- # Dokumentace nopCommerce nopCommerce je open source e-commerce software, který obsahuje jak katalogový frontend, tak backend s administračním nástrojem. nopCommerce je plně přizpůsobitelný nákupní košík, stabilní, bezpečný a rozšiřitelný. Od stažení až po dokumentaci nabízí [nopCommerce.com](https://www.nopCommerce.com) ucelenou základnu informací, zdrojů a podpory komunity nopCommerce. Dokumentace nopCommerce vám pomůže projít procesem nastavení vašeho obchodu. Díky ní rychle zprovozníte svůj web! --- # Instalace nopCommerce nopCommerce lze stáhnout jako e-commerce řešení připravené k instalaci, nebo jako úplný zdrojový kód připravený k úpravám. Tato kapitola pokrývá vše, co potřebujete vědět o stažení a instalaci nopCommerce. - [Technologie a systémové požadavky](xref:cs/installation-and-upgrading/technology-and-system-requirements) - [Průvodce instalací](xref:cs/installation-and-upgrading/installing-nopcommerce/index) - [Výběr hostingové společnosti](xref:cs/installation-and-upgrading/installing-nopcommerce/choose-a-hosting-company) - [Lokální instalace (pouze pro vývojáře)](xref:cs/installation-and-upgrading/installing-nopcommerce/installing-local) - [Instalace na Windows](xref:cs/installation-and-upgrading/installing-nopcommerce/installing-on-windows) - [Instalace na Microsoft Azure](xref:cs/installation-and-upgrading/installing-nopcommerce/installing-on-microsoft-azure) - [Instalace na Linux](xref:cs/installation-and-upgrading/installing-nopcommerce/installing-on-linux) - [Předinstalovaný nopCommerce](xref:cs/installation-and-upgrading/installing-nopcommerce/pre-installed-nopcommerce) - [Plně spravovaný privátní cloudový hosting od Everleap](xref:cs/installation-and-upgrading/installing-nopcommerce/everleap-fully-managed-hosting) - [Aktualizace nopCommerce](xref:cs/installation-and-upgrading/upgrading-nopcommerce) --- # Technologie a systémové požadavky Ke spuštění nopCommerce budete na svém serveru/počítači potřebovat nainstalováno následující: ## Podporované operační systémy * Windows * Windows 10 Client (1607 nebo vyšší) * Windows 11 (23H2 nebo vyšší) * Windows Server 2016 nebo vyšší * Linux * Red Hat Enterprise Linux 8 nebo vyšší * Fedora 41 nebo vyšší nebo * Debian 13 nebo vyšší * Ubuntu 22.04 nebo vyšší * openSUSE Leap 16 nebo vyšší * SUSE Enterprise Linux 15.7 nebo vyšší * Alpine Linux 3.21 nebo vyšší * macOS * macOS 15.0 nebo vyšší >[!NOTE] > > Úplný [seznam podporovaných operačních systémů naleznete zde](https://github.com/dotnet/core/blob/main/release-notes/10.0/supported-os.md). ## Podporované webové servery * Internet Information Service (IIS) 7.0 nebo vyšší * Pro nopCommerce 5.00: Nainstalujte runtime .NET 10 ([stáhnout](https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-aspnetcore-10.0.12-windows-hosting-bundle-installer)). * Pro nopCommerce 4.90: Nainstalujte runtime .NET 9 ([stáhnout](https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-aspnetcore-9.0.9-windows-hosting-bundle-installer)). * Pro nopCommerce 4.80: Nainstalujte runtime .NET 9 ([stáhnout](https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-aspnetcore-9.0.0-windows-hosting-bundle-installer)). * Pro nopCommerce 4.70: Nainstalujte runtime .NET 8 ([stáhnout](https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-aspnetcore-8.0.4-windows-hosting-bundle-installer)). * Pro nopCommerce 4.60: Nainstalujte runtime .NET 7 ([stáhnout](https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-aspnetcore-7.0.5-windows-hosting-bundle-installer)). * Pro nopCommerce 4.50: Nainstalujte runtime .NET 6 ([stáhnout](https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-aspnetcore-6.0.1-windows-hosting-bundle-installer)). * Pro nopCommerce 4.40: Nainstalujte runtime .NET 5 ([stáhnout](https://dotnet.microsoft.com/download/dotnet/thank-you/runtime-aspnetcore-5.0.3-windows-hosting-bundle-installer)). * Pro nopCommerce 4.30: Nainstalujte runtime .NET Core 3.1 ([stáhnout](https://dotnet.microsoft.com/download/dotnet-core/thank-you/runtime-aspnetcore-3.1.3-windows-hosting-bundle-installer)). * Pro nopCommerce 4.20: Nainstalujte runtime .NET Core 2.2 ([stáhnout](https://dotnet.microsoft.com/download)). * Pro nopCommerce 4.10: Nainstalujte runtime .NET Core 2.1 ([stáhnout](https://dotnet.microsoft.com/download)). * Pro nopCommerce 4.00: Nainstalujte .NET Core Window Server hosting runtime ([stáhnout](https://dotnet.microsoft.com/download)) * Pro nopCommerce 3.90 nebo nižší: ASP.NET 4.5 (MVC 5.0) a Microsoft .NET Framework 4.5.1 nebo vyšší ## Podporované databáze * MS SQL Server 2018 nebo vyšší * MySql Server 8 nebo vyšší (od nopCommerce 4.30) * PostgreSQL 15 nebo vyšší (od nopCommerce 4.40) ## Podporované prohlížeče * Microsoft Edge. Microsoft Internet Explorer 9 a vyšší (IE6 a IE7 byly podporovány ve verzích před 3.60, IE8 byl podporován ve verzích před 4.10) * Mozilla Firefox 2.0 a vyšší * Google Chrome 1.x a vyšší * Apple Safari 12.x a vyšší **Pro nopCommerce 5.00 nebo vyšší: MS Visual Studio 2026 (verze 18.0 nebo vyšší). A nezapomeňte nainstalovat .NET 10 SDK ([stáhnout](https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/sdk-10.0.401-windows-x64-installer)). Vyžadováno pro vývojáře, kteří chtějí upravovat zdrojový kód.** *Pro nopCommerce 4.90 nebo vyšší: MS Visual Studio 2022 (verze 17.14 nebo vyšší). A nezapomeňte nainstalovat .NET 9 SDK ([stáhnout](https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/sdk-9.0.305-windows-x64-installer)). Vyžadováno pro vývojáře, kteří chtějí upravovat zdrojový kód.* *Pro nopCommerce 4.80 nebo vyšší: MS Visual Studio 2022 (verze 17.12 nebo vyšší). A nezapomeňte nainstalovat .NET 9 SDK ([stáhnout](https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/sdk-9.0.100-windows-x64-installer)). Vyžadováno pro vývojáře, kteří chtějí upravovat zdrojový kód.* *Pro nopCommerce 4.70 nebo vyšší: MS Visual Studio 2022 (verze 17.9 nebo vyšší). A nezapomeňte nainstalovat .NET 8 SDK ([stáhnout](https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/sdk-8.0.204-windows-x64-installer)). Vyžadováno pro vývojáře, kteří chtějí upravovat zdrojový kód.* *Pro nopCommerce 4.60 nebo vyšší: MS Visual Studio 2022 (verze 17.5 nebo vyšší). A nezapomeňte nainstalovat .NET 7 SDK ([stáhnout](https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/sdk-7.0.302-windows-x64-installer)). Vyžadováno pro vývojáře, kteří chtějí upravovat zdrojový kód.* *Pro nopCommerce 4.60 nebo vyšší: MS Visual Studio 2022 (verze 17.5 nebo vyšší). A nezapomeňte nainstalovat .NET 7 SDK ([stáhnout](https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/sdk-7.0.302-windows-x64-installer)). Vyžadováno pro vývojáře, kteří chtějí upravovat zdrojový kód.* *Pro nopCommerce 4.50: MS Visual Studio 2022 (verze 17.0 nebo vyšší). A nezapomeňte nainstalovat .NET 6 SDK ([stáhnout](https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/sdk-6.0.406-windows-x64-installer)). Vyžadováno pro vývojáře, kteří chtějí upravovat zdrojový kód.* *Pro nopCommerce 4.40 nebo vyšší: MS Visual Studio 2019 (verze 16.9 nebo vyšší). A nezapomeňte nainstalovat .NET 5 SDK ([stáhnout](https://dotnet.microsoft.com/download/dotnet/thank-you/sdk-5.0.408-windows-x64-installer)). Vyžadováno pro vývojáře, kteří chtějí upravovat zdrojový kód.* *Pro nopCommerce 4.30: MS Visual Studio 2019 (verze 16.3 nebo vyšší). A nezapomeňte nainstalovat .NET Core SDK ([stáhnout](https://dotnet.microsoft.com/download/dotnet-core/thank-you/sdk-3.1.426-windows-x64-installer)). Vyžadováno pro vývojáře, kteří chtějí upravovat zdrojový kód.* *Pro nopCommerce 4.20 nebo vyšší: MS Visual Studio 2017 (verze 15.9 nebo vyšší). A nezapomeňte nainstalovat .NET Core SDK ([stáhnout](https://dotnet.microsoft.com/download)). Vyžadováno pro vývojáře, kteří chtějí upravovat zdrojový kód.* *Pro nopCommerce 4.10: MS Visual Studio 2017 (verze 15.7 nebo vyšší). A nezapomeňte nainstalovat .NET Core SDK ([stáhnout](https://dotnet.microsoft.com/download)). Vyžadováno pro vývojáře, kteří chtějí upravovat zdrojový kód.* *Pro nopCommerce 4.00 nebo nižší: MS Visual Studio 2017 (verze 15.3 nebo vyšší). A nezapomeňte nainstalovat .NET Core SDK ([stáhnout](https://dotnet.microsoft.com/download)). Vyžadováno pro vývojáře, kteří chtějí upravovat zdrojový kód.* > [!NOTE] > > Pokud instalujete nopCommerce ve Windows a chcete používat funkci více obchodů s SSL, je vyžadován Windows Server 2012 se službou IIS 8, protože podporuje SNI (Server Name Indication). --- # Instalace nopCommerce nopCommerce je multiplatformní řešení a lze jej provozovat na Windows i Linuxu. nopCommerce můžete také nainstalovat na Microsoft Azure nebo použít předinstalovanou verzi nopCommerce, což je nejjednodušší způsob, jak vytvořit vlastní obchod na nopCommerce. Vyberte jednu z následujících možností: - [Lokální instalace (pouze pro vývojáře)](xref:cs/installation-and-upgrading/installing-nopcommerce/installing-local) - [Instalace na Windows](xref:cs/installation-and-upgrading/installing-nopcommerce/installing-on-windows) - [Instalace na Microsoft Azure](xref:cs/installation-and-upgrading/installing-nopcommerce/installing-on-microsoft-azure) - [Instalace na Linux](xref:cs/installation-and-upgrading/installing-nopcommerce/installing-on-linux) - [Předinstalovaný nopCommerce](xref:cs/installation-and-upgrading/installing-nopcommerce/pre-installed-nopcommerce) - [Plně spravovaný privátní cloudový hosting od Everleap](xref:cs/installation-and-upgrading/installing-nopcommerce/everleap-fully-managed-hosting) --- # Poskytovatelé hostingu Ať už plánujete používat nopCommerce tak, jak je, nebo upravovat kód, nakonec budete potřebovat web hostovat, aby jej veřejnost mohla navštívit a nakupovat vaše produkty. Poskytovatelé hostingu váš web doslova hostují a umožňují uživatelům se na něj dostat. nopCommerce lze hostovat téměř u jakéhokoli poskytovatele. Výběr poskytovatele hostingu je důležité rozhodnutí. Před výběrem poskytovatele je třeba zvážit řadu faktorů. V první řadě se musíte ujistit, že poskytovatel splňuje [technologické a systémové požadavky](xref:cs/installation-and-upgrading/technology-and-system-requirements). Kromě toho je vhodné zvážit tyto faktory: 1. **Dostupnost (uptime)** – Dobrý poskytovatel by měl garantovat dostupnost 99,9 procenta. Dostupnost jednoduše znamená, že váš web bude v provozu a k dispozici uživatelům. Pokud je váš web často mimo provoz nebo nedostupný, mnoho produktů neprodáte. 1. **Podpora** – Hledejte poskytovatele, kteří nabízejí technickou podporu 24/7. Ideální je telefonická podpora 24/7, ale tu je někdy obtížné najít. Hledejte poskytovatele, který nabízí podporu po telefonu, e-mailem i přes live chat. 1. **Cena** – Například hosting na Windows je většinou poměrně levný. Vyberte si poskytovatele, který nabízí slevy při ročním nebo pololetním předplatném. 1. **Vyhrazená IP adresa** – Většina instalací nopCommerce bude vyžadovat SSL certifikát, protože budete zpracovávat platební karty. Ověřte si u poskytovatele cenu vyhrazené IP adresy pro vaši doménu, neměla by být příliš vysoká. 1. **Zálohy** – Ujistěte se, že poskytovatel nabízí zálohování vaší instalace a databáze. Může jít o automatické nebo ruční zálohy, ale budete klidnější, když budete vědět, že vaše data jsou zálohována. 1. **Možnosti růstu** – S tím, jak bude mít váš web více uživatelů a budete více prodávat, bude muset růst i váš web. Dobrý poskytovatel nabídne možnosti rozšíření, od většího diskového prostoru po větší prostor pro databázi. Patří sem i přechod ze sdíleného serveru na dedikovaný server. > [!TIP] > > Více o doporučených hostingových partnerech nopCommerce se dozvíte zde – [Hostingoví partneři](https://www.nopcommerce.com/hosting-partners?utm_source=docs_nopcommerce&utm_medium=link&utm_content=hosting&utm_campaign=parnters_page). --- # Lokální instalace Tato kapitola popisuje, jak stáhnout software nopCommerce, nahrát jej na server, definovat oprávnění k souborům a nainstalovat jej do vašeho systému. Můžete se také podívat na videozáznam o instalaci nopCommerce na našem [kanálu YouTube](https://www.youtube.com/watch?v=L7NGodeB9sQ). Než začnete s instalací, ujistěte se, že váš webhosting splňuje [minimální požadavky pro provoz nopCommerce](xref:cs/installation-and-upgrading/technology-and-system-requirements). > [!NOTE] > > Další informace o tom, jak vybrat hosting, najdete na [této stránce](xref:cs/installation-and-upgrading/installing-nopcommerce/choose-a-hosting-company). Při stahování nopCommerce je k dispozici několik možností. Abyste určili, kterou možnost stáhnout, musíte se rozhodnout, jak budete nopCommerce používat. K dispozici jsou následující možnosti: 1. **Web (bez zdrojového kódu)**. Tato možnost je určena uživatelům, kteří nechtějí nebo nepotřebují vyvíjet žádný vlastní kód. Jedná se o předkompilovanou verzi nopCommerce, kterou stačí nahrát k poskytovateli hostingu a ihned používat. I s touto možností mohou uživatelé upravovat vzhled a chování nebo uživatelské rozhraní (UI) svého webu podle svých potřeb, ale nemusí se starat o vývoj. 1. **Zdrojový kód**. Tato možnost obsahuje úplné řešení (solution) pro Visual Studio. Je určena uživatelům, kteří chtějí upravovat kód nopCommerce. Obsahuje veškerý zdrojový kód použitý k vývoji nopCommerce a musí být otevřena ve Visual Studiu. Obsahuje také skripty pro sestavení a kompilaci řešení k nahrání k poskytovateli hostingu. 1. **Aktualizační skript**. Možnost aktualizačního skriptu je určena uživatelům, kteří již mají nopCommerce nainstalovaný. Skript aktualizuje vaši stávající instalaci na nejnovější verzi. S každou z těchto možností, kromě aktualizačního skriptu, můžete nopCommerce nasadit do svého vývojového prostředí i k poskytovateli hostingu. Vyberte možnost, kterou chcete [stáhnout](https://www.nopcommerce.com/en/download-nopcommerce), a kliknutím na příslušný odkaz zahajte stahování. Doporučujeme vytvořit na ploše novou složku pro uložení stažených souborů, abyste k nim měli snadný přístup. ## Spuštění webu pomocí IIS (balíček bez zdrojového kódu) Chcete-li použít IIS, zkopírujte obsah rozbalené složky nopCommerce do virtuálního adresáře IIS (nebo kořene webu) a poté si web zobrazte v prohlížeči. Pokud používáte nopCommerce 3.90 nebo nižší, nakonfigurujte jej pro běh v integrovaném režimu a nakonfigurujte fond aplikací tak, aby používal .NET Framework verze 4. Upozorňujeme, že u nopCommerce 4.00 a vyšších to není nutné. ## Spuštění webu pomocí Visual Studia (balíček se zdrojovým kódem) Tento krok popisuje, jak spustit web ve Visual Studiu. Chcete-li web spustit ve Visual Studiu, rozbalte archiv s úplným zdrojovým kódem do místní složky. Spusťte Visual Studio a zvolte **File → Open → Project/Solution**. Přejděte do složky, do které jste archiv rozbalili, a otevřete soubor řešení `NopCommerce.sln`. Spusťte projekt `Nop.Web`. ## Získání balíčku „připraveného k nasazení“ (bez zdrojového kódu) z balíčku se zdrojovým kódem Pokud používáte nopCommerce **3.20 (nebo vyšší)**, postupujte podle těchto kroků: - Otevřete řešení ve Visual Studiu. - Znovu sestavte celé řešení. - Publikujte projekt **Nop.Web** z Visual Studia. Při publikování se ujistěte, že je konfigurace nastavena na *Release*. ## Postup instalace nopCommerce vyžaduje oprávnění k zápisu pro níže uvedené adresáře a soubory: - **Pro nopCommerce verze 4.00 a vyšší:** - `\App_Data\` - `\bin\` - `\Logs\` - `\Plugins\` - `\Plugins\Uploaded\` - `\wwwroot\.well-known\` - `\wwwroot\bundles\` - `\wwwroot\db_backups\` - `\wwwroot\files\` - `\wwwroot\files\exportimport\` - `\wwwroot\icons\` - `\wwwroot\images\` - `\wwwroot\images\thumbs\` - `\wwwroot\images\uploaded\` - `\wwwroot\sitemaps\` - `\App_Data\DataProtectionKeys\` - `\App_Data\plugins.json` (po instalaci) - `\App_Data\appsettings.json` (nebo dataSettings.json u starších verzí; po instalaci) - **Pro nopCommerce verze 2.00–3.90:** - `\App_Data\` - `\bin\` - `\Content\` - `\Content\Images\` - `\Content\Images\Thumbs\` - `\Content\Images\Uploaded\` - `\Content\files\ExportImport\` - `\Plugins\` - `\Plugins\bin\` - `\Global.asax` - `\web.config` Tato oprávnění se ověřují během procesu instalace. Pokud oprávnění k zápisu nemáte, zobrazí se varovná zpráva s žádostí o konfiguraci oprávnění. Před instalací nopCommerce se ujistěte, že máte v systému nainstalovaný databázový server. K připojení k serveru můžete použít kteroukoli z následujících metod ověřování: - **Účet SQL Serveru**: Při připojení touto metodou se v SQL Serveru vytvářejí přihlašovací účty, které nejsou založeny na uživatelských účtech Windows. Uživatelské jméno i heslo jsou vytvořeny pomocí SQL Serveru a uloženy v něm. Při použití této metody musíte zadat své přihlašovací jméno a heslo. - **Integrované ověřování Windows**: Při připojení touto metodou SQL Server ověřuje název účtu a heslo pomocí tokenu objektu zabezpečení Windows v operačním systému. To znamená, že identitu uživatele potvrzuje Windows. SQL Server nevyžaduje heslo a ověření identity neprovádí. Ověřování Windows je výchozím režimem ověřování a je mnohem bezpečnější než ověřování SQL Serveru. Ověřování Windows používá bezpečnostní protokol Kerberos, umožňuje vynucovat zásady hesel z hlediska ověřování složitosti silných hesel, podporuje uzamčení účtu a podporuje vypršení platnosti hesla. Připojení vytvořené pomocí ověřování Windows se někdy nazývá důvěryhodné připojení, protože SQL Server důvěřuje přihlašovacím údajům poskytnutým systémem Windows. Jakmile web poprvé otevřete, budete přesměrováni na instalační stránku: ![Instalace nopCommerce](_static/installing-local/installation.jpg) Na panelu *Informace o obchodu* (Store information) vyplňte následující údaje: - **E-mail administrátora** (Admin user email): e-mailová adresa prvního administrátora webu. - **Heslo administrátora** (Admin user password): musíte zadat heslo pro účet administrátora. - **Potvrzení hesla** (Confirm the password): potvrďte heslo administrátora. - **Země** (Country): vyberte zemi z rozevíracího seznamu. Umožňuje předkonfigurovat obchod na základě vybrané země. Například: - stáhnout a předinstalovat jazykový balíček z oficiálního webu - předkonfigurovat některá nastavení (například PangV nebo nastavení „Zobrazovat informace o dani/dopravě“ pro Německo) - předkonfigurovat některé údaje o dopravě, nastavení DPH, měny, měrné jednotky a další. - **Vytvořit ukázková data** (Create sample data): zaškrtněte toto políčko, pokud chcete vytvořit ukázkové produkty. To se doporučuje, abyste mohli začít pracovat s webem ještě před přidáním vlastních produktů. Tyto položky můžete kdykoli později odstranit nebo zrušit jejich publikování, aby se na webu již nezobrazovaly. - **Přihlásit se k odběru newsletteru nopCommerce** (Subscribe to nopCommerce newsletter): zaškrtněte toto políčko, pokud se chcete během instalace přihlásit k odběru newsletteru nopCommerce. Na panelu *Informace o databázi* (Database information) musíte zadat následující údaje: - **Databáze** (Database): zde můžete vybrat Microsoft SQL Server, MySQL nebo PostgreSQL. - **Vytvořit databázi, pokud neexistuje** (Create database if it doesn't exist): pro úspěšnou instalaci doporučujeme vytvořit databázi a databázového uživatele předem. Stačí vytvořit instanci databáze a přidat do ní databázového uživatele. Proces instalace vytvoří všechny tabulky, uložené procedury a další. - **Zadat vlastní připojovací řetězec (pokročilé)** (Enter raw connection string (advanced)): zaškrtněte toto políčko, pokud chcete místo vyplnění polí připojení zadat **Připojovací řetězec** (Connection string). - **Název serveru** (Server name): IP adresa, URL nebo název serveru vaší databáze. Název serveru zjistíte v systému pro správu databáze nebo v ovládacím panelu hostingu. - **Název databáze** (Database name): název databáze, kterou nopCommerce používá. Pokud jste se rozhodli vytvořit databázi předem, použijte zde název, který jste databázi dali. - **Použít integrované ověřování Windows** (Use integrated Windows authentication): pokud instalujete u poskytovatele hostingu, můžete použít svůj účet SQL Serveru a zadat přihlašovací údaje, které jste vytvořili spolu s databází. V takovém případě tuto možnost nezaškrtávejte. Pokud používáte vývojové prostředí, můžete zvolit ověřování Windows. V takovém případě toto políčko zaškrtněte. Pokud používáte ověřování Windows, musí být účet, pod kterým běží fond aplikací v IIS, uživatelem databáze. - **Uživatelské jméno SQL** (SQL Username): zadejte přihlašovací jméno databázového uživatele. - **Heslo SQL** (SQL Password): zadejte heslo databázového uživatele. - **Zadat vlastní řazení (collation)** (Specify custom collation): jde o pokročilé nastavení, které by mělo zůstat nezaškrtnuté. Kliknutím na **Instalovat** (Install) zahájíte proces instalace. Po dokončení instalace se zobrazí domovská stránka vašeho nového webu. > [!NOTE] > > Tlačítko **Restartovat instalaci** (Restart installation) v dolní části instalační stránky umožňuje znovu spustit proces instalace pro případ, že se něco pokazí. > > [!NOTE] > > Pokud používáte nopCommerce 3.90 nebo nižší, ujistěte se, že je váš fond aplikací nastaven do režimu *Integrated*. > > [!NOTE] > > Pokud chcete web nopCommerce zcela obnovit do výchozího nastavení, můžete odstranit sekci **ConnectionStrings** ze souboru `appsettings.json` (nebo `dataSettings.json` u starších verzí), který se nachází v adresáři `App_Data`. Můžete dokonce odstranit celý tento soubor, mějte však na paměti, že v takovém případě bude při dalším spuštění obnoven s výchozími hodnotami, takže můžete přijít o svá nastavení. --- # Instalace na Windows Tato kapitola popisuje, jak stáhnout software nopCommerce, nahrát jej na server a nainstalovat. Na našem [kanálu YouTube](https://www.youtube.com/watch?v=L7NGodeB9sQ) si také můžete prohlédnout videonávod k instalaci nopCommerce. Než začnete s instalací, ujistěte se, že váš webhosting splňuje [minimální požadavky pro provoz nopCommerce](xref:cs/installation-and-upgrading/technology-and-system-requirements). > [!NOTE] > > Další informace o tom, jak vybrat hosting, najdete na [této stránce](xref:cs/installation-and-upgrading/installing-nopcommerce/choose-a-hosting-company). ## Stažení nopCommerce Chcete-li nainstalovat nopCommerce na Windows, musíte jej nejprve stáhnout. Přejděte na [stránku pro stažení](https://www.nopcommerce.com/download-nopcommerce) a vyberte verzi **Balíček bez zdrojového kódu** (Package without source code) pro Windows. Jde o předkompilovanou verzi nopCommerce, kterou stačí nahrát k poskytovateli hostingu a můžete ji ihned používat. ## Nahrání souborů nopCommerce Dalším krokem je nahrání souborů nopCommerce na server. K tomu je potřeba použít připojení FTP, které umožňuje přenos souborů mezi počítači. Při nastavení postupujte takto: 1. Vyberte a stáhněte si některou z aplikací FTP klienta, kterou budete používat k přenosu souborů. 1. V ovládacím panelu hostingu najděte své přihlašovací údaje k FTP. 1. V aplikaci FTP klienta nastavte připojení mezi svým počítačem a serverem pomocí přihlašovacích údajů k FTP, které jste našli v předchozím kroku. 1. Nahrajte soubory nopCommerce na server. ## Vytvoření databáze Před spuštěním nopCommerce vytvořte v ovládacím panelu hostingu novou instanci databáze. Tato databáze bude sloužit k ukládání dat vašeho webu. > [!NOTE] > > Při vytváření databáze vyberte, pokud budete vyzváni, MS SQL Server verze *2012* nebo *vyšší*. Název databáze, název serveru (nebo IP, URL), přihlašovací jméno uživatele a heslo k databázi použijeme později během instalace. Tyto údaje jsou nutné pro připojení k databázi. ## Vytvoření nového webu V ovládacím panelu hostingu vytvořte nový web. Poté zjistěte URL, přes kterou se k tomuto webu dostanete. ## Instalace nopCommerce Pomocí URL z předchozího kroku otevřete web v prohlížeči. Při prvním otevření webu budete přesměrováni na instalační stránku: ![Instalace nopCommerce](_static/installing-local/installation.jpg) Na panelu *Informace o obchodě* (Store information) vyplňte následující údaje: - **E-mail administrátora** (Admin user email): e-mailová adresa prvního administrátora webu. - **Heslo administrátora** (Admin user password): je potřeba zadat heslo pro účet administrátora. - **Potvrzení hesla** (Confirm the password): potvrďte heslo administrátora. - **Země** (Country): vyberte zemi z rozbalovacího seznamu. Umožní to předkonfigurovat obchod podle zvolené země. Například: - stáhnout a předinstalovat jazykový balíček z oficiálního webu - předkonfigurovat některá nastavení (například PangV nebo nastavení „Zobrazovat informace o dani/dopravě“ pro Německo) - předkonfigurovat některé údaje o dopravě, nastavení DPH, měny, měrné jednotky a další. - **Vytvořit ukázková data** (Create sample data): zaškrtněte toto políčko, pokud chcete vytvořit ukázkové produkty. Doporučujeme to, abyste mohli s webem začít pracovat ještě před přidáním vlastních produktů. Tyto položky můžete kdykoli později smazat nebo zrušit jejich publikování, aby se na webu již nezobrazovaly. Na panelu *Informace o databázi* (Database information) je potřeba zadat následující údaje: - **Databáze** (Database): zde můžete vybrat Microsoft SQL Server, MySQL nebo PostgreSQL. Pokud instalujete nopCommerce na Windows, zvolte první možnost. - **Vytvořit databázi, pokud neexistuje** (Create database if it doesn't exist): pro úspěšnou instalaci doporučujeme vytvořit databázi a databázového uživatele předem. Stačí vytvořit instanci databáze a přidat k ní databázového uživatele. Instalační proces vytvoří všechny tabulky, uložené procedury a další. - **Zadat vlastní připojovací řetězec (pokročilé)** (Enter raw connection string (advanced)): zaškrtněte toto políčko, pokud chcete místo vyplňování polí pro připojení zadat **Připojovací řetězec** (Connection string). - **Název serveru** (Server name): IP, URL nebo název serveru vaší databáze. Název serveru zjistíte v ovládacím panelu hostingu. - **Název databáze** (Database name): název databáze, kterou používá nopCommerce. Pokud jste se rozhodli vytvořit databázi předem, použijte zde její název. - **Použít integrované ověřování Windows** (Use integrated Windows authentication): pokud instalujete u poskytovatele hostingu, tuto možnost nepotřebujete. - **Uživatelské jméno SQL** (SQL Username): zadejte přihlašovací jméno databázového uživatele. - **Heslo SQL** (SQL Password): zadejte heslo databázového uživatele. - **Zadat vlastní řazení (collation)** (Specify custom collation): jde o pokročilé nastavení, které by mělo zůstat nezaškrtnuté. Kliknutím na **Instalovat** (Install) spusťte proces instalace. Po dokončení instalace se zobrazí úvodní stránka vašeho nového webu. > [!NOTE] > > Tlačítko **Restartovat instalaci** (Restart installation) v dolní části instalační stránky umožňuje instalaci spustit znovu, pokud se něco pokazí. > > [!IMPORTANT] > > Pokud chcete web nopCommerce zcela obnovit do výchozího nastavení, můžete smazat soubor `appsettings.json` z adresáře `App_Data`. --- # Instalace na Linux Tato kapitola popisuje, jak nainstalovat software nopCommerce na systém Linux na příkladu *Xubuntu 22.04*: - [Instalace na Linux](#installing-on-linux) - [Instalace a konfigurace softwaru](#install-and-configure-software) - [Přidání repozitáře .NET](#add-the-net-repository) - [Instalace .NET Core Runtime](#install-the-net-core-runtime) - [Instalace MySQL Serveru](#install-mysql-server) - [Instalace nginx](#install-nginx) - [Získání nopCommerce](#get-nopcommerce) - [Vytvoření služby nopCommerce](#create-the-nopcommerce-service) - [Proces instalace](#installation-process) - [Řešení problémů](#troubleshooting) - [Gdip](#gdip) - [SSL](#ssl) - [Viz také](#see-also) ## Instalace a konfigurace softwaru .NET je k dispozici v repozitáři balíčků Ubuntu .NET backports. ### Přidání repozitáře .NET Otevřete terminál a spusťte následující příkazy: ```cmd sudo add-apt-repository ppa:dotnet/backports ``` ![Instalace nopCommerce](_static/installing-on-linux/add_repository.png) ### Instalace .NET Core Runtime Aktualizujte seznam produktů dostupných k instalaci a poté nainstalujte runtime .NET: ```cmd sudo apt-get update sudo apt-get install -y aspnetcore-runtime-10.0 ``` > [!NOTE] > > Pokud dojde k chybě, podrobné informace najdete na stránce [Install .NET SDK or .NET Runtime on Ubuntu](https://learn.microsoft.com/en-us/dotnet/core/install/linux-ubuntu-install). Všechny nainstalované runtime .NET Core zobrazíte následujícím příkazem: ```cmd dotnet --list-runtimes ``` ### Instalace MySQL Serveru Nainstalujte MySQL server ve verzi 8.0: ```cmd sudo apt-get install mysql-server-8.0 ``` ![Instalace nopCommerce](_static/installing-on-linux/install_mysql.png) Ve výchozím nastavení je heslo uživatele root prázdné; nastavíme ho. Spusťte následující příkaz pro přístup k příkazovému řádku MySQL: ```cmd sudo mysql ``` Spusťte následující příkaz ALTER USER, který přepne metodu ověřování uživatele root na mysql_native_password, jež používá heslo. Nahraďte ‘password’ požadovaným novým heslem a nezapomeňte ponechat jednoduché uvozovky kolem hesla: ```cmd ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'password'; ``` > [!NOTE] > > Pro uživatele root v MySQL je důležité zvolit silné a jedinečné heslo. Silné heslo by mělo mít alespoň 12 znaků a obsahovat kombinaci velkých a malých písmen, číslic a speciálních znaků. Zadejte **exit** a stisknutím klávesy Enter ukončete příkazový řádek MySQL. ![Instalace nopCommerce](_static/installing-on-linux/config_mysql.png) > [!NOTE] > > Pokud máte problém s nastavením hesla uživatele root na serveru MySQL, přečtěte si následující články: > [How to Reset the Root Password](https://dev.mysql.com/doc/refman/8.0/en/resetting-permissions.html) a > [MySQL Error: 'Access denied for user 'root'@'localhost'](https://stackoverflow.com/questions/41645309/mysql-error-access-denied-for-user-rootlocalhost). ### Instalace nginx Nainstalujte balíček nginx: ```cmd sudo apt-get install nginx ``` ![Instalace nopCommerce](_static/installing-on-linux/install_nginx.png) Spusťte službu nginx: ```cmd sudo systemctl start nginx ``` a zkontrolujte její stav: ```cmd sudo systemctl status nginx ``` ![Instalace nopCommerce](_static/installing-on-linux/status_nginx.png) Chcete-li nakonfigurovat nginx jako reverzní proxy, která bude přeposílat požadavky do vaší aplikace ASP.NET Core, upravte soubor /etc/nginx/sites-available/default. Otevřete jej v textovém editoru a nahraďte jeho obsah následujícím: ```cmd # Default server configuration # server { listen 80 default_server; listen [::]:80 default_server; server_name nopCommerce.com; location / { proxy_pass http://localhost:5000; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection keep-alive; proxy_set_header Host $host; proxy_cache_bypass $http_upgrade; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } # SSL configuration # # listen 443 ssl default_server; # listen [::]:443 ssl default_server; # # Note: You should disable gzip for SSL traffic. # See: https://bugs.debian.org/773332 # # Read up on ssl_ciphers to ensure a secure configuration. # See: https://bugs.debian.org/765782 # # Self signed certs generated by the ssl-cert package # Don't use them in a production server! # # include snippets/snakeoil.conf; } ``` ## Získání nopCommerce Vytvořte adresář: ```cmd sudo mkdir /var/www/nopCommerce ``` Stáhněte a rozbalte nopCommerce: ```cmd cd /var/www/nopCommerce sudo wget https://github.com/nopSolutions/nopCommerce/releases/download/release-5.00.1/nopCommerce_5.00.1_NoSource_linux_x64.zip sudo apt-get install unzip sudo unzip nopCommerce_5.00.1_NoSource_linux_x64.zip ``` Vytvořte několik adresářů potřebných ke spuštění nopCommerce: ```cmd sudo mkdir bin sudo mkdir logs ``` Změňte oprávnění souborů: ```cmd cd .. sudo chgrp -R www-data nopCommerce/ sudo chown -R www-data nopCommerce/ ``` ## Vytvoření služby nopCommerce Vytvořte soubor */etc/systemd/system/nopCommerce.service* s následujícím obsahem: ```cmd [Unit] Description=Example nopCommerce app running on Xubuntu [Service] WorkingDirectory=/var/www/nopCommerce ExecStart=/usr/bin/dotnet /var/www/nopCommerce/Nop.Web.dll Restart=always # Restart service after 10 seconds if the dotnet service crashes: RestartSec=10 KillSignal=SIGINT SyslogIdentifier=nopCommerce-example User=www-data Environment=ASPNETCORE_ENVIRONMENT=Production Environment=DOTNET_PRINT_TELEMETRY_MESSAGE=false [Install] WantedBy=multi-user.target ``` Spusťte službu: ```cmd sudo systemctl start nopCommerce.service ``` Zkontrolujte stav služby nopCommerce: ```cmd sudo systemctl status nopCommerce.service ``` ![Instalace nopCommerce](_static/installing-on-linux/status_nopCommerce.png) Restartujte server nginx: ```cmd sudo systemctl restart nginx ``` Nyní je vše připraveno a můžete přistoupit k instalaci a konfiguraci obchodu. ## Proces instalace Další postup instalace nopCommerce je stejný jako při instalaci na Windows; pokyny najdete na [tomto odkazu](xref:cs/installation-and-upgrading/installing-nopcommerce/installing-on-windows#install-nopcommerce). ## Řešení problémů ### Gdip *Pokud máte problém s načítáním obrázků v poli RichText Box (The type initializer for 'Gdip' threw an exception), stačí nainstalovat knihovnu libgdiplus*: ```cmd sudo apt-get install libgdiplus ``` ### SSL *Pokud chcete na svém webu používat SSL, nezapomeňte v souboru **appsettings.json** nastavit hodnotu `UseProxy` na **`true`***. ## Viz také - [Provoz nopCommerce na Linux VPS. Část 2](https://www.nopcommerce.com/running-nopcommerce-on-linux-vps-part-2) --- # Instalace na Microsoft Azure nopCommerce lze na Microsoft Azure nasadit třemi způsoby: 1. **FTP**. Tuto metodu použijte, pokud již máte připravený balíček k nasazení (bez zdrojového kódu). Můžete jej publikovat do místního souborového systému a poté publikované soubory nahrát přes FTP. Jak získat přihlašovací údaje FTP pro Azure? Přejděte na **[Azure.com](https://azure.microsoft.com/) → My Account → Management portal → vyberte svůj web → přejděte na Dashboard → quick glance**. Zde najdete přihlašovací údaje FTP nebo možnosti *Reset your deployment credentials* (obnovit přihlašovací údaje pro nasazení) či *Download the publish profile* (stáhnout profil publikování). V novém portálu Azure přejděte na [portal.azure.com](http://portal.azure.com/) → procházet weby → přejděte na svůj web → Properties. Zde najdete přihlašovací údaje FTP nebo možnosti *Reset your deployment credentials* či *Download the publish profile*. 1. **Visual Studio** – web deploy. Na Azure můžete nasazovat také přímo z *Visual Studia*. Stáhněte nebo získejte přihlašovací údaje pro nasazení z Azure výše uvedeným způsobem a ve *Visual Studiu* nastavte profil web deploy. 1. **Web platform installer**. nopCommerce je k dispozici v galerii aplikací Azure Web Sites. Přejděte tedy do portálu Azure a klikněte na „*start, new site, from gallery*“. Ze seznamu dostupných aplikací vyberte nopCommerce. Jakmile zadáte informace o připojení k databázi a kliknete na *`OK`*, bude nopCommerce připraven ke spuštění. >[!TIP] > > Pokud se zobrazí chyba „HTTP Error 500.32 - ANCM Failed to Load dll“, může být nutné změnit platformu na 64bitovou (v Azure: **App Settings - Settings - Configuration - General settings - Platform settings - Platform**). Jakmile je web nasazen, musíte nainstalovat nopCommerce. [Více se o tom dočtete zde](xref:cs/installation-and-upgrading/installing-nopcommerce/index). Azure podporuje více instancí od verze 3.70. To je skvělé pro škálovatelnost jakékoli aplikace. Nyní se nemusíte obávat, zda váš web zvládne mnoho návštěvníků. Co přesně tedy bylo uděláno pro podporu více instancí v Azure a webových farmách? * **Podpora účtu úložiště BLOB v Microsoft Azure**. Více informací o [účtech úložiště v Azure najdete zde](https://azure.microsoft.com/documentation/articles/storage-introduction/). *Jak konfigurovat:* * Jakmile máte v Azure nastavené úložiště BLOB, otevřete soubor `appsettings.json` (nebo `web.config` v předchozích verzích), vyhledejte element **AzureBlobStorage** a zadejte připojovací řetězec, kontejner a koncový bod úložiště BLOB. >[!IMPORTANT] > >Tato nastavení platí pro nopCommerce verze 4.80 a nižší. * Jakmile máte v Azure nakonfigurované úložiště BLOB, otevřete konfigurační stránku pluginu **Azure Blob Storage** a zadejte připojovací řetězec, kontejner a koncový bod úložiště BLOB. >[!IMPORTANT] > >Tato nastavení platí pro nopCommerce verze 4.90 a vyšší. * **Podpora distribuované cache a správy relací**. Podporovanými možnostmi jsou SQL Server a Redis. Konfiguraci SQL Serveru najdete podrobněji v sekci [DistributedCacheConfig](https://docs.nopcommerce.com/en/developer/tutorials/appsettings-json-file.html#distributedcacheconfig). Následující popis předpokládá, že jako cache server byl zvolen [Redis](http://redis.io/) (již dostupný v Azure, Amazonu a u dalších cloudových hostingových společností). *Jak konfigurovat:* * Nejprve musíte nainstalovat a nastavit Redis. Více informací o tom, [jak používat Redis v Azure, najdete zde](https://azure.microsoft.com/documentation/articles/cache-dotnet-how-to-use-azure-redis-cache/). * Poté jej musíte nakonfigurovat v nopCommerce. Chcete-li povolit ukládání do cache v Redisu, otevřete soubor `appsettings.json`. Vyhledejte konfigurační sekci **DistributedCacheConfig**. Zde nastavte **DistributedCacheType** na Redis a **Enabled** na *`true`* a poté zadejte **ConnectionString** odkazující na váš server Redis (nakonfigurovaný v prvním kroku). * Pro verzi 3.90 (a nižší) musíte také povolit Redis jako distribuovanou správu relací. Otevřete soubor `web.config`. Vyhledejte a odkomentujte element **sessionState**. Zadejte jeho atributy (například *host*, *accessKey* atd.) odkazující na váš server Redis. * Doporučená nastavení souboru `appsettings.json` pro zlepšení stability (pro nopCommerce 4.50 a nižší): * **UsePluginsShadowCopy** – nastavte na *`false`*, abyste předešli problémům s recyklací fondu IIS a horizontálním škálováním. * **Konfigurace monitorovacích agentů Azure jako crawlerů (nopCommerce 4.70 a vyšší)**. Při použití monitorování koncových bodů Azure Traffic Manager (například když je Path nastavena na `/`) nebo funkce **Always On** služby Azure App Service mohou jejich požadavky na kořenovou adresu URL při každém volání vytvořit nového zákazníka typu host. Abyste tomu zabránili, nakonfigurujte tyto user agenty jako crawlery v souboru `additional.crawlers.xml` (viz nastavení `CrawlerOnlyAdditionalUserAgentStringsPath` v `appsettings.json`): ```xml ``` * Zajistěte, aby naplánované úlohy nopCommerce běžely vždy pouze na jedné instanci. Konfigurace: * Pro verzi 3.90 (a nižší) otevřete soubor `web.config`, vyhledejte element **WebFarms** a nastavte jeho atribut **MultipleInstancesEnabled** na *`true`*. Pokud používáte Microsoft Azure Websites (nikoli cloudové služby), nastavte na *`true`* také atribut **RunOnAzureWebsites**. * U novějších verzí není nutná žádná změna konfigurace, protože spouštěč úloh využívá distribuovanou cache k zajištění, že úlohy poběží vždy pouze na jedné instanci. ## Postup instalace Další postup instalace nopCommerce je stejný jako postup instalace na Windows; návod najdete na [tomto odkazu](xref:cs/installation-and-upgrading/installing-nopcommerce/installing-on-windows#install-nopcommerce). ## Webové farmy Můžete také nakonfigurovat vyrovnávání zátěže pomocí webových farem IIS. [Více se o tom dočtete zde](xref:cs/installation-and-upgrading/installing-nopcommerce/web-farms). --- # Vyrovnávání zátěže a webové farmy v nopCommerce Vyrovnávání zátěže (load balancing) je rozdělení pracovní zátěže mezi mnoho uzlů. Obvykle se používá k vyrovnávání HTTP provozu mezi více servery, které společně fungují jako webový front end. Vyrovnávání zátěže lze v nopCommerce nakonfigurovat několika způsoby: 1. Použijte cloudová zařízení s automatickým škálováním, například Azure Web Apps od Microsoftu. [Více informací naleznete zde](xref:cs/installation-and-upgrading/installing-nopcommerce/installing-on-microsoft-azure). 1. Nakonfigurujte vyrovnávání zátěže pomocí webových farem IIS. Tento přístup je popsán níže. Než začnete konfigurovat webovou farmu pro nopCommerce, důrazně doporučujeme přečíst si [tento návod](https://docs.microsoft.com/en-us/iis/web-hosting/scenario-build-a-web-farm-with-iis-servers/overview-build-a-web-farm-with-iis-servers) od Microsoftu. Microsoft navrhuje dva způsoby vytvoření webové farmy se servery IIS: 1. Infrastruktura s lokálním obsahem (Local Content Infrastructure) 1. Infrastruktura se sdíleným síťovým obsahem (Shared Network Content Infrastructure) nopCommerce podporuje oba způsoby a replikaci obsahu zajišťuje pomocí Distributed File System Replication (DFSR), pokud používáte **Local Content Infrastructure**, nebo používá centrální umístění pro správu obsahu v případě **Shared Network Content Infrastructure**. ## Konfigurace nopCommerce Nejprve musíte v IIS nakonfigurovat počáteční nastavení webové farmy a přidat do ní první instanci svého obchodu nopCommerce. Poté musíte v administraci nopCommerce nakonfigurovat několik nastavení, aby nopCommerce mohl s webovými farmami pracovat: 1. Přejděte do **Konfigurace → Nastavení → Všechna nastavení (pokročilé)** (Configuration → Settings → All settings (advanced)). Najděte nastavení **mediasettings.useabsoluteimagepath** a změňte jeho hodnotu na *false* 1. Přejděte do **Konfigurace → Nastavení → Nastavení aplikace** (Configuration → Settings → App settings) a najděte záložku *Konfigurace distribuované mezipaměti* (Distributed cache configuration). Zaškrtněte políčko **Použít distribuovanou mezipaměť** (Use distributed cache) a zvolte preferovanou možnost: - *Redis*. V tomto případě stačí níže zadat **Připojovací řetězec** (Connection string) k vašemu serveru Redis - *SQL Server*. V tomto případě musíte nejprve v databázi připravit novou tabulku pomocí příkazu „sql-cache create“. Více o tom v [dokumentaci Microsoftu](https://docs.microsoft.com/en-us/aspnet/core/performance/caching/distributed?view=aspnetcore-5.0#distributed-sql-server-cache). Poté vyplňte pole **Připojovací řetězec** (Connection string), **Název schématu** (Schema name) a **Název tabulky** (Table name) 1. Protože naše webová farma využívá Application Request Routing (ARR) k řízení provozu pomocí proxy serveru, zaškrtněte políčko **Použít proxy servery** (Use proxy servers) 1. Klikněte na tlačítko **Uložit** (Save). Aplikace nopCommerce se restartuje. ## Konfigurace webové farmy ### Pravidlo přesměrování administrace Protože webová farma hostuje více instancí aplikace, musíte jednu z instancí nopCommerce zvolit jako primární, abyste předešli zamykání souborů. Tento primární uzel bude zpracovávat požadavky z administrace. Pravidlo by mělo vypadat takto: ```xml ``` Kde `admin.wf.local` je adresa vaší primární instance. ### Pravidla vyrovnávání zátěže Po nastavení webové farmy musíte v sekci **Application Request Routing** nakonfigurovat pravidlo vyrovnávání zátěže. Přidejte podmínku, která zabrání zpracování požadavků určených pro primární uzel (v našem případě požadavků na administraci): ```xml ``` Kde `wf-local` je název webové farmy. Výše popsaná pravidla můžete přidat dvěma způsoby: 1. Zahrnout je do souboru `applicationHost.config` (sekce **system.webServer/rewrite/globalRules**) 1. Použít sekci **URL Rewrite script** ve Správci IIS (IIS Manager) > [!NOTE] > > V některých případech má ARR problémy se zpracováním URL javascriptových souborů obsahujících více než jeden symbol „.“. Může to například ovlivnit minifikované js soubory končící na `.min.js`. Abyste předešli chybám při zpracování takových souborů, doporučujeme tyto požadavky směrovat přímo na jednu z instancí nopCommerce. Jak vidíte ve výše uvedených příkladech, děláme to pro celý adresář `lib_npm` směrováním na primární instanci. Po dokončení konfigurace přidejte do webové farmy nové instance. ### Replikace souborů Když začnete konfigurovat replikaci souborů, ujistěte se, že následující složky primární instance jsou nastaveny tak, aby podporovaly replikaci na všechny ostatní uzly (instance): - /App_Data - /Plugins - /Themes - /wwwroot > [!NOTE] > > Všechny akce, které předpokládají restart aplikace nopCommerce (například instalace pluginu, aktualizace nastavení aplikace), vyžadují ruční restart všech fondů aplikací (application pools) souvisejících s webovou farmou. --- # Předinstalovaný nopCommerce Můžete využít jednoduché a rychlé instalační řešení nopCommerce, které vytvořil tým nopCommerce ve spolupráci s naším hostingovým partnerem WinHost. Náš hostingový tarif obsahuje předinstalovanou platformu. To znamená, že můžete na svém webu začít pracovat okamžitě. ## Výhody * Není třeba ztrácet čas hledáním spolehlivého hostingu, výběrem vhodného hostingového tarifu a instalací nopCommerce. * Předinstalovaný hostingový tarif zajišťuje rychlý a spolehlivý chod nopCommerce. * WinHost nabízí pro obchody s předinstalovaným nopCommerce 30denní bezplatnou zkušební verzi hostingu. Další informace o [hostingu s předinstalovaným nopCommerce](https://www.winhost.com/a/noponwh$nopcommerce). --- # Plně spravovaný hosting v privátním cloudu pro nopCommerce Tým nopCommerce ve spolupráci s Everleap Managed Services spustil plně spravovaný hosting v privátním cloudu (Fully-managed Private Cloud hosting) pro kritické weby, který zvyšuje jejich výkon a spolehlivost. Vaši aplikaci proaktivně monitorujeme. Pokud zaznamenáme jakékoli problémy, upozorníme vás a poskytneme řešení nebo doporučení k jejich odstranění. Abychom lépe porozuměli vašim požadavkům na hosting, nabízíme vám bezplatnou konzultaci. Na základě vašich požadavků navrhneme hostingovou infrastrukturu na míru, která odpovídá potřebám vašeho podnikání, a nabídneme vám paušální měsíční poplatek. Pro vaše pohodlí nabízíme také bezplatnou migraci databáze a webu. ## Výhody používání našeho privátního cloudu *-* **Vysoký výkon.** Váš web bude na serveru jediný, takže nedochází k soupeření o prostředky, které by vedlo ke snížení výkonu. *-* **Neomezená škálovatelnost.** Škálování a upgrade vaší hostingové infrastruktury proběhne bez narušení provozu, s minimální nebo žádnou odstávkou. *-* **Paušální měsíční náklady.** Infrastruktura na míru je navržena tak, aby splňovala vaše technické a obchodní požadavky, aniž byste platili za rostoucí návštěvnost nebo jakékoli jiné aktivity uživatelů na vašem webu. *-* **Lepší zabezpečení.** Nižší bezpečnostní rizika, protože pro váš projekt existuje samostatný webový hostitel a nikdo jiný nenahraje zranitelnou aplikaci třetí strany. *-* **Bezplatná technická podpora 24/7.** Získáte také 2 hodiny pokročilých služeb podpory měsíčně (např. konzultace s DBA). [Získejte bezplatnou konzultaci](https://www.nopcommerce.com/en/private-cloud-hosting-solution?utm_source=docs_nopcommerce&utm_medium=documentation&utm_campaign=everleap-managed-solution#request-consultation) nebo se dozvíte více o [plně spravovaném hostingu v privátním cloudu](https://www.nopcommerce.com/private-cloud-hosting-solution?utm_source=docs_nopcommerce&utm_medium=documentation&utm_campaign=everleap-managed-solution) od Everleap. > \* Upozorňujeme, že počáteční cena je 199 $/měs. Pokud je váš rozpočet na hosting nižší, doporučujeme vám použít tuto [hostingovou službu](https://www.nopcommerce.com/pre-installed-nopcommerce?utm_source=docs_nopcommerce&utm_medium=documentation&utm_campaign=pre-installed). --- # Aktualizace nopCommerce Tato kapitola popisuje, jak aktualizovat nopCommerce na [nejnovější](https://www.nopcommerce.com/download-nopcommerce) verzi. Možná to budete chtít udělat, protože jste v sekci novinek nopCommerce na nástěnce viděli zprávu, že je k dispozici nové vydání. nopCommerce nepodporuje automatické aktualizace, musíte je provést ručně. > [!IMPORTANT] > > Od verze 4.40 již nepoužíváme aktualizační SQL skripty. Aktualizace se provádí automaticky pomocí migrací (při prvním spuštění aplikace). Při aktualizaci z verze 4.30 na 4.40 proto musíte vynechat krok 2 z níže uvedeného seznamu! Postupujte podle následujících kroků: 1. Zálohujte vše na svém webu včetně databáze. To je nesmírně důležité, abyste se mohli vrátit k funkčnímu webu bez ohledu na to, co se během migrace stane. 1. **[Pro aktualizaci na nopCommerce 4.30 a starší]** Poté musíte spustit aktualizační SQL skripty. Musíte je spouštět postupně. Například pokud je vaše aktuální verze 3.90 a nejnovější dostupná verze je 4.20, musíte aktualizovat na 4.00, poté na 4.10 a poté na 4.20. Stáhněte si tedy potřebné aktualizační skripty ze stránky [stažení nopCommerce](https://www.nopcommerce.com/download-nopcommerce). Po stažení aktualizačního skriptu jej spusťte nad svou databází. > [!NOTE] > > Nezapomeňte si přečíst soubor `Readme.txt` dodávaný s aktualizačním skriptem. Někdy obsahuje důležité poznámky týkající se aktualizace na nejnovější verzi. 1. Odstraňte všechny soubory předchozí verze kromě souborů JSON v adresáři 'App_Data', jako jsou `appsettings.json` a `plugins.json`. Tyto soubory je třeba uschovat, protože je později použijeme. U starších verzí: pokud existují soubory jako `dataSettings.json`, `Settings.txt` nebo `InstalledPlugins.txt`, uschovejte je také. 1. Nahrajte nové soubory webu (získejte [nejnovější verzi](https://www.nopcommerce.com/download-nopcommerce)). 1. Ověřte, že je vše v pořádku. > [!NOTE] > > Při nasazení se ujistěte, že je cílový soubor `appsettings.json` aktualizován podle nejnovější verze nopCommerce, aby produkční web nadále odkazoval na produkční databázi. Ve starších verzích nopCommerce to mohou být soubory `dataSettings.json` a `Settings.txt`. Ujistěte se také, že je soubor `plugins.json` (`InstalledPlugins.txt`) rovněž aktualizován podle nejnovější verze nopCommerce. > > [!NOTE] > >Pokud aktualizujete nopCommerce na verzi 4.50 z některé z předchozích verzí, ujistěte se, že váš připojovací řetězec obsahuje jeden z následujících parametrů: `Encrypt=false` nebo `TrustServerCertificate=True` (v závislosti na požadavcích vašeho serveru). Tyto parametry můžete do připojovacího řetězce přidat ručně v souboru \App_Data\appsettings.json. Tento krok je způsoben knihovnou `Microsoft.Data.SqlClient`, která změnila výchozí hodnotu možnosti `Encrypt` z `false` na `true`. > > [!NOTE] > > Pokud jste obrázky ukládali do souborového systému, zálohujte je také (`\wwwroot\Images\`) a po aktualizaci je zkopírujte zpět. > > [!NOTE] > > **(aktualizace z 3.X na 4.X)**: Pokud chcete aktualizovat z verze 3.90 na nejnovější verzi, musíte nejprve nainstalovat verzi 4.00 (nad stávající databázi), spustit migrační SQL skript z 3.90 na 4.00 a poté aktualizovat na 4.10, 4.20 a dále. ## Řešení problémů Pokud se po aktualizaci setkáte s problémy, můžete vždy obnovit zálohu a nahradit soubory soubory z předchozí verze. Dotaz můžete vždy položit na našem [fóru](https://www.nopcommerce.com/boards/). > [!Note] > > Pokud při pokročilém vyhledávání na našem fóru nenajdete, co potřebujete, zkuste vyhledávání Google zaměřené na web nopCommerce: [vaše hledaná slova **site:[nopcommerce.com](https://www.nopcommerce.com/ "nopcommerce.com")**]. --- # Začínáme Pokud jste v nopCommerce nováčkem, postupujte podle níže uvedených kroků a nastavte a spusťte svůj obchod: ## 1. Nakonfigurujte svůj obchod - [Konfigurace obecných nastavení obchodu](xref:cs/getting-started/advanced-configuration/your-store-information) - [Konfigurace platebních metod](xref:cs/getting-started/configure-payments/payment-methods/index) - [Konfigurace možností dopravy](xref:cs/getting-started/configure-shipping/index) - Konfigurace seznamu uživatelů: vytvořte [různé skupiny](xref:cs/running-your-store/customer-management/customer-roles) uživatelů, poskytněte jim [samostatný přístup k oblastem vašeho webu](xref:cs/running-your-store/customer-management/access-control-list) a nabídkám a další. ## 2. Vytvořte katalog a přidejte produkty Katalog je to, s čím vaši zákazníci neustále pracují. Proto je zásadní, aby se v něm dalo snadno procházet a vyhledávat potřebné produkty. ### Vytvořte kategorie a výrobce Kategorie a výrobci budou ve vašem katalogu sloužit k filtrování produktů. Naučte se s nimi pracovat, abyste usnadnili navigaci na webu. - [Kategorie](xref:cs/running-your-store/catalog/categories) - [Výrobci](xref:cs/running-your-store/catalog/manufacturers) ### Přidejte produkty Produkty můžete přidávat ručně jeden po druhém, nebo importovat katalog ze souboru xml. - [Produkty](xref:cs/running-your-store/catalog/products/index) ### Definujte varianty produktů Co když jsou vaše produkty variabilní – například prodáváte tenisky v různých barvách a velikostech? V nopCommerce můžete pro tento účel nastavit atributy specifikace a atributy produktu. - [Seskupené produkty (varianty)](xref:cs/running-your-store/catalog/products/grouped-products-variants) ## 3. Zlepšete zákaznický zážitek ve svém obchodě Nyní, když je váš katalog naplněn produkty, zajistěte, aby vaši zákazníci dostali na cestě k nákupu veškerou potřebnou podporu. ### Recenze produktů Osobní nákupní zkušenost se počítá. Dává lidem větší důvěru ve vás jako prodejce. Zde se dozvíte, jak ve svém internetovém obchodě zpřístupnit recenze produktů a jak je spravovat. - [Recenze produktů](xref:cs/running-your-store/catalog/products/product-reviews) ### Podpora přes LiveChat Vaši zákazníci se často potřebují zeptat hned a teď. Možnost LiveChat jim může dobře pomoci. Pluginy pro chat najdete na marketplace nopCommerce. - [Další informace o pluginech v nopCommerce](xref:cs/getting-started/advanced-configuration/plugins-in-nopcommerce) ### Seznamy přání Seznam přání je dobrou možností pro odložený nákup. Umožněte zákazníkům přidat některé produkty do seznamu přání, aby je mohli koupit později nebo je sdílet s přáteli. Je to také dobrá příležitost pro vás, jak analyzovat chování zákazníků. - [Nákupní košíky a seznamy přání](xref:cs/running-your-store/order-management/shopping-carts-and-wishlists) ## 4. Marketingové a propagační nástroje Marketing vašeho obchodu je nezbytný pro získání loajality zákazníků a zvýšení povědomí mezi potenciálními zákazníky. V nopCommerce je mnoho marketingových možností: můžete nabízet speciální ceny, doporučovat produkty v závislosti na nákupním chování, propagovat obchod prostřednictvím e-mailových kampaní a mnoho dalšího. - [Propagační nástroje](xref:cs/running-your-store/promotional-tools/index) ### Slevy a speciální ceny Použití speciálních cen u produktů může zákazníky motivovat, aby nakoupili dříve a (nebo) nakoupili více. - [Slevy](xref:cs/running-your-store/promotional-tools/discounts) - [Množstevní ceny](xref:cs/running-your-store/promotional-tools/tier-prices) ### Věrnostní program Funkce věrnostních bodů v nopCommerce umožňuje zákazníkům získávat body za určité akce (registrace, nákupy). - [Věrnostní body](xref:cs/running-your-store/promotional-tools/reward-points) ### Křížový marketing V nopCommerce můžete zákazníkům na základě jejich nákupního chování nabízet [další produkty](xref:cs/running-your-store/promotional-tools/cross-sells-and-related-products), které by se jim mohly líbit. Je to také dobrá příležitost k up-sellingu některých produktů. ### E-mailové kampaně Vytvářejte [e-mailové kampaně](xref:cs/running-your-store/promotional-tools/email-campaigns), abyste snadno a rychle oslovili svou cílovou skupinu speciálními nabídkami, novinkami, vzdělávacím obsahem a dalším. ## 5. Speciální funkce nopCommerce pro obchody všech typů Ať už chcete vyzkoušet malý projekt, nebo se chystáte spustit marketplace, můžete se na nopCommerce spolehnout. Existuje mnoho možností, jak splnit vaše obchodní požadavky: ### Více obchodů nopCommerce vám umožňuje provozovat z jediné instalace nopCommerce více než jeden obchod pomocí jednoho rozhraní a spravovat všechny administrativní operace z jediného panelu. [Zde se dozvíte](xref:cs/getting-started/advanced-configuration/multi-store), jak nastavit několik obchodů. - [Více obchodů](xref:cs/getting-started/advanced-configuration/multi-store) ### Více dodavatelů Nástroje pro více dodavatelů a drop shipping vám umožňují prodávat online, aniž byste museli držet zásoby nebo odesílat objednávky. Podívejte se na [videonávod](https://www.youtube.com/watch?v=MH6r6tqfLF8&index=9&list=PLnL_aDfmRHwsbhj621A-RFb1KnzeFxYz4) o podpoře více dodavatelů. - [Správa dodavatelů](xref:cs/running-your-store/vendor-management) > [!TIP] > > Pokud máte potíže s konfigurací katalogu obchodu, neváhejte položit dotaz na [komunitních fórech](http://www.nopcommerce.com/boards/forum/5/general-support) nebo si objednat služby [prémiové podpory](http://www.nopcommerce.com/nopcommerce-premium-support-services). --- # Rozhraní nopCommerce Tato kapitola popisuje základy rozhraní nopCommerce. Po přihlášení byste měli v horní části webu vidět odkaz **Administrace** (Administration). Případně můžete administraci otevřít jednoduše tak, že na konec URL svého webu přidáte `/admin`. Například `www.example.com/admin`. První obrazovkou, která se zobrazí po přihlášení do administrace nopCommerce, je *Nástěnka* (Dashboard): ![nástěnka](_static/admin-area-overview/dashboard.png) Nástěnka obsahuje následující sekce: * **Začněte přijímat objednávky** (Start accepting orders) je sekce, která obsahuje všechna hlavní témata související s nastavením obchodu. Tento průvodce vás doslova „vezme za ruku“, provede vás administrací a vysvětlí, jak vše funguje. * **Novinky nopCommerce** (nopCommerce news) je sekce, která zobrazuje důležité novinky a informace o výprodejích a akcích od nopCommerce. * **Obecné statistiky** (Common statistics) vašeho internetového obchodu, které zahrnují počty objednávek, nevyřízených žádostí o vrácení, registrovaných zákazníků a produktů s nízkými zásobami. * Další sekce zobrazující klíčové statistiky vašeho internetového obchodu: **objednávky, noví zákazníci, celkové částky objednávek, nedokončené objednávky, nejnovější objednávky, oblíbená vyhledávaná klíčová slova, nejprodávanější podle množství, nejprodávanější podle částky**: ![Statistiky](_static/admin-area-overview/stats.jpg) Více o [těchto přehledech najdete zde](xref:cs/running-your-store/reports). Sekce nástěnky lze snadno sbalit kliknutím na ikonu ![položka](_static/admin-area-overview/item.png). ## Společné prvky stránek nopCommerce ### Boční panel ![Boční panel](_static/admin-area-overview/sidebar.png) Boční panel se nachází vlevo na každé stránce administrace. Umožňuje procházet funkce administrátora nopCommerce. Boční panel lze snadno sbalit kliknutím na ikonu „hamburgeru“ vedle loga ![dashboard2](_static/admin-area-overview/hamburger.jpg) ### Vyhledávací pole ![dashboard3](_static/admin-area-overview/search.jpg) V horní části bočního panelu je vyhledávací pole. Začněte psát název sekce, na kterou chcete přejít; vyhledávací řádek automaticky navrhne možnosti a přesměruje vás přímo na požadovanou. ### Systémová nabídka ![dashboard4](_static/admin-area-overview/menu.jpg) Tato část rozhraní zobrazuje jméno přihlášeného uživatele, tlačítko pro odhlášení, odkaz na veřejnou část obchodu a malou nabídku, ze které může uživatel zvolit vymazání mezipaměti (cache) nebo restartování aplikace. ## Základní a rozšířený režim Na některých stránkách administrace uvidíte následující přepínač: ![dashboard5](_static/admin-area-overview/dashboard5.png) Tento dvoupolohový přepínač *Základní–Rozšířený* (Basic–Advanced) umožňuje přepínat mezi režimy zobrazení stránky. Pro pohodlí jsme vytvořili **Základní** (Basic) režim, ve kterém se zobrazují nejčastěji používaná nastavení. Pokud na stránce nemůžete najít požadované nastavení, přepněte do **Rozšířeného** (Advanced) režimu, kde uvidíte všechna dostupná nastavení. Na některých stránkách je vedle přepínače tlačítko **Nastavení** (Settings). Pomocí něj můžete základní režim přizpůsobit svým potřebám přidáním/odebráním požadovaných nastavení. ![dashboard6](_static/admin-area-overview/dashboard6.png) Kliknutím na **Nastavení** (Settings) zobrazíte seznam dostupných nastavení. Zaškrtněte políčka **požadovaných nastavení**. Přidaná nastavení se pak budou zobrazovat v **Základním** režimu. ![dashboard7](_static/admin-area-overview/dashboard7.png) --- # Katalog Produkty jsou základem internetového obchodu a správa produktů je velmi důležitou součástí strategie řízení vašeho obchodu. Informace o produktu pomáhají zákazníkům rozhodnout se, zda si položku chtějí koupit, či nikoli. Dbejte proto na kvalitní obsah produktů v obchodě, protože buduje důvěru zákazníků, že dostávají přesně to, co potřebují a očekávají. Nejdůležitějšími součástmi správy produktů v nopCommerce jsou přidávání produktů a výrobců, nastavení kategorií produktů pro snadnou navigaci, přidávání kvalitních popisů produktů a atraktivních obrázků, uvedení všech možných variant produktu a definování štítků produktů, aby bylo vyhledávání produktů rychlé a efektivní. ## Katalog na příkladu skutečného obchodu V následujících příkladech použijeme náš demo obchod založený na motivu „Nop Venture Theme“ od Nop-Templates. Více informací o tomto [motivu třetí strany najdete zde](https://www.nopcommerce.com/nop-venture-theme-14-plugins-nop-templatescom). Zde je několik tipů, které vám pomohou vytvořit pro zákazníky dobře navržený katalog. ### Kategorie - Při přidávání kategorií do obchodu dbejte na to, aby jasně popisovaly produkty (nebo podkategorie), které obsahují. Jako v následujícím příkladu, kde kategorie Boards obsahuje pouze prkna: ![Kategorie](_static/index/category.jpg) *Kategorie vytvoříte pomocí tlačítka **Přidat novou** (Add new) na stránce **Katalog → Kategorie** (Catalog → Categories)*. - Pokud potřebujete obecnou kategorii rozdělit na konkrétnější, použijte podkategorie. Zákazníkům to usnadní vyhledávání. Jako v příkladu níže, kde kategorie Water Sports obsahuje podkategorie Surf, Windsurf a Kitesurf: ![Podkategorie](_static/index/subcategories.jpg) *Chcete-li z kategorie udělat podkategorii, zadejte na stránce úpravy kategorie **Nadřazenou kategorii** (Parent category).* - Nejoblíbenější kategorie přidejte do horní nabídky, která je viditelná na každé stránce, a přilákejte tak více zákazníků: ![Kategorie](_static/index/categories.jpg) *K tomu použijte na stránce úpravy kategorie zaškrtávací políčko **Zahrnout do horní nabídky** (Include in top menu).* - Nejzajímavější kategorie přidejte na domovskou stránku. Tyto kategorie budou první, co zákazník při návštěvě vašeho obchodu uvidí: ![Kategorie na domovské stránce](_static/index/homepage-categories.jpg) *K tomu použijte na stránce úpravy kategorie zaškrtávací políčko **Zobrazit na domovské stránce** (Show on home page).* - Umožněte zákazníkům vyhledávat v kategoriích pomocí filtrů: ![Filtry](_static/index/filters.jpg) *Funkce filtrování využívá [atributy specifikace](xref:cs/running-your-store/catalog/products/specification-attributes).* - Umožněte zákazníkům řadit produkty a měnit režim zobrazení: ![Řazení](_static/index/sort.jpg) *Více informací o řazení najdete v sekci [Nastavení katalogu – Řazení produktů](xref:cs/running-your-store/catalog/catalog-settings#product-sorting). K nastavení režimu zobrazení použijte na stránce úpravy kategorie pole **Povolit zákazníkům zvolit velikost stránky** (Allow customers to select page size) a **Možnosti velikosti stránky** (Page size options).* Jak vytvořit kategorii, se dozvíte v kapitole [Kategorie](xref:cs/running-your-store/catalog/categories). ## Viz také - [Kategorie](xref:cs/running-your-store/catalog/categories) - [Výrobci](xref:cs/running-your-store/catalog/manufacturers) - [Atributy](xref:cs/running-your-store/catalog/products/product-attributes) - [Produkty](xref:cs/running-your-store/catalog/products/index) - [Filtr YMM (rok-značka-model)](xref:cs/running-your-store/catalog/ymm) - [Ceníky](xref:cs/running-your-store/catalog/price-lists) - [Nastavení katalogu](xref:cs/running-your-store/catalog/catalog-settings) --- # Design Tato kapitola pokrývá základy konfigurace designu vašeho obchodu. K tomuto tématu existuje samostatná příručka. V této kapitole se zabýváme procesem instalace motivu a nastavením médií. Pokud potřebujete další informace o přizpůsobení grafického motivu, nahlédněte do [příručky pro designéry](xref:cs/developer/design/index). ## Další informace naleznete v následujících kapitolách - [Výběr a instalace motivu](xref:cs/getting-started/design-your-store/choose-and-install-a-theme) - [Nastavení médií](xref:cs/getting-started/design-your-store/media-settings) --- # Výběr a instalace motivu Po stažení nového motivu, který je v souboru zip, rozbalte obsah souboru zip a zkopírujte jej do složky **Themes**, jak je znázorněno na obrázku níže: ![p1](_static/choose-and-install-a-theme/instal_theme1.jpg) 1. Přejděte na **administrace → Konfigurace → Nastavení → Obecná nastavení** (admin panel → Configuration → Settings → General settings). ![p2](_static/choose-and-install-a-theme/instal_theme2.png) 1. V poli **Výchozí motiv obchodu** (Default store theme) vyberte nový motiv a klikněte na **Uložit** (Save). 1. Přejděte do veřejné části obchodu. Měli byste vidět, že byl na obchod použit nový motiv. --- # Nahrání loga Logo webu se obvykle zobrazuje na každé stránce v záhlaví. Vaše logo bude vypadat skvěle ve většině šablon nopCommerce bez ohledu na to, kterou si vyberete a jak často ji měníte. Chcete-li na svůj web nahrát nové logo, postupujte takto: 1. Přejděte do **Konfigurace → Nastavení → Obecná nastavení** (Configuration → Settings → General settings). Zobrazí se okno *Obecná nastavení*: ![Obecná nastavení](_static/uploading-your-logo/upload.png) 1. Najděte pole **Logo**, klikněte na tlačítko **Procházet** (Browse) vedle něj a vyberte soubor s obrázkem. Vybraný obrázek se nahraje. Nahraný obrázek můžete odstranit kliknutím na tlačítko **tap to undo**. ![Obecná nastavení](_static/uploading-your-logo/tap_to_undo.png) 1. Kliknutím na tlačítko **Uložit** (Save) vpravo nahoře logo na webu aktivujete. 1. Navštivte veřejnou část webu a ověřte, že logo vypadá dobře. --- # Nahrání favikon Od verze 4.20 můžete favikony automaticky nahrávat prostřednictvím administrace. > [!NOTE] > > V případě více obchodů musíte tento postup nahrání zopakovat pro každý obchod. 1. Chcete-li nahrát favikony, přejděte do **Konfigurace → Nastavení → Obecná nastavení** (Configuration → Settings → General settings)**.** Zobrazí se panel *Favikona a ikony aplikace* (Favicon and app icons): ![settings_block](_static/adding-a-favicon/settings_block.png) 1. Klikněte na zelené tlačítko **Nahrát jednu ikonu nebo archiv ikon** (Upload single icon or icons archive); otevře se dialog pro výběr souboru: ![file_selection_dialog](_static/adding-a-favicon/file_selection_dialog0.png) Zde musíte zkopírovat cestu k vašim ikonám (liší se v závislosti na obchodu a virtuálním adresáři). Například `/icons/icons_0`. 1. Existuje několik možností, co nahrát, podle toho, jak dobře mají být favikony vašeho webu přizpůsobeny různým zařízením: - Nejúplnější možností je použít některý z generátorů favikon. V tomto návodu ukážeme příklad použití [RealFaviconGenerator](https://realfavicongenerator.net/). Díky této službě nahrajete kompletní balíček favikon několika kliknutími. - Přejděte na hlavní stránku tohoto generátoru, kde budete vyzváni k výběru obrázku pro favikonu ![realfavicongenerator](_static/adding-a-favicon/realfavicongenerator.png) - Po výběru obrázku a kliknutí na **Continue with this picture** budete přesměrováni na další stránku. Zde můžete upravit nastavení zobrazení favikon pro konkrétní zařízení a aplikace – iOS Web Clip, Android Chrome, Windows Metro, macOS Safari a další. Služba automaticky zobrazí ukázky zobrazení. Můžete si je přizpůsobit podle svých potřeb nebo ponechat výchozí. - V dolní části téže stránky najdete panel **Favicon Generator Options**. ![favicon_generator_options](_static/adding-a-favicon/favicon_generator_options.png) - V této sekci musíte nastavit určitá nastavení. Na záložce **Path** vyberte možnost `I cannot or I do not want to place favicon files at the root of my web site. Instead I will place them here` a zadejte cestu z kroku 2. ![favicon_path](_static/adding-a-favicon/favicon_path.png) - Na záložce **Version/Refresh** vyberte možnost podle toho, zda je váš web již v produkčním provozu. Pomůže vám s tím popis nastavení. ![favicon_version](_static/adding-a-favicon/favicon_version.png) - Na záložce **Additional files** je nutné vybrat možnost vygenerování html souboru v balíčku. ![favicon_additional_fields](_static/adding-a-favicon/favicon_additional_fields.png) - Nyní, když jsou všechna nastavení nastavena, klikněte na tlačítko pro generování. ![generate_button](_static/adding-a-favicon/generate_button.png) - Stáhněte si svůj balíček favikon. ![download_package](_static/adding-a-favicon/download_package.png) - Nejjednodušší možností je použít pouze soubor **favicon.ico**, který se na mnoha webech dlouhou dobu úspěšně používal, dokud se neobjevila zařízení s různým rozlišením obrazovky. - Najděte ukázkový balíček favikon, který se nachází v adresáři `wwwroot/icons/samples/`, a zkopírujte jej. - V novém balíčku odstraňte všechny soubory kromě **favicon.ico** a **html_code.html**. - Nahraďte soubor **favicon.ico** v tomto balíčku svou novou favikonou. - Upravte soubor **html_code.html**. Ponechte v něm jediný řádek: ``, za předpokladu, že `/icons/icons_0` je cesta z kroku 2. - Uložte tyto dva soubory do balíčku. Váš balíček favikon je připraven. - Střední možností je použití kompletního balíčku favikon bez generátoru. 1. Najděte ukázkový balíček favikon, který se nachází v adresáři `wwwroot/icons/samples/`, a zkopírujte jej. 1. Nahraďte obrázky v novém balíčku vlastními s ohledem na původní velikosti. 1. Upravte soubor **html_code.html** a nahraďte všechny výskyty `/icons/icons_0` cestou uloženou v kroku 2. 1. Uložte tento balíček. Váš balíček favikon je připraven. 1. Vraťte se do administrace s připraveným balíčkem favikon k nahrání. Vyberte požadovaný soubor a klikněte na **Nahrát jednu ikonu nebo archiv ikon**. ![upload_package](_static/adding-a-favicon/file_selection_dialog.png) 1. Ověřte, že byl balíček úspěšně nahrán. ![success](_static/adding-a-favicon/success.png) 1. Chcete-li novou favikonu na webu vidět, vymažte mezipaměť v administraci i v prohlížeči a poté stránku znovu načtěte. > [!TIP] > > K vytvoření balíčku favikon můžete použít libovolné generátory, služby třetích stran nebo jej vytvořit ručně. Jediným požadavkem je existence souboru **html_code.html** s HTML kódem, který bude umístěn do elementu `` stránek webu. --- # Widget Swiper Widget Swiper umožňuje zobrazit na domovské stránce vašeho obchodu posuvník (slider). ## Konfigurace pluginu Swiper Přejděte do **Konfigurace → Widgety** (Configuration → Widgets). Zobrazí se okno *Widgety*: ![Widgety](_static/swiper/widgets.png) Klikněte na **Upravit** (Edit) vedle widgetu Swiper. Okno se rozbalí následovně: ![Úprava Swiperu](_static/swiper/swiper_edit.png) Zaškrtnutím políčka **Je aktivní** (Is active) plugin povolíte. Klikněte na **Konfigurovat** (Configure). Okno *Konfigurace – Swiper* se zobrazí následovně: ![Swiper – konfigurace](_static/swiper/swiper_configure.png) Pro každý snímek, který chcete nahrát, proveďte následující: ![Swiper – přidání snímku](_static/swiper/swiper_add_slide.png) * V poli **Obrázek** (Picture) klikněte na *Procházet* a nahrajte požadovaný obrázek. * V poli **Název** (Title) zadejte název obrázku. Pokud nechcete zobrazovat žádný text, ponechte pole prázdné. * V poli **Alternativní text obrázku** (Image alternate text) zadejte alternativní text, který bude k obrázku přidán. * V poli **URL** zadejte požadovanou adresu URL, nebo jej ponechte prázdné, pokud nechcete, aby byl obrázek klikací. Klikněte na **Přidat** (Add). Nyní můžete přejít na domovskou stránku veřejné části obchodu a zobrazit aktualizovaný posuvník obrázků: ![Domovská stránka](_static/swiper/swiper_homepage.png) --- # Horní menu a zápatí > [!WARNING] > > Tento článek se týká verzí nopCommerce 4.80 a starších. Nový způsob generování menu, dostupný od nopCommerce 4.90, je popsán v článku [Menu](xref:cs/running-your-store/content-management/menu). V nopCommerce si můžete zvolit, jak se bude zobrazovat horní menu a zápatí. Do horního menu můžete zařadit nejdůležitější a nejzajímavější odkazy, abyste přilákali více zákazníků, a do zápatí přidat servisní odkazy, které vašim klientům poskytnou aktuální informace o obchodě. ## Horní menu V šabloně Default Clean vypadá horní menu takto: ![Horní menu šablony Default Clean](_static/top-menu-and-footer/top-menu.jpg) Jak vidíte, zobrazuje kategorie obchodu. Upozorňujeme, že pokud chcete, aby se kategorie zobrazovala v horním menu, musíte na stránce úpravy kategorie zaškrtnout políčko **Zahrnout do horního menu** (Include in top menu). Podrobnosti najdete níže. Do horního menu můžete zařadit následující položky: - Kategorie - Vlastní stránky (topics) - Odkazy na sekce webu Níže se dozvíte, jak jednotlivé položky přidat. ### Kategorie Chcete-li zařadit kategorii do horního menu, přejděte v administraci na stránku úpravy kategorie: zvolte **Katalog → Kategorie** (Catalog → Categories). Poté klikněte na tlačítko **Upravit** (Edit) vedle kategorie. Zobrazí se okno *Upravit podrobnosti kategorie*: ![Upravit podrobnosti kategorie](_static/top-menu-and-footer/category-details.jpg) Zaškrtněte políčko **Zahrnout do horního menu** (Include in top menu) a klikněte na **Uložit** (Save). > [!NOTE] > > Pokud je tato kategorie podkategorií, ujistěte se, že má tuto vlastnost povolenou i její nadřazená kategorie. ### Vlastní stránky (topics) Chcete-li zařadit stránku do horního menu, přejděte v administraci na stránku úpravy stránky: zvolte **Správa obsahu → Stránky** (Content management → Topics (pages)). Poté klikněte na tlačítko **Upravit** (Edit) vedle stránky. Zobrazí se okno *Upravit podrobnosti stránky*: ![Upravit podrobnosti stránky](_static/top-menu-and-footer/topic-details-top-menu.jpg) Zaškrtněte políčko **Zahrnout do horního menu** (Include in top menu) a klikněte na **Uložit** (Save). ### Odkazy na sekce webu Chcete-li zařadit některé sekce webu do horního menu, přejděte do **Konfigurace → Nastavení → Obecná nastavení** (Configuration → Settings → General settings). Pokračujte na panel *Položky horního menu* (Top menu items): ![Nastavení horního menu](_static/top-menu-and-footer/general-settings-top-menu.jpg) Z následujícího seznamu vyberte položky, které chcete v horním menu zobrazit: - **Zobrazit „Úvodní stránka“** (Display "Home page") - **Zobrazit „Nové produkty“** (Display "New products") - **Zobrazit „Vyhledávání“** (Display "Search") - **Zobrazit „Můj účet“** (Display "My account") - **Zobrazit „Blog“** (Display "Blog") - **Zobrazit „Fóra“** (Display "Forums") - **Zobrazit „Kontaktujte nás“** (Display "Contact us") Poté klikněte na **Uložit** (Save). > [!NOTE] > > Položka menu „Nové produkty“ se zobrazí pouze tehdy, je-li na stránce **Konfigurace → Nastavení → Nastavení katalogu** (Configuration → Settings → Catalog settings) povolena stránka „Nové produkty“ (panel *Další sekce*). ## Zápatí V šabloně Default Clean vypadá zápatí takto: ![Zápatí šablony Default Clean](_static/top-menu-and-footer/footer.jpg) Ve výchozím stavu zobrazuje odkazy na sekce webu seskupené do tří typů: *Informace, Zákaznický servis, Můj účet*. Kterýkoli ze zobrazených odkazů můžete odebrat nebo přidat nové. Do zápatí můžete zařadit následující položky: - Vlastní stránky (topics) - Odkazy na sekce webu Níže se dozvíte, jak jednotlivé položky přidat. ### Vlastní stránky Chcete-li zařadit stránku do zápatí, přejděte v administraci na stránku úpravy stránky: zvolte **Správa obsahu → Stránky** (Content management → Topics (pages)). Poté klikněte na tlačítko **Upravit** (Edit) vedle stránky. Zobrazí se okno *Upravit podrobnosti stránky*: ![Upravit podrobnosti stránky](_static/top-menu-and-footer/topic-details-footer.jpg) Zvolte, kde se má odkaz na stránku zobrazovat. Můžete zaškrtnout jedno nebo více políček: - **Zahrnout do zápatí (sloupec 1)** (Include in footer (column 1)) - **Zahrnout do zápatí (sloupec 2)** (Include in footer (column 2)) - **Zahrnout do zápatí (sloupec 3)** (Include in footer (column 3)) Pokud například zvolíte **Zahrnout do zápatí (sloupec 1)**, odkaz se zobrazí ve sloupci *Informace*. Kliknutím na **Uložit** (Save) uložte změny. ### Odkazy na sekce webu Chcete-li zařadit některé sekce webu do zápatí, přejděte do **Konfigurace → Nastavení → Obecná nastavení** (Configuration → Settings → General settings). Pokračujte na panel *Položky zápatí* (Footer items): ![Nastavení zápatí](_static/top-menu-and-footer/general-settings-footer.jpg) Z následujícího seznamu vyberte položky, které chcete v zápatí zobrazit: - **Zobrazit „Mapa webu“** (Display "Sitemap") > [!NOTE] > > Položka menu „Mapa webu“ se zobrazí pouze tehdy, je-li na stránce **Konfigurace → Nastavení → Obecná nastavení** (Configuration → Settings → General settings) zaškrtnuto políčko **Mapa webu povolena** (Sitemap enabled) (panel *Mapa webu*). - **Zobrazit „Kontaktujte nás“** (Display "Contact us") - **Zobrazit „Vyhledávání“** (Display "Search") - **Zobrazit „Novinky“** (Display "News") - **Zobrazit „Blog“** (Display "Blog") - **Zobrazit „Fóra“** (Display "Forums") - **Zobrazit „Naposledy zobrazené produkty“** (Display "Recently viewed products") > [!NOTE] > > Položka menu „Naposledy zobrazené produkty“ se zobrazí pouze tehdy, je-li na stránce **Konfigurace → Nastavení → Nastavení katalogu** (Configuration → Settings → Catalog settings) povolena stránka „Naposledy zobrazené produkty“ (panel *Další sekce*). - **Zobrazit „Seznam porovnávaných produktů“** (Display "Compare products list") > [!NOTE] > > Položka menu „Seznam porovnávaných produktů“ se zobrazí pouze tehdy, je-li na stránce **Konfigurace → Nastavení → Nastavení katalogu** (Configuration → Settings → Catalog settings) povolena funkce „Porovnání produktů“ (panel *Porovnání produktů*). - **Zobrazit „Nové produkty“** (Display "New products") > [!NOTE] > > Položka menu „Nové produkty“ se zobrazí pouze tehdy, je-li na stránce **Konfigurace → Nastavení → Nastavení katalogu** (Configuration → Settings → Catalog settings) povolena stránka „Nové produkty“ (panel *Další sekce*). - **Zobrazit „Můj účet“** (Display "My account") - **Zobrazit „Objednávky“** (Display "Orders") - **Zobrazit „Adresy“** (Display "Addresses") - **Zobrazit „Nákupní košík“** (Display "Shopping cart") > [!NOTE] > > Položka menu „Nákupní košík“ se konkrétnímu zákazníkovi zobrazí pouze tehdy, je-li pro roli zákazníka povoleno oprávnění „Veřejný obchod. Povolit nákupní košík“ (Public store. Enable shopping cart). Oprávnění spravujete na stránce **Konfigurace → Seznam řízení přístupu** (Configuration → Access control list). Více o oprávněních si můžete přečíst v části [Seznam řízení přístupu](xref:cs/running-your-store/customer-management/access-control-list). - **Zobrazit „Seznam přání“** (Display "Wishlist") > [!NOTE] > > Položka menu „Seznam přání“ se konkrétnímu zákazníkovi zobrazí pouze tehdy, je-li pro roli zákazníka povoleno oprávnění „Veřejný obchod. Povolit seznam přání“ (Public store. Enable wishlist). Oprávnění spravujete na stránce **Konfigurace → Seznam řízení přístupu** (Configuration → Access control list). Více o oprávněních si můžete přečíst v části [Seznam řízení přístupu](xref:cs/running-your-store/customer-management/access-control-list). - **Zobrazit „Požádat o účet dodavatele“** (Display "Apply for vendor account") > [!NOTE] > > Položka menu „Požádat o účet dodavatele“ se zobrazí pouze tehdy, je-li na stránce **Konfigurace → Nastavení → Nastavení dodavatelů** (Configuration → Settings → Vendor settings) zaškrtnuto políčko **Povolit zákazníkům požádat o účet dodavatele** (Allow customers to apply for vendor account) (panel *Obecné*). Kliknutím na **Uložit** (Save) uložte změny. ### Sledujte nás Chcete-li přizpůsobit blok **Sledujte nás** (Follow us) v zápatí, přejděte do **Konfigurace → Nastavení → Obecná nastavení** (Configuration → Settings → General settings). Pokračujte na panel *Sociální sítě* (Social media): ![Nastavení sociálních sítí](_static/top-menu-and-footer/social-media-settings.jpg) Zadejte odkazy na své sociální sítě: - **URL stránky na Facebooku** (Facebook page URL) - **URL stránky na X** (X page URL) - **URL kanálu YouTube** (YouTube channel URL) - **URL Instagramu** (Instagram URL) - **URL TikToku** (TikTok URL) - **URL Snapchatu** (Snapchat URL) - **URL Pinterestu** (Pinterest URL) - **URL Tumblru** (Tumblr URL) ### Newsletter Blok newsletteru se ve výchozím stavu zobrazuje v zápatí. Chcete-li tento blok skrýt, přejděte do **Konfigurace → Nastavení → Nastavení zákazníků** (Configuration → Settings → Customer settings). Pokračujte na panel *Účet* (Account) a zaškrtněte políčko **Skrýt pole newsletteru** (Hide newsletter box): ![Nastavení pole newsletteru](_static/top-menu-and-footer/newsletter-settings.jpg) Kliknutím na **Uložit** (Save) uložte změny. Zápatí se odpovídajícím způsobem aktualizuje. ### Powered by nopCommerce Podle licenčních podmínek nopCommerce, bez zakoupení *klíče pro odstranění copyrightu* (Copyright removal key): - NESMÍTE odstranit ani skrýt text „Powered by nopCommerce“, který se zobrazuje v dolní části každé stránky webu provozovaného na nopCommerce - Když uživatelé kliknou na text „powered by nopCommerce“, musí být přesměrováni na . Odkaz „Powered by nopCommerce“ musí mít stejný, neupravený formát, v jakém je dodán ve zdrojovém kódu programu. Tato povinnost se vztahuje i na všechny kopie a odvozená díla! - Upozornění na autorská práva v zápatí vašeho obchodu (webu) musí zůstat nedotčené, neupravené a jasně viditelné. NEPOKOUŠEJTE se upozornění na autorská práva jakkoli upravovat, odstraňovat nebo skrývat. Po zakoupení „klíče pro odstranění copyrightu“ (copyright removal key) smíte text „Powered by nopCommerce“ odstranit. Upozorňujeme, že porušování autorských práv je nezákonné. Více informací najdete na stránce [nopCommerce copyright removal key](https://nopcommerce.com/nopcommerce-copyright-removal-key?utm_source=documentation&utm_medium=link&utm_campaign=powered_by_nopcommerce&utm_content=topmenu_footer). --- # Nastavení médií Tato část popisuje, jak nastavit podrobnosti médií vašeho obchodu. Patří sem definování velikostí obrázků produktů, variant a avatarů a další. Chcete-li definovat nastavení médií, přejděte do **Konfigurace → Nastavení → Nastavení médií** (Configuration → Settings → Media settings). Na panelu *Obecné* (Common) definujte nastavení následovně: ![p1](_static/media-settings/media_sett_common.png) - Kliknutím na tlačítko **Změnit** (Change) nad volbou **Obrázky jsou uloženy v** (Pictures are stored into) zvolíte mezi databází a souborovým systémem. > [!NOTE] > > Před kliknutím na tlačítko **Změnit** se doporučuje vytvořit zálohu databáze. - Do pole **Maximální velikost obrázku** (Maximum image size) zadejte maximální velikost obrázku (tj. delší strany) povolenou pro nahrávání obrázků (v pixelech). - Zaškrtněte **Více adresářů pro náhledy** (Multiple thumb directories), chcete-li mít více adresářů pro náhledy. To je užitečné, pokud má vaše hostingová společnost omezení počtu souborů v jednom adresáři. - Do pole **Výchozí kvalita obrázku (0 - 100)** (Default image quality (0 - 100)) zadejte kvalitu nahrávaných obrázků. Po změně musíte ručně odstranit všechny již vygenerované náhledy. - Zaškrtněte **Importovat obrázky produktů pomocí hashe** (Import product images using hash), chcete-li k porovnání obrázků s nahranými produkty použít HASHBYTES. Upozorňujeme, že tuto funkci některé databáze nepodporují. - Zaškrtněte **Přiblížení obrázku** (Picture zoom), chcete-li povolit přiblížení obrázku na stránce podrobností produktu. - **Povolit nahrávání SVG v administraci** (Allow SVG uploads in admin area) – Protože formát *svg* je vektorová kresba popsaná ve formě XML, můžete pro zvýšení bezpečnosti zakázat přidávání obrázků v tomto formátu v administraci. Na panelu *Produkt* (Product) definujte nastavení následovně: ![p1](_static/media-settings/media_sett_product.png) - Do pole **Velikost obrázku v detailu produktu** (Product detail image size) zadejte výchozí velikost obrázků v detailu produktu v pixelech. - Do pole **Velikost náhledu produktu (katalog)** (Product thumbnail image size (catalog)) zadejte výchozí velikost náhledů produktů zobrazovaných na stránkách kategorií nebo výrobců v pixelech. - Do pole **Velikost náhledu produktu (stránka produktu)** (Product thumbnail image size (product page)) zadejte výchozí velikost náhledů produktů (v pixelech) zobrazovaných na stránce podrobností produktu (používá se, pokud máte více než jeden obrázek produktu). - Do pole **Velikost obrázku přidruženého produktu** (Associated product image size) zadejte výchozí velikost obrázků přidružených produktů v pixelech. Přidružené produkty jsou součástí seskupených produktů. - **Výchozí obrázek** (Default image) – Můžete vybrat výchozí obrázek, který se ve veřejném obchodě zobrazí u produktů bez obrázků. Na panelu *3D modely produktů* (Product 3D models) definujte nastavení následovně: ![p1](_static/media-settings/media_sett_3d.png) - **Ovládání kamery** (Camera control): Povoluje nebo zakazuje interakci uživatele s kamerou, což zákazníkům umožňuje ručně obíhat kolem modelu a posouvat jím. - **Přiblížení** (Zoom): Umožňuje uživatelům přibližovat a oddalovat a prohlížet si jemné detaily produktu. - **Automatické otáčení** (Auto-rotate): Povoluje automatické otáčení 3D modelu po načtení stránky, čímž upoutá pozornost na interaktivní prvek. - **Líné načítání** (Lazy loading): Odkládá načtení 3D prohlížeče a souborů modelu, dokud uživatel s galerií nezačne pracovat, čímž zrychluje počáteční načtení stránky. - **Limit velikosti nahrávaného souboru** (Upload size limit): Určuje maximální povolenou velikost souborů `.GLB` pro nahrávání, aby se zabránilo přetížení serveru a optimalizoval se výkon. Na panelu *Ostatní stránky* (Other pages) definujte nastavení následovně: ![p1](_static/media-settings/media_sett_other.png) - Do pole **Velikost náhledu kategorie** (Category thumbnail image size) zadejte výchozí velikost náhledů na stránkách kategorií v pixelech. - Do pole **Velikost náhledu výrobce** (Manufacturer thumbnail image size) zadejte výchozí velikost náhledů na stránkách výrobců v pixelech. - Do pole **Velikost náhledu dodavatele** (Vendor thumbnail image size) zadejte výchozí velikost náhledů na stránkách dodavatelů v pixelech. - Do pole **Velikost náhledu v košíku/seznamu přání** (Cart/wishlist thumbnail image size) zadejte výchozí velikost náhledů produktů v nákupním košíku a seznamu přání v pixelech. - Do pole **Velikost náhledu v mini košíku** (Mini-shopping cart thumbnail image size) zadejte výchozí velikost (v pixelech) náhledů produktů zobrazovaných v bloku mini nákupního košíku. - Do pole **Velikost obrázku avatara** (Avatar image size) zadejte výchozí velikost obrázků avatarů. Tato stránka umožňuje **konfiguraci pro více obchodů**, což znamená, že lze definovat stejná nastavení pro všechny obchody, nebo se mohou v jednotlivých obchodech lišit. Chcete-li spravovat nastavení pro určitý obchod, zvolte jeho název z rozbalovacího seznamu *Konfigurace pro více obchodů* a zaškrtněte všechna potřebná políčka na levé straně, abyste pro ně nastavili vlastní hodnotu. ## Videonávody - [Správa nastavení médií](https://www.youtube.com/watch?v=3JS4Zj4TBwQ) --- # Konfigurace plateb **Platby** jsou jádrem e-commerce. Tato sekce se věnuje globálním nastavením obchodu, která umožňují přijímat platby. > [!NOTE] > > nopCommerce spolupracuje s předními poskytovateli plateb a podporuje přední platební brány, které najdete na [marketplace](https://www.nopcommerce.com/en/marketplace) nopCommerce. Tato kapitola popisuje, jak nastavit platební metody, měny a omezení platebních metod. > [!TIP] > > Jak nainstalovat platební (nebo jakýkoli jiný) plugin, popisuje kapitola [Pluginy v nopCommerce](xref:cs/getting-started/advanced-configuration/plugins-in-nopcommerce). ## Viz také - [Platební metody](xref:cs/getting-started/configure-payments/payment-methods/index) - [Pokročilá konfigurace](xref:cs/getting-started/configure-payments/advanced-configuration/index) - [Omezení platebních metod](xref:cs/getting-started/configure-payments/advanced-configuration/payment-method-restrictions) - [Měny](xref:cs/getting-started/configure-payments/advanced-configuration/currencies) --- # Platební metody Platební metoda určuje, jakým způsobem zákazník za objednávku zaplatí. nopCommerce podporuje *online* i *offline transakce*. U online metod se nopCommerce integruje s platebními bránami třetích stran, takže údaje o platební kartě zákazníka jsou po dokončení objednávky automaticky odeslány přes bránu (buď jako autorizace, nebo jako autorizace a stržení platby). Současně můžete mít aktivních více platebních metod. Zákazník si způsob platby může vybrat v pokladně. Chcete-li definovat platební metody, přejděte do **Konfigurace → Platební metody** (Configuration → Payment methods). > [!TIP] > > Ve výchozím nastavení je v nopCommerce k dispozici několik platebních metod, další platební pluginy však najdete na [marketplace](https://www.nopcommerce.com/marketplace) nopCommerce. Podrobnosti o vývoji platebních metod naleznete v [dokumentu](xref:cs/developer/plugins/payment-method). ![metody](_static/index/payment-methods.jpg) Chcete-li platební metodu aktivovat, klikněte na **Upravit** (Edit) vedle požadované metody, zaškrtněte políčko **Je aktivní** (Is active) a klikněte na **Aktualizovat** (Update). Volba **Je aktivní** se změní z *false* na *true*. Různé platební metody podporují různé možnosti. Existují **4 platební možnosti**, které platební metoda může, ale nemusí podporovat: * **Podporuje zachycení** (Supports capture) udává, zda tato metoda umožňuje zpracovat převod peněz poté, co byla částka stržena. * **Vrácení peněz** (Refund) udává, že tato metoda umožňuje vrátit peníze poté, co byla částka stržena a zachycena. * **Částečné vrácení peněz** (Partial refund) udává, zda tato metoda umožňuje částečně vrátit peníze poté, co byla částka stržena a zachycena. * **Zrušení** (Void) udává, zda tato metoda umožňuje vrátit peníze předtím, než byla částka stržena (když je stav platby čekající). * **Podpora opakovaných plateb** (Recurring support) udává, zda tato metoda umožňuje opakované platby. Kliknutím na **Konfigurovat** (Configure) vedle platební metody ji nastavíte. ## Viz také * [PayPal Commerce](xref:cs/getting-started/configure-payments/payment-methods/paypal-commerce) * [PayPal Zettle](xref:cs/getting-started/configure-payments/payment-methods/paypal-zettle) * [PayPal Standard](xref:cs/getting-started/configure-payments/payment-methods/paypal-standard) * [PayPal Smart Payment Buttons](xref:cs/getting-started/configure-payments/payment-methods/paypal-smart-payment-buttons) * [Šek/poštovní poukázka](xref:cs/getting-started/configure-payments/payment-methods/check-money-order) * [Platební karta (ruční zpracování)](xref:cs/getting-started/configure-payments/payment-methods/credit-card-manual-processing) --- # PayPal Commerce `PayPal Commerce` nabízí vašim kupujícím zjednodušené a bezpečné prostředí pokladny. PayPal automaticky a inteligentně zobrazuje vašim nakupujícím nejrelevantnější platební typy, takže mohou snáze dokončit nákup pomocí metod, jako jsou platby kreditní kartou, Apple Pay, Google Pay, PayPal Credit, Venmo, iDEAL, Bancontact a další platební typy. ## Konfigurace platební metody Chcete-li nakonfigurovat plugin `PayPal Commerce`, přejděte do **Konfigurace → Platební metody** (Configuration → Payment methods). Poté na této stránce najděte platební metodu **PayPal**. Nebude to obtížné, protože jde o naši doporučenou platební metodu. ![Seznam](_static/paypal-commerce/list.png) Přístup ke konfiguraci pluginu je k dispozici také z navigační nabídky. ![Seznam](_static/paypal-commerce/list_2.png) Při konfiguraci `PayPal Commerce` postupujte podle těchto kroků: ### 1. Připojení účtu PayPal Nezáleží na tom, zda již máte firemní účet PayPal, pouze osobní účet, nebo žádný účet; připojení začíná vždy stejně: 1. Otevřete v administraci konfigurační stránku PayPal Commerce. Zobrazí se následující formulář: ![Registrace PayPal Commerce](_static/paypal-commerce/onboarding.png) 1. Vyberte typ účtu, který chcete připojit: produkční nebo sandbox. Pokud chcete plugin nejprve otestovat, povolte nastavení **Použít sandbox** (Use sandbox). 1. Klikněte na tlačítko **Sign up for PayPal** a zobrazí se následující vyskakovací okno, ve kterém můžete vyplnit potřebné údaje a připojit účet: ![Vyskakovací okno registrace PayPal Commerce](_static/paypal-commerce/popup-form-first-page.png) K vyplnění všech požadovaných údajů budete muset projít několika kroky; počet údajů se bude lišit podle toho, zda vytváříte nový účet, připojujete existující, nebo převádíte osobní účet na firemní. 1. Jakmile budete hotovi a budete schváleni k používání plateb PayPal, vraťte se na konfigurační stránku pluginu a obnovte ji. Zobrazí se následující formulář: ![Registrace PayPal Commerce dokončena](_static/paypal-commerce/onboarding-completed.png) Zde uvidíte oznámení o úspěšném připojení; pokud se objeví varování nebo chyby, podrobnosti zjistíte v **Systém → Protokol** (System → Log). Zobrazí se zde také stav procesu připojení účtu; pokud některý z kroků není dokončen, přihlaste se do svého osobního účtu PayPal a tento krok dokončete. Pokud jste připojili sandboxový účet, zobrazí se také připomínka, že po dokončení testování je potřeba vytvořit produkční účet. 1. Pokud již máte ve svém účtu PayPal vytvořenou aplikaci REST API a chcete ji nadále používat, zaškrtněte políčko **Zadat přihlašovací údaje API ručně** (Specify API credentials manually) a zadejte přihlašovací údaje do polí níže takto: ![Přihlašovací údaje PayPal Commerce](_static/paypal-commerce/credentials.png) ### 2. Konfigurace pluginu 1. Najděte platební metodu **PayPal Commerce** na stránce **Konfigurace → Platební metody** (Configuration → Payment methods) a klikněte na **Konfigurovat** (Configure); zobrazí se následující blok nastavení: ![Konfigurace PayPal Commerce](_static/paypal-commerce/configuration.png) * Zvolte **Typ platby** (Payment type), chcete-li platbu buď zachytit (capture) okamžitě, nebo platbu za objednávku po jejím vytvoření pouze autorizovat. * Zaškrtněte **Použít vlastní pole karty** (Use Custom Card Fields), chcete-li ve svém obchodě povolit pokročilé platby kreditními a debetními kartami. Jde o řešení vyhovující standardu PCI pro přijímání plateb debetními a kreditními kartami přímo ve vašem obchodě, aniž by zákazníci museli být přesměrováni na weby třetích stran. * Zaškrtněte **Použít Apple Pay** (Use Apple Pay), chcete-li ve svém obchodě povolit Apple Pay. Než začnete v prostředí sandbox/produkce, ověřte všechny názvy domén ve svém prostředí, na kterých se bude zobrazovat tlačítko Apple Pay. Transakce Apple Pay fungují pouze na doméně a webu, které jsou registrovány na vás. 1. [Stáhněte si](https://paypalobjects.com/devdoc/apple-pay/well-known/apple-developer-merchantid-domain-association) soubor přidružení domény pro své prostředí. 1. Umístěte soubor na svůj web pro každou doménu a subdoménu, kterou chcete registrovat, na adresu */.well-known/apple-developer-merchantid-domain-association*. 1. Přihlaste se do obchodnického účtu PayPal, přejděte do **Payment Methods**, poté v sekci **Apple Pay** vyberte odkaz **Manage** a zde použijte **Add Domain**. * Zaškrtněte **Použít Google Pay** (Use Google Pay), chcete-li ve svém obchodě povolit Google Pay. * Zaškrtněte **Použít alternativní platební metody** (Use Alternative Payments Methods), chcete-li ve svém obchodě povolit alternativní platební metody. Díky alternativním platebním metodám mohou zákazníci po celém světě platit prostřednictvím svých bankovních účtů, peněženek a dalších místních platebních metod. Například zákazník v Nizozemsku může chtít platit pomocí iDEAL, kterou pro online nákupy používá více než polovina spotřebitelů v Nizozemsku, zatímco zákazník v Belgii na stejném webu může chtít platit pomocí Bancontact, která je tam oblíbenou platební metodou. Plugin ve výchozím nastavení automaticky vykreslí všechna způsobilá tlačítka na jednom místě. * Zaškrtněte **Použít Vault** (Use Vault), chcete-li povolit PayPal Vault. Umožňuje bezpečně ukládat platební údaje zákazníků a používat je v dalších transakcích, aniž by zákazníci museli platební údaje zadávat znovu. * Zaškrtněte **Přeskočit stránku „Potvrzení objednávky“** (Skip 'Confirm Order' page), chcete-li tento krok během pokladny přeskočit, takže po schválení platby na webu PayPal budou zákazníci přesměrováni přímo na stránku „Objednávka dokončena“. * Zaškrtněte **Použít sledování zásilek** (Use shipment tracking), chcete-li používat sledování balíků. Chcete-li automaticky synchronizovat stav zásilky s PayPal, zadejte při vytváření nebo úpravě zásilky v administraci sledovací číslo a dopravce: ![Zásilka](_static/paypal-commerce/shipment.png) 1. Poté přejděte na panel *Výrazné zobrazení PayPal* (Feature PayPal Prominently): ![Konfigurace PayPal Commerce](_static/paypal-commerce/display-settings.png) Na tomto panelu definujte nastavení zobrazení: * Zaškrtněte políčko **Zobrazit tlačítka v nákupním košíku** (Display buttons on shopping cart), chcete-li na stránce nákupního košíku zobrazit tlačítka PayPal vedle výchozího tlačítka pokladny. * Zaškrtněte políčko **Zobrazit tlačítka v detailu produktu** (Display buttons on product details), chcete-li zobrazit tlačítka PayPal na stránkách s detaily produktu, což kupujícím umožní dokončit nákup bez procházení celé pokladny. * Zaškrtněte políčko **Zobrazit logo v odkazech záhlaví** (Display logo in header links), chcete-li v odkazech záhlaví zobrazit logo PayPal. Tato loga a bannery jsou skvělým způsobem, jak dát kupujícím najevo, že k bezpečnému zpracování jejich plateb jste zvolili PayPal. * Je-li předchozí políčko zaškrtnuto, zobrazí se pole **Zdrojový kód loga** (Logo source code). Do tohoto pole zadejte zdrojový kód loga. Další loga a bannery najdete v PayPal Logo Center. Kód můžete také upravit tak, aby správně zapadal do vašeho motivu a stylu webu. * Zaškrtněte políčko **Zobrazit logo v patičce** (Display logo in footer), chcete-li v patičce zobrazit logo PayPal. Tato loga a bannery jsou skvělým způsobem, jak dát kupujícím najevo, že k bezpečnému zpracování jejich plateb jste zvolili PayPal. * Je-li předchozí políčko zaškrtnuto, zobrazí se pole **Zdrojový kód loga** (Logo source code). Do tohoto pole zadejte zdrojový kód loga. Další loga a bannery najdete v PayPal Logo Center. Kód můžete také upravit tak, aby správně zapadal do vašeho motivu a stylu webu. 1. Kliknutím na **Uložit** (Save) uložte nastavení pluginu. > [!NOTE] > > Plugin není nutné aktivovat, bude povolen ihned po instalaci. Pokud jej z nějakého důvodu nehodláte ve svém obchodě používat, můžete jej zakázat na stránce **Konfigurace → Lokální pluginy** (Configuration → Local plugins). ### 3. Konfigurace zpráv PayPal Pay Later PayPal nabízí krátkodobé bezúročné platby a další speciální možnosti financování, které mohou kupující využít k tomu, aby nakoupili hned a zaplatili později, zatímco prodejci dostanou zaplaceno předem. Nabídky Pay Later se liší podle země. Díky nabídkám Pay Later mohou prodejci nakupujícím poskytnout větší kupní sílu a flexibilitu rozložit náklady na nákupy v čase. Více informací o Pay Later naleznete na stránce [Buy now, pay later](https://www.paypal.com/digital-wallet/ways-to-pay/buy-now-pay-later). 1. Klikněte na odkaz **Pay Later** v položce nabídky **Konfigurace → PayPal Commerce** (Configuration → PayPal Commerce); zobrazí se následující konfigurátor: ![PayPal Commerce Pay Later](_static/paypal-commerce/pay-later-settings.png) Zde si můžete přizpůsobit zprávy Pay Later. 1. Kliknutím na **Publish Shanges** uložte konfiguraci. ## Omezení na obchody a role zákazníků Jakoukoli platební metodu můžete omezit na obchod a roli zákazníka. To znamená, že metoda bude k dispozici pouze určitým obchodům nebo rolím zákazníků. Můžete to provést na stránce *seznamu pluginů*. 1. Přejděte do **Konfigurace → Lokální pluginy** (Configuration → Local plugins). Najděte plugin, který chcete omezit. V našem případě jde o **PayPal Commerce**. Pro rychlejší nalezení použijte panel *Hledat* (Search) v horní části stránky a vyhledávejte podle **Názvu pluginu** (Plugin name) nebo **Skupiny** (Group) pomocí možnosti *Platební metody* (Payment methods). ![Lokální pluginy](_static/paypal-commerce/local-plugins.png) 1. Klikněte na tlačítko **Upravit** (Edit) a zobrazí se okno *Upravit detaily pluginu* (Edit plugin details) takto: ![Úprava pluginu](_static/paypal-commerce/edit-plugin.png) 1. Můžete nastavit následující omezení: * V poli **Omezeno na role zákazníků** (Limited to customer roles) zvolte jednu nebo několik rolí zákazníků, tj. administrátory, dodavatele, hosty, kteří budou moci tento plugin používat. Pokud tuto možnost nepotřebujete, ponechte pole prázdné. > [!Important] > > Abyste mohli tuto funkci používat, musíte vypnout následující nastavení: **Nastavení katalogu → Ignorovat pravidla ACL (pro celý web)** (Catalog settings → Ignore ACL rules (sitewide)). Přečtěte si více o [seznamu řízení přístupu](xref:cs/running-your-store/customer-management/access-control-list). * Pomocí možnosti **Omezeno na obchody** (Limited to stores) omezíte tento plugin na určitý obchod. Pokud máte více obchodů, vyberte ze seznamu jeden nebo několik. Pokud tuto možnost nepoužíváte, ponechte pole prázdné. > [!Important] > > Abyste mohli tuto funkci používat, musíte vypnout následující nastavení: **Nastavení katalogu → Ignorovat pravidla „omezení na obchod“ (pro celý web)** (Catalog settings → Ignore "limit per store" rules (sitewide)). Přečtěte si více o [funkcionalitě více obchodů](xref:cs/getting-started/advanced-configuration/multi-store). 1. Klikněte na **Uložit** (Save). --- # PayPal Zettle *PayPal Zettle* je kompletní řešení pokladního místa (POS), které vám umožňuje přijímat platby kartou, bezkontaktní a mobilní platby. Snadno se synchronizuje s vaším obchodem nopCommerce a pomáhá vám podnikat tam, kde prodáváte dnes a kde plánujete prodávat zítra – ať už online, v kamenné prodejně nebo na cestách. K registraci použijte své údaje PayPal a propojte účty během několika minut, aby vaše tržby mohly být připisovány přímo na váš účet PayPal. ## Konfigurace metody POS Chcete-li nakonfigurovat plugin `PayPal Zettle`, přejděte do **Konfigurace → POS** (Configuration → POS). Poté vyhledejte POS řešení **PayPal Zettle**: ![Seznam](_static/paypal-zettle/find.jpg) Při konfiguraci `PayPal Zettle` postupujte podle těchto kroků. 1. Vytvořte firemní účet PayPal (Business) Pokud již účet PayPal máte, pokračujte rovnou další částí. Pokud ne, zaregistrujte si firemní účet podle těchto pokynů. Poté si stáhněte aplikaci PayPal Zettle POS a objednejte si čtečku karet. ![krok1](_static/paypal-zettle/signUp1step.png) > [!NOTE] > > Pokud již účet máte, budete přesměrováni na autorizaci. ![krok2](_static/paypal-zettle/signUp2step.png) ![krok3](_static/paypal-zettle/signUp3step.png) ![krok4](_static/paypal-zettle/signUp4step.png) ![krok5](_static/paypal-zettle/signUp5step.png) 1. Nakonfigurujte plugin PayPal Zettle Otevřete v administraci konfigurační stránku PayPal Zettle. Zobrazí se následující formulář: ![Konfigurace pluginu](_static/paypal-zettle/configure_plugin.jpg) 1. Přejděte do svého **obchodnického účtu** (merchant account). ![Konfigurace pluginu](_static/paypal-zettle/merchant_account.jpg) Zkontrolujte informace a klikněte na **Create key**. Spolu s klíčem API bude vytvořeno ID klienta (Client ID). ![Vytvoření klíče API](_static/paypal-zettle/create_api_key_1.jpg) Na stránce **Create API key** klikněte na **Copy key** a vložte klíč do pole na konfigurační stránce tohoto pluginu; totéž proveďte pro **Client ID**. ![Vytvoření klíče API](_static/paypal-zettle/create_api_key_2.jpg) > [!NOTE] > > Klíč API se zobrazí pouze jednou, proto si jej nezapomeňte zkopírovat. Kliknutím na **Uložit** (Save) uložte nastavení pluginu. Po zadání se zobrazí informace o aktuálním stavu připojení, tlačítko pro odpojení a některé údaje profilu. Pokud během připojení dojde k chybám nebo k nesouladu mezi nastavením obchodu a profilem *Zettle*, zobrazí se varování. Pro správnou funkci pluginu bychom je měli opravit. ![Vytvoření klíče API](_static/paypal-zettle/configure_connected.jpg) 1. Synchronizace knihovny produktů Synchronizace knihovny produktů je hlavní funkcí pluginu. Synchronizace se konfiguruje na stejné stránce v samostatném panelu. Nerozlišujeme mezi počáteční synchronizací a aktualizacemi. Vše se konfiguruje a spouští na jednom místě, bez ohledu na to, zda jde o počáteční synchronizaci nebo další pravidelné aktualizace. ![Synchronizace](_static/paypal-zettle/sync.jpg) > [!TIP] > > Zde máme úplný návod, jak provést synchronizaci, a ke každému bodu je k dispozici nápověda. Zdrojem pravdy je obchod nopCommerce, takže synchronizace produktů je jednosměrná – z obchodu nopCommerce do katalogu Zettle. Přitom si můžeme zvolit, zda produkty v katalogu smazat, nebo je ponechat. Synchronizace může být automatická (naplánovaná úloha) nebo ji může obchodník spustit ručně z této stránky. Pro automatickou synchronizaci musíme zapnout **Enable auto synchronization** a nastavit **Auto synchronization period**. Před synchronizací musíme zvolit, které produkty chceme importovat do katalogu *Zettle*. K tomu slouží tabulka pod nastaveními. ![Synchronizace](_static/paypal-zettle/sync2.jpg) Synchronizovány budou pouze produkty, které jsou zahrnuty v této tabulce. V budoucnu se všechny změny produktu (aktualizace údajů, smazání, změna obrázku atd.) budou synchronizovat s katalogem. Synchronizaci konkrétního produktu lze pozastavit (vlastnost **Active**). > [!NOTE] > > Nastavení **Sync enabled** (totéž jako **Active**), **Price sync enabled**, **Image sync enabled**, **Inventory tracking enabled** se uplatní při přidání produktu do tabulky, jde tedy o výchozí nastavení. Lze je nastavit také pro každý konkrétní produkt. Během synchronizace se importuje buď samotný produkt, nebo jeho kombinace atributů produktu, pokud jsou uvedeny. Při synchronizaci můžeme také přidat existující slevy. 1. Synchronizace skladových zásob Druhou funkcí pluginu je **synchronizace skladových zásob** (Inventory Synchronization). Tato synchronizace funguje oběma směry – pro změny v obchodě (nopCommerce) i pro změny v katalogu (Zettle). Abychom mohli sledovat skladové zásoby produktu, musíme zapnout **Inventory tracking enabled**. Při další synchronizaci se sledování zapne a změny se začnou synchronizovat. Pokud již sledování u produktu nepotřebujeme, musíme tuto možnost odpovídajícím způsobem vypnout. Nyní bychom měli uložit nastavení synchronizace a **spustit** ji. > [!TIP] > > Podrobnosti o průběhu synchronizace najdete v protokolu. > ![Protokol](_static/paypal-zettle/log.jpg) ## Omezení na obchody a role zákazníků Jakoukoli platební metodu můžete omezit na obchod a roli zákazníka. To znamená, že metoda bude dostupná pouze pro určité obchody nebo role zákazníků. Můžete to provést na stránce *seznamu pluginů*. 1. Přejděte do **Konfigurace → Lokální pluginy** (Configuration → Local plugins). Najděte plugin, který chcete omezit. V našem případě jde o **PayPal Zettle**. Chcete-li jej najít rychleji, použijte panel *Hledat* v horní části stránky a vyhledávejte podle **Názvu pluginu** (Plugin name) nebo **Skupiny** (Group) pomocí možnosti *Platební metody* (Payment methods). ![Pluginy](_static/paypal-zettle/plugins.jpg) 1. Klikněte na tlačítko **Upravit** (Edit) a zobrazí se okno *Upravit podrobnosti pluginu* (Edit plugin details): ![Úprava](_static/paypal-zettle/edit.jpg) 1. Můžete nastavit následující omezení: * V poli **Omezeno na role zákazníků** (Limited to customer roles) zvolte jednu nebo několik rolí zákazníků, tj. administrátory, dodavatele, hosty, kteří budou moci tento plugin používat. Pokud tuto možnost nepotřebujete, ponechte pole prázdné. > [!Important] > > Chcete-li tuto funkci používat, musíte vypnout následující nastavení: **Nastavení katalogu → Ignorovat pravidla ACL (pro celý web)** (Catalog settings → Ignore ACL rules (sitewide)). Více informací o [seznamu řízení přístupu](xref:cs/running-your-store/customer-management/access-control-list). * Pomocí možnosti **Omezeno na obchody** (Limited to stores) omezíte tento plugin na určitý obchod. Pokud máte více obchodů, vyberte ze seznamu jeden nebo několik. Pokud tuto možnost nepoužíváte, ponechte pole prázdné. > [!Important] > > Chcete-li tuto funkci používat, musíte vypnout následující nastavení: **Nastavení katalogu → Ignorovat pravidla „omezení na obchod“ (pro celý web)** (Catalog settings → Ignore "limit per store" rules (sitewide)). Více informací o [funkci více obchodů](xref:cs/getting-started/advanced-configuration/multi-store). Klikněte na **Uložit** (Save). --- # PayPal Standard > [!Important] > > Tento plugin je v současné době zastaralý a byl nahrazen pluginem [**PayPal Commerce**](xref:cs/getting-started/configure-payments/payment-methods/paypal-commerce). PayPal Standard je nejjednodušší způsob, jak bezpečně přijímat online platby kartou a přes PayPal. Chcete-li nakonfigurovat plugin PayPal Standard, přejděte do **Konfigurace → Platební metody** (Configuration → Payment methods). Poté v seznamu platebních metod najděte platební metodu **PayPal Standard**: ![Seznam](_static/paypal-standard/list.jpg) ## Aktivace metody, úprava jejího názvu a pořadí zobrazení Můžete upravit název platební metody, který se bude zákazníkům zobrazovat ve veřejném obchodě, nebo její pořadí zobrazení. Za tímto účelem klikněte na stránce seznamu platebních metod na tlačítko **Upravit** (Edit) v řádku pluginu. Budete moci zadat **Zobrazovaný název** (Friendly name) a **Pořadí zobrazení** (Display order). V tomto řádku můžete také plugin aktivovat nebo deaktivovat pomocí pole **Je aktivní** (Is active). Klikněte na tlačítko **Aktualizovat** (Update). Vaše změny budou uloženy. ## Konfigurace platební metody Chcete-li používat plugin **PayPal Standard** jako platební metodu, postupujte podle těchto kroků: 1. Zaregistrujte si obchodní účet (Business account) na [https://www.paypal.com/bizsignup](https://www.paypal.com/bizsignup/). Poté vyplňte informace o sobě a své firmě: ![krok1](_static/paypal-standard/signUp1step.png) > [!NOTE] > > Pokud již účet máte, budete přesměrováni na přihlášení. ![krok2](_static/paypal-standard/signUp2step.png) ![krok3](_static/paypal-standard/signUp3step.png) ![krok4](_static/paypal-standard/signUp4step.png) ![krok5](_static/paypal-standard/signUp5step.png) 1. V horním navigačním panelu klikněte na ikonu **Settings** (Nastavení) ![nastavení](_static/paypal-standard/settings_icon.png) 1. V levém panelu vyberte **Website payments** a v řádku **Website preferences** klikněte na **Update**. ![websitepayments](_static/paypal-standard/websitepaymentsppal.png) 1. V sekci **Auto return for website payments** nastavte přepínač na **On.** Jako **Return URL** zadejte URL svého webu, na který budou po platbě zákazníka zasílána ID transakcí od PayPal. V našem případě je to `http://localhost:15536/Plugins/PaymentPayPalStandard/PDTHandler`, nezapomeňte však nahradit localhost URL svého webu. ![autoreturnURLPP](_static/paypal-standard/autoreturnURLPP.png) 1. V sekci **Payment data transfer** nastavte přepínač na **On** a zkopírujte **Identity Token.** ![PDTtoken](_static/paypal-standard/PDTtoken.png) 1. Chcete-li plugin nakonfigurovat v administraci nopCommerce, přejděte do **Konfigurace → Platební metody** (Configuration → Payment methods). V řádku **PayPal Standard** klikněte na **Konfigurovat** (Configure). ![nopconfig](_static/paypal-standard/nopConfigPP.png) 1. Do pole **Business Email** zadejte e-mail uvedený při registraci obchodního účtu na paypal.com. 1. Do pole **PDT Identity Token** zadejte zkopírovaný **Identity Token** z bodu č. 5. 1. Klikněte na **Uložit** (Save). Aktivace **IPN** (Instant Payment Notification): 1. V levém panelu vyberte **Notifications** a v řádku **Instant payment notifications** klikněte na **Update**. ![oznámení](_static/paypal-standard/notificationsPP.png) 1. Seznamte se s informacemi o **IPN** a klikněte na **Choose IPN Settings**. ![chooseIPN](_static/paypal-standard/chooseIPNSettings.png) 1. Vyberte **Receive IPN messages (Enabled)**. Jako **Notification URL** zadejte URL svého obslužného programu IPN. ![editIPN](_static/paypal-standard/editIPN.png) 1. Klikněte na **Save.** Měla by se zobrazit zpráva, že jste IPN úspěšně aktivovali. > [!NOTE] > > Instant Payment Notification (IPN) je služba zpráv PayPal, která odešle oznámení, když dojde ke změně transakce. Po integraci IPN mohou prodejci automatizovat svůj back office, takže nemusí čekat na připsání plateb, aby mohli spustit vyřízení objednávky. ## Omezení na obchody a role zákazníků Kteroukoli platební metodu můžete omezit na obchod a roli zákazníka. To znamená, že metoda bude dostupná pouze pro určité obchody nebo role zákazníků. Můžete to provést ze stránky *seznamu pluginů*. 1. Přejděte do **Konfigurace → Místní pluginy** (Configuration → Local plugins). Najděte plugin, který chcete omezit. V našem případě je to **PayPal Standard**. Chcete-li jej najít rychleji, použijte panel *Hledat* (Search) v horní části stránky a vyhledávejte podle **Názvu pluginu** (Plugin name) nebo **Skupiny** (Group) s možností *Platební metody* (Payment methods). ![Pluginy](_static/paypal-standard/plugin.jpg) 1. Klikněte na tlačítko **Upravit** (Edit) a zobrazí se okno *Upravit podrobnosti pluginu* (Edit plugin details): ![Pluginy](_static/paypal-standard/edit.jpg) 1. Můžete nastavit následující omezení: - V poli **Omezeno na role zákazníků** (Limited to customer roles) vyberte jednu nebo více rolí zákazníků, tj. administrátory, dodavatele, hosty, kteří budou moci tento plugin používat. Pokud tuto možnost nepotřebujete, ponechte pole prázdné. > [!IMPORTANT] > > Abyste mohli tuto funkci používat, musíte vypnout následující nastavení: **Nastavení katalogu → Ignorovat pravidla ACL (v celém webu)** (Catalog settings → Ignore ACL rules (sitewide)). Více o [seznamu řízení přístupu](xref:cs/running-your-store/customer-management/access-control-list). - Pomocí možnosti **Omezeno na obchody** (Limited to stores) omezíte tento plugin na určitý obchod. Pokud máte více obchodů, vyberte ze seznamu jeden nebo více. Pokud tuto možnost nepoužíváte, ponechte pole prázdné. > [!IMPORTANT] > > Abyste mohli tuto funkci používat, musíte vypnout následující nastavení: **Nastavení katalogu → Ignorovat pravidla „omezení podle obchodu“ (v celém webu)** (Catalog settings → Ignore "limit per store" rules (sitewide)). Více o [funkci více obchodů](xref:cs/getting-started/advanced-configuration/multi-store). - Klikněte na **Uložit** (Save). ## Známé problémy ### Chyba: Things don't appear to be working at the moment (PayPal) Pokud se zobrazí chyba „Things don't appear to be working at the moment. Please try again later“ ![paypalerror](_static/paypal-standard/file-6jjW2AH7yT.png) Chybu způsobuje nastavení ve vašem účtu PayPal. **Krok 1**: Na levém postranním panelu v části „Products & Services“ klikněte na „Website Payments“ **Krok 2**: Klikněte na „Update“ vedle sekce „Website Preferences“ **Krok 3**: Posuňte se dolů k sekci „Encrypted Website Payments“, vpravo vyberte „Off“ a poté změny uložte. ![encryptedwebsitepayments](_static/paypal-standard/file-c2yKWw2xMN.png) Po uložení změny se můžete vrátit na svůj web a znovu vyzkoušet tlačítko/formuláře – měly by fungovat. --- # PayPal Smart Payment Buttons > [!Important] > > Tento plugin je v současnosti zastaralý a byl nahrazen pluginem [**PayPal Commerce**](xref:cs/getting-started/configure-payments/payment-methods/paypal-commerce). PayPal Checkout s chytrými platebními tlačítky (Smart Payment Buttons) nabízí vašim zákazníkům zjednodušenou a bezpečnou pokladnu. PayPal inteligentně a automaticky nabízí nakupujícím nejrelevantnější typy plateb, což jim usnadňuje dokončení nákupu pomocí metod jako Pay with Venmo, PayPal Credit, platby kartou, iDEAL, Bancontact, Sofort a dalších typů plateb. ## Video návod Podívejte se na tento [video návod](https://youtu.be/lJxVqjwUFkY) a zjistěte, jak nakonfigurovat PayPal Smart Payment Buttons. ## Konfigurace platební metody Plugin PayPal Smart Payment Buttons nakonfigurujete v **Konfigurace → Platební metody** (Configuration → Payment methods). Poté v seznamu platebních metod najděte platební metodu **PayPal Smart Payment Buttons**: ![Seznam](_static/paypal-smart-payment-buttons/list.jpg) Při konfiguraci PayPal Smart Payment Buttons postupujte takto: ### 1. Aktivace platební metody Klikněte na tlačítko **Upravit** (Edit) v řádku pluginu na stránce se seznamem platebních metod. Plugin aktivujte zaškrtnutím políčka **Je aktivní** (Is active). Klikněte na tlačítko **Aktualizovat** (Update). Změny se uloží. ### 2. Vytvoření účtu PayPal Pokud již účet PayPal máte, pokračujte rovnou k [další části](#3-set-up-the-paypal-developer-dashboard). Zaregistrujte si firemní účet (Business account) na [PayPal](https://www.paypal.com/us/webapps/mpp/referral/paypal-business-account2?partner_id=9JJPJNNPQ7PZ8). Poté vyplňte informace o sobě a své firmě: ![Krok 1](_static/paypal-smart-payment-buttons/signUp1step.png) > [!NOTE] > > Pokud již účet máte, budete přesměrováni na přihlášení. ![Krok 2](_static/paypal-smart-payment-buttons/signUp2step.png) ![Krok 3](_static/paypal-smart-payment-buttons/signUp3step.png) ![Krok 4](_static/paypal-smart-payment-buttons/signUp4step.png) ![Krok 5](_static/paypal-smart-payment-buttons/signUp5step.png) ### 3. Nastavení PayPal Developer Dashboard 1. Přihlaste se do [Developer Dashboard](https://developer.paypal.com/developer/applications) pomocí přihlašovacích údajů ke svému účtu PayPal. 1. V části **My Apps & Credentials** pomocí přepínače přepínejte mezi aplikacemi pro ostrý provoz (live) a testovacími aplikacemi (sandbox). ![My Apps & Credentials](_static/paypal-smart-payment-buttons/my-apps.jpg) 1. Přejděte do sekce *REST API apps* a klikněte na **Create App**. ![Create App](_static/paypal-smart-payment-buttons/rest.jpg) 1. Zadejte název své aplikace a klikněte na **Create App**. Otevře se stránka s detaily aplikace, na které se zobrazí vaše přihlašovací údaje. 1. Zkopírujte a uložte si **Client ID** a **Secret** své aplikace. 1. Zkontrolujte detaily aplikace, a pokud jste provedli nějaké změny, aplikaci uložte. ### 4. Konfigurace platební metody v nopCommerce 1. Na stránce **Konfigurace → Platební metody** (Configuration → Payment methods) najděte platební metodu **PayPal Smart Payment Buttons** a klikněte na **Konfigurovat** (Configure). Zobrazí se stránka *Konfigurace – PayPal Smart Payment Buttons*: ![Konfigurace](_static/paypal-smart-payment-buttons/configure.jpg) 1. Na stránce *Konfigurace – PayPal Smart Payment Buttons* definujte následující nastavení: * **Použít sandbox** (Use sandbox), pokud chcete platební metodu nejprve otestovat. * Zadejte **Client ID**, které jste si uložili v předchozích krocích. * Zadejte **Secret**, který jste si uložili v předchozích krocích. * Zvolte **Typ platby** (Payment type) – buď okamžité zachycení platby (capture), nebo autorizaci platby za objednávku po jejím vytvoření. 1. Poté přejděte na panel *PayPal Prominently*: ![Create App](_static/paypal-smart-payment-buttons/display.jpg) Na tomto panelu definujte nastavení zobrazení: * Zaškrtnutím políčka **Zobrazit tlačítka v nákupním košíku** (Display buttons on shopping cart) se na stránce nákupního košíku místo výchozího tlačítka pokladny zobrazí tlačítka PayPal. * Zaškrtnutím **Zobrazit tlačítka na detailu produktu** (Display buttons on product details) se tlačítka PayPal zobrazí na stránkách detailu produktu; kliknutí na ně se chová stejně jako výchozí tlačítko „Přidat do košíku“. * Zaškrtnutím políčka **Zobrazit logo v odkazech záhlaví** (Display logo in header links) se v odkazech záhlaví zobrazí logo PayPal. Tato loga a bannery jsou skvělým způsobem, jak dát zákazníkům najevo, že k bezpečnému zpracování jejich plateb používáte PayPal. * Pokud je předchozí políčko zaškrtnuté, zobrazí se pole **Zdrojový kód loga** (Logo source code). Do tohoto pole zadejte zdrojový kód loga. Další loga a bannery najdete v PayPal Logo Center. Kód můžete také upravit tak, aby správně zapadl do vaší šablony a stylu webu. * Zaškrtnutím políčka **Zobrazit logo v patičce** (Display logo in footer) se v patičce zobrazí logo PayPal. Tato loga a bannery jsou skvělým způsobem, jak dát zákazníkům najevo, že k bezpečnému zpracování jejich plateb používáte PayPal. * Pokud je předchozí políčko zaškrtnuté, zobrazí se pole **Zdrojový kód loga** (Logo source code). Do tohoto pole zadejte zdrojový kód loga. Další loga a bannery najdete v PayPal Logo Center. Kód můžete také upravit tak, aby správně zapadl do vaší šablony a stylu webu. Kliknutím na **Uložit** (Save) uložíte nastavení pluginu. ## Omezení na obchody a role zákazníků Jakoukoli platební metodu můžete omezit na obchod a roli zákazníka. To znamená, že metoda bude k dispozici pouze pro určité obchody nebo role zákazníků. Můžete to provést na stránce *seznamu pluginů*. 1. Přejděte do **Konfigurace → Lokální pluginy** (Configuration → Local plugins). Najděte plugin, který chcete omezit. V našem případě je to **PayPal Smart Payment Buttons**. Chcete-li jej najít rychleji, použijte panel *Hledat* v horní části stránky a vyhledávejte podle **Názvu pluginu** (Plugin name) nebo **Skupiny** (Group) s možností *Platební metody*. ![Pluginy](_static/paypal-smart-payment-buttons/plugins.jpg) 1. Klikněte na tlačítko **Upravit** (Edit) a zobrazí se okno *Upravit detaily pluginu*: ![Úprava](_static/paypal-smart-payment-buttons/edit.jpg) 1. Můžete nastavit následující omezení: * V poli **Omezeno na role zákazníků** (Limited to customer roles) zvolte jednu nebo více rolí zákazníků, tj. administrátory, dodavatele, hosty, kteří budou moci tento plugin používat. Pokud tuto možnost nepotřebujete, ponechte pole prázdné. > [!Important] > > Chcete-li tuto funkci použít, musíte vypnout následující nastavení: **Nastavení katalogu → Ignorovat pravidla ACL (pro celý web)** (Catalog settings → Ignore ACL rules (sitewide)). Přečtěte si více o [seznamu řízení přístupu](xref:cs/running-your-store/customer-management/access-control-list). * Pomocí možnosti **Omezeno na obchody** (Limited to stores) omezíte tento plugin na určitý obchod. Pokud máte více obchodů, vyberte ze seznamu jeden nebo několik. Pokud tuto možnost nepoužíváte, ponechte pole prázdné. > [!Important] > > Chcete-li tuto funkci použít, musíte vypnout následující nastavení: **Nastavení katalogu → Ignorovat pravidla „omezení na obchod“ (pro celý web)** (Catalog settings → Ignore "limit per store" rules (sitewide)). Přečtěte si více o [funkci více obchodů](xref:cs/getting-started/advanced-configuration/multi-store). Klikněte na **Uložit** (Save). --- # Šek/peněžní poukázka Šeky/peněžní poukázky často používají státní instituce nebo velké firmy. Místo přímé platby prostřednictvím vašeho webu vás nakupující požádají o zaslání **Objednávky (Purchase order, PO)** a platbu vám pošlou zpět. Většina zpracování objednávky probíhá mimo software. Chcete-li tuto platební metodu nakonfigurovat, přejděte do **Konfigurace → Platební metody** (Configuration → Payment methods). V seznamu platebních metod najděte **Check/money order (Payments.CheckMoneyOrder)**: ![Seznam](_static/check-money-order/list.jpg) ## Aktivace metody, úprava jejího názvu a pořadí zobrazení Můžete upravit název platební metody, který se bude zákazníkům zobrazovat ve veřejné části obchodu, nebo její pořadí zobrazení. Za tímto účelem klikněte na tlačítko **Upravit** (Edit) v řádku pluginu na stránce seznamu platebních metod. Budete moci zadat **Zobrazovaný název** (Friendly name) a **Pořadí zobrazení** (Display order). V tomto řádku můžete také plugin aktivovat nebo deaktivovat pomocí pole **Je aktivní** (Is active). Klikněte na tlačítko **Aktualizovat** (Update). Vaše změny budou uloženy. ## Konfigurace platební metody Na stránce **Konfigurace → Platební metody** (Configuration → Payment methods) najděte platební metodu **Check/money order (Payments.CheckMoneyOrder)** a klikněte na tlačítko **Konfigurovat** (Configure). Zobrazí se okno *Konfigurovat - Šek/peněžní poukázka* (Configure - Check/money order) takto: ![purchaseorder](_static/check-money-order/purchaseorder.png) Platební metodu nastavte takto: * Do pole **Popis** (Description) zadejte informace, které se zákazníkům zobrazí během pokladny. * Definujte **Dodatečný poplatek** (Additional fee) za použití této metody. * V poli **Dodatečný poplatek. Použít procenta** (Additional fee. Use percentage) určete, zda se má na celkovou částku objednávky uplatnit dodatečný procentuální poplatek. Pokud není povoleno, použije se pevná hodnota. * Pole **Vyžadován produkt k odeslání** (Shippable product is required) určuje, zda jsou pro zobrazení této platební metody během pokladny vyžadovány produkty, které lze odeslat. Klikněte na **Uložit** (Save). ## Omezení na obchody a role zákazníků Jakoukoli platební metodu můžete omezit na obchod a roli zákazníka. To znamená, že metoda bude k dispozici pouze určitým obchodům nebo rolím zákazníků. Můžete to provést na stránce *seznamu pluginů*. 1. Přejděte do **Konfigurace → Lokální pluginy** (Configuration → Local plugins). Najděte plugin, který chcete omezit. V našem případě jde o **Check/money order**. Pro rychlejší nalezení použijte panel *Hledat* (Search) v horní části stránky a vyhledávejte podle **Názvu pluginu** (Plugin name) nebo **Skupiny** (Group) pomocí možnosti *Platební metody* (Payment methods). ![Pluginy](_static/check-money-order/plugin.jpg) 1. Klikněte na tlačítko **Upravit** (Edit) a zobrazí se okno *Upravit detaily pluginu* (Edit plugin details) takto: ![Pluginy](_static/check-money-order/edit.jpg) 1. Můžete nastavit následující omezení: * V poli **Omezeno na role zákazníků** (Limited to customer roles) zvolte jednu nebo několik rolí zákazníků, tj. administrátory, dodavatele, hosty, kteří budou moci tento plugin používat. Pokud tuto možnost nepotřebujete, ponechte pole prázdné. > [!Important] > > Abyste mohli tuto funkci používat, musíte vypnout následující nastavení: **Nastavení katalogu → Ignorovat pravidla ACL (pro celý web)** (Catalog settings → Ignore ACL rules (sitewide)). Přečtěte si více o [seznamu řízení přístupu](xref:cs/running-your-store/customer-management/access-control-list). * Pomocí možnosti **Omezeno na obchody** (Limited to stores) omezíte tento plugin na určitý obchod. Pokud máte více obchodů, vyberte ze seznamu jeden nebo několik. Pokud tuto možnost nepoužíváte, ponechte pole prázdné. > [!Important] > > Abyste mohli tuto funkci používat, musíte vypnout následující nastavení: **Nastavení katalogu → Ignorovat pravidla „omezení na obchod“ (pro celý web)** (Catalog settings → Ignore "limit per store" rules (sitewide)). Přečtěte si více o [funkcionalitě více obchodů](xref:cs/getting-started/advanced-configuration/multi-store). Klikněte na **Uložit** (Save). --- # Platební karta (ruční zpracování) Jedná se o speciální platební plugin, který umožňuje úspěšně zadat všechny objednávky na webu, ale ve skutečnosti zákazníkovi NIC NESTRHNE ani nevolá žádnou živou platební bránu. Tuto platební metodu doporučujeme použít, pokud chcete provést některou z následujících činností: * Zpracovávat všechny objednávky offline * Zpracovávat je ručně prostřednictvím jiného back-office systému * Otestovat web od začátku do konce před spuštěním do ostrého provozu Chcete-li tuto platební metodu nakonfigurovat, přejděte do **Konfigurace → Platební metody** (Configuration → Payment methods). Poté v seznamu platebních metod vyhledejte platební metodu **Credit card (Payments.Manual)**: ![Seznam](_static/credit-card-manual-processing/list.jpg) ## Aktivace metody, úprava jejího názvu a pořadí zobrazení Můžete upravit název platební metody, který se zákazníkům zobrazí ve veřejné části obchodu, nebo její pořadí zobrazení. Klikněte k tomu na stránce se seznamem platebních metod na tlačítko **Upravit** (Edit) v řádku pluginu. Budete moci zadat **Přátelský název** (Friendly name) a **Pořadí zobrazení** (Display order). V tomto řádku můžete pomocí pole **Je aktivní** (Is active) také plugin aktivovat nebo deaktivovat. Klikněte na tlačítko **Aktualizovat** (Update). Vaše změny budou uloženy. ## Konfigurace platební metody Na stránce **Konfigurace → Platební metody** (Configuration → Payment methods) vyhledejte platební metodu **Credit card (Payments.Manual)** a klikněte na tlačítko **Konfigurovat** (Configure). Okno *Konfigurace – Platební karta* se zobrazí následovně: ![Ruční zpracování](_static/credit-card-manual-processing/manualprocessing.png) Platební metodu nastavte takto: * V poli **Po dokončení pokladny označit platbu jako** (After checkout mark payment as) určete režim transakce. * Definujte **Dodatečný poplatek** (Additional fee) za použití této metody. * V poli **Dodatečný poplatek. Použít procenta** (Additional fee. Use percentage) určete, zda se má na celkovou částku objednávky použít dodatečný procentní poplatek. Pokud tato možnost není povolena, použije se pevná hodnota. Klikněte na **Uložit** (Save). ## Omezení na obchody a role zákazníků Libovolnou platební metodu můžete omezit na obchod a roli zákazníka. To znamená, že metoda bude k dispozici pouze pro určité obchody nebo role zákazníků. Můžete to provést na stránce *seznamu pluginů*. 1. Přejděte do **Konfigurace → Místní pluginy** (Configuration → Local plugins). Vyhledejte plugin, který chcete omezit. V našem případě je to **Credit card**. Abyste jej našli rychleji, použijte panel *Hledat* v horní části stránky a vyhledávejte podle **Názvu pluginu** (Plugin name) nebo **Skupiny** (Group) s volbou *Platební metody* (Payment methods). ![Pluginy](_static/credit-card-manual-processing/plugin.jpg) 1. Klikněte na tlačítko **Upravit** (Edit) a okno *Upravit podrobnosti pluginu* (Edit plugin details) se zobrazí následovně: ![Pluginy](_static/credit-card-manual-processing/edit.jpg) 1. Můžete nastavit následující omezení: * V poli **Omezeno na role zákazníků** (Limited to customer roles) vyberte jednu nebo více rolí zákazníků, například administrátory, dodavatele nebo hosty, kteří budou moci tento plugin používat. Pokud tuto možnost nepotřebujete, ponechte pole prázdné. > [!Important] > > Abyste mohli tuto funkci používat, musíte vypnout následující nastavení: **Nastavení katalogu → Ignorovat pravidla ACL (pro celý web)** (Catalog settings → Ignore ACL rules (sitewide)). Přečtěte si více o [seznamu řízení přístupu](xref:cs/running-your-store/customer-management/access-control-list). * Pomocí možnosti **Omezeno na obchody** (Limited to stores) omezíte tento plugin na určitý obchod. Pokud máte více obchodů, vyberte ze seznamu jeden nebo několik. Pokud tuto možnost nepoužíváte, ponechte pole prázdné. > [!Important] > > Abyste mohli tuto funkci používat, musíte vypnout následující nastavení: **Nastavení katalogu → Ignorovat pravidla „omezení na obchod“ (pro celý web)** (Catalog settings → Ignore "limit per store" rules (sitewide)). Přečtěte si více o [funkci více obchodů](xref:cs/getting-started/advanced-configuration/multi-store). Klikněte na **Uložit** (Save). ## Videonávody * [Konfigurace platební metody Platební karta (ruční zpracování)](https://www.youtube.com/watch?v=dN2q27dKvUU) --- # Pokročilá konfigurace - [Omezení platebních metod](xref:cs/getting-started/configure-payments/advanced-configuration/payment-method-restrictions) - [Měny](xref:cs/getting-started/configure-payments/advanced-configuration/currencies) --- # Omezení platebních metod Omezení platebních metod umožňují omezit platby přicházející z určitých zemí. Chcete-li platební metodu omezit, přejděte do **Konfigurace → Omezení plateb** (Configuration → Payment restrictions). ![paymentmethodrestrictions](_static/payment-method-restrictions/payment_method_restrictions.png) Zaškrtněte políčko (políčka) u země nebo zemí, ve kterých má být platební metoda (platební metody) nedostupná. Klikněte na **Uložit** (Save). > [!NOTE] > > V případě potřeby můžete vybrat celý sloupec omezení pro všechny země. --- # Měny V nopCommerce se **používá pouze primární měna obchodu**. Primární měna obchodu je měna, vůči které se konfigurují všechny ostatní povolené měny. Přestože nopCommerce umožňuje zobrazovat ceny produktů ve více měnách, pro platební transakce s online platebními bránami se používá primární měna. Pokud používáte online platební bránu (například PayPal), odešle se do platební brány částka, která bude odpovídat ceně zadané v primární měně obchodu. Primární měnu obchodu používají pouze administrátoři obchodu. Používá se k nastavování cen produktů a nemusí být shodná s publikovanými měnami. Pokud máte publikovanou pouze jednu měnu, obchod nezobrazí ani výběr měny, ani symbol měny u cen. Pokud je publikováno více měn, všechny ceny budou označeny aktuálně vybranou měnou. nopCommerce doporučuje odstranit všechny měny, které nejsou potřeba. nopCommerce používá k výpočtu částek v publikovaných měnách **směnný kurz**. Směnný kurz se zadává při přidání nebo úpravě měny. Alternativně můžete k výpočtu částky použít službu **směnných kurzů v reálném čase** a cena produktu bude vynásobena poskytnutým směnným kurzem. Směnné kurzy se denně mění. Směnný kurz proto můžete upravovat tak často, jak je potřeba, abyste měli aktuální údaje. Skutečné transakce se zpracovávají pouze v primární měně vašeho obchodu. U transakcí platebními kartami banky obvykle provádějí směnu automaticky na základě nejaktuálnějších kurzů měn. Chcete-li definovat nastavení měn, přejděte do **Konfigurace → Měny** (Configuration → Currencies). ![Měny](_static/currencies/currencies1.png) V rozbalovacím seznamu **Aktuální poskytovatel směnných kurzů** (Current exchange rate provider) vyberte poskytovatele směnných kurzů, který bude použit k získávání aktuálních kurzů. > [!NOTE] > > Ve výchozím nastavení je v nopCommerce k dispozici pouze jeden poskytovatel směnných kurzů — ECB. Chcete-li získávat aktuální kurzy od ECB, musíte jako primární měnu pro směnné kurzy vybrat EUR. Zaškrtněte políčko **Automatická aktualizace povolena** (Auto update enabled), chcete-li povolit automatickou aktualizaci kurzů měn každou hodinu. Klikněte na **Uložit** (Save). > [!NOTE] > > Ve výchozím nastavení se všechny kurzy měn aktualizují jednou za hodinu. Nastavení aktualizace kurzů měn můžete změnit v **Systém → Naplánované úlohy** (System → Schedule tasks); zvolte **Aktualizovat směnné kurzy měn** (Update currency exchange rates). ![Naplánovaná úloha](_static/currencies/tasks.jpg) ## Přidání nové měny Klikněte na tlačítko **Přidat nový** (Add new). ![currencies3](_static/currencies/currencies3.png) Definujte nastavení měny: * **Název** (Name) měny. * **Kód měny** (Currency code). Seznam kódů měn naleznete na: * Zadejte směnný **Kurz** (Rate) vůči primárnímu směnnému kurzu měny. * V rozbalovacím seznamu **Zobrazovací národní prostředí** (Display locale) vyberte národní prostředí pro zobrazení hodnot měny. * Zadejte **Vlastní formátování** (Custom formatting), které se použije na hodnoty měny. V tomto poli můžete určit libovolné symboly pro zobrazení měny ve veřejném obchodě, počet desetinných míst a další. * V poli **Omezeno na obchody** (Limited to stores) vyberte z rozbalovacího seznamu předem vytvořený obchod. Pokud tuto funkci nepotřebujete, nechte pole prázdné. > [!NOTE] > > Abyste mohli tuto funkci používat, musíte vypnout následující nastavení: **Nastavení katalogu → Ignorovat pravidla „omezení na obchod“ (pro celý web)** (Catalog settings → Ignore "limit per store" rules (sitewide)). Přečtěte si více o [funkci více obchodů](xref:cs/getting-started/advanced-configuration/multi-store). * V rozbalovacím seznamu **Typ zaokrouhlení** (Rounding type) zvolte jeden z typů zaokrouhlení: * *Výchozí zaokrouhlení* * *Zaokrouhlení nahoru v intervalech 0,05 (0,06 se zaokrouhlí na 0,10)* * *Zaokrouhlení dolů v intervalech 0,05 (0,06 se zaokrouhlí na 0,05)* * *Zaokrouhlení nahoru v intervalech 0,10 (1,05 se zaokrouhlí na 1,10)* * *Zaokrouhlení dolů v intervalech 0,10 (1,05 se zaokrouhlí na 1,00)* * *Zaokrouhlení v intervalech 0,50* * *Zaokrouhlení v intervalech 1,00 (1,01–1,49 se zaokrouhlí na 1,00, 1,50–1,99 se zaokrouhlí na 2,00)* * *Zaokrouhlení nahoru v intervalech 1,00 (1,01–1,99 se zaokrouhlí na 2,00)* * Zaškrtněte políčko **Publikováno** (Published), aby tato měna byla viditelná a návštěvníci vašeho obchodu si ji mohli vybrat. nopCommerce podporuje zobrazování cen ve více měnách. Pokud máte několik publikovaných měn, zákazníci si budou moci vybrat požadovanou měnu. * Do pole **Pořadí zobrazení** (Display order) zadejte pořadí zobrazení této měny. Hodnota 1 představuje začátek seznamu. Klikněte na **Uložit** (Save). ## Získání aktuálních kurzů Klikněte na tlačítko **Získat aktuální kurzy** (Get live rates) v pravém horním rohu okna *Měny*. V dolní části stránky se rozbalí panel: ![Aktuální kurzy](_static/currencies/live-rates.jpg) Zde klikněte na **Použít vše** (Apply all) nebo použijte nové kurzy pro všechny potřebné měny ručně pomocí tlačítka **Použít kurz** (Apply rate). ## Videonávody * [Správa měn v nopCommerce](https://www.youtube.com/watch?v=2nzVxGyc5-M) --- # Konfigurace dopravy Tato část se zabývá procesem konfigurace dopravy a správou více skladů v nopCommerce. Zahrnuje jak ruční konfiguraci dopravy, tak nastavení dopravy prostřednictvím API jednotlivých poskytovatelů dopravy, jako je UPS. Upozorňujeme, že nopCommerce nabízí integraci se službami dopravy a optimalizacemi třetích stran. Najdete je na [marketplace](http://www.nopcommerce.com/marketplace) nopCommerce a v sekci [technologických partnerů](http://www.nopcommerce.com/technology-partners). ## Viz také * [Nastavení dopravy](xref:cs/getting-started/configure-shipping/shipping-settings) * [Poskytovatelé dopravy](xref:cs/getting-started/configure-shipping/shipping-providers/index) * [Sklady](xref:cs/getting-started/configure-shipping/advanced-configuration/warehouses) * [Data a rozsahy](xref:cs/getting-started/configure-shipping/advanced-configuration/dates-and-ranges) * [Měrné jednotky](xref:cs/getting-started/configure-shipping/advanced-configuration/measures) * [Výdejní místa](xref:cs/getting-started/configure-shipping/advanced-configuration/pickup-points) * [Země, státy](xref:cs/getting-started/configure-shipping/advanced-configuration/countries-states) --- # Nastavení dopravy Tato kapitola popisuje, jak nastavit podrobnosti dopravy obchodu. Kromě umístění a nastavení skladu tvoří dobrou logistiku i další věci. Chcete-li spravovat nastavení dopravy, přejděte do **Konfigurace → Nastavení → Nastavení dopravy** (Configuration → Settings → Shipping settings). Na panelu *Obecné* (Common) definujte nastavení dopravy následovně: ![Nastavení dopravy](_static/shipping-settings/shipping-settings-common.jpg) * Zaškrtněte **Povolit odhad dopravy (stránka košíku)** (Estimate shipping enabled (cart page)), chcete-li na stránce nákupního košíku zobrazovat odhadované informace o dopravě na základě doručovací adresy zákazníka. Jak to vypadá, uvidíte na snímku obrazovky níže. * Zaškrtněte **Povolit odhad dopravy (stránka produktu)** (Estimate shipping enabled (product page)), chcete-li na stránce s podrobnostmi produktu zobrazovat odhadované informace o dopravě na základě doručovací adresy zákazníka. Jak to vypadá, uvidíte na snímku obrazovky níže. ![Odhad dopravy](_static/shipping-settings/estimate-shipping.png) * Zaškrtnutím políčka **Použít název města pro odhad dopravy** (Use a city name for estimate shipping) umožníte zákazníkům zadat místo PSČ název města. * Zaškrtněte **Povoleno „Vyzvednutí na prodejně“** ("Pick up in store" enabled), chcete-li během pokladny v kroku doručovací adresy zobrazovat možnost vyzvednutí na prodejně. Uživatelé uvidí následující obrazovku: ![Doručovací adresa](_static/shipping-settings/shipping-address.png) ![Adresa výdejního místa](_static/shipping-settings/Pickup-Point-address.png) * V případě potřeby zaškrtněte políčko **Ignorovat dodatečný poplatek za dopravu při vyzvednutí na prodejně** (Ignore additional shipping charge for pick up in store). * Zvolte **Zobrazit výdejní místa na mapě** (Display pickup points on the map), pokud je chcete zobrazovat v Google Maps. Je-li tato možnost vybrána, zákazníci by neměli zadávat doručovací adresu ani volit způsob dopravy. * **Klíč API Google Maps** (Google maps API key). Pokud je předchozí nastavení zapnuto, zadejte zde klíč API Google Maps. > [!Note] > > Pro možnost „Vyzvednutí na prodejně“ můžete také stanovit poplatek. Přejděte k tomu do **Konfigurace → Doprava → Výdejní místa** (Configuration → Shipping → Pickup points) a nakonfigurujte příslušného poskytovatele výdejních míst. Více informací najdete zde: [Výdejní místa](xref:cs/getting-started/configure-shipping/advanced-configuration/pickup-points). * Zaškrtnutím **Doprava zdarma nad „x“** (Free shipping over 'x') povolíte dopravu zdarma pro objednávky nad určitou celkovou částku. Poté se zobrazí následující pole, ve kterém můžete definovat hodnotu „x“. * Do pole **Hodnota „x“** (Value of 'x') zadejte hodnotu, nad kterou budou mít všechny objednávky s vyšší celkovou částkou nárok na dopravu zdarma. * **Počítat „x“ včetně daně** (Calculate 'x' including tax). Pokud tato možnost není vybrána, hodnota se počítá bez daně. * Zaškrtněte **Použít umístění skladu** (Use warehouse location), chcete-li jej použít při dotazu na ceny dopravy. To je užitečné, pokud odesíláte z více skladů. * Zaškrtněte **Zohlednit rozměry a hmotnost přidružených produktů** (Consider associated products dimensions and weight), chcete-li při dopravě zohledňovat rozměry a hmotnost přidružených produktů; zrušte zaškrtnutí například v případě, že je hlavní produkt již zahrnuje. * V rozevíracím seznamu **Řadit způsoby dopravy podle** (Sort shipping methods by) vyberte pole, podle kterého se mají způsoby dopravy řadit. Na panelu *Oznámení* (Notifications) definujte nastavení dopravy následovně: ![Nastavení dopravy – oznámení](_static/shipping-settings/shipping-settings-notifications.jpg) * V případě potřeby zaškrtněte **Upozornit zákazníka na odeslání z více míst** (Notify customer about shipping from multiple locations). To je užitečné, pokud odesíláte z více skladů. * Zaškrtněte **Zobrazit události zásilky (zákazníci)** (Display shipment events (customers)), chcete-li zákazníkům umožnit zobrazit události zásilky na stránce s podrobnostmi zásilky. > [!NOTE] > > Poznámka: aby mohla být tato funkce povolena, musí ji podporovat metoda výpočtu dopravy. * Zaškrtněte **Zobrazit události zásilky (majitelé obchodu)** (Display shipment events (store owners)), chcete-li majitelům obchodu umožnit zobrazit události zásilky na stránce s podrobnostmi zásilky. > [!NOTE] > > Poznámka: aby mohla být tato funkce povolena, musí ji rovněž podporovat metoda výpočtu dopravy. Poté definujte nastavení *pokladny* (checkout): ![Nastavení dopravy – pokladna](_static/shipping-settings/shipping-settings-checkout.jpg) * Zaškrtněte políčko **Skrýt celkovou cenu dopravy, pokud doprava není vyžadována** (Hide shipping total if shipping not required), chcete-li skrýt popisek *Doprava celkem*, pokud doprava není vyžadována. * Zaškrtnutím políčka **Doručit na stejnou adresu** (Ship to the same address) zobrazíte během pokladny (v kroku „fakturační adresa“) možnost „doručit na stejnou adresu“. V takovém případě bude krok „doručovací adresa“ s příslušnými možnostmi (například vyzvednutí na prodejně) přeskočen. > [!NOTE] > > Při použití tohoto nastavení se ujistěte, že všechny fakturační země (**Konfigurace → Země** (Configuration → Countries)) podporují dopravu (zaškrtnuté políčko **Povoluje dopravu** (Allows shipping)). * Zaškrtněte **Přeskočit stránku způsobu dopravy** (Bypass shipping method page), pokud je k dispozici pouze jeden způsob dopravy. Tato stránka se pak během procesu pokladny nezobrazí. Definujte *podrobnosti o místě odeslání* (shipping origin): ![Nastavení dopravy – místo odeslání](_static/shipping-settings/shipping-settings-origin.jpg) Zahrnuje pole adresy, jako jsou: * Vyberte **Zemi** (Country). * Vyberte **Stát/kraj** (State/province). * Definujte **Okres/oblast** (County/region). * Zadejte požadované **Město** (City). * Zadejte požadovanou **Adresu 1** (Address 1). * Zadejte požadované **PSČ** (Zip/postal code). a další pole. Klikněte na **Uložit** (Save). --- # Poskytovatelé dopravy Pokud prodáváte produkty, které lze odeslat, budete muset ve svém obchodě nastavit způsoby dopravy, abyste mohli objednávky doručovat zákazníkům. Můžete buď definovat vlastní způsoby dopravy, nebo použít předdefinované způsoby dopravy poskytované oblíbenými přepravci, jako je UPS. nopCommerce obsahuje předinstalované pluginy pro dopravu, které platformu propojují s předními poskytovateli dopravy, a navíc vestavěné nástroje pro složité výpočty dopravy, jako je doprava podle hmotnosti nebo podle celkové částky a doprava s pevnou sazbou. > [!TIP] > > Ve výchozím nastavení je v nopCommerce k dispozici několik poskytovatelů dopravy, další poskytovatele dopravy však najdete na [marketplace](https://www.nopcommerce.com/marketplace) nopCommerce. Pokud se rozhodnete definovat a používat vlastní způsoby dopravy, je nutné ceny dopravy pro tyto způsoby zadat ručně. Pokud se rozhodnete používat způsoby dopravy poskytované přepravními společnostmi, jako je UPS, ceny dopravy pro tyto způsoby bude nutné získávat od příslušných přepravních společností. Všechny možnosti dopravy jsou implementovány jako pluginy a lze je najít a nainstalovat v části *Místní pluginy* (**Konfigurace → Pluginy → Místní pluginy** (Configuration → Plugins → Local plugins)). V následujících kapitolách se dozvíte, jak nastavit požadované možnosti dopravy: * [Ruční (pevná sazba nebo podle hmotnosti a podle celkové částky)](xref:cs/getting-started/configure-shipping/shipping-providers/manual) * [UPS](xref:cs/getting-started/configure-shipping/shipping-providers/ups) --- # Ruční (pevná sazba nebo podle hmotnosti a podle celkové částky) Ruční doprava (pevná sazba nebo podle hmotnosti a podle celkové částky) umožňuje u všech předdefinovaných způsobů dopravy nastavit pevné poplatky nebo poplatky vypočítávat podle hmotnosti a podle celkové částky. Příklad toho, jak lze tuto metodu ve vašem obchodě použít, najdete níže v části [Příklad](#example). ## Definice ručního poskytovatele dopravy Přejděte do **Konfigurace → Doprava → Poskytovatelé dopravy** (Configuration → Shipping → Shipping providers). Zobrazí se okno *Poskytovatelé dopravy*: ![Ruční způsoby dopravy](_static/manual/methods.jpg) Metodu ručního výpočtu ceny dopravy povolte následovně: * V řádku **Manual (fixed or by weight and by total)** klikněte na tlačítko **Upravit** (Edit). * Ve sloupci **Je aktivní** (Is active) zaškrtněte políčko. * Klikněte na tlačítko **Aktualizovat** (Update). Hodnota *false* se změní na *true*. Klikněte na tlačítko **Konfigurovat** (Configure) vedle možnosti Manual (fixed or by weight and by total) v seznamu. Kliknutím na tlačítko v horní části stránky můžete přepnout výpočet poplatku za dopravu *pevnou sazbou* (Fixed rate) na výpočet *podle hmotnosti/celkové částky* (By weight/total). ## Konfigurace pevné sazby ![Ruční konfigurace](_static/manual/fixed-rate-configure.jpg) Klikněte na tlačítko **Upravit** (Edit) vedle způsobu dopravy a zadejte pro něj **Sazbu** (Rate) a **Dny přepravy** (Transit days) (je-li to potřeba). Klikněte na **Aktualizovat** (Update). > [!NOTE] > > Způsoby dopravy můžete přidávat/odebírat v *okně Způsoby dopravy*, do kterého se dostanete kliknutím na ![tlačítko](_static/manual/manual-shipping-manage-button.png), a některé způsoby můžete pro zvolené země omezit kliknutím na ![omezení](_static/manual/manual-shipping-restrictions.png) v horní části. ## Konfigurace sazby podle hmotnosti/celkové částky ![podle hmotnosti](_static/manual/manual-shipping-by-weight-total.png) Možnost **doprava podle hmotnosti a podle celkové částky** umožňuje nastavit různé poplatky za dopravu na základě hmotnosti a celkové částky zásilky. Možnost účtovat různé poplatky v závislosti na hmotnosti a celkové částce zásilky pomáhá firmě udržet nízké náklady na dopravu při odesílání těžkých položek a zároveň nabídnout přiměřené ceny dopravy zákazníkům, kteří nakupují lehké produkty. K výpočtu poplatků použijte vzorec **[dodatečné pevné náklady] + ([celková hmotnost objednávky] - [dolní hmotnostní limit]) × [sazba za jednotku hmotnosti] + [mezisoučet objednávky] × [procento poplatku]**, kde: * **dodatečné pevné náklady** jsou náklady na zásilku v případě, že hmotnost je pod určitou úrovní (dolní hmotnostní limit). * **sazba za jednotku hmotnosti** je cena za každou jednotku hmotnosti nad dolním hmotnostním limitem. * **mezisoučet objednávky a procento poplatku** jsou parametry pro výpočet dodatečných nákladů na základě mezisoučtu objednávky. Pokud máte například následující podmínky dopravy: * pokud je hmotnost 0 až 1 libra a mezisoučet objednávky je od 1 $ do 10 $, cena je 10 $. Měli byste vytvořit **následující pravidla dopravy**: * Hmotnost objednávky od: **0** * Hmotnost objednávky do: **1** * Mezisoučet objednávky od: **1** * Mezisoučet objednávky do: **10** * Dodatečné pevné náklady: **10** * Dolní hmotnostní limit: **0** * Sazba za jednotku hmotnosti: **0** * pokud je hmotnost 1,1 libry až 2 libry a mezisoučet objednávky je od 11 $ do 1000 000 $, cena je 15 $. Měli byste vytvořit **následující pravidla dopravy**: * Hmotnost objednávky od: **1.000** * Hmotnost objednávky do: **2** * Mezisoučet objednávky od: **11** * Mezisoučet objednávky do: **1000000** * Dodatečné pevné náklady: **15** * Dolní hmotnostní limit: **0** * Sazba za jednotku hmotnosti: **0** * nad 2 libry je cena 3 $ za každých dalších 0,5 libry. Měli byste vytvořit **následující pravidla dopravy**: * Pokud jsou vaše pevné náklady 15 $, cena za libru nad 2 libry je 6 $ * Hmotnost objednávky od: **2.0001** * Hmotnost objednávky do: **99999** * Dodatečné pevné náklady: **15** * Dolní hmotnostní limit: **2** * Sazba za jednotku hmotnosti: **6** > [!NOTE] > > Dodatečná hmotnost bude účtována poměrně; > například za 2,1 libry bude účtováno 15 $ + (0.1 * 6)= 15,6 $ Chcete-li přidat nové pravidlo dopravy, klikněte na **Přidat záznam** (Add record). Zobrazí se okno *Přidat nový záznam*: ![Přidat pravidlo](_static/manual/manual-shipping-add-new.jpg) Definujte následující informace: * **Obchod** (Store), ve kterém budou vypočtené poplatky uplatněny. Zvolte *, chcete-li pravidla použít pro všechny obchody. * **Sklad** (Warehouse), ze kterého bude doprava probíhat. Zvolte *, chcete-li pravidla použít pro všechny sklady. * **Země, Stát/kraj, PSČ** (Country, State/province, Zip) cíle zásilky. * Vyberte **Způsob dopravy** (Shipping method) ze seznamu předem vytvořených možností. Pomocí **Spravovat způsoby dopravy** (Manage shipping methods) v horní části můžete způsoby dopravy přidávat/odebírat; více se dozvíte v části [Konfigurace způsobů dopravy](#configure-shipping-methods). * Vytvořte konfiguraci hmotnosti vyplněním polí **Hmotnost objednávky od** (Order weight from) a **Hmotnost objednávky do** (Order weight to). Pokud hmotnost zásilky zákazníka spadá do tohoto rozsahu, dodatečné náklady budou pevné a vypočtené podle tohoto záznamu. * Nakonfigurujte cenová pravidla pro tento záznam pomocí polí **Mezisoučet objednávky od, Mezisoučet objednávky do, Dodatečné pevné náklady, Dolní hmotnostní limit, Sazba za jednotku hmotnosti, Procento poplatku (z mezisoučtu)** (Order subtotal from, Order subtotal to, Additional fixed cost, Lower weight limit, Rate per weight unit, Charge percentage (of subtotal)). * Definujte pole **Dny přepravy** (Transit days), které určuje počet dní na doručení. > [!NOTE] > > Ujistěte se, že nastavení **Konfigurace → Nastavení → Nastavení dopravy → Zohlednit rozměry a hmotnost přidružených produktů** (Configuration → Settings → Shipping settings → Consider associated products dimensions and weight) je zapnuté (true). Klikněte na **Uložit** (Save). > [!NOTE] > > Pokud chcete zákazníkům povolit pouze způsoby nakonfigurované na této obrazovce, zaškrtněte políčko **Omezit způsoby dopravy na nakonfigurované** (Limit shipping methods to configured ones) v dolní části stránky. ## Konfigurace způsobů dopravy Majitel obchodu může definovat požadovaný seznam způsobů dopravy používaných v poskytovateli *Manual (fixed or by weight and by total)*. Postup správy způsobů dopravy: Přejděte do **Konfigurace → Doprava → Poskytovatelé dopravy** (Configuration → Shipping → Shipping providers). Poté klikněte na tlačítko **Konfigurovat** (Configure) vedle poskytovatele *Manual (fixed or by weight and by total)*. Zobrazí se okno konfigurace: ![Konfigurace](_static/manual/fixed-rate-configure.jpg) Klikněte na **Spravovat způsoby dopravy** (Manage shipping methods); zobrazí se *okno Způsoby dopravy*: ![Způsoby](_static/manual/fixed-rate-methods.jpg) Klikněte na tlačítko **Přidat nový** (Add new); zobrazí se okno *Přidat nový způsob dopravy*: ![Přidat nový](_static/manual/fixed-rate-methods-add-new.jpg) Pro nový záznam definujte následující pole: * **Název** (Name) způsobu dopravy, který uvidí zákazník. * **Popis** (Description) způsobu dopravy, který uvidí zákazník. * **Pořadí zobrazení** (Display order) způsobu dopravy. Hodnota 1 představuje začátek seznamu. Klikněte na **Uložit** (Save). > [!NOTE] > > V okně *Způsoby dopravy* můžete kliknutím na **Upravit** (Edit) upravit stávající způsoby dopravy, jak je popsáno výše. ## Omezení způsobů dopravy Majitel obchodu může definovat omezení konkrétních způsobů dopravy v určitých zemích. Chcete-li tak učinit, přejděte do **Konfigurace → Doprava → Poskytovatelé dopravy** (Configuration → Shipping → Shipping providers). Klikněte na tlačítko **Konfigurovat** (Configure) vedle poskytovatele *Manual (fixed or by weight and by total)*. Zobrazí se okno konfigurace: ![Konfigurace](_static/manual/fixed-rate-configure.jpg) Klikněte na **Omezení způsobů dopravy** (Shipping method restrictions); zobrazí se okno *Omezení způsobů dopravy*: ![Způsoby](_static/manual/fixed-rate-restrictions-methods.jpg) Vyberte jeden nebo více způsobů dopravy, které chcete v určitých zemích zakázat. V případě potřeby můžete vybrat celý sloupec omezení pro všechny země. Klikněte na **Uložit** (Save). ## Příklad Řekněme, že máte obchod sídlící v USA, který zasílá zboží v rámci USA a do Kanady. Nastavíte tři dostupné způsoby dopravy: * **Ground**, který umožňuje dopravu pozemní přepravou. * **Next day air**, který zajišťuje leteckou dopravu do druhého dne. * **2nd day air**, který umožňuje leteckou dopravu do dvou dnů. > [!TIP] > > Vlastní způsoby dopravy můžete přidat kliknutím na tlačítko **Spravovat způsoby dopravy** (Manage shipping methods) na stránce *Konfigurace - Manual (Fixed or By Weight and By Total)*. Dále řekněme, že poplatek za dopravu závisí na celkové částce objednávky a dodací adrese. Například: * Pokud zákazník za objednávku zaplatí 150 $, poskytujeme dopravu zdarma způsobem **Ground** pouze v rámci USA. Pokud je celková částka objednávky nižší než 150 $, účtujeme 10 $. Doručení v rámci USA bude trvat 5 dní. * V případě Kanady musí zákazník vytvořit objednávku v hodnotě 250 $, aby měl dopravu zdarma způsobem **Ground**. Pokud je celková částka objednávky nižší než 250 $, účtujeme 20 $. Doručení bude v tomto případě trvat 7 dní. * Pokud zákazník potřebuje doručení **Next day air**, bude to v USA stát 60 $. Řekněme, že chcete možnost **Next day air** pro Kanadu zakázat. * Pokud je zákazník ochoten počkat o den déle, doporučujeme použít dopravu **2nd day air**, která stojí 40 $ pro USA i Kanadu. S ohledem na všechny výše uvedené požadavky nastavíme způsob dopravy na stránce *Konfigurace - Manual (Fixed or By Weight and By Total)* následovně: * Způsob **Ground** ![Konfigurace Ground](_static/manual/configuration-ground.jpg) * Způsob **Next day air** ![Konfigurace Next day air](_static/manual/configuration-nextday.jpg) * Způsob **2nd day air** ![Konfigurace 2nd day air](_static/manual/configuration-2ndday.jpg) Chcete-li zakázat možnost **Next day air** pro Kanadu, klikněte na tlačítko **Omezení způsobů dopravy** (Shipping method restrictions) a vyplňte *Omezení způsobů dopravy* následovně: ![Příklad konfigurace](_static/manual/restrictions-example.jpg) ### Podívejme se, jak možnosti dopravy vypadají ve veřejném obchodě 1. Kdykoli zákazník z USA navštíví stránku produktu (nebo stránku nákupního košíku), zobrazí se odhad dopravy následovně: ![Odhad](_static/manual/estimate-product-page.jpg) > [!TIP] > > Mimochodem, odhad dopravy můžete zakázat zrušením zaškrtnutí políček **Odhad dopravy povolen (stránka košíku)** (Estimate shipping enabled (cart page)) a **Odhad dopravy povolen (stránka produktu)** (Estimate shipping enabled (product page)) na stránce **Konfigurace → Nastavení → Nastavení dopravy** (Configuration → Settings → Shipping settings). Když zákazník přejde k podrobnostem dopravy, zobrazí se následující možnosti: ![Odhad USA](_static/manual/estimation-popup-usa.jpg) 2. Kdykoli zákazník v okně odhadu dopravy zvolí Kanadu, zobrazí se následující možnosti: ![Odhad Kanada](_static/manual/estimation-popup-canada.jpg) Jak vidíte, možnost **Next day air** již není k dispozici. > [!TIP] > > Pokud chcete svým zákazníkům nabídnout výdejní místa, podívejte se, jak je nastavit, v kapitole [Výdejní místa](xref:cs/getting-started/configure-shipping/advanced-configuration/pickup-points). ## Videonávody * [Konfigurace ručního způsobu dopravy](https://www.youtube.com/watch?v=1nYj0NqVUWw&t=8s) --- # UPS ## Definice výpočtů dopravy UPS v reálném čase 1. Vytvořte si uživatelský účet UPS na [UPS.com](https://www.ups.com/), poté přejděte na [developer.ups.com](https://developer.ups.com/) a vytvořte aplikaci, abyste získali následující údaje: * Client ID * Client Secret > [!NOTE] > > Slouží k použití UPS OAuth, které je povinné pro všechny nové účty po červnu 2023 a pro všechny účty po červnu 2024 ![Metody výpočtu ceny dopravy](_static/ups/ups-apps-configuration.jpg) 2. Přidejte produkty UPS, abyste povolili sledování zásilek, výpočty cen atd. Doporučené produkty jsou: * Rating * Address Validation * Landed Cost Quoting * Tracking * Shipping * Time In Transit 3. V administraci nopCommerce přejděte do **Konfigurace → Nastavení → Nastavení dopravy** (Configuration → Settings → Shipping Settings). Nakonfigurujte místo odeslání. Výchozí možností je nakonfigurovat jediné **Místo odeslání** (Shipping Origin), které se nastavuje níže na stránce. Můžete však také zvolit **Použít umístění skladu** (Use Warehouse Location), pokud chcete použít nastavení nakonfigurovaná v **Konfigurace → Doprava → Sklad** (Configuration → Shipping → Warehouse). Zaškrtávací políčko **Použít umístění skladu** se zobrazí po výběru možnosti **Pokročilé** (Advanced) v selektoru konfigurace stránky pod záhlavím **Nastavení dopravy**. ![Metody výpočtu ceny dopravy](_static/ups/shipping-settings-advanced.jpg) 4. V administraci nopCommerce přejděte do **Konfigurace → Doprava → Poskytovatelé dopravy** (Configuration → Shipping → Shipping providers). ![Metody výpočtu ceny dopravy](_static/ups/shipping-rate-methods.jpg) 5. Tuto metodu povolte následovně: * V řádku UPS (United Postal Service) klikněte na tlačítko **Upravit** (Edit). * Ve sloupci **Je aktivní** (Is active) zaškrtněte políčko. * Klikněte na **Aktualizovat** (Update). Hodnota *false* se změní na *true*. 6. Klikněte na **Konfigurovat** (Configure) vedle možnosti UPS (United Parcel Service) v seznamu. Zobrazí se okno *Konfigurace – UPS (United Parcel Service)*: ![Stránka konfigurace](_static/ups/ups-configure.jpg) > [!WARNING] > > Od června 2024 již nebude možné provádět transakce s rozhraními API UPS s použitím přístupového klíče k ověření a je nutné aktualizovat bezpečnostní model na OAuth 2.0 7. Zadejte následující informace získané od poskytovatele UPS a zvolte možnosti, které jsou pro váš obchod relevantní: * Zaškrtněte políčko **Použít sandbox** (Use sandbox), chcete-li použít testovací prostředí. * Zadejte **Client ID** poskytovatele UPS. * Zadejte **Client Secret** získaný od poskytovatele. * Zadejte své **Číslo účtu** (Account Number) získané od poskytovatele. * Vyberte požadovanou **Klasifikaci zákazníka UPS** (UPS Customer Classification): * Rates Associated With Shipper Number * Daily Rates * Retail Rates * Regional Rates * General List Rates * Standard List Rates * Vyberte požadovaný **Typ vyzvednutí UPS** (UPS Pickup Type): * Daily Pickup * Customer Counter * One Time Pickup * On Call Air * Letter Center * Air Service Center * Vyberte požadovaný **Typ balení UPS** (UPS Packaging Type): * Unknown * Letter * Customer Supplied Package * Tube * P A K * Express Box * 10 kg Box * 25 kg Box * Pallet * Small Express Box * Medium Express Box * Large Express Box * Zaškrtněte políčko **Pojistit zásilku** (Insure package), chcete-li označit, že zásilka bude pojištěna. * Zadejte **Dodatečný manipulační poplatek** (Additional handling charge). Jde o dodatečný poplatek účtovaný vašim zákazníkům. * Vyberte **Služby přepravce** (Carrier Services), které chcete zákazníkům nabízet. * Zaškrtněte **Povoleno doručení v sobotu** (Saturday Delivery enabled), chcete-li získávat ceny pro doručení v sobotu. * Vyberte **Typ balení** (Packing type): * Balit podle rozměrů (Pack by dimensions) * Balit po jedné položce v balíku (Pack by one item per package) * Balit podle objemu (Pack by volume) * Zaškrtněte políčko **Předávat rozměry** (Pass dimensions), chcete-li při požadavku na ceny předávat rozměry zásilky. * Vyberte **Typ hmotnosti** (Weight type) – libry nebo kilogramy. * Vyberte **Typ rozměrů** (Dimensions type) – palce nebo centimetry. * Zaškrtněte políčko **Trasování** (Tracing), chcete-li zaznamenávat trasování systému do systémového logu. Zaznamená se celý XML požadavku a odpovědi (včetně AccessKey/Username, Password). V produkčním prostředí tuto volbu nenechávejte zapnutou. Klikněte na **Uložit** (Save). --- # Pokročilá konfigurace * [Sklady](xref:cs/getting-started/configure-shipping/advanced-configuration/warehouses) * [Data a rozsahy](xref:cs/getting-started/configure-shipping/advanced-configuration/dates-and-ranges) * [Měrné jednotky](xref:cs/getting-started/configure-shipping/advanced-configuration/measures) * [Výdejní místa](xref:cs/getting-started/configure-shipping/advanced-configuration/pickup-points) * [Země, státy](xref:cs/getting-started/configure-shipping/advanced-configuration/countries-states) --- # Země, státy Tato sekce popisuje, jak spravovat země (kde se nacházejí vaši zákazníci) a státy. Chcete-li definovat země a státy, přejděte do **Konfigurace → Země** (Configuration → Countries). ![země](_static/countries-states/countries1_1.png) > [!TIP] > > Ve výchozím nastavení jsou nahrány všechny země. Země můžete *publikovat* a *zrušit jejich publikování* tak, že je vyberete a kliknete na odpovídající tlačítka v horní části stránky. ## Přidání nové země Chcete-li přidat novou zemi, klikněte na **Přidat novou** (Add new). ![přidání země](_static/countries-states/addcountry.png) V panelu *Informace o zemi* (Country info) definujte následující nastavení země: * **Název** (Name) země. * **Povolit fakturaci** (Allows billing) zákazníkům z této země. * **Povolit dopravu** (Allows shipping) zákazníkům v této zemi. * Zadejte **Dvoupísmenný kód ISO** (Two letter ISO) této země. * Zadejte **Třípísmenný kód ISO** (Three letter ISO) této země. * Zadejte **Číselný kód ISO** (Numeric ISO code) této země. * Zaškrtnutím políčka **Podléhá DPH** (Subject to VAT) určíte, zda se zákazníkům v této zemi účtuje DPH EU (daň z přidané hodnoty Evropské unie). > [!NOTE] > > Toto pole se používá pouze tehdy, je-li na stránce nastavení daní povolena možnost DPH EU (Konfigurace → Nastavení → Nastavení daní). * Chcete-li zemi svázat s určitým obchodem, vyberte požadované obchody v poli **Omezeno na obchody** (Limited to stores): > [!NOTE] > > Tento seznam se používá pouze tehdy, máte-li nakonfigurováno více obchodů. Další podrobnosti naleznete v části [Více obchodů](xref:cs/getting-started/advanced-configuration/multi-store). * Zaškrtněte políčko **Publikováno** (Published), aby byla tato země viditelná při registraci nových účtů a při vytváření dodacích a fakturačních adres. * Zadejte **Pořadí zobrazení** (Display order) této země. Hodnota 1 představuje začátek seznamu. Klikněte na **Uložit** (Save). ## Přidání nových států a provincií V panelu *Státy a provincie* (State and provinces) můžete přidávat státy a provincie dané země. > [!TIP] > > Ve výchozím nastavení jsou přidány státy USA. ![přidání země 2](_static/countries-states/states.jpg) Kliknutím na tlačítko **Přidat nový stát/provincii** (Add a new state/province) v dolní části panelu přidáte nový stát nebo provincii. ![země 3](_static/countries-states/countries3.png) Definujte následující údaje státu/provincie: * **Název** (Name) státu nebo provincie. * **Zkratka** (Abbreviation) provincie nebo státu. * Zaškrtnutím políčka **Publikováno** (Published) stát nebo provincii na webu zveřejníte. * Do pole **Pořadí zobrazení** (Display order) zadejte pořadí zobrazení této provincie nebo státu. Hodnota 1 představuje začátek seznamu. Klikněte na **Uložit** ## Export/import států Seznam států všech zemí přidaných do systému můžete exportovat nebo naopak importovat další pomocí odpovídajících tlačítek v horní části stránky **Konfigurace → Země**. ![Export/import](_static/countries-states/export-import.jpg) > [!NOTE] > > Importovaný soubor musí mít stejný formát jako exportovaný. --- # Sklady nopCommerce podporuje více skladů. Tento nástroj umožňuje majiteli obchodu sledovat zásoby v různých skladech a zlepšit logistiku. Následující část popisuje, jak přidat sklady, včetně údajů o skladu, jako je název, země, adresa a další. Postup přidání nových skladů: 1. Přejděte do **Konfigurace → Doprava → Sklady** (Configuration → Shipping → Warehouses). Zobrazí se okno *Sklady*: ![Sklady](_static/warehouses/warehouses.png) 1. Klikněte na **Přidat nový** (Add new). Zobrazí se okno *Přidat nový sklad*: ![Přidat nový](_static/warehouses/warehouses-add-new.png) 1. Zadejte následující údaje o skladu: * **Název** (Name). * **Země** (Country) skladu. * **Kraj/stát** (State/province) skladu. * **Okres/region** (County/region) skladu. * **Město** (City) skladu. * **Adresa 1** (Address 1) skladu. * **PSČ** (Zip/postal code) skladu. * **Telefonní číslo** (Phone number) skladu. * Do pole **Komentář administrátora** (Admin comment) zadejte volitelný komentář nebo informace pro interní použití. Poté budete moci na stránce úpravy produktu vybrat sklad pro své produkty nebo dokonce využít funkci více skladů: ![Více skladů](_static/warehouses/multiple.jpg) --- # Data a rozsahy ## Termíny doručení Termíny doručení jsou časová rozmezí, která zákazníkovi zobrazují přibližnou dobu doručení. Termíny doručení lze přiřadit k produktům a zobrazit na stránkách s detailem produktu. * Přejděte do **Konfigurace → Doprava → Data a rozsahy** (Configuration → Shipping → Dates and ranges). V okně *Data a rozsahy* se zobrazí následující dva panely: ### Panel Termíny doručení ![Termíny doručení](_static/dates-and-ranges/delivery-dates.png) Klikněte na **Přidat nový** (Add new). Zobrazí se okno *Přidat nový termín doručení*: ![Přidat nový](_static/dates-and-ranges/delivery-dates-add-new.png) * Do pole **Název** (Name) zadejte název nového termínu doručení; obvykle jde o časové rozmezí. * Do pole **Pořadí zobrazení** (Display order) zadejte pořadí zobrazení tohoto termínu doručení. Hodnota 1 představuje začátek seznamu. Klikněte na tlačítko **Uložit** (Save). ### Panel Rozsahy dostupnosti produktů Zde můžete nastavit rozsahy dostupnosti produktů. Tyto možnosti se zobrazí na stránce úpravy produktu. ![Rozsahy dostupnosti](_static/dates-and-ranges/avialability-ranges.png) Kliknutím na **Přidat nový** přidáte vlastní rozsah. Zobrazí se okno *Přidat nový rozsah dostupnosti produktu*: ![Přidat nový rozsah dostupnosti](_static/dates-and-ranges/avialability-ranges-add-new.png) * Do pole **Název** zadejte název nového rozsahu, například 2 měsíce. * Do pole **Pořadí zobrazení** zadejte pořadí zobrazení tohoto rozsahu dostupnosti. Hodnota 1 představuje začátek seznamu. Klikněte na tlačítko **Uložit**. --- # Měrné jednotky Tato sekce popisuje, jak přidat nové jednotky hmotnosti a rozměrů. Přidání nových jednotek rozměru nebo hmotnosti: Přejděte do **Konfigurace → Doprava → Měrné jednotky** (Configuration → Shipping → Measures). Sekce *Rozměry* (Dimensions) a *Hmotnost* (Weight) se rozbalí takto: ![rozměry](_static/measures/dimensions.png) ![hmotnosti](_static/measures/weights.png) V dolní části sekce definujte následující údaje nové jednotky: * **Název** (Name) nové jednotky rozměru (hmotnosti). * **Systémové klíčové slovo** (System keyword) pro tuto jednotku. * **Poměr k primární jednotce rozměru (hmotnosti)** (Ratio to primary dimension (weight)). * **Pořadí zobrazení** (Display order) měrné jednotky v seznamu. Hodnota 1 představuje začátek seznamu. Poté klikněte na **Přidat nový záznam** (Add new record). Nová jednotka rozměru (hmotnosti) bude přidána do tabulky *Rozměry* (*Hmotnosti*). > [!NOTE] > > Primární jednotku rozměru (hmotnosti) můžete nastavit kliknutím na **Označit jako primární rozměr (hmotnost)** (Mark as primary dimension (weight)). Kliknutím na **Upravit** (Edit) vedle měrné jednotky můžete upravit její údaje, jak je popsáno výše. --- # Výdejní místa Výdejní místo je možnost, která zákazníkům dává flexibilitu zvolit si, kde si zásilku převezmou. > [!NOTE] > > Tato možnost je dostupná pouze tehdy, když je na stránce nastavení dopravy (**Konfigurace → Nastavení → Nastavení dopravy** (Configuration → Settings → Shipping settings)) zaškrtnuto políčko **Povoleno „Vyzvednutí v obchodě“** ("Pick up in store" enabled). Poskytovatele výdejních míst spravujete takto: Přejděte do **Konfigurace → Doprava → Výdejní místa** (Configuration → Shipping → Pickup points); zobrazí se stránka *Poskytovatelé výdejních míst*: ![Poskytovatelé výdejních míst](_static/pickup-points/pickup-point-providers.jpg) Ve výchozím stavu je k dispozici pouze jedna možnost **Vyzvednutí v obchodě** (Pickup in store). Ujistěte se, že je poskytovatel výdejních míst aktivní. Pokud není, klikněte na tlačítko **Upravit** (Edit) a zaškrtněte políčko ve sloupci **Je aktivní** (Is active). Poté změny uložte kliknutím na tlačítko **Aktualizovat** (Update). Chcete-li upravit stávající výdejní místa nebo přidat nová, klikněte v tabulce na **Konfigurovat** (Configure). Otevře se stránka *Konfigurace – Vyzvednutí v obchodě*: ![Konfigurace výdejního místa](_static/pickup-points/pickup-in-store-configure.png) Klikněte na **Přidat nové výdejní místo** (Add a new pickup point); zobrazí se okno *Přidat nové*: ![Nové výdejní místo](_static/pickup-points/pickup-point-add-new.png) Vyplňte následující údaje: * **Název** (Name) výdejního místa. * **Popis** (Description), je-li potřeba. * V rozevíracím seznamu vyberte **Zemi** (Country). * V rozevíracím seznamu vyberte **Stát/kraj** (State/province). * **Město** (City). * **Adresa 1** (Address 1). * **PSČ** (Zip/postal code). * **Otevírací doba** (Opening hours) výdejního místa. * **Poplatek za vyzvednutí** (Pickup fee), je-li potřeba. * **Pořadí zobrazení** (Display order) tohoto výdejního místa. * **Obchod(y)** (Store(s)), které toto výdejní místo používají. Změny **uložte** (Save). Kliknutím na **Upravit** vedle výdejního místa upravíte dříve zadané údaje. --- # Konfigurace daní Tato kapitola popisuje nastavení daňových nástrojů nopCommerce. > [!NOTE] > > Tato kapitola se týká vestavěných daňových nástrojů nopCommerce, nikoli daňových služeb třetích stran. nopCommerce podporuje i externí služby, ty však vyžadují instalaci pluginů z [marketplace](http://www.nopcommerce.com/marketplace). Postup instalace takových modulů je popsán v kapitole [Pluginy](xref:cs/developer/plugins/index). ## Průvodce konfigurací DPH v EU Chcete-li nastavit podporu DPH v nopCommerce pro obchody v EU, přejděte do **Konfigurace → Nastavení → Nastavení daní** (Configuration → Settings → Tax settings). Na panelu *Obecné* (Common): * Nastavte **Daň založena na** (Tax based on) na **Doručovací adresa** (Shipping address). Na panelu *DPH* (VAT): * Zaškrtněte **Povolit DPH EU** (EU VAT enabled). Tím zajistíte, že daň bude účtována pouze u zásilek v rámci EU. * Vyberte **Zemi** (Country), ve které se váš obchod nachází. * Pokud je to relevantní, zaškrtněte *Povolit osvobození od DPH* (Allow VAT exemption). Tím zajistíte, že vašim zákazníkům registrovaným k DPH, kteří nechávají zboží doručit v rámci EU, ale mimo zemi, ve které se obchod nachází, nebude DPH účtována. * Zaškrtnutím políčka **Předpokládat, že DIČ je vždy platné** (Assume VAT always valid) přeskočíte ověřování DIČ. Zadaná DIČ budou vždy považována za platná. Za uvedení správného DIČ bude odpovědný zákazník. * Pokud jste zaškrtli **Povolit osvobození od DPH** (Allow VAT exemption), možná budete chtít zaškrtnout také políčka „**Použít webovou službu**“ (Use web service) a „**Upozornit administrátora na zadání nového DIČ**“ (Notify admin when a new VAT number is submitted). Klikněte na tlačítko **Uložit** (Save). Přejděte do **Konfigurace → Země** (Configuration → Countries). Ujistěte se, že všechny země spadající do působnosti DPH mají možnost **Podléhá DPH** (Subject to VAT) nastavenou na *true*. ![Země](_static/index/countries.jpg) > [!NOTE] > > Jersey, Guernsey a ostatní Normanské ostrovy nejsou součástí Spojeného království ani nespadají do působnosti DPH. Pokud do těchto míst prodáváte, možná to budete muset změnit. Přejděte do **Konfigurace → Daňové kategorie** (Configuration → Tax categories). ![Daňové kategorie](_static/index/tax-categories.jpg) Pro každou sazbu DPH ve vaší zemi nastavte daňovou kategorii. Například „Základní sazba“, „Nulová sazba“, „Snížená sazba“. Výchozí třídy, které již existují, ale nejsou použitelné, odstraňte. Přejděte do **Konfigurace → Poskytovatelé daní** (Configuration → Tax providers). Pomocí tlačítka **Označit jako primárního poskytovatele** (Mark as primary provider) nastavte jako výchozího poskytovatele **Manual (fixed or by country/state/zip)**. ![Poskytovatelé daní](_static/index/tax-providers.jpg) Chcete-li upravit daňové sazby, klikněte na řádku poskytovatele **Manual (fixed or by country/state/zip)** na **Konfigurovat** (Configure). V horní části stránky uvidíte tlačítko. Kliknutím na něj přepnete do režimu **Pevná sazba** (Fixed rate). ![Konfigurace](_static/index/configure.jpg) Na této stránce uvidíte své kategorie sazeb DPH. Klikněte na **Upravit** (Edit) vedle každé kategorie a zadejte procentní sazby. Poté klikněte na tlačítko **Aktualizovat** (Update). Ujistěte se, že všechny produkty mají na svých [stránkách produktu](xref:cs/running-your-store/catalog/products/add-products) přiřazenou daňovou kategorii. ![Produkt](_static/index/product.jpg) ## Viz také * [Nastavení daní](xref:cs/getting-started/configure-taxes/tax-settings) * [Poskytovatelé daní](xref:cs/getting-started/configure-taxes/tax-providers/index) --- # Nastavení daní Tato sekce popisuje nastavení daní vašeho obchodu, například definování cen včetně nebo bez daně, definování typu zobrazení daně a další. Chcete-li spravovat nastavení daní, přejděte do **Konfigurace → Nastavení → Nastavení daní** (Configuration → Settings → Tax settings). ![Nastavení daní](_static/tax-settings/tax-settings.jpg) Nejprve definujte **obecná** nastavení daní: * V rozevíracím seznamu **Daň vypočítat podle** (Tax based on) vyberte požadovanou možnost, na které je daň založena, takto: * **Fakturační adresa** (Billing address). Je-li tato možnost vybrána, daň se vypočítává podle fakturační adresy zákazníka. Pokud fakturační adresa není známa, použije se výchozí adresa (zadaná níže). * **Doručovací adresa** (Shipping address). Je-li tato možnost vybrána, daň se vypočítává podle doručovací adresy zákazníka. Pokud doručovací adresa není známa, použije se výchozí adresa (zadaná níže). * **Výchozí adresa** (Default address). Je-li tato možnost vybrána, daň se vypočítává podle výchozí adresy zadané níže. * **Automaticky zjistit zemi podle IP adresy** (Automatically detect country by IP address). Je-li toto nastavení povoleno a fakturační/doručovací adresa zákazníka ještě není nastavena, země adresy použité pro výpočet daně bude určena automaticky službou GEO (podle IP adresy). * Zvolte **Výchozí daňovou kategorii** (Default tax category) pro produkty. Bude předvybrána na stránce *Přidat nový produkt* (Add new product). * Políčko **Daň podle adresy výdejního místa** (Tax based on pickup point address) určuje, zda se má při zvolení výdejního místa pro výpočet daně použít adresa výdejního místa. * Zaškrtnutím políčka **Ceny včetně daně** (Prices include tax) určíte, zda zadané ceny zahrnují daň. Poté definujte **výchozí daňovou adresu (používanou pro výpočet daně)** takto: * Vyberte **Zemi** (Country). * Vyberte **Stát/kraj** (State/province). * Definujte **Okres/region** (County/region). * Definujte **Město** (City). * Definujte **Adresu 1** (Address 1). * Zadejte **PSČ** (Zip/postal code). Na panelu **Zobrazení daně** (Tax displaying) můžete nastavit, jak se bude daň zákazníkům zobrazovat: * Zaškrtnutím políčka **Povolit zákazníkům zvolit typ zobrazení daně** (Allow customers to select tax display type) určíte, zda si zákazníci mohou typ zobrazení daně zvolit. Pokud políčko není zaškrtnuto, zobrazí se rozevírací seznam **Typ zobrazení daně** (Tax display type): * **Bez daně** (Excluding tax): vyberte pro vynucení zobrazení bez daně. * **Včetně daně** (Including tax): vyberte pro vynucení zobrazení včetně daně. * Zaškrtnutím políčka **Zobrazit příponu daně** (Display tax suffix) zobrazíte příponu daně (vč. daně\bez daně). * Zaškrtnutím políčka **Zobrazit všechny uplatněné daňové sazby** (Display all applied tax rates) zobrazíte všechny uplatněné daňové sazby na samostatném řádku na stránce nákupního košíku. * Zaškrtnutím políčka **Skrýt nulovou daň** (Hide zero tax) skryjete nulovou hodnotu daně v souhrnu objednávky. * Zaškrtnutím políčka **Skrýt daň v souhrnu objednávky** (Hide tax in order summary) skryjete hodnotu daně v souhrnu objednávky, pokud jsou ceny zobrazeny včetně daně. * Zaškrtnutím políčka **Vynutit vyloučení daně z mezisoučtu objednávky** (Force tax exclusion from order subtotal) bude daň z mezisoučtu objednávky vždy vyloučena (bez ohledu na zvolený typ zobrazení daně). Toto políčko ovlivňuje pouze stránky, na kterých se zobrazují celkové částky objednávky. Na panelu *Doprava* (Shipping) zaškrtněte políčko **Doprava podléhá dani** (Shipping is taxable), chcete-li určit, že doprava podléhá dani. Poté se zobrazí následující pole: * **Cena dopravy zahrnuje daň** (Shipping price includes tax): vyberte, chcete-li určit, že cena dopravy zahrnuje daň. * **Daňová kategorie dopravy** (Shipping tax category): vyberte požadovanou daňovou kategorii používanou pro výpočet daně z dopravy. Na panelu *Platba* (Payment) zaškrtněte políčko **Dodatečný poplatek platební metody podléhá dani** (Payment method additional fee is taxable), chcete-li určit, že dodatečný poplatek platební metody podléhá dani. Zobrazí se následující možnosti: * **Dodatečný poplatek platební metody zahrnuje daň** (Payment method additional fee includes tax): vyberte, chcete-li určit, že dodatečný poplatek platební metody zahrnuje daň. * **Daňová kategorie dodatečného poplatku platební metody** (Payment method additional fee tax category): v rozevíracím seznamu vyberte požadovanou daňovou kategorii používanou pro výpočet daně z dodatečného poplatku platební metody. Poté nastavte DPH na panelu *DPH* (VAT): * Zaškrtnutím políčka **EU DPH povoleno** (EU VAT enabled) určíte, že je povolena daň z přidané hodnoty Evropské unie. Je-li tato možnost vybrána, budou zákazníci během registrace nebo na stránce s detaily zákaznického účtu požádáni o *DIČ společnosti* (Company VAT number). Toto DIČ lze automaticky ověřit prostřednictvím webové služby, je-li zaškrtnuto políčko **Použít webovou službu** (Use web service), nebo ručně majitelem obchodu na stránce s detaily zákazníka v administraci. * **EU DPH povoleno pro hosty** (EU VAT enabled for guests) – Zaškrtněte, chcete-li povolit EU DPH (daň z přidané hodnoty Evropské unie) pro zákazníky-hosty. Budou jej muset zadat během pokladny v kroku fakturační adresy. * **DIČ je povinné** (VAT number required) – Zaškrtněte, pokud je „EU DIČ“ povinné. * **Země vašeho obchodu** (Your shop country): v rozevíracím seznamu vyberte zemi, ve které se váš obchod nachází. * **Povolit osvobození od DPH** (Allow VAT exemption): zaškrtnutím tohoto políčka osvobodíte od DPH způsobilé zákazníky registrované k DPH. * **Předpokládat, že DIČ je vždy platné** (Assume VAT always valid): zaškrtnutím tohoto políčka přeskočíte ověřování DIČ. Zadaná DIČ budou vždy platná. Za uvedení aktuálního DIČ odpovídá klient. * **Použít webovou službu** (Use web service): zaškrtnutím tohoto políčka budete k ověřování DIČ používat webovou službu. * **Upozornit administrátora při odeslání nového DIČ** (Notify admin when a new VAT number is submitted): zaškrtnutím tohoto políčka budete při odeslání nového DIČ dostávat upozornění e-mailem. > [!NOTE] > > Je-li DPH povoleno, účtuje se daň 0 % za dopravu mimo EU a 0 % těm, kteří uvedli ověřené a schválené DIČ a zasílají v rámci EU, ale mimo zemi obchodu. Další informace o EU DPH naleznete v článku. > > [!TIP] > > Jak nastavit EU DPH, si přečtěte zde: [Průvodce konfigurací EU DPH](xref:cs/getting-started/configure-taxes/index#eu-vat-configuration-guide). Klikněte na **Uložit** (Save). ## Výukové materiály * [Správa nastavení daní](https://www.youtube.com/watch?v=8iF5nQvIoLs&feature=youtu.be) --- # Poskytovatelé daní Chcete-li definovat poskytovatele daňových sazeb, přejděte do **Konfigurace → Poskytovatelé daní** (Configuration → Tax providers). ![Poskytovatelé daní](_static/index/tax-providers.png) Pro výpočet daně lze použít pouze jednoho poskytovatele daňových sazeb. Přidávání nových poskytovatelů daní se doporučuje pouze pokročilým uživatelům. Chcete-li vybrat výchozího poskytovatele daní, klikněte na tlačítko **Označit jako primárního poskytovatele** (Mark as primary provider). > [!TIP] > > Ve výchozím nastavení je v nopCommerce k dispozici několik poskytovatelů daní, další poskytovatele daní však najdete na [marketplace](https://www.nopcommerce.com/marketplace) nopCommerce. Konfigurace poskytovatelů daní je popsána v následujících kapitolách: * [Poskytovatel daní Avalara](xref:cs/getting-started/configure-taxes/tax-providers/avalara) * [Ruční (pevná sazba nebo podle země/státu/PSČ)](xref:cs/getting-started/configure-taxes/tax-providers/manual) --- # Ruční (pevná sazba nebo podle země/státu/PSČ) Chcete-li nakonfigurovat poskytovatele daní Manual (fixed or by country/state/zip), přejděte do **Konfigurace → Poskytovatelé daní** (Configuration → Tax providers). ![Poskytovatelé daní](_static/manual/tax-providers.png) Chcete-li upravit daňové sazby, klikněte na **Konfigurovat** (Configure) v řádku poskytovatele **Manual (fixed or by country/state/zip)**. Výpočet daně podle *Pevné sazby* (Fixed rate) můžete přepnout na výpočet daně podle *Země/státu/PSČ* (Country/state/zip) kliknutím na příslušné tlačítko vlevo nahoře. Chcete-li spravovat daňové kategorie, klikněte na tlačítko **Spravovat daňové kategorie** (Manage tax categories) vpravo nahoře. ## Pevná sazba Kliknutím na tlačítko **Podle země** (By country) v horní části stránky přepnete editor do režimu **Pevná sazba** (Fixed rate). ![Konfigurace](_static/manual/configure-confirm.jpg) Upozorňujeme, že při přepínání mezi režimy *Pevná sazba* a *Podle země* se uplatní ta daňová pravidla, která jsou zobrazena na konfigurační stránce. ![Konfigurace](_static/manual/configure.jpg) Na této stránce vidíte předem vytvořené daňové kategorie. Klikněte na **Upravit** (Edit) vedle každé kategorie a zadejte procentuální sazby. Poté klikněte na tlačítko **Aktualizovat** (Update). Ujistěte se, že vaše produkty mají na svých [stránkách produktu](xref:cs/running-your-store/catalog/products/add-products) přiřazenou daňovou kategorii. ![Produkt](_static/manual/product.jpg) > [!NOTE] > > Tato sekce zobrazuje pouze předem vytvořené daňové kategorie. Kliknutím na tlačítko **Spravovat daňové kategorie** (Manage tax categories) daňové kategorie upravíte, nebo si přečtěte, jak daňové kategorie spravovat, zde: [konfigurace daňových kategorií](#configure-tax-categories). ## Podle země Kliknutím na tlačítko **Pevná sazba** (Fixed rate) v horní části stránky přepnete editor do režimu **Podle země** (By country). ![Podle země](_static/manual/tax-by-country.png) Novou daňovou sazbu definujte takto: * Vyberte **Obchod** (Store), pro který je sazba definována. Vyberte *, chcete-li tuto sazbu uplatnit na všechny obchody. * Vyberte **Zemi** (Country), pro kterou je daňová sazba definována. * Vyberte **Stát/kraj** (State/province), pro který je daňová sazba definována. Je-li vybrána hvězdička (*), bude tato daňová sazba platit pro všechny zákazníky z vybrané země bez ohledu na stát. * Zadejte **PSČ** (Zip) oblasti, pro kterou je daňová sazba definována. Je-li toto pole prázdné, bude tato daňová sazba platit pro všechny zákazníky z vybrané země nebo státu bez ohledu na PSČ. * Vyberte **Daňovou kategorii** (Tax category), na kterou se má daňová sazba uplatnit. * Do pole **Procento** (Percentage) zadejte požadované procento. Klikněte na **Přidat daňovou sazbu** (Add tax rate). Nová daňová sazba se zobrazí takto: ![Přidání daňové sazby](_static/manual/add-tax-rate.png) > [!NOTE] > > Tato sekce zobrazuje pouze předem vytvořené daňové kategorie. Kliknutím na tlačítko **Spravovat daňové kategorie** (Manage tax categories) daňové kategorie upravíte, nebo si přečtěte, jak daňové kategorie spravovat, zde: [konfigurace daňových kategorií](#configure-tax-categories). ## Konfigurace daňových kategorií Chcete-li definovat daňové kategorie, přejděte do **Konfigurace → Daňové kategorie** (Configuration → Tax categories). Zobrazí se okno *Daňové kategorie* (Tax categories): ![Daňové kategorie](_static/manual/tax-categories.jpg) Chcete-li přidat novou daňovou kategorii, zadejte v dolní části panelu **Název** (Name) kategorie a **Pořadí zobrazení** (Display order) této daňové klasifikace. V poli **Pořadí zobrazení** představuje hodnota 1 začátek seznamu. Poté kliknutím na **Přidat nový záznam** (Add new record) novou daňovou kategorii uložte. --- # Daňový poskytovatel Avalara ## Připojení k AvaTax Po instalaci daňového poskytovatele Avalara je potřeba nakonfigurovat integraci. > [!NOTE] > > Ujistěte se, že je plugin nainstalován a označen jako „Povoleno“ (**Konfigurace → Lokální pluginy** (Configuration → Local plugins)). Chcete-li plugin povolit, klikněte na **Upravit** (Edit) a zaškrtněte políčko **Je povoleno** (Is enabled). ![Lokální pluginy](_static/avalara/local-plugins.png) Chcete-li nakonfigurovat daňového poskytovatele Avalara, přejděte na **Konfigurace → Daňoví poskytovatelé** (Configuration → Tax providers). ![Daňoví poskytovatelé](_static/avalara/tax-providers.png) Klikněte na **Označit jako primárního poskytovatele** (Mark as primary provider). Klikněte na **Konfigurovat** (Configure) vedle možnosti daňového poskytovatele Avalara v seznamu. Podle pokynů v horní části stránky si vytvořte účet. Poté plugin nakonfigurujte; funkce každého pole se zobrazí po najetí myší na „?“. 1. Nakonfigurujte své přihlašovací údaje AvaTax: ![Konfigurace přihlašovacích údajů](_static/avalara/avalara-configuration-common.png) * **ID účtu** (Account ID): poskytnuto během procesu aktivace účtu AvaTax. * **Licenční klíč** (License key): poskytnut během procesu aktivace účtu AvaTax. * **Společnost** (Company): identifikátor profilu společnosti v administrační konzoli AvaTax. * **Použít sandbox** (Use sandbox) se povoluje pro potvrzení testovací transakce. * **Povolit protokolování** (Enable logging) povolí protokolování všech požadavků na služby Avalara. 2. Nakonfigurujte nastavení výpočtu daně: ![Konfigurace daně](_static/avalara/avalara-configuration-tax-calculation.png) * **Potvrzovat transakce** (Commit transactions) se povoluje pro potvrzení transakcí ihned po jejich uložení. * **Ověřovat adresu** (Validate address) se povoluje pro ověření zadané adresy. * **Adresa původu daně** (Tax origin address) se používá pro daňové požadavky na služby Avalara. * **Použít tabulky daňových sazeb k odhadu** (Use tax rate tables to estimate) určuje, zda se k odhadu použijí tabulky daňových sazeb. Použije se jako výchozí výpočet daně pro stránky katalogu a během pokladny se upraví a sladí s konečnou daní transakce. Daňové sazby se vyhledávají podle PSČ (pouze USA) v souboru, který Avalara pravidelně aktualizuje (viz Naplánované úlohy). * **Daňové sazby pouze podle adresy** (Tax rates by address only) se zobrazí, pokud předchozí nastavení není zaškrtnuto. Povolte jej, chcete-li získávat daňové sazby pouze podle adresy (snižuje počet volání API, ale může zkreslit výsledky). 3. Nakonfigurujte nastavení osvobození od daně: ![Konfigurace osvobození](_static/avalara/avalara-configuration-exemption.png) * **Povolit certifikáty osvobození** (Enable exemption certificates) se povoluje pro aktivaci certifikátů osvobození od daně. * **Omezeno na role zákazníků** (Limited to customer roles) slouží k omezení zákazníků, kteří mají k této funkci přístup. * **Automaticky ověřovat certifikáty** (Auto validate certificates) se povoluje pro automatické ověřování nově nahraných/vytvořených certifikátů. * **Povolit úpravu údajů** (Allow edit info) se povoluje, aby zákazníci mohli při správě certifikátů upravovat své údaje (například jméno, telefon, adresu). * **Zobrazit zprávu „Žádné platné certifikáty“** (Display 'No valid certificates' message) se povoluje pro zobrazení zprávy na stránce potvrzení objednávky, že zákazník nemá žádné platné certifikáty. ![Konfigurace osvobození – žádné certifikáty](_static/avalara/avalara-configuration-exemption-none.png) > [!TIP] > > Text této zprávy lze upravit v jazykových zdrojích. 4. Klikněte na **Uložit** (Save) a poté na tlačítko **Testovat připojení** (Test connection), čímž provedete testovací připojení. 5. Chcete-li provést *testovací výpočet daně*, vyplňte formulář adresy v dolní části stránky (upozorňujeme, že daňový plugin Avalara pro nopCommerce potvrzuje transakce pouze pro adresy v USA) a klikněte na **Testovat daňovou transakci** (Test tax transaction). ![Konfigurace testu](_static/avalara/avalara-configuration-test.png) ## Přiřazení kódu AvaTax Přejděte na **Konfigurace → Daňové kategorie** (Configuration → Tax categories). V pravé horní části stránky uvidíte tlačítko **Avalara tax codes** se značkou Avalara. Po kliknutí na něj se zobrazí následující rozbalovací nabídka: > [!IMPORTANT] > > Tlačítko **Avalara tax codes** se zobrazí pouze tehdy, pokud je plugin *Avalara* vybrán jako hlavní daňový poskytovatel na stránce *Konfigurace → Daňoví poskytovatelé*. ![Daňové kategorie](_static/avalara/tax-categories.jpg) * **Export tax codes to Avalara** – exportuje všechny kódy z vašeho obchodu do backendu AvaTax. * **Import Avalara system tax codes** – importuje všechny daňové kódy AvaTax ze systému Avalara. ![Import daňových kategorií](_static/avalara/tax-categories-import.jpg) * **Delete Avalara system tax codes** – smaže všechny kódy exportované ze systému Avalara. ## Přiřazení systémového daňového kódu AvaTax k položce 1. Přejděte na **Katalog → Produkty** (Catalog → Products). 1. Vyberte produkt, otevřete obrazovku s podrobnostmi produktu a klikněte na **Upravit** (Edit). 1. Na obrazovce **Podrobnosti produktu** (Product Details) na panelu **Cena** (Price) přiřaďte v poli **Daňová kategorie** (Tax category) z rozbalovacího seznamu odpovídající kód. ![Daňová kategorie produktu](_static/avalara/product-tax-category.png) > [!IMPORTANT] > > Pro lepší orientaci v backendu AvaTax se ujistěte, že je zadáno **SKU**. 1. Klikněte na **Uložit** (Save). 1. Seznam všech dostupných systémových daňových kódů AvaTax najdete na [http://taxcode.avatax.avalara.com](http://taxcode.avatax.avalara.com). ## Klasifikace položek Managed Tariff Code Classification je služba Avalara, která přiřazuje celní kódy harmonizovaného systému (HS) k vašemu katalogu produktů. Jakmile Avalara klasifikuje položky, které prodáváte, můžete celní kódy automaticky zahrnout do výpočtů AvaTax nebo je exportovat pro použití ve vlastní podnikové aplikaci. Celní orgány používají celní kódy harmonizovaného systému (HS) k výpočtu celních sazeb pro všechny mezinárodně obchodované produkty. Na rozdíl od kódů daně z prodeje a užití nejsou celní kódy univerzální. Produktům, které prodáváte do zahraničí, přiřaďte plně kvalifikované celní kódy, abyste mohli vypočítat cla a dovozní daně. V AvaTax jsou nadřazené produkty klasifikovány celním kódem a všechna podřízená SKU tuto klasifikaci dědí. 1. Aktivujte funkci *Klasifikace položek* (Item Classification) na stejnojmenné kartě. 1. Určete, pro které země se mají získat klasifikační kódy HS. 1. Uložte nastavení pomocí tlačítka **Uložit** (Save). ![Klasifikace položek](_static/avalara/item-classification.png) 1. Přejděte do **Item Classification settings** ve svém osobním účtu Avalara. ![Klasifikace položek v Avalara](_static/avalara/item-classification-avalara.png) 1. Zadejte adresu koncového bodu pro webhook – `{your.store.url}/avalara/item-classification-webhook` ![Koncový bod klasifikace položek](_static/avalara/item-classification-endpoint.png) 1. Znovu přejděte na konfigurační stránku pluginu a určete, které produkty mají být odeslány ke klasifikaci. ![Synchronizace klasifikace položek](_static/avalara/item-classification-sync.png) 1. Kliknutím na tlačítko **Synchronizovat nyní** (Sync now) spustíte proces odesílání produktů ke klasifikaci. Po obdržení odpovědi ze služby Avalara se tabulka naplní přijatými hodnotami (tabulky je třeba aktualizovat ručně). Poté budou přijaté hodnoty klasifikačních kódů předány k výpočtu daňových sazeb. ## Ověření adresy zákazníka 1. Ujistěte se, že je zaškrtnuto políčko **Ověřovat adresu** (Validate address); v takovém případě bude adresa ověřena automaticky. 1. Uživatel uvidí následující obrazovku: ![Ověření adresy](_static/avalara/validate-customer-address.png) ## Osvobození od daně Pomocí tohoto pluginu lze osvobození od daně povolit dvěma způsoby: 1. Přiřaďte v administraci kategorii osvobození od daně AvaTax konkrétnímu zákazníkovi nebo celé roli zákazníka: * Klikněte na **Zákazníci → Zákazníci → Upravit zákazníka** (Customers → Customers → Edit customer) * Najděte zvýrazněné pole **Kód použití entity** (Entity use code), klikněte na něj a vyberte odpovídající kód typu zákazníka. ![Podrobnosti zákazníka](_static/avalara/customer-entity-use-code.png) * Klikněte na **Uložit** (Save) > [!NOTE] > > Políčko **Osvobozeno od daně** (Tax exempt) není nutné zaškrtávat: stačí přiřadit **Kód použití entity**. 2. Aktivujte funkci certifikátů osvobození: > [!IMPORTANT] > > Aby tato funkce fungovala správně, budete potřebovat [účet CertCapture](https://avlr.co/3bA1P1X). * Ujistěte se, že je zaškrtnuto políčko **Povolit certifikáty osvobození** (Enable exemption certificates); v takovém případě budou zákazníci moci před nákupem spravovat své certifikáty osvobození od daně. * V sekci účtu bude přidána nová stránka ![Certifikáty osvobození od daně](_static/avalara/exemption-certificates.png) --- # E-mailové účty Tato kapitola popisuje, jak nastavit e-mailové účty spojené s vaším obchodem: obecný kontaktní e-mail, e-mail obchodního zástupce, e-mail zákaznické podpory a další. Chcete-li spravovat e-mailové účty, přejděte do **Konfigurace → E-mailové účty** (Configuration → Email accounts). Okno *E-mailové účty* zobrazuje e-mailové účty majitele obchodu, jak je uvedeno níže. Po nakonfigurování e-mailových účtů může majitel obchodu vybrat požadovaný e-mailový účet na stránce podrobností šablony zprávy, jak je popsáno v kapitole [Šablony zpráv](xref:cs/running-your-store/content-management/message-templates). ![E-mailové účty](_static/email-accounts/email-accounts.png) ## Přidání nového e-mailového účtu Chcete-li přidat nový e-mailový účet, klikněte na **Přidat nový** (Add new). Zobrazí se okno *Přidat nový e-mailový účet*: ![Přidat nový e-mailový účet](_static/email-accounts/email-accounts-add-new.png) Definujte následující informace o e-mailovém účtu: * Do pole **E-mailová adresa** (Email address) zadejte e-mailovou adresu pro všechny odchozí e-maily vašeho obchodu. Příklad: `sales@yourstore.com`. > [!NOTE] > > Někteří poskytovatelé e-mailu nemusí toto nastavení použít, pokud tato e-mailová adresa není přidána jako alias/účet pro odesílání v e-mailovém účtu, který používáte k ověření. * Do pole **Zobrazované jméno e-mailu** (Email display name) zadejte zobrazované jméno pro odchozí e-maily vašeho obchodu. Příklad: „Obchodní oddělení vašeho obchodu“. * Do pole **Hostitel** (Host) zadejte název hostitele nebo IP adresu vašeho e-mailového serveru. * Do pole **Port** zadejte SMTP port vašeho e-mailového serveru. * Zaškrtněte políčko **SSL**, chcete-li k šifrování SMTP připojení použít protokol Secure Sockets Layer. * Do pole **Maximální počet e-mailů** (Max number of emails) zadejte maximální počet e-mailů odeslaných najednou. * Zvolte **Metodu ověřování** (Authentication method), která bude použita k identifikaci klienta při připojení k SMTP serveru. * *Bez ověřování* (No authentication) (žádná další pole) * *NTLM (výchozí síťové přihlašovací údaje)* (NTLM (the default network credentials)) * *Přihlašovací jméno/Heslo* (Login/Password) * Do pole **Uživatel** (User) zadejte uživatelské jméno k vašemu e-mailovému serveru. * Do pole **Heslo** (Password) zadejte heslo k vašemu e-mailovému serveru. * *Google (OAuth2)* ![E-mailový účet - Google](_static/email-accounts/email-accounts-google.png) * **ID klienta** (Client ID). Veřejný identifikátor aplikace. * **Tajný klíč klienta** (Client Secret). Tajemství známé pouze aplikaci a autorizačnímu serveru. * *Microsoft (OAuth2)* ![E-mailový účet - Microsoft](_static/email-accounts/email-accounts-microsoft.png) * **Identifikátor tenanta** (Tenant identifier) může být GUID (ID vaší instance Microsoft Entra), název domény nebo jeden ze zástupných výrazů: „organizations“, „consumers“, „common“. * **ID klienta** (Client ID). Veřejný identifikátor aplikace. * **Tajný klíč klienta** (Client Secret). Tajemství známé pouze aplikaci a autorizačnímu serveru. Klikněte na **Uložit** (Save). Okno se rozšíří následovně: ![E-mailový účet - Podrobnosti](_static/email-accounts/email-accounts-details.png) Do pole **Odeslat e-mail na** (Send email to) zadejte e-mailovou adresu pro testovací e-mail a klikněte na **Odeslat testovací e-mail** (Send test email). --- # Pokročilá konfigurace * [Jak nainstalovat a nakonfigurovat certifikáty SSL](xref:cs/getting-started/advanced-configuration/how-to-install-and-configure-ssl-certificates) * [Informace o vašem obchodu](xref:cs/getting-started/advanced-configuration/your-store-information) * [Nastavení GDPR](xref:cs/getting-started/advanced-configuration/gdpr-settings) * [Lokalizace](xref:cs/getting-started/advanced-configuration/localization) * [Vlastní HTML](xref:cs/getting-started/advanced-configuration/custom-html) * [Metody externího ověřování](xref:cs/getting-started/advanced-configuration/external-authentication-methods) * [Vícefaktorové ověřování](xref:cs/getting-started/advanced-configuration/multi-factor-authentication) * [Integrace AI agenta Jotform](xref:cs/getting-started/advanced-configuration/jotform) * [Konfigurace analytiky](xref:cs/getting-started/advanced-configuration/configure-analytics) * [Pluginy v nopCommerce](xref:cs/getting-started/advanced-configuration/plugins-in-nopcommerce) * [Více obchodů](xref:cs/getting-started/advanced-configuration/multi-store) * [Nastavení zabezpečení](xref:cs/getting-started/advanced-configuration/security-settings) * [Poskytovatelé SMS](xref:cs/getting-started/advanced-configuration/sms-providers/index) * [Nakupování přes ChatGPT](xref:cs/getting-started/advanced-configuration/chatgpt-shopping) * [Google AI Commerce Search](xref:cs/getting-started/advanced-configuration/google-ai-commerce-search) * [PunchOut](xref:cs/getting-started/advanced-configuration/punchout) * [Nastavení robots.txt](xref:cs/getting-started/advanced-configuration/robots-txt) * [Nastavení PDF](xref:cs/getting-started/advanced-configuration/pdf-settings) * [Všechna nastavení](xref:cs/getting-started/advanced-configuration/all-settings) --- # Jak nainstalovat a nakonfigurovat SSL certifikáty Co je SSL certifikát? SSL je zkratka pro Secure Socket Layer. SSL certifikáty ověřují identitu vašeho webu a šifrují informace, které návštěvníci na váš web odesílají (nebo z něj přijímají). Když váš web chrání SSL certifikát, mohou mít vaši zákazníci jistotu, že informace, které zadají na jakékoli zabezpečené stránce, jsou soukromé a kyberzločinci je nemohou zobrazit. ## Jak získat SSL certifikát 1. Chcete-li na svém webu implementovat SSL, musíte nejprve získat SSL certifikát od poskytovatele SSL certifikátů, neboli certifikační autority. Existuje mnoho certifikačních autorit, u kterých můžete pro svůj web získat SSL certifikát, například SSL.com, Namecheap nebo GoDaddy. 2. Poté je třeba zakoupený SSL certifikát nainstalovat na server. Způsob, jak to provést, závisí na serveru. Další pokyny a doporučení najdete v návodu poskytovatele SSL certifikátu nebo v dokumentaci k serveru. V tomto článku uvedu pouze odkaz na takový návod od společnosti GoDaddy: [Instalace SSL certifikátů](https://www.godaddy.com/help/install-ssl-certificates-16623). 3. V posledním kroku je třeba nastavit obchod nopCommerce v administraci. Přejděte na stránku **Konfigurace → Obchody** (Configuration → Stores). Vyberte obchod, který chcete nastavit, a klikněte na tlačítko **Upravit** (Edit) vedle něj. Zobrazí se okno *Upravit podrobnosti obchodu* (Edit store details): ![Obchod](_static/how-to-install-and-configure-ssl-certificates/store.jpg) - Zadejte **URL obchodu** (Store URL) s předponou `https://`. - Zaškrtněte políčko **SSL povoleno** (SSL enabled). > [!WARNING] > > Nepovolujte jej, dokud nemáte na serveru nainstalovaný SSL certifikát. ## Řešení problémů ### Administrace není dostupná kvůli problémům se SSL certifikátem Častým problémem je situace, kdy SSL certifikát není na serveru nainstalován nebo jsou problémy s konfigurací SSL. Současně bylo v obchodě aktivováno nastavení **SSL povoleno** (SSL enabled) (jak jsme to udělali v předchozí části). **Dotčené verze**: Všechny **Řešení**: Spusťte následující SQL dotaz: ```sql UPDATE [dbo].[Store] SET [SslEnabled] = 'False' ``` ### Smíšený obsah HTTP a HTTPS Smíšený obsah vzniká, když web funguje přes bezpečnostní protokol SSL, ale některé prostředky (například obrázky) se načítají přes nezabezpečené připojení HTTP. To způsobuje chyby na stránce, protože původní požadavek byl zabezpečen přes HTTPS. Při použití load balanceru mohou vznikat podobné problémy, protože komunikuje s aplikací přes HTTP. **Dotčené verze**: 4.20 a starší **Řešení**: - Ujistěte se, že jste aktivovali nastavení: ```json securitysettings.forcesslforallpages = true ``` - Ujistěte se, že váš web na hostingovém serveru naslouchá na portu 443. **Dotčené verze**: Všechny **Řešení**: - V hlavičce požadavku chybí pole `UseHttpXForwardedProto`. Zkuste v souboru `appsettings.json` povolit nastavení `UseHttpXForwardedProto` a restartovat web. ```json "UseHttpXForwardedProto": true ``` - Problém můžete vyřešit přidáním direktivy CSP „upgrade-insecure-requests“. To lze provést buď v souboru `web.config`, nebo vložením stejné inline direktivy do sekce `` dokumentu pomocí elementu ``: ```XML ``` - Pokud používáte Cloudflare, zkontrolujte, zda je vaše nastavení SSL v režimu `Full` nebo `Flexible` – přihlaste se do ovládacího panelu Cloudflare a klikněte na `SSL/TLS app`, kde nastavení SSL zkontrolujete. ### Nekonečná smyčka přesměrování (ERR_TOO_MANY_REDIRECTS) Když se nepřihlášený uživatel pokusí přihlásit nebo navštívit nákupní košík, web se dostane do nekonečné smyčky přesměrování. **Dotčené verze**: Všechny **Řešení**: - Zkuste na webu smazat cookies; postup se může mírně lišit v závislosti na používaném prohlížeči. Případně můžete stránku jednoduše otevřít v anonymním režimu a ověřit, zda je to příčinou chyby. - Vymažte cache serveru, proxy a prohlížeče. - Zkontrolujte přesměrování z HTTP na HTTPS na serveru. Je docela možné, že pravidla přesměrování na HTTPS na vašem serveru byla chybně nakonfigurována. Do IIS můžete přidat pravidlo přesměrování z http na https. Vzor pravidla má následující podobu: ```xml ``` - ERR_TOO_MANY_REDIRECTS často způsobují také služby reverzní proxy, jako je Cloudflare. To se obvykle stává, když je zapnutá jejich možnost Flexible SSL a vy již máte u svého webhostingu nainstalovaný SSL certifikát. Když je zvolena možnost Flexible, všechny požadavky na váš hostingový server se odesílají přes HTTP. Váš hostingový server již s největší pravděpodobností má nastavené přesměrování z HTTP na HTTPS, a proto vzniká smyčka přesměrování. Chcete-li to napravit, musíte v nastavení Cloudflare Crypto změnit Flexible na Full nebo Full (strict). --- # Informace o vašem obchodě Ve výchozí instalaci nopCommerce je vytvořen pouze jeden obchod, který je potřeba nakonfigurovat, jak je popsáno níže. Chcete-li nastavit výchozí obchod, přejděte na **Konfigurace → Obchody** (Configuration → Stores). ![hlavní obchod](_static/your-store-information/mainstore.png) Kliknutím na **Upravit** (Edit) vedle výchozího obchodu jej nakonfigurujete. ![úprava obchodu](_static/your-store-information/Store-Edit.png) ## Informace Podrobnosti hlavního obchodu nakonfigurujte takto: * Definujte **Název obchodu** (Store name). * Zadejte **URL obchodu** (Store URL). * Stiskněte tlačítko **SSL**, pokud je váš obchod zabezpečen pomocí SSL. SSL (Secure Sockets Layer) je standardní bezpečnostní technologie pro vytvoření šifrovaného spojení mezi webovým serverem a prohlížečem. Toto spojení zajišťuje, že všechna data přenášená mezi webovým serverem a prohlížeči zůstanou soukromá a neporušená. SSL je průmyslový standard, který miliony webů používají k ochraně online transakcí se svými zákazníky. > [!IMPORTANT] > > Toto tlačítko stiskněte až po instalaci certifikátu SSL na server. V opačném případě nebudete mít ke svému webu přístup a budete muset ručně upravit příslušný záznam v databázi (tabulka [Store]). > > [!TIP] > > Více o nastavení SSL se dočtete v následující kapitole: [Jak nainstalovat a nakonfigurovat certifikáty SSL](xref:cs/getting-started/advanced-configuration/how-to-install-and-configure-ssl-certificates). * Pole **Hodnoty HOST** (HOST values) je seznam možných hodnot HTTP_HOST vašeho obchodu (například `yourstore.com`, `www.yourstore.com`). Vyplnění tohoto pole je nutné pouze v případě, že máte [řešení s více obchody](xref:cs/getting-started/advanced-configuration/multi-store), aby bylo možné určit aktuální obchod. Toto pole umožňuje rozlišit požadavky na různé URL a určuje aktuální obchod. Aktuální hodnotu HTTP_HOST můžete zobrazit také v **Systém → Informace o systému** (System → System information). * V poli **Výchozí jazyk** (Default language) zvolte výchozí jazyk obchodu. Pole můžete také ponechat nevybrané. V takovém případě se použije první nalezený jazyk (s nejnižším pořadím zobrazení). * Definujte **Pořadí zobrazení** (Display order) tohoto obchodu. Hodnota 1 představuje začátek seznamu. * Definujte **Název společnosti** (Company name). * Definujte **Adresu společnosti** (Company address). * Nastavte **Telefonní číslo společnosti** (Company phone number). * Do pole **DIČ společnosti** (Company VAT) zadejte DIČ (VAT number) vaší společnosti (používá se v EU). ## SEO Majitel obchodu může pro každý obchod lokalizovat hlavní klíčové slovo webu, meta titulek a meta popis. ![SEO](_static/your-store-information/SEO.png) ## Viz také * [Nastavení více obchodů](xref:cs/getting-started/advanced-configuration/multi-store) * [Země](xref:cs/getting-started/configure-shipping/advanced-configuration/countries-states) * [Jazyky](xref:cs/getting-started/advanced-configuration/localization) * [Nastavení zabezpečení](xref:cs/getting-started/advanced-configuration/security-settings) * [Nastavení PDF](xref:cs/getting-started/advanced-configuration/pdf-settings) * [Nastavení GDPR](xref:cs/getting-started/advanced-configuration/gdpr-settings) --- # Nastavení GDPR *GDPR* (obecné nařízení o ochraně osobních údajů, General Data Protection Regulation) je revidovaný nový zákon Evropské unie o ochraně osobních údajů, který ovlivňuje, jak všechny společnosti shromažďují, používají a sdílejí osobní údaje svých evropských zákazníků. Nařízení vstoupilo v platnost 24. května 2016 a uplatňuje se od 25. května 2018. Nařízení je zásadním krokem k posílení základních práv jednotlivců v digitálním věku a usnadňuje podnikání tím, že vyjasňuje pravidla pro společnosti a veřejné orgány na jednotném digitálním trhu. Další informace naleznete v tomto zdroji: [https://ec.europa.eu/info/law/law-topic/data-protection/data-protection-eu_en](https://ec.europa.eu/info/law/law-topic/data-protection/data-protection-eu_en) ## Konfigurace GDPR Chcete-li ve svém obchodě nopCommerce povolit nastavení GDPR, přejděte do **Administrace → Konfigurace → Nastavení → Nastavení GDPR** (Administration → Configuration → Settings → GDPR settings). ![Konfigurace](_static/gdpr-settings/configure.jpg) Poté zaškrtněte políčko **GDPR povoleno** (GDPR enabled). Další nastavení vám umožní zaznamenávat protokol následujících činností: * **Zaznamenávat souhlas „přijetí zásad ochrany osobních údajů“** (Log "accept privacy policy" consent). * **Zaznamenávat souhlas s „odběrem novinek“** (Log "newsletter" consent). * **Zaznamenávat změny uživatelského profilu** (Log user profile changes). * **Smazat neaktivní zákazníky po uplynutí měsíců** (Delete inactive customers after months) – výchozí hodnota je 36 měsíců. Souhlasy na svém webu nopCommerce můžete přidat kliknutím na tlačítko **Přidat souhlas** (Add consent) na panelu *Souhlasy*: ![Souhlasy](_static/gdpr-settings/consents.jpg) Pro přidání nového souhlasu budete přesměrováni do okna *Přidat souhlas*: ![Přidat souhlas](_static/gdpr-settings/add-consent.jpg) Definujte následující nastavení souhlasu: * **Zpráva** (Message) nebo otázka, která se zobrazí zákazníkům. * Zda je souhlas **Povinný** (Is required). * Zda se souhlas **Zobrazí během registrace** (Displayed during registration). * Zda se souhlas **Zobrazí na stránce „informace o zákazníkovi“** (Displayed on "customer info" page) v sekci „Můj účet“. * **Pořadí zobrazení** (Display order) je pořadí zobrazení souhlasu. Hodnota 1 představuje první položku v seznamu. Zde je příklad možnosti souhlasu na stránce s informacemi o zákazníkovi: ![souhlas](_static/gdpr-settings/agreement.png) Pokud jste povolili nastavení protokolu souhlasů, můžete si protokol činností zobrazit v **Administrace → Zákazníci → Požadavky GDPR (protokol)** (Administration → Customers → GDPR requests (log)). ![protokol](_static/gdpr-settings/log.png) Když je nastavení GDPR povoleno, může majitel obchodu provádět také tyto akce: * **Trvale smazat** (Permanent delete) pro smazání záznamu zákazníka. * **Exportovat data** (Export data) pro export dat zákazníka. K tomu přejděte na stránku **Administrace → Zákazníci → Upravit zákazníka** (Administration → Customers → Edit customer). ![detail zákazníka](_static/gdpr-settings/customerdetails.png) ## Návody * [Správa nastavení GDPR v nopCommerce](https://www.youtube.com/watch?v=6bLc_TDqD18&feature=youtu.be) --- # Lokalizace V nopCommerce může mít váš obchod nainstalováno několik jazyků. Zákazníci však uvidí pouze data, která byla definována v jimi zvoleném jazyce. > [!TIP] > > Ve výchozím stavu je nainstalována angličtina. Chcete-li zobrazit nebo upravit nainstalované jazyky, přejděte do **Konfigurace → Jazyky** (Configuration → Languages): ![language](_static/localization/Language.png) > [!NOTE] > > Nové jazykové balíčky si můžete stáhnout z oficiální stránky [Translations](https://www.nopcommerce.com/translations). ## Přidání nového jazyka Chcete-li přidat nový jazyk, klikněte na **Přidat nový** (Add new). V okně *Přidat nový jazyk* definujte následující nastavení: ![addlanguage](_static/localization/addlanguage.png) * **Název** (Name) nového jazyka. * **Jazyková kultura** (Language culture) — konkrétní kód jazyka (například de-AT pro rakouskou němčinu). > [!NOTE] > > Při úpravě pole **Jazyková kultura** se ujistěte, že je pro tuto kulturu nainstalován příslušný balíček CLDR. CLDR pro zadanou kulturu můžete nastavit na panelu *Lokalizace* na stránce **Konfigurace → Nastavení → Obecná nastavení** (Configuration → Settings → General Settings). * **Jedinečný SEO kód** (Unique SEO code) — dvoupísmenný SEO kód jazyka, který se používá ke generování URL jako `http://www.yourstore.com/en/`, pokud máte publikováno více jazyků. > [!NOTE] > > Na panelu **Konfigurace → Nastavení → Obecná nastavení → Nastavení lokalizace** (Configuration → Settings → General settings → Localization settings) by měla být povolena možnost **SEO přátelské URL s více jazyky** (SEO friendly URLs with multiple languages). * **Název souboru obrázku vlajky** (Flag image file name) — zadejte název souboru obrázku vlajky. Obrázek by měl být uložen v adresáři `…/images/flags`. Obrázek můžete také vybrat z předdefinovaného seznamu. * V případě potřeby zaškrtněte **Zprava doleva** (Right-to-Left) (například pro arabštinu nebo hebrejštinu). > [!NOTE] > > Aktivní šablona musí podporovat RTL (mít odpovídající soubor stylů CSS). Tato možnost ovlivňuje pouze veřejnou část obchodu. * **Výchozí měna** (Default currency) pro konkrétní jazyk. Pokud není zadána, použije se první nalezená (s nejnižším pořadím zobrazení). * Možnost **Omezeno na obchody** (Limited to stores) umožňuje nastavit tento jazyk pro konkrétní obchod(y). Obchod(y) můžete vybrat z předem vytvořeného seznamu. Pokud tuto možnost nepoužíváte, ponechte pole prázdné. > [!NOTE] > > Chcete-li používat omezení na obchody, musí být na panelu **Konfigurace → Nastavení → Nastavení katalogu → Výkon** (Configuration → Settings → Catalog settings → Performance) zakázána možnost **Ignorovat pravidla „omezení na obchod“ (pro celý web)** (Ignore "limit per store" rules (sitewide)). * **Publikovat** (Publish) jazyk, aby byl viditelný a návštěvníci vašeho obchodu si jej mohli vybrat. * **Pořadí zobrazení** (Display order) jazyka. Hodnota 1 představuje začátek seznamu. Kliknutím na **Uložit** (Save) uložte změny. > [!NOTE] > > Protože se jazykové kultury načítají pouze při spuštění aplikace, je nutné po přidání nebo odstranění jazyka aplikaci restartovat. > > [!NOTE] > > Po přidání nového jazyka budete moci importovat a exportovat řetězcové prostředky pomocí tlačítek **Importovat prostředky** (Import resources) a **Exportovat prostředky** (Export resources) v horní části stránky. Panel *Řetězcové prostředky* (String resources) na stránce úpravy jazyka vám umožní zobrazit existující jazykové prostředky a ručně přidat nové. ## Import jazykového balíčku Pokud chcete do svého obchodu přidat nový jazyk, postupujte takto: 1. Navštivte stránku [překladů](https://www.nopcommerce.com/translations) nopCommerce. 1. Vyberte verzi nopCommerce a stáhněte požadovaný jazykový balíček. 1. Přejděte do **Konfigurace → Jazyky** (Configuration → Languages) a klikněte na tlačítko **Přidat nový** (AddNew). ![LanguageAddNew](_static/localization/language-add-new.png) 1. Vyplňte povinná pole a klikněte na **Uložit a pokračovat v úpravách** (Save and continue edit). ![LanguageSave](_static/localization/language-save.png) 1. Klikněte na **Importovat prostředky** (Import resources) a zadejte cestu ke staženému souboru jazykového balíčku (*.xml). ![LanguageImport](_static/localization/language-import.png) Pokud jste v překladu našli chybu nebo chcete vlastní pojmenování, můžete řetězcové prostředky upravit na panelu *Řetězcové prostředky* (String resources). ## Správa řetězcových prostředků Přejděte do **Konfigurace → Jazyky** (Configuration → Languages). Zobrazí se okno *Jazyky*: ![Jazyky](_static/localization/languages.png) Klikněte na tlačítko **Upravit** (Edit) vedle jazyka. V okně **Upravit podrobnosti jazyka** (Edit language details) najděte panel **Řetězcové prostředky** (String resources). Například chcete změnit název panelu v horní části stránky z „Administration“ (na obrázku níže) na „Control panel“. ![Příklad 1](_static/localization/lang-example-before-change.jpeg) 1. Chcete-li najít lokalizační prostředek, který potřebujete upravit, zadejte do pole **Název prostředku** (Resource name) „administration“. Pokud prostředek existuje, bude nalezen. Klikněte na **Upravit** (Edit) vedle něj. 1. Zadejte novou hodnotu do pole **Hodnota** (Value) a klikněte na **Aktualizovat** (Update). ![Příklad 2](_static/localization/lang-resource-edit.png) 1. Změny se projeví: ![Příklad 3](_static/localization/lang-example-after-change.jpeg) Chcete-li přidat nový řetězcový prostředek, použijte panel **Přidat nový záznam** (Add new record). Toto okno umožňuje přidat do tabulky nový záznam prostředku: ![Přidat nový záznam](_static/localization/lang-add-resource.png) * Do pole **Název prostředku** (Resource name) zadejte identifikátor řetězcového prostředku. * Do pole **Hodnota** (Value) zadejte hodnotu pro tento identifikátor řetězcového prostředku. Klikněte na **Uložit** (Save). ## Nastavení lokalizace Chcete-li nakonfigurovat nastavení lokalizace, přejděte do **Konfigurace → Nastavení → Obecná nastavení** (Configuration → Settings → General settings): ![Nastavení lokalizace](_static/localization/lang-localization-settings.jpg) * Chcete-li nastavit vzor [CLDR](http://cldr.unicode.org/) pro lokalizaci validace na straně klienta podle aktuální kultury, klikněte na tlačítko **Nastavit CLDR pro aktuální kulturu** (Set CLDR for current culture). * Zaškrtněte políčko **Načíst všechny lokalizační prostředky při spuštění** (Load all locale resources on startup), chcete-li při spuštění aplikace načíst všechny lokalizační prostředky. Je-li povoleno, všechny lokalizační prostředky se načtou při spuštění aplikace. Spuštění aplikace bude pomalejší, ale poté se všechny stránky otevírají mnohem rychleji. * Zaškrtněte políčko **Načíst všechny lokalizované vlastnosti při spuštění** (Load all localized properties on startup), chcete-li při spuštění aplikace načíst všechny lokalizované vlastnosti. Je-li povoleno, všechny lokalizované vlastnosti (například lokalizované vlastnosti produktů) se načtou při spuštění aplikace. Spuštění aplikace bude pomalejší, ale poté se všechny stránky otevírají mnohem rychleji. Používá se pouze při povolení dvou nebo více jazyků. Nedoporučuje se jej povolovat, pokud máte rozsáhlý katalog (několik tisíc lokalizovaných entit). * Zaškrtněte políčko **Načíst všechny názvy vhodné pro vyhledávače při spuštění** (Load all search engine friendly names on startup), chcete-li při spuštění aplikace načíst všechny názvy vhodné pro vyhledávače (slugy). Je-li povoleno, všechny slugy se načtou při spuštění aplikace. Spuštění aplikace bude pomalejší, ale poté se všechny stránky otevírají mnohem rychleji. Nedoporučuje se jej povolovat, pokud máte rozsáhlý katalog (několik tisíc entit). * Zaškrtněte políčko **Používat obrázky pro výběr jazyka** (Use images for language selection), chcete-li místo názvů jazyků používat obrázky. * Zaškrtněte políčko **SEO přátelské URL s více jazyky povoleny** (SEO friendly URLs with multiple languages enabled), chcete-li povolit SEO přátelské URL pro všechny jazyky. Je-li povoleno, vaše URL budou `http://www.yourStore.com/en/` nebo `http://www.yourStore.com/fr/` (SEO přátelské). > [!NOTE] > > Po změně nastavení **SEO přátelské URL s více jazyky povoleny** musíte aplikaci restartovat. V opačném případě může docházet k chybám. * Zaškrtněte políčko **Automaticky detekovat jazyk** (Automatically detect language) pro detekci jazyka na základě nastavení prohlížeče zákazníka. ## Lokalizace entit Pokud máte ve svém obchodě nainstalováno více jazyků, budete moci zadávat některá pole zobrazovaná zákazníkům v různých jazycích. Například: ![Pole](_static/localization/fields.jpg) * Na *záložce Standardní* zadejte text, který se zákazníkům zobrazí, pokud nejsou lokalizovaná pole zadána. * Na *záložkách s názvy jazyků* zadejte lokalizovaný text. --- # Nastavení vlastního HTML Nastavení *Vlastního HTML* (Custom HTML) spravujete v **Konfigurace → Nastavení → Obecná nastavení** (Configuration → Settings → General settings). Tato stránka umožňuje konfiguraci pro více obchodů; to znamená, že stejná nastavení lze definovat pro všechny obchody, nebo se mohou mezi obchody lišit. Pokud chcete spravovat nastavení pro určitý obchod, vyberte jeho název z rozbalovacího seznamu konfigurace pro více obchodů a zaškrtněte vlevo všechna potřebná políčka, abyste pro ně nastavili vlastní hodnoty. Další podrobnosti naleznete v článku [Více obchodů](xref:cs/getting-started/advanced-configuration/multi-store). ## Vlastní HTML Přestože k plnému využití nopCommerce nejsou běžné znalosti programování potřeba, v některých případech může být nutné přidat kód do záhlaví a zápatí. Můžete například chtít používat analytiku, což je častý důvod, proč dochází k napadení souborů webu. Mnoho nástrojů a sledovacích skriptů vyžaduje přidání úryvků kódu do záhlaví nebo zápatí webu. V tomto článku vám ukážeme, jak přidat kód do HTML záhlaví nebo zápatí nopCommerce. Standardní web se podobně jako textový dokument skládá z několika různých částí: - Záhlaví (header). Záhlaví webu obsahuje řadu prvků „předběžného načtení“ a údaje o certifikátu *Secure Sockets Layer (SSL)*, šifrování, případném JavaScriptu a další. - Tělo (body). - Zápatí (footer). Funguje podobně jako záhlaví, ale nachází se ve spodní části stránky. Servery načítají stránky lineárně – záhlaví, tělo a poté zápatí. To znamená, že kód v záhlaví se načte jako první a kód v zápatí až po všem ostatním. Nastavení *Vlastního HTML* definujte takto: ![Zabezpečení](_static/custom-html/custom-html.jpg) Tímto způsobem se libovolný kód přidá na globální úrovni (tj. pro celý web). --- # Externí metody ověřování Externí metody ověřování umožňují uživatelům přihlásit se na web nopCommerce bez zadávání přihlašovacích údajů – e-mailu a hesla. Uživatelé mohou být ověřeni pomocí externího webu (například Facebook nebo Google). nopCommerce má vestavěné externí ověřování přes Facebook. Další metody můžete nastavit pomocí pluginů z [marketplace](https://www.nopcommerce.com/marketplace). Jakmile je externí metoda ověřování nakonfigurována a označena jako aktivní, uživatelé uvidí na přihlašovací stránce novou možnost ověření. ## Správa externích metod ověřování Přejděte do **Konfigurace → Ověřování → Externí ověřování** (Configuration → Authentication → External authentication). Zobrazí se okno *Externí ověřování*: ![Externí ověřování](_static/external-authentication-methods/external-authentication.png) Klikněte na **Upravit** (Edit) vedle metody ověřování a zaškrtnutím **Je aktivní** (Is active) metodu aktivujte. Můžete také definovat **Pořadí zobrazení** (Display order) metody. Poté kliknutím na tlačítko **Aktualizovat** (Update) změny uložte. Pro konfiguraci metody klikněte na **Konfigurovat** (Configure). ## Správa ověřování přes Facebook Metoda ověřování přes Facebook je vestavěný plugin pro externí ověřování. Chcete-li nakonfigurovat ověřování přes Facebook, postupujte takto: 1. Na stránce **Konfigurace → Ověřování → Externí ověřování** (Configuration → Authentication → External authentication) klikněte na **Konfigurovat** (Configure) vedle **Facebook authentication**. Zobrazí se okno *Konfigurovat - Facebook authentication*: ![Facebook](_static/external-authentication-methods/facebook.jpg) 1. Přejděte na stránku [Facebook for Developers](https://developers.facebook.com/apps) a přihlaste se. Pokud nemáte účet na Facebooku, vytvořte si jej pomocí odkazu Sign up for Facebook na přihlašovací stránce. 1. Klepnutím na tlačítko **+ Add a New App** v pravém horním rohu vytvořte nové App ID. (Pokud jde o vaši první aplikaci na Facebooku, text tlačítka bude **Create a New App**.) 1. Vyplňte formulář a klepněte na tlačítko **Create App ID**. 1. Zobrazí se stránka *Product Setup*, na které můžete vybrat funkce pro novou aplikaci. U *Facebook Login* klikněte na **Get Started**. 1. Klikněte na odkaz **Settings** v nabídce vlevo; zobrazí se stránka *Client OAuth Settings* s již nastavenými výchozími hodnotami. 1. Do pole **Valid OAuth Redirect URIs** zadejte `https://yoursitename.com/signin-facebook`, přičemž `yoursitename.com` nahraďte URL svého webu. 1. Klikněte na **Save Changes**. 1. V levé navigaci klikněte na odkaz **Dashboard**. 1. Zkopírujte své **App ID/API Key** a **App secret** do formuláře na konfigurační stránce pluginu. Klikněte na tlačítko **Uložit** (Save). Na přihlašovací stránce veřejné části obchodu uvidíte nově přidanou metodu ověřování. ## Viz také * [Pluginy v nopCommerce](xref:cs/getting-started/advanced-configuration/plugins-in-nopcommerce) --- # Vícefaktorové ověřování Vícefaktorové ověřování (MFA) (v našem případě jde o dvoufaktorové ověřování – 2FA) je metoda ověřování, která vyžaduje, aby uživatel pro získání přístupu ke zdroji poskytl dva nebo více ověřovacích faktorů. MFA je klíčovou součástí silné politiky správy identit a přístupu (IAM). Místo pouhého zadání uživatelského jména a hesla vyžaduje MFA jeden nebo více dalších ověřovacích faktorů, což snižuje pravděpodobnost úspěšného kybernetického útoku. nopCommerce implementuje vestavěné vícefaktorové ověřování prostřednictvím Google Authenticator. Další metody můžete nastavit pomocí pluginů z [marketplace](https://www.nopcommerce.com/marketplace). ## Správa metod vícefaktorového ověřování Ve výchozím nastavení není plugin Google Authenticator nainstalován. Chcete-li plugin nainstalovat, přejděte do **Konfigurace → Místní pluginy** (Configuration → Local plugins). 1. Vyhledejte *Google Authenticator* v poli **Název pluginu** (Plugin name). 1. Klikněte na tlačítko **Instalovat** (Install). 1. Poté klikněte na tlačítko **Restartovat aplikaci pro použití změn** (Restart application to apply changes), aby se změny projevily. 1. Přejděte do **Konfigurace → Ověřování → Vícefaktorové ověřování** (Configuration → Authentication → Multi-factor authentication). Zobrazí se okno *Vícefaktorové ověřování*: ![Vícefaktorové ověřování](_static/multi-factor-authentication/list.jpg) 1. Klikněte na **Upravit** (Edit) vedle metody ověřování a zaškrtnutím **Je aktivní** (Is active) metodu aktivujte. Můžete také definovat **Pořadí zobrazení** (Display order) metody. Poté kliknutím na tlačítko **Aktualizovat** (Update) uložte změny. ## Konfigurace pluginu Google Authenticator Kliknutím na **Konfigurovat** (Configure) metodu nakonfigurujete. Zobrazí se stránka *Konfigurace - Google Authenticator*: ![Vícefaktorové ověřování](_static/multi-factor-authentication/google-authenticator.jpg) Na této stránce musíte zadat: - **Obchodní prefix** (Business prefix), aby uživatelé mohli v aplikaci GoogleAuthenticator rozlišit informace o účtu pro váš obchod. - **QRPixelsPerModule** pro nastavení počtu pixelů na jednotku. Modul je jeden čtverec v QR kódu. Ve výchozím nastavení je to 3 pro obrázek o velikosti 171 × 171 pixelů. Poté klikněte na **Uložit** (Save). Na této stránce můžete také vyhledávat zákazníky podle e-mailu pomocí panelu *Hledat*. ## Jak to funguje Chcete-li pochopit, jak vícefaktorové ověřování v nopCommerce funguje, podívejte se na níže uvedený diagram. - Schéma **2FA nakonfigurováno** znázorňuje proces, kdy už zákazník 2FA nakonfiguroval. ![Jak to funguje](_static/multi-factor-authentication/2FA_configured.jpg) - Schéma **Nastavení 2FA** znázorňuje proces, kdy musí zákazník 2FA teprve nastavit. ![Jak to funguje](_static/multi-factor-authentication/2FA_setup.jpg) ## Stránka vícefaktorového ověřování ve veřejném obchodě Chcete-li nakonfigurovat vícefaktorové ověřování, musí zákazník navštívit stránku **Můj účet - Vícefaktorové ověřování** (My account - Multi-factor authentication), která vypadá takto: ![Jak to funguje](_static/multi-factor-authentication/my-account.jpg) Postup aktivace MFA: 1. Aktivujte nastavení **Je povoleno** (Is enabled). 1. Zvolte jednoho z poskytovatelů vícefaktorového ověřování (ve výchozím nastavení je k dispozici pouze jeden). 1. Uložte. 1. Nakonfigurujte vybraného poskytovatele vícefaktorového ověřování podle pokynů na stránce individuálního nastavení vybraného poskytovatele. > [!WARNING] > > Po uložení vybraného poskytovatele jej nezapomeňte nakonfigurovat; jinak vám bude při příštím pokusu o přihlášení k účtu odepřen přístup. --- # Integrace Jotform AI Agent do obchodu nopCommerce ## Co je Jotform AI Agent? [Jotform AI Agent](https://www.jotform.com/ai/agents/?partner=nopCommerce) je výkonný nástroj zákaznického servisu, který poskytuje pomoc v reálném čase. Jotform AI Agent není jen chatbot. Dokáže okamžitě odpovídat na dotazy ohledně doby doručení, zásad vracení zboží a dostupnosti produktů, a snižuje tak míru opuštění webu mimo pracovní dobu. Dokáže doporučovat produkty na základě vstupu uživatele a navádět uživatele na konkrétní stránky produktů ve vašem obchodě nopCommerce. Díky personalizovaným konverzacím a dostupnosti 24/7 zvyšuje spokojenost zákazníků a zefektivňuje vaše procesy podpory, což vede k lepšímu udržení zákazníků a vyšším prodejům. ## První kroky 1. [Zaregistrujte se do Jotform](https://www.jotform.com/?partner=nopCommerce) (nebo se přihlaste, pokud již účet máte). 1. Přejděte na stránku Workspace a klikněte na tlačítko Create v levém horním rohu. ![Tlačítko Create](_static/jotform/create.png) 1. Klikněte na „AI Agent“. ![start](_static/jotform/start.png) 1. Na otevřené stránce Describe the Agent zadejte do pole Describe the Agent popis AI agenta, kterého chcete vytvořit. Například: „Vytvoř agenta zákaznické podpory, který pohotově odpovídá na dotazy, řeší problémy a nabízí užitečná řešení.“ Případně můžete kliknout na jedno z tlačítek pod ním s předdefinovaným popisem a poté kliknout na Send. ![popis](_static/jotform/describe.png) Tím se vytvoří AI agent podle toho, co jste napsali, a budete přesměrováni přímo do AI Agent Builder, kde jej můžete dále upravit a přizpůsobit. ![builder](_static/jotform/builder.png) ## Jak přizpůsobit personu agenta Přizpůsobení persony vašeho AI agenta je jednoduché a pomáhá přizpůsobit jeho interakce vašim konkrétním potřebám. Snadno můžete upravit jméno AI agenta, jeho roli, tón komunikace, a dokonce i to, jak je upovídaný, což umožňuje personalizovanější a efektivnější uživatelský zážitek. Doladěním těchto nastavení můžete ovlivnit, jak váš AI agent komunikuje, aby každá konverzace působila přirozeněji a poutavěji. Ať už chcete, aby byl formální, neformální, nebo něco mezi tím, volba je zcela na vás! Další podrobnosti najdete v průvodcích Jotform AI Agent: 1. [Jak přizpůsobit avatar agenta](https://www.jotform.com/help/how-to-customize-agent-avatar/?partner=nopCommerce/?partner=nopCommerce) 1. [Jak přizpůsobit design agenta](https://www.jotform.com/help/how-to-customize-agents-design/?partner=nopCommerce) 1. [Jak přizpůsobit personu agenta](https://www.jotform.com/help/how-to-customize-agent-persona/?partner=nopCommerce) 1. [Jak natrénovat AI agenta](https://www.jotform.com/help/how-to-train-your-ai-agent/?partner=nopCommerce) 1. [Jak přizpůsobit akce a spouštěče agenta](https://www.jotform.com/help/how-to-customize-agent-actions-and-triggers/?partner=nopCommerce) 1. [Jak učit agenta pomocí chatu](https://www.jotform.com/help/how-to-teach-your-agent-by-chatting/?partner=nopCommerce) 1. [Jak natrénovat AI agenta pomocí URL adres](https://www.jotform.com/help/how-to-train-an-ai-agent-with-urls/?partner=nopCommerce) 1. [Jak umožnit agentům vyhledávat konkrétní klíčová slova na určeném webu](https://www.jotform.com/help/how-to-let-your-agents-to-search-specific-keywords-in-defined-website/?partner=nopCommerce) ## Integrace s nopCommerce * Přečtěte si článek „[How to Use Agent as Chatbot](https://www.jotform.com/help/how-to-use-agent-as-chatbot/)“, abyste pochopili, jak vytvořit kód pro vložení * Poté v nastavení pluginu zaškrtněte políčko Povoleno (Enabled) ![Stránka konfigurace](_static/jotform/config-page.png) * Zobrazí se textové pole **Kód pro vložení** (Embed code) * Zkopírujte JavaScriptový kód z jotform.com a klikněte na tlačítko Uložit (Save) ![Dokončení konfigurace](_static/jotform/configured.png) --- # Plugin Google Analytics Tato část popisuje, jak do obchodu přidat a integrovat plugin **Google Analytics**. Konfigurace pluginu Google Analytics: Přejděte na **Konfigurace → Widgety** (Configuration → Widgets). Zobrazí se okno *Widgety*: ![Widgety](_static/configure-analytics/google-analytics-widgets.png) ## Aktivace pluginu Klikněte na **Upravit** (Edit) vedle položky **Google analytics**. Okno se rozbalí takto: ![Google Analytics](_static/configure-analytics/google-analytics-widgets-edit.jpg) Zaškrtnutím políčka **Je aktivní** (Is active) povolíte plugin Google Analytics. Poté klikněte na tlačítko **Aktualizovat** (Update) a uložte změny. ## Konfigurace pluginu Klikněte na **Konfigurovat** (Configure) vedle položky **Google analytics**. Zobrazí se okno *Konfigurovat – Google analytics*: ![Google Analytics – konfigurace](_static/configure-analytics/google-analytics-widgets-configure.png) Pro povolení integrace Google Analytics proveďte následující kroky: * Vytvořte si **účet Google Analytics** na odkazu [http://www.google.com/analytics/](http://www.google.com/analytics/) a podle průvodce přidejte svůj web * Zkopírujte **ID Google Analytics** do pole **ID** ve formuláři. * Zadejte **Sledovací kód** (Tracking code) vygenerovaný službou Google Analytics. {GOOGLEID} a {CUSTOMER_TRACKING} budou dynamicky nahrazeny. * Zaškrtnutím políčka **Povolit eCommerce** (Enable eCommerce) budou informace o objednávkách předávány funkci Google eCommerce. Je-li políčko zaškrtnuto, zobrazí se následující pole: * Zaškrtněte **Použít JS k odeslání informací eCommerce** (Use JS to send eCommerce info), chcete-li k odeslání informací o e-commerce ze stránky dokončené objednávky použít kód JS. U platebních metod s přesměrováním ji někteří zákazníci mohou přeskočit. V opačném případě se informace o e-commerce odešlou pomocí požadavku HTTP. Informace se odesílají při každém zaplacení objednávky, v tomto režimu však nejsou podporovány parametry UTM. * Zaškrtněte **Zahrnout daň** (Include tax), chcete-li při generování sledovacího kódu pro část e-commerce zahrnout daň. * Zaškrtnutím políčka **Zahrnout ID zákazníka** (Include customer ID) se do skriptu zahrne identifikátor zákazníka. Klikněte na **Uložit** (Save). Google Analytics bude integrováno do vašeho obchodu. --- # Pluginy v nopCommerce Pluginy jsou sady komponent, které obchodu nopCommerce přidávají specifické funkce. Příkladem pluginů jsou platební moduly, metody výpočtu ceny dopravy a další. Tato část popisuje, jak pluginy instalovat ručně. [Marketplace](http://www.nopcommerce.com/marketplace) nopCommerce nabízí řadu pluginů rozšiřujících funkce vašeho obchodu. Pluginy lze instalovat buď stažením z marketplace, nebo přímo z administrace. Pluginy na marketplace lze řadit podle kategorie, verze, názvu nebo hodnocení a mohou být zdarma i placené. Pluginy dostupné na marketplace vyvíjí tým nopCommerce, partneři pro řešení nebo dodavatelé třetích stran. > [!NOTE] > > Pluginy označené „By nopCommerce team“ vyvíjí tým nopCommerce a jsou distribuovány zdarma. Konektory na služby třetích stran jsou vyvíjeny v rámci *programu technologického partnerství*; vztahují se na ně [prémiové služby podpory](http://www.nopcommerce.com/nopcommerce-premium-support-services) nopCommerce a jsou rovněž distribuovány zdarma. ## Instalace pluginu 1. Uživatel má dvě možnosti, jak plugin nahrát. Můžete použít kteroukoli, která vám vyhovuje: * Nahrajte plugin do složky `/plugins` v adresáři nopCommerce a restartujte aplikaci (nebo klikněte na tlačítko **Znovu načíst seznam pluginů** (Reload list of plugins)). * Nahrajte plugin nebo šablonu pomocí tlačítka **Nahrát plugin nebo šablonu** (Upload plugin or theme) a zadejte cestu k umístění archivu s pluginem ve vašem lokálním úložišti. > [!TIP] > > Další pluginy pro nopCommerce můžete stáhnout v našem [adresáři rozšíření](https://www.nopcommerce.com/marketplace). ![Nahrání pluginu](_static/plugins-in-nopcommerce/plugin-upload.png) 1. Projděte seznam pluginů a najděte nově nainstalovaný plugin. 1. Kliknutím na odkaz **Instalovat** (Install) plugin nainstalujete. 1. Instalaci dokončete kliknutím na tlačítko **Restartovat aplikaci pro uplatnění změn** (Restart application to apply changes) v horním panelu. 1. Plugin se zobrazí v seznamu pluginů (**Konfigurace → Lokální pluginy** (Configuration → Local plugins)). > [!NOTE] > > Pokud nopCommerce provozujete v režimu medium trust, doporučuje se vyčistit adresář `\Plugins\bin\`. ## Konfigurace pluginu 1. Přejděte do **Konfigurace → Lokální pluginy** (Configuration → Local plugins). Zobrazí se seznam pluginů: ![Lokální pluginy](_static/plugins-in-nopcommerce/local-plugins.png) 1. Kliknutím na odkaz **Konfigurovat** (Configure) vedle pluginu přejdete na stránku konfigurace pluginu. Pokud vedle pluginu tlačítko **Konfigurovat** není, plugin žádnou konfiguraci nevyžaduje. ## Změna popisného názvu, pořadí zobrazení a omezení pluginu 1. Přejděte do **Konfigurace → Lokální pluginy** (Configuration → Local Plugins). Zobrazí se seznam pluginů: ![Lokální pluginy](_static/plugins-in-nopcommerce/local-plugins.png) 1. Klikněte na tlačítko **Upravit** (Edit) vedle pluginu. Údaje pluginu upravte takto: ![Úprava pluginu](_static/plugins-in-nopcommerce/plugin-edit.jpg) 1. Zadejte **Popisný název** (Friendly name). 1. V poli **Pořadí zobrazení** (Display order) určete požadované umístění, na kterém se má plugin zobrazit. Hodnota 1 představuje začátek seznamu. 1. Zaškrtněte pole **Je povoleno** (Is enabled), chcete-li plugin v obchodě povolit. 1. V rozevíracím seznamu **Omezeno na role zákazníků** (Limited to customer roles) vyberte role, které mají mít možnost tento plugin používat. 1. V poli **Omezeno na obchody** (Limited to stores) určete obchody, ve kterých se bude plugin používat. 1. Klikněte na **Uložit** (Save) v horní části stránky. ## Odinstalace pluginu 1. Přejděte do **Konfigurace → Lokální pluginy** (Configuration → Local plugins). Zobrazí se seznam pluginů: ![Lokální pluginy](_static/plugins-in-nopcommerce/local-plugins.png) 1. Kliknutím na odkaz **Odinstalovat** (Uninstall) vedle pluginu jej odinstalujete. Plugin bude odinstalován. Odkaz ve **sloupci Instalace** se změní na **Instalovat**, takže plugin můžete kdykoli znovu nainstalovat. 1. Odinstalaci dokončete kliknutím na tlačítko **Restartovat aplikaci pro uplatnění změn** (Restart application to apply changes) v horním panelu. ## Návody * [Instalace pluginu (pro verze 3.90 - 4.10)](https://youtu.be/eLDsSm-4gKA) * [Správa přístupu k pluginům podle role zákazníka](https://www.youtube.com/watch?v=52lVVpQ3Qag) --- # Více obchodů nopCommerce umožňuje provozovat z jedné instalace nopCommerce více než jeden obchod s využitím jednoho rozhraní. Díky tomu můžete hostovat více veřejných obchodů na různých doménách a všechny administrativní operace spravovat z jediného administračního panelu. Data katalogu můžete sdílet mezi obchody, jeden produkt můžete mít ve více obchodech a vaši zákazníci se mohou do všech vašich obchodů přihlásit pomocí stejných přihlašovacích údajů. ## Konfigurace více obchodů ### 1. Část v ovládacím panelu hostingu V následujícím příkladu popíšeme nastavení dvou ukázkových obchodů: * `www.store1.com` * `www.store2.com` 1. Nahrajte a nainstalujte web na `www.store1.com`. Toto je jediné místo, kde jsou uloženy soubory a knihovny DLL nopCommerce. > [!NOTE] > > Více o tom, jak nainstalovat nopCommerce, se dočtete v následující kapitole: [Instalace nopCommerce](xref:cs/installation-and-upgrading/installing-nopcommerce/index). 1. V ovládacím panelu `www.store2.com` (tím se myslí ovládací panel vašeho hostingu, nikoli administrace nopCommerce) zajistěte, aby všechny požadavky na `www.store2.com` byly přesměrovány (forwardovány, nikoli redirectovány) na `www.store1.com`. Proveďte to pomocí záznamů CNAME. Tento krok je zásadní. 1. V ovládacím panelu `www.store1.com` nakonfigurujte alias domény pro `www.store2.com`. Tento krok může být pro některé uživatele komplikovaný (pokud máte potíže, požádejte o provedení tohoto kroku svého správce systému). Po dokončení výše uvedených kroků se při přístupu na `www.store2.com` z prohlížeče zobrazí obsah `www.store1.com`. Dalším krokem je konfigurace obchodů v administraci nopCommerce, která je popsána níže. Poté můžete začít nahrávat obsah pro oba obchody. 1. Volitelné (příklad): Tento krok lze provést v ovládacím panelu Plesk následovně: Kdykoli je `www.store2.com` přesměrován na `www.store1.com`, webový server Plesku neví, jak `www.store2.com` zobrazit, protože používá virtuální hosting založený na názvech (Name-Based Virtual Hosting). Proto musíte pro `www.store2.com` vytvořit alias domény, jak je popsáno níže: * Přihlaste se do panelu domény `www.store1.com` buď přímo, nebo pomocí odkazu **Open in Control Panel** z administračního panelu serveru. * Na kartě **Websites & Domains** vyberte odkaz **Add New Domain Alias** v dolní části karty. * Zadejte úplný alias. Například `store2.com`. * Ujistěte se, že je vybrána možnost **Web service**. * Služba **Mail** je volitelná. Vyberte tuto možnost, pokud chcete, aby e-maily z `www.store2.com` byly přesměrovány podobným způsobem. * Ujistěte se, že možnost **Synchronize DNS zone with the primary domain** není zaškrtnutá. ### 2. Část v administraci nopCommerce Jakmile je instalace a technické nastavení hotové, můžete své obchody spravovat z administrace nopCommerce. Přejděte do **Konfigurace → Obchody** (Configuration → Stores). Zobrazí se okno *Obchody*: ![Okno Obchody](_static/multi-store/mainstore.png) > [!NOTE] > > Ve výchozím nastavení je vytvořen pouze jeden obchod. Chcete-li nastavit více obchodů, klikněte na **Přidat nový** (Add new) a definujte následující nastavení obchodu: ![Vytvoření](_static/multi-store/create.jpg) * Definujte **Název obchodu** (Store name). * Zadejte **URL obchodu** (Store URL). * Zaškrtněte políčko **SSL povoleno** (SSL enabled), pokud je váš obchod zabezpečen pomocí SSL. SSL (Secure Sockets Layer) je standardní bezpečnostní technologie pro vytvoření šifrovaného spojení mezi webovým serverem a prohlížečem. Toto spojení zajišťuje, že všechna data předávaná mezi webovým serverem a prohlížeči zůstanou soukromá a neporušená. SSL je průmyslový standard, který používají miliony webů k ochraně online transakcí se svými zákazníky. > [!IMPORTANT] > > Tuto možnost zaškrtněte až poté, co na svém serveru nainstalujete certifikát SSL. V opačném případě se na svůj web nedostanete a budete muset ručně upravit příslušný záznam v databázi (tabulka [Store]). > > [!TIP] > > Více o nastavení SSL se dočtete v následující kapitole: [Jak nainstalovat a nakonfigurovat certifikáty SSL](xref:cs/getting-started/advanced-configuration/how-to-install-and-configure-ssl-certificates). * Pole **Hodnoty HOST** (HOST values) je seznam možných hodnot HTTP_HOST vašeho obchodu (například `store1.com`, `www.store1.com`). Vyplnění tohoto pole je nutné pouze v případě řešení s více obchody, aby bylo možné určit aktuální obchod. Toto pole umožňuje rozlišit požadavky na různé adresy URL a určuje aktuální obchod. Aktuální hodnotu HTTP_HOST můžete zjistit také v **Systém → Informace o systému** (System → System information). * V poli **Výchozí jazyk** (Default language) zvolte výchozí jazyk svého obchodu. Můžete jej také ponechat nevybraný. V takovém případě se použije první nalezený jazyk (s nejnižším pořadím zobrazení). * Definujte **Pořadí zobrazení** (Display order) tohoto obchodu. 1 představuje začátek seznamu. * Definujte **Název společnosti** (Company name). * Definujte **Adresu společnosti** (Company address). * Nastavte **Telefonní číslo společnosti** (Company phone number). * Do pole **DIČ společnosti** (Company VAT) zadejte DIČ (VAT number) vaší společnosti (používá se v EU). Další obchod přidáte kliknutím na tlačítko **Přidat nový** na stránce **Konfigurace → Obchody** a vyplněním obdobných polí. Nyní byly pomocí jediné instalace nopCommerce nakonfigurovány dva obchody: * `www.store1.com` * `www.store2.com` > [!NOTE] > > Řešení s více obchody (rozlišení obchodů podle HTTP_HOST) nefunguje pro weby ve virtuálních adresářích na stejné doméně. Nemůžete mít například jeden obchod na `http://www.site.com/store1` a druhý obchod na `http://www.site.com/store2`, protože hodnota HTTP_HOST je pro oba weby stejná (`www.site.com`). ## Konfigurace entit pro více obchodů Jakmile jsou obchody nastaveny a nakonfigurovány, můžete definovat své entity pro jednotlivé obchody. Provedete to vyplněním pole **Omezeno na obchody** (Limited to stores) na stránkách podrobností každé z následujících entit: [Produkty](xref:cs/running-your-store/catalog/products/index), [Kategorie](xref:cs/running-your-store/catalog/categories), [Výrobci](xref:cs/running-your-store/catalog/manufacturers), [Jazyky](xref:cs/getting-started/advanced-configuration/localization), [Měny](xref:cs/getting-started/configure-payments/advanced-configuration/currencies), [Šablony zpráv](xref:cs/running-your-store/content-management/message-templates), [Blogy](xref:cs/running-your-store/content-management/blog), [Novinky](xref:cs/running-your-store/content-management/news), [Stránky (topics)](xref:cs/running-your-store/content-management/topics-pages). Posuňte se dolů k poli **Omezeno na obchody** a z rozbalovací nabídky zvolte název existujícího obchodu, jak je znázorněno na obrazovce *Upravit podrobnosti produktu* níže: ![Mapování](_static/multi-store/product-limited-to-store.png) ## Konfigurace nastavení pro více obchodů Pro různé obchody lze také nakonfigurovat různá [témata](xref:cs/getting-started/design-your-store/choose-and-install-a-theme). Kromě toho můžete přepsat hodnotu libovolného nastavení pro jednotlivé obchody. Přejděte například do **Nastavení → Nastavení objednávek** (Settings → Order settings) a podívejte se na rozbalovací seznam **Konfigurace pro více obchodů pro** (Multi-store configuration for), kde můžete zvolit obchod, pro který chcete nastavení přepsat: ![Přepsání nastavení](_static/multi-store/override-settings.jpg) Po výběru obchodu se stránka obnoví a budete moci definovat libovolné pole pro zvolený obchod. Poté stačí kliknout na **Uložit** (Save) a nastavení uložit. --- # Nastavení zabezpečení Nastavení zabezpečení spravujete v **Konfigurace → Nastavení → Obecná nastavení** (Configuration → Settings → General settings). Tato stránka podporuje konfiguraci pro více obchodů; to znamená, že stejná nastavení lze definovat pro všechny obchody, nebo se mohou mezi obchody lišit. Chcete-li spravovat nastavení pro konkrétní obchod, vyberte jeho název v rozevíracím seznamu konfigurace pro více obchodů a zaškrtněte vlevo všechna potřebná políčka, abyste pro ně nastavili vlastní hodnoty. Další podrobnosti najdete v části [Více obchodů](xref:cs/getting-started/advanced-configuration/multi-store). ## Zabezpečení Nastavení *Zabezpečení* (Security) definujte takto: ![Zabezpečení](_static/security-settings/security.jpg) * Do pole **Povolené IP adresy pro administraci** (Admin area allowed IP) zadejte IP adresy, které mají přístup do administrace. Pokud nechcete přístup do administrace omezovat, ponechte pole prázdné. IP adresy oddělujte čárkami (například 127.0.0.10, 232.18.204.16). * Zaškrtnutím **Povolit honeypot** (Enable honeypot) zapnete [honeypot](https://en.wikipedia.org/wiki/Honeypot_(computing)). V počítačové terminologii je honeypot past nastražená k odhalení, odklonění nebo jinému potlačení pokusů o neoprávněné použití informačních systémů. * Do pole **Soukromý šifrovací klíč** (Encryption private key) zadejte soukromý šifrovací klíč používaný k ukládání citlivých dat. Klíč můžete kdykoli změnit kliknutím na **Změnit** (Change). Všechna citlivá data jsou šifrována tímto soukromým klíčem. > [!NOTE] > > Před změnou šifrovacího klíče se doporučuje zálohovat databázi. Mezi citlivá data patří veškeré informace o platebních kartách (pouze pokud jsou tyto informace ukládány v databázi obchodu). ## CAPTCHA CAPTCHA je program, který dokáže rozlišit, zda se na váš web pokouší dostat člověk, nebo počítač. nopCommerce používá reCAPTCHA od Googlu. reCAPTCHA je bezplatná služba, která chrání váš web před spamem a zneužitím. reCAPTCHA využívá pokročilý systém analýzy rizik a adaptivní výzvy, aby zabránila automatizovanému softwaru v nekalé činnosti na vašem webu, a přitom legitimní uživatele nechala snadno projít. Nastavení *CAPTCHA* definujte takto: ![CAPTCHA](_static/security-settings/captcha.jpg) Po zaškrtnutí **CAPTCHA povolena** (CAPTCHA enabled) se na tomto panelu zobrazí následující nastavení: * **Typ reCAPTCHA** (Type of reCAPTCHA): zvolte `reCAPTCHA v2` nebo `reCAPTCHA v3`. Rozdíl mezi nimi spočívá v tom, že reCAPTCHA v2 zobrazuje zaškrtávací políčko „Nejsem robot“, zatímco reCAPTCHA v3 je pro zákazníky neviditelná. Více o [reCAPTCHA v2](https://developers.google.com/recaptcha/docs/display) a [reCAPTCHA v3](https://developers.google.com/recaptcha/docs/v3). * **Prahová hodnota skóre reCAPTCHA v3** (reCAPTCHA v3 score threshold) je dostupná, když je vybrána reCAPTCHA v3. Přečtěte si [více o prahové hodnotě skóre](https://developers.google.com/recaptcha/docs/v3). * Zobrazit CAPTCHA na stránce **přihlášení**. * Zobrazit CAPTCHA na stránce **registrace**. * Zobrazit CAPTCHA na stránce **zapomenutého hesla**. * Zobrazit CAPTCHA na stránce **kontaktujte nás**. * Zobrazit CAPTCHA na stránce **odeslání seznamu přání příteli e-mailem**. * Zobrazit CAPTCHA na stránce **odeslání produktu příteli e-mailem**. * Zobrazit CAPTCHA na **stránce blogu (komentáře)**. * Zobrazit CAPTCHA na **stránce novinek (komentáře)**. * Zobrazit CAPTCHA v **bloku odběru novinek**. * Zobrazit CAPTCHA na stránce **recenzí produktů**. * Zobrazit CAPTCHA na stránce **žádosti o účet dodavatele**. * Zobrazit CAPTCHA na stránce **fóra**. * Zobrazit CAPTCHA na stránce **pokladny pro hosty**. * Zadejte **veřejný klíč** reCAPTCHA. * Zadejte **soukromý klíč** reCAPTCHA. > [!NOTE] > > Podpora Recaptcha v1 byla ukončena. --- # Poskytovatelé SMS Chcete-li definovat poskytovatele SMS, přejděte do **Konfigurace → Poskytovatelé SMS** (Configuration → SMS providers). ![Poskytovatelé SMS](_static/index/sms_providers.png) K odesílání oznámení lze používat pouze jednoho poskytovatele SMS. Přidávání nových poskytovatelů SMS se doporučuje pouze pokročilým uživatelům. Chcete-li vybrat výchozího poskytovatele SMS, klikněte na tlačítko **Označit jako primárního poskytovatele** (Mark as primary provider). ## Povolení přihlášení pomocí telefonního čísla 1. Přejděte do **Konfigurace → Nastavení → Nastavení zákazníků** (Configuration → Settings → Customer settings), sekce [Heslo a zabezpečení](xref:cs/running-your-store/customer-management/customer-settings). 2. Zaškrtněte políčko **Povoleno přihlášení telefonem** ('Login by phone' enabled) (další možnost vedle přihlášení e-mailovou adresou). 3. Ujistěte se, že je na panelu *Pole formuláře zákazníka* (Customer form fields) zaškrtnuta možnost **Povoleno „Telefonní číslo“** ('Phone number' enabled), jinak zákazníci nebudou moci zadat číslo, na které se má kód odeslat. 4. Uložte nastavení. ## Jak to funguje 1. Zákazník zadá na přihlašovací stránce veřejné části obchodu své telefonní číslo. 2. Obchod požádá primárního poskytovatele SMS (v tomto případě Twilio) o odeslání ověřovacího kódu na toto číslo. 3. Zákazník zadá přijatý kód a obchod jej před přihlášením zákazníka ověří. > [!TIP] > > Ve výchozím nastavení je v nopCommerce k dispozici několik poskytovatelů SMS, další poskytovatele SMS však najdete na [marketplace](https://www.nopcommerce.com/marketplace) nopCommerce. Konfigurace poskytovatelů SMS je popsána v následujících kapitolách: * [Poskytovatel SMS Twilio](xref:cs/getting-started/advanced-configuration/sms-providers/twilio) --- # Poskytovatel SMS Twilio [Twilio](https://www.twilio.com/) je cloudová komunikační platforma s programovatelným odesíláním SMS. nopCommerce podporuje Twilio přímo bez dalších úprav, takže není potřeba žádný plugin třetí strany. V nopCommerce se poskytovatel SMS používá k odeslání **jednorázového ověřovacího kódu (OTP)**, když se zákazník přihlašuje do obchodu pomocí telefonního čísla. Tato možnost je doplňková: zákazníci se mohou i nadále přihlašovat pomocí e-mailové adresy nebo uživatelského jména. ## Účet Twilio Poskytovatel funguje přes Twilio REST API, proto je vyžadován účet Twilio: 1. Zaregistrujte si účet Twilio a dokončete ověření v [konzoli Twilio](https://console.twilio.com/). 2. Pořiďte si telefonní číslo, které podporuje SMS. Na stránce **Account Dashboard** klikněte na **Get a phone number** nebo přejděte do **Phone Numbers → Manage → Buy a number** a ujistěte se, že má číslo povolenou funkci **SMS**. 3. Zkopírujte přihlašovací údaje účtu ze stránky **Account Dashboard**: * **Account SID** — 34znakový identifikátor začínající na „AC“. Slouží jako přihlašovací jméno a identifikuje účet (nebo podúčet), ze kterého se zprávy odesílají. * **Auth token** — klíč používaný k autorizaci požadavků API. > [!IMPORTANT] > > Odesílání SMS vyžaduje kladný zůstatek na účtu Twilio. Zprávy se účtují po segmentech a sazby závisí na cílové zemi. > > [!NOTE] > > Některé země a sítě vyžadují před doručením obchodních zpráv další postupy (registraci odesílatele, schválení krátkého kódu atd.). Splňte všechny příslušné požadavky na ověření nebo registraci pro země, ve kterých se nacházejí vaši zákazníci. ## Konfigurace poskytovatele 1. Přejděte do **Konfigurace → Poskytovatelé SMS** (Configuration → SMS providers). 2. V seznamu najděte položku **Twilio SMS provider** a kliknutím na **Označit jako primárního poskytovatele** (Mark as primary provider) nastavte, aby jej nopCommerce používal k odesílání SMS. Současně lze používat pouze jednoho poskytovatele. > [!NOTE] > > Pokud byl dříve používán jiný poskytovatel, jeho primární stav se automaticky odebere. 3. Klikněte na **Konfigurovat** (Configure) vedle možnosti Twilio SMS provider v seznamu a otevře se stránka s přihlašovacími údaji. ![SMS Twilio](_static/twilio/configure.png) 4. Vyplňte následující pole: * **Informace o zůstatku** (Balance info): aktuální zůstatek vašeho účtu Twilio. Toto pole je pouze pro čtení a zobrazí se po nakonfigurování poskytovatele. Kliknutím na **Zkontrolovat zůstatek účtu** (Check the account balance) hodnotu aktualizujete. * **Account SID**: **Account SID** zkopírovaný ze stránky **Account Dashboard** v konzoli Twilio. * **Auth token**: **Auth token** zkopírovaný z podokna **Account Info** na stránce **Console Dashboard**. Zacházejte s ním jako s heslem: poskytuje úplný přístup k účtu. * **Telefonní číslo** (Phone number): telefonní číslo účtu Twilio, ze kterého se ověřovací kódy odesílají. Zadejte číslo v mezinárodním formátu, například `+12345678900`. 5. Klikněte na **Uložit** (Save). > [!TIP] > > Twilio filtruje zprávy podle účtu, takže odesílání můžete otestovat bez použití skutečného mobilního čísla: odešlete zprávu na číslo Twilio **Virtual Phone** `+18777804236` a zkontrolujte zprávu v rozhraní Virtual Phone. Upozorňujeme, že se tam zobrazují pouze zprávy odeslané z vašeho účtu. ## Řešení problémů Pokud zákazníci ověřovací kód neobdrží, zkontrolujte následující: * Hodnoty **Account SID**, **Auth token** a **Telefonní číslo** jsou zkopírovány správně a neobsahují nadbytečné mezery. * Pole **Informace o zůstatku** ukazuje kladný zůstatek, protože při vyčerpaném účtu se ověřovací kódy neodesílají. * Číslo odesílatele podporuje SMS a požadavky na ověření nebo registraci pro cílovou zemi jsou splněny. * Číslo příjemce je zadáno v mezinárodním formátu, například `+12345678900`. * Podrobnosti o neúspěšných požadavcích a konečný stav doručení jsou k dispozici v konzoli Twilio (**Message → Logs**). > [!NOTE] > > Úspěšná odpověď z Twilio API znamená, že zpráva byla přijata k odeslání, nikoli že byla doručena. Konečný stav vždy ověřte v protokolu zpráv v konzoli Twilio. --- # Nakupování v ChatGPT ChatGPT Shopping zpřístupňuje vaše produkty k vyhledání v ChatGPT. Integrace je implementována jako plugin *ChatGPT Shopping* (systémový název *Feed.ChatGptShopping*) a je k dispozici v nopCommerce 5.00. Plugin generuje strukturovaný produktový feed, který odpovídá specifikaci produktového feedu OpenAI, takže ChatGPT přesně indexuje a zobrazuje vaše produkty s aktuálními cenami a dostupností. Vaše produkty se budou zobrazovat ve výsledcích založených na AI, když nakupující aktivně zkoumají možnosti, porovnávají produkty a rozhodují se, co koupit. Funkce funguje podobně jako Google Shopping. ## Jak to funguje - Plugin generuje produktový feed ve formátu JSONL (jeden produkt na řádek). Soubor je komprimován pomocí gzip a kódován v UTF-8. - Soubor feedu se generuje pro každý obchod a ukládá se na statické veřejné URL, aby jej bylo možné sdílet se službou ChatGPT Shopping. - OpenAI pravidelně stahuje feed z nakonfigurované URL, čímž udržuje produktová data v ChatGPT aktuální. - Feed slouží pouze k vyhledávání produktů: produkty jsou označeny jako způsobilé pro vyhledávání a reklamy, ale ne pro pokladnu, takže nakupující dokončují nákupy ve vašem obchodě. ## Instalace pluginu 1. Přejděte do **Konfigurace → Lokální pluginy** (Configuration → Local plugins). 1. Vyhledejte *ChatGPT Shopping* v poli **Název pluginu** (Plugin name). Plugin patří do skupiny *Propagační feedy* (Promotion feeds). 1. Klikněte na tlačítko **Instalovat** (Install). 1. Kliknutím na tlačítko **Restartovat aplikaci pro použití změn** (Restart application to apply changes) změny použijte. > [!NOTE] > > Při instalaci plugin povolí nastavení médií **Použít absolutní cestu k obrázkům** (Use absolute image path) (vyžadováno pro absolutní URL obrázků produktů) a přidá plánovanou úlohu *Synchronization (ChatGPT Shopping)*, která je ve výchozím stavu vypnutá. ## Konfigurace pluginu Chcete-li plugin nakonfigurovat, přejděte do **Konfigurace → Lokální pluginy** (Configuration → Local plugins) a klikněte na **Konfigurovat** (Configure) vedle *ChatGPT Shopping*. ![ChatGPT shopping](_static/chatgpt-shopping/configure.png) Tato stránka umožňuje konfiguraci pro více obchodů; to znamená, že stejná nastavení lze definovat pro všechny obchody, nebo se mohou mezi obchody lišit. Pokud chcete spravovat nastavení pro určitý obchod, zvolte jeho název z rozevíracího seznamu konfigurace více obchodů a zaškrtněte vlevo všechna potřebná políčka, abyste pro ně nastavili vlastní hodnoty. Další podrobnosti naleznete v sekci [Více obchodů](xref:cs/getting-started/advanced-configuration/multi-store). Definujte následující nastavení: - **Měna** (Currency) — měna použitá ke generování feedu. Ceny produktů se převádějí do této měny. - **Jazyk** (Language) — jazyk použitý ke generování feedu. Používají se lokalizované názvy a popisy produktů. - **Cílové země** (Target countries) — cílové země, pro které se feed generuje. Použijte kódy zemí ISO 3166-1 alpha-2 oddělené čárkami (např. US,CA,GB). Vynechaná nebo prázdná hodnota neznamená celý svět. - **Země obchodu** (Store country) — země obchodu. Použijte kód země ISO 3166-1 alpha-2 (např. US). Vynechaná nebo prázdná hodnota nevybírá jiný trh. - **Povolit automatickou synchronizaci** (Enable auto synchronization) — povolí nebo zakáže automatickou synchronizaci feedu. Je-li povolena, feed se automaticky synchronizuje v zadaném intervalu. - **Interval automatické synchronizace** (Auto synchronization period) — interval (v minutách) pro automatickou synchronizaci. Je-li automatická synchronizace povolena, musí být větší než 0. - **Velikost náhledového obrázku produktu** (Product thumbnail image size) — výchozí velikost (v pixelech) náhledových obrázků produktů ve feedu. - **Cesta k vygenerovanému souboru (statická)** (Generated file path (static)) — veřejná URL vygenerovaného souboru feedu. Cesta je pro váš obchod statická a lze ji sdílet se službou ChatGPT Shopping. Kliknutím na **Uložit** (Save) uložíte změny. Pomocí **Generovat feed** (Generate feed) feed vygenerujete ručně. ## Generování feedu Kliknutím na tlačítko **Generovat feed** (Generate feed) vygenerujete feed pro aktuální rozsah obchodu. Pokud není vybrán konkrétní rozsah obchodu, feed se vygeneruje pro všechny obchody. Feed obsahuje produkty, které jsou publikované, nesmazané a viditelné jednotlivě. Zohledňuje se mapování na obchody a seznamy řízení přístupu (ACL). Soubor feedu se ukládá do `files/exportimport/{store ID}-chatgptshopping_products.jsonl.gz`. Veřejná URL každého vygenerovaného souboru se zobrazuje v poli **Cesta k vygenerovanému souboru (statická)** (Generated file path (static)). Každá položka feedu obsahuje následující produktová data: - **item_id** — SKU produktu, jedinečné pro každý produkt. Je-li zadáno, odesílá se také GTIN a číslo dílu výrobce (MPN). - **title** — název produktu (až 150 znaků). - **description** — úplný popis produktu převedený na prostý text (až 5 000 znaků). Pokud je úplný popis prázdný, použije se krátký popis. - **url** — URL stránky s detaily produktu. - **brand** — název výrobce. - **product_category** — drobečková navigace kategorie (např. Apparel & Accessories > Shoes). - **condition** — stav produktu (ve výchozím nastavení `new`). - **image_url** a **additional_image_urls** — hlavní obrázek produktu a další obrázky (celkem až 10 obrázků), zmenšené na nakonfigurovanou velikost náhledu. - **video_url** — URL videa produktu. - **price** — cena produktu bez slev ve formátu `amount CURRENCY` (např. `79.99 USD`), převedená do zvolené měny. - **availability** — stav skladu: `in_stock`, `out_of_stock` nebo `pre_order`. Produkty na předobjednávku obsahují také `availability_date`. - **seller_name** a **seller_url** — název a URL vašeho obchodu. - **review_count** a **star_rating** — počet schválených recenzí produktu a průměrné hodnocení produktu. - **target_countries** a **store_country** — geografické údaje definované v nastavení pluginu. ## Automatická synchronizace Aby byl feed stále aktuální, plugin přidává plánovanou úlohu *Synchronization (ChatGPT Shopping)*. Ve výchozím stavu je úloha vypnutá a po povolení se spouští každých 8 hodin (480 minut). Úlohu můžete povolit a interval synchronizace určit v konfiguraci pluginu. Úlohu lze spravovat také v **Systém → Plánované úlohy** (System → Schedule tasks). Další podrobnosti naleznete v sekci [Plánované úlohy](xref:cs/running-your-store/system-administration/schedule-tasks). > [!NOTE] > > Po změně nastavení automatické synchronizace nezapomeňte restartovat aplikaci. ## Připojení feedu k ChatGPT Chcete-li své produkty zpřístupnit v ChatGPT Shopping, proveďte následující kroky: 1. Vygenerujte produktový feed. 1. Ověřte, že je feed veřejně přístupný. 1. Přihlaste se do [ChatGPT Merchant Portal](https://chatgpt.com/merchants/). 1. Zaregistrujte svůj obchod (pokud jste tak ještě neučinili). 1. Přidejte nový produktový feed a zadejte veřejnou URL vygenerovaného feedu JSONL. 1. Dokončete proces ověření a odešlete feed ke zpracování. 1. Feed znovu vygenerujte pokaždé, když se váš katalog změní. OpenAI bude pravidelně stahovat nejnovější verzi z nakonfigurované URL. Další informace naleznete v oficiální dokumentaci OpenAI: - [Power product discovery in ChatGPT](https://chatgpt.com/merchants/) - [Provide a structured product feed as file upload to an SFTP server](https://developers.openai.com/commerce/specs/file-upload/overview) - [Product feed specification](https://developers.openai.com/commerce/specs/file-upload/products). --- # Google AI Commerce Search Google AI Commerce Search je služba Google pro vyhledávání produktů poháněná umělou inteligencí. Rozumí tomu, co nakupující skutečně hledá, a vrací nejrelevantnější produkty z vašeho katalogu, což zlepšuje relevanci vyhledávání a v důsledku toho i konverze a průměrnou hodnotu objednávky. V nopCommerce je integrace implementována jako plugin *Google AI Commerce Search* (systémový název *AIRecommendation.GoogleAI*), který je k dispozici od nopCommerce 5.00. Plugin patří do skupiny *Doporučování pomocí AI* (AI-powered recommendation). ## Jak to funguje - Plugin importuje váš katalog produktů do katalogu Google Cloud (projekt → umístění → katalog → větev) prostřednictvím Retail API. - Po importu dat Google katalog sestaví a zaindexuje a vyhledávač vrací ID produktů seřazená podle relevance pro zadaná klíčová slova. - Změny produktů provedené v nopCommerce se do Google odesílají okamžitě, takže index zůstává aktuální bez nutnosti ručních opakovaných importů. - Výsledky vyhledávání vrácené službou Google se mapují zpět na produkty nopCommerce. nopCommerce znovu uplatní svá vlastní omezení (publikované produkty, data dostupnosti, mapování na obchody, seznamy řízení přístupu, cenové rozpětí) a zobrazí produkty v pořadí vráceném službou Google, takže nakupující vidí řazení Google nad standardním vyhledáváním nopCommerce. - Kategorie, výrobci, štítky produktů a filtry atributů specifikace vybrané nakupujícím se předávají službě Google jako filtry vyhledávání, takže filtrování provádí přímo vyhledávač. - Google používá ID návštěvníka k personalizaci a přeřazení výsledků. Plugin předává jako ID návštěvníka hodnotu cookie `_ga` (Google Analytics), proto je vyžadován plugin [Google Analytics](xref:cs/getting-started/advanced-configuration/configure-analytics). > [!NOTE] > > Poskytovatel doporučování pomocí AI se používá pouze pro vyhledávání produktů podle klíčových slov, tj. pro rozbalovací seznam automatického doplňování ve vyhledávacím poli a pro stránku výsledků vyhledávání. Ostatní seznamy produktů nejsou ovlivněny. ## Předpoklady Před instalací pluginu připravte integraci na straně Google Cloud: 1. Povolte pro svůj projekt Google Cloud Retail API. 1. Vytvořte katalog s výchozí větví (plugin pracuje s jedním katalogem a jednou větví). 1. Vytvořte servisní účet a udělte mu roli potřebnou pro práci s Retail API (pro úplnou synchronizaci stačí *Retail Editor*; *Retail Viewer* lze použít, pokud katalog importuje jiný nástroj, např. BigQuery). 1. Vytvořte pro servisní účet klíč JSON a stáhněte jej. ### Autorizace nopCommerce Autorizaci zajišťuje [Identity and Access Management (IAM)](https://docs.cloud.google.com/iam/docs/overview) a plugin podporuje [Application Default Credentials (ADC)](https://docs.cloud.google.com/docs/authentication/application-default-credentials), díky čemuž může stejný kód běžet ve vývojovém i produkčním prostředí. Nejspolehlivějším způsobem, jak pro tuto integraci nakonfigurovat ADC, je použít klíč servisního účtu. Zkopírujte stažený soubor klíče JSON na svůj server (například do adresáře `/etc/gcloud/`) a nastavte na něj proměnnou prostředí `GOOGLE_APPLICATION_CREDENTIALS`: - Linux (terminál nebo spouštěcí skript `.bashrc`): ```sh export GOOGLE_APPLICATION_CREDENTIALS="/etc/gcloud/your-service-account-key.json" ``` - Windows (PowerShell, rozsah počítače): ```powershell [System.Environment]::SetEnvironmentVariable('GOOGLE_APPLICATION_CREDENTIALS', 'C:\gcloud\your-service-account-key.json', 'Machine') ``` - Docker (předejte proměnnou a připojte soubor klíče): ```sh docker run -e GOOGLE_APPLICATION_CREDENTIALS=/app/key.json -v /etc/gcloud/your-service-account-key.json:/app/key.json my-retail-app ``` Poté aplikaci restartujte, aby se nová proměnná prostředí načetla. ## Instalace pluginu 1. Přejděte do **Konfigurace → Místní pluginy** (Configuration → Local plugins). 1. V poli **Název pluginu** (Plugin name) vyhledejte *Google AI Commerce Search*. Plugin patří do skupiny *Doporučování pomocí AI* a vyžaduje plugin *Google Analytics*. 1. Klikněte na tlačítko **Instalovat** (Install). 1. Kliknutím na tlačítko **Restartovat aplikaci pro použití změn** (Restart application to apply changes) změny použijete. 1. Na stránce podrobností pluginu zaškrtněte políčko **Povoleno** (Enabled), aby se plugin stal aktivním poskytovatelem doporučování pomocí AI. Aktivní může být vždy pouze jeden poskytovatel doporučování pomocí AI. > [!NOTE] > > Při instalaci plugin povolí nastavení médií **Použít absolutní cestu k obrázkům** (Use absolute image path), které je nutné pro předávání absolutních URL obrázků produktů službě Google, a vyplní výchozí hodnoty konfigurace: umístění *global*, katalog *default_catalog* a větev *default_branch*. ## Konfigurace pluginu Chcete-li plugin nakonfigurovat, přejděte do **Konfigurace → Místní pluginy** a klikněte na **Konfigurovat** (Configure) vedle *Google AI Commerce Search*. ![Google AI Commerce Search](_static/google-ai-commerce-search/configure.png) Konfigurační stránka popisuje, jak funguje autorizace Google Cloud, a poskytuje následující nastavení: - **Enabled** (Povoleno) — zapnutí nebo vypnutí pluginu. Je-li vypnut, plugin nesynchronizuje data se službou Google ani nevrací výsledky vyhledávání. - **Project ID** — ID projektu Google Cloud, kterému katalog patří. - **Location ID** — ID umístění (regionu) katalogu v Google Cloud, například `global`. - **Catalog ID** — ID katalogu v Google Cloud. - **Branch ID** — ID větve v Google Cloud, do které se odesílají data produktů. - **Sync Allowed** (Synchronizace povolena) — zapnutí nebo vypnutí synchronizace dat produktů se službou Google. Vypněte ji, pokud váš katalog importuje jiný nástroj (například BigQuery) nebo pokud chcete Google používat pouze pro vyhledávání. - **Search Allowed** (Vyhledávání povoleno) — zapnutí nebo vypnutí vyhledávání produktů prostřednictvím Google. - **Log Requests** (Protokolovat požadavky) — zapnutí nebo vypnutí protokolování požadavků odesílaných službě Google. Užitečné pro ladění a testování; požadavky se zapisují do souboru protokolu nopCommerce. Všechny čtyři identifikátory (projekt, umístění, katalog a větev) jsou povinné a musí odpovídat hodnotám v konzoli Google Cloud. Kliknutím na **Uložit** (Save) uložíte změny. ## Import katalogu Chcete-li do Google importovat celý katalog, klikněte na tlačítko **Synchronizovat katalog nyní** (Sync catalog now). Ke spuštění této akce musíte povolit nastavení **Sync Allowed** a mít udělené oprávnění *Upravovat produkty* (Edit products). Plugin produkty převede a importuje je v dávkách (500 produktů na požadavek), poté zobrazí oznámení s počtem úspěšně importovaných produktů a počtem selhání. Výsledek importu se také zapisuje do protokolu nopCommerce. Importují se pouze publikované produkty a zohledňuje se mapování na obchody a seznamy řízení přístupu. Každý produkt se odesílá s následujícími daty: - **ID** — SKU produktu, nebo ID produktu, pokud je SKU prázdné. - **Type** (Typ) — *Primary* pro běžné produkty a *Variant* pro kombinace atributů produktu a varianty seskupených produktů. - **Primary product ID** (ID primárního produktu) — SKU (nebo ID) nadřazeného produktu u variant. - **Name** (Název), **GTIN**, **URL**, **kód jazyka** — použije se kód jazyka výchozího jazyka administrace. - **Title** (Titulek) — krátký popis produktu (až 1 000 znaků). - **Description** (Popis) — úplný popis produktu (až 5 000 znaků). - **Price** (Cena) — cena produktu (u varianty přepsaná cena) v primární měně obchodu. - **Availability** (Dostupnost) — `IN_STOCK`, `OUT_OF_STOCK` nebo `BACKORDER`, vypočteno v závislosti na způsobu správy zásob a skladovém množství. - **Rating** (Hodnocení) — průměrné hodnocení a počet schválených recenzí produktu. - **Categories** (Kategorie) — úplná cesta kategorie (např. `Sports & Fitness > Athletic Clothing > Shoes`). Úplné cesty Google důrazně doporučuje pro lepší kvalitu vyhledávání a doporučení. - **Brands** (Značky) — názvy výrobců. - **Attributes** (Atributy) — atributy specifikace a názvy jejich možností. - **Tags** (Štítky) — štítky produktu. - **Images** (Obrázky) — obrázek produktu; u variant se použije první obrázek kombinace. ## Synchronizace změn produktů Když jsou povolena obě nastavení **Enabled** i **Sync Allowed** a plugin je aktivním poskytovatelem doporučování pomocí AI, plugin automaticky udržuje Google aktuální: - vytvořený produkt nebo kombinace atributů produktu se odešle do Google; - aktualizovaný produkt nebo kombinace atributů produktu se aktualizuje v Google; - odstraněný produkt nebo kombinace atributů produktu se z Google odebere. Pokud jsou tato nastavení vypnuta nebo je aktivní jiný poskytovatel doporučování pomocí AI, neodesílají se žádné požadavky a můžete se místo toho spolehnout na úplný import katalogu. ## Vyhledávání ve veřejném obchodě Když jsou povolena obě nastavení **Enabled** i **Search Allowed**, vyhledávání produktů podle klíčových slov ve veřejném obchodě obsluhuje Google: - Klíčová slova zadaná nakupujícím se odesílají do umístění `default_search` nakonfigurovaného katalogu a větve. - Filtry kategorií, výrobců, štítků produktů a atributů specifikace se převádějí do syntaxe filtrů Retail API. - ID návštěvníka se přebírá z cookie `_ga`, takže výsledky mohou být personalizovány. Ujistěte se, že plugin Google Analytics je nainstalován a nakonfigurován a že jeho cookie není pro váš obchod blokována. - Velikost stránky vyhledávání je omezena na 120 produktů na požadavek (maximum povolené Retail API). - Vrácená ID produktů nebo SKU se mapují zpět na produkty nopCommerce; duplicitní položky (například několik variant téhož produktu) se sloučí do jediného produktu. - Pokud Google pro zadaná klíčová slova nevrátí žádné produkty nebo požadavek selže, nopCommerce se vrátí ke standardnímu vyhledávání produktů, takže nakupující přesto dostanou výsledky. > [!IMPORTANT] > > Google vrací výsledky pouze pro produkty, které již byly importovány do katalogu a zaindexovány. Po úvodní konfiguraci spusťte **Synchronizovat katalog nyní** a udržujte katalog synchronizovaný, jinak nakupující nemusí dostávat žádné výsledky poháněné AI. ## Řešení problémů - **Žádné výsledky vyhledávání** — ujistěte se, že katalog byl importován, nastavení **Enabled** a **Search Allowed** jsou povolena a plugin je aktivním poskytovatelem doporučování pomocí AI. Mějte na paměti, že když Google nic nevrátí, nopCommerce se vrátí ke standardnímu vyhledávání. - **Chyby ověřování** — ověřte, že proměnná prostředí `GOOGLE_APPLICATION_CREDENTIALS` je nastavena pro účet, pod kterým aplikace běží, že soubor klíče je čitelný a že aplikace byla po změně proměnné restartována. - **Chyby odepření oprávnění** — ujistěte se, že servisní účet má požadovanou roli Retail API a že je pro projekt povoleno Retail API. - **Prázdné nebo nerelevantní výsledky** — zlepšete zdrojová data: na řazení mají vliv úplné cesty kategorií, štítky produktů, atributy specifikace, obrázky, ceny i dostupnost. - **Ladění** — povolte nastavení **Log Requests** a v protokolu nopCommerce zkontrolujte požadavky odeslané službě Google. ## Další informace - [Přehled AI Commerce Search](https://cloud.google.com/retail/docs) - [Jak to funguje](https://cloud.google.com/retail/docs/how-it-works) - [Import produktů](https://cloud.google.com/retail/docs/import/products) - [Filtrování a řazení výsledků](https://cloud.google.com/retail/docs/filter-and-order) - [Reference Search API](https://cloud.google.com/retail/docs/reference/rpc/google.cloud.retail.v2#google.cloud.retail.v2.SearchRequest) - [Řízení přístupu pro Retail API](https://cloud.google.com/retail/docs/access-control) --- # PunchOut PunchOut je nákupní protokol, který bezproblémově propojuje váš obchod s podnikovými nákupními (procurement) systémy odběratelů, jako jsou SAP Ariba, Coupa, Oracle eProcurement a další. Umožňuje nákupčím přistupovat k vašemu obchodu přímo z jejich nákupního systému, procházet katalog a přidávat produkty do nákupního košíku, aniž by opustili svůj nákupní proces. Obsah košíku se poté přenese zpět do nákupního systému jako požadavek na nákup (requisition). V nopCommerce je integrace implementována jako plugin *PunchOut cXML Integration* (systémový název *Misc.PunchOut*) a je k dispozici od nopCommerce 5.00. Plugin patří do skupiny *Misc* a implementuje protokol PunchOut pomocí cXML (verze 1.2.014). ## Jak to funguje 1. Nákupní systém odešle do vašeho obchodu `PunchOutSetupRequest` (dokument cXML). 1. nopCommerce požadavek ověří, vytvoří relaci PunchOut a vrátí `PunchOutSetupResponse` obsahující URL úvodní stránky (Start Page URL). 1. Uživatel je z nákupního systému přesměrován do veřejné části obchodu nopCommerce a je automaticky přihlášen. 1. Uživatel prochází katalog a přidává produkty do nákupního košíku jako obvykle. 1. Během aktivní relace PunchOut je standardní tlačítko **Pokladna** (Checkout) nahrazeno tlačítkem **Odeslat ke schválení** (Submit for Approval). 1. Po kliknutí na **Odeslat ke schválení** nopCommerce z aktuálního nákupního košíku vygeneruje `PunchOutOrderMessage` (cXML). 1. Prohlížeč automaticky odešle `PunchOutOrderMessage` zpět do nákupního systému pomocí URL *BrowserFormPost* uvedené v původním požadavku na nastavení. 1. Nákupní systém na základě přijatých dat košíku vytvoří nebo aktualizuje požadavek na nákup. 1. V nopCommerce se nevytvoří žádná objednávka a zpracování platby se přeskočí. 1. Relace PunchOut se dokončí a uživatel se vrátí do nákupního systému. > [!NOTE] > > - Relace PunchOut se ukládají do databáze a automaticky vyprší. > - Všechny příchozí a odchozí dokumenty cXML se zaznamenávají do protokolu pro účely auditu a řešení problémů. > - Pomocí samostatných přihlašovacích údajů klientů PunchOut lze nakonfigurovat více nákupních systémů. > - U aktivních relací PunchOut se standardní proces pokladny nopCommerce obchází. ## Instalace pluginu 1. Přejděte do **Konfigurace → Lokální pluginy** (Configuration → Local plugins). 1. Vyhledejte *PunchOut cXML Integration* v poli **Název pluginu** (Plugin name). Plugin patří do skupiny *Misc*. 1. Klikněte na tlačítko **Instalovat** (Install). 1. Kliknutím na tlačítko **Restartovat aplikaci pro uplatnění změn** (Restart application to apply changes) změny uplatníte. ## Konfigurace pluginu Plugin nakonfigurujete v **Konfigurace → Lokální pluginy** (Configuration → Local plugins) kliknutím na **Konfigurovat** (Configure) vedle *PunchOut cXML Integration*. Stránka konfigurace obsahuje následující sekce: - **Obecná nastavení** (Common settings) — obecná nastavení pluginu. - **Identita** (Identity) — přihlašovací údaje klientů PunchOut, kteří se smějí připojit k vašemu obchodu. - **Relace** (Session) — aktivní a dokončené relace PunchOut. - **Protokol** (Log) — příchozí a odchozí dokumenty cXML. Definujte následující obecná nastavení: ![PunchOut](_static/punchout/configure_common.png) - **Je aktivní** (Is active) — zapnutí nebo vypnutí pluginu. Plugin je ve výchozím stavu vypnutý; když je vypnutý, nopCommerce odpovídá na příchozí požadavky na nastavení chybou *Service Unavailable*. - **Doba do vypršení** (Time to expire) — doba v hodinách, po které relace PunchOut vyprší (ve výchozím stavu 24 hodin). - **Kód měrné jednotky** (Unit of measure code) - kód měrné jednotky pro relaci PunchOut. - **Omezené role zákazníků** (Restricted customer roles) — vyberte role zákazníků, které nebudou mít přístup k funkci PunchOut. Pokud není vybrána žádná role, budou mít přístup všichni zákazníci. Ve výchozím stavu je omezena role *Administrátoři*. Kliknutím na **Uložit** (Save) změny uložíte. ## Konfigurace identit Nákupní systém se ověřuje pomocí přihlašovacích údajů *Identity* a *Shared secret* odeslaných v elementu `Sender` požadavku na nastavení. nopCommerce přihlašovací údaje ověří a požadavky s neplatným sdíleným tajemstvím odmítne. V sekci **Identita** (Identity) spravujte odesílatele, kteří se smějí připojit k vašemu obchodu: ![PunchOut](_static/punchout/configure_identity.png) - Pomocí vyhledávacího pole můžete filtrovat identity podle hodnoty identity. - Tabulka obsahuje sloupce **Identita** (Identity) a **Hash sdíleného tajemství** (Shared secret hash). Obě hodnoty lze upravovat přímo v řádku. Když změníte hodnotu ve sloupci „Hash sdíleného tajemství“, ve skutečnosti zadáváte nový tajný klíč, který se poté zahashuje. - K správě identit použijte tlačítka **Upravit** (Edit) a **Smazat** (Delete). - V bloku *Přidat nový záznam* (Add new record) zadejte **Identitu** (Identity) a **Sdílené tajemství** (Shared secret) nákupního systému a klikněte na tlačítko **Přidat nový záznam** (Add new record). > [!IMPORTANT] > > Sdílené tajemství se ukládá jako hash SHA-256. Identitu a sdílené tajemství předejte administrátorovi nákupního systému, aby bylo možné stejné přihlašovací údaje nakonfigurovat na straně nákupního systému. > ![PunchOut](_static/punchout/punchout_shared_secret_authentication_flow.png) ## Relace PunchOut ve veřejné části obchodu Když nákupčí přejde na URL úvodní stránky, nopCommerce aktivuje relaci a nákupčího automaticky přihlásí. Pokud zákazník s kontaktním e-mailem z požadavku na nastavení neexistuje, vytvoří se nový zákazník a přiřadí se k roli zákazníka *Registrovaní*. Adresa *ShipTo* z požadavku na nastavení se uloží jako doručovací adresa zákazníka. Během aktivní relace PunchOut: - Nákupčí může procházet pouze domovskou stránku, katalog, stránky produktů a nákupní košík; přechod na jakoukoli jinou stránku je přesměrován na domovskou stránku. - Standardní tlačítko **Pokladna** (Checkout) je nahrazeno tlačítkem **Odeslat ke schválení** (Submit for Approval) a slevy na položky jsou na stránce košíku skryté. - Pokladna, kontaktní formuláře, recenze produktů a stránky zákaznického účtu (informace o účtu, registrace, obnovení hesla, adresy, produkty ke stažení, avatar, nástroje GDPR, zůstatek dárkového poukazu, vícefaktorové ověřování) nejsou k dispozici. - Recenze produktů jsou na stránkách detailu produktu vypnuté. Pokud relace vyprší, data relace se vymažou a nákupčí je přesměrován na domovskou stránku s upozorněním *Your PunchOut session has expired*. ## Správa relací Sekce **Relace** (Session) obsahuje seznam relací PunchOut s ID relace, cookie nákupčího, stavem aktivity, e-mailem zákazníka (s odkazem na stránku úpravy zákazníka), obchodem a datem vytvoření. Relaci můžete ručně ukončit tlačítkem **Ukončit relaci** (Close Session). ![PunchOut](_static/punchout/configure_session.png) ## Zobrazení protokolu Sekce **Protokol** (Log) obsahuje seznam všech příchozích a odchozích dokumentů cXML. Každý záznam obsahuje ID relace, typ zprávy (*SetupRequest*, *SetupResponse* nebo *OrderMessage*) a datum vytvoření. Protokol můžete filtrovat podle data vytvoření. ![PunchOut](_static/punchout/configure_log.png) Kliknutím na tlačítko **Zobrazit** (View) zobrazíte podrobnosti záznamu: ID relace, typ zprávy, směr (*Inbound* — z nákupního systému do nopCommerce, nebo *Outbound* — z nopCommerce do nákupního systému), nezpracované XML, URL, identitu, chybovou zprávu (pokud existuje) a datum vytvoření. Jednotlivé záznamy můžete smazat na stránce záznamu protokolu, nebo celý protokol vymazat tlačítkem **Vymazat protokol** (Clear log). ## Zprávy cXML Plugin implementuje následující zprávy cXML (verze 1.2.014): - **PunchOutSetupRequest** — odesílá ji nákupní systém na `POST /punchout/setup`. nopCommerce z ní načte přihlašovací údaje odesílatele, cookie nákupčího, URL *BrowserFormPost*, kontaktní e-mail a adresu *ShipTo*. - **PunchOutSetupResponse** — vrací ji nopCommerce. Obsahuje URL úvodní stránky (`/punchout/start?sessionId=...`), která nákupčího přesměruje do veřejné části obchodu. - **PunchOutOrderMessage** — generuje se z aktuálního nákupního košíku a odesílá se na URL *BrowserFormPost*. Obsahuje cookie nákupčího, celkovou částku košíku a položky košíku s SKU produktu (`SupplierPartID`), popisem (název produktu a hodnoty atributů), množstvím, jednotkovou cenou a měnou. Chybové odpovědi používají standardní element cXML `Response/Status` s příslušným stavovým kódem: `401` pro neplatné sdílené tajemství, `400` pro chybně formátovaný požadavek a `503`, když je plugin vypnutý. ## Další informace - [Getting Started with cXML (PDF)](https://xml.cxml.org/current/cXMLGettingStarted.pdf) - [cXML Reference Guide (PDF)](https://xml.cxml.org/current/cXMLReferenceGuide.pdf) - [cXML 1.2.014 DTD](http://xml.cxml.org/schemas/cXML/1.2.014/cXML.dtd) --- # Nastavení robots.txt Chcete-li spravovat nastavení *robots.txt*, přejděte do **Konfigurace → Nastavení → Obecná nastavení** (Configuration → Settings → General settings). Tato stránka umožňuje konfiguraci pro více obchodů; to znamená, že stejná nastavení lze definovat pro všechny obchody, nebo se mohou lišit obchod od obchodu. Pokud chcete spravovat nastavení pro určitý obchod, zvolte jeho název z rozbalovacího seznamu konfigurace pro více obchodů a zaškrtněte vlevo všechna potřebná políčka, abyste pro ně mohli nastavit vlastní hodnoty. Další podrobnosti najdete v kapitole [Více obchodů](xref:cs/getting-started/advanced-configuration/multi-store). ## robots.txt Soubor *robots.txt* sděluje crawlerům vyhledávačů, ke kterým URL na vašem webu mají přístup. Používá se hlavně k tomu, aby web nebyl přetížen požadavky; nejde o mechanismus, jak webovou stránku vyřadit z Googlu. Chcete-li webovou stránku z Googlu vyřadit, zablokujte indexování pomocí `noindex` nebo stránku chraňte heslem. Nastavení *robots.txt* definujte takto: ![Zabezpečení](_static/robots-txt/robots-txt.jpg) - **Povolit sitemap.xml** (Allow sitemap.xml) - Zaškrtněte, chcete-li robotům povolit přístup k souboru sitemap.xml. - **Zakázané jazyky** (Disallow languages) - Seznam jazyků, které se mají zakázat. Pokud nechcete robotům omezovat určité jazyky, ponechte toto pole prázdné. - **Zakázané cesty** (Disallow paths) - Seznam cest, které se mají zakázat. - **Lokalizovatelné zakázané cesty** (Localizable disallow paths) - Seznam lokalizovatelných cest, které se mají zakázat. - **Doplňková pravidla** (Additions rules) - Zadejte doplňková pravidla pro soubor robots.txt. Pravidla jsou pokyny pro crawlery, které části webu mohou procházet. Úplný popis jednotlivých pravidel najdete na stránce o [interpretaci specifikace robots.txt společností Google](https://developers.google.com/search/docs/crawling-indexing/robots/robots_txt). > [!NOTE] > > Data robots.txt můžete také rozšířit přidáním souboru *robots.additions.txt* do adresáře wwwroot svého webu. --- # Nastavení PDF Při provozu obchodu můžete potřebovat automaticky generované soubory PDF, například faktury a smluvní podmínky. Chcete-li definovat nastavení PDF, přejděte do **Konfigurace → Nastavení → Obecná nastavení** (Configuration → Settings → General settings) a najděte panel *PDF*: ![Panel PDF](_static/pdf-settings/pdf.png) * Do oblasti **Logo v PDF** (PDF logo) přetáhněte soubor loga, který chcete nahrát. Tento obrázek se bude zobrazovat na fakturách k objednávkám ve formátu PDF. Doporučuje se použít malý obrázek. * Do pole **Text zápatí faktury (levý sloupec)** (Invoice footer text (left column)) zadejte text, který se zobrazí v dolní části generovaných faktur (levý sloupec). * Do pole **Text zápatí faktury (pravý sloupec)** (Invoice footer text (right column)) zadejte text, který se zobrazí v dolní části generovaných faktur (pravý sloupec). * Zaškrtněte **Použít velikost stránky Letter** (Use Letter page size), pokud chcete, aby vaše dokumenty PDF měly velikost stránky Letter. Pokud toto políčko není zaškrtnuto, použije se ve výchozím nastavení velikost stránky A4. * Zaškrtněte **Zakázat faktury PDF pro čekající objednávky** (Disable PDF invoices for pending orders), pokud nechcete, aby si zákazníci mohli tisknout faktury PDF pro čekající objednávky. ## Návody * [Přidání firemních údajů (brandingu) na fakturu PDF](https://youtu.be/TeXmuNWsdD4) --- # Všechna nastavení *Všechna nastavení* je pokročilý nástroj pro úpravu všech nastavení webu na jediné obrazovce. Máte-li například více obchodů a potřebujete vytvořit přesnou kopii prvního obchodu z hlediska nastavení, může vám provedení všech změn na jedné obrazovce pomocí *Všech nastavení* ušetřit spoustu času. > [!NOTE] > > Úpravy nastavení v tomto okně se doporučují pouze pokročilým uživatelům. Nedoporučuje se tato nastavení měnit, pokud uživatel systém velmi dobře nezná. Nastavení definujete takto: Přejděte do **Konfigurace → Nastavení → Všechna nastavení (pokročilé)** (Configuration → Settings → All settings (advanced)). Zobrazí se okno *Všechna nastavení (pokročilé)*: ![Všechna nastavení](_static/all-settings/allsettings.png) ## Přidání nového nastavení Nové nastavení můžete přidat pomocí panelu *Přidat nový záznam* (Add new record) v dolní části stránky. Pro nové nastavení vyplňte následující pole: * Zadejte **Název nastavení** (Setting name). * Zadejte **Hodnotu** (Value) nastavení. * Určete, ve kterém **Obchodě** (Store) se nastavení použije. Kliknutím na **Přidat nový záznam** (Add new record) nastavení přidáte. ## Úprava existujícího nastavení Chcete-li upravit existující nastavení, klikněte na tlačítko **Upravit** (Edit) v řádku nastavení. Budete moci upravit **Název nastavení** a jeho **Hodnotu**. Poté kliknutím na **Aktualizovat** (Update) změny uložte. ![Úprava nastavení](_static/all-settings/edit.jpg) --- # Provoz obchodu * [Správa produktů](xref:cs/running-your-store/catalog/index) * [Správa objednávek](xref:cs/running-your-store/order-management/index) * [Správa zákazníků](xref:cs/running-your-store/customer-management/index) * [Správa dodavatelů](xref:cs/running-your-store/vendor-management) * [Propagační nástroje](xref:cs/running-your-store/promotional-tools/index) * [Optimalizace pro vyhledávače](xref:cs/running-your-store/search-engine-optimization) * [Reporty](xref:cs/running-your-store/reports) * [Správa systému](xref:cs/running-your-store/system-administration/index) --- # Produkty Přidávání a nastavování produktů patří k nejdůležitějším úkolům majitele obchodu. Je potřeba definovat typy produktů, roztřídit produkty do kategorií, přidat různé možnosti produktů a atraktivní obrázky, definovat štítky produktů a další parametry SEO. To vše zákazníkům usnadní vyhledávání a porovnávání produktů, což vede k většímu počtu nákupů. Přidávání produktů zahrnuje také některá důležitá interní nastavení, například parametry skladu a dopravy. Jak vytvářet produkty v nopCommerce, se dozvíte v následujících kapitolách: - [Přidání produktů](xref:cs/running-your-store/catalog/products/add-products) - [Hromadná úprava produktů](xref:cs/running-your-store/catalog/products/bulk-edit-products) - [Atributy produktu](xref:cs/running-your-store/catalog/products/product-attributes) - [Atributy specifikace](xref:cs/running-your-store/catalog/products/specification-attributes) - [Stahovatelné produkty](xref:cs/running-your-store/catalog/products/downloadable-products) - [Seskupené produkty (varianty)](xref:cs/running-your-store/catalog/products/grouped-products-variants) - [Opakované produkty](xref:cs/running-your-store/catalog/products/recurring-products) - [Produkty k pronájmu](xref:cs/running-your-store/catalog/products/rental-products) - [Import/export](xref:cs/running-your-store/catalog/products/import-export-products) - [Štítky produktů](xref:cs/running-your-store/catalog/products/product-tags) - [Recenze produktů](xref:cs/running-your-store/catalog/products/product-reviews) --- # Přidání produktů Co nejlepší nastavení produktů je pro obchod zásadní. Dbejte na to, abyste nevynechali žádný detail, jako je zobrazení různých variant velikostí a barev, důkladné popisy produktů a přidání atraktivních obrázků. Chcete-li přidat nový produkt, přejděte na **Katalog → Produkty** (Catalog → Products). Klikněte na tlačítko **Přidat nový** (Add new) v pravém horním rohu. ![Produkty](_static/add-product-for-beginners/products.jpg) > [!NOTE] > > Produkty můžete importovat z externího souboru kliknutím na tlačítko **Import**. Jakmile máte seznam produktů, můžete jej kliknutím na tlačítko **Export** exportovat do externího souboru pro účely zálohy. Po kliknutí na tlačítko **Export** se zobrazí rozbalovací nabídka, která umožňuje **Exportovat do XML (vše nalezené)** (Export to XML (all found)) nebo **Exportovat do XML (vybrané)** (Export to XML (selected)) a **Exportovat do Excelu (vše nalezené)** (Export to Excel (all found)) nebo **Exportovat do Excelu (vybrané)** (Export to Excel (selected)). Kromě toho je možné **Stáhnout katalog jako PDF** (Download catalog as PDF) a vytisknout tak vybrané produkty do souboru PDF. Chcete-li produkty ze seznamu odebrat, vyberte položky, které chcete smazat, a klikněte na tlačítko **Smazat (vybrané)** (Delete (selected)). Stránka *Přidat nový produkt* je k dispozici ve dvou režimech: **rozšířeném** a **základním** (ve výchozím nastavení rozšířený režim). Můžete se přepnout do základního režimu, který zobrazuje pouze povinná pole. ![Přidat nový produkt](_static/add-product-for-beginners/add_a_new_product.png) V *základním* režimu si také můžete nastavit, která pole mají být povinná. Klikněte na tlačítko **Nastavení** (Settings) vedle přepínače. Zobrazí se vyskakovací okno *Nastavení*: ![Nastavení](_static/add-product-for-beginners/settings.jpg) Vyberte potřebná pole a klikněte na **Uložit** (Save). Upozorňujeme, že se v tomto případě stránka obnoví. ## Informace o produktu Začněte vyplněním obecných informací na panelu *Informace o produktu* (Product info): - Zadejte **Název produktu** (Product name). - Zadejte **Krátký popis** (Short description) produktu, který se bude zobrazovat v katalogu. - Zadejte **Úplný popis** (Full description) produktu, který se zobrazí na stránce s detailem produktu. Zde můžete přidat text, odrážky, odkazy nebo další obrázky. Napište podrobný popis, protože ovlivňuje rozhodování vašich kupujících. - Zadejte **SKU** produktu. Jde o skladovou jednotku (stock-keeping unit) používanou interně ke sledování produktu. Je to váš jedinečný interní identifikátor, pomocí kterého produkt sledujete. - **Kategorie** (Categories). Produkt můžete přiřadit k libovolnému počtu kategorií. [Kategorie produktů](xref:cs/running-your-store/catalog/categories) spravujete v **Katalog → Kategorie** (Catalog → Categories). - **Výrobci** (Manufacturers). Produkt můžete přiřadit k libovolnému počtu výrobců. [Výrobce](xref:cs/running-your-store/catalog/manufacturers) spravujete v **Katalog → Výrobci** (Catalog → Manufacturers). - Zaškrtněte **Publikováno** (Published), aby byl produkt v obchodě viditelný. - Zadejte **Štítky produktu** (Product tags) – klíčová slova pro identifikaci produktu. Štítky oddělujte čárkami. Čím více produktů je spojeno s určitým štítkem, tím větší se zobrazí v cloudu *Oblíbené štítky* na bočním panelu stránky katalogu. Více o správě štítků produktů se dočtete v části [Štítky produktů](xref:cs/running-your-store/catalog/products/product-tags). ![Oblíbené štítky](_static/add-product-for-beginners/popular_tags.png) - Zadejte **GTIN (globální číslo obchodní položky)**. Mezi tyto identifikátory patří UPC (v Severní Americe), EAN (v Evropě), JAN (v Japonsku) a ISBN (pro knihy). - Zadejte **Katalogové číslo výrobce** (Manufacturer part number). Jde o číslo dílu, které produktu přidělil výrobce. - Zaškrtněte políčko **Zobrazit na domovské stránce** (Show on homepage), chcete-li produkt zobrazit na domovské stránce obchodu. Doporučeno pro vaše nejoblíbenější produkty. Pokud je toto políčko zaškrtnuto, může majitel obchodu zadat také **Pořadí zobrazení** (Display order) produktu. Hodnota 1 představuje začátek seznamu. - Nastavte **Typ produktu** (Product type) na *Jednoduchý* (Simple) nebo *Seskupený* (Grouped). Více o typech produktů se dočtete v kapitole [Seskupené produkty (varianty)](xref:cs/running-your-store/catalog/products/grouped-products-variants). - Pole **Šablona produktu** (Product template) je viditelné, pokud máte na stránce **Systém → Šablony** (System → Templates) nainstalované vlastní šablony produktů. - Zaškrtněte **Viditelný samostatně** (Visible individually), pokud chcete, aby se produkt zobrazoval v katalogu nebo ve výsledcích vyhledávání; v opačném případě bude produkt v katalogu skrytý a dostupný pouze ze stránky s detailem seskupeného produktu. - Zaškrtněte **Ověření věku** (Age verification), pokud produkt podléhá věkovému omezení. Věk zákazníka se pak ověřuje podle minimálního věku nastaveného u pole **Povoleno „Datum narození“** ('Date of Birth' enabled) v **Konfigurace → Nastavení → Nastavení zákazníků** (Configuration → Settings → Customer settings). Ujistěte se proto, že je toto pole povoleno a jeho hodnota **Minimální věk pro nákup** (Minimum age to purchase) je vhodně nastavena (například pro ověření, že je zákazníkovi více než 18 let). Více o konfiguraci pole data narození se dočtete v části [Nastavení zákazníků](xref:cs/running-your-store/customer-management/customer-settings). > [!NOTE] > > Pokud nelze datum narození zákazníka ověřit, produkt nelze zakoupit. - Vyberte **Role zákazníků** (Customer roles), které budou moci produkt v katalogu vidět. Pokud tuto možnost nepotřebujete a produkt mohou vidět všichni, ponechte pole prázdné. > [!NOTE] > > Abyste mohli tuto funkci používat, musíte vypnout následující nastavení: **Konfigurace → Nastavení katalogu → Ignorovat pravidla ACL (v celém webu)** (Configuration → Catalog settings → Ignore ACL rules (sitewide)). Více o [seznamu řízení přístupu](xref:cs/running-your-store/customer-management/access-control-list). - Pokud se produkt prodává jen v určitých obchodech, vyberte je v poli **Omezeno na obchody** (Limited to stores). Pokud tuto funkci nepotřebujete, ponechte pole prázdné. > [!NOTE] > > Abyste mohli tuto funkci používat, musíte vypnout následující nastavení: **Nastavení katalogu → Ignorovat pravidla „omezení na obchod“ (v celém webu)** (Catalog settings → Ignore "limit per store" rules (sitewide)). Více o [funkci více obchodů](xref:cs/getting-started/advanced-configuration/multi-store). - **Dodavatel** (Vendor). [Dodavatele](xref:cs/running-your-store/vendor-management) spravujete v **Zákazníci → Dodavatelé** (Customers → Vendors). - **Vyžaduje jiné produkty** (Require other products) určuje, zda produkt vyžaduje jiné produkty. Pokud ano, zadejte **ID požadovaných produktů** (Required product IDs) oddělená čárkami a zajistěte, aby nevznikaly cyklické odkazy, například A vyžaduje B a B vyžaduje A. V případě potřeby zvolte **Automaticky přidat tyto produkty do košíku** (Automatically add these products to the cart). - Zaškrtněte **Povolit recenze zákazníků** (Allow customer reviews), aby zákazníci mohli produkt hodnotit. - Definujte **Datum začátku dostupnosti** (Available start date) a/nebo **Datum konce dostupnosti** (Available end date) produktu. - Zaškrtněte **Označit jako nový** (Mark as new), chcete-li produkt označit jako nedávno přidaný. Tímto způsobem můžete spravovat seznam produktů zobrazených na stránce „Nové produkty“. Pomocí polí **Označit jako nový. Datum začátku** (Mark as new. Start date) a **Označit jako nový. Datum konce** (Mark as new. End date) můžete také určit období, po které bude produkt označen jako nový. - Do pole **Komentář administrátora** (Admin comment) zadejte informativní komentář. Tento komentář je pouze pro interní použití a zákazníci jej neuvidí. ## Cena Na panelu *Cena* (Price) definujte: - **Cenu** (Price) v předem nastavené měně. > [!NOTE] > > Měnu obchodu můžete změnit v **Konfigurace → Měny** (Configuration → Currencies). Více o [měnách](xref:cs/getting-started/configure-payments/advanced-configuration/currencies). - **Původní cenu** (Old price). Pokud je větší než nula, zobrazí se ve veřejné části obchodu vedle nové ceny pro porovnání. - **Náklady na produkt** (Product cost), tedy součet všech nákladů spojených s výrobou produktu nebo poskytnutím služby. Zákazníkům se nezobrazuje. - **Ceníky** (Price lists). Vyberte ceníky, které se na tento produkt vztahují. Ceník definuje, jak se cena produktu změní (procentuální nebo částkové zvýšení/snížení, případně pevná cena) a na které role zákazníků se uplatní. Ceníky spravujete v **Katalog → Ceníky** (Catalog → Price lists), kde lze pro každý produkt nastavit také **Ruční cenu** (Manual price), která přepíše vypočtenou hodnotu. > [!NOTE] > > Pokud se na stejný produkt vztahuje několik aktivních ceníků, o použité ceně rozhoduje nastavení **Strategie ceníků** (Price list strategy) v **Konfigurace → Nastavení → Nastavení katalogu** (Configuration → Settings → Catalog settings). Při strategii *Minimální cena* (Minimal price) se uplatní všechny odpovídající ceníky a použije se nejnižší vypočtená cena. Při strategii *Podle priority* (Use by priority) se ceníky uplatňují v pořadí podle hodnot jejich priority a použije se cena z prvního použitelného ceníku. - **Zakázat tlačítko koupit** (Disable buy button). To se může hodit u produktů „na vyžádání“. - **Zakázat tlačítko seznamu přání** (Disable wishlist button). - **Dostupné pro předobjednávku** (Available for pre-order), pokud produkt ještě v obchodě není, ale chcete zákazníkům umožnit si jej objednat. Ve veřejné části obchodu se místo standardního tlačítka *Přidat do košíku* zobrazí tlačítko *Předobjednat*. Je-li tato možnost zaškrtnuta, zobrazí se pole **Datum začátku dostupnosti předobjednávky** (Pre-order availability start date). Zadejte datum začátku dostupnosti produktu v UTC. Jakmile toto datum nastane, tlačítko *Předobjednat* se změní na *Přidat do košíku*. - **Cena na dotaz** (Call for price), chcete-li na stránce s detailem produktu ve veřejné části obchodu místo ceny zobrazit *Cena na dotaz* nebo *Vyžádat nabídku*. To vám může pomoci navázat kontakt se zákazníky a poskytnout jim další informace o produktu, o který se zajímají. - **Zákazník zadává cenu** (Customer enters price), pokud musí cenu zadat zákazník. Je-li tato možnost zaškrtnuta, zobrazí se následující pole: - Do pole **Minimální částka** (Minimum amount) zadejte minimální částku ceny. - Do pole **Maximální částka** (Maximum amount) zadejte maximální částku ceny. - **Povolena PAngV (základní cena)** (PAngV (base price) enabled), pokud má produkt základní cenu. To vyžaduje německý zákon (PAngV). Pokud například prodáváte 500 ml piva za 1,50 €, musíte uvést základní cenu: 3,00 € za 1 l. Je-li tato možnost zaškrtnuta, zobrazí se následující pole: - **Množství v produktu** (Amount in product) – prodávané množství produktu. - **Jednotka produktu** (Unit of product) – měrná jednotka dříve zadané hodnoty. - **Referenční množství** (Reference amount) – základní množství. - **Referenční jednotka** (Reference unit) – měrná jednotka dříve zadané hodnoty. - **Slevy** (Discounts). Zjistěte, jak [nastavit slevy](xref:cs/running-your-store/promotional-tools/discounts). > [!NOTE] > > Chcete-li používat slevy, ujistěte se, že je nastavení **Ignorovat slevy (v celém webu)** (Ignore discounts (sitewide)) vypnuto na panelu **Konfigurace → Nastavení → Nastavení katalogu → Výkon** (Configuration → Settings → Catalog settings → Performance). - Zda je produkt osvobozen od daně, a to zaškrtnutím **Osvobozeno od daně** (Tax exempt). V opačném případě vyberte z rozbalovacího seznamu **Daňová kategorie** (Tax category) požadovanou daňovou klasifikaci produktu. Daňové kategorie může majitel obchodu nastavit v **Konfigurace → Daně → Daňové kategorie** (Configuration → Tax → Tax categories). - V případě potřeby nastavte [množstevní ceny](xref:cs/running-your-store/promotional-tools/tier-prices). ## Doprava Na panelu *Doprava* (Shipping) definujte podrobnosti dopravy specifické pro produkt: - Zaškrtněte **Doprava povolena** (Shipping enabled), pokud lze produkt odeslat. Sekce se rozbalí a zobrazí další podrobnosti. - Nastavte parametry produktu, které se použijí pro výpočet dopravy: **Hmotnost, Délka, Šířka, Výška** (Weight, Length, Width, Height). > [!NOTE] > > Předdefinované měrné jednotky můžete změnit v **Konfigurace → Doprava → Měrné jednotky** (Configuration → Shipping → Measures). - **Doprava zdarma** (Free shipping), pokud je k dispozici. - **Odeslat samostatně** (Ship separately), pokud se má produkt odesílat odděleně od ostatních produktů. Pokud objednávka obsahuje několik kusů produktu, budou všechny odeslány samostatně. - **Příplatek za dopravu** (Additional shipping charge). - **Datum doručení** (Delivery date), které se zobrazí ve veřejné části obchodu. > [!NOTE] > > Možnosti data doručení spravujete v **Konfigurace → Doprava → Data doručení** (Configuration → Shipping → Delivery dates). > [!NOTE] > > K dispozici je nastavení **Povolit odhad dopravy (stránka produktu)** (Estimate shipping enabled (product page)), které lze zapnout v **Konfigurace → Nastavení → Nastavení dopravy** (Configuration → Settings → Shipping settings). > Toto nastavení umožňuje na stránce s detailem produktu ve vyskakovacím okně zobrazit odhadované informace o dopravě na základě doručovací adresy zákazníka. ## Sklad Definujte [nastavení skladu pro produkt podle tohoto popisu](xref:cs/running-your-store/order-management/inventory-management). ## Multimédia Na tomto panelu můžete přidat veškerý mediální obsah související s aktuálním produktem. ### Obrázky Na panelu *Obrázky* (Pictures) můžete přidat obrázky produktu. ![Multimédia – obrázky](_static/add-product-for-beginners/multimedia-pictures.jpg) Pomocí tlačítka **Nahrát soubory** (Upload files) můžete nahrát více obrázků najednou. Po nahrání obrázků můžete u každého z nich nastavit následující hodnoty: - Do pole **Alt** zadejte hodnotu atributu „alt“ HTML elementu „img“. Pokud je pole prázdné, použije se výchozí pravidlo (například název produktu). - Do pole **Titulek** (Title) zadejte hodnotu atributu „title“ HTML elementu „img“. Pokud je pole prázdné, použije se výchozí pravidlo (například název produktu). - Definujte **Pořadí zobrazení** (Display order) obrázku na stránce produktu. Hodnota 1 představuje začátek seznamu. > [!NOTE] > > Chcete-li nahrávat obrázky ve formátu *.svg, musíte aktivovat následující nastavení > ![Nastavení svg](_static/add-product-for-beginners/svg_setting.jpg) > > [!TIP] > > [Výukové video na YouTube: Hromadný import obrázků produktů](https://www.youtube.com/watch?v=9BUqR_OGiq4) ### Videa Na kartě „Video“ můžete přidat odkazy na vložená videa z libovolných videoslužeb, jako je *YouTube* nebo *Vimeo*. ![Multimédia – videa](_static/add-product-for-beginners/multimedia-videos.jpg) #### Odkaz pro vložení z YouTube 1. Najděte své video na YouTube a klikněte na tlačítko „Sdílet“. 1. Ve vyskakovací nabídce zvolte „Vložit“. ![sdílení videa na youtube](_static/add-product-for-beginners/youtube_share_embed.png) 1. Zkopírujte odkaz uzavřený v uvozovkách. ![kopírování odkazu na video z youtube](_static/add-product-for-beginners/youtube_share_embed_copy.png) 1. Vložte tento odkaz do pole „Embed video URL“, jak je popsáno výše. Upozorňujeme, že aby bylo možné videa vložit, musí být buď veřejná, nebo neveřejná (Unlisted); soukromá videa vložit nelze. #### Odkaz pro vložení z Vimeo 1. Najděte své video na Vimeo a klikněte na tlačítko „Share“. ![sdílení videa na vimeo](_static/add-product-for-beginners/vimeo_share.png) 1. Zkopírujte odkaz uzavřený v uvozovkách. ![sdílení videa na vimeo](_static/add-product-for-beginners/vimeo_share_embed_copy.png) 1. Vložte tento odkaz do pole „Embed video URL“, jak je popsáno výše. ### 3D model Tato funkce umožňuje nahrávat a zobrazovat 3D modely v galerii obrázků produktu. Zákazníkům poskytuje interaktivní způsob, jak si produkty prohlédnout, včetně funkcí, jako je otáčení modelu. #### Požadavky na soubory Majitelé obchodů musí 3D modely připravit ve formátu **.GLB**. K vytvoření kompatibilních modelů lze použít následující software pro 3D návrh a úpravy: - Maya - Blender - 3ds Max - ZBrush - Substance Painter - Photoshop Podporován je pouze **jeden** soubor `.GLB` na produkt. ![3D model](_static/add-product-for-beginners/multimedia_3d.png) Všechny nahrané soubory `.GLB` se ukládají do adresáře `\Nop.Web\wwwroot\images\3d\`. Pokud není nahrán žádný vlastní model, použije se zástupný soubor. > [!NOTE] > > Další globální konfigurace této funkce jsou k dispozici na stránce [Nastavení médií](xref:cs/getting-started/design-your-store/media-settings). ## Atributy produktu Na panelu *Atributy produktu* (Product attributes) můžete přidat atributy produktu. Více o [atributech produktu a jejich vytváření](xref:cs/running-your-store/catalog/products/product-attributes). ![Atributy produktu](_static/add-product-for-beginners/product_attributes2.png) ### Přidání nového atributu Jakmile máte vytvořený seznam atributů, klikněte na kartě *Atributy* (Attributes) na **Přidat nový atribut** (Add a new attribute). Zobrazí se okno *Přidat nový atribut*: ![Přidat nový atribut](_static/add-product-for-beginners/add-attribute.jpg) Nastavte nový atribut: - Z rozbalovacího seznamu **Atribut** (Attribute) vyberte atribut. - Vyplňte pole **Textová výzva** (Text prompt), pokud chcete, aby se ve veřejné části obchodu před tímto atributem zobrazoval nějaký text. - Zaškrtněte **Je povinný** (Is required), aby byl tento atribut pro zákazníky povinný. - Definujte **Typ ovládacího prvku** (Control type) pro tento atribut (například rozbalovací seznam, seznam přepínačů). > [!NOTE] > > U typu ovládacího prvku „Výběr data“ (Date picker) je možné nastavit počet zobrazovaných let pomocí parametru **catalogsettings.countdisplayedyearsdatepicker** na stránce *Všechna nastavení (pokročilé)* (All settings (advanced)). Pokud například nastavíte nulu, zobrazí se pouze aktuální rok. Pokud nastavíte 5, zobrazí se aktuální rok a následujících 5 let. Jak to nastavit, se dočtete na stránce [Všechna nastavení](xref:cs/getting-started/advanced-configuration/all-settings). - Definujte **Pořadí zobrazení** (Display order) atributu na stránce produktu. Hodnota 1 představuje začátek seznamu. Klikněte na **Uložit a pokračovat v úpravách** (Save and continue edit). Panel **Hodnoty** (Values) nyní zobrazuje předdefinované hodnoty tohoto atributu. V případě potřeby klikněte v řádku hodnoty na **Upravit** (Edit). ### Úprava hodnoty atributu ![Úprava hodnoty](_static/add-product-for-beginners/attribute-value.jpg) Podrobnosti hodnoty atributu upravte takto: - Vyberte **Typ hodnoty atributu** (Attribute value type). Existují dva typy hodnot atributu: *Jednoduchý* (Simple) a *Přidružený k produktu* (Associated to product). Typ *Přidružený k produktu* zvolte, pokud chcete, aby hodnotou tohoto atributu byl jiný produkt z vašeho katalogu, a chcete sledovat i jeho skladové zásoby. Zde můžete využít *funkci balíčků produktů*, která zákazníkům umožňuje koupit různé kombinace nebo sady produktů jako jeden produkt, přičemž nakupující mají možnost nastavit požadované množství atributů pomocí pole **Zákazník zadává množství** (Customer enters quantity) popsaného níže. Pokud je předchozí nastavení *Přidružený k produktu*, zobrazí se následující pole: - **Přidružený produkt** (Associated product) umožňuje vybrat produkt přidružený k tomuto atributu. K výběru produktu použijte tlačítko **Přidružit produkt** (Associate a product). > [!NOTE] > > Ujistěte se, že se po výběru přidruženého produktu nezobrazilo žádné upozornění. Například: > ![Upozornění u přidruženého produktu](_static/add-product-for-beginners/assotiated-warning.jpg) - Zaškrtněte pole **Zákazník zadává množství** (Customer enters quantity), chcete-li zákazníkovi umožnit zadat množství atributu (který představuje přidružený produkt). - Pokud předchozí pole není zaškrtnuto, můžete zadat **Množství produktu** (Product quantity). Minimální povolená hodnota je 1. - Zadejte **Název** (Name) atributu. - Zadejte **Barvu RGB** (RGB color), která se použije s ovládacím prvkem barevných čtverečků. - Do pole **Úprava ceny** (Price adjustment) zadejte cenu, která se uplatní při výběru této hodnoty atributu. Například „10“ pro přičtení 10 dolarů. Nebo 10 %, pokud je zaškrtnuto **Úprava ceny. Použít procenta** (Price adjustment. Use percentage). - Zaškrtněte **Úprava ceny. Použít procenta** (Price adjustment. Use percentage), což určuje, zda se na produkt uplatní procento. Pokud není povoleno, použije se pevná hodnota. - Pomocí pole **Úprava hmotnosti** (Weight adjustment) zadejte úpravu hmotnosti, která se uplatní při výběru této hodnoty atributu. - Vyplňte pole **Náklady** (Cost). Náklady na hodnotu atributu jsou náklady na všechny komponenty, které tuto hodnotu tvoří. Může jít buď o nákupní cenu, pokud jsou komponenty nakupovány od externích dodavatelů, nebo o kombinované náklady na materiál a výrobní procesy, pokud je komponenta vyráběna interně. - Zaškrtněte pole **Je předvybraný** (Is pre-selected), pokud má být tato hodnota atributu pro zákazníka předvybrána. - Zadejte **Pořadí zobrazení** (Display order) hodnoty atributu. Hodnota 1 představuje první položku v seznamu hodnot atributu. - Vyberte **Obrázek** (Picture) přidružený k této hodnotě atributu. Tento obrázek nahradí hlavní obrázek produktu, když se na tuto hodnotu atributu produktu klikne (vybere se). Klikněte na **Uložit** (Save). ### Podmínky atributů V případě potřeby definujte pro tento atribut podmínky na panelu *Podmínka* (Condition). Podmíněné atributy se zobrazí, pokud je vybrán předchozí atribut – například když nabízíte možnost personalizovat oblečení jménem a textové pole zobrazíte pouze tehdy, když je vybrán přepínač „Personalizovat“. ![Podmínka](_static/add-product-for-beginners/condition.jpg) - Zaškrtnutím políčka **Povolit podmínku** (Enable condition) podmínku povolíte. - Vyberte **Atribut** (Attribute) a jeho hodnotu. Po výběru hodnoty bude podmínka splněna a atribut se zobrazí. ### Kombinace atributů Na kartě *Kombinace atributů* (Attribute combinations) definujte různé kombinace atributů a pro každou z nich následující informace: ![product_attributes3](_static/add-product-for-beginners/product_attributes3.png) Kliknutím na tlačítko **Přidat kombinaci** (Add combination) vyberte novou kombinaci a zadejte její podrobnosti: ![Kombinace](_static/add-product-for-beginners/new-combination.jpg) Pro každou kombinaci definujte: - Atributy v rámci kombinace. - Aktuální **Skladové množství** (Stock quantity) této kombinace. - Pokud jste na stránce s detailem produktu povolili „Spravovat sklad podle atributů“ (Manage stock by attributes), můžete provést řadu akcí, když aktuální skladové množství klesne pod **Minimální skladové množství** (Minimum stock quantity) (nebo jej dosáhne), například zobrazit v přehledu nízkých zásob. - **Povolit i bez skladových zásob** (Allow out of stock), pokud chcete zákazníkům umožnit koupit produkt s určitými atributy, i když není skladem. - **SKU**. - **Katalogové číslo výrobce** (Manufacturer part number). - **GTIN**. - **Přepsaná cena** (Overridden price), pokud se cena produktů s určitými atributy liší od běžné ceny produktu. Tímto způsobem můžete například poskytnout slevu. Ponecháte-li pole prázdné, bude ignorováno. > [!NOTE] > > Je-li toto pole vyplněno, všechny ostatní uplatněné slevy budou ignorovány. - Do pole **Upozornit administrátora při množství nižším než** (Notify admin for quantity below) zadejte množství, pod jehož hodnotou bude administrátor upozorněn. - Vyberte **Obrázek** (Picture) přidružený k této kombinaci atributů. Tento obrázek nahradí hlavní obrázek produktu, když je vybrána tato kombinace atributů produktu. Klikněte na **Uložit** (Save). > [!NOTE] > > Upozorňujeme, že některé typy ovládacích prvků atributů, které podporují vlastní uživatelský vstup (například nahrání souboru, textová pole, výběr data), jsou ve spojení s kombinacemi atributů nepoužitelné. Chcete-li vygenerovat všechny možné kombinace, použijte tlačítko **Vygenerovat všechny možné kombinace** (Generate all possible combinations). Nebo použijte tlačítko **Vygenerovat několik kombinací** (Generate several combinations) a ručně vyberte některé hodnoty atributů, ze kterých se vygenerují potřebné kombinace. ## Atributy specifikace Atributy specifikace jsou vlastnosti produktu, jako je velikost obrazovky nebo počet portů USB, které jsou viditelné na stránce s detailem produktu. Atributy specifikace lze použít k filtrování produktů na stránce s detailem kategorie. Více o [atributech specifikace](xref:cs/running-your-store/catalog/products/specification-attributes). > [!NOTE] > > Na rozdíl od atributů produktu slouží atributy specifikace pouze k informačním účelům. ![Atributy specifikace](_static/add-product-for-beginners/spec.jpg) Na panelu *Atributy specifikace* (Specification attributes) přidejte atributy specifikace. >[!NOTE] > > Atribut můžete produktu přidat z existujícího seznamu atributů, nebo, pokud potřebujete vytvořit nový, přejděte na **Katalog → Atributy → Atributy specifikace** (Catalog → Attributes → Specification attributes). Chcete-li přidat nový atribut, klikněte na tlačítko **Přidat atribut** (Add attribute) a vyplňte sekci *Přidat nový atribut specifikace produktu*: ![Přidat nový atribut specifikace](_static/add-product-for-beginners/add_a_new_specification_attribute2.png) - Z rozbalovacího seznamu vyberte **Typ atributu** (Attribute type). - Ze seznamu předem vytvořených atributů vyberte **Atribut** (Attribute). - Vyberte **Možnost atributu** (Attribute option). - V případě potřeby povolte **Povolit filtrování** (Allow filtering) podle této možnosti na stránce kategorie. - Zaškrtněte **Zobrazit na stránce produktu** (Show on product page), aby byl atribut na stránce produktu viditelný. - Nastavte **Pořadí zobrazení** (Display order) atributu. Hodnota 1 představuje začátek seznamu. Klikněte na **Uložit** (Save). ## Třída produktu Určete, zda je produkt - [Dárkový poukaz](xref:cs/running-your-store/promotional-tools/gift-cards) - [Stahovatelný produkt](xref:cs/running-your-store/catalog/products/downloadable-products) - [Pronájem](xref:cs/running-your-store/catalog/products/rental-products) - [Opakovaný produkt](xref:cs/running-your-store/catalog/products/recurring-products) ## SEO Pro stránku produktu definujte následující parametry SEO: - **Název stránky přátelský k vyhledávačům** (Search engine friendly page name) – název stránky používaný vyhledávači. Pokud nic nezadáte, URL stránky produktu se vytvoří z názvu produktu. Pokud zadáte custom-seo-page-name, použije se následující vlastní URL: `http://www.yourStore.com/custom-seo-page-name`. - **Meta titulek** (Meta title) – titulek webové stránky. - **Meta klíčová slova** (Meta keywords) – stručný a výstižný seznam nejdůležitějších témat (klíčových slov a frází) souvisejících s produktem. Tato slova se přidají do hlavičky stránky produktu. - **Meta popis** (Meta description) – stručný popis produktu, který se přidá do hlavičky stránky produktu. Více o [SEO](xref:cs/running-your-store/search-engine-optimization). ## Související produkty a křížový prodej Nastavte [související produkty a křížový prodej podle tohoto popisu](xref:cs/running-your-store/promotional-tools/cross-sells-and-related-products). ## Zakoupeno v objednávkách Chcete-li zobrazit seznam objednávek, ve kterých byl produkt zakoupen, přejděte na panel *Zakoupeno v objednávkách* (Purchased with orders). Zde můžete zkontrolovat stav objednávky a zobrazit její podrobnosti. ![zakoupeno_v_objednavkach](_static/add-product-for-beginners/puchased_with_orders.png) ## Historie skladového množství Na této kartě můžete zobrazit všechny změny skladového množství produktu a objednávky s tímto produktem. ![historie_skladoveho_mnozstvi](_static/add-product-for-beginners/stock_quantity_history.png) ## Nastavení stránky produktu Nastavení stránky produktu popisují následující části: [Pole produktu](xref:cs/running-your-store/catalog/catalog-settings#product-fields), [Stránka produktu](xref:cs/running-your-store/catalog/catalog-settings#product-page) a [Sdílení](xref:cs/running-your-store/catalog/catalog-settings#share). ## Viz také - [Kategorie produktů](xref:cs/running-your-store/catalog/categories) - [Výrobci produktů](xref:cs/running-your-store/catalog/manufacturers) - [Správa objednávek](xref:cs/running-your-store/order-management/index) - [Webinář. První kroky v nopCommerce](https://www.youtube.com/watch?v=B_CfgJH0ylM&list=PLnL_aDfmRHwsJn1rnKaXdIcJg4pKJeeXs) ## Výukové materiály - [Výukové video: Přidání nového produktu](https://www.youtube.com/watch?v=wVgTgdQVWPQ&index=2&list=PLnL_aDfmRHwsbhj621A-RFb1KnzeFxYz4) --- # Hromadná úprava produktů Chcete-li hromadně upravit produkty, přejděte do **Produkty → Hromadná úprava produktů** (Products → Bulk edit products). Stránka hromadné úpravy produktů obsahuje seznam všech aktuálních produktů. ![Hromadná úprava produktů](_static/bulk-edit-products/bulk-edit-products.jpg) Když chcete upravit produkt, obvykle přejdete na stránku úpravy daného produktu. U drobné změny to nevadí, ale když potřebujete upravit celou řadu produktů, stává se to složitým a časově náročným. Funkce hromadné úpravy produktů poskytuje jednoduchý a pohodlný způsob, jak hromadně upravit část informací o produktech. Seznam polí dostupných k úpravě tvoří: - Název produktu - SKU - Cena - Původní cena - Množství skladem - Publikováno V pravém horním rohu stránky je tlačítko '**Uložit vybrané**' (Save selected) a tlačítko '**Uložit vše**' (Save all). Po kliknutí se všechny nově zadané hodnoty uloží do databáze. ![Hromadná úprava produktů 1](_static/bulk-edit-products/bulk-edit-products_1.jpg) Produkty můžete také přidávat kliknutím na tlačítko '**Přidat nový**' (Add new) na konci tabulky. --- # Atributy produktu Atributy produktu jsou varianty produktu (například barva, velikost). Uživatel může vytvářet různé kombinace atributů. Například produkt může být k dispozici v různých velikostech a barvách. Uživatel by tedy vytvořil dva atributy a jejich hodnoty, například „velikost“ (S, M, L) a „barva“ (červená, modrá, bílá), a poté nastavil skupiny podle dostupnosti produktů. V nopCommerce se atributy produktu používají při **sledování skladových zásob** a mohou také způsobit **rozdíl v ceně**. Chcete-li definovat atributy produktu, přejděte do **Katalog → Atributy → Atributy produktu** (Catalog → Attributes → Product attributes). ![Atributy produktu](_static/product-attributes/product_attributes.png) > [!NOTE] > > Ve výchozím nastavení nejsou v nopCommerce předem vytvořeny žádné atributy produktu. ## Přidání atributů produktu Kliknutím na **Přidat nový** (Add new) přidáte atribut. ![Přidat nový](_static/product-attributes/add_a_new_product_attribute.png) V okně *Přidat nový atribut produktu* vyplňte pole **Název** (Name) a **Popis** (Description). Kliknutím na **Uložit a pokračovat v úpravách** (Save and continue edit) přejdete na panel úprav *Předdefinované hodnoty* (Predefined values). > [!TIP] > > [Videonávod na YouTube: Přidání produktu s barevnými atributy](https://youtu.be/QihipwQ61YU) ## Přidání předdefinovaných hodnot Na panelu *Předdefinované hodnoty* klikněte na **Přidat novou hodnotu** (Add a new value) a otevře se okno *Přidat novou hodnotu*: ![Přidání předdefinovaných hodnot](_static/product-attributes/add_a_new_value.png) V okně *Přidat novou hodnotu* definujte: - **Název** (Name) atributu. - **Úpravu ceny** (Price adjustment) uplatněnou při výběru této hodnoty atributu. Například „10“ pro přičtení 10 dolarů. Nebo 10 %, pokud je zaškrtnuto **Úprava ceny. Použít procenta** (Price adjustment. Use percentage). - Zaškrtávací políčko **Úprava ceny. Použít procenta** umožňuje určit procentuální úpravu ceny namísto absolutní hodnoty. - **Úpravu hmotnosti** (Weight adjustment) uplatněnou při výběru této hodnoty atributu. - Hodnota atributu **Náklady** (Cost) představuje náklady na všechny komponenty, ze kterých se tato hodnota skládá. Může jít buď o nákupní cenu, pokud jsou komponenty nakupovány od externích dodavatelů, nebo o souhrnné náklady na materiál a výrobní procesy, pokud je komponenta vyráběna interně. - Zda je hodnota pro zákazníka **Předvybraná** (Is pre-selected). - **Pořadí zobrazení** (Display order) v seznamu atributů. Po vyplnění polí klikněte na **Uložit** (Save). > [!TIP] > > Při přidávání atributu produktu není nutné vytvářet hodnoty atributu; můžete je vytvořit později při přiřazování konkrétního atributu produktu k produktu. > Jakmile jsou atributy a hodnoty nastaveny, lze je seskupovat a spravovat na panelu *Atributy produktu* na stránce úprav produktu. > > [!NOTE] > > Někteří majitelé obchodů dávají přednost zvýraznění produktů odlišených atributy a vytvářejí samostatný produkt pro každý konkrétní atribut (například samostatně uvedená modrá trička a červená trička). V takovém případě doporučujeme vytvořit seskupený produkt (v příkladu trička), aby se všechny varianty zobrazily na stejné stránce, když si zákazník seskupený produkt prohlíží. Přečtěte si více o [seskupených produktech](xref:cs/running-your-store/catalog/products/grouped-products-variants). > > [!WARNING] > > Přidání nových nebo aktualizace stávajících „Předdefinovaných hodnot“ nemá vliv na produkty, které již daný atribut mají. ## Panel Používáno produkty Na panelu *Používáno produkty* (Used by products) můžete zvolit, které produkty tento atribut používají: ![Používáno produkty](_static/product-attributes/used-by.jpg) ## Viz také - [Přidávání produktů](xref:cs/running-your-store/catalog/products/add-products) - [Seskupený produkt](xref:cs/running-your-store/catalog/products/grouped-products-variants) ## Videonávody - [Přehled podmíněných atributů produktu](https://www.youtube.com/watch?v=eIdHVcEdos8&t=55s) --- # Atributy specifikace Atributy specifikace jsou podobné [atributům produktu](xref:cs/running-your-store/catalog/products/product-attributes); používají se však pouze pro informaci (zobrazují se na stránce detailu produktu) a pro filtrování produktů na stránce detailu kategorie. Neurčují cenu produktu a nelze je použít ke sledování skladových zásob. ## Příklad Řekněme, že provozujete internetový obchod s počítači. Co zákazníkovi pomůže rozhodnout se? - Poskytněte zákazníkovi úplné a výstižné informace o svých produktech. Přestože vyplníte krátký i úplný popis konkrétního počítače, umožněte zákazníkovi zobrazit vlastnosti produktu, které vystihují jeho nejdůležitější detaily: ![Atributy specifikace](_static/specification-attributes/specs.jpg) Tato tabulka se může zobrazit na stránce detailu produktu, pokud při [přidávání atributu specifikace k produktu](xref:cs/running-your-store/catalog/products/add-products#specification-attributes) zaškrtnete pole **Zobrazit na stránce produktu** (Show on product page). - Umožněte zákazníkům vyhledávat počítače pomocí funkce filtrování. Řekněme, že ve vašem obchodě lze vyhledávat podle typu procesoru a paměti. Stránka kategorie pak bude vypadat takto: ![Filtrování](_static/specification-attributes/filter.jpg) Při [přidávání atributu specifikace k produktu](xref:cs/running-your-store/catalog/products/add-products#specification-attributes) zaškrtněte pole **Povolit filtrování** (Allow filtering), chcete-li u konkrétního produktu povolit filtrování podle tohoto atributu. - Zahrňte do svého obchodu funkci „Porovnání produktů“. Tato funkce rovněž využívá atributy specifikace. Ve vašem obchodě s počítači bude stránka „Porovnání produktů“ vypadat takto: ![Porovnání produktů](_static/specification-attributes/compare.jpg) Funkci „Porovnání produktů“ povolíte v **Konfigurace → Nastavení → Nastavení katalogu** (Configuration → Settings → Catalog settings). Na panelu *Porovnání produktů* zaškrtněte políčko **Povoleno „Porovnání produktů“** ('Compare products' enabled). Další část popisuje, jak atributy specifikace vytvořit. Upozorňujeme, že po vytvoření seznamu atributů specifikace je budete muset k produktům přidávat jednotlivě. Jak přidat atributy specifikace k produktům, se dozvíte v části [Přidávání produktů – Atributy specifikace](xref:cs/running-your-store/catalog/products/add-products#specification-attributes). ## Vytvoření skupiny atributů specifikace > [!NOTE] > > Všechny atributy specifikace, které nepatří do žádné skupiny, jsou ve *Výchozí skupině (nezařazené atributy specifikace)*. Seznam atributů specifikace a jejich skupin zobrazíte a upravíte v **Katalog → Atributy → Atributy specifikace** (Catalog → Attributes → Specification attributes). ![Atributy specifikace](_static/specification-attributes/specification_attributes.jpg) Kliknutím na **Přidat skupinu** (Add group) přidáte novou skupinu. Zobrazí se okno *Přidat novou skupinu atributů specifikace*: ![Přidat skupinu](_static/specification-attributes/specification_group.jpg) Na panelu *Informace o skupině atributů* zadejte: - **Název** (Name) skupiny atributů specifikace. - Číslo **Pořadí zobrazení** (Display order). Poté změny uložte. ## Vytvoření atributu specifikace > [!NOTE] > > Ve výchozím stavu nejsou v nopCommerce předem vytvořeny žádné atributy specifikace. Seznam atributů specifikace zobrazíte a upravíte v **Katalog → Atributy → Atributy specifikace** (Catalog → Attributes → Specification attributes). ![Atributy specifikace](_static/specification-attributes/specification_attributes.jpg) Na této stránce můžete atributy specifikace smazat tak, že je vyberete a kliknete na tlačítko **Smazat (vybrané)** (Delete(selected)). Kliknutím na **Přidat atribut** (Add attribute) přidáte nový atribut. Zobrazí se okno *Přidat nový atribut specifikace*: ![Přidat nový](_static/specification-attributes/new-attribute.jpg) Na panelu *Informace o atributu* zadejte: - **Název** (Name) atributu specifikace. - Číslo **Pořadí zobrazení** (Display order). Kliknutím na **Uložit a pokračovat v úpravách** (Save and continue edit) přejdete na panel úprav *Možnosti*. ### Přidání nové možnosti Kliknutím na tlačítko **Přidat novou možnost** (Add a new option) na panelu *Možnosti* (Options) vytvoříte novou možnost atributu specifikace. Zobrazí se okno *Přidat novou možnost*: ![Přidat novou možnost](_static/specification-attributes/add_a_new_option.jpg) Definujte následující nastavení možnosti: - **Název** (Name) možnosti atributu specifikace. - Zaškrtnutím políčka **Určit barvu** (Specify color) zvolíte barvu, která se použije místo textového názvu možnosti (zobrazí se jako „barevný čtvereček“). - Zvolte **RGB barvu** (RGB color), která se zobrazí zákazníkům. - Číslo **Pořadí zobrazení** (Display order). Kliknutím na **Uložit** (Save) uložíte údaje možnosti. Následující snímek obrazovky zobrazuje již přidané možnosti: ![Možnosti](_static/specification-attributes/options.jpg) ### Použito u produktů Pokud jste atribut specifikace použili u produktů, můžete seznam těchto produktů zobrazit na panelu *Použito u produktů* (Used by products): ![Použito u produktů](_static/specification-attributes/used-by.jpg) ## Viz také - [Přidávání produktů](xref:cs/running-your-store/catalog/products/add-products) - [Atributy produktu](xref:cs/running-your-store/catalog/products/product-attributes) - [Video návod na YouTube: Správa atributů specifikace](https://www.youtube.com/watch?v=YmD_vHqWzQw&index=11&list=PLnL_aDfmRHwsbhj621A-RFb1KnzeFxYz4) --- # Produkty ke stažení Funkce produktů ke stažení je užitečná, pokud budete prodávat například e-knihy nebo audioknihy, kurzy, soubory PDF, hudbu, software nebo chcete vytvořit fotobanku. ## Příklad Řekněme, že chcete prodávat e-knihy. Čím se obchod s e-knihami liší od jiných obchodů? - Především byste měli zákazníkům poskytnout snadný způsob, jak si knihy z vašeho obchodu stáhnout. V nopCommerce najdou zákazníci všechny zakoupené produkty ke stažení v sekci „Můj účet“: ![Ukázka](_static/downloadable-products/my-account.jpg) - Možná budete chtít zákazníkům umožnit také náhled některých částí knih, které chtějí koupit. V takovém případě uvidí zákazníci na stránce s podrobnostmi produktu následující tlačítko *Stáhnout ukázku*: ![Ukázka](_static/downloadable-products/sample.jpg) - Nebo může být užitečné požádat zákazníka, aby před stažením e-knihy souhlasil s *uživatelskou smlouvou*. Například souhlasil, že si stáhne a vytiskne jednu kopii každé kapitoly e-knihy pouze pro osobní potřebu. Takto zákazník tuto smlouvu uvidí: ![Souhlas](_static/downloadable-products/agree.jpg) Všechny tyto funkce lze nastavit při úpravě produktu. Ve zvláštních případech navíc můžete stahování určité knihy omezit nastavením počtu dní, po které si zákazníci ponechají přístup ke knize, nebo maximálního počtu stažení. Nebo můžete zvolit, kdy může zákazník knihu stáhnout: ihned po zaplacení knihy, nebo po ručním ověření. Pokud jste se již naučili nastavit [běžný produkt](xref:cs/running-your-store/catalog/products/add-products), v následující části se dozvíte, jak z tohoto produktu udělat produkt ke stažení. ## Nastavení produktu ke stažení Chcete-li vytvořit produkt ke stažení, přejděte do **Katalog → Produkty** (Catalog → Products). Klikněte na **Přidat nový** (Add new), vyplňte běžná pole produktu a zaškrtněte příslušné políčko na panelu *Produkt ke stažení* (Downloadable product). ![Produkt ke stažení](_static/downloadable-products/DownloadableProduct.png) Definujte následující údaje: - V sekci **Soubor ke stažení** (Download file) nahrajte soubor pomocí tlačítka **Nahrát soubor** (Upload a file), nebo zaškrtněte příslušné políčko **použít URL ke stažení** (use download URL) a zadejte **URL ke stažení** (Download URL). - **Neomezený počet stažení** (Unlimited downloads) – pokud lze produkt stáhnout neomezeně mnohokrát. Když tato možnost není zaškrtnutá, zobrazí se další pole. - Do pole **Max. počet stažení** (Max. downloads) zadejte maximální počet stažení, který zákazník po zakoupení produktu získá. - **Počet dní** (Number of days), po které si zákazníci ponechají přístup k souboru. Pokud chcete povolit trvalé stahování, ponechte toto pole prázdné. - **Typ aktivace stahování** (Download activation type): - *Když je objednávka zaplacena* (When order is paid) — tuto možnost vyberte, chcete-li stahování povolit, až když je stav platby objednávky „Zaplaceno“. - *Ručně* (Manually) — tuto možnost vyberte, chcete-li předat kontrolu administrátorovi obchodu. Když je tato možnost vybrána, musí administrátor stahování aktivovat ručně. To se provádí na panelu *Produkty* (Products) stránky *Upravit podrobnosti objednávky* (Edit order details). - **Má uživatelskou smlouvu** (Has user agreement) — pokud musí zákazník souhlasit s uživatelskou smlouvou, aby mohl produkt stáhnout. - Poté se zobrazí editor **Text uživatelské smlouvy** (User agreement text), který umožňuje zadat/upravit text uživatelské smlouvy. - **Má ukázkový soubor ke stažení** (Has sample download file) umožňuje zákazníkovi stáhnout ukázkový soubor. - Pokud je to relevantní, nahrajte **Ukázkový soubor ke stažení** (Sample download file) pomocí tlačítka **Nahrát soubor** (Upload a file), nebo zaškrtněte příslušné políčko **použít URL ke stažení** (use download URL) a zadejte **URL ke stažení** (Download URL). Soubor se zobrazí na stránce s podrobnostmi produktu a může si jej zdarma stáhnout kterýkoli zákazník. > [!TIP] > > Protože produkty ke stažení nevyžadují dopravu, ujistěte se, že pole **Doprava povolena** (Shipping enabled) na panelu *Doprava* (Shipping) není zaškrtnuté. > > [!TIP] > > Protože u produktů ke stažení není třeba sledovat skladové zásoby, ujistěte se, že pole **Způsob správy zásob** (Inventory method) na panelu *Skladové zásoby* (Inventory) je nastaveno na *Nesledovat zásoby* (Don't track inventory). ## Registrace zákazníka Rozhodněte, zda je pro produkty ke stažení vyžadována registrace zákazníka, zaškrtnutím políčka **Vyžadovat registraci pro produkty ke stažení** (Require registration for downloadable products) na panelu *Obecné* (Common) na stránce **Konfigurace → Nastavení → Nastavení zákazníků** (Configuration → Settings → Customer settings). ## Stránka účtu s produkty ke stažení Pokud chcete ze stránky zákaznického účtu skrýt položku nabídky „Produkty ke stažení“, přejděte na stránku **Konfigurace → Nastavení → Nastavení zákazníků** (Configuration → Settings → Customer settings) a zaškrtněte políčko **Skrýt kartu „Produkty ke stažení“** (Hide 'Downloadable products' tab). ## Viz také - [Objednávky](xref:cs/running-your-store/order-management/orders) ## Výukové materiály - [Správa digitálních produktů](https://www.youtube.com/watch?v=om-HKr-B2yA) --- # Seskupené produkty (varianty) Seskupené produkty neboli produkty s variantami jsou pohodlným nástrojem pro prodej produktu, který má různé doplňkové položky nebo sady atributů. Různé kombinace takového produktu lze prodávat jako samostatné produkty a jejich cena se může lišit. V nopCommerce vypadají seskupené produkty jako jediná stránka s detailem produktu, která zobrazuje všechny možné varianty. Jde o pohodlný a SEO přívětivý nástroj pro prodej komplexních produktů. > [!TIP] > > Základní produkt, například tělo fotoaparátu, lze například seskupit s různými sadami objektivů. Dalším případem použití seskupeného produktu je prodej určitého typu produktu s různými sadami atributů. Například čokoláda s různými příchutěmi. V takovém případě zákazník snadno uvidí hlavní produkt a všechny jeho varianty na stejné stránce. ![Seskupený produkt](_static/grouped-products-variants/grouped.jpg) ## Přidání nového seskupeného produktu Chcete-li vytvořit seskupený produkt, přejděte na **Katalog → Produkty** (Catalog → Products). Postup se skládá z několika kroků: > [!TIP] > > Zjistěte, [jak vyplnit pole produktu](xref:cs/running-your-store/catalog/products/add-products). 1. Vytvořte několik produktů s typem produktu *jednoduchý* (simple). Ty představují varianty hlavního produktu. Pomocí políčka **Viditelný samostatně** (Visible individually) určete, zda mají být viditelné samostatně v katalogu a ve výsledcích vyhledávání, nebo se mají zobrazovat pouze na stránce hlavního produktu. 1. Vytvořte produkt typu **Seskupený (produkt s variantami)** (Grouped (product with variants)) a na panelu **Přidružené produkty (varianty)** (Associated products (variants)) k němu přiřaďte jednoduché produkty vytvořené v předchozím kroku: ![varianty](_static/grouped-products-variants/variants.png) > [!NOTE] > > - Ve veřejné části obchodu vidí zákazník na stránce s detailem *seskupeného* produktu samostatné tlačítko **Přidat do košíku** pro každý přidružený produkt. > - *Jednoduchý* produkt může být přidružen pouze k jednomu *seskupenému* produktu. > - *Seskupené* produkty **nelze objednat přímo**. Lze však objednat *jednoduché* produkty, které jsou k nim přidruženy. Zákazník si například nemůže přímo objednat produkt Creative Sound Card. Místo toho si musí objednat verzi OEM nebo Retail produktu Creative Sound Card. V tomto případě je *seskupeným* produktem Creative Sound Card a k tomuto *seskupenému* produktu jsou přidruženy dva *jednoduché* produkty: OEM a Retail, každý s potenciálně odlišnou cenou. ## Výukové materiály - [Seskupené produkty v nopCommerce](https://www.youtube.com/watch?v=B1UdxXf_jmE) - [Vytváření balíčků produktů v nopCommerce](https://www.youtube.com/watch?v=sf9jP6KFcko) --- # Opakující se produkty Typ opakujícího se produktu se obvykle používá pro předplatné nebo produkty s plánem splátek. Pokud je váš produkt opakující se, zaškrtněte odpovídající políčko na panelu *Opakující se produkt* (Recurring product). ![Opakující se produkt](_static/recurring-products/recurring.png) Definujte následující údaje: - **Délka cyklu** (Cycle length). Jde o časové období, ve kterém se opakující se objednávka může opakovat. - **Období cyklu** (Cycle Period) ve *dnech*, *týdnech*, *měsících* nebo *letech*. Určuje jednotky časového období. - **Celkový počet cyklů** (Total cycles) je počet, kolikrát zákazník opakující se produkt obdrží. Opakovací cyklus můžete definovat pro jakýkoli produkt, aby systém mohl automaticky vytvářet opakované objednávky. V takovém případě systém vždy, když má být provedena platba, použije platební údaje z původní objednávky pro následné opakované objednávky. Na následné objednávky se navíc uplatní původní poplatky za dopravu. > [!NOTE] > > Alespoň jeden z aktivních platebních modulů musí podporovat opakované platby. ## Viz také - [Platební metody](xref:cs/getting-started/configure-payments/payment-methods/index) --- # Produkty k pronájmu Funkce produktů k pronájmu je užitečná, pokud chcete vytvořit web, na kterém si zákazníci mohou rezervovat pokoje a hotely. Tuto funkci lze použít také pro web, který nabízí k pronájmu například svatební šaty, kempingové vybavení, dětské hračky a další. ## Příklad Řekněme, že chcete vytvořit web nabízející svatební šaty k pronájmu. Které funkce budou v tomto případě užitečné? - Jednou z nejdůležitějších funkcí je umožnit zákazníkům zvolit *dobu pronájmu*. V nopCommerce lze zvolit datum začátku a datum konce, jak je vidět na snímku obrazovky níže: ![Příklad pronájmu](_static/rental-products/example.jpg) - nopCommerce také umožňuje administrátorovi obchodu zvolit *období pronájmu* a *délku období pronájmu*. Chcete například pronajímat svatební šaty minimálně na 3 dny. V takovém případě zákazník uvidí na stránce s detailem produktu následující: ![Období pronájmu](_static/rental-products/period.jpg) - Pomocí *atributů pokladny* můžete zákazníkům umožnit zadat čas vrácení, kdy má dopravce šaty vyzvednout: ![Příklad pronájmu](_static/rental-products/time.jpg) Více o atributech pokladny se dočtete [zde](xref:cs/running-your-store/order-management/checkout-attributes). Pokud jste se již naučili nastavit [běžný produkt](xref:cs/running-your-store/catalog/products/add-products), v následující části se dozvíte, jak z tohoto produktu udělat produkt k pronájmu. ## Nastavení produktu k pronájmu Chcete-li vytvořit produkt k pronájmu, přejděte na **Katalog → Produkty** (Catalog → Products). Klikněte na **Přidat nový** (Add new), vyplňte běžná pole produktu a na panelu *Pronájem* (Rental) zaškrtněte odpovídající políčko. ![Panel Pronájem](_static/rental-products/rental.png) Definujte následující podrobnosti: - **Délka období pronájmu** (Rental period length) je délka cyklu pronájmu, tedy minimální zúčtovací období. Cena se uvádí za toto období. - **Období pronájmu** (Rental period) ve *dnech*, *týdnech*, *měsících* nebo *letech*. Určuje časové jednotky období pronájmu. Při nákupu produktů k pronájmu musí zákazníci ve veřejné části obchodu zadat dobu pronájmu. Částka k úhradě se vypočítá automaticky. ![Pronájem ve veřejné části obchodu](_static/rental-products/rental1.png) ## Výukové materiály - [Správa produktů k pronájmu](https://www.youtube.com/watch?v=tOaC6hOILZY&list=PLnL_aDfmRHwsbhj621A-RFb1KnzeFxYz4&index=24) --- # Import/export produktů nopCommerce podporuje import z formátu Excel a export produktů do XML nebo Excelu. Produkty z katalogu si můžete stáhnout v PDF. Tyto možnosti najdete v **Katalog → Produkty** (Catalog → Products) na hlavní stránce vlevo nahoře. ![Produkty](_static/import-export-products/buttons.jpg) ## Export produktů Produkty můžete exportovat ve formátu XML nebo Excel kliknutím na tlačítko **Exportovat** (Export). Po kliknutí na tlačítko **Exportovat** se zobrazí rozevírací nabídka, která umožňuje **Exportovat do XML (vše nalezené)** (Export to XML (all found)) nebo **Exportovat do XML (vybrané)** (Export to XML (selected)) a **Exportovat do Excelu (vše nalezené)** (Export to Excel (all found)) nebo **Exportovat do Excelu (vybrané)** (Export to Excel (selected)). ![Export produktu](_static/import-export-products/exporting_product.png) Pokud nepotřebujete stáhnout všechny produkty, použijte panel *Hledat* (Search) k nalezení požadovaných produktů a/nebo zaškrtávací políčka k výběru potřebných produktů. Stáhne se soubor s produkty, které jste zvolili. Soubor bude obsahovat všechny vlastnosti produktů z panelů stránky úprav produktu (Informace o produktu, SEO, Obrázky a další). > [!NOTE] > > Pokud používáte atributy produktů, bude exportovaná tabulka Excelu seskupena podle řádků. Chcete-li zobrazit detaily atributů, klikněte v tabulce na + vedle svého produktu. > ![Jednoduchý produkt](_static/import-export-products/simple_product.png) ## Import produktů Pokud nechcete přidávat všechny produkty do katalogu ručně, můžete použít možnost importu. > [!NOTE] > > Než začnete importovat, měli byste si stáhnout šablonu tabulky pro import ve formátu Excel, jak bylo popsáno v sekci [export produktů](#exporting-products). Pro přesný a správný import produktů je zásadní správně pojmenovat všechny sloupce v tabulce (přesně jako ve stažené tabulce). Není povinné vyplnit všechna pole tabulky. Produkt bude vytvořen na základě vyplněných polí. Importované produkty se rozlišují podle SKU. Pokud SKU již existuje, odpovídající produkt bude aktualizován. Import vyžaduje hodně paměťových prostředků. Proto se nedoporučuje importovat více než 500–1000 záznamů najednou. Pokud máte více záznamů, je lepší je rozdělit do několika souborů Excel a importovat je samostatně. ### Příklad Například chceme do katalogu přidat taneční boty. Vytvořme v tabulce nový řádek: ![tabulka produktů](_static/import-export-products/product_table.png) Poté klikněte na **Importovat** (Import), zvolte soubor a klikněte na tlačítko **Importovat z Excelu** (Import from Excel). Poté zkontrolujte, zda máte v katalogu nový produkt. ![katalog produktů](_static/import-export-products/product_catalog.png) ## Import produktů s obrázky hostovanými na externích zdrojích Někdy je nutné importovat produkty s obrázky, které jsou hostovány na externích zdrojích. nopCommerce takový scénář podporuje. Z bezpečnostních důvodů je však tato možnost ve výchozím stavu vypnutá. Můžete ji povolit na stránce **„Nastavení katalogu“** (Catalog settings) v administraci. Stačí povolit nastavení **„Export/import produktů. Povolit stahování obrázků“** (Export/import products. Allow download images). V této metodě načítání obrázků se používá kód pro ověřování adres poskytovaný platformou .NET. Tento mechanismus ne vždy správně určí správnost adres, přestože plně odpovídají specifikaci [RFC3986](https://datatracker.ietf.org/doc/html/rfc3986). Doporučujeme vyhnout se v URL používání speciálních znaků, jako jsou **^** nebo **~**. Ujistěte se proto, že všechny zadané URL obsahují pouze latinské znaky. ## Import produktů s kategoriemi a výrobci Import kategorií a výrobců je specifický, protože produkt může patřit do více kategorií nebo výrobců. Každá nová hodnota v této buňce musí být oddělena znakem **;**. Vyhněte se prosím používání mezer pro formátování, i když by je algoritmus měl ignorovat (například 1;2;3 je lepší než 1; 2; 3). Sloupce **Categories** a **Manufacturers** mohou obsahovat jak identifikátory odpovídajících objektů, tak jejich názvy (můžete použít jeden přístup nebo oba podle svého uvážení kombinovat). Pokud chcete importovat kategorie podle názvu, můžete zadat pouze název nebo celou hierarchii názvů kategorií. V takovém případě bude nadřazená kategorie oddělena od podřízené symboly **>>**. Například „Computers >> Desktops;“ Import kategorií a výrobců podle názvu rozlišuje velká a malá písmena, tzn. „**T**est category/manufacturer **n**ame“ není totéž co „**t**est category/manufacturer **N**ame“ ## Nastavení importu/exportu Nastavení importu/exportu popisuje následující sekce: [Export/import](xref:cs/running-your-store/catalog/catalog-settings#exportimport). ## Viz také * [Přidávání produktů](xref:cs/running-your-store/catalog/products/add-products) --- # Štítky produktů Štítky produktů jsou klíčová slova pro identifikaci produktů. Slouží k řazení produktů podle určité vlastnosti a umožňují specifické, úzce zaměřené vyhledávání produktů. Pokud například prodáváte oblečení a chcete vytvořit štítky pro trička, mohou to být například „tričko“, „bavlna“, „polo“. Chcete-li upravit štítky produktů, které se zobrazují ve veřejné části obchodu, přejděte do **Katalog → Štítky produktů** (Catalog → Product tags). ![Štítky produktů](_static/product-tags/tags.jpg) Na stránce štítků produktů vidíte ve sloupci **Označené produkty** (Tagged products), kolik produktů má určitý štítek. Štítek můžete upravit kliknutím na tlačítko **Upravit** (Edit) vedle něj. Štítky můžete také smazat tak, že je vyberete a kliknete na tlačítko **Smazat (vybrané)** (Delete(selected)). ## Přidávání štítků produktů Štítky můžete přidat na stránce Upravit podrobnosti produktu při přidávání nebo úpravě produktu. ![Přidání štítků](_static/product-tags/product_tags2.png) Zadejte štítky a oddělte je čárkami. Jakmile jsou štítky vytvořeny, lze je použít i pro další produkty. Čím více produktů je s určitým štítkem spojeno, tím větší bude v oblasti *Oblíbené štítky* zobrazené v postranním panelu stránky katalogu: ![Oblíbené štítky](_static/product-tags/popular_tags.png) ## Nastavení štítků produktů Nastavení štítků produktů popisuje následující část: [Štítky](xref:cs/running-your-store/catalog/catalog-settings#tags). ## Viz také * [Kategorie produktů](xref:cs/running-your-store/catalog/categories) * [Přidávání produktů](xref:cs/running-your-store/catalog/products/add-products) --- # Recenze produktů Recenze produktů jsou komentáře zákazníků k produktu. Recenze mohou obsahovat také hodnocení. Ve veřejné části obchodu se recenze zobrazují na stránce s podrobnostmi produktu. Zákazníci mohou psát recenze k různým produktům. Poté, co je recenze napsána a schválena majitelem obchodu, mohou ostatní zákazníci určit, zda je recenze užitečná, či nikoli, kliknutím na *Ano* nebo *Ne* vedle recenze. > [!NOTE] > > Ve výchozím stavu musí recenze schválit majitel obchodu, než se objeví ve veřejné části obchodu. Pokud se však majitel obchodu rozhodne, že recenze schvalovat nemusí, lze toto výchozí chování změnit. Chcete-li povinné schvalování recenzí produktů vypnout, přejděte do **Konfigurace → Nastavení → Nastavení katalogu** (Configuration → Settings → Catalog settings) a zrušte zaškrtnutí možnosti **Recenze produktů musí být schváleny** (Product reviews must be approved). ## Správa recenzí produktů Chcete-li spravovat recenze produktů, přejděte do **Katalog → Recenze produktů** (Catalog → Product reviews). Zobrazí se okno *Recenze produktů*: ![Správa recenzí produktů](_static/product-reviews/product_reviews2.png) ### Vyhledávání recenzí Recenze můžete vyhledávat podle: - Časového rozmezí pomocí polí **Vytvořeno od** (Created from) a **Vytvořeno do** (Created to). Do polí Vytvořeno od a Vytvořeno do zadejte časové rozmezí pro vyhledávání. Případně můžete kliknout na rozbalovací kalendář a vybrat požadované rozmezí. - **Zprávy** (Message). Lze použít k nalezení recenze podle názvu nebo fragmentu textu. - **Schváleno** (Approved). Lze použít k nalezení recenze podle vlastnosti „Schváleno“. - **Produktu** (Product). Seřadí a zobrazí recenze související s konkrétním produktem. - **Obchodu** (Store). Umožňuje zobrazit všechny recenze produktů konkrétního obchodu. Toto pole se zobrazuje, pokud máte více než jeden obchod. ### Schválení nebo zamítnutí Vyberte recenze, které chcete schválit nebo zamítnout, a klikněte na tlačítko **Schválit vybrané** (Approve selected), případně **Zamítnout vybrané** (Disapprove selected). ## Úprava recenzí produktů Chcete-li upravit recenzi produktu, klikněte na **Upravit** (Edit) vedle recenze. Zobrazí se okno *Upravit podrobnosti recenze produktu* (Edit product review details): ![Úprava recenzí produktů](_static/product-reviews/edit_product_review_details.png) - Uvidíte **Produkt** (Product), ke kterému byla recenze přidána. Po kliknutí na toto pole budete přesměrováni do okna úpravy podrobností produktu, kde můžete podrobnosti produktu upravit. - Uvidíte **Obchod** (Store), ve kterém byla recenze napsána. - A **Zákazníka** (Customer), který recenzi vytvořil. Po kliknutí na toto pole budete přesměrováni do okna úpravy podrobností zákazníka, kde můžete údaje upravit. - Můžete upravit **Název** (Title) recenze. - A její **Text**. - V poli **Text odpovědi** (Reply text) můžete na recenzi odpovědět; odpověď bude viditelná ve veřejné části obchodu pod recenzí. - **Hodnocení** (Rating) zobrazuje hodnocení zákazníka. Nelze jej upravit. - Zaškrtnutím políčka **Je schváleno** (Is approved) recenzi schválíte. - **Vytvořeno** (Created on) zobrazuje datum a čas vytvoření recenze. ## Typy recenzí Pokud jste vytvořili vlastní typy recenzí, uvidíte panel *Typy recenzí* (Review types): ![Typy recenzí](_static/product-reviews/review-types.jpg) V této oblasti si můžete prohlédnout všechny doplňkové recenze aktuálního produktu. **Hodnocení** (Rating) zobrazuje hodnocení zákazníka. Žádné sloupce v tabulce nelze upravovat. Více informací o nastavení recenzí najdete v kapitolách [Recenze produktů](xref:cs/running-your-store/catalog/catalog-settings#product-reviews) a [Typy recenzí](xref:cs/running-your-store/catalog/catalog-settings#review-types). ## Výukové materiály - [Správa recenzí produktů](https://www.youtube.com/watch?v=TBOpCoEAMnU&feature=youtu.be) - [Správa typů recenzí produktů](https://youtu.be/Ts7_T9sd1Do) --- # Kategorie Před přidáním nových produktů by měl správce obchodu vytvořit kategorie, ke kterým tyto produkty později přiřadí. Kategorie spravujete v **Katalog → Kategorie** (Catalog → Categories). ![Kategorie](_static/categories/categories.jpg) Kategorii můžete vyhledat na panelu *Hledat* (Search) zadáním **Názvu kategorie** (Category name) nebo jeho části, podle vlastnosti **Publikováno** (Published) nebo mezi všemi kategoriemi určitého **Obchodu** (Store) (pokud je povoleno více obchodů). > [!NOTE] > > Chcete-li kategorie ze seznamu odebrat, vyberte položky, které chcete smazat, a klikněte na tlačítko **Smazat (vybrané)** (Delete (selected)). > Kategorie můžete kliknutím na tlačítko **Export** exportovat do externího souboru pro účely zálohy. Po kliknutí na tlačítko **Export** se zobrazí rozbalovací nabídka, která umožňuje **Exportovat do XML** (Export to XML) nebo **Exportovat do Excelu** (Export to Excel). ## Přidání nové kategorie Chcete-li přidat novou kategorii, klikněte na tlačítko **Přidat nový** (Add new) v horní části stránky. Zobrazí se okno *Přidat novou kategorii*. ![Přidat novou kategorii](_static/categories/add-new.png) Tato stránka je k dispozici ve dvou režimech: **rozšířeném** a **základním**. Přepněte se do základního režimu, který zobrazuje pouze hlavní pole, nebo použijte rozšířený režim, který zobrazuje všechna dostupná pole. ### Informace o kategorii Na panelu *Informace o kategorii* (Category info) definujte následující informace o kategorii: - **Název** (Name) – název kategorie zobrazený v katalogu. - **Popis** (Description) – popis kategorie. K úpravě rozvržení a písma použijte editor. - Pokud je tato kategorie podkategorií, vyberte z rozbalovacího seznamu **Nadřazenou kategorii** (Parent category). Nová kategorie bude ve veřejné části obchodu umístěna pod touto kategorií. - **Obrázek** (Picture) – obrázek představující kategorii. Nahrajte obrázek ze svého zařízení. - **Omezit pro dodavatele** (Restrict from vendors) – zaškrtnutím zabráníte dodavatelům přidávat do této kategorie produkty. Tato možnost je užitečná, pokud máte v obchodě povoleno více dodavatelů. Po povolení dodavatelé tuto kategorii neuvidí na stránkách „Přidat produkt“ ani „Upravit produkt“ v administraci. ### Zobrazení ![Zobrazení](_static/categories/display.png) Na panelu *Zobrazení* (Display) definujte následující informace o kategorii: - Zaškrtnutím políčka **Publikováno** (Published) bude kategorie viditelná ve veřejné části obchodu. - Zaškrtnutím políčka **Zobrazit na domovské stránce** (Show on home page) se kategorie zobrazí na domovské stránce. - Zaškrtnutím políčka **Zahrnout do horního menu** (Include in top menu) se kategorie zahrne do horního menu na domovské stránce. - Zaškrtnutím políčka **Povolit zákazníkům zvolit velikost stránky** (Allow customers to select page size) umožníte zákazníkům zvolit velikost stránky, tedy počet produktů zobrazených na stránce s detailem kategorie. Velikost stránky mohou zákazníci vybrat ze seznamu velikostí stránky, který majitel obchodu zadal do pole **Možnosti velikosti stránky** (Page size options). - Je-li předchozí políčko zaškrtnuto, zobrazí se **Možnosti velikosti stránky** (Page size options). Zadejte čárkami oddělený seznam možností velikosti stránky (například 10, 5, 15, 20). Pokud není vybrána žádná, je výchozí velikostí stránky první možnost. - Pokud políčko **Povolit zákazníkům zvolit velikost stránky** není zaškrtnuto, zobrazí se možnost **Velikost stránky** (Page size). Ta nastavuje velikost stránky pro produkty v této kategorii, například „4“ produkty na stránku. > [!TIP] > > Pokud například do kategorie přidáte sedm produktů a nastavíte její velikost stránky na tři, zobrazí se na stránce s detailem této kategorie ve veřejné části obchodu tři produkty na stránku a celkový počet stránek bude tři. - Zaškrtněte políčko **Filtrování podle cenového rozpětí** (Price range filtering), pokud chcete povolit filtrování podle cenového rozpětí. - Pokud chcete cenové rozpětí zadat ručně, zaškrtněte políčko **Zadat cenové rozpětí ručně** (Enter price range manually). - Je-li výše uvedené nastavení povoleno, zadejte **Cenu „od“** (Price 'from'). - A **Cenu „do“** (Price 'to'). - **Pořadí zobrazení** (Display order) – pořadové číslo pro zobrazení kategorie. Toto číslo se používá k řazení kategorií ve veřejné části obchodu (vzestupně). Kategorie s pořadím zobrazení 1 bude umístěna na začátku seznamu. - Pole **Šablona kategorie** (Category template) je viditelné, pokud máte na stránce **Systém → Šablony** (System → Templates) nainstalované vlastní šablony kategorií. Tato šablona určuje, jak se bude tato kategorie (a její produkty) zobrazovat. ### Mapování ![Mapování](_static/categories/mappings.jpg) Na panelu *Mapování* (Mappings) definujte následující informace o kategorii: - **Slevy** (Discounts) – vyberte slevy spojené s touto kategorií. Slevy můžete vytvořit na stránce **Propagace → Slevy** (Promotions → Discounts). Více o slevách se dočtete v kapitole [Slevy](xref:cs/running-your-store/promotional-tools/discounts). > [!NOTE] > > Upozorňujeme, že zde jsou viditelné pouze slevy typu *přiřazeno ke kategoriím*. Po namapování slev na kategorii se uplatní na všechny produkty v této kategorii. > > [!NOTE] > > Chcete-li používat slevy, ujistěte se, že je nastavení **Ignorovat slevy (v celém webu)** (Ignore discounts (sitewide)) vypnuto na panelu **Konfigurace → Nastavení → Nastavení katalogu → Výkon** (Configuration → Settings → Catalog settings → Performance). - V poli **Omezeno na role zákazníků** (Limited to customer roles) vyberte role zákazníků, které budou moci kategorii v katalogu vidět. Pokud tuto možnost nepotřebujete a kategorii mohou vidět všichni, ponechte pole prázdné. > [!NOTE] > > Abyste mohli tuto funkci používat, musíte vypnout následující nastavení: **Konfigurace → Nastavení katalogu → Ignorovat pravidla ACL (v celém webu)** (Configuration → Catalog settings → Ignore ACL rules (sitewide)). Více o [seznamu řízení přístupu](xref:cs/running-your-store/customer-management/access-control-list). - Pokud se kategorie prodává jen v určitých obchodech, vyberte je v poli **Omezeno na obchody** (Limited to stores). Pokud tuto funkci nepotřebujete, ponechte pole prázdné. > [!NOTE] > > Abyste mohli tuto funkci používat, musíte vypnout následující nastavení: **Nastavení katalogu → Ignorovat pravidla „omezení na obchod“ (v celém webu)** (Catalog settings → Ignore "limit per store" rules (sitewide)). Více o [funkci více obchodů](xref:cs/getting-started/advanced-configuration/multi-store). ### SEO ![Nastavení SEO](_static/categories/setting-up-seo.png) Na panelu *SEO* definujte následující podrobnosti: - **Název stránky přátelský k vyhledávačům** (Search engine friendly page name) – název stránky používaný vyhledávači. Pokud pole ponecháte prázdné, URL stránky kategorie se vytvoří z názvu kategorie. Pokud zadáte custom-seo-page-name, použije se následující vlastní URL: `http://www.yourStore.com/custom-seo-page-name`. - **Meta titulek** (Meta title) určuje titulek webové stránky. Jde o kód vložený do hlavičky webové stránky: ```html Creating Title Tags for Search Engine Optimization & Web Usability ``` - **Meta klíčová slova** (Meta keywords) – meta klíčová slova kategorie, která představují stručný a výstižný seznam nejdůležitějších témat stránky. Značka meta keywords vypadá takto: `` - **Meta popis** (Meta description) – popis kategorie. Značka meta description je stručné a výstižné shrnutí obsahu stránky. Značka meta description vypadá takto: `` Kliknutím na tlačítko **Uložit a pokračovat v úpravách** (Save and continue edit) přejdete k přidávání produktů do kategorie. ### Produkty Panel *Produkty* (Products) obsahuje seznam produktů souvisejících s vybranou kategorií. Tyto produkty lze v katalogu filtrovat podle kategorie. Majitel obchodu může do kategorie přidávat nové produkty. Upozorňujeme, že před přidáním produktů je nutné kategorii uložit. Kliknutím na **Přidat nový produkt** (Add a new product) vyhledejte produkt, který chcete do této kategorie zahrnout. Vyhledávat můžete podle **Názvu produktu** (Product name), **Kategorie** (Category), **Dodavatele** (Vendor), **Obchodu** (Store), **Typu produktu** (Product type) a **Výrobce** (Manufacturer). ![Přidat produkty](_static/categories/add-product.jpg) Vyberte produkty, které chcete do kategorie přidat, a klikněte na tlačítko **Uložit** (Save). Produkty se zobrazí ve vybrané kategorii. ![Produkty](_static/categories/products.png) Po přidání produktu do kategorie definujte v tabulce *Produkty* kliknutím na tlačítko **Upravit** (Edit) vedle produktu následující informace: - **Je doporučený produkt** (Is featured product). - **Pořadí zobrazení** (Display order). > [!NOTE] > > Kliknutím na **Zobrazit** (View) budete přesměrováni na stránku *Upravit podrobnosti produktu*. Klikněte na **Uložit** (Save). Nová kategorie se zobrazí ve veřejné části obchodu pod svou nadřazenou kategorií. ## Import kategorií Pokud nechcete přidávat všechny kategorie do katalogu ručně, můžete použít možnost importu. > [!NOTE] > > Před zahájením importu byste si měli stáhnout šablonu tabulky pro import ve formátu Excel. Pro přesný a správný import kategorií je zásadní správně pojmenovat všechny sloupce tabulky (přesně jako ve stažené tabulce). Není nutné vyplnit všechna pole tabulky. Kategorie se vytvoří na základě vyplněných polí. Import vyžaduje mnoho paměťových prostředků. Proto se nedoporučuje importovat více než 500–1000 záznamů najednou. Pokud máte záznamů více, je lepší je rozdělit do několika souborů Excel a importovat je samostatně. ## Viz také - [Přidání produktů](xref:cs/running-your-store/catalog/products/add-products) - [SEO](xref:cs/running-your-store/search-engine-optimization) --- # Výrobci Výrobce spravujete v **Katalog → Výrobci** (Catalog → Manufacturers). ![Výrobci](_static/manufacturers/manufactures.jpg) Výrobce můžete vyhledat na panelu *Hledat* zadáním **Názvu výrobce** (Manufacturer name) nebo jeho části, podle vlastnosti **Publikováno** (Published) nebo mezi všemi výrobci určitého **Obchodu** (Store) (pokud je povoleno více obchodů). > [!NOTE] > > Chcete-li výrobce ze seznamu odebrat, vyberte položky ke smazání a klikněte na tlačítko **Smazat (vybrané)** (Delete (selected)). > Výrobce můžete pro účely zálohování exportovat do externího souboru kliknutím na tlačítko **Export**. Po kliknutí na tlačítko **Export** se zobrazí rozbalovací nabídka s možnostmi **Exportovat do XML** (Export to XML) nebo **Exportovat do Excelu** (Export to Excel). ## Přidání nového výrobce Chcete-li přidat nového výrobce, klikněte na tlačítko **Přidat nový** (Add new) v horní části stránky. Zobrazí se okno *Přidat nového výrobce*. ![Přidat nového výrobce](_static/manufacturers/add_a_new_manufacturer.png) Tato stránka je dostupná ve dvou režimech: **rozšířeném** a **základním**. Přepněte do základního režimu, který zobrazuje pouze hlavní pole, nebo použijte rozšířený režim, který zobrazuje všechna dostupná pole. ### Informace o výrobci Na panelu *Informace o výrobci* (Manufacturer info) definujte následující údaje: - **Název** (Name) — název výrobce zobrazovaný v katalogu. - **Popis** (Description) — popis výrobce. K úpravě rozvržení a písma použijte editor. - **Obrázek** (Picture) — obrázek představující výrobce. Nahrajte obrázek ze svého zařízení. ### Zobrazení ![Zobrazení](_static/manufacturers/display2.png) Na panelu *Zobrazení* (Display) definujte následující údaje: - Zaškrtněte políčko **Publikováno** (Published), aby byl výrobce viditelný ve veřejné části obchodu. - Zaškrtněte políčko **Povolit zákazníkům zvolit velikost stránky** (Allow customers to select page size), aby si zákazníci mohli zvolit velikost stránky, tj. počet produktů zobrazených na stránce podrobností výrobce. Zákazníci mohou velikost stránky vybrat ze seznamu velikostí stránky, který majitel obchodu zadá do pole **Možnosti velikosti stránky** (Page size options). - Pokud je předchozí políčko zaškrtnuté, zobrazí se pole **Možnosti velikosti stránky** (Page size options). Zadejte čárkami oddělený seznam možností velikosti stránky (například 10, 5, 15, 20). Pokud není vybrána žádná, je výchozí velikostí stránky první možnost. - Pokud políčko **Povolit zákazníkům zvolit velikost stránky** není zaškrtnuté, zobrazí se možnost **Velikost stránky** (Page size). Nastavuje velikost stránky pro produkty tohoto výrobce, například 4 produkty na stránku. > [!TIP] > > Pokud například k výrobci přidáte sedm produktů a nastavíte velikost stránky na tři, zobrazí se na stránce podrobností tohoto výrobce ve veřejné části obchodu tři produkty na stránku a celkový počet stránek bude tři. - Zaškrtněte políčko **Filtrování podle cenového rozpětí** (Price range filtering), pokud chcete povolit filtrování podle cenového rozpětí. - Pokud chcete cenové rozpětí zadávat ručně, zaškrtněte políčko **Zadat cenové rozpětí ručně** (Enter price range manually). - Je-li výše uvedené nastavení povoleno, zadejte **Cenu „od“** (Price 'from'). - A **Cenu „do“** (Price 'to'). - **Pořadí zobrazení** (Display Order) — pořadové číslo pro zobrazení výrobce. Toto číslo se používá k řazení výrobců ve veřejné části obchodu (vzestupně). Výrobce s pořadím zobrazení 1 bude umístěn na začátku seznamu. - Pole **Šablona výrobce** (Manufacturer template) je viditelné, pokud máte na stránce **Systém → Šablony** (System → Templates) nainstalovány vlastní šablony výrobců. Tato šablona určuje, jak se bude tento výrobce (a jeho produkty) zobrazovat. ### GPSR Na panelu *GPSR* definujte následující údaje: - **Fyzická adresa** (Physical address) — fyzická adresa výrobce. Toto pole je povinné pro produkty prodávané v EU, aby byl splněn obecný předpis EU o bezpečnosti výrobků (nařízení (EU) 2023/988). - **Elektronická adresa** (Electronic address) — elektronická adresa (např. e-mail) výrobce pro účely kontaktu. - **Jméno odpovědné osoby** (Responsible person name) — jméno fyzické nebo právnické osoby usazené v EU, která odpovídá za zajištění souladu s požadavky GPSR. Je povinné, pokud výrobce není usazen v EU. - **Fyzická adresa odpovědné osoby** (Responsible person physical address) — fyzická adresa odpovědné osoby. - **Elektronická adresa odpovědné osoby** (Responsible person electronic address) — elektronická adresa (např. e-mail) odpovědné osoby pro účely kontaktu. ![GPSR](_static/manufacturers/gpsr.png) > [!NOTE] > > GPSR (obecné nařízení o bezpečnosti výrobků) vyžaduje, aby každá nabídka produktu v EU obsahovala jasnou identifikaci a kontaktní údaje výrobce. Pokud výrobce není usazen v EU, musí být určena odpovědná osoba se sídlem v EU, kterou mohou spotřebitelé a úřady kontaktovat ve věci bezpečnosti produktu. ### Přiřazení ![Přiřazení](_static/manufacturers/mappings.png) Na panelu *Přiřazení* (Mappings) definujte následující údaje: - **Slevy** (Discounts) — vyberte slevy spojené s tímto výrobcem. Slevy můžete vytvořit na stránce **Propagace → Slevy** (Promotions → Discounts). Více o slevách si přečtěte v kapitole [Slevy](xref:cs/running-your-store/promotional-tools/discounts). > [!NOTE] > > Upozorňujeme, že zde jsou viditelné pouze slevy typu *přiřazené k výrobcům*. Po přiřazení slev k výrobci budou uplatněny na všechny produkty tohoto výrobce. > > [!NOTE] > > Pokud chcete slevy používat, ujistěte se, že je na panelu **Konfigurace → Nastavení → Nastavení katalogu → Výkon** (Configuration → Settings → Catalog settings → Performance) zakázáno nastavení **Ignorovat slevy (pro celý web)** (Ignore discounts (sitewide)). - V poli **Omezeno na role zákazníků** (Limited to customer roles) vyberte role zákazníků, které budou moci výrobce v katalogu vidět. Pokud tuto možnost nepotřebujete, ponechte pole prázdné a výrobce uvidí všichni. > [!NOTE] > > Abyste mohli tuto funkci používat, musíte zakázat následující nastavení: **Konfigurace → Nastavení katalogu → Ignorovat pravidla ACL (pro celý web)** (Configuration → Catalog settings → Ignore ACL rules (sitewide)). Více o [seznamu řízení přístupu si přečtěte zde](xref:cs/running-your-store/customer-management/access-control-list). - V poli **Omezeno na obchody** (Limited to stores) vyberte obchody, pokud se produkty výrobce prodávají pouze v konkrétních obchodech. Pokud tuto funkci nepotřebujete, ponechte pole prázdné. > [!NOTE] > > Abyste mohli tuto funkci používat, musíte zakázat následující nastavení: **Nastavení katalogu → Ignorovat pravidla „omezení na obchod“ (pro celý web)** (Catalog settings → Ignore "limit per store" rules (sitewide)). Více o [funkci více obchodů si přečtěte zde](xref:cs/getting-started/advanced-configuration/multi-store). ### SEO ![SEO](_static/manufacturers/SEO.png) Na panelu *SEO* definujte následující údaje: - **Název stránky vhodný pro vyhledávače** (Search engine friendly page name) — název stránky používaný vyhledávači. Pokud pole ponecháte prázdné, URL stránky výrobce se vytvoří z názvu výrobce. Pokud zadáte custom-seo-page-name, použije se následující vlastní URL: `http://www.yourStore.com/custom-seo-page-name`. - **Meta titulek** (Meta title) určuje titulek webové stránky. Jde o kód vložený do hlavičky vaší webové stránky: ```html Creating Title Tags for Search Engine Optimization & Web Usability ``` - **Meta klíčová slova** (Meta keywords) — meta klíčová slova výrobce, která představují stručný a výstižný seznam nejdůležitějších témat stránky. Značka meta keywords vypadá takto: `` - **Meta popis** (Meta description) — popis výrobce. Značka meta description je stručné a výstižné shrnutí obsahu stránky. Značka meta description vypadá takto: `` Kliknutím na tlačítko **Uložit a pokračovat v úpravách** (Save and continue edit) pokračujte k přidání produktů k výrobci. ### Produkty Panel *Produkty* (Products) obsahuje seznam produktů souvisejících s vybraným výrobcem; tyto produkty lze v katalogu filtrovat podle výrobce. Majitel obchodu může k výrobci přidávat nové produkty. Upozorňujeme, že před přidáním produktů je nutné výrobce uložit. Kliknutím na **Přidat nový produkt** (Add a new product) vyhledejte produkt, který chcete k tomuto výrobci přidat. Vyhledávat můžete podle **Názvu produktu** (Product name), **Kategorie** (Category), **Dodavatele** (Vendor), **Obchodu** (Store), **Typu produktu** (Product type) a **Výrobce** (Manufacturer). ![Přidat produkty](_static/manufacturers/add-product.jpg) Vyberte produkty, které chcete k výrobci přidat, a klikněte na tlačítko **Uložit** (Save). Produkt se zobrazí u vybraného výrobce. ![products2](_static/manufacturers/products2.png) Po přidání produktu k výrobci definujte v tabulce *Produkty* kliknutím na tlačítko **Upravit** (Edit) vedle produktu následující informace: - **Je doporučený produkt** (Is featured product). - **Pořadí zobrazení** (Display order). > [!NOTE] > > Kliknutím na **Zobrazit** (View) budete přesměrováni na stránku *Upravit podrobnosti produktu*. Klikněte na **Uložit** (Save). ## Import výrobců Pokud nechcete přidávat všechny výrobce do katalogu ručně, můžete použít možnost importu. > [!NOTE] > > Před zahájením importu byste si měli stáhnout šablonu tabulky pro import ve formátu Excel. Pro přesný a správný import výrobců je zásadní správně pojmenovat všechny sloupce tabulky (přesně jako ve stažené tabulce). Není nutné vyplňovat všechna pole tabulky. Výrobce bude vytvořen na základě vyplněných polí. Import vyžaduje velké množství paměťových prostředků. Proto se nedoporučuje importovat více než 500–1000 záznamů najednou. Pokud máte více záznamů, je lepší je rozdělit do více souborů Excel a importovat je samostatně. ## Viz také - [Přidávání produktů](xref:cs/running-your-store/catalog/products/add-products) - [SEO](xref:cs/running-your-store/search-engine-optimization) ## Návody - [Správa výrobců v nopCommerce](https://www.youtube.com/watch?v=NnWD9-zi8s4&feature=youtu.be) --- # Nastavení katalogu Nastavení katalogu zahrnují povolení možností řazení produktů, změnu režimů zobrazení, porovnávání produktů a další. Chcete-li definovat nastavení katalogu, přejděte do **Konfigurace → Nastavení → Nastavení katalogu** (Configuration → Settings → Catalog settings). Stránka nastavení katalogu je k dispozici v *pokročilém* a *základním* režimu (výchozí je pokročilý režim). Tato stránka umožňuje konfiguraci pro více obchodů; to znamená, že stejná nastavení lze definovat pro všechny obchody, nebo se mohou mezi obchody lišit. Chcete-li spravovat nastavení pro konkrétní obchod, vyberte jeho název z rozbalovacího seznamu konfigurace pro více obchodů a zaškrtněte vlevo všechna potřebná zaškrtávací políčka, abyste pro ně mohli nastavit vlastní hodnoty. Další podrobnosti naleznete v části [Více obchodů](xref:cs/getting-started/advanced-configuration/multi-store). ## Umělá inteligence Tato funkce integruje služby *umělé inteligence (AI)* přímo do platformy a automatizuje tvorbu popisů produktů a meta tagů pro optimalizaci pro vyhledávače (SEO), včetně meta titulku (Meta Title), meta popisu (Meta Description) a meta klíčových slov (Meta Keywords). Funkce je zabudována přímo do jádra aplikace a podporuje tři oblíbené poskytovatele služeb AI: - DeepSeek - Gemini - ChatGPT > [!NOTE] > > Aktivní může být vždy pouze jeden poskytovatel. Všechna související nastavení naleznete na stránce *Nastavení katalogu* v sekci **Umělá inteligence** (Artificial Intelligence). ![AI](_static/catalog-settings/ai_settings.png) Mezi klíčové možnosti konfigurace patří: - **Povolit umělou inteligenci** (Enable artificial intelligence): Můžete zapnout nebo vypnout celou funkci generování pomocí AI. Nezávisle na tom můžete také zapnout nebo vypnout generování SEO polí. - **Typ poskytovatele** (Provider type): Rozbalovací nabídka umožňuje vybrat, který ze tří podporovaných poskytovatelů AI bude použit pro generování obsahu. - **Šablony promptů – dotaz AI pro generování[..]** (Prompt Templates - AI query to generate[..]): Šablony všech požadavků API odesílaných službě AI lze upravovat. Pokročilí uživatelé si tak mohou prompty přizpůsobit a doladit tak, aby lépe vyhovovaly jejich konkrétním potřebám. ### Generování popisů produktů 1. Přejděte na stránku úpravy produktu. Tlačítko **„Generovat popis pomocí AI“** (Generate description with AI) se nachází přímo pod editorem popisu produktu. ![AI](_static/catalog-settings/ai_product_description.png) 1. Kliknutím na tlačítko se otevře okno konfigurace. ![AI](_static/catalog-settings/ai_product_description_generate.png) Zde můžete upravit parametry, které budou odeslány službě AI pro vygenerování popisu. Následující pole jsou povinná: - **Název produktu** (Product name) - **Cílový jazyk** (Target language) - **Vlastnosti a klíčová slova** (Features and keywords) - **Tón komunikace** (Tone of voice) - Můžete také zadat libovolné **Zvláštní pokyny** (Special instructions), které AI usměrní. 1. Kliknutím na tlačítko **„Generovat popis pomocí AI“** ve vyskakovacím okně odešlete požadavek. - Při úspěchu: Vygenerovaný text se zobrazí v okně. Poté jej můžete **Uložit** (Save) přímo do pole popisu produktu nebo **Kopírovat do schránky** (Copy to the clipboard). Pokud nejste s výsledkem spokojeni, můžete znovu kliknout na tlačítko „Generovat“ a získat novou verzi. ![AI](_static/catalog-settings/ai_product_description_generated.png) - Při selhání: Pokud během generování dojde k chybě, místo textu se zobrazí chybová zpráva, často včetně odkazu na soubor protokolu pro řešení problémů. ![AI](_static/catalog-settings/ai_product_description_generated_fail.png) ### Generování SEO meta tagů 1. V sekci SEO na stránce úpravy produktu obsahuje každý blok meta tagů tlačítko **„Generovat meta tagy pomocí AI“** (Generate meta tags with AI). ![AI](_static/catalog-settings/ai_product_seo.png) 1. Kliknutím na toto tlačítko se automaticky vygeneruje obsah pro všechna SEO pole, která jsou: - V nastavení povolena pro generování. - Aktuálně prázdná (nástroj nepřepíše existující, ručně zadaná data). > [!IMPORTANT] > > Pokud změníte pole, která slouží jako základ pro generování (např. název produktu nebo krátký popis), a neuložíte je, systém vás před odesláním požadavku službě AI vyzve k uložení změn. > > ![AI](_static/catalog-settings/ai_product_seo_alert.png) ## Nastavení vyhledávání ![Vyhledávání](_static/catalog-settings/search.jpg) Horní panel stránky nastavuje *Vyhledávání* (Search): - Zaškrtněte políčko **Vyhledávání povoleno** (Search enabled), pokud chcete, aby byla ve veřejném obchodě povolena funkce vyhledávání. - Zaškrtněte políčko **Automatické doplňování vyhledávání povoleno** (Search autocomplete enabled), aby se ve veřejném obchodě zobrazovalo vyhledávací pole s automatickým doplňováním takto: ![Vyhledávání](_static/catalog-settings/search.png) Když je tato možnost povolena, zobrazí se následující další pole: - **Počet zobrazovaných produktů při automatickém doplňování** (Number of 'autocomplete' products to display) nastavuje počet výsledků, které budou viditelné v rozbalovacím seznamu automatického doplňování vyhledávacího pole ve veřejném obchodě. - Zaškrtněte políčko **Zobrazit v poli automatického doplňování odkaz na všechny výsledky vyhledávání** (Show a link to all search results in the autocomplete box), aby se v poli automatického doplňování zobrazoval odkaz na všechny výsledky. Zobrazí se, pokud je počet nalezených položek větší než počet zobrazený v poli automatického doplňování. - Zaškrtněte políčko **Zobrazit obrázky produktů v poli automatického doplňování** (Show product images in autocomplete box), aby se ve vyhledávacím poli s automatickým doplňováním zobrazovaly obrázky produktů. - **Minimální délka hledaného výrazu** (Search term minimum length) je minimální počet znaků potřebných pro vyhledávání. - Zaškrtněte políčko **Stránka vyhledávání. Povolit zákazníkům zvolit velikost stránky** (Search page. Allow customers to select page size), pokud chcete zákazníkům umožnit vybrat velikost stránky z předdefinovaného seznamu možností. - Do pole **Stránka vyhledávání. Možnosti velikosti stránky** (Search page. Page size options) zadejte čárkami oddělený seznam možností velikosti stránky pro zákazníky, tedy počtu produktů, které chcete zobrazit na stránce vyhledávání produktů. - Pokud je nastavení **Stránka vyhledávání. Povolit zákazníkům zvolit velikost stránky** vypnuto, zobrazí se pole **Stránka vyhledávání. Produktů na stránku** (Search page. Products per page). Do tohoto pole zadejte počet produktů, které chcete zobrazit na stránce vyhledávání. - Zaškrtněte políčko **Stránka vyhledávání. Filtrování podle cenového rozpětí** (Search page. Price range filtering), pokud chcete povolit filtrování podle cenového rozpětí. - Pokud chcete cenové rozpětí zadávat ručně, zaškrtněte políčko **Stránka vyhledávání. Zadat cenové rozpětí ručně** (Search page. Enter price range manually). - Pokud je výše uvedené nastavení povoleno, zadejte **Stránka vyhledávání. Cena „od“** (Search page. Price 'from'). - A **Stránka vyhledávání. Cena „do“** (Search page. Price 'to'). - Pokud je povoleno **Povolit zákazníkům vyhledávat podle názvu výrobce** (Allow customers to search with manufacturer name), mohou zákazníci vyhledávat podle názvu výrobce. - Pokud je povoleno **Povolit zákazníkům vyhledávat podle názvu kategorie** (Allow customers to search with category name), mohou zákazníci vyhledávat podle názvu kategorie. > [!NOTE] > > Standardní vyhledávání v nopCommerce se spoléhá na přesné shody, proto pokud chcete zvýšit rychlost a relevanci vyhledávání na svém webu, doporučujeme použít fulltextové vyhledávání (Full-text Search). Na rozdíl od standardního vyhledávání analyzuje fulltextové vyhledávání celý obsah webu a vrací nejrelevantnější výsledky. Automatické doplňování a tolerance překlepů optimalizují rychlost vyhledávání a pomáhají uživatelům najít přesně to, co potřebují. > > [Další informace](xref:cs/running-your-store/catalog/catalog-settings/full-text-search/index) ## Recenze produktů ![Recenze produktů](_static/catalog-settings/product-reviews.jpg) Druhý panel nastavuje *Recenze produktů* (Product reviews). Definujte následující: - **Recenze produktů musí být schváleny** (Product reviews must be approved) – recenze produktů musí před zveřejněním schválit administrátor obchodu. - **Jedna recenze produktu od zákazníka** (One review per product from customer) – zákazník může k jednomu produktu přidat pouze 1 recenzi. - **Povolit anonymním uživatelům psát recenze produktů** (Allow anonymous users to write product reviews) – umožní anonymním uživatelům psát recenze produktů. - **Recenze produktu možná pouze po jeho zakoupení** (Product review possible only after product purchasing) – produkt mohou recenzovat pouze zákazníci, kteří si jej již objednali. - **Upozorňovat na nové recenze produktů** (Notify about new product reviews) – upozorní majitele obchodu na nové veřejné recenze. - **Upozornit zákazníka na odpověď na recenzi produktu** (Notify customer about product review reply) – upozorní zákazníka na odpověď na jeho recenzi produktu. - **Recenze podle obchodu** (Reviews per store) – zobrazuje pouze recenze aktuálního obchodu (na stránce detailu produktu). Zrušte zaškrtnutí tohoto políčka, pokud chcete, aby zákazníci viděli recenze produktu napsané ve všech vašich obchodech. - **Zobrazit záložku recenzí produktů na stránce „Můj účet“** (Show product reviews tab on 'My account' page) – umožní zákazníkům zobrazit všechny jejich recenze na stránce „Můj účet“. - **Velikost stránky recenzí produktů** (Product reviews page size) je počet recenzí na stránku. - **Řadit vzestupně** (Sort by ascending) – řadí recenze produktů podle data vytvoření vzestupně. ## Typy recenzí Další blok nastavuje *Typy recenzí* (Review types). Pokud se domníváte, že základní recenze nestačí, můžete nakonfigurovat seznam typů recenzí. ![Typy recenzí](_static/catalog-settings/review_types.png) Kliknutím na tlačítko **Přidat nový** (Add new) vytvoříte nový typ recenze. ![Hodnocení kvality](_static/catalog-settings/quality_rating.png) Definujte následující: - Zadejte **Název** (Name) typu recenze. - Zadejte **Popis** (Description) typu recenze. - Definujte **Pořadí zobrazení** (Display order). - Pokud je zaškrtnuto **Povinné** (Required), musí zákazníci před pokračováním zvolit odpovídající hodnotu hodnocení. - **Viditelné pro všechny zákazníky** (Visible to all customers) nastavuje viditelnost typu recenze pro všechny zákazníky. Kliknutím na tlačítko **Uložit** (Save) přidáte nový typ recenze. Zákazníci nyní budou moci na stránce recenze produktu ve veřejném obchodě vyplnit další hodnocení. ![Recenze produktů](_static/catalog-settings/product_reviews.png) Na této stránce můžete také vidět zpětnou vazbu zanechanou všemi zákazníky (pokud je toto nastavení aktivní). Na stránce osobního účtu zákazníka je také možné zobrazit všechny recenze, které k produktům zanechal. ![Můj účet](_static/catalog-settings/my_account.png) ## Výkon ![Výkon](_static/catalog-settings/performance.jpg) Další panel nastavuje *Výkon* (Performance). Povolení následujících nastavení může výrazně zlepšit výkon obchodu: - **Ignorovat pravidla ACL (v celém webu)** (Ignore ACL rules (sitewide)) vypne [pravidla ACL](xref:cs/running-your-store/customer-management/access-control-list) nakonfigurovaná pro entity. - **Ignorovat omezení podle obchodu (v celém webu)** (Ignore limit per store (sitewide)) umožňuje ignorovat pravidla omezení podle obchodů nakonfigurovaná pro entity. Toto nastavení se doporučuje povolit, pokud máte pouze jeden obchod nebo nemáte žádná omezení specifická pro obchod. Více o provozu více obchodů si přečtěte v části [Více obchodů](xref:cs/getting-started/advanced-configuration/multi-store). - **Ignorovat slevy (v celém webu)** (Ignore discounts (sitewide)). - **Ignorovat doporučené produkty (v celém webu)** (Ignore featured products (sitewide)). - **Ukládat ceny produktů do mezipaměti** (Cache product prices). Toto nastavení byste neměli povolovat, pokud používáte složité slevy, pravidla požadavků na slevy nebo slevové kódy (kupóny). ## Sdílení ![Sdílení](_static/catalog-settings/share.jpg) Možnosti sdílení v panelu *Sdílení* (Share) umožňují nastavit nakupujícím možnost sdílet produkty na jejich sociálních sítích. Možnosti se na stránkách produktů zobrazí jako malé ikony. Nastavení možností sdílení: - Zaškrtněte **Zobrazit tlačítko sdílení** (Show a share button), aby se na stránce detailu produktu zobrazovalo tlačítko sdílení. Když je toto pole zaškrtnuto, zobrazí se pole **Kód tlačítka sdílení** (Share button code). - Pole **Kód tlačítka sdílení** zobrazuje kód tlačítka stránky. > [!NOTE] > > Ve výchozím nastavení se používá služba ShareThis ([https://sharethis.com/](https://sharethis.com/)). Takto vypadají odkazy pro sdílení: ![Sdílení](_static/catalog-settings/zzz.png) - Zaškrtněte políčko **Funkce „Poslat příteli“ povolena** ('Email a friend' enabled), aby zákazníci mohli používat možnost „Poslat příteli“. - V případě potřeby zaškrtněte **Povolit anonymním uživatelům poslat příteli e-mail** (Allow anonymous users to email a friend). ## Porovnání produktů ![Porovnání produktů](_static/catalog-settings/compare-products.jpg) Možnost porovnání produktů umožňuje zákazníkům porovnávat různé nabídky podle jejich vlastností a cen, aby mohli učinit co nejlepší nákupní rozhodnutí. Blok *Porovnání produktů* (Compare products) nastavte takto: - Zaškrtněte políčko **Porovnání produktů povoleno** ('Compare products' enabled), aby zákazníci mohli ve vašem veřejném obchodě porovnávat produkty. Na stránkách produktů se zobrazí tlačítko *Přidat do porovnání* (Add to compare list). - Zaškrtněte políčko **Zahrnout krátký popis do porovnání produktů** (Include short description in compare products), aby se na stránce porovnání produktů zobrazovaly krátké popisy produktů. - Zaškrtněte políčko **Zahrnout úplný popis do porovnání produktů** (Include full description in compare products), aby se na stránce porovnání produktů zobrazovaly úplné popisy produktů. ![porovnání_produktů](_static/catalog-settings/compare_product.png) ## Další sekce ![Další sekce](_static/catalog-settings/additional-sections.jpg) Panel *Další sekce* (Additional sections) umožňuje nastavit následující možnosti: - Zaškrtněte políčko **Odebrat požadované produkty** (Remove required products), aby se požadovaný produkt automaticky odebral z košíku, když je odebrán hlavní produkt. - **Zobrazit nejprodávanější produkty na domovské stránce** (Show best sellers on home page) umožňuje zobrazit bestsellery na domovské stránce. - Pokud je předchozí políčko zaškrtnuto, budete moci zadat **Počet nejprodávanějších produktů na domovské stránce** (Number of best sellers on home page). - Zaškrtněte políčko **„Zákazníci také koupili“ povoleno** ('Products also purchased' enabled), aby zákazníci mohli zobrazit seznam produktů, které zakoupili také ti, kteří koupili výše uvedený produkt. - Když je předchozí možnost povolena, zobrazí se pole **Počet zobrazovaných produktů „Zákazníci také koupili“** (Number of also purchased products to display). Zde může majitel obchodu nastavit počet zobrazovaných produktů. - Zaškrtněte políčko **„Naposledy zobrazené produkty“ povoleno** ('Recently viewed products' enabled), aby zákazníci viděli produkty, které si ve vašem obchodě nedávno prohlíželi. - Do pole **Počet „Naposledy zobrazených produktů“** (Number of 'Recently viewed products') zadejte počet nedávno zobrazených produktů, které se mají zobrazit, když je předchozí políčko zaškrtnuto. - Zaškrtněte políčko **Stránka „Nové produkty“ povolena** ('New products' page enabled), pokud chcete, aby byla v obchodě povolena stránka „Nové produkty“. - Do pole **Stránka „Nové produkty“. Možnosti velikosti stránky** ('New products' page. Page size options) zadejte počet nedávno přidaných produktů, které se mají zobrazit, když je zaškrtnuto *Stránka „Nové produkty“ povolena*. - V případě potřeby zaškrtněte políčko **Zobrazit datum dostupnosti předobjednávky** (Display the date for a pre-order availability). ## Pole produktu ![Pole produktu](_static/catalog-settings/product-fields.jpg) V panelu *Pole produktu* (Product fields) můžete nastavit následující možnosti: - **Zobrazit SKU na stránce detailu produktu** (Show SKU on product details page). - **Zobrazit SKU na stránkách katalogu** (Show SKU on catalog pages). - **Zobrazit GTIN** (Show GTIN) ve veřejném obchodě. - **Zobrazit katalogové číslo výrobce** (Show manufacturer part number) ve veřejném obchodě. - **Zobrazit krátký popis na stránkách katalogu** (Show short description on catalog pages) ve veřejném obchodě. ## Stránka produktu ![Stránka produktu](_static/catalog-settings/product-page.jpg) V panelu *Stránka produktu* (Product page) můžete nastavit následující možnosti: - **Typ struktury URL produktu** (Product URL structure type). Možné hodnoty: - /Product - /Category/Product - /Manufacturer/Product - **Zobrazit ikonu „doprava zdarma“** (Show "free shipping" icon) u produktů, které mají tuto možnost povolenu. - **Povolit zobrazení stránky detailu nepublikovaného produktu** (Allow viewing of unpublished product details page). V tomto případě nebude ovlivněno SEO a vyhledávací roboti budou stránku indexovat, i když je produkt dočasně nepublikovaný a pro zákazníky neviditelný. Majitel obchodu má k nepublikovaným produktům přístup vždy. - Zaškrtněte políčko **Zpráva o ukončení prodeje u nepublikovaných produktů** (Discontinued message for unpublished products), aby se zobrazovala zpráva „prodej produktu byl ukončen“, když se zákazníci pokusí otevřít stránku detailu nepublikovaného produktu. - Vyberte **Typ zobrazení hodnoty atributu, když není skladem** (Display type for attribute value when out of stock). Pokud kombinace atributů není skladem, můžete ji zobrazit jako neaktivní nebo jako obvykle. > [!NOTE] > > Upozorňujeme, že u produktu by měla být povolena možnost **Povolit pouze existující kombinace atributů** (Allow only existing attribute combinations). ## Stránky katalogu ![Stránky katalogu](_static/catalog-settings/catalog-pages.jpg) Panel *Stránky katalogu* (Catalog pages) umožňuje nastavit: - **Povolit změnu režimu zobrazení** (Allow view mode changing) na stránkách kategorií a výrobců. - **Výchozí režim zobrazení** (Default view mode) – buď *Mřížka* (Grid), nebo *Seznam* (List). - **Zahrnout produkty z podkategorií** (Include products from subcategories) při zobrazení stránky detailu kategorie. - **Zobrazit počet různých produktů vedle každé kategorie** (Show number of distinct products beside each category) v navigační oblasti kategorií umístěné v levém sloupci veřejného obchodu. - V případě potřeby zapněte nastavení **Zobrazit počet různých produktů vedle každé kategorie**. - **Drobečková navigace kategorií povolena** (Category breadcrumb enabled). Zaškrtnutím povolíte cestu kategorií (drobečkovou navigaci). Jde o lištu v horní části obrazovky, která na stránkách produktů ukazuje, ve kterých kategoriích a podkategoriích byl produkt zobrazen. Každý dílčí prvek lišty je samostatným hypertextovým odkazem. - **Počet zobrazovaných výrobců** (Number of manufacturers to display) v navigačním bloku výrobců. - **Použít načítání produktů pomocí AJAX** (Use AJAX products loading) k asynchronnímu načítání produktů (platí pro „stránkování“, „filtrování“ a „režimy zobrazení“) na stránkách katalogu. - **Povolit filtrování podle výrobce** (Enable manufacturer filtering) povolí filtrování podle výrobce na stránkách katalogu. - **Povolit filtrování podle cenového rozpětí** (Enable price range filtering) povolí filtrování podle cenového rozpětí na stránkách katalogu. - **Povolit filtrování podle atributů specifikace** (Enable specification attribute filtering) na stránkách katalogu, pokud je to potřeba. Pokud je vypnuto, filtrování podle atributů specifikace se na stránkách katalogu nezobrazí, i když takové atributy máte vytvořeny. - **Zobrazit všechny obrázky na stránkách katalogu** (Display all pictures on catalog pages) – na stránkách katalogu bude možné prohlížet všechny obrázky produktu. - **Zobrazit ceny „Od“** (Display 'From' prices) – zaškrtnutím zobrazíte na stránkách katalogu ceny „Od“. Místo pevné základní ceny se zobrazí minimální možná cena produktu na základě úprav cen atributů a kombinací. Pokud je toto nastavení povoleno, doporučuje se povolit také nastavení „Ukládat ceny produktů do mezipaměti“. Mějte však na paměti, že to může ovlivnit výkon, pokud používáte některé složité slevy, pravidla požadavků na slevy apod. > [!TIP] > > Chcete-li na stránkách katalogu zobrazit krátký popis produktu, musíte aktivovat toto nastavení - `catalogsettings.showshortdescriptiononcatalogpages` ## Štítky ![Štítky](_static/catalog-settings/tags.jpg) V panelu *Štítky* (Tags) můžete definovat: - **Počet štítků produktů (oblak)** (Number of product tags (cloud)) — počet štítků, které se zobrazí v oblaku štítků. - **Povolit zákazníkům zvolit velikost stránky „Produkty podle štítku“** (Allow customers to select 'Products by tag' page size) na stránce štítku produktu ze seznamu možností předdefinovaných majitelem obchodu. Pokud je vypnuto, zákazníci nebudou moci velikost stránky zvolit a zadává ji majitel obchodu. - Pokud je předchozí možnost zaškrtnuta, zobrazí se pole **Možnosti velikosti stránky „Produkty podle štítku“** ('Products by tag' page size options). Můžete zadat hodnoty, které mohou uživatelé obchodu vybírat. Čísla oddělujte čárkami. První hodnota bude výchozí. - Pokud je nastavení **Povolit zákazníkům zvolit velikost stránky „Produkty podle štítku“** vypnuto, zobrazí se pole **Stránka „Produkty podle štítku“. Produktů na stránku** ('Products by tag' page. Products per page). Do tohoto pole zadejte počet produktů, které chcete zobrazit na stránce. - Zaškrtněte políčko **Stránka „Produkty podle štítku“. Filtrování podle cenového rozpětí** ('Products by tag' page. Price range filtering), pokud chcete povolit filtrování podle cenového rozpětí. - Pokud chcete cenové rozpětí zadávat ručně, zaškrtněte políčko **Stránka „Produkty podle štítku“. Zadat cenové rozpětí ručně** ('Products by tag' page. Enter price range manually). - Pokud je výše uvedené nastavení povoleno, zadejte **Stránka „Produkty podle štítku“. Cena „od“** ('Products by tag' page. Price 'from'). - A **Stránka „Produkty podle štítku“. Cena „do“** ('Products by tag' page. Price 'to'). ## Daň ![Daň](_static/catalog-settings/tax.jpg) V panelu *Daň* (Tax) jsou k dispozici některé možnosti informací o dani a dopravě specifické pro Německo: - **Zobrazit informace o dani/dopravě (zápatí)** (Display tax/shipping info (footer)). - **Zobrazit informace o dani/dopravě (stránka detailu produktu)** (Display tax/shipping info (product details page)). - **Zobrazit informace o dani/dopravě (boxy produktů)** (Display tax/shipping info (product boxes)). - **Zobrazit informace o dani/dopravě (nákupní košík)** (Display tax/shipping info (shopping cart)). - **Zobrazit informace o dani/dopravě (seznam přání)** (Display tax/shipping info (wishlist)). - **Zobrazit informace o dani/dopravě (stránka detailu objednávky)** (Display tax/shipping info (order details page)). ## Export/import ![Export/import](_static/catalog-settings/import-export.jpg) V panelu *Export/import* můžete definovat: - Zaškrtněte políčko **Export/import produktů s atributy** (Export/import products with attributes), pokud potřebujete, aby se atributy produktů exportovaly/importovaly při každém exportu/importu produktu. - Zaškrtněte políčko **Export/import produktů s atributy specifikace** (Export/import products with specification attributes), pokud se mají produkty exportovat/importovat s atributy specifikace. - Zaškrtněte políčko **Export/import produktů s drobečkovou navigací kategorií** (Export/import products with category breadcrumb), pokud se mají produkty exportovat/importovat s úplnými názvy kategorií včetně názvů všech jejich nadřazených kategorií. - Zaškrtněte políčko **Export/import kategorií pomocí názvu kategorie** (Export/import categories using name of category), pokud se mají kategorie exportovat/importovat pomocí názvů kategorií. - Zaškrtněte políčko **Export/import produktů. Povolit stahování obrázků** (Export/import products. Allow download images), pokud lze při exportu produktů stahovat obrázky ze vzdáleného serveru. - Zaškrtněte políčko **Export/import produktů. Povolit rozdělení souboru** (Export/import products. Allow splitting file), pokud chcete importovat produkty z jednotlivých souborů optimální velikosti automaticky vytvořených z hlavního souboru. Tato funkce vám pomůže importovat velké množství dat s menším zpožděním. - Zaškrtněte políčko **Export/import souvisejících entit pomocí názvu** (Export/import related entities using name), pokud se mají související entity exportovat/importovat pomocí názvů. - Zaškrtněte políčko **Export/import produktů s „omezením na obchody“** (Export/import products with "limited to stores"), pokud se mají produkty exportovat/importovat s jejich vlastnostmi „omezení na obchody“. > [!NOTE] > > Pokud máte dva nebo více jazyků, export/import do Excelu/XML podporuje vícejazyčná data. ## Řazení produktů V panelu *Řazení produktů* (Product sorting) můžete definovat: - Zaškrtněte políčko **Povolit řazení produktů** (Allow product sorting), abyste povolili možnost řazení produktů na stránkách kategorií a výrobců. Řazení podle *Pozice* (Position), *Názvu* (Name), *Ceny* (Price) a *Data vytvoření* (Date of creation) můžete aktivovat/deaktivovat. > [!NOTE] > > Výběr hodnoty „Pozice“ znamená, že na řazení produktů nebudou kladena žádná omezení. ![řazení_produktů](_static/catalog-settings/product_sorting.jpg) Vlastnosti **Pořadí zobrazení** (Display order) a **Je aktivní** (Is active) jednotlivých možností můžete upravit kliknutím na tlačítko **Upravit** (Edit). --- # Filtr YMM (rok-značka-model) ## Přehled Filtr YMM (Year-Make-Model, tedy rok-značka-model) umožňuje zákazníkům vyhledávat produkty pomocí strukturovaného víceúrovňového systému filtrování. Ačkoli název naznačuje použití v automobilovém odvětví, funkce je plně přizpůsobitelná a lze ji upravit pro jakýkoli katalog produktů, který vyžaduje kontrolu kompatibility, například náhradní díly pro elektroniku (např. filtrování podle „značky, modelu, velikosti displeje“). Hlavním účelem je pomoci zákazníkům snadno najít díly kompatibilní s konkrétním vozidlem nebo produktem, zlepšit uživatelský zážitek a snížit pravděpodobnost nesprávných nákupů. ### Klíčové funkce - **Konfigurovatelné víceúrovňové filtrování:** Administrátoři mohou definovat až tři vnořené úrovně filtru (např. Rok → Značka → Model). - **Flexibilní správa hodnot:** Snadné přidávání, úpravy a hromadná správa hodnot filtru (např. 2023, Audi, A4) v administraci nebo pomocí importu/exportu z Excelu. - **Mapování produktů na filtr:** Přiřazení produktů k jedné nebo více kompatibilním kombinacím filtru pro zajištění přesných výsledků vyhledávání. - **Bezproblémová integrace do veřejné části obchodu:** Zobrazení filtru na domovské stránce pro snadný přístup a zobrazení podrobných informací o kompatibilitě na stránkách produktů. ## Konfigurace v administraci ### Nastavení filtru Funkci nakonfigurujete v **Konfigurace → Nastavení → Nastavení filtru (YMM)** (Configuration → Settings → Filter (YMM) settings). ![YMM](_static/ymm/ymm_settings.png) - **`Enabled`** (Povoleno): Hlavní přepínač, který aktivuje nebo deaktivuje celou funkci YMM na webu. Ve výchozím stavu je vypnutý. - **`Display on home page`** (Zobrazit na domovské stránce): Zaškrtnutím tohoto políčka zobrazíte blok filtru YMM na domovské stránce webu. - **`Display filter values on product details page`** (Zobrazit hodnoty filtru na stránce detailu produktu): Je-li zaškrtnuto, zobrazí se na stránkách produktů tabulka „Kompatibilní s“ se seznamem všech přiřazených kombinací filtru. Ve výchozím stavu je zapnuto. #### Tabulka úrovní filtru Zde můžete přizpůsobit tři dostupné úrovně filtru: ![YMM](_static/ymm/ymm_fl_edit.png) - **Povoleno** (Enabled): Aktivace nebo deaktivace každé úrovně. - **Název** (Name): Nastavení vlastního, lokalizovatelného názvu každé úrovně. > [!NOTE] > > Ve výchozím stavu bude mít nová instalace nakonfigurovány a povoleny úrovně „Year“, „Make“ a „Model“. > [!WARNING] > > Nadřazenou úroveň nelze vypnout, pokud je podřízená úroveň aktuálně zapnutá. ### Správa hodnot filtru Možnosti pro jednotlivé úrovně filtru vytvoříte a spravujete v **Katalog → Hodnoty úrovní filtru (YMM)** (Catalog → Filter level values (YMM)). ![YMM](_static/ymm/ymm_flv_list.png) - **Vytváření a úprava hodnot:** Administrátoři mohou přidávat nebo upravovat kombinace hodnot pro povolené úrovně filtru (např. Rok: 2024, Značka: BMW, Model: X5). Systém brání vytvoření duplicitních kombinací. ![YMM](_static/ymm/ymm_flv_edit.png) - **Mapování produktů:** Při vytváření nebo úpravě sady hodnot se zobrazí nové okno, ve kterém můžete k této konkrétní kombinaci přímo přiřadit produkty. Toto okno zobrazuje také produkty, které již přiřazeny jsou. - **Funkce správy:** - **Filtr:** Tabulku v administraci lze filtrovat podle jednotlivých aktivních úrovní a rychle tak najít záznamy. - **Import/Export:** Hromadná správa hodnot filtru pomocí nástroje pro import a export z/do Excelu. - **Smazat vybrané:** Odstranění více kombinací hodnot najednou. ### Mapování ze stránky úpravy produktu Mapování můžete spravovat také přímo na stránce konfigurace produktu. 1. Přejděte do **Katalog → Produkty** (Catalog → Products) a otevřete produkt k úpravě. 1. Najděte nový panel **„Hodnoty úrovní filtru (YMM)“** ("Filter level values (YMM)") (nachází se za panelem „Cross-sell produkty“). ![YMM](_static/ymm/ymm_product_map.png) 1. Zde můžete přidávat nebo odebírat vazby mezi produktem a existujícími kombinacemi hodnot filtru. ## Funkce ve veřejné části obchodu ### Filtr na domovské stránce Je-li povoleno zobrazení funkce na domovské stránce, zákazníci uvidí blok filtru s rozevíracími nabídkami pro každou aktivní úroveň filtru. ![YMM](_static/ymm/ymm_public.png) Rozevírací nabídky jsou **závislé a postupné**. Než se aktivuje rozevírací nabídka druhé úrovně („Značka“), musí být vybrána hodnota ve filtru první úrovně (např. „Rok“) atd. ### Stránka výsledků vyhledávání Vyhledávání se provede až poté, co zákazník vybere hodnotu pro **všechny povolené úrovně filtru**. Po kliknutí na **Hledat** je uživatel přesměrován na samostatnou stránku výsledků vyhledávání YMM. ![YMM](_static/ymm/ymm_search.png) Tato stránka zobrazuje v horní části vybraná kritéria filtru a pod nimi stránkovaný seznam všech odpovídajících produktů. ### Stránka detailu produktu Je-li příslušné nastavení aktivní, zobrazí se na stránce produktu tabulka s názvem **„Kompatibilní s“**. Tato tabulka přehledně uvádí všechny kombinace YMM, se kterými je daný produkt kompatibilní, což zákazníkům dodává jistotu při nákupu. ![YMM](_static/ymm/ymm_product_compatible.png) --- # Ceníky ## Přehled Ceník je pojmenovaná sada pravidel, která mění cenu produktů k němu přiřazených. Ceník může zvýšit nebo snížit základní cenu produktu o procento nebo pevnou částku, případně nastavit jednu pevnou cenu pro všechny své produkty, například: - velkoobchodní nebo B2B ceny pro konkrétní roli zákazníka; - dočasný výprodej uplatněný na vybranou skupinu zákazníků po omezenou dobu; - vyjednané ceny pro konkrétní zákazníky, například zákazníka s dlouhodobou smlouvou. Ceníky se od [slev](xref:cs/running-your-store/promotional-tools/discounts) liší tím, že ceník mění samotnou cenu produktu, a stává se tak základem pro další výpočty, zatímco sleva se uplatňuje až na výslednou cenu. ![Ceníky](_static/price-lists/price_lists.png) ## Jak ceník ovlivňuje cenu Cena se z ceníku převezme pouze tehdy, jsou-li splněny všechny následující podmínky: - ceník je **aktivní**; - aktuální okamžik spadá do období mezi datem začátku a konce platnosti ceníku (pokud jsou zadána); - zákazník patří do rolí zákazníků vybraných pro tento ceník, nebo je jedním ze zákazníků přidaných do tohoto ceníku jednotlivě; - produkt je k tomuto ceníku přiřazen. ![Ceníky](_static/price-lists/price_lists_info.png) Cena podle ceníku se vypočítá ze základní hodnoty **Cena** (Price) produktu pomocí zvoleného typu a hodnoty výpočtu: | Typ výpočtu | Výsledek | | --- | --- | | Procentní snížení | základní cena minus zadané procento | | Procentní zvýšení | základní cena plus zadané procento | | Snížení o částku | základní cena minus zadaná částka | | Zvýšení o částku | základní cena plus zadaná částka | | Pevná cena | zadaná cena se použije tak, jak je | Například u produktu se základní cenou 100 USD a ceníku typu *Procentní snížení* s hodnotou 15 bude cena 85 USD. Produkt může mít v rámci ceníku nastavenou **Ruční cenu** (Manual price). Pokud je zadána, použije se tato hodnota místo vypočtené. ![Ceníky](_static/price-lists/price_lists_products.png) > [!NOTE] > > U kteréhokoli produktu můžete výsledek výpočtů zkontrolovat v panelu *Produkty* (Products) ceníku, kde se zobrazují sloupce **Původní cena** (Original price), **Vypočtená cena** (Calculated price) a **Ruční cena** (Manual price). ### Více ceníků pro jeden produkt Pokud se na stejný produkt a zákazníka vztahuje několik aktivních ceníků, výsledek závisí na nastavení **Strategie ceníků** (Price list strategy), které najdete v **Konfigurace → Nastavení → Nastavení katalogu** (Configuration → Settings → Catalog settings). - **Minimální cena** (Minimal price): uplatní se všechny použitelné ceníky a použije se nejnižší výsledná cena. - **Použít podle priority** (Use by priority): ceníky se uplatňují vzestupně podle hodnoty **Priorita** (Priority) a použije se cena prvního použitelného ceníku. Ceníky s nižší hodnotou priority se uplatňují jako první; pokud má několik ceníků stejnou hodnotu, uplatňují se v pořadí, v jakém byly vytvořeny. Toto pole se v administraci zobrazuje pouze tehdy, je-li zvolena strategie *Použít podle priority*. > [!NOTE] > > Nastavení lze v instalaci s více obchody nakonfigurovat také samostatně pro každý obchod. ## Vytvoření ceníku Chcete-li přidat nový ceník, přejděte do **Katalog → Ceníky** (Catalog → Price lists) a klikněte na **Přidat nový** (Add new). V panelu *Informace o ceníku* (Price list info) definujte následující hodnoty: - **Název** (Name) ceníku. - **Typ výpočtu ceny** (Price calculation type). Dostupné možnosti jsou *Procentní snížení* (Percentage decrease), *Procentní zvýšení* (Percentage increase), *Snížení o částku* (Amount decrease), *Zvýšení o částku* (Amount increase) a *Pevná cena* (Fixed price). - **Hodnota výpočtu ceny** (Price calculation value). Její význam závisí na zvoleném typu výpočtu: u procentních typů jde o procento, u typů s částkou a pevnou cenou o částku. - **Aktivní** (Active). Neaktivní ceníky se na produkty neuplatňují, což vám umožňuje připravit ceník předem a zapnout jej později. - **Role zákazníků** (Customer roles). Vyberte role, na které se tento ceník uplatní. Pokud není vybrána žádná role a nejsou přidáni žádní jednotliví zákazníci, uplatní se ceník na všechny zákazníky. - **Popis** (Description) ceníku. - **Datum začátku** (Start date) a **Datum konce** (End date). Ponechte tato pole prázdná, aby byl ceník aktivní neomezeně. Kliknutím na **Uložit** (Save) uložíte změny, nebo kliknutím na **Uložit a pokračovat v úpravách** (Save and continue edit) přejdete k dalším panelům. ## Přiřazení produktů k ceníku Produkty lze do ceníku přidat ze stránky ceníku nebo ze stránky produktu. ### Ze stránky ceníku Přejděte do panelu *Produkty* ceníku a klikněte na **Přidat produkt** (Add product). Ve vyskakovacím okně najděte požadované produkty (vyhledávat můžete podle názvu produktu, kategorie, výrobce, dodavatele, obchodu a typu produktu), vyberte je a klikněte na **Uložit**. U každého produktu v tabulce můžete: - zobrazit **Původní cenu** (základní cenu produktu) a **Vypočtenou cenu**; - nastavit **Ruční cenu**, která přepíše vypočtenou hodnotu. Klikněte na **Upravit** (Edit), zadejte cenu a uložte; - otevřít stránku produktu nebo produkt z ceníku odebrat. ### Ze stránky produktu Přejděte do **Katalog → Produkty** (Catalog → Products), otevřete požadovaný produkt a v panelu *Cena* (Price) vyberte ceníky v poli **Ceníky** (Price lists). Další podrobnosti naleznete v části [Přidání produktů](xref:cs/running-your-store/catalog/products/add-products). ![Ceníky](_static/price-lists/price_lists_product_info.png) > [!NOTE] > > Ruční cena nastavená v panelu *Produkty* ceníku má přednost před cenou vypočtenou ceníkem. Více o tomto poli si přečtěte v části [Přidání produktů](xref:cs/running-your-store/catalog/products/add-products). ## Přiřazení zákazníků k ceníku Kromě rolí zákazníků můžete ceník přiřadit konkrétním zákazníkům. Přejděte do panelu *Zákazníci* (Customers) ceníku a klikněte na **Přidat zákazníka** (Add customer). Najděte požadované zákazníky, vyberte je a klikněte na **Uložit**. ![Ceníky](_static/price-lists/price_lists_customers.png) Ceník se pak na tyto zákazníky uplatní navíc k zákazníkům s vybranými rolemi. > [!NOTE] > > Tímto způsobem lze do ceníku přidat pouze registrované zákazníky. Chcete-li ceník uplatnit na hosty, použijte role zákazníků, například roli *Hosté* (Guests). ## Import a export ceníků Na stránce **Katalog → Ceníky** můžete importovat ceníky ze souboru Excel nebo exportovat stávající. Pro export klikněte na **Exportovat** (Export) a vyberte **Exportovat do Excelu (vše nalezené)** (Export to Excel (all found)) nebo **Exportovat do Excelu (vybrané)** (Export to Excel (selected)). Pro import klikněte na **Importovat** (Import) a nahrajte soubor Excel. Soubor obsahuje pro každý ceník následující sloupce: `Id`, `Name`, `Description`, `Active`, `StartDateUtc`, `EndDateUtc`, `PriceCalculationType`, `PriceCalculationValue`, `Customers`, `CustomerRoles`, `Priority`. Každý produkt ceníku je popsán ve vnořených řádcích téhož souboru se sloupci `Sku` a `ManualPrice`. > [!NOTE] > > Ceníky se rozlišují podle sloupce **Id**. Pokud ID ve vašem obchodě již existuje, odpovídající ceník se aktualizuje; u nových ceníků ponechte v tomto sloupci hodnotu 0. Všechna SKU uvedená v souboru musí ve vašem katalogu existovat, jinak se import neprovede. ## Oprávnění Funkce ceníků je řízena následujícími oprávněními v **Konfigurace → Uživatelé → Role** (Configuration → Users → Roles): - **Zobrazit ceníky** (View price lists). - **Vytvářet, upravovat a mazat ceníky** (Create, edit and delete price lists). - **Importovat a exportovat ceníky** (Import and export price lists). Více o tom, jak nakonfigurovat oprávnění, si přečtěte v části [Seznam řízení přístupu](xref:cs/running-your-store/customer-management/access-control-list). ## Viz také - [Přidání produktů](xref:cs/running-your-store/catalog/products/add-products) - [Množstevní ceny](xref:cs/running-your-store/promotional-tools/tier-prices) - [Slevy](xref:cs/running-your-store/promotional-tools/discounts) - [Role zákazníků](xref:cs/running-your-store/customer-management/customer-roles) - [Funkce více obchodů](xref:cs/getting-started/advanced-configuration/multi-store) --- # Směrnice EU Omnibus ## Úvod Pořiďte si prosím [integraci směrnice Omnibus](https://www.nopcommerce.com/omnibus-directive). ### Co je Omnibus? Směrnice (EU) 2019/2161, známá také jako [směrnice Omnibus](https://eur-lex.europa.eu/eli/dir/2019/2161/oj), je směrnice Evropské unie zaměřená na posílení práv spotřebitelů a podporu větší transparentnosti prostřednictvím sankcí k vymáhání těchto práv. Hlavním cílem směrnice Omnibus je posílit ochranu práv spotřebitelů v celé Evropské unii a vztahuje se na všechny internetové obchody. ### Klíčové body směrnice Omnibus * Jakékoli snížení ceny musí být na webu internetového obchodu zobrazeno uvedením předchozí ceny i aktuální ceny po slevě. * Jako referenční cena pro uplatnění snížení musí být použita nejnižší cena zaznamenaná během 30 dnů před akcí. ### Jak uplatňovat akce v plném souladu se směrnicí Před plánováním akce nebo slevového období musíte zajistit, že všechny historické ceny jsou k dispozici alespoň za 30 dnů před datem akce. Na vyžádání místních úřadů byste měli být schopni prokázat a ukázat své ceny za poslední měsíc. ## Plugin nopCommerce pro směrnici Omnibus Aby byla zajištěna shoda se směrnicí Omnibus, naše integrace sleduje změny cen v nakonfigurovaném časovém období a zobrazuje zákazníkům nejnižší cenu. Sledování zohledňuje slevy uplatněné na produkty, kategorie nebo výrobce. Směrnice EU Omnibus ovlivňuje způsob, jakým musí internetové obchody zobrazovat ceny svých produktů, zejména těch ve výprodeji. Směrnice vyžaduje, aby prodejci informovali zákazníky nejen o zlevněné ceně nebo procentu slevy, ale také o nejnižší ceně, za kterou byl produkt prodáván v posledních 30 dnech. Tyto ceny se označují jako ceny omnibus. Obchody musí být ve stanovování cen transparentní – ceny omnibus musí být výrazné a pro zákazníky snadno dostupné, a to jednotně na všech stránkách produktů. ![Stránka produktu](_static/product.png) ![Nejnižší cena](_static/lowest-price.png) ### Konfigurace pluginu ![Nejnižší cena](_static/settings.png) Na konfigurační stránce můžete povolit obnovování historie, nakonfigurovat časové období, přizpůsobit možnosti zobrazení a další. Klikněte na tlačítko „Refresh price history data“ a plugin vypočítá a uloží běžné ceny (do historických dat). V závislosti na počtu produktů to může chvíli trvat, buďte proto trpěliví. Doporučuje se to provést po instalaci pluginu nebo při zahájení nové slevové kampaně. > [!NOTE] > > Plugin podporuje pouze standardní slevy. Slevy s personalizovanými kódy kupónů nejsou podporovány. Data historie cen se automaticky obnovují každých 24 hodin pro publikované produkty, nebo okamžitě pro produkt, u kterého se změní cena (produkt je vytvořen nebo upraven). 1. Pokud chcete naplánované obnovování dat historie cen vypnout, zrušte zaškrtnutí políčka **Enable scheduled refresh of price history data** – ve výchozím stavu je zapnuté. To může být užitečné u obchodů s velkým počtem produktů. 1. Chcete-li upravit časové období pro výpočet nejnižší ceny, zadejte požadovanou hodnotu do pole **Lowest price calculation timeframe**. Ve výchozím stavu integrace zobrazuje nejnižší cenu za posledních 30 dnů před aktuálním datem. 1. Pomocí nastavení **Show lowest price** zvolte, jak se má nejnižší cena zobrazovat na stránce s podrobnostmi produktu: * **When the lowest price is lower than the current price** – zobrazí nejnižší cenu pouze tehdy, když je nižší než aktuální cena (jinak bude skrytá). * **Always** – pokud chcete nejnižší cenu zobrazovat vždy (i když je stejná jako aktuální). * **Hide** – užitečné, když jste plugin právě nainstalovali a shromážděná data nejsou dostatečná (toto nastavení se doporučuje zvolit během prvních 30 dnů provozu pluginu). 1. Zaškrtávací políčko **Hide lowest price for products with attributes** umožňuje skrýt nebo zobrazit nejnižší cenu u produktů s atributy produktu. Data historie cen se neukládají pro atributy produktu s úpravami ceny (ukládáme pouze standardní ceny produktů). Plugin každých 24 hodin automaticky odstraňuje zastaralá data historie cen (data historie starší než nakonfigurované období pro výpočet ceny). > [!NOTE] > > Naplánovaná úloha neodstraňuje záznam historie cen, který předchází nakonfigurovanému období pro výpočet ceny, protože se považuje za počáteční cenu. ![Seznam produktů](_static/product-list.png) V bloku **Product list** vidíte aktuální a nejnižší ceny, stav dostupnosti a tlačítko „View“ pro úpravu produktu. Produkty můžete filtrovat podle názvu, kategorie, typu a obchodu (pokud jich máte více). ![Historie změn cen](_static/price-history.png) Blok **Price change history** obsahuje všechny uložené ceny produktů. Každý záznam v tabulce má tlačítko, které umožňuje jej smazat (například pokud byl záznam uložen omylem). Data historie změn můžete filtrovat podle názvu produktu, období výpočtu a obchodu (pokud jich máte více). ![Stránka s podrobnostmi slevy](_static/discount.png) Na stránce s podrobnostmi slevy můžete přidat všechny informace o slevě a uvést produkty, na které se vztahuje. Doporučujeme po nakonfigurování slevové akce na stránce s podrobnostmi slevy ručně obnovit data změn cen kliknutím na tlačítko „Refresh price history data (Omnibus)“. V opačném případě může mezi spuštěními naplánované úlohy (každých 24 hodin) dojít k nesouladu se směrnicí Omnibus. ### Instalace pluginu Tato část popisuje, jak integrovat plugin pro směrnici Omnibus do vašeho obchodu. 1. [Zakupte si integraci](https://www.nopcommerce.com/omnibus-directive). 1. Stáhněte si archiv pluginu. 1. Přejděte do **Administrace > Konfigurace > Lokální pluginy** (Admin area > Configuration > Local plugins). 1. Nahrajte archiv pluginu pomocí tlačítka „Nahrát plugin nebo šablonu“ (Upload plugin or theme). 1. Posuňte se v seznamu pluginů dolů a najděte nově nahraný plugin. 1. Kliknutím na tlačítko **Instalovat** (Install) plugin nainstalujte. Další [informace o tom, jak instalovat pluginy](https://docs.nopcommerce.com/getting-started/advanced-configuration/plugins-in-nopcommerce.html), naleznete zde. --- # Konfigurace fulltextového vyhledávání pro váš obchod nopCommerce Fulltextové vyhledávání je výkonná technologie, která uživatelům umožňuje rychle a přesně prohledávat velké objemy textových dat. Na rozdíl od standardního vyhledávání nopCommerce, které se spoléhá na přesné shody, analyzuje fulltextové vyhledávání obsah webu a vrací nejrelevantnější výsledky. Automatické doplňování a tolerance překlepů optimalizují rychlost vyhledávání a pomáhají uživatelům najít přesně to, co potřebují. Rychlé fulltextové vyhledávání nopCommerce je implementováno ve dvou pluginech: * [Rychlé fulltextové vyhledávání založené na Lucene](xref:cs/running-your-store/catalog/catalog-settings/full-text-search/lucene-configure) * [Rychlé fulltextové vyhledávání založené na Elasticsearch](xref:cs/running-your-store/catalog/catalog-settings/full-text-search/elasticsearch-configure) --- # Fulltextové vyhledávání založené na Elasticsearch Pořiďte si [oficiální integraci s Elasticsearch](https://www.nopcommerce.com/full-text-search-elasticsearch?utm_source=docs.nopcommerce&utm_medium=documentation&utm_campaign=full-text-search-elasticsearch). Elasticsearch je vyhledávač založený na knihovně Lucene. Poskytuje distribuovaný fulltextový vyhledávač s podporou více tenantů, s webovým rozhraním HTTP a dokumenty JSON bez schématu. Naše integrace poskytuje silně typované API a dotazovací DSL pro komunikaci se serverem Elasticsearch. Plugin obsahuje vysokoúrovňové operace pro produkty, jako je hromadné indexování, operace aktualizace a vyhledávání. > [!NOTE] > > Integrace je založena na klientovi .NET v8 pro použití s verzemi Elasticsearch 8.x ## Dostupné funkce Zde je seznam podporovaných funkcí: * Automatická aktualizace dat produktů na serveru Elasticsearch (v reálném čase nebo podle plánu). * Automatické přiřazení dostupného jazyka indexování k aktuálnímu jazyku obchodu. * Několik vestavěných typů vyhledávání: * Fuzzy vyhledávání se používá pro fráze, které jsou napsány chybně. Pokud například napíšete ‘test’ místo ‘text’, výsledky budou přesto nalezeny. * Vyhledávání se zástupnými znaky se používá k vyhledávání podle vzorů frází namísto hledání celých frází. Integrace používá zástupný operátor `*` pro reprezentaci konců slov. * Přesné vyhledávání striktně porovnává dotaz s indexovanými tokeny. * Několik metod ověřování pro přístup ke clusteru Elasticsearch. ## Instalace pluginu Tato část popisuje, jak integrovat Elasticsearch do vašeho obchodu. 1. Zakupte integraci na [https://www.nopcommerce.com/full-text-search-elasticsearch](https://www.nopcommerce.com/full-text-search-elasticsearch?utm_source=docs.nopcommerce&utm_medium=documentation&utm_campaign=full-text-search-elasticsearch) 1. Stáhněte archiv pluginu. 1. Přejděte do administrace > Konfigurace > Místní pluginy (Configuration > Local plugins). Nahrajte archiv pluginu pomocí funkce „Nahrát plugin nebo téma“ (Upload plugin or theme). 1. Posuňte se v seznamu pluginů dolů a najděte nově nainstalovaný plugin. Kliknutím na tlačítko „Instalovat“ (Install) plugin nainstalujete. Další informace naleznete v článku [jak instalovat pluginy](https://docs.nopcommerce.com/getting-started/advanced-configuration/plugins-in-nopcommerce.html). Pro správnou funkci pluginu musí být Elasticsearch nakonfigurován. Více informací o [procesu instalace Elasticsearch](https://www.elastic.co/downloads/elasticsearch). > [!NOTE] > > Plugin patří do skupiny **Poskytovatel vyhledávání** (Search provider). Pro rychlejší navigaci použijte pole **Skupina** (Group) na panelu vyhledávání k filtrování pluginů. ![Místní pluginy](_static/local-plugins-elasticsearch.png) ## Konfigurace pluginu Klikněte na tlačítko **Konfigurovat** (Configure) vedle možnosti Elastic search provider v seznamu. Poté konfiguraci pluginu dokončete podle následujících kroků: ![Stránka konfigurace Lucene](_static/elasticsearch-config-page.png) 1. Zadejte URL koncového bodu uzlu (Node endpoint), kterou bude plugin používat pro připojení k vašemu clusteru Elasticsearch. 1. Zadejte název indexu, který bude používán pro požadavky na server Elasticsearch (ve výchozím nastavení *nopcommerceproducts*) 1. Zadejte přihlašovací údaje k serveru Elasticsearch: * **Typ ověřování** (Authentication type). Vyberte metodu ověřování, která bude použita k udělení přístupu ke clusteru Elasticsearch. * **Uživatelské jméno** (Username). Uživatelské jméno, které používáte se schématem ověřování Basic. * **Heslo** (Password). Heslo, které používáte se schématem ověřování Basic. * **Api Key**. Klíč, který používáte se schématem ověřování Bearer. 1. Zvolte algoritmus vyhledávání: * Vyhledávání „**Fuzzy**“ je založeno na Levenshteinově vzdálenosti (například vyhledávání výrazu „roam“ najde výrazy jako „foam“ a „roams“). * Vyhledávání „**Contains**“ hledá 0 nebo více znaků na základě vyhledávání se zástupným znakem „*“ na konci (například pro vyhledání „test“, „tests“ nebo „tester“ můžete použít výraz „test“). * Možnost „**None**“ je založena na přesné shodě. 1. Zvolte pravidlo pro porovnávání výrazů ve vyhledávacím dotazu: * Operátor „**Should**“ – výrazy by se měly vyskytovat v poli odpovídajícího produktu, ale jsou volitelné * Operátor „**Must**“ – výrazy se musí vyskytovat v poli odpovídajícího produktu. 1. Nastavte chování aktualizace dokumentů vyhledávacího indexu. Zaškrtněte **Okamžitě aktualizovat indexy** (Immediately update indexes), chcete-li změny namapovaného produktu (například změnu jeho názvu nebo popisu) použít okamžitě. V opačném případě bude přeindexování naplánováno. > [!NOTE] > > Přeindexování můžete spustit také ručně kliknutím na tlačítko „Znovu sestavit index“ (Rebuild index). 1. V případě potřeby zadejte **Limit výsledků** (Result limit). Limit výsledků je maximální počet shod, které budou pro vyhledávací dotazy načteny ze serveru Elasticsearch. 1. Zadejte další oddělovací znaky pro rozdělení vyhledávacího dotazu na výrazy. Upozorňujeme, že vyhledávací dotazy se kromě zadaných oddělovačů vždy rozdělují mezerou. 1. Zadejte **Faktor zvýhodnění** (Boost factor) pro každé indexované pole nebo pomocí zaškrtávacího políčka povolte či zakažte zvýhodnění relevance. 1. Klikněte na tlačítko **Uložit** (Save) > [!NOTE] > > Pro přepnutí stavu pluginu použijte tlačítka „**Povolit**“ (Enable) nebo „**Zakázat**“ (Disable). Zobrazují se v závislosti na aktuálním stavu. --- # Fulltextové vyhledávání založené na Lucene Pořiďte si [plugin pro fulltextové vyhledávání založený na Lucene](https://www.nopcommerce.com/full-text-search-lucene?utm_source=docs.nopcommerce&utm_medium=documentation&utm_campaign=full-text-search-lucene). [Apache Lucene™](https://lucene.apache.org/) je vysoce výkonná a plnohodnotná knihovna vyhledávacího enginu napsaná výhradně v Javě. Jde o technologii vhodnou pro téměř jakoukoli aplikaci, která vyžaduje strukturované vyhledávání, fulltextové vyhledávání, fasetové vyhledávání, vyhledávání nejbližších sousedů ve vysokorozměrných vektorech, opravu pravopisu nebo návrhy dotazů. Naše integrace používá [Lucene.Net](https://lucenenet.apache.org/), což je port vyhledávací knihovny Lucene. Apache Lucene.NET je knihovna pro .NET, která poskytuje výkonné indexování, vyhledávací funkce a pokročilé možnosti analýzy/tokenizace. ## Dostupné funkce Zde je seznam podporovaných funkcí: * Automatická aktualizace dat produktů v uloženém indexu. * Automatické přiřazení dostupného jazyka indexování k aktuálnímu jazyku obchodu. * Několik vestavěných typů vyhledávání: * Fuzzy vyhledávání se používá pro fráze, které jsou napsány s chybou. Například když napíšete „test“ místo „text“, výsledky mohou být přesto nalezeny. * Vyhledávání se zástupnými znaky se používá k vyhledávání podle vzorů frází namísto celých frází. Integrace používá zástupný operátor `*`, který představuje konce slov. * Přesné vyhledávání striktně porovnává dotaz s indexovanými tokeny. ## Instalace pluginu Tato část popisuje, jak integrovat plugin Lucene do vašeho obchodu. 1. Zakupte integraci na [https://www.nopcommerce.com/full-text-search-lucene](https://www.nopcommerce.com/full-text-search-lucene?utm_source=docs.nopcommerce&utm_medium=documentation&utm_campaign=full-text-search-lucene) 1. Stáhněte archiv pluginu. 1. Přejděte do administrace > Konfigurace > Lokální pluginy (configuration > local plugins). 1. Nahrajte archiv pluginu pomocí funkce „Nahrát plugin nebo šablonu“ (Upload plugin or theme). 1. Posuňte se v seznamu pluginů dolů a najděte nově nainstalovaný plugin. Kliknutím na tlačítko „Instalovat“ (Install) plugin nainstalujte. Více informací najdete v článku [jak instalovat pluginy](https://docs.nopcommerce.com/getting-started/advanced-configuration/plugins-in-nopcommerce.html) > [!NOTE] > > Plugin patří do skupiny **Poskytovatel vyhledávání** (Search provider). Pro rychlejší orientaci použijte k filtrování pluginů pole **Skupina** (Group) ve vyhledávacím panelu. ![Lokální pluginy](_static/local-plugins-lucene.png) ## Konfigurace pluginu Klikněte v seznamu na tlačítko **Konfigurovat** (Configure) vedle poskytovatele vyhledávání Lucene. Poté dokončete konfiguraci pluginu podle následujících kroků: ![Konfigurační stránka Lucene](_static/lucene-config-page.png) 1. Vyberte vyhledávací algoritmus: * Vyhledávání „**Fuzzy**“ je založeno na Levenshteinově vzdálenosti (například hledání výrazu „roam“ najde výrazy jako „foam“ a „roams“). * Vyhledávání „**Contains**“ hledá 0 nebo více znaků na základě vyhledávání se zástupným znakem „*“ na konci (například pro nalezení „test“, „tests“ nebo „tester“ můžete použít výraz „test“). * Možnost „**None**“ je založena na přesné shodě. 1. Vyberte pravidlo pro shodu výrazů ve vyhledávacím dotazu: * Operátor „**Should**“ – výrazy by se měly vyskytovat v poli odpovídajícího produktu, ale jsou volitelné * Operátor „**Must**“ – výrazy se musí vyskytovat v poli odpovídajícího produktu. 1. Nastavte chování aktualizace dokumentů vyhledávacího indexu. Zaškrtněte **Okamžitě aktualizovat indexy** (Immediately update indexes), aby se změny namapovaných produktů (například změna jejich názvů nebo popisů) projevily okamžitě. V opačném případě bude přeindexování naplánováno. > [!NOTE] > > Přeindexování můžete také spustit ručně kliknutím na tlačítko „Znovu sestavit index“ (Rebuild index). 1. V případě potřeby zadejte **Limit výsledků** (Result limit). Limit výsledků je maximální počet shod, které budou pro vyhledávací dotazy načteny z indexu. 1. Zadejte další oddělovací znaky pro rozdělení vyhledávacího dotazu na výrazy. Upozorňujeme, že vyhledávací dotazy se kromě zadaných oddělovačů vždy dělí také podle mezer. 1. Zadejte **Faktor zvýhodnění** (Boost factor) pro každé indexované pole, nebo pomocí zaškrtávacího políčka povolte či zakažte zvýhodnění podle relevance. 1. Klikněte na tlačítko **Uložit** (Save) > [!NOTE] > > Ke změně stavu pluginu použijte tlačítka „**Povolit**“ (Enable) nebo „**Zakázat**“ (Disable). Zobrazují se v závislosti na aktuálním stavu. --- # Správa objednávek Funkce správy objednávek představují „centrum“ vašeho obchodu: zde se shromažďují a spravují všechna provozní data, jako jsou objednávky, platby, zpracování zásilek, aktualizace skladových zásob a žádosti o vrácení zboží. V následujících kapitolách se dozvíte, jak správu objednávek využít naplno: * [Objednávky](xref:cs/running-your-store/order-management/orders) * [Správa dopravy](xref:cs/running-your-store/order-management/shipping-management) * [Žádosti o cenovou nabídku (RFQ)](xref:cs/running-your-store/order-management/rfq) * [Žádosti o vrácení zboží](xref:cs/running-your-store/order-management/return-requests) * [Nákupní košíky a seznamy přání](xref:cs/running-your-store/order-management/shopping-carts-and-wishlists) * [Správa skladových zásob](xref:cs/running-your-store/order-management/inventory-management) * [Atributy pokladny](xref:cs/running-your-store/order-management/checkout-attributes) * [Nastavení objednávek](xref:cs/running-your-store/order-management/order-settings) --- # Objednávky Chcete-li zobrazit a spravovat objednávky, přejděte do **Prodej → Objednávky** (Sales → Orders). Stránka objednávek obsahuje seznam všech aktuálních objednávek. Jakmile zákazník dokončí transakci, objeví se na stránce objednávek nová objednávka. Horní část stránky umožňuje majiteli obchodu vyhledávat objednávky. Zadejte konkrétní kritéria vyhledávání a pomocí různých filtrů najděte jakoukoli objednávku zadanou v obchodě. Po dokončení vyhledávání se jeho výsledky zobrazí v dolní polovině obrazovky. Kliknutím na **Zobrazit** (View) zobrazíte podrobnosti objednávky. ![Seznam objednávek](_static/orders/search.png) ## Vyhledávání objednávek Chcete-li vyhledat objednávky, zadejte jedno nebo více z následujících kritérií vyhledávání: * **Datum od** (Start date) a **Datum do** (End date) pro vymezení období vytvoření objednávek. * **Sklad** (Warehouse) pro načtení objednávek s produkty z určeného skladu. * **Produkt** (Product) — zadejte název produktu. * **Stavy objednávky** (Order statuses) – vyberte jednu z následujících možností: *Vše*, *Čekající*, *Zpracovává se*, *Dokončeno*, *Zrušeno*. * **Stavy platby** (Payment statuses) — vyberte konkrétní stav platby, podle kterého se má vyhledávat: *Vše*, *Čekající*, *Autorizováno*, *Zaplaceno*, *Částečně vráceno*, *Vráceno*, *Stornováno*. * **Stavy dopravy** (Shipping statuses) — vyberte konkrétní stav dopravy, podle kterého se má vyhledávat: *Vše*, *Doprava není vyžadována*, *Dosud neodesláno*, *Částečně odesláno*, *Odesláno*, *Doručeno*. * **Obchod** (Store) — nastavte konkrétní obchod, ve kterém byly objednávky zadány. * **Dodavatel** (Vendor) — vyhledávání podle konkrétního dodavatele. Uvidíte objednávky s produkty určeného dodavatele. * **Fakturační telefonní číslo** (Billing phone number) — telefonní číslo zákazníka. * **Fakturační e-mailová adresa** (Billing email address) — e-mailová adresa zákazníka. * **Fakturační příjmení** (Billing last name) — příjmení zákazníka. * **Fakturační země** (Billing country) — země zákazníka. * **Platební metoda** (Payment method) — nastavte konkrétní platební metodu, která byla použita v pokladně. * **Poznámky k objednávce** (Order notes) — vyhledávání v poznámkách k objednávce. Ponechte prázdné pro načtení všech objednávek. * **Přejít přímo na objednávku č.** (Go directly to order #) — zadejte číslo objednávky a kliknutím na **Přejít** (Go) zobrazte požadovanou objednávku. ### Export objednávek Objednávky můžete exportovat do externího souboru kliknutím na tlačítko **Export** v horní části stránky. Po kliknutí na tlačítko **Export** se zobrazí rozbalovací nabídka, která umožňuje **Exportovat do XML (vše nalezené)** (Export to XML (all found)) nebo **Exportovat do XML (vybrané)** (Export to XML (selected)) a **Exportovat do Excelu (vše nalezené)** (Export to Excel (all found)) nebo **Exportovat do Excelu (vybrané)** (Export to Excel (selected)). ### Import objednávek Objednávky můžete importovat z Excelu kliknutím na **Import**, výběrem souboru a kliknutím na tlačítko **Importovat z Excelu** (Import from Excel). Importované objednávky se rozlišují podle GUID objednávky. Pokud GUID objednávky již existuje, její údaje se aktualizují. > [!WARNING] > > Import vyžaduje hodně paměťových prostředků. Proto se nedoporučuje importovat více než 500–1 000 záznamů najednou. Pokud máte více záznamů, je lepší je rozdělit do více souborů Excel a importovat je samostatně. ## Podrobnosti objednávky Chcete-li zobrazit úplné informace o objednávce, klikněte na **Zobrazit** (View) vedle objednávky v seznamu. Kliknutím na tlačítko **Faktura (PDF)** (Invoice (PDF)) v pravém horním rohu vygenerujete fakturu k objednávce ve formátu PDF. Pokud chcete objednávku smazat, klikněte na **Smazat** (Delete). ### Informace Na panelu **Informace** (Info) může majitel obchodu provádět následující: * Zobrazit **Číslo objednávky** (Order #), což je jedinečné číslo objednávky. * Zobrazit **Vytvořeno** (Created on) — datum/čas, kdy byla objednávka zadána/vytvořena. * Zobrazit **Zákazníka** (Customer), který objednávku zadal. * Zobrazit **Stav objednávky** (Order status). Stav objednávky bude *Dokončeno* pouze tehdy, když je stav platby nastaven na *Zaplaceno* a stav dopravy na *Doručeno*. Stav objednávky lze změnit ručně kliknutím na tlačítko **Změnit stav** (Change status). Tato možnost se však doporučuje pouze pokročilým uživatelům, protože v takovém případě je nutné všechny příslušné akce (jako úprava skladových zásob, odeslání oznamovacích e-mailů, věrnostní body, aktivace/deaktivace dárkových poukazů) provést ručně. * **Zrušit objednávku** (Cancel order). Zobrazí se potvrzovací zpráva; kliknutím na **Ano** (Yes) objednávku ze systému odstraníte. > [!NOTE] > > Když zákazník použije platební metodu Manual Credit Card, která umožňuje ukládat údaje o platební kartě do databáze, zobrazí se tlačítko **Upravit platební kartu** (Edit credit card). Pokud je použita jiná platební metoda, toto tlačítko viditelné nebude. * Zobrazit **Mezisoučet objednávky** (Order subtotal), **Dopravu objednávky** (Order shipping), **Daň objednávky** (Order tax), **Celkovou částku objednávky** (Order total), **Zisk** (Profit). Pokud kliknete na tlačítko **Upravit součty objednávky** (Edit order totals), budete moci upravit součty objednávky jako na snímku obrazovky níže: ![Součty objednávky](_static/orders/edit-totals.jpg) * Zobrazit **Platební metodu** (Payment method) použitou pro tuto objednávku. * Zobrazit **Stav platby** (Payment status). Může být jeden z následujících: *Čekající*, *Autorizováno*, *Zaplaceno (zachyceno)*, *Vráceno*, *Částečně vráceno* nebo *Stornováno*. > [!NOTE] > > Ne všechny platební brány podporují všechny tyto stavy. Více o platebních metodách se dočtete v kapitole [Platební metody](xref:cs/getting-started/configure-payments/payment-methods/index). Pokud je stav platby *Autorizováno*, budou k dispozici příslušná tlačítka **Stornovat** (Void) a **Zachytit** (Capture). **Zachytit** slouží k inkasování prostředků od zákazníka. **Stornovat** zruší objednávku, která dosud nebyla zachycena. Pokud je stav platby *Čekající*, může majitel kliknout na **Označit jako zaplacené** (Mark as paid), čímž označí, že platba za objednávku byla provedena. Pokud je stav platby *Zaplaceno*, budou k dispozici tlačítka **Vrátit platbu** (Refund) a **Částečně vrátit** (Partial refund). Po kliknutí na **Vrátit platbu** se zobrazí potvrzovací okno. Po kliknutí na tlačítko **Částečně vrátit** se zobrazí okno *Částečné vrácení*. Toto okno umožňuje majiteli vrátit část celkové částky objednávky takto: ![Vrácení platby](_static/orders/refund.png) * Zobrazit **Obchod** (Store), ve kterém byla objednávka zadána. * Zobrazit **GUID objednávky** (Order GUID) zobrazované pro interní použití. * Zobrazit **IP adresu zákazníka** (Customer IP address), kterou zákazník použil při zadávání objednávky. ### Fakturace a doprava Na panelu **Fakturace a doprava** (Billing & shipping) si v případě potřeby zobrazte a upravte fakturační a dodací údaje. * Zobrazit **Fakturační adresu** (Billing address) a **Dodací adresu** (Shipping address). Volitelně můžete kliknout na odkaz **Zobrazit adresu v Mapách Google** (View address on Google maps) a vyhledat požadovanou dodací adresu. Kliknutím na tlačítko **Upravit** (Edit) upravíte fakturační nebo dodací adresu. * Zobrazit a v případě potřeby upravit **Způsob dopravy** (Shipping method). * Zobrazit **Stav dopravy** (Shipping status). > [!NOTE] > > Majitelé obchodů mohou k jedné objednávce vytvořit několik zásilek. Pokud vytvoříte zásilku, ale neodešlete všechny produkty, bude stav dopravy objednávky **Částečně odesláno** (Partially shipped). Jakmile jsou odeslány všechny produkty, stav se změní na **Odesláno** (Shipped). Jakmile jsou doručeny všechny zásilky, stav se změní na **Doručeno** (Delivered). * Zobrazit seznam **Zásilek** (Shipments). ![Panel zásilek](_static/orders/shipments.jpg) Kliknutím na **Zobrazit** (View) vedle zásilky zobrazíte její podrobnosti. Zobrazí se okno s informacemi o zásilce: ![Podrobnosti zásilky](_static/orders/shipment-details.jpg) Tlačítko **Přidat zásilku** (Add shipment) umožňuje vytvořit k objednávce několik zásilek a je viditelné, pokud je v objednávce alespoň jeden neodeslaný produkt. Kliknutím na tlačítko **Přidat zásilku** přidáte k objednávce novou zásilku a zobrazí se okno **Přidat novou zásilku k objednávce** (Add a new shipment to order): ![Přidání zásilky](_static/orders/add-shipment.jpg) * Do pole **Sledovací číslo** (Tracking number) zadejte sledovací číslo zásilky. Sledovací číslo umožňuje vašim zákazníkům i vám kontrolovat průběh přepravy zásilky po telefonu nebo prostřednictvím online systému provozovaného vaším přepravcem (poštou nebo soukromou kurýrní službou, jako je FedEx nebo UPS). Kdykoli zásilka projde určitými body na své trase, systém přepravce ji identifikuje a sledovací databáze se aktualizuje o nové informace o poloze a čase. * V případě potřeby vyplňte pole **Komentář administrátora** (Admin comment). * Zaškrtnutím políčka **Odesláno** (Shipped) označíte zásilku jako odeslanou s aktuálním datem. * Pokud je předchozí políčko zaškrtnuté, bude k dispozici políčko **Doručeno** (Delivered). Zaškrtnutím tohoto políčka označíte zásilku jako doručenou s aktuálním datem. * Na panelu **Odeslané produkty** (Products shipped): ve sloupci **Množství k odeslání** (Qty to ship) zadejte požadované množství konkrétní položky objednávky k odeslání. ### Produkty Na panelu **Produkty** (Products) může majitel obchodu: * **Zobrazit informace o produktu** včetně ceny, množství a celkové ceny. * Kliknutím na odkaz **Název produktu** zobrazit stránku s podrobnostmi produktu. Pokud je produkt ke stažení, klikněte na **Resetovat** (Reset) pro vynulování počtu stažení nebo na **Nahrát licenční soubor** (Upload license file). Pokud je navíc *Typ aktivace stahování* (Download activation type) produktu nastaven na *Ručně* (Manually), má administrátor možnost kliknout na **Aktivovat** (Activate) a povolit tak stažení produktu z webu, nebo na **Deaktivovat** (Deactivate) a stažení produktu z webu zakázat. * **Upravit** (Edit) **Cenu** (Price), **Množství** (Quantity), **Slevu** (Discount) a **Celkem** (Total) produktu. * **Smazat** (Delete) produkt ze systému. ![Produkty](_static/orders/products.jpg) * Kliknout na **Přidat produkt** (Add product). Vyberte produkt ze seznamu. Poté v okně *Přidat nový produkt k objednávce* (Add a new product to order) vyhledejte požadovaný produkt. Následně vyplňte požadované hodnoty a klikněte na **Přidat produkt**. Po přidání nového produktu do objednávky nezapomeňte aktualizovat součty objednávky. ![Přidání produktu](_static/orders/add-product.jpg) ### Poznámky k objednávce Na panelu **Poznámky k objednávce** (Order notes) může majitel obchodu zobrazit poznámky, které byly k objednávce přidány pro informační účely, mazat poznámky a přidávat nové. Poznámka může obsahovat **Přiložený soubor** (Attached file) a může být **Zobrazena zákazníkovi** (Displayed to a customer) ve veřejné části obchodu. ![Produkty](_static/orders/note.jpg) ## Viz také * [Přidávání produktů](xref:cs/running-your-store/catalog/products/add-products) * [Zásilky](xref:cs/running-your-store/order-management/shipping-management) * [Výukové video na YouTube o správě objednávek](https://www.youtube.com/watch?v=z6TUJOO3gVg&index=5&list=PLnL_aDfmRHwsbhj621A-RFb1KnzeFxYz4) --- # Správa dopravy Chcete-li vyhledávat a zobrazovat zásilky, přejděte do **Prodej → Zásilky** (Sales → Shipments). ## Seznam zásilek ![Seznam zásilek](_static/shipping-management/order-shipment-list.jpg) Horní část stránky umožňuje vyhledávat zásilky podle různých kritérií: * **Datum začátku** (Start date) a **Datum konce** (End date) pro zásilky vytvořené mezi těmito daty. * Zadejte **Sledovací číslo** (Tracking number), chcete-li najít zásilku s určitým sledovacím číslem. * Vyberte **Sklad** (Warehouse) pro zásilky odeslané z konkrétního skladu. * Zaškrtněte políčko **Načíst nedoručené** (Load not delivered), pokud nechcete načítat již doručené položky. * Pomocí polí **Země, Stát/kraj, Okres/region, Město** (Country, State/province, County/region, City) vyhledávejte podle místa určení zásilky. * Zaškrtněte políčko **Načíst neodeslané** (Load not shipped), pokud nechcete načítat již odeslané položky. * Zaškrtněte políčko **Načíst nepřipravené k vyzvednutí** (Load not ready for pickup), chcete-li načíst položky, které nejsou připraveny k vyzvednutí. Vyberte určité zásilky a použijte **Nastavit jako odeslané (vybrané)** (Set as shipped (selected)), **Nastavit jako doručené (vybrané)** (Set as delivered (selected)) nebo **Nastavit jako připravené k vyzvednutí (vybrané)** (Set as ready for pickup (selected)). Můžete také použít **Tisk dodacích listů (vybrané)** (Print packaging slips (selected)) nebo **Tisk dodacích listů (vše)** (Print Packaging slips (all)) a vytisknout dodací listy. V seznamu zásilek může majitel obchodu zobrazit všechny položky zásilky kliknutím na ![rozbalit](_static/shipping-management/order-shipment-expand.png) v prvním sloupci zásilky. ## Detaily zásilky Pokud kliknete na **Zobrazit** (View), otevře se okno *Zobrazit detaily zásilky* (View shipment details) takto: ![Detaily zásilky](_static/shipping-management/shipment-details.jpg) V tomto okně můžete: * Přejít k objednávce. * Nastavit **Sledovací číslo** (Tracking number) zásilky. * Přidat **Komentář administrátora** (Admin comment) pro interní použití. * Zobrazit **Celkovou hmotnost zásilky** (Shipment total weight). * Označit zásilku jako **Odeslanou** (Shipped). * Upravit **Datum odeslání** (Date shipped). * Označit zásilku jako **Doručenou** (Delivered). * Upravit **Datum doručení** (Date delivered). * **Vytisknout dodací list** (Print packaging slip). * **Smazat** (Delete) zásilku. Pokud zákazník během pokladny zvolil způsob dopravy „Vyzvednutí v obchodě“ (Pick up in store), budete moci zásilku označit jako „připravenou k vyzvednutí“. Na stránce *Zobrazit detaily zásilky* vypadá toto tlačítko takto: ![Detaily zásilky](_static/shipping-management/ready-for-pickup.jpg) ## Nastavení dopravy Chcete-li nastavit dopravu, navštivte sekci [Konfigurace dopravy](xref:cs/getting-started/configure-shipping/index). ## Viz také * [Objednávky](xref:cs/running-your-store/order-management/orders) * [Přidávání produktů](xref:cs/running-your-store/catalog/products/add-products) --- # Žádost o cenovou nabídku (RFQ) a podpora cenových nabídek ## Přehled Tato funkce je implementována jako samostatný plugin, který zákazníkům umožňuje odeslat **žádost o cenovou nabídku (RFQ)** na produkty v jejich nákupním košíku. Je užitečná zejména při vyjednávání množstevních slev nebo speciálních cen, které na webu jinak nejsou k dispozici. Administrátoři webu mohou v reakci na ni vytvořit a zákazníkovi odeslat formální **cenovou nabídku** (Quote) se speciální nabídkou. ## Nastavení a konfigurace Konfigurace pluginu je jednoduchá: - **Aktivace**: Celou funkci lze povolit nebo zakázat jediným nastavením. ![Obrázek](_static/rfq/configure.png) - **Řízení přístupu**: Oprávnění seznamu řízení přístupu (ACL) lze nakonfigurovat zvlášť pro veřejnou část obchodu a pro administraci a určit tak, kdo může funkci používat. ![Obrázek](_static/rfq/acl.png) ## Použití ### Postup zákazníka 1. **Zahájení RFQ**: Pokud je plugin aktivní a ACL to povolují, zobrazí se na stránce nákupního košíku nové tlačítko. ![Obrázek](_static/rfq/sc_request.png) Kliknutím na něj se uživatel dostane na formulář pro vytvoření RFQ. ![Obrázek](_static/rfq/sc_request_form.png) 1. **Úprava RFQ**: V tomto formuláři může uživatel žádost před odesláním upravit. RFQ se do databáze uloží až po odeslání. - Přidat k žádosti komentáře. - Navrhnout vlastní množství a cenu za jednotku pro každou položku. - Uživatel se může vrátit do košíku kliknutím na **„Zpět do nákupního košíku“** (Back to shopping cart). 1. **Odeslání RFQ**: Jakmile uživatel klikne na **„Odeslat žádost“** (Send request), RFQ je odeslána a uživatel ji již nemůže upravovat. Jedinými dostupnými akcemi jsou její zrušení nebo smazání. ![Obrázek](_static/rfq/sc_request_form_create.png) 1. **Správa RFQ a cenových nabídek**: Po odeslání žádosti se v sekci uživatelského účtu objeví dvě nové položky menu: - **„Žádosti o cenovou nabídku“** (Requests for quote): Seznam všech odeslaných RFQ. ![Obrázek](_static/rfq/sc_request_list.png) - **„Cenové nabídky“** (Quotes): Seznam všech nabídek obdržených od administrátora obchodu. Při odeslání nové cenové nabídky obdrží uživatel e-mailové upozornění. ![Obrázek](_static/rfq/customer_q_list.png) 1. **Vytvoření objednávky z cenové nabídky**: Pokud je obdržená cenová nabídka přijatelná a nevypršela její platnost, může uživatel kliknout na **„Vytvořit objednávku“** (Create the order). ![Obrázek](_static/rfq/customer_q_create_order.png) Tato akce provede následující: - Aktuální nákupní košík uživatele se vyprázdní. - Vytvoří se nový košík obsahující přesně ty položky a ceny, které jsou uvedeny v cenové nabídce. - Uživatel pokračuje standardním procesem pokladny. 1. **Omezení režimu cenové nabídky**: - Jakmile je košík vygenerován z cenové nabídky, považuje se za košík v „režimu cenové nabídky“. - Uživatel nemůže do košíku přidávat další položky ani měnit položky z cenové nabídky. Pokus o to zruší režim cenové nabídky a vyprázdní košík. - Uživatel může kliknout na **„Ukončit režim cenové nabídky“** (Exit quote mode), čímž vyprázdní košík a vrátí se na hlavní stránku obchodu. ![Obrázek](_static/rfq/sc_by_q.png) ### Postup administrátora 1. **Upozornění a správa**: Když uživatel odešle RFQ, majitel obchodu obdrží e-mailové upozornění. V administraci se objeví dvě nové položky menu pro správu RFQ a cenových nabídek, které vedou na jejich příslušné seznamy. ![Obrázek](_static/rfq/admin_rfq.png) 1. **Kontrola RFQ**: V seznamu RFQ může administrátor zobrazit podrobnosti žádosti uživatele. Na stránce úprav může administrátor: - Upravit libovolnou položku produktu. - Odstranit položku ze žádosti. - Zrušit nebo smazat celou RFQ. ![Obrázek](_static/rfq/admin_rfq_edit.png) 1. **Vytvoření cenové nabídky**: - **Z RFQ**: Administrátor může RFQ přímo převést na cenovou nabídku kliknutím na tlačítko **„Vytvořit cenovou nabídku“** (Create the quote) na stránce podrobností RFQ. ![Obrázek](_static/rfq/admin_rfq_create_q.png) - **Od začátku**: Novou cenovou nabídku lze vytvořit také samostatně ze stránky hlavního seznamu cenových nabídek. 1. **Úprava cenové nabídky**: Na stránce úpravy cenové nabídky může administrátor: - Upravit existující data produktů. - Přidat nové produkty ve dvou krocích: - nejprve vyhledat produkt; ![Obrázek](_static/rfq/admin_create_q.png) - poté nastavit požadované množství a cenu; ![Obrázek](_static/rfq/admin_create_q_product.png) - Nastavit datum vypršení platnosti nabídky. Po tomto datu z ní uživatel již nemůže vytvořit objednávku. 1. **Odeslání cenové nabídky**: Cenová nabídka je uložena v databázi, ale zůstává před uživatelem skrytá, dokud administrátor neklikne na **„Odeslat cenovou nabídku“** (Send quote). Po odeslání obdrží uživatel e-mailové upozornění. 1. **Pravidla po odeslání**: - Jakmile je cenová nabídka odeslána uživateli, administrátor ji již nemůže upravovat. - Odeslanou cenovou nabídku lze smazat pouze tehdy, pokud z ní uživatel dosud nevytvořil objednávku. --- # Žádosti o vrácení Funkce žádostí o vrácení umožňuje zákazníkům požádat o vrácení dříve zakoupených položek. Tyto žádosti jsou známé také jako žádosti RMA. Tato možnost je dostupná pouze pro dokončené objednávky. Nastavení žádostí o vrácení se spravuje v **Konfigurace → Nastavení → Nastavení objednávek** (Configuration → Settings → Order settings) na panelu *Nastavení žádostí o vrácení* (Return request settings). Chcete-li žádosti o vrácení povolit, zaškrtněte políčko **Povolit systém vracení** (Enable returns system). Je-li tato možnost povolena, zobrazí se u dokončených objednávek na stránce detailu objednávky ve veřejné části obchodu tlačítko **Vrátit položku(y)** (Return item(s)). Chcete-li přejít k [části s nastavením žádostí o vrácení, klikněte sem](#return-request-settings). V následujících částech popíšeme, jak mohou funkci žádostí o vrácení využívat vaši zákazníci a jak žádosti o vrácení spravovat v administraci. ## Odeslání žádosti o vrácení Pro odeslání žádosti o vrácení by měl zákazník provést následující kroky: 1. Ve veřejné části obchodu přejde do okna *Můj účet* a klikne na **Objednávky**. Zobrazí se následující stránka: ![Můj účet – Objednávky](_static/return-requests/my-account-orders.jpg) 1. Klikne na tlačítko **Vrátit položku(y)** vedle dokončené objednávky, kterou chce vrátit. Zobrazí se okno *Vrácení položek z objednávky č.*, jak ukazuje následující příklad: ![Vrácení položek](_static/return-requests/return-items.jpg) * Rozevírací seznam **Množství k vrácení** (Qty to return) umožňuje vybrat počet vracených položek. * Rozevírací seznam **Důvod vrácení** (Return reason) umožňuje vybrat důvod žádosti o vrácení. Například objednán nesprávný produkt, doručen nesprávný produkt a další. Jak spravovat důvody vrácení, si přečtěte [níže](#return-request-settings). * Rozevírací seznam **Akce vrácení** (Return action) umožňuje vybrat požadovanou akci. Například oprava produktu, výměna produktu, vystavení dobropisu a další. Jak spravovat akce vrácení, si přečtěte [níže](#return-request-settings). * Možnost **Nahrát soubor** (Upload a file) použijte, chcete-li k žádosti přiložit další dokumenty nebo obrázky. > [!NOTE] > > Tato možnost je dostupná pouze tehdy, když je zaškrtnuto políčko **Povolit nahrávání souborů** (Allow file uploads). Jak to nastavit, si přečtěte [níže](#return-request-settings). * Do pole **Komentáře** (Comments) může zákazník zadat volitelný komentář pro informaci. 1. Po využití funkce žádosti o vrácení může zákazník vytvořené žádosti o vrácení a jejich stavy zobrazit na stránce *Můj účet* ve veřejné části obchodu kliknutím na **Žádosti o vrácení**: ![Žádosti o vrácení ve veřejné části](_static/return-requests/return-requests.jpg) ## Správa žádostí o vrácení Majitel obchodu nyní může tuto žádost o vrácení spravovat v administraci. Žádosti o vrácení zobrazíte a upravíte v **Prodej → Žádosti o vrácení** (Sales → Return requests). Všechny žádosti o vrácení se zobrazí takto: ![Žádosti o vrácení v administraci](_static/return-requests/return-requests-admin.jpg) Klikněte na **Upravit** (Edit) vedle žádosti o vrácení; zobrazí se okno *Upravit detaily žádosti o vrácení*: ![Úprava žádosti o vrácení](_static/return-requests/edit-return-request.jpg) Administrátor obchodu může: * Zobrazit **ID** žádosti o vrácení. * Zobrazit **Číslo objednávky** (Order #). Kliknutím na číslo objednávky přejdete na stránku detailu příslušné objednávky. * Zobrazit **Zákazníka** (Customer). Kliknutím na e-mail zákazníka přejdete na stránku detailu příslušného zákazníka. * Zobrazit **Produkt** (Product). Kliknutím na název produktu přejdete na stránku detailu příslušného produktu. * Zadat **Množství** (Quantity) vraceného produktu. * Vyplnit pole **Množství vrácené na sklad** (Quantity returned to stock). Představuje počet položek, které mají být vráceny na sklad. * Vybrat **Stav žádosti o vrácení** (Return request status): * *Čeká na vyřízení* (Pending) * *Přijato* (Received) * *Vrácení autorizováno* (Return authorized) * *Položka(y) opravena(y)* (Item(s) repaired) * *Položka(y) refundována(y)* (Item(s) refunded) * *Žádost zamítnuta* (Request rejected) * *Zrušeno* (Cancelled) * V poli **Důvod vrácení** (Reason for return) v případě potřeby upravit důvod vrácení. * V poli **Požadovaná akce** (Requested action) v případě potřeby upravit požadovanou akci. * V poli **Komentáře zákazníka** (Customer comments) v případě potřeby upravit komentář zadaný zákazníkem. * Do pole **Poznámky personálu** (Staff notes) zadat volitelnou poznámku pro informaci. Tyto poznámky se zákazníkovi nezobrazí. * Zobrazit **Datum** (Date), kdy byla žádost o vrácení odeslána. > [!NOTE] > > Kliknutím na tlačítko **Upozornit zákazníka na změnu stavu** (Notify customer about status change) odešlete zákazníkovi e-mail s informací o změně stavu žádosti o vrácení. ![Ovládací tlačítka](_static/return-requests/control-elements.png) ## Nastavení žádostí o vrácení Nastavení žádostí o vrácení definujete v **Konfigurace → Nastavení → Nastavení objednávek** (Configuration → Settings → Order settings). Tato stránka podporuje konfiguraci pro více obchodů; to znamená, že stejná nastavení lze definovat pro všechny obchody, nebo se mohou mezi obchody lišit. Chcete-li spravovat nastavení pro konkrétní obchod, vyberte jeho název v rozevíracím seznamu konfigurace pro více obchodů a zaškrtněte vlevo všechna potřebná políčka, abyste pro ně nastavili vlastní hodnoty. Další podrobnosti najdete v části [Více obchodů](xref:cs/getting-started/advanced-configuration/multi-store). Přejděte na panel *Nastavení žádostí o vrácení* (Return request settings): ![Nastavení žádostí o vrácení](_static/return-requests/return-request-settings.jpg) Na tomto panelu můžete definovat: * **Povolit systém vracení** (Enable returns system), aby zákazníci mohli odesílat žádosti o vrácení zakoupených položek. * V poli **Maska čísla žádosti o vrácení** (Return request number mask) v případě potřeby zadat vlastní číslo žádosti o vrácení. * **Počet dní, po které je žádost o vrácení dostupná** (Number of days that the return request is available) – nastavuje počet dní, po které bude odkaz na žádost o vrácení dostupný v zákaznické sekci. > [!TIP] > > Pokud například majitel obchodu umožňuje vrácení do 30 dnů od nákupu, nastaví se toto pole na 30. Když se zákazník přihlásí na web a podívá se do „Můj účet“, objednávky dokončené před více než 30 dny nebudou mít tlačítko **Vrátit položku(y)**. * Zaškrtněte políčko **Povolit nahrávání souborů** (Allow file uploads), chcete-li při odesílání žádosti o vrácení povolit nahrávání souborů (například obrázků). Tato možnost je užitečná zejména pro zákazníky, kteří mají s objednávkou nějaký problém, například obdrželi poškozené nebo nesprávné produkty. ### Důvody žádostí o vrácení Tento panel představuje seznam důvodů, ze kterých si zákazník může vybrat při odesílání žádosti o vrácení. ![Důvody žádostí o vrácení](_static/return-requests/return-request-reasons.jpg) Kliknutím na **Přidat nový** (Add new) přidáte nový důvod žádosti. Zobrazí se okno *Přidat nový důvod žádosti o vrácení*: ![Přidání důvodu žádosti o vrácení](_static/return-requests/add-reason.jpg) Zadejte **Název** (Name) důvodu žádosti o vrácení a číslo **Pořadí zobrazení** (Display order) (hodnota 1 představuje první položku v seznamu). Kliknutím na **Uložit** (Save) změny uložíte. ### Akce žádostí o vrácení Tento panel představuje seznam akcí, ze kterých si zákazník může vybrat při odesílání žádosti o vrácení. ![Akce žádostí o vrácení](_static/return-requests/return-request-actions.jpg) Kliknutím na **Přidat nový** (Add new) přidáte novou akci žádosti. Zobrazí se okno *Přidat novou akci žádosti o vrácení*: ![Přidání akce žádosti o vrácení](_static/return-requests/add-action.jpg) Zadejte **Název** (Name) akce žádosti o vrácení a číslo **Pořadí zobrazení** (Display order) (hodnota 1 představuje první položku v seznamu). Kliknutím na **Uložit** (Save) změny uložíte. ## Viz také * [Video návod na YouTube: správa žádostí o vrácení](https://www.youtube.com/watch?v=VqF2GZ2ip_0&list=PLnL_aDfmRHwsbhj621A-RFb1KnzeFxYz4&index=17) * [Nastavení objednávek](xref:cs/running-your-store/order-management/order-settings) * [Objednávky](xref:cs/running-your-store/order-management/orders) --- # Nákupní košíky a seznamy přání Sekce „Nákupní košíky a seznamy přání“ umožňuje majitelům obchodů zobrazit na jedné stránce všechny existující nákupní košíky a seznamy přání všech zákazníků ve všech obchodech. Na tuto stránku se dostanete přes **Prodej → Nákupní košíky a seznamy přání** (Sales → Shopping carts and wishlists). ![Nákupní košíky a seznamy přání](_static/shopping-carts-and-wishlists/list.jpg) V oblasti *Hledat* (Search) v horní části stránky vyberte požadovaný **Typ nákupního košíku** (Shopping cart type): *Nákupní košík* (Shopping cart) nebo *Seznam přání* (Wishlist). Produkty můžete rozbalit kliknutím na následující ikonu v prvním sloupci: ![Rozbalit](_static/shopping-carts-and-wishlists/icon.jpg). Ze seznamu můžete kliknutím na odkaz zákazníka přejít na stránku s podrobnostmi o zákazníkovi. Kliknutím na název produktu můžete také přejít na stránku úprav produktu nebo produkt z košíku odstranit kliknutím na tlačítko **Smazat** (Delete). ## Nákupní košík V rozbalovacím seznamu **Typ nákupního košíku** (Shopping cart type) na stránce **Prodej → Nákupní košíky a seznamy přání** vyberte *Nákupní košík* a kliknutím na **Hledat** (Search) zobrazte seznam nákupních košíků. Tento seznam obsahuje všechny produkty, které byly vloženy do košíků, ale nebyly zakoupeny. Následující snímek obrazovky ukazuje, jak zákazník vidí stránku nákupního košíku ve veřejné části obchodu: ![Nákupní košík ve veřejné části](_static/shopping-carts-and-wishlists/shopping-cart-public.jpg) Na stránce nákupního košíku je několik prvků. Některé z nich lze v případě potřeby vypnout: 1. Tlačítko ve sloupci **Odebrat** (Remove) umožňuje odebrat položku z nákupního košíku. 1. Tlačítko ve sloupci **Množství** (Qty.) umožňuje zákazníkovi změnit množství produktu zadáním příslušného čísla do pole **Množství**. 1. Tlačítko **Pokračovat v nákupu** (Continue shopping) umožňuje zákazníkovi přejít do katalogu. 1. Tlačítko **Odhadnout dopravu** (Estimate shipping) umožňuje zákazníkovi odhadnout cenu dopravy. Po kliknutí na toto tlačítko se zobrazí následující vyskakovací okno: ![Odhad dopravy](_static/shopping-carts-and-wishlists/estimate-shipping.jpg) V tomto okně může zákazník zadat doručovací adresu a zobrazit odpovídající možnosti dopravy. Odhad dopravy na stránce nákupního košíku můžete vypnout zrušením zaškrtnutí políčka **Povolit odhad dopravy (stránka košíku)** (Estimate shipping enabled (cart page)) na stránce **Konfigurace → Nastavení → Nastavení dopravy** (Configuration → Settings → Shipping settings). 1. Na výše uvedeném snímku nákupního košíku vidíte rozbalovací seznam **Dárkové balení** (Gift wrapping). Jde o atribut pokladny. Více o správě atributů pokladny se dočtete v kapitole [Atributy pokladny](xref:cs/running-your-store/order-management/checkout-attributes). 1. Sekce **Slevový kód** (Discount code) umožňuje zákazníkovi zadat slevový kód. To můžete vypnout zrušením zaškrtnutí políčka **Zobrazit pole pro slevu** (Show discount box) na stránce **Konfigurace → Nastavení → Nastavení nákupního košíku** (Configuration → Settings → Shopping cart settings). Více o slevách se dočtete v kapitole [Slevy](xref:cs/running-your-store/promotional-tools/discounts). 1. Sekce **Dárkové poukazy** (Gift cards) umožňuje zákazníkovi použít dárkový poukaz. To můžete vypnout zrušením zaškrtnutí políčka **Zobrazit pole pro dárkový poukaz** (Show gift card box) na stránce **Konfigurace → Nastavení → Nastavení nákupního košíku**. Více o dárkových poukazech se dočtete v kapitole [Dárkové poukazy](xref:cs/running-your-store/promotional-tools/gift-cards). 1. V sekci součtů nákupního košíku zákazník vidí poplatek za dopravu. Jak nastavit dopravu, se dočtete v části [Konfigurace dopravy](xref:cs/getting-started/configure-shipping/index). 1. Ve stejné sekci zákazník vidí informace o dani. Jak nastavit daně, se dočtete v části [Konfigurace daní](xref:cs/getting-started/configure-taxes/index). 1. Ve stejné sekci zákazník vidí, kolik věrnostních bodů získá. Jak nastavit věrnostní body, se dočtete v části [Věrnostní body](xref:cs/running-your-store/promotional-tools/reward-points). 1. Ve stejné sekci zákazník vidí obchodní podmínky. To můžete vypnout zrušením zaškrtnutí políčka **Obchodní podmínky (stránka nákupního košíku)** (Terms of service (shopping cart page)) na stránce **Konfigurace → Nastavení → Nastavení objednávek** (Configuration → Settings → Order settings). > [!NOTE] > > Pokud nechcete zákazníkům umožnit přidat určitý produkt do nákupního košíku, zaškrtněte políčko **Zakázat tlačítko koupit** (Disable buy button) na panelu *Ceny* (Prices) na stránce úprav produktu. Více o přidávání produktů se dočtete v kapitole [Přidání produktů](xref:cs/running-your-store/catalog/products/add-products). > > [!NOTE] > > Podívejte se na náš [marketplace](http://www.nopcommerce.com/marketplace), kde najdete pluginy, které vám pomohou spravovat opuštěné košíky a získat zpět ztracené prodeje. ## Seznam přání V rozbalovacím seznamu **Typ nákupního košíku** (Shopping cart type) na stránce **Prodej → Nákupní košíky a seznamy přání** vyberte možnost *Seznam přání* a kliknutím na **Hledat** (Search) zobrazte seznamy přání. Seznam přání je seznam produktů, který může zákazník sdílet s přáteli nebo si jej uložit a později přesunout do košíku. Pokud je u produktu povoleno přidání do seznamu přání, zobrazí se na stránce s detailem produktu ve veřejné části obchodu tlačítko **Přidat do seznamu přání** (Add to wishlist). Když je do seznamu přání přidán produkt s různými variantami, budou v seznamu přání zahrnuty všechny varianty, které zákazník zvolil. > [!TIP] > > Pokud například zákazník přidá stejnou košili ve 2 různých barvách, každá košile se v seznamu přání zobrazí jako samostatná položka. Pokud zákazník přidá stejný produkt do seznamu přání vícekrát, produkt se zobrazí pouze jednou, ale s aktualizovaným množstvím, které odpovídá počtu přidání. Následující snímek obrazovky ukazuje, jak zákazník vidí stránku seznamu přání ve veřejné části obchodu: ![Seznam přání ve veřejné části](_static/shopping-carts-and-wishlists/wishlist-public.jpg) Na stránce seznamu přání je několik prvků: 1. Tlačítko ve sloupci **Odebrat** (Remove) umožňuje odebrat položku ze seznamu přání. 1. Tlačítko **Aktualizovat seznam přání** (Update wishlist) umožňuje zákazníkovi změnit množství produktu zadáním příslušného čísla do pole **Množství** (Qty). 1. Tlačítko **Přidat do košíku** (Add to cart) umožňuje zákazníkovi přidat vybrané produkty do košíku. 1. Tlačítko **Poslat příteli e-mailem** (Email a friend) umožňuje zákazníkovi poslat seznam přání příteli e-mailem. To můžete vypnout zrušením zaškrtnutí políčka **Povolit zákazníkům posílat seznamy přání e-mailem** (Allow customers to email their wishlists) na stránce **Konfigurace → Nastavení → Nastavení nákupního košíku** (Configuration → Settings → Shopping cart settings). 1. **URL vašeho seznamu přání pro sdílení** (Your wishlist URL for sharing) umožňuje zákazníkovi seznam přání sdílet. > [!NOTE] > > Pokud nechcete zákazníkovi umožnit přidat určitý produkt do seznamu přání, zaškrtněte políčko **Zakázat tlačítko seznamu přání** (Disable wishlist button) na panelu *Ceny* (Prices) na stránce úprav produktu. Více o přidávání produktů se dočtete v kapitole [Přidání produktů](xref:cs/running-your-store/catalog/products/add-products). ### Více seznamů přání Registrovaní zákazníci mohou vytvářet a spravovat více seznamů přání, což umožňuje lepší uspořádání požadovaných produktů. Ve výchozím nastavení má každý zákazník „Seznam přání“, který nelze přejmenovat ani smazat. Základní pojmy: - **Výchozí seznam přání:** Každý registrovaný zákazník má jeden výchozí seznam přání s názvem „Seznam přání“. Tento seznam je trvalý a nelze jej změnit ani odstranit. - **Vlastní seznam přání:** Registrovaní uživatelé mohou vytvářet další, personalizované seznamy přání. Ty mohou uživatelé pojmenovat, spravovat a mazat. Uživatelské scénáře: 1. Zobrazení seznamů přání ![Zobrazení seznamů přání](_static/shopping-carts-and-wishlists/viewing-wishlists.png) - Po přechodu na hlavní stránku seznamu přání se zobrazí produkty obsažené ve výchozím „Seznamu přání“. - Na této stránce je také viditelný seznam všech vytvořených vlastních seznamů přání. - Výběrem vlastního seznamu přání se zobrazení aktualizuje tak, aby ukazovalo pouze produkty obsažené v tomto konkrétním seznamu. 1. Vytvoření vlastního seznamu přání ![obrázek](_static/shopping-carts-and-wishlists/add-custom-wishlist.png) - Nové seznamy přání mohou vytvářet pouze registrovaní uživatelé. - Na hlavní stránce seznamu přání je k dispozici možnost „Vytvořit nový seznam přání“. - Uživatelé mohou svému novému seznamu přání zadat vlastní název. 1. Smazání vlastního seznamu přání ![obrázek](_static/shopping-carts-and-wishlists/delete-custom-wishlist.png) - Při zobrazení obsahu vlastního seznamu přání bude k dispozici tlačítko „Smazat“. - Před trvalým smazáním seznamu přání se uživateli zobrazí výzva k potvrzení. > [!NOTE] > Výchozí „Seznam přání“ nelze smazat. 1. Přidání produktů do seznamu přání Postup přidání produktů do seznamu přání (např. kliknutím na ikonu „srdce“ na stránce produktu nebo katalogu) se liší podle toho, zda uživatel vytvořil vlastní seznamy přání. **Scénář 1: Neexistují žádné vlastní seznamy přání** - Když uživatel přidá produkt do seznamu přání, automaticky se přidá do výchozího „Seznamu přání“. **Scénář 2: Existuje alespoň jeden vlastní seznam přání** ![obrázek](_static/shopping-carts-and-wishlists/add-to-list.png) - Produkt se i v tomto případě okamžitě přidá do výchozího „Seznamu přání“. - Po přidání se zobrazí oznámení potvrzující, že byl produkt přidán. Toto oznámení bude obsahovat odkaz, například „Přesunout do vlastního seznamu přání“. - Kliknutím na tento odkaz se otevře vyskakovací okno, ve kterém může uživatel: - Vybrat existující vlastní seznam přání, do kterého se produkt přesune. - Zvolit vytvoření nového seznamu přání, který bude produkt obsahovat. - Po výběru cíle může být uživatel přesměrován na zvolený seznam přání nebo může pokračovat v nákupu. 1. Přesun produktů mezi seznamy přání ![obrázek](_static/shopping-carts-and-wishlists/move-to-list.png) - Tato funkce je k dispozici pouze tehdy, když uživatel vytvořil alespoň jeden vlastní seznam přání. - Na stránce seznamu přání bude u každé položky produktu rozbalovací nabídka. - Tato nabídka obsahuje všechny dostupné seznamy přání (včetně výchozího „Seznamu přání“). - Výběrem seznamu přání z rozbalovací nabídky se produkt přesune ze svého aktuálního seznamu do vybraného. ## Nastavení nákupního košíku a seznamu přání Chcete-li změnit nastavení nákupního košíku a seznamu přání, přejděte na stránku **Konfigurace → Nastavení → Nastavení nákupního košíku** (Configuration → Settings → Shopping cart settings). Tato stránka umožňuje konfiguraci pro více obchodů; to znamená, že stejná nastavení lze definovat pro všechny obchody, nebo se mohou mezi obchody lišit. Pokud chcete spravovat nastavení pro určitý obchod, vyberte jeho název z rozbalovacího seznamu konfigurace pro více obchodů a zaškrtněte vlevo všechna potřebná políčka, abyste pro ně nastavili vlastní hodnoty. Další podrobnosti naleznete v článku [Více obchodů](xref:cs/getting-started/advanced-configuration/multi-store). ### Obecná nastavení Na panelu *Obecné* (Common) můžete definovat: ![Obecné](_static/shopping-carts-and-wishlists/common.png) - **Zobrazit pole pro slevu** (Show discount box) – zobrazí na stránce nákupního košíku pole pro slevový kupón. - **Zobrazit pole pro dárkový poukaz** (Show gift card box) – zobrazí na stránce nákupního košíku pole pro dárkový poukaz. - **Povolit úpravu položek košíku** (Allow cart item editing) – umožní zákazníkům upravovat položky v košíku. Tato funkce je užitečná, pokud mají produkty hodnoty zadávané zákazníky. - **Maximální počet položek v nákupním košíku** (Maximum shopping cart items) – maximální počet produktů, které je povoleno přidat do nákupního košíku. - Zaškrtnutím políčka **Košíky sdílené mezi obchody** (Carts shared between stores) budou nákupní košíky (a seznamy přání) sdíleny mezi obchody. - **Zobrazit obrázky produktů v košíku** (Show product images on cart) – zobrazí obrázky produktů v nákupních košících obchodu. - **Zobrazit košík po přidání produktu** (Display cart after adding a product) – zobrazí stránku nákupního košíku ihned po přidání produktu do košíku. Pokud toto políčko není zaškrtnuto, zákazník zůstane na stránce, kde produkt do košíku přidal. - **Počet produktů křížového prodeje** (Number of cross-sells), které chcete zobrazit na stránce pokladny nákupního košíku ve veřejné části obchodu. Pokud nechcete produkty křížového prodeje zobrazovat, zadejte 0. ### Nastavení mini nákupního košíku Na panelu *Mini nákupní košík* (Mini shopping cart) můžete definovat: ![mini-nakupni-kosik](_static/shopping-carts-and-wishlists/mini-shopping-cart.png) - **Zobrazit mini nákupní košík** (Show mini-shopping cart) – rozbalovací nabídka, která se zobrazí v pravém horním rohu hlavního okna při najetí myší na odkaz „Nákupní košík“, jak je vidět níže: ![Košík](_static/shopping-carts-and-wishlists/cart.png) Je-li toto pole zaškrtnuto, zobrazí se následující pole: - **Počet produktů v mini nákupním košíku** (Number of products in mini-shopping cart) – maximální počet produktů zobrazených v rozbalovací nabídce mini nákupního košíku ve veřejné části obchodu. - **Zobrazit obrázky produktů v mini nákupním košíku** (Show product images in mini shopping cart) – určuje, zda se v rozbalovací nabídce mini nákupního košíku zobrazují obrázky. ### Nastavení seznamu přání Na panelu *Seznam přání* (Wishlist) můžete definovat: ![Seznam přání](_static/shopping-carts-and-wishlists/wishlist.png) - **Maximální počet položek v seznamu přání** (Maximum wishlist items) – maximální počet různých produktů, které je povoleno přidat do seznamu přání. - **Zobrazit obrázky produktů v seznamu přání** (Show product images on wishlist) – zobrazí obrázky produktů v seznamech přání zákazníků. - **Povolit zákazníkům posílat seznam přání e-mailem** (Allow customers to email their wishlist) přátelům. Je-li toto pole povoleno, zobrazí se následující pole: - **Povolit hostům posílat seznam přání e-mailem** (Allow guests to email their wishlist) přátelům. - **Povolit více seznamů přání** (Allow multiple wishlists) – určuje, zda mohou zákazníci používat více seznamů přání. - **Maximální počet vlastních seznamů přání** (Maximum number of custom wishlists) – udává počet vlastních seznamů přání, které může zákazník používat. - **Povolit přidávání položek, které nejsou skladem, do seznamu přání** (Allow 'out of stock' items to be added to the wishlist). - Zaškrtnutím políčka **Přesunout položky ze seznamu přání do košíku** (Move items from wishlist to cart) se produkty po kliknutí na tlačítko „Přidat do košíku“ přesunou ze seznamu přání do košíku. V opačném případě se zkopírují. - **Zobrazit seznam přání po přidání produktu** (Display wishlist after adding a product) – zobrazí stránku seznamu přání ihned po přidání produktu do seznamu přání. Pokud toto políčko není zaškrtnuto, zákazník zůstane na stránce, kde produkt do seznamu přání přidal. ## Viz také - [Objednávky](xref:cs/running-your-store/order-management/orders) - [Propagační nástroje](xref:cs/running-your-store/promotional-tools/index) ## Výukové materiály - [Přehled seznamů přání v nopCommerce](https://www.youtube.com/watch?v=9EN7oZSwIVE) --- # Správa skladových zásob Správa skladových zásob je systém řízení stavu zásob. V nopCommerce se skládá z nastavení skladových zásob a sledování nízkých zásob. Skladové zásoby nastavíte v **Katalog → Produkty → Upravit produkt** (Catalog → Products → Edit a product). V okně *Upravit detaily produktu* přejděte na panel *Skladové zásoby* (Inventory). Na tomto panelu můžete zvolit jednu ze tří metod správy zásob: 1. [Nesledovat skladové zásoby](#dont-track-inventory) 1. [Sledovat skladové zásoby](#track-inventory) 1. [Sledovat skladové zásoby podle atributů produktu](#track-inventory-by-product-attributes) V následujících částech si ukážeme rozdíly mezi těmito metodami. ## Nesledovat skladové zásoby Některé produkty nemusí sledování skladových zásob vyžadovat. Například služby, zboží z druhé ruky nebo zboží vyráběné na zakázku. V takovém případě se majitel obchodu může rozhodnout zásoby nesledovat výběrem možnosti *Nesledovat skladové zásoby* (Don't track inventory) v poli **Metoda správy zásob** (Inventory method). ![Nesledovat skladové zásoby](_static/inventory-management/inventory.png) V tomto případě může majitel obchodu definovat: - **Sklad** (Warehouse), který se použije při výpočtu cen dopravy. Více se dočtete v kapitole [Sklady](xref:cs/getting-started/configure-shipping/advanced-configuration/warehouses). - **Minimální množství v košíku** (Minimum cart qty) je množství povolené v nákupním košíku zákazníka; například nastavte 3, chcete-li zákazníkům povolit nákup pouze 3 a více kusů tohoto produktu. - **Maximální množství v košíku** (Maximum cart qty) je množství povolené v nákupním košíku zákazníka; například nastavte 5, chcete-li zákazníkům povolit nákup pouze 5 nebo méně kusů tohoto produktu. - Do pole **Povolená množství** (Allowed quantities) zadejte čárkami oddělený seznam množství, na která chcete tento produkt omezit. Místo textového pole pro množství, do kterého lze zadat libovolné množství, se zákazníkům zobrazí rozevírací seznam s hodnotami, které zde zadáte. - Zaškrtněte políčko **Nevratné** (Not returnable), pokud tento produkt nelze vrátit. V takovém případě zákazník nebude moci odeslat žádost o vrácení. ## Sledovat skladové zásoby Pokud je sledování skladových zásob nutné, může majitel obchodu v poli **Metoda správy zásob** (Inventory method) vybrat jednu ze dvou možností: *Sledovat skladové zásoby* (Track inventory) (podle produktu) nebo *Sledovat skladové zásoby podle atributů produktu* (Track inventory by product attributes). Možnost *Sledovat skladové zásoby* je určena pro ty, kteří nemají varianty produktu a potřebují jednoduše vědět, kolik kusů zbývá. V této části popíšeme možnost *Sledovat skladové zásoby*. Po výběru této možnosti se sekce rozbalí a zobrazí nová pole: ![Sledovat skladové zásoby](_static/inventory-management/track-inventory.jpg) Skladové zásoby nastavte takto: - **Množství na skladě** (Stock quantity) je celkové množství. Snižuje se při každém odeslání objednávky. - Zvolte **Sklad** (Warehouse), který se použije při výpočtu cen dopravy. Sklady můžete spravovat na stránce **Konfigurace → Doprava → Sklady** (Configuration → Shipping → Warehouses). Další podrobnosti najdete na stránce [Sklady](xref:cs/getting-started/configure-shipping/advanced-configuration/warehouses). - Zaškrtněte políčko **Více skladů** (Multiple warehouses), chcete-li podporovat dopravu a správu zásob z více skladů. Tímto způsobem můžete spravovat zásoby pro jednotlivé sklady: ![Více skladů](_static/inventory-management/multiple-warehouses.jpg) Klikněte na **Použít** (Use) v příslušném řádku, chcete-li tento sklad pro produkt použít. - Zadejte **Množství na skladě** (Stock qty), což je celkové množství. Snižuje se při každém odeslání objednávky. - Zadejte **Rezervované množství** (Reserved qty), což je množství produktu, které je objednané, ale dosud nebylo odesláno ani přidáno do zásilky. - **Plánované množství** (Planned qty) je množství produktu, které je objednané a již přidané do zásilky, ale dosud nebylo odesláno. - Abyste zabránili tomu, že zákazníci zadají objednávku a teprve pak zjistí, že produkt není skladem, můžete podniknout určité kroky. Zaškrtnutím políčka **Zobrazit dostupnost** (Display availability) zobrazíte dostupnost zásob ve veřejné části obchodu. - V případě potřeby zaškrtněte políčko **Zobrazit množství na skladě** (Display stock quantity), aby zákazníci viděli množství produktu na skladě na stránce detailu produktu (toto políčko se zobrazí pouze tehdy, když je zaškrtnuto políčko **Zobrazit dostupnost**). Následující snímek obrazovky ukazuje, co zákazník uvidí ve veřejné části obchodu: ![Dostupnost](_static/inventory-management/stock-quantity.png) - Do pole **Minimální množství na skladě** (Minimum stock qty) zadejte minimální hodnotu, při jejímž poklesu budou provedeny další akce. - V rozevíracím seznamu **Akce při nízkém stavu zásob** (Low stock activity) vyberte akci, která se provede, když množství na skladě klesne pod hodnotu minimálního množství na skladě: - **Nic** (Nothing): majitelé obchodů se mohou rozhodnout neprovádět žádnou akci. To znamená, že zákazníci mohou produkty dál objednávat. - **Deaktivovat tlačítko Koupit** (Disable buy button): při nízkém stavu zásob se tlačítko pro nákup deaktivuje. Zákazníci tedy tento produkt nemohou koupit, ale stále jej v obchodě vidí. - **Zrušit publikování** (Unpublish): produkt již v obchodě není viditelný. Používá se, když se má prodej produktu úplně ukončit. - Do pole **Upozornit při množství pod** (Notify for qty below) zadejte hodnotu, při jejímž poklesu se administrátorovi odešle upozornění e-mailem. - Majitelé obchodů mohou nastavit **Objednávky na dobírku zásob** (Backorders), tj. objednávky, které nelze v okamžiku nákupu vyřídit. V rozevíracím seznamu vyberte požadovaný režim: - **Bez objednávek mimo sklad** (No backorders): zákazníci nemohou tento produkt koupit, pokud není skladem. - **Povolit množství pod 0** (Allow qty below 0): zákazníci mohou tento produkt koupit, i když není skladem. - **Povolit množství pod 0 a upozornit zákazníka** (Allow qty below 0 and notify customer): zákazníci mohou tento produkt koupit, i když není skladem. Navíc obdrží upozornění s následující zprávou: *Není skladem – objednáno, bude odesláno po naskladnění (v tomto případě by měla být povolena také možnost **Zobrazit dostupnost**)*. - Zaškrtnutím **Povolit odběr upozornění na naskladnění** (Allow back in stock subscriptions) umožníte zákazníkům přihlásit se k odběru upozornění na dostupnost produktu, jak ukazuje snímek obrazovky níže: ![Odběr](_static/inventory-management/stock-subscription.png) - Zvolte **Rozsah dostupnosti produktu** (Product availability range), který se zákazníkům zobrazí, když produkt momentálně není k dispozici. Rozsahy dostupnosti můžete nastavit na panelu *Rozsahy dostupnosti produktů* na stránce **Konfigurace → Doprava → Data a rozsahy** (Configuration → Shipping → Dates and ranges). Další podrobnosti najdete na stránce [Data a rozsahy](xref:cs/getting-started/configure-shipping/advanced-configuration/dates-and-ranges). - **Minimální množství v košíku** (Minimum cart qty) je množství povolené v nákupním košíku zákazníka; například nastavte 3, chcete-li zákazníkům povolit nákup pouze 3 a více kusů tohoto produktu. - **Maximální množství v košíku** (Maximum cart qty) je množství povolené v nákupním košíku zákazníka; například nastavte 5, chcete-li zákazníkům povolit nákup pouze 5 nebo méně kusů tohoto produktu. - Do pole **Povolená množství** (Allowed quantities) zadejte čárkami oddělený seznam množství, na která chcete tento produkt omezit. Místo textového pole pro množství, do kterého lze zadat libovolné množství, se zákazníkům zobrazí rozevírací seznam s hodnotami, které zde zadáte. - Zaškrtněte políčko **Nevratné** (Not returnable), pokud tento produkt nelze vrátit. V takovém případě zákazník nebude moci odeslat žádost o vrácení. ## Sledovat skladové zásoby podle atributů produktu Pokud máte různé kombinace atributů produktu a potřebujete sledovat jejich množství na skladě, vyberte metodu správy zásob *Sledovat skladové zásoby podle atributů produktu* (Track inventory by product attributes). Po výběru této možnosti se sekce rozbalí a zobrazí nová pole: ![Sledovat skladové zásoby podle atributů produktu](_static/inventory-management/track-inventory-attributes.jpg) - Zvolte **Sklad** (Warehouse), který se použije při výpočtu cen dopravy. Sklady můžete spravovat na stránce **Konfigurace → Doprava → Sklady** (Configuration → Shipping → Warehouses). Další podrobnosti najdete na stránce [Sklady](xref:cs/getting-started/configure-shipping/advanced-configuration/warehouses). - Abyste zabránili tomu, že zákazníci zadají objednávku a teprve pak zjistí, že produkt není skladem, můžete podniknout určité kroky. Zaškrtnutím políčka **Zobrazit dostupnost** (Display availability) zobrazíte dostupnost zásob ve veřejné části obchodu. - V případě potřeby zaškrtněte políčko **Zobrazit množství na skladě** (Display stock quantity), aby zákazníci viděli množství produktu na skladě na stránce detailu produktu (toto políčko se zobrazí pouze tehdy, když je zaškrtnuto políčko **Zobrazit dostupnost**). Následující snímek obrazovky ukazuje, co zákazník uvidí ve veřejné části obchodu: ![Dostupnost](_static/inventory-management/stock-quantity.png) - Zvolte **Rozsah dostupnosti produktu** (Product availability range), který se zákazníkům zobrazí, když produkt momentálně není k dispozici. Rozsahy dostupnosti můžete nastavit na panelu *Rozsahy dostupnosti produktů* na stránce **Konfigurace → Doprava → Data a rozsahy** (Configuration → Shipping → Dates and ranges). Další podrobnosti najdete na stránce [Data a rozsahy](xref:cs/getting-started/configure-shipping/advanced-configuration/dates-and-ranges). - **Minimální množství v košíku** (Minimum cart qty) je množství povolené v nákupním košíku zákazníka; například nastavte 3, chcete-li zákazníkům povolit nákup pouze 3 a více kusů tohoto produktu. - **Maximální množství v košíku** (Maximum cart qty) je množství povolené v nákupním košíku zákazníka; například nastavte 5, chcete-li zákazníkům povolit nákup pouze 5 nebo méně kusů tohoto produktu. - Do pole **Povolená množství** (Allowed quantities) zadejte čárkami oddělený seznam množství, na která chcete tento produkt omezit. Místo textového pole pro množství, do kterého lze zadat libovolné množství, se zákazníkům zobrazí rozevírací seznam s hodnotami, které zde zadáte. - Zaškrtnutím **Povolit pouze existující kombinace atributů** (Allow only existing attribute combinations) povolíte přidávat do košíku/seznamu přání pouze existující kombinace atributů s množstvím na skladě větším než 0. V takovém případě musíte vytvořit všechny kombinace atributů produktu, které máte skladem. - Zaškrtněte políčko **Nevratné** (Not returnable), pokud tento produkt nelze vrátit. V takovém případě zákazník nebude moci odeslat žádost o vrácení. > [!NOTE] > > Chcete-li nastavit **Množství na skladě** (Stock quantity) pro různé kombinace atributů, přejděte na stránce úpravy detailů produktu na záložku **Kombinace atributů** (Attribute combinations) panelu *Atributy produktu*. Na této záložce můžete u konkrétní kombinace atributů určit, zda **Povolit vyprodáno** (Allow out of stock), aby bylo možné objednávky schválit, i když produkt není skladem. ![Kombinace atributů](_static/inventory-management/atribute-combinations.jpg) > > [!TIP] > > Produkty, kterých je aktuálně nedostatek, můžete sledovat v **Reporty → Nízký stav zásob** (Reports → Low stock). > Report nízkého stavu zásob obsahuje seznam produktů, kterých je aktuálně nedostatek, tj. jejich množství na skladě je rovno nebo menší než minimální množství na skladě nastavené v sekci *Skladové zásoby* na stránce detailu produktu. ![Nízký stav zásob](_static/inventory-management/low-stock.png) Kliknutím na **Zobrazit** (View) zobrazíte stránku detailu produktu, kde lze tato nastavení zásob změnit. Další podrobnosti o reportech v nopCommerce najdete na stránce [Reporty](xref:cs/running-your-store/reports). ## Viz také - [Atributy produktu](xref:cs/running-your-store/catalog/products/product-attributes) - [Sklady](xref:cs/getting-started/configure-shipping/advanced-configuration/warehouses) ## Návody - [Správa objednávek mimo sklad (backorders) v nopCommerce](https://www.youtube.com/watch?v=CMhQ39clCKM) --- # Atributy pokladny Atributy pokladny představují dodatečné informace k objednávce, které se shromažďují v závěrečné fázi nákupního procesu. > [!TIP] > > Pomocí atributů pokladny mohou majitelé obchodů například určit, zda zakoupený produkt vyžaduje dárkové balení nebo opatrné zacházení, jako v případě křehkého zboží. Atributy pokladny se zobrazují na stránce nákupního košíku a umožňují uživatelům je v případě potřeby vybrat před pokladnou. Atributy pokladny nastavíte nebo upravíte v **Katalog → Atributy → Atributy pokladny** (Catalog → Attributes → Checkout attributes). ![Atributy pokladny](_static/checkout-attributes/list.jpg) Atributy pokladny můžete vybrat a smazat je kliknutím na tlačítko **Smazat (vybrané)** (Delete (selected)). ## Přidání nového atributu pokladny Nový atribut pokladny vytvoříte kliknutím na **Přidat nový** (Add new). Zobrazí se okno *Přidat nový atribut pokladny*: ![Přidat nový atribut pokladny](_static/checkout-attributes/add-new.jpg) Tato stránka je dostupná ve dvou režimech: **pokročilém** a **základním**. Přepněte do základního režimu, který zobrazuje pouze hlavní pole, nebo použijte pokročilý režim, který zobrazuje všechna dostupná pole. Na panelu *Informace o atributu* (Attribute info) vyplňte následující údaje: - **Název** (Name) — název atributu. - **Textová výzva** (Text prompt) — otázka nebo komentář, který se zobrazí v oblasti pokladny na stránce nákupního košíku. - V rozevíracím seznamu **Typ ovládacího prvku** (Control type) vyberte požadovaný způsob zobrazení hodnoty atributu, například *Rozevírací seznam*, *Seznam přepínačů*, *Zaškrtávací políčka*, *Textové pole*. > [!NOTE] > > Rozevírací seznamy, seznamy přepínačů, zaškrtávací políčka a barevné čtverečky vyžadují, aby majitel obchodu definoval hodnoty (například Zelená, Modrá, Červená a další). Typy ovládacích prvků *Textové pole* a *Výběr data* nevyžadují, aby majitel obchodu definoval hodnoty, protože zákazníci budou vyzváni k vyplnění těchto polí. U některých typů ovládacích prvků můžete navíc určit ověřovací pravidla. Například u atributu *Textové pole* můžete definovat **Minimální délku**, **Maximální délku** a **Výchozí hodnotu**. U atributu *Nahrání souboru* můžete definovat **Povolenou příponu souboru** a **Maximální velikost souboru (KB)**. - Zaškrtněte políčko **Povinné** (Required), pokud je výběr hodnoty atributu nutný před dokončením nákupu. - **Pořadí zobrazení** (Display order) — pořadové číslo zobrazení atributu pokladny. - Zaškrtněte políčko **Vyžadován odesílatelný produkt** (Shippable product required), pokud se má tento atribut zobrazovat pouze u produktu, který je třeba odeslat. - Zaškrtnuté políčko **Osvobozeno od daně** (Tax exempt) znamená, že se na tento atribut pokladny nebude uplatňovat žádná daň. - Pokud se daň uplatňuje, vyberte v rozevíracím seznamu **Daňová kategorie** (Tax category) daňovou kategorii atributu pokladny. - **Omezeno na obchody** (Limited to stores) umožňuje omezit atribut na jeden nebo více obchodů. > [!NOTE] > > Chcete-li tuto funkci použít, musíte vypnout následující nastavení: **Nastavení katalogu → Ignorovat pravidla „omezení na obchod“ (pro celý web)** (Catalog settings → Ignore "limit per store" rules (sitewide)). Přečtěte si více o [funkci více obchodů](xref:cs/getting-started/advanced-configuration/multi-store). Kliknutím na **Uložit a pokračovat v úpravách** (Save and continue edit) přejdete na panel *Hodnoty atributu* (pokud je k dispozici). ### Přidání nové hodnoty atributu pokladny Na panelu *Hodnoty atributu* (Attribute values) klikněte na **Přidat novou hodnotu atributu pokladny** (Add a new checkout attribute value) a vytvořte novou hodnotu atributu. ![Přidat novou hodnotu atributu pokladny](_static/checkout-attributes/value.jpg) V okně *Přidat novou hodnotu atributu pokladny* vyplňte následující údaje: - **Název** (Name) — název hodnoty atributu. > [!TIP] > > Například *Ano* nebo *Ne* pro otázky typu „Požadujete opatrné zacházení s křehkým zbožím?“ - **Úprava ceny** (Price adjustment) přičte zadanou částku k celkové částce nákupu, pokud je hodnota atributu vybrána. - **Úprava hmotnosti** (Weight adjustment) změní hmotnost objednávky o zadanou hodnotu, pokud je hodnota atributu vybrána. - Zaškrtnutím políčka **Předvybráno** (Pre-selected) určíte, že je hodnota atributu pro zákazníka předem vybraná. - **Pořadí zobrazení** (Display order) — pořadové číslo zobrazení hodnoty atributu. Hodnoty atributů můžete **Upravit** (Edit) a **Smazat** (Delete) kliknutím na příslušná tlačítka vedle atributů na panelu *Hodnoty atributu*. ![hodnoty atributu](_static/checkout-attributes/attribute_values.png) ## Přidání podmínky Na panelu *Podmínka* (Condition) může majitel obchodu určit podmínku, za které bude atribut pokladny viditelný (v závislosti na jiných atributech). Podmíněný atribut se zobrazí pouze tehdy, je-li vybrán předchozí atribut. ![podmínka](_static/checkout-attributes/condition.png) Klikněte na **Uložit** (Save). Nový atribut se zobrazí na stránce nákupního košíku ve veřejné části obchodu. ## Návody - [Přidávání atributů pokladny](https://www.youtube.com/watch?v=sJcZP1qjHmY&list=PLnL_aDfmRHwsbhj621A-RFb1KnzeFxYz4&index=3) - [Přehled podmíněných atributů pokladny](https://www.youtube.com/watch?v=z3UiXgK8Jgo&list=PLnL_aDfmRHwsbhj621A-RFb1KnzeFxYz4&index=18) --- # Nastavení objednávek Chcete-li definovat nastavení objednávek, přejděte do **Konfigurace → Nastavení → Nastavení objednávek** (Configuration → Settings → Order settings). Zobrazí se okno *Nastavení objednávek* (Order settings). Tato stránka umožňuje konfiguraci pro více obchodů; to znamená, že stejná nastavení lze definovat pro všechny obchody, nebo se mohou mezi obchody lišit. Pokud chcete spravovat nastavení pro určitý obchod, zvolte jeho název z rozevíracího seznamu konfigurace více obchodů a zaškrtněte vlevo všechna potřebná políčka, abyste pro ně nastavili vlastní hodnoty. Další podrobnosti naleznete v sekci [Více obchodů](xref:cs/getting-started/advanced-configuration/multi-store). V tomto okně můžete definovat následující nastavení objednávek: ## Pokladna Na panelu *Pokladna* (Checkout) definujte následující nastavení: ![Pokladna](_static/order-settings/checkout.jpg) * **Pokladna zakázána** (Checkout disabled) pro vypnutí procesu pokladny. * **Anonymní pokladna povolena** (Anonymous checkout allowed), která zákazníkům umožní nakupovat produkty bez registrace/přihlášení. * **Použít jednostránkovou pokladnu** (Use one page checkout), tedy jedinou webovou stránku, kterou by zákazníci používali k nákupu produktu nebo služby od vás. * **Celkové částky objednávky na kartě platebních údajů** (Order totals on payment info tab) pro zobrazení seznamu produktů a celkových částek objednávky na kartě platebních údajů (jednostránková pokladna). * Zda vyžadovat od zákazníků souhlas s **Obchodními podmínkami** (Terms of service) před zpracováním objednávky (**na stránce nákupního košíku**). * Zda vyžadovat od zákazníků souhlas s **Obchodními podmínkami** (Terms of service) před zpracováním objednávky (**na stránce potvrzení objednávky**). * **Vypnout krok „Fakturační adresa“** (Disable "Billing address" step) během pokladny. Fakturační adresa bude předvyplněna a uložena pomocí výchozích registračních údajů (nelze použít, je-li vybrána pokladna pro hosty). V **Konfigurace → Nastavení → Nastavení zákazníků** (Configuration → Settings → Customer settings) zajistěte, aby příslušná pole adresy, která nelze předvyplnit, nebyla povinná (nebo byla vypnutá). * **Vypnout stránku „Objednávka dokončena“** (Disable "Order completed" page) pro automatické přesměrování zákazníka na stránku s detaily objednávky po jejím odeslání. * **Zobrazit „Vyzvednutí v obchodě“ na stránce „Způsob dopravy“** (Display "Pickup in store" on "Shipping method" page) nebo na stránce doručovací adresy. ## Celkové částky objednávky Na panelu *Celkové částky objednávky* (Order totals) definujte následující nastavení: ![Celkové částky](_static/order-settings/totals.jpg) * **Minimální mezisoučet objednávky** (Min order sub-total amount). Objednávky pod touto částkou nebudou vystaveny. * **Vypočítat „Minimální mezisoučet objednávky“ včetně daně** (Calculate "Min order sub-total amount" including tax). V takovém případě bude mezisoučet objednávky při ověřování pole **Minimální mezisoučet objednávky** zadaného v předchozím kroku vypočítán včetně daně. * **Minimální celková částka objednávky** (Min order total amount). Objednávky pod touto částkou nebudou vystaveny. * **Automaticky aktualizovat celkové částky objednávky** (Auto update order totals), aby se celkové částky objednávky automaticky aktualizovaly při úpravě objednávky v administraci (v současné době v BETA testování). ## Obecné Na panelu *Obecné* (Common) definujte následující nastavení: ![Obecné](_static/order-settings/common.jpg) * Počítadlo **ID objednávky** (Order ID). To se hodí, pokud chcete, aby vaše objednávky začínaly určitým číslem. Ovlivní pouze objednávky vytvořené po nastavení. Hodnota musí být větší než aktuální maximální ID objednávky. * V poli **Maska čísla objednávky** (Order number mask) můžete vytvořit vlastní číslo objednávky. Například začínající {YYYY} — rokem data vytvoření objednávky. * **Je povoleno opakované objednání** (Is re-order allowed), které zákazníkům umožní objednat znovu. Mechanismus opakovaného objednání automaticky přidá do nákupního košíku všechny položky, které byly v předchozí objednávce. * **Dokončit objednávku při doručení** (Complete order when delivered) pro nastavení stavu objednávky na „Dokončeno“ (Complete) pouze tehdy, když je její stav dopravy „Doručeno“ (Delivered). V opačném případě bude stačit stav „Odesláno“ (Shipped). * **Exportovat objednávky s produkty** (Export orders with products). * **Povolit administrátorům kupovat produkty „Cena na dotaz“** (Allow admins to buy "Call for price" products), které administrátorům (v režimu vystupování jako zákazník) umožní kupovat produkty označené jako „Cena na dotaz“. * **Zobrazit náhled produktu na stránce s detaily objednávky** (Show product thumbnail in order details page) pro zobrazení náhledu produktu na stránce s detaily objednávky. ## PDF faktura Na panelu *PDF faktura* (PDF invoice) definujte následující nastavení: ![PDF faktura](_static/order-settings/pdf-invoice.jpg) * **Přiložit PDF fakturu (e-mail „objednávka odeslána“)** (Attach PDF invoice ("order placed" email)). * **Přiložit PDF fakturu (e-mail „objednávka zaplacena“)** (Attach PDF invoice ("order paid" email)). * **Přiložit PDF fakturu (e-mail „objednávka se zpracovává“)** (Attach PDF invoice ("order processing" email)). * **Přiložit PDF fakturu (e-mail „objednávka dokončena“)** (Attach PDF invoice ("order completed" email)). > [!TIP] > > Jak nastavit PDF, se dozvíte v kapitole [Nastavení PDF](xref:cs/getting-started/advanced-configuration/pdf-settings). ## Dárkové poukazy Na panelu *Dárkové poukazy* (Gift cards) definujte následující nastavení: ![Dárkové poukazy](_static/order-settings/gift-cards.jpg) * **Aktivovat dárkové poukazy po dokončení objednávky** (Activate gift cards after completing of an order) pro aktivaci souvisejících dárkových poukazů po dokončení objednávky. * **Deaktivovat dárkové poukazy po zrušení objednávky** (Deactivate gift cards after cancelling of an order) pro deaktivaci souvisejících dárkových poukazů po zrušení objednávky. * **Deaktivovat dárkové poukazy po smazání objednávky** (Deactivate gift cards after deleting of an order) pro deaktivaci souvisejících dárkových poukazů po smazání objednávky. * **Smazat historii použití dárkového poukazu po zrušení objednávky** (Delete gift card usage history after order cancellation) pro smazání historie použití dárkového poukazu po zrušení objednávky. ## Nastavení žádostí o vrácení Na panelu *Nastavení žádostí o vrácení* (Return request settings) můžete nastavit žádosti o vrácení. Další podrobnosti naleznete v sekci [Nastavení žádostí o vrácení](xref:cs/running-your-store/order-management/return-requests#return-request-settings). ## Viz také * [Objednávky](xref:cs/running-your-store/order-management/orders) * [Žádosti o vrácení](xref:cs/running-your-store/order-management/return-requests) * [Nastavení PDF](xref:cs/getting-started/advanced-configuration/pdf-settings) --- # Správa zákazníků Zákazníci v nopCommerce představují širokou skupinu, která zahrnuje všechny uživatele. Tato kapitola popisuje, jak spravovat profily zákazníků, sledovat aktivity v systému a zobrazovat uživatele online. Jak co nejlépe využít správu zákazníků ve vašem obchodě nopCommerce, se dozvíte v následujících kapitolách: * [Správa zákazníků](xref:cs/running-your-store/customer-management/managing-customers) * [Role zákazníků](xref:cs/running-your-store/customer-management/customer-roles) * [Seznam řízení přístupu](xref:cs/running-your-store/customer-management/access-control-list) * [Protokol aktivit](xref:cs/running-your-store/customer-management/activity-log) * [Zákazníci online](xref:cs/running-your-store/customer-management/online-customers) * [Nastavení zákazníků](xref:cs/running-your-store/customer-management/customer-settings) --- # Správa zákazníků Seznam zákazníků obsahuje údaje o všech existujících zákaznících a umožňuje přidávat nové. Seznam zákazníků obsahuje údaje o všech existujících zákaznících a umožňuje přidávat nové. Tato a další nastavení správy zákazníků dělají z nopCommerce e-commerce platformu s vestavěnou [omnichannel funkcí](https://www.nopCommerce.com/omnichannel-commerce). V nopCommerce zahrnují zákazníci všechny uživatele, jako jsou administrátoři, dodavatelé a kupující. V nopCommerce zahrnují zákazníci všechny uživatele, jako jsou administrátoři, dodavatelé a kupující. Chcete-li spravovat zákazníky, přejděte do **Zákazníci → Zákazníci** (Customers → Customers). Zobrazí se následující okno: ![Zákazníci](_static/managing-customers/customers.png) Chcete-li vyhledat zákazníky, zadejte v okně *Zákazníci* (Customers) jedno nebo více z následujících kritérií vyhledávání: - **E-mail** (Email). - **Uživatelské jméno** (Username), je-li povoleno v [nastavení zákazníků](xref:cs/running-your-store/customer-management/customer-settings). - **Jméno** (First name). - **Příjmení** (Last name). - **Je aktivní** (Is active). Vyhledávání zákazníků podle stavu účtu. - **Datum narození** (Date of birth), je-li povoleno v [nastavení zákazníků](xref:cs/running-your-store/customer-management/customer-settings). - **Společnost** (Company), je-li povoleno v [nastavení zákazníků](xref:cs/running-your-store/customer-management/customer-settings). - **Telefon** (Phone), je-li povoleno v [nastavení zákazníků](xref:cs/running-your-store/customer-management/customer-settings). - **PSČ** (Zip code), je-li povoleno v [nastavení zákazníků](xref:cs/running-your-store/customer-management/customer-settings). - **IP adresa** (IP address). - **Role zákazníků** (Customer roles) — můžete vybrat jednu nebo více rolí zákazníků, které se mají zobrazit. - **Datum registrace od** (Registration date from) a **Datum registrace do** (Registration date to) - **Poslední aktivita od** (Last activity from) a **Poslední aktivita do** (Last activity to) > [!NOTE] > > Data zákazníků můžete exportovat do externího souboru kliknutím na **Exportovat do XML (vše)** (Export to XML (all)) nebo **Exportovat do Excelu (vše)** (Export to Excel (all)). Data vybraných zákazníků můžete exportovat do externího souboru kliknutím na **Exportovat do XML (vybrané)** (Export to XML (selected)) nebo **Exportovat do Excelu (vybrané)** (Export to Excel (selected)). Poté klikněte na tlačítko **Hledat** (Search). ## Přidání nového zákazníka Chcete-li přidat nového zákazníka, klikněte v okně *Zákazníci* na **Přidat nový** (Add new). Zobrazí se okno *Přidat nového zákazníka* (Add a new customer). Definujte následující údaje o zákazníkovi: ## Informace o zákazníkovi Panel *Informace o zákazníkovi* (Customer info) umožňuje zadat osobní a účetní údaje zákazníka, například změnit heslo nebo přiřadit/odebrat role zákazníka. ![Detaily zákazníka](_static/managing-customers/add-new.png) Můžete upravit následující pole: - **E-mailová** adresa (Email). - **Heslo** (Password). - **Jméno** (First name). - **Příjmení** (Last name). - **Pohlaví** (Gender). - **Datum narození** (Date of birth). - **Název společnosti** (Company name). - **Osvobozen od daně** (Is tax exempt) určuje, zda je zákazník osvobozen od daní. - **Role zákazníků** (Customer roles) — jedna nebo více rolí zákazníka. Upozorňujeme, že každá role, která se potřebuje přihlašovat do systému (například administrátor, dodavatel), by měla mít mimo jiné roli zákazníka „Registrovaný“ (Registered). Role zákazníků můžete nastavit v sekci [Role zákazníků](xref:cs/running-your-store/customer-management/customer-roles). - V rozevíracím seznamu **Správce dodavatele** (Manager of vendor) v případě potřeby vyberte dodavatele přiřazeného k tomuto zákaznickému účtu. Po přiřazení se bude tento zákazník moci přihlásit do portálu vybraného dodavatele a spravovat jeho produkty a objednávky. Upozorňujeme, že pokud máte k tomuto zákazníkovi přiřazeného dodavatele, měli byste zajistit, aby byl tento záznam zákazníka v seznamu [Dodavatelé](xref:cs/running-your-store/vendor-management). - Zaškrtnutím políčka **Aktivní** (Active) zákazníka aktivujete. - **Zákazník musí změnit heslo** (Customer must change password) – zaškrtněte, chcete-li po zákazníkovi vyžadovat změnu hesla. - **Komentář administrátora** (Admin comment) — komentáře administrátora pro interní použití, je-li to potřeba. Kliknutím na tlačítko **Uložit** (Save) uložíte změny, nebo kliknutím na tlačítko **Uložit a pokračovat v úpravách** (Save and continue edit) přejdete k dalším informacím o zákazníkovi. V takovém případě uvidíte na stránce s detaily zákazníka nově přidané panely. Uvidíte také tlačítka **Odeslat e-mail** (Send email), **Odeslat soukromou zprávu** (Send private message) (pokud jsou povolena [fóra](xref:cs/running-your-store/content-management/forums)) a **Smazat** (Delete). ![Tlačítka](_static/managing-customers/edit_customer_details.png) Po kliknutí na tlačítko **Odeslat e-mail** se zobrazí okno *Odeslat e-mail* (Send email), které majiteli obchodu umožní odeslat zákazníkovi e-mail. Po kliknutí na tlačítko **Odeslat soukromou zprávu** se zobrazí okno *Odeslat soukromou zprávu* (Send private message), které umožní odeslat zákazníkovi zprávu. Chcete-li používat soukromé zprávy, povolte je v [nastavení fór](xref:cs/running-your-store/content-management/forums). ## Objednávky Na panelu *Objednávky* (Orders) můžete zobrazit detaily objednávek zákazníka. ![informace o zákazníkovi](_static/managing-customers/customer-orders.png) ## Adresy Na panelu *Adresy* (Addresses) můžete zobrazovat, upravovat a vytvářet nové adresy zákazníka. ![adresy](_static/managing-customers/customert-adresses.png) Kliknutím na tlačítko **Přidat novou adresu** (Add new address) přidáte novou adresu zákazníka. Vyplňte příslušná pole a klikněte na **Uložit** (Save). Nová adresa bude přidána k zákazníkovi. ## Aktuální nákupní košík a seznam přání Na panelu *Aktuální nákupní košík a seznam přání* (Current shopping cart and wishlist) můžete zobrazit nákupní košík a seznam přání zákazníka. ## Protokol aktivit Na panelu *Protokol aktivit* (Activity log) můžete zobrazit protokol aktivit zákazníka. Jak spravovat typy aktivit, se dozvíte v sekci [Protokol aktivit – typy aktivit zákazníků](xref:cs/running-your-store/customer-management/activity-log#customer-activity-types). ## Zadat objednávku (vystupovat jako zákazník) Na panelu *Zadat objednávku (vystupovat jako zákazník)* (Place order (impersonate)) mohou majitelé obchodů vytvářet objednávky pro své zákazníky bez znalosti hesla. To je užitečné pro zákazníky, kteří se nechtějí registrovat, nebo pro velké weby, kde pracovníci zákaznického servisu přijímají objednávky po telefonu. Panel obsahuje tlačítko **Zadat objednávku** (Place order). Po kliknutí na toto tlačítko budete přesměrováni do veřejné části obchodu. Vyberte produkty, které zákazník chce, přidejte je do košíku přesně tak, jak by to udělal zákazník ve veřejné části obchodu, poté pomocí tlačítka **K pokladně** (Checkout) projděte obvyklým procesem pokladny a nakonec kliknutím na odkaz **Ukončit relaci** (Finish session) v horní části stránky tuto relaci ukončete. ## Odběry upozornění na opětovné naskladnění Na panelu *Odběry upozornění na opětovné naskladnění* (Back in stock subscriptions) uvidíte produkty, k jejichž odběru je zákazník přihlášen. ## Věrnostní body Na panelu *Věrnostní body* (Reward points) mohou majitelé obchodů zákazníkovi přidat věrnostní body nebo zobrazit historii jejich využití. Tento panel je viditelný, pokud je program věrnostních bodů povolen. Další informace naleznete v sekci [Věrnostní body](xref:cs/running-your-store/promotional-tools/reward-points). ### Přidání (snížení) bodů ![Věrnostní body](_static/managing-customers/customer-reward-points.png) Na tomto panelu: - Zadejte počet **Bodů** (Points). Chcete-li body snížit, zadejte zápornou hodnotu. - V poli **Platnost bodů** (Points validity) zadejte počet dní, po které budou udělené body platné (pouze pro kladný počet bodů). - Zadejte **Zprávu** (Message) nebo komentář. - Zaškrtněte políčko **Aktivovat body okamžitě** (Activate points immediately), pokud chcete zákazníkům umožnit používat věrnostní body ihned po jejich získání. Pokud toto políčko nezaškrtnete, zobrazí se ještě jedna možnost: - Pokud předchozí políčko není zaškrtnuto, zadejte v poli **Aktivace věrnostních bodů** (Reward points activation) dobu (počet dní/hodin), po jejímž uplynutí budou věrnostní body aktivovány. ## Viz také - [Role zákazníků](xref:cs/running-your-store/customer-management/customer-roles) - [Dodavatelé](xref:cs/running-your-store/vendor-management) ## Výukové materiály - [Správa zákazníků v nopCommerce](https://www.youtube.com/watch?v=DOl-g-NNFEM&list=PLnL_aDfmRHwsbhj621A-RFb1KnzeFxYz4&index=1) - [Opětovné přiřazení smazané e-mailové adresy](https://www.youtube.com/watch?v=lqmrWJdXZEE&t=1s) - [Přehled režimu vystupování jako zákazník](https://www.youtube.com/watch?v=KQi-CDVawJ4) --- # Role zákazníků Role zákazníků v nopCommerce umožňují vytvářet skupiny uživatelů vašeho internetového obchodu. Můžete vytvářet různé skupiny, například administrátory obchodu, nakupující, [dodavatele](xref:cs/running-your-store/vendor-management) a další. Těmto skupinám můžete také udělit určitá práva, například zvýhodněné ceny a další zvláštní statusy (např. osvobození od daně, dopravu zdarma a další), pomocí [seznamu řízení přístupu](xref:cs/running-your-store/customer-management/access-control-list). Role zákazníků spravujete v **Zákazníci → Role zákazníků** (Customers → Customer roles). Zobrazí se okno *Role zákazníků*: ![Role zákazníků](_static/customer-roles/customerroles1.png) Kliknutím na **Přidat nový** (Add new) přidáte novou roli zákazníka. Zobrazí se okno *Přidat novou roli zákazníka*: ![Přidat novou roli zákazníka](_static/customer-roles/customerroles2.png) Vyplňte následující údaje: * **Název** (Name) role zákazníka. * Zaškrtnutím **Aktivní** (Active) tuto roli aktivujete. * Zaškrtněte políčko **Doprava zdarma** (Free shipping), aby zákazníci s touto rolí měli u svých objednávek dopravu zdarma. * Zaškrtněte políčko **Osvobozeno od daně** (Tax exempt), aby zákazníci s touto rolí mohli nakupovat bez daně. * Zaškrtněte **Přepsat výchozí typ zobrazení daně** (Override default tax display type) a v rozevíracím seznamu **Výchozí typ zobrazení daně** (Default tax display type) vyberte jeden z typů: * *Včetně daně* * *Bez daně* * Zaškrtněte **Povolit platnost hesla** (Enable password lifetime), chcete-li zákazníky přinutit změnit heslo po uplynutí stanovené doby. * **Zakoupeno s produktem** (Purchased with product). Kliknutím na tlačítko **Vybrat produkt** (Choose product) vyberte speciální produkt. Zákazník je do této role zákazníka přidán, jakmile je tento produkt zakoupen (zaplacen). > [!NOTE] > > V případě vrácení peněz nebo zrušení objednávky musíte zákazníka z této role odebrat ručně. * **Je systémová role** (Is system role). Toto nastavení ukazuje, zda je role používána v kódu. Je předdefinované a nelze jej měnit. * **Systémový název** (System name) role zákazníka. Klikněte na **Uložit** (Save). ## Návody * [Přehled rolí zákazníků](https://www.youtube.com/watch?v=3vdIDNIYFIQ) * [Obnovení smazaného administrátora](https://www.youtube.com/watch?v=D45WkrbaA38) --- # Seznam řízení přístupu Seznam řízení přístupu (ACL – Access Control List) omezuje nebo uděluje uživatelům přístup do určitých oblastí webu. Tento seznam spravují administrátoři. Uživatel proto musí mít administrátorská práva, aby k němu měl přístup. Seznam přístupu má následující vlastnosti: * Seznam řízení přístupu je založen na rolích, tj. spravuje role, jako jsou *Globální administrátoři* (Global administrators), *Správci obsahu* (Content managers) a další. Tento seznam rolí lze spravovat na stránce **Zákazníci → Role zákazníků** (Customers → Customer roles). Další podrobnosti naleznete v části [Role zákazníků](xref:cs/running-your-store/customer-management/customer-roles). * Seznam řízení přístupu se zobrazuje v administraci. Uživatel musí být administrátorem, aby měl k ACL přístup. * Existují některé předdefinované akce administrátora. Patří mezi ně *Spravovat objednávky* (Manage orders), *Spravovat zákazníky* (Manage customers) a mnoho dalších. Chcete-li spravovat seznam řízení přístupu, přejděte do **Konfigurace → Seznam řízení přístupu** (Configuration → Access control list). Zobrazí se okno *Seznam řízení přístupu*: ![Seznam řízení přístupu](_static/access-control-list/acl.png) Klikněte na **Upravit** (Edit) a vyberte požadované role vedle položek *Oprávnění* (Permission). Vybrané role budou mít odpovídajícím způsobem přístup k vybraným akcím. ![Seznam řízení přístupu](_static/access-control-list/acl_edit.png) Klikněte na **Uložit** (Save). > [!TIP] > > Příklad: Potřebujeme roli s názvem *Správce obsahu* (Content manager). *Správce obsahu* musí mít přístup ke správě nových produktů a výrobců, k úpravám recenzí na webu, blogům, kampaním a nesmí mít přístup k nákupním košíkům. > Postup: > > 1. Na stránce **Zákazníci → Role zákazníků** vytvořte **Roli zákazníka** s názvem *Správce obsahu*. > 1. V seznamu řízení přístupu přidejte požadované role zákazníků pro následující oprávnění: *Access Admin Area, Admin Area. Manage Blog, Admin Area. Manage Campaigns, Admin Area. Manage Forums, Admin Area. Manage News, Admin Area. Manage Newsletter Subscribers, Public Store. Allow Navigation, Public Store. Display Prices* (Přístup do administrace; Administrace. Spravovat blog; Administrace. Spravovat kampaně; Administrace. Spravovat fóra; Administrace. Spravovat novinky; Administrace. Spravovat odběratele newsletteru; Veřejný obchod. Povolit navigaci; Veřejný obchod. Zobrazovat ceny). > 1. Uložte změny. --- # Protokol aktivit Protokol aktivit slouží ke sledování aktivity uživatelů v systému. Ve výchozím nastavení jsou v nopCommerce pro sledování povoleny všechny *typy aktivit*. Majitel obchodu je může vypnout zrušením zaškrtnutí příslušných políček. Většina uvedených typů aktivit je určena pouze pro administrátora a zaznamenává akce v administraci. Některé jsou však určeny pro veřejný obchod a sledují akce nakupujících (například přidání do košíku/seznamu přání nebo odeslání objednávky). ## Typy aktivit zákazníků Chcete-li typy aktivit povolit/zakázat, přejděte do **Zákazníci → Typy aktivit** (Customers → Activity types). ![Typy aktivit](_static/activity-log/activity-type.png) Zaškrtněte políčko **Je povoleno** (Is enabled) vedle typu aktivity, který chcete povolit. Poté klikněte vpravo nahoře na **Uložit** (Save). ## Protokol aktivit zákazníků Chcete-li vyhledávat v protokolech aktivit, přejděte do **Zákazníci → Protokol aktivit** (Customers → Activity log). ![Protokol aktivit](_static/activity-log/activity-log.jpg) Kritéria vyhledávání definujte pomocí jednoho nebo více z následujících polí: - Chcete-li vyhledávat podle časového rozmezí, zadejte rozmezí do polí **Vytvořeno od** (Created from) a **Vytvořeno do** (Created to). Případně můžete kliknout na rozbalovací kalendář a vybrat požadované rozmezí dat. - **Typ protokolu aktivit** (Activity log type) pro aktivitu zákazníka. - **IP adresa** (IP address) pro vyhledání zákazníka podle IP adresy. Konkrétní položku protokolu aktivit můžete vymazat kliknutím na tlačítko **Odstranit** (Delete) vedle ní, nebo vymazat celý protokol aktivit kliknutím na tlačítko **Vymazat protokol aktivit** (Clear activity log) vpravo nahoře. --- # Zákazníci online Sekce Zákazníci online umožňuje majitelům obchodů zobrazit zákazníky, kteří byli online během posledních 20 minut. Tyto informace jsou pro majitele obchodů užitečné, protože ukazují naposledy navštívenou stránku a pomáhají rozhodnout o krocích potřebných k přeměně návštěvníků v kupující. Toto okno otevřete přes **Zákazníci → Zákazníci online** (Customers → Online customers). ![Zákazníci online](_static/online-customers/list.png) Majitel obchodu může uživatele filtrovat podle **Rolí zákazníků** (Customer roles). Okno *Zákazníci online* obsahuje následující sloupce: - **Informace o zákazníkovi** (Customer info) – kliknutím na odkaz můžete zobrazit a upravit informace o zákazníkovi. - **IP adresa** (IP Address) – aktuální IP adresa zákazníka - **Umístění** (Location) – umístění zákazníka určené podle IP adresy. - **Poslední aktivita** (Last activity) – datum a čas, kdy se zákazník online naposledy přihlásil. - **Naposledy navštívená stránka** (Last visited page) – stránka, kterou zákazník navštívil naposledy. > [!NOTE] > > Chcete-li zobrazit naposledy navštívenou stránku, musíte povolit nastavení **Ukládat naposledy navštívenou stránku** (Store last visited page) na stránce **Konfigurace → Nastavení → Nastavení zákazníků** (Configuration → Settings → Customer settings) (panel *Účet* (Account)). Tato stránka obsahuje data GeoLite2 vytvořená společností MaxMind, dostupná na [http://www.maxmind.com](http://www.maxmind.com) --- # Nastavení zákazníků Nastavení zákazníků zahrnují možnost povolit zákazníkům nahrát avatar, zobrazovat polohu zákazníka, měnit formát jména nebo datum registrace a další. Chcete-li definovat nastavení zákazníků, přejděte do **Konfigurace → Nastavení → Nastavení zákazníků** (Configuration → Settings → Customer settings). Zobrazí se okno nastavení zákazníků. Toto okno obsahuje šest panelů: Obecné, Heslo a zabezpečení, Účet, Profil, Pole formuláře zákazníka a Pole formuláře adresy. 1. Panel **Obecné** (Common) obsahuje obecná nastavení zákazníků. 1. Panel **Heslo a zabezpečení** (Password and security) obsahuje pole, pomocí kterých lze nakonfigurovat nastavení zabezpečení a složitost hesla. 1. Panel **Účet** (Account) obsahuje pole pro nastavení zákaznického účtu. 1. Panel **Profil** (Profile) obsahuje pole pro konfiguraci profilu zákazníka. 1. Panel **Pole formuláře zákazníka** (Customer form fields) obsahuje pole, která se používají na stránce registrace zákazníka. 1. Panel **Pole formuláře adresy** (Address form fields) obsahuje pole pro podrobné zadání adresy zákazníka během pokladny. ## Obecné ![obecné](_static/customer-settings/customersettings1.png) Obecná nastavení zákazníků definujte následovně: * Vyberte **Způsob registrace** (Registration method): * **Standardní vytvoření účtu** (Standard account creation): uživatelé se mohou registrovat; není vyžadováno žádné schválení. * **Po registraci je vyžadováno ověření e-mailu** (Email validation is required after registration): uživatelé se mohou registrovat; před schválením účtu však musí potvrdit e-mail, který jim byl zaslán. * **Zákazník musí být schválen administrátorem** (A customer should be approved by administrator): uživatelé se mohou registrovat; je vyžadováno schválení administrátorem. * **Registrace je zakázána** (Registration is disabled): tuto možnost vyberte, chcete-li registraci zakázat. * Zaškrtněte políčko **Upozornit na registraci nového zákazníka** (Notify about new customer registration), aby majitel obchodu dostal e-mailové upozornění pokaždé, když se zaregistruje nový zákazník. * Zaškrtněte políčko **Vyžadovat registraci pro stahovatelné produkty** (Require registration for downloadable products), pokud se zákazníci musí pro nákup stahovatelných produktů zaregistrovat. * Pomocí pole **Povolit zákazníkům kontrolu zůstatku dárkového poukazu** (Allow customers to check gift card balance) umožníte zákazníkům kontrolovat zůstatek dárkového poukazu. > [!NOTE] > > Pokud je pole **Povolit zákazníkům kontrolu zůstatku dárkového poukazu** zaškrtnuté, musí být v administraci povoleno nastavení CAPTCHA (**Konfigurace → Nastavení → Obecná nastavení → panel CAPTCHA** (Configuration → Settings → General settings → CAPTCHA panel)). Tato funkce je potenciálně nebezpečná a CAPTCHA je potřebná k zabránění a ztížení útoků hrubou silou. Další podrobnosti naleznete v [nastavení CAPTCHA](xref:cs/getting-started/advanced-configuration/security-settings#captcha). * Zvolte, zda **Povolit zákazníkům vybrat časové pásmo** (Allow customers to select time zone) ve veřejném obchodě na stránce účtu. V opačném případě se použije výchozí časové pásmo. * V rozbalovacím seznamu vyberte **Výchozí časové pásmo obchodu** (Default store time zone). > [!NOTE] > > Aktuální časové pásmo se zobrazuje automaticky. * Zaškrtněte **Povolit zákazníkům odebrat přidružení** (Allow customers to remove associations), chcete-li zákazníkům umožnit odebrat přidružení externího ověřování. ## Heslo a zabezpečení ![heslo](_static/customer-settings/customersettings2.png) * Nastavte **Minimální délku hesla, Maximální délku hesla, Heslo musí obsahovat alespoň jedno malé písmeno, Heslo musí obsahovat alespoň jedno velké písmeno, Heslo musí obsahovat alespoň jeden nealfanumerický znak, Heslo musí obsahovat alespoň jednu číslici** (Password minimum length, Password maximum length, Password must have at least one lowercase, Password must have at least one uppercase, Password must have at least one non alphanumeric character, Password must have at least one digit) pro změnu složitosti hesla. * **Počet neopakovatelných hesel** (Unduplicated passwords number) je počet hesel, se kterými nesmí být nové heslo shodné. * Vyberte **Výchozí formát hesla** (Default password format): * *Prostý text* (Clear) * *Hashované* (Hashed) * *Šifrované* (Encrypted) > [!NOTE] > > Toto nastavení slouží k ukládání hesel zákazníků a uplatní se pouze u nově registrovaných zákazníků. * Do pole **Platnost hesla** (Password lifetime) zadejte počet dní do vypršení platnosti hesla. > [!NOTE] > > Chcete-li používat funkci **Platnost hesla**, nezapomeňte na stránce úprav role zákazníka (**Zákazníci → Role zákazníků** (Customers → Customer roles)) zaškrtnout vlastnost **Povolit platnost hesla** (Enable password lifetime) u těch rolí, které musí hesla měnit. Další podrobnosti naleznete v kapitole [Role zákazníků](xref:cs/running-your-store/customer-management/customer-roles). * Do pole **Odkaz pro obnovení hesla. Dny platnosti** (Password recovery link. Days valid) zadejte počet dní platnosti odkazu pro obnovení hesla. Nastavte 0, pokud nechcete, aby platnost odkazu vypršela. * Zadejte **Maximální počet neúspěšných přihlášení** (Maximum login failures). Nastavením 0 tuto funkci vypnete. * Do pole **Doba zablokování (neúspěšná přihlášení)** (Lockout time (login failures)) zadejte počet minut, na které budou uživatelé zablokováni. * Zaškrtněte políčko **Vynutit dvojí zadání e-mailu** (Force entering email twice), pokud chcete, aby zákazníci při registraci zadávali e-mail dvakrát. * **Vynutit vícefaktorové ověřování** (Force multi-factor authentication). Vynutí aktivaci vícefaktorového ověřování pro role zákazníků uvedené v seznamu řízení přístupu (musí být aktivní alespoň jeden poskytovatel MFA). * Zaškrtněte políčko **Povoleno „Přihlášení telefonem“** ('Login by phone' enabled), chcete-li zákazníkům umožnit přihlásit se do obchodu pomocí telefonního čísla namísto e-mailové adresy nebo uživatelského jména. ![heslo](_static/customer-settings/customersettings3.png) > [!IMPORTANT] > > Tato funkce má následující předpoklady, všechny se definují na stejné stránce *Nastavení zákazníků*: > > * **Povoleno „Telefonní číslo“** ('Phone number' enabled) a **Povinné „Telefonní číslo“** ('Phone number' required) na panelu *Pole formuláře zákazníka*. V opačném případě zákazníci nebudou moci zadat číslo, na které se kód odesílá. > * Nakonfigurovaný a povolený poskytovatel SMS, protože ověřovací kód se odesílá jako zpráva SMS. Více se dočtete v kapitole [Poskytovatel SMS Twilio](xref:cs/getting-started/advanced-configuration/sms-providers/twilio). Když je zaškrtnuto políčko **Povoleno „Přihlášení telefonem“**, zobrazí se následující možnosti: * **Doba platnosti kódu OTP** (OTP code time to live): doba (v sekundách), po kterou zůstává jednorázový kód (OTP) platný. Nastavte 0, pokud platnost kódu nemá vypršet. * **Počet pokusů o odeslání kódu OTP** (OTP code send attempts): maximální počet, kolikrát může zákazník požádat o nový kód pro stejné telefonní číslo. * **Počet pokusů o ověření kódu OTP** (OTP code verification attempts): počet povolených neúspěšných pokusů o ověření kódu OTP. * **Doba před opětovným odesláním kódu OTP** (OTP code resend time): doba (v minutách), která musí uplynout, než může zákazník o kód požádat znovu. * **Délka kódu OTP** (OTP code length): počet číslic ve vygenerovaném kódu. > [!NOTE] > > Ověřovací kód se odesílá prostřednictvím SMS a je platný pouze jednou. Pokud platnost kódu vypršela, byl překročen počet pokusů o jeho odeslání nebo je kód vyžádán znovu dříve, než uplyne **Doba před opětovným odesláním kódu OTP**, zákazník je vyzván, aby si vyžádal nový. * **Ověřování telefonního čísla je povoleno** (Phone number validation is enabled). Toto nastavení zajišťuje, že čísla zadaná zákazníky mají vždy jednotný formát a lze je použít k ověření. ## Účet ![Účet](_static/customer-settings/account.jpg) * Zaškrtněte políčko **Povolena „Uživatelská jména“** ('Usernames' enabled), chcete-li pro přihlášení a registraci namísto e-mailů používat uživatelská jména. > [!NOTE] > > V produkčním prostředí se nedoporučuje tuto možnost měnit. Když je zaškrtnuto políčko **Povolena „Uživatelská jména“**, zobrazí se následující možnosti: * **Povolit zákazníkům změnit uživatelské jméno** (Allow customers to change their usernames): tuto možnost vyberte, pokud zákazníci smějí měnit svá uživatelská jména. * **Povolit zákazníkům ověřit dostupnost uživatelského jména** (Allow customers to check the availability of usernames): tuto možnost vyberte, chcete-li zákazníkům umožnit ověřit dostupnost uživatelského jména před kliknutím na tlačítko *Uložit* na stránce *Můj účet - Informace o zákazníkovi*. V takovém případě se zobrazí tlačítko **Ověřit dostupnost** (Check availability); viz příklad níže. ![Tlačítko Ověřit dostupnost](_static/customer-settings/check-availability-button.jpg) * Zaškrtněte pole **Ověřování uživatelského jména je povoleno** (Username validation is enabled), pokud chcete povolit ověřování uživatelského jména (při registraci nebo změně na stránce „Můj účet“ ve veřejném obchodě). Když je toto políčko zaškrtnuto, zobrazí se následující možnosti: * **Pravidlo ověření uživatelského jména** (Username validation rule): v tomto poli nastavte ověřovací pravidlo pro uživatelské jméno. Můžete zadat seznam povolených znaků nebo regulární výraz. Pokud používáte regulární výraz, zaškrtněte níže popsané pole **Použít regulární výraz pro ověření uživatelského jména**. * Zaškrtněte pole **Použít regulární výraz pro ověření uživatelského jména** (Use regex for username validation), chcete-li k ověření uživatelského jména použít regulární výraz (při registraci nebo změně na stránce „Můj účet“ ve veřejném obchodě). * Vyberte **Formát jména zákazníka** (Customer name format): * *Zobrazovat e-maily* (Show emails) * *Zobrazovat uživatelská jména* (Show usernames) * *Zobrazovat celá jména* (Show full names) * *Zobrazovat křestní jméno* (Show first name) Jméno zákazníka se bude v obchodě zobrazovat u komentářů zákazníka k novinkám a blogu, na stránkách fóra a jinde. * Zaškrtněte políčko **Ověřování telefonního čísla je povoleno** (Phone number validation is enabled), pokud chcete povolit ověřování telefonního čísla (při registraci nebo změně na stránce „Můj účet“ ve veřejném obchodě). Když je toto políčko zaškrtnuto, zobrazí se následující možnosti: * **Pravidlo ověření telefonního čísla** (Phone number validation rule): v tomto poli nastavte ověřovací pravidlo pro telefonní číslo. Můžete zadat seznam povolených znaků nebo regulární výraz. Pokud používáte regulární výraz, zaškrtněte níže popsané pole **Použít regulární výraz pro ověření uživatelského jména**. * Zaškrtněte pole **Použít regulární výraz pro ověření telefonního čísla** (Use regex for phone number validation), chcete-li k ověření telefonního čísla použít regulární výraz (při registraci nebo změně na stránce „Můj účet“ ve veřejném obchodě). * **Povolit zákazníkům nahrávat avatary** (Allow customers to upload avatars): avatary zákazníků se budou v obchodě zobrazovat u jejich komentářů k novinkám a blogu, na stránkách fóra a jinde. Pokud je tato možnost zaškrtnuta, zobrazí se následující políčko: * Zaškrtněte políčko **Výchozí avatar povolen** (Default avatar enabled), chcete-li zobrazovat výchozí avatary uživatelů. * Zaškrtněte políčko **Skrýt kartu „Stahovatelné produkty“** (Hide 'Downloadable products' tab), chcete-li tuto kartu na stránce „Můj účet“ skrýt. * Zaškrtněte políčko **Skrýt kartu „Odběry upozornění na naskladnění“** (Hide 'Back in stock subscriptions' tab), chcete-li tuto kartu na stránce „Můj účet“ skrýt. * Zaškrtněte políčko **Skrýt pole pro newsletter** (Hide newsletter box), pokud nechcete zobrazovat pole pro přihlášení k odběru newsletteru. * Zaškrtněte políčko **Pole pro newsletter. Povolit odhlášení** (Newsletter box. Allow to unsubscribe), chcete-li v bloku newsletteru zobrazit možnost „odhlásit odběr“. To je vyžadováno například v Německu. * Zaškrtněte políčko **Ukládat naposledy navštívenou stránku** (Store last visited page), chcete-li ukládat naposledy navštívenou stránku zákazníka. Naposledy navštívené stránky zákazníků pak můžete zobrazit na stránce **Zákazníci → Zákazníci online** (Customers → Online customers). Zrušením zaškrtnutí tohoto políčka můžete zlepšit výkon webu. * Zaškrtněte políčko **Ukládat IP adresu** (Store IP address), chcete-li ukládat poslední IP adresy zákazníků. Vypnutí může zlepšit výkon. ## Profil ![profil](_static/customer-settings/customersettings4.png) * **Povolit zobrazování profilů zákazníků** (Allow viewing of customer profiles): toto nastavení umožňuje zobrazit ve veřejném obchodě podrobnosti o ostatních zákaznících. * V případě potřeby zaškrtněte políčko **Zobrazovat polohu zákazníků** (Show customers location). * V případě potřeby zaškrtněte políčko **Zobrazovat datum registrace zákazníků** (Show customers join date). ## Pole formuláře zákazníka Na panelu *Pole formuláře zákazníka* (Customer form fields) definujte, zda jsou v systému povolena následující pole formuláře: ![pole formuláře zákazníka](_static/customer-settings/customersettings5.png) * **Povoleno „Pohlaví“** ('Gender' enabled) * **Povolena možnost „Neutrální“** ('Neutral' option enabled). Pokud je tato možnost povolena, budete moci zadat jednu ze tří možností pohlaví: muž, žena, neutrální (podle německých zákonů). * **Povoleno „Jméno“** ('First name' enabled). Pokud je povoleno, můžete také rozhodnout, zda má být toto pole povinné. * **Povoleno „Příjmení“** ('Last name' enabled). Pokud je povoleno, můžete také rozhodnout, zda má být toto pole povinné. * **Povoleno „Datum narození“** ('Date of Birth' enabled). Pokud je povoleno, můžete také rozhodnout, zda má být toto pole povinné, a zadat minimální povolený věk (například abyste zajistili, že zákazník je starší 18 let). * **Povoleno „Společnost“** ('Company' enabled). Pokud je povoleno, můžete také rozhodnout, zda má být toto pole povinné. * **Povoleno „Ulice“** ('Street address' enabled). Pokud je povoleno, můžete také rozhodnout, zda má být toto pole povinné. * **Povoleno „Ulice 2“** ('Street address 2' enabled), pokud je povolena druhá adresa ulice. Pokud je povoleno, můžete také rozhodnout, zda má být toto pole povinné. * **Povoleno „PSČ“** ('Zip/postal code' enabled). Pokud je povoleno, můžete také rozhodnout, zda má být toto pole povinné. * **Povoleno „Město“** ('City' enabled). Pokud je povoleno, můžete také rozhodnout, zda má být toto pole povinné. * **Povoleno „Okres/region“** ('County/region' enabled). Pokud je povoleno, můžete také rozhodnout, zda má být toto pole povinné. * **Povoleno „Země“** ('Country' enabled). Pokud je povoleno, můžete také rozhodnout, zda má být toto pole povinné. * **Povoleno „Stát/kraj“** ('State/province' enabled). Pokud je povoleno, můžete také rozhodnout, zda má být toto pole povinné. Poznámka: Toto pole je viditelné pouze tehdy, když je povoleno pole **Země**. * **Povoleno „Telefonní číslo“** ('Phone number' enabled). Pokud je povoleno, můžete také rozhodnout, zda má být toto pole povinné. * **Povoleno „Fax“** ('Fax number' enabled). Pokud je povoleno, můžete také rozhodnout, zda má být toto pole povinné. * Zaškrtněte políčko **Povoleno „Souhlas se zásadami ochrany osobních údajů“** ('Accept privacy policy' enabled), chcete-li po zákaznících při registraci vyžadovat souhlas se zásadami ochrany osobních údajů. * Zaškrtněte políčko **Povoleno „Newsletter“** ('Newsletter' enabled), chcete-li zákazníkům při registraci nabídnout odběr newsletteru. ### Vlastní atributy zákazníka Pokud výchozí pole formuláře nestačí vašim požadavkům, můžete pomocí této tabulky spravovat další atributy zákazníka. Atributy zákazníka se vytvářejí stejným způsobem jako atributy pokladny. Další podrobnosti naleznete v kapitole [Atributy pokladny](xref:cs/running-your-store/order-management/checkout-attributes). ![Vlastní atributy zákazníka](_static/customer-settings/customersettings6.png) ## Pole formuláře adresy Na panelu *Pole formuláře adresy* (Address form fields) může majitel obchodu spravovat pole formuláře adresy dostupná během registrace. Můžete vybrat, která z následujících polí jsou povolena a povinná: ![Pole formuláře adresy](_static/customer-settings/customersettings7.png) * **Povoleno „Společnost“** ('Company' enabled). Pokud je povoleno, můžete také rozhodnout, zda má být toto pole povinné. * **Povoleno „Ulice“** ('Street address' enabled). Pokud je povoleno, můžete také rozhodnout, zda má být toto pole povinné. * **Povoleno „Ulice 2“** ('Street address 2' enabled), pokud je povolena druhá adresa ulice. Pokud je povoleno, můžete také rozhodnout, zda má být toto pole povinné. * **Povoleno „PSČ“** ('Zip/postal code' enabled). Pokud je povoleno, můžete také rozhodnout, zda má být toto pole povinné. * **Povoleno „Město“** ('City' enabled). Pokud je povoleno, můžete také rozhodnout, zda má být toto pole povinné. * **Povoleno „Okres/region“** ('County/region' enabled). Pokud je povoleno, můžete také rozhodnout, zda má být toto pole povinné. * **Povoleno „Země“** ('Country' enabled). Pokud je povoleno, můžete také rozhodnout, zda má být toto pole povinné. * **Povoleno „Stát/kraj“** ('State/province' enabled). Pokud je povoleno, můžete také rozhodnout, zda má být toto pole povinné. Poznámka: Toto pole je viditelné pouze tehdy, když je povoleno pole **Země**. * **Povoleno „Telefonní číslo“** ('Phone number' enabled). Pokud je povoleno, můžete také rozhodnout, zda má být toto pole povinné. * **Povoleno „Fax“** ('Fax number' enabled). Pokud je povoleno, můžete také rozhodnout, zda má být toto pole povinné. ### Vlastní atributy adresy > [!NOTE] > > Pokud výchozí pole adresy nestačí vašim požadavkům, můžete pomocí této tabulky spravovat další atributy adresy. Atributy adresy se vytvářejí stejným způsobem jako atributy pokladny. Další podrobnosti naleznete v kapitole [Atributy pokladny](xref:cs/running-your-store/order-management/checkout-attributes). ![Vlastní atributy adresy](_static/customer-settings/customersettings8.png) Klikněte na **Uložit** (Save) v horní části stránky. ## Videonávody * [Konfigurace nastavení hesel](https://www.youtube.com/watch?v=TwWArXNi0CA) --- # Správa dodavatelů *Dodavatelé* představují zvláštní kategorii zákazníků, kterou je třeba posuzovat samostatně. nopCommerce obsahuje nástroje pro [více dodavatelů](https://www.nopcommerce.com/multi-vendor-marketplace) (multi-vendor) a drop shipping, které vám umožňují prodávat online, aniž byste museli držet zásoby nebo sami odesílat objednávky. V tomto případě je každý produkt přiřazen ke konkrétnímu dodavateli, jehož údaje (včetně e-mailové adresy) jsou uloženy. Při každém zadání objednávky je dodavateli každého produktu v objednávce odeslán e-mail. E-mail obsahuje produkty, množství a v případě potřeby další informace. Dodavatel odešle zboží zákazníkovi jménem obchodníka, který obvykle všem svým dodavatelům platí na konci měsíce. Produkty od více nezávislých dodavatelů se zobrazují ve společném katalogu produktů a návštěvníci vašeho webu mohou nakupovat v jednom internetovém obchodě, i když vaše produkty dodávají stovky dodavatelů z celého světa. Každému dodavateli lze poskytnout přístup do administrace, kde může spravovat své produkty, prohlížet přehledy prodejů a podrobnosti objednávek týkajících se jeho produktů. Dodavatelé nevidí činnost ostatních dodavatelů. Peníze přicházejí na obchodní účet administrátora obchodu, který je následně ručně rozděluje mezi dodavatele podle historie objednávek, jež je sledována a spravována zvlášť pro každého dodavatele. Zákazník tak vidí pouze jednu platbu hlavní společnosti. Následující postup popisuje, jak nastavit záznam dodavatele a poskytnout mu přístup k portálu dodavatele. ## Nastavení účtu dodavatele Přejděte do **Zákazníci → Dodavatelé** (Customers → Vendors). Zobrazí se okno *Dodavatelé*: ![Dodavatelé](_static/vendor-management/vendor1.png) Klikněte na **Přidat nový** (Add new). ### Informace o dodavateli ![Přidat dodavatele](_static/vendor-management/vendor2.png) Na panelu *Informace o dodavateli* (Vendor info) definujte následující údaje o dodavateli: * **Název** (Name) dodavatele. * **Popis** (Description) dodavatele. * **E-mail** dodavatele. Na tento e-mail budou zasílána upozornění „Objednávka zadána“. * Zaškrtnutím políčka **Aktivní** (Active) dodavatele aktivujete. * Nahrajte **Obrázek** (Picture) dodavatele. * **Komentář administrátora** (Admin comment) — volitelný komentář nebo informace pro interní použití. > [!NOTE] > > Některé šablony zpráv pro dodavatele, například *OrderPaid.VendorNotification* a *OrderPlaced.VendorNotification*, jsou ve výchozím stavu zakázány. Jak to změnit, se dozvíte v části [Šablony zpráv](xref:cs/running-your-store/content-management/message-templates). ### Atributy dodavatele Pokud vytvoříte nějaké další atributy dodavatele, zobrazí se také panel *Atributy dodavatele* (Vendor attributes). Majitel obchodu může pro dodavatele vytvářet atributy obdobně jako pro produkt. Obchody s více dodavateli tak mohou shromažďovat a zobrazovat zákazníkům více informací o dodavateli. Více o atributech dodavatele a o tom, jak je vytvořit, se dozvíte v části [Atributy dodavatele](#vendor-attributes) níže. ### Adresa (volitelné) Na panelu *Adresa (volitelné)* (Address (optional)) zadejte adresu dodavatele. ![Adresa (volitelné)](_static/vendor-management/address.jpg) ### Zobrazení Na panelu *Zobrazení* (Display) definujte následující parametry zobrazení: ![Zobrazení](_static/vendor-management/vendor4.png) * **Povolit zákazníkům zvolit velikost stránky** (Allow customers to select page size) z předdefinovaného seznamu možností. * Pokud je předchozí políčko zaškrtnuté, definujte **Možnosti velikosti stránky** (Page size options) (oddělené čárkami). * Pokud předchozí políčko není zaškrtnuté, zadejte **Velikost stránky** (Page size). * **Pořadí zobrazení** (Display order) dodavatele. ### SEO Nastavení SEO najdete v části [Panely SEO](xref:cs/running-your-store/search-engine-optimization#seo-panels). ![SEO](_static/vendor-management/seo.jpg) ## Přiřazení dodavatele k záznamu zákazníka Tento krok je volitelný a je nutný pouze tehdy, pokud chcete, aby se vaši dodavatelé mohli přihlásit do svého administračního portálu a spravovat své produkty, objednávky a/nebo další data. Pokud nechcete, aby dodavatelé měli přístup do administrace, tento krok vynechte a všechna přiřazení dodavatelů bude spravovat majitel obchodu. Přejděte do **Zákazníci → Zákazníci** (Customers → Customers). Zobrazí se okno *Zákazníci*: ![Zákazníci](_static/vendor-management/vendor7.png) Vytvořte nového zákazníka nebo klikněte na **Upravit** (Edit) vedle záznamu zákazníka, ke kterému chcete přiřadit dodavatele. Další informace o vytvoření zákazníka najdete v části [Přidání nového zákazníka](xref:cs/running-your-store/customer-management/managing-customers#add-a-new-customer). * Na panelu *Informace o zákazníkovi* (Customer info) se ujistěte, že je v poli **Role zákazníka** (Customer roles) vybrána role zákazníka *Dodavatelé* (Vendors). > [!NOTE] > > Zákaznický účet dodavatele nemůže patřit do výchozí role zákazníka *Administrátoři* (Administrators). * Na panelu *Informace o zákazníkovi* (Customer info) najděte pole **Správce dodavatele** (Manager of vendor). Vyberte dříve vytvořený záznam dodavatele. ![Upravit zákazníka](_static/vendor-management/edit-customer.jpg) Po nastavení zákaznického účtu dodavatele může dodavatel tento účet používat ke správě produktů, objednávek a zásilek a k prohlížení přehledů. Po přihlášení se v horní části veřejné části obchodu zobrazí odkaz *Administrace* (Administration). > [!TIP] > > [Videonávod na YouTube: Správa dodavatelů](https://www.youtube.com/watch?v=MH6r6tqfLF8&list=PLnL_aDfmRHwsbhj621A-RFb1KnzeFxYz4&index=9) ## Nastavení dodavatelů Tato část popisuje, jak definovat nastavení dodavatelů vašeho obchodu. Patří sem počet zobrazovaných dodavatelů, zda zobrazovat dodavatele na stránkách podrobností produktu a další. Přejděte do **Konfigurace → Nastavení → Nastavení dodavatelů** (Configuration → Settings → Vendor settings). Tato stránka umožňuje konfiguraci pro více obchodů; to znamená, že stejná nastavení lze definovat pro všechny obchody, nebo se mohou mezi obchody lišit. Pokud chcete spravovat nastavení pro konkrétní obchod, vyberte jeho název z rozbalovacího seznamu konfigurace pro více obchodů a zaškrtněte vlevo všechna potřebná zaškrtávací políčka, abyste pro ně mohli nastavit vlastní hodnoty. Další podrobnosti najdete v části [Více obchodů](xref:cs/getting-started/advanced-configuration/multi-store). ### Obecné Na panelu *Obecné* (Common) definujte následující nastavení dodavatelů: ![Obecné](_static/vendor-management/vendorsettings1.png) * **Povolit zákazníkům požádat o účet dodavatele** (Allow customers to apply for vendor account). Nejprve uživatel vyplní žádost dodavatele, čímž vytvoří účet dodavatele. Poté je žádost předložena majiteli obchodu (prostřednictvím e-mailového upozornění) ke schválení. > [!NOTE] > > Aby majitel obchodu udělil přístup do administrace, musí příslušný záznam zákazníka ručně přidat do role „Dodavatelé“. Více se dočtete ve výše uvedené části [Přiřazení dodavatele k záznamu zákazníka](#assigning-a-vendor-to-a-customer-record). * Pokud je předchozí políčko zaškrtnuté, můžete zaškrtnout **Obchodní podmínky** (Terms of service) a vyžadovat tak od dodavatelů souhlas s obchodními podmínkami při registraci. > [!NOTE] > > Chcete-li tyto obchodní podmínky upravit, přejděte do **Správa obsahu → Stránky** (Content management → Topics (pages)). Najděte položku **VendorTermsOfService** a klikněte na **Upravit** (Edit). Více se dočtete v části [Stránky (topics)](xref:cs/running-your-store/content-management/topics-pages). * **Povolit dodavatelům upravovat informace** (Allow vendors to edit info) umožňuje dodavatelům uvádět osobní informace ve veřejné části obchodu. * Zvolte, zda **Upozorňovat na změny informací o dodavateli** (Notify about vendor information changes), aby byl administrátor upozorňován na změny informací o dodavateli. * **Maximální počet produktů** (Maximum number of products) na dodavatele. * **Povolit dodavatelům importovat produkty** (Allow vendors to import products) umožňuje dodavatelům importovat produkty. ### Katalog Na panelu *Katalog* (Catalog) definujte následující nastavení dodavatelů: ![Katalog](_static/vendor-management/vendorsettings2.png) * **Povolit zákazníkům kontaktovat dodavatele** (Allow customers to contact vendors) (odesílat e-maily pomocí kontaktních formulářů). Tato funkce je dostupná na stránce podrobností dodavatele ve veřejné části obchodu. * **Povolit vyhledávání podle dodavatele** (Allow search by vendor) zákazníkům na stránce rozšířeného vyhledávání. * Zvolte, zda **Zobrazit dodavatele na stránce podrobností produktu** (Show vendor on product details page) (je-li přiřazen). * Zvolte, zda **Zobrazit název dodavatele na stránce podrobností objednávky** (Show vendor name on order details page) (je-li přiřazen). * **Počet zobrazených dodavatelů** (Number of vendors to display) v navigačním bloku dodavatelů ve veřejné části obchodu. ### *Atributy dodavatele* Můžete vytvořit libovolný počet atributů dodavatele, například obchodní název nebo web. ![Atributy dodavatele](_static/vendor-management/vendorsettings3.png) #### Přidání nového atributu Kliknutím na **Přidat nový** (Add new) vytvořte nový atribut dodavatele a jeho hodnoty. Zobrazí se okno *Přidat nový atribut dodavatele*: ![Přidat nový](_static/vendor-management/vendorsettings4.png) Na panelu *Informace o atributu* (Attribute info) definujte následující informace: * **Název** (Name) — název atributu dodavatele. * **Povinné** (Required) — je-li atribut povinný, musí dodavatelé před pokračováním zvolit odpovídající hodnotu atributu. * Z rozbalovacího seznamu **Typ ovládacího prvku** (Control type) vyberte požadovaný způsob zobrazení hodnoty atributu: *Rozbalovací seznam, Seznam přepínačů, Zaškrtávací políčko, Textové pole, Víceřádkové textové pole, Zaškrtávací políčko jen pro čtení* (Drop-down list, Radio button list, Checkbox, Textbox, Multiline textbox, Read-only checkbox). * **Pořadí zobrazení** (Display order) — pořadí zobrazení atributu dodavatele. > [!NOTE] > > Rozbalovací seznamy, seznamy přepínačů, zaškrtávací políčka a zaškrtávací políčka jen pro čtení vyžadují, aby majitel obchodu definoval hodnoty. Typy ovládacích prvků textové pole a víceřádkové textové pole nevyžadují, aby majitel obchodu definoval hodnoty, protože tato textová pole budou vyplňovat dodavatelé. Kliknutím na **Uložit a pokračovat v úpravách** (Save and continue edit) přejdete na panel *Hodnoty* (Values). #### Přidání nové hodnoty atributu Na panelu *Hodnoty* (Values) klikněte na **Přidat novou hodnotu atributu** (Add a new attribute value) a vytvořte novou hodnotu atributu. ![Přidat nové hodnoty atributu](_static/vendor-management/vendorsettings5.png) V okně *Přidat novou hodnotu atributu* definujte následující informace: * **Název** (Name) — název hodnoty atributu. * Zaškrtněte políčko **Předvybráno** (Pre-selected), chcete-li označit, že je hodnota atributu pro zákazníka předvybrána. * **Pořadí zobrazení** (Display order) — pořadové číslo zobrazení hodnoty atributu. Hodnoty atributů můžete upravovat a odebírat kliknutím na příslušná tlačítka vedle hodnot atributů na panelu *Hodnoty*. Klikněte na **Uložit** (Save). Nový atribut se zobrazí na stránce *Upravit podrobnosti dodavatele*. ## Recenze dodavatelů Katalog na stránce podrobností dodavatele zobrazuje recenze, které byly agregovány pro výpočet celkového hodnocení každého dodavatele. Na stránce dodavatele najdete seznam recenzí, který vzniká agregací recenzí všech produktů dodavatele, seřazený podle data. ![Recenze dodavatelů](_static/vendor-management/vendor_reviews.png) > [!NOTE] > > Výchozí počet recenzí na stránce recenzí dodavatele je 6. Tuto hodnotu můžete změnit v nastavení *VendorProductReviewsPageSize*. ## Povolení soukromých zpráv (PM) zákazníků dodavatelům V současné době mohou zákazníci kontaktovat dodavatele (nastavení `vendorsettings.allowcustomerstocontactvendors`). Dodavatelům je však možné posílat i soukromé zprávy. K tomu je potřeba na stránce podrobností dodavatele vybrat, kterému zákazníkovi bude soukromá zpráva doručena. ![Zákazník pro PM](_static/vendor-management/customer_for_pm.png) Vybrat lze pouze jednoho zákazníka. ![Výběr soukromé zprávy dodavatele](_static/vendor-management/vendor_pm_choose.png) Pokud má nastavení *forumsettings.allowprivatemessages* hodnotu **true**, zobrazí se v katalogu na stránce dodavatele další tlačítko pro odeslání soukromé zprávy. ![Soukromá zpráva dodavateli](_static/vendor-management/vendor_pm.png) Nyní můžete vyplnit níže uvedený formulář a soukromou zprávu odeslat. ![Odeslání soukromé zprávy dodavateli](_static/vendor-management/vendor_pm_send.png) > [!NOTE] > > V současné době mohou zákazníci kontaktovat dodavatele prostřednictvím kontaktního formuláře (nastavení `vendorsettings.allowcustomerstocontactvendors`). --- # Propagační nástroje nopCommerce vám umožňuje využívat k marketingu obchodu mnoho propagačních nástrojů. Mohou vám pomoci zvýšit povědomí zákazníků o vaší značce, motivovat partnery a dodavatele k účasti v affiliate programech, nabídnout zákazníkům výhodné nabídky (například slevy, množstevní ceny), zvýšit prodeje a budovat věrnost k vašemu obchodu. Více se dozvíte v následujících kapitolách: - [Slevy](xref:cs/running-your-store/promotional-tools/discounts) - [Dárkové poukazy](xref:cs/running-your-store/promotional-tools/gift-cards) - [Věrnostní body](xref:cs/running-your-store/promotional-tools/reward-points) - [Affiliate partneři](xref:cs/running-your-store/promotional-tools/affiliates) - [Množstevní ceny](xref:cs/running-your-store/promotional-tools/tier-prices) - [Křížový prodej a související produkty](xref:cs/running-your-store/promotional-tools/cross-sells-and-related-products) - [E-mailové kampaně](xref:cs/running-your-store/promotional-tools/email-campaigns) - [Integrace Brevo](xref:cs/running-your-store/promotional-tools/brevo-integration/index) - [Facebook Pixel](xref:cs/running-your-store/promotional-tools/facebook-pixel) - [Integrace Omnisend](xref:cs/running-your-store/promotional-tools/omnisend) - [Připomínky](xref:cs/running-your-store/promotional-tools/reminders) --- # Slevy V nopCommerce můžete pomocí slev zpřístupnit speciální nabídky. Lze je uplatnit na určité kategorie, produkty, celkovou částku a další. Pro své slevy můžete využít různé požadavky dostupné přímo v základu i prostřednictvím pluginů z [nopCommerce marketplace](http://www.nopcommerce.com/marketplace). Produkty v nopCommerce mohou mít připojen libovolný počet slev. V případě uplatnění více slev nopCommerce automaticky vypočítá nejlepší možnou cenu pro zákazníka na základě všech dostupných slev a členství ve skupinách. Nejběžnějším způsobem použití slev je kód kupónu. Kód kupónu zadává zákazník na stránce nákupního košíku těsně před přechodem k pokladně. Chcete-li zobrazit seznam slev, přejděte na stránku **Propagace → Slevy** (Promotions → Discounts): ![Slevy](_static/discounts/list.jpg) Horní část stránky umožňuje vyhledávat slevy podle různých kritérií: - **Datum začátku** (Start date) a **Datum konce** (End date) pro slevy vytvořené mezi těmito daty. - **Typ slevy** (Discount type). - **Dodavatel** (Vendor) pro vyhledávání podle konkrétního dodavatele. - **Kód kupónu** (Coupon code). - **Název slevy** (Discount name) je úplný název slevy nebo jeho část. - **Je aktivní** (Is Active). > [!NOTE] > > Ve výchozím stavu nejsou v nopCommerce k dispozici žádné slevy, takže je můžete vytvořit od začátku a řídit se vlastní marketingovou strategií. ## Přidání nové slevy Chcete-li přidat novou slevu, přejděte do **Propagace → Slevy** (Promotions → Discounts) a klikněte na **Přidat nový** (Add new). ![Přidání nové slevy](_static/discounts/add-new.jpg) Tato stránka je k dispozici ve dvou režimech: rozšířeném a základním. Zůstaňte v základním režimu, který zobrazuje pouze hlavní pole, nebo přepněte do rozšířeného režimu, který zobrazuje všechna dostupná pole. - Zaškrtněte políčko **Je aktivní** (Is active), pokud chcete tuto slevu nastavit jako aktivní. - Zadejte **Název** (Name) slevy. - V rozevíracím seznamu **Typ slevy** (Discount type) přiřaďte slevu k požadované možnosti takto: - *Přiřazeno k celkové částce objednávky* (Assigned to order total): tyto slevy se uplatňují na celou objednávku zákazníka (celkovou částku objednávky). - *Přiřazeno k produktům* (Assigned to products): po vytvoření této slevy ji majitel obchodu může přiřadit k produktu na stránce s detaily produktu nebo přidat produkty na panelu *Uplatněno na produkty* (Applied to products), který se zobrazí níže po uložení nové slevy. - *Přiřazeno ke kategoriím* (Assigned to categories): po vytvoření této slevy ji majitel obchodu může přiřadit ke kategorii na stránce úprav kategorie nebo přidat kategorie na panelu *Uplatněno na kategorie* (Applied to categories), který se zobrazí níže po uložení nové slevy. To umožňuje uplatnit slevu na všechny produkty v této kategorii. - Je-li tato možnost vybrána, zobrazí se pole **Uplatnit na podkategorie** (Apply to subcategories), které umožňuje uplatnit tuto slevu i na podkategorie. - *Přiřazeno k výrobcům* (Assigned to manufacturers): po vytvoření této slevy ji majitel obchodu může přiřadit k výrobci na stránce úprav výrobce nebo přidat výrobce na panelu *Uplatněno na výrobce* (Applied to manufacturer), který se zobrazí níže po uložení nové slevy. To umožňuje uplatnit slevu na všechny produkty tohoto výrobce. - *Přiřazeno k dopravě* (Assigned to shipping): tyto slevy se uplatňují na poplatek za dopravu. - *Přiřazeno k mezisoučtu objednávky* (Assigned to order subtotal): tyto slevy se uplatňují na hodnoty mezisoučtu objednávky. - Vyberte **Dodavatele** (Vendor). [Dodavatele](xref:cs/running-your-store/vendor-management) můžete spravovat v **Zákazníci → Dodavatelé** (Customers → Vendors). Jediným podporovaným typem slevy pro dodavatele bude „Přiřazeno k produktům“. Žádné jiné typy slev nebude možné vytvořit. Dodavatel pak bude moci k této slevě přiřadit pouze své vlastní produkty (karta „Uplatněno na produkty“). - Zaškrtněte políčko **Použít procenta** (Use percentage), pokud chcete uplatnit procentuální slevu. - Je-li předchozí políčko zaškrtnuto, zobrazí se pole **Procento slevy** (Discount percentage). - Můžete také nastavit **Maximální částku slevy** (Maximum discount amount). Ponechte toto pole prázdné, chcete-li povolit jakoukoli výši slevy. Pokud používáte typ slevy *Přiřazeno k produktům*, bude uplatněna na každý produkt zvlášť. - Pokud políčko **Použít procenta** není zaškrtnuto, můžete na objednávku nebo SKU uplatnit **Částku slevy** (Discount amount). - Zaškrtněte políčko **Vyžaduje kód kupónu** (Requires coupon code), aby zákazník mohl pro získání slevy uplatnit kód kupónu. - Po zaškrtnutí políčka se zobrazí možnost **Kód kupónu** (Coupon code). Do tohoto pole můžete zadat požadovaný kód kupónu. Zákazníci pak mohou během pokladny zadat kód kupónu a uplatnit slevu. > [!NOTE] > > Zákazník může na objednávku uplatnit neomezený počet kódů kupónů, pokud pro ni platí. - Pokud chcete pro svou slevu určit **Datum začátku** (Start date) a **Datum konce** (End date), vyberte je v poli kalendáře v koordinovaném světovém čase (UTC). - Možnost **Kumulativní s ostatními slevami** (Cumulative with other discounts) umožňuje zákazníkům používat několik slev současně. Je-li vybrána, lze tuto slevu používat souběžně s ostatními. > [!NOTE] > > Tato funkce funguje pouze pro slevy stejného typu. Slevy různých typů jsou již nyní kumulativní. - Můžete také omezit počet použití slevy. V rozevíracím seznamu **Omezení slevy** (Discount limitation) vyberte požadované omezení slevy: - *Neomezeno* (Unlimited). - *Pouze N-krát* (N times only): vyberte tuto možnost a zadejte, kolikrát bude tato sleva k dispozici. - *N-krát na zákazníka* (N times per customer): vyberte tuto možnost a zadejte, kolikrát bude tato sleva k dispozici pro jednoho zákazníka. - V poli **Maximální zlevněné množství** (Maximum discounted quantity) (viditelné pouze tehdy, když je **Typ slevy** nastaven na *Přiřazeno k produktům*, *kategoriím* nebo *výrobcům*) zadejte maximální množství produktu, které lze zlevnit. Lze to použít pro scénáře typu „kupte 2 a třetí dostanete zdarma“. - V případě potřeby zadejte **Komentář administrátora** (Admin comment). Zákazníkům se nezobrazí. Kliknutím na **Uložit** (Save) uložíte změny, nebo kliknutím na **Uložit a pokračovat v úpravách** (Save and continue edit) přejdete k úpravám dalších panelů. ## Přidání požadavků slevy Po vytvoření slevy můžete přidat požadavky slevy, pokud chcete, aby se na slevu vztahovala určitá konkrétní pravidla. Požadavky nastavte, pokud chcete slevu omezit na určité kategorie uživatelů v závislosti na roli zákazníka, utracené částce nebo jiných kritériích. Můžete použít jeden typ požadavku nebo seskupit několik typů a uplatnit je současně. Chcete-li přidat požadavky slevy, přejděte na panel *Požadavky* (Requirements): ![Požadavky](_static/discounts/requirements.jpg) Chcete-li přidat nový požadavek, vyberte z rozevíracího seznamu **Typ požadavku slevy** (Discount requirement type). - V nopCommerce je přímo v základu k dispozici jeden typ požadavku: *Musí být přiřazen k roli zákazníka* (Must be assigned to a customer role). Ten umožňuje nakonfigurovat slevy pro určité skupiny zákazníků (role). Další požadavky jsou k dispozici jako pluginy na našem [marketplace](https://www.nopcommerce.com/en/extensions?searchterm=discount+requirement&category=discounts-promotions). - Můžete také vytvořit skupinu požadavků pro složité požadavky s více pravidly. Skupina požadavků je užitečná funkce pro vytváření šablon požadavků slevy. Skupinu požadavků stačí vytvořit jen jednou a poté ji použít, kdykoli chcete toto omezení uplatnit. V případě potřeby můžete jednu skupinu požadavků zahrnout do jiné. Požadavky se nastavují pomocí booleovské logiky. Například pokud chcete, aby byla sleva přiřazena ke konkrétní roli zákazníka, nebo v případě, že zákazník utratil určitou částku. Takové požadavky a další jsou k dispozici jako pluginy na našem [marketplace](https://www.nopcommerce.com/en/extensions?searchterm=discount+requirement&category=discounts-promotions). ![Skupinové požadavky](_static/discounts/discount-requirenents-group.png) Můžete nastavit neomezený počet skupin požadavků, jednu uvnitř druhé. Například ve složitějším případě, kdy chcete, aby zákazníci získali slevu, pokud jsou dodavateli a utratili určitou částku, nebo pokud jsou moderátory fóra a zároveň vložili do košíku určitý produkt. Když zákazníci uplatní slevu při přechodu k pokladně, zobrazí se takto: ![sleva v nákupním košíku](_static/discounts/discount-in-shopping-cart.png) ![kód kupónu](_static/discounts/coupone-code.png) ## Běžné typy slev ### Výprodej na Black Friday Black Friday je vždy den po Dni díkůvzdání. Jde o poměrně běžnou slevovou kampaň; téměř každý internetový obchod pořádá výprodej na Black Friday. ![Black Friday](_static/discounts/Black-friday.png) - **Název** (Name) — můžete zadat libovolný název; je pouze interní. - **Typ slevy** (Discount type) — zde jde o typ *Přiřazeno k mezisoučtu*, kdy se sleva uplatňuje na celou částku objednávky před připočtením všech poplatků (jako je poplatek za dopravu a daně). To je zde relevantní, protože chceme zlevnit všechny produkty v košíku. - Slevu můžeme uplatnit v % nebo jen zadat částku ve zvolené měně. Zde máme 10 %. - Lze omezit i **Maximální částku slevy** (Maximum discount amount), takže i když celková cena produktů v košíku činí 300 $, zákazník stejně získá slevu pouze 10 $. - Tato sleva bude vyžadovat **Kód kupónu** (Coupon code). Slevy můžete uplatňovat i bez zadávání kódů kupónů, ale z marketingového hlediska se to nedoporučuje. Kódy kupónů vám umožňují ověřit výsledky kampaní. - Slevy jsou často časově omezené. Zde jsme do polí **Datum začátku** (Start date) a **Datum konce** (End date) zadali data víkendu Black Friday. - Možnost **Kumulativní s ostatními slevami** (Cumulative with other discounts) umožňuje zákazníkům používat několik slev současně. - Poslední nastavení se týká **Omezení slevy** (Discount limitation). Tuto slevu lze například uplatnit jednou na zákazníka. ### Kupte jeden kus a druhý získejte o 50 % levněji Často potřebujete prodat více kusů určitého produktu. V takovém případě můžete zákazníkům nabídnout slevu, abyste je motivovali ke koupi více kusů. Podívejme se, jak ve vašem obchodě nopCommerce použít slevu „Kupte jeden kus a druhý získejte o 50 % levněji“. ![Úprava detailů slevy](_static/discounts/buy_1.png) - **Typ slevy** (Discount type) je *Přiřazeno k produktům*. Produkty můžete přidat na panelu *Uplatněno na produkty* (Applied to products); zde to bude „Oversized T-shirt“. - Chceme, aby zákazníci získali slevu 50 % na druhé tričko. - Tuto slevu lze použít jednou na zákazníka, takže **Maximální zlevněné množství** (Maximum discounted quantity) je 1. - Na panelu *Požadavky* (Requirements) můžete nastavit požadavky na množství produktu. Přidejte typ požadavku *Zákazník má všechny tyto produkty* (Customer has all of these products) a přidejte tričko s množstvím 2. Tento typ požadavku lze [stáhnout jako plugin](https://www.nopcommerce.com/en/has-all-products-discount-requirement-rule). O tom, jak instalovat pluginy, si přečtěte v sekci [Pluginy](xref:cs/getting-started/advanced-configuration/plugins-in-nopcommerce). ![Kupte jeden kus a druhý získejte o 50 % levněji](_static/discounts/buy_2.png) Tento scénář můžete využít i k nastavení další oblíbené slevy „Kupte jeden a druhý dostanete zdarma“, pokud nastavíte slevu 100 %. ## Viz také - Další pluginy s typy slev a typy požadavků slev na [nopCommerce marketplace](http://www.nopcommerce.com/marketplace) - Jak [instalovat pluginy](xref:cs/getting-started/advanced-configuration/plugins-in-nopcommerce) ## Výukové materiály - [Používání slev v nopCommerce](https://www.youtube.com/watch?v=cAXxnV79dzw&index=7&list=PLnL_aDfmRHwsbhj621A-RFb1KnzeFxYz4) - [Konfigurace slev pomocí booleovské logiky](https://www.youtube.com/watch?v=gBtZG3OcjnQ) --- # Dárkové poukazy V nopCommerce máte možnost prodávat vedle jiných typů produktů také dárkové poukazy. Dárkové poukazy jsou dobrým marketingovým nástrojem, který vám umožňuje oslovit více zákazníků a podpořit další nákupy. Dárkové poukazy jsou vysoce cíleným nástrojem, protože jejich příjemci jsou rozhodně motivováni je využít – je to pro ně jako osobní nabídka. ![Dárkový poukaz nopCommerce](_static/gift-cards/gift_main.png) ## Přidání nového dárkového poukazu Můžete vytvářet produkty typu dárkový poukaz – produkt definujete jako dárkový poukaz zaškrtnutím políčka **Je dárkový poukaz** (Is gift card) při vytváření produktu v panelu **Katalog → Produkty → Přidat nový → Dárkový poukaz** (Catalog → Products → Add new → Gift card). ![Je dárkový poukaz](_static/gift-cards/is_gift_card.png) V tomto panelu musíte také zadat **Typ dárkového poukazu** (Gift card type): *Virtuální* (Virtual) nebo *Fyzický* (Physical). > [!WARNING] > > Nedoporučuje se měnit typ dárkového poukazu v „ostrém“ obchodě. ## Aktivace dárkového poukazu Poté, co vaši zákazníci dokončí nákupy produktů typu dárkový poukaz, můžete vyhledávat a zobrazit seznam všech zakoupených dárkových poukazů v **Prodej → Dárkové poukazy** (Sales → Gift cards). ![Dárkové poukazy](_static/gift-cards/gift-cards.jpg) Chcete-li zobrazit podrobnosti dárkového poukazu, klikněte na tlačítko **Upravit** (Edit) vedle něj. Zobrazí se okno *Upravit podrobnosti dárkového poukazu* (Edit gift card details): ![Úprava dárkového poukazu](_static/gift-cards/gift-card-edit.jpg) Pro aktivaci dárkového poukazu zaškrtněte políčko **Je dárkový poukaz aktivován** (Is gift card activated). Poté vygenerujte **Kód kupónu** (Coupon code). > [!NOTE] > > Chcete-li dárkový poukaz aktivovat automaticky po dokončení objednávky, přejděte na stránku **Konfigurace → Nastavení → Nastavení objednávek** (Configuration → Settings → Order settings). Najděte panel *Dárkové poukazy* (Gift cards) a zaškrtněte políčko **Aktivovat dárkové poukazy po dokončení objednávky** (Activate gift cards after completing of an order). V tomto případě se **Kód kupónu** vygeneruje také automaticky. > Upozorňujeme, že tato stránka obsahuje i další nastavení týkající se aktivace dárkových poukazů. Můžete také definovat následující informace o dárkovém poukazu: - V poli **Typ dárkového poukazu** vyberte, zda je *Virtuální*, nebo *Fyzický*. - Vedle pole **Objednávka** (Order) klikněte na **Zobrazit** (View), chcete-li zobrazit objednávku, ve které byl dárkový poukaz zakoupen. - V poli **Počáteční hodnota** (Initial value) v případě potřeby upravte počáteční hodnotu poukazu. - Pole **Zbývající částka** (Remaining amount) umožňuje zobrazit zbývající částku tohoto dárkového poukazu. - Pole **Je dárkový poukaz aktivován** určuje, zda je tento dárkový poukaz aktivován a lze jej použít. - Pole **Kód kupónu** představuje kód kupónu dárkového poukazu (používá se během pokladny). - V případě potřeby upravte v příslušných polích **Jméno příjemce** (Recipients name), **E-mail příjemce** (Recipient's email) (pokud je typ dárkového poukazu *Virtuální*), **Jméno odesílatele** (Sender's name) a **E-mail odesílatele** (Sender's email) (pokud je typ dárkového poukazu *Virtuální*). - Do oblasti **Zpráva** (Message) zadejte volitelnou zprávu. - Klikněte na **Upozornit příjemce** (Notify recipient). Příjemci bude odeslán e-mail s podrobnostmi dárkového poukazu. Toto tlačítko je relevantní pouze pro virtuální dárkové poukazy, nikoli pro fyzické. ## Historie použití V panelu *Historie použití* (Usage history) vidíte seznam objednávek, pro které byl tento kupón dárkového poukazu použit. Poté, co je dárkový poukaz aktivován a odesílatel obdrží kód kupónu, může jej použít během pokladny. ![Historie použití dárkového poukazu](_static/gift-cards/gift-usage.jpg) ## Použití dárkových poukazů Dárkový poukaz se ve veřejném obchodě používá zadáním sériového čísla do pole na stránce nákupního košíku. ![Použití dárkového poukazu](_static/gift-cards/using-geft-cards.jpg) > [!NOTE] > > Pole pro dárkový poukaz na stránce nákupního košíku můžete vypnout zrušením zaškrtnutí políčka **Zobrazit pole pro dárkový poukaz** (Show gift card box) na stránce **Konfigurace → Nastavení → Nastavení nákupního košíku** (Configuration → Settings → Shopping cart settings) (panel *Obecné* (Common)). Můžete také zákazníkům umožnit kontrolu zůstatku dárkového poukazu. Za tímto účelem zaškrtněte políčko **Povolit zákazníkům kontrolovat zůstatek dárkového poukazu** (Allow customers to check gift card balance) na stránce **Konfigurace → Nastavení → Nastavení nákupního košíku** (panel *Obecné*). > [!NOTE] > > Tato funkce vyžaduje povolení CAPTCHA, protože je potenciálně nebezpečná, a CAPTCHA je potřeba k zabránění a ztížení útoků hrubou silou. Chcete-li aktivovat CAPTCHA, přejděte na stránku **Konfigurace → Nastavení → Obecná nastavení** (Configuration → Settings → General settings) a v panelu *CAPTCHA* zaškrtněte políčko **CAPTCHA povolena** (CAPTCHA enabled). Jak nastavit CAPTCHA, se dozvíte v části [Nastavení zabezpečení – CAPTCHA](xref:cs/getting-started/advanced-configuration/security-settings#captcha). ## Viz také - [Přidání produktů](xref:cs/running-your-store/catalog/products/add-products) - [Video návod na YouTube ke správě dárkových poukazů](https://www.youtube.com/watch?v=4SJ7uBZGas0&index=4&list=PLnL_aDfmRHwsbhj621A-RFb1KnzeFxYz4) --- # Věrnostní body Funkce „Věrnostní body“ umožňuje vytvořit a zavést věrnostní program, který zlepšuje zákaznickou zkušenost a zvyšuje loajalitu zákazníků. Program „Věrnostní body“ umožňuje zákazníkům získávat body za určité akce, které na webu provedou, například za registraci a nákupy. Věrnostní body lze použít jako jednu z platebních metod. Tato možnost se zobrazuje v oblasti platebních metod v pokladně. Směnitelné věrnostní body lze používat společně s dalšími platebními možnostmi, jako jsou platební karty, dárkové poukazy a další. Body lze také zrušit, pokud zákazník zruší objednávku nebo odešle žádost o vrácení. ## Správa věrnostních bodů Chcete-li spravovat program věrnostních bodů, přejděte do **Konfigurace → Nastavení → Věrnostní body** (Configuration → Settings → Reward points). Tato stránka je k dispozici ve dvou režimech: *základním* a *pokročilém*. Tato stránka umožňuje konfiguraci pro více obchodů; to znamená, že stejná nastavení lze definovat pro všechny obchody, nebo se mohou lišit obchod od obchodu. Pokud chcete spravovat nastavení pro určitý obchod, zvolte jeho název z rozbalovacího seznamu konfigurace pro více obchodů a zaškrtněte vlevo všechna potřebná políčka, abyste pro ně mohli nastavit vlastní hodnoty. Další podrobnosti najdete v kapitole [Více obchodů](xref:cs/getting-started/advanced-configuration/multi-store). Chcete-li nastavit svůj program věrnostních bodů, definujte tato nastavení: ## Obecné ![Obecná nastavení věrnostních bodů](_static/reward-points/settings-common.jpg) - Zaškrtnutím políčka **Povoleno** (Enabled) aktivujete program věrnostních bodů. - V poli **Směnný kurz** (Exchange rate) zadejte směnný kurz věrnostních bodů (například 1 bod = 1 $). - Do pole **Minimální počet věrnostních bodů k použití** (Minimum reward points to use) zadejte minimální počet věrnostních bodů, který musí zákazníci mít, než je mohou použít. Pokud toto nastavení nepotřebujete, zadejte 0. - Pokud vyplníte pole **Maximální počet věrnostních bodů k použití na objednávku** (Maximum reward points to use per order), zákazníci nebudou moci na jednu objednávku použít více než X věrnostních bodů. Pokud toto nastavení nechcete používat, nastavte 0. - Nastavení **Maximální podíl úhrady body** (Maximum redeemed rate) omezuje maximální část celkové částky objednávky, kterou lze uhradit věrnostními body (v procentech). Například pokud je nastaveno na 0,6, lze věrnostními body uhradit pouze 60 % celkové částky objednávky, ale ne více než **Maximální počet věrnostních bodů k použití na objednávku**. Pokud toto nastavení nechcete používat, nastavte 0. ## Získávání věrnostních bodů ![Získávání věrnostních bodů](_static/reward-points/settings-earning.jpg) - V poli **Body za nákupy** (Points for purchases) zadejte počet bodů udělovaných za nákupy. - V poli **Platnost bodů za nákupy** (Purchases points validity) zadejte počet dní, po které budou body udělené za nákupy platné. Výchozí hodnota je `45` dní. Pokud zadáte hodnotu `0`, platnost věrnostních bodů nikdy nevyprší. - V poli **Minimální celková částka objednávky** (Minimum order total) zadejte minimální celkovou částku objednávky (bez ceny dopravy) pro udělení bodů za nákupy. - V poli **Body za registraci** (Points for registration) zadejte počet bodů udělovaných za registraci zákazníka. - V poli **Platnost bodů za registraci** (Registration points validity) zadejte počet dní, po které budou body udělené za registraci platné. - Zaškrtněte políčko **Aktivovat body okamžitě** (Activate points immediately), pokud chcete zákazníkům umožnit používat věrnostní body hned po jejich získání. Pokud toto políčko zrušíte, zobrazí se další možnost: - V poli **Aktivace věrnostních bodů** (Reward points activation) zadejte období (počet dní/hodin), po jehož uplynutí budou věrnostní body aktivovány. - Zaškrtnutím políčka **Zobrazit, kolik bude získáno** (Display how much will be earned) ukážete zákazníkům, kolik bodů získají. Bude to vidět na stránce pokladny. - Zaškrtněte políčko **Body se sčítají pro všechny obchody** (Points accumulated for all stores), chcete-li všechny věrnostní body shromažďovat v jednom zůstatku pro všechny obchody, aby je bylo možné použít v kterémkoli obchodě. - V poli **Velikost stránky** (Page size) nastavte velikost stránky pro historii věrnostních bodů na stránce *Můj účet*. Klikněte na **Uložit** (Save). > [!NOTE] > > Věrnostní body se vztahují pouze na registrované uživatele. Když zákazník použije věrnostní body v pokladně, vypadá to takto: ![Věrnostní body v pokladně](_static/reward-points/reward_will_earn.png) ![Věrnostní body v pokladně](_static/reward-points/reward_pints_checkout.png) ## Viz také - [Výukové video o správě věrnostních bodů](https://www.youtube.com/watch?v=lE4-xDUKkd0&index=14&list=PLnL_aDfmRHwsbhj621A-RFb1KnzeFxYz4) --- # Affiliate partneři Affiliate marketing je internetová marketingová praxe, při které jsou affiliate partneři odměňováni za vygenerovanou návštěvnost webu (každého návštěvníka nebo zákazníka). Jde o webový program s platbou za výkon, jehož cílem je odměňovat affiliate partnery za přivádění kvalifikovaných potenciálních zákazníků nebo prodejů ze svých webů na web obchodníka. Affiliate partneři jsou třetí strany, které na váš web odkazují zákazníky. Software nopCommerce dokáže tato doporučení sledovat, takže správce obchodu může určit provizi, která má být affiliate partnerům vyplacena. Jakmile je zákazníkovi přiřazeno ID affiliate partnera, bude tímto ID označena také každá objednávka, kterou zadá. V nopCommerce vypadá odkaz affiliate partnera následovně: `http://www.yourstore.com/?AffiliateID=N` (kde N je ID affiliate partnera). Majitel obchodu může pro marketingové účely zadat také pole *přátelské URL* (friendly URL): `http://www.yourstore.com/?affiliate=your_friendly_name_here`. Tato adresa URL se zobrazí, když navštívíte stránku s podrobnostmi o affiliate partnerovi. Kdykoli někdo na webu affiliate partnera klikne na tento odkaz, nopCommerce vyhledá v řetězci dotazu parametr s ID affiliate partnera. ![Affiliate partneři v nopCommerce](_static/affiliates/affiliates.jpg.png) ## Přidání nového affiliate partnera Chcete-li přidat affiliate partnera, přejděte do **Propagace → Affiliate partneři** (Promotions → Affiliates) a klikněte na **Přidat nový** (Add new). ![Přidání nového affiliate partnera](_static/affiliates/affiliate_new.png) Zadejte údaje o affiliate partnerovi: - Zaškrtnutím políčka **Aktivní** (Active) affiliate partnera aktivujete. - **Jméno** (First name). - **Příjmení** (Last name). - **E-mail** (Email). - Název **společnosti** (Company). - Z rozevíracího seznamu vyberte **Zemi** (Country). - Pokud jsou vybranou zemí USA, zadejte také **Stát/kraj** (State/province). - **Okres/oblast** (County/region). - **Město** (City). - **Adresa 1** (Address 1). - **Adresa 2** (Address 2). - **PSČ** (Zip/postal code). - **Telefonní číslo** (Phone number). - **Číslo faxu** (Fax number). - Do pole **Komentář administrátora** (Admin comment) můžete zadat volitelný komentář nebo informace pro interní použití. - Můžete zadat **Přátelský název URL** (Friendly URL name), což je přátelský odkaz URL affiliate partnera pro marketingové účely, nebo můžete toto pole ponechat prázdné – pak se použije výchozí adresa URL. Ve výchozím nastavení mají affiliate partneři adresy URL ve tvaru: `http://www.yourstore.com/?AffiliateID=N` (kde N je ID affiliate partnera). Pokud kliknete na **Uložit a pokračovat v úpravách** (Save and continue edit), zobrazí se dva další panely, na kterých můžete zkontrolovat, jak je tento affiliate partner úspěšný: - Panel *Přidružení zákazníci* (Affiliated customers) zobrazuje seznam všech zákazníků přidružených k affiliate partnerovi. - Panel *Přidružené objednávky* (Affiliated orders) zobrazuje seznam všech přidružených objednávek. Když přidružený zákazník zadá objednávku, uvidíte ji na tomto panelu. ## Viz také - [Správa objednávek](xref:cs/running-your-store/order-management/index) - [Správa zákazníků](xref:cs/running-your-store/customer-management/index) --- # Množstevní ceny Množstevní ceny jsou propagační nástroj, který majiteli obchodu umožňuje nabízet speciální ceny, když zákazníci kupují větší množství určitého produktu. Tento nástroj se obvykle používá ve velkoobchodě, ale mohou jej využít i maloobchodníci, aby motivovali kupující a zvýšili prodeje. Množstevní ceny lze u produktu nastavit na stránce úprav produktu. Přejděte do **Katalog → Produkty** (Catalog → Products), vyberte produkt, ke kterému chcete přidat množstevní cenu, a klikněte na **Upravit** (Edit). Najděte panel *Množstevní ceny* (Tier prices) a přidejte novou množstevní cenu: ![Množstevní ceny](_static/tier-prices/tier.png) > [!NOTE] > > Než budete moci přidat množstevní ceny na stránku produktu, musíte produkt uložit. ## Přidání množstevních cen Kliknutím na tlačítko **Přidat novou množstevní cenu** (Add new tier price) přidáte novou množstevní cenu. Zobrazí se okno *Přidat novou množstevní cenu* (Add new tier price): ![Přidání množstevních cen](_static/tier-prices/add-new.jpg) - V polích **Množství** (Quantity) a **Cena** (Price) definujte cenu platnou pro určité množství produktu. - Pokud provozujete více obchodů, vyberte v rozevíracím seznamu **Obchod** (Store) ten, ve kterém plánujete množstevní ceny uplatnit. - V rozevíracím seznamu **Role zákazníka** (Customer role) vyberte roli zákazníka, na základě které bude množstevní cena definována, například *Všichni* zákazníci, *Registrovaní*, *Hosté*. - Do polí **Datum začátku** (Start date) a **Datum konce** (End date) zadejte období platnosti množstevních cen. Pokud to není relevantní, ponechte tato pole prázdná. Klikněte na **Uložit** (Save). Tabulka *Množstevní ceny* bude aktualizována o nová data. Nyní si můžete ve veřejné části obchodu prohlédnout aktualizovanou stránku s detaily produktu: ![Příklad množstevní ceny](_static/tier-prices/TierPriceExample.jpg) Když zákazník přidá do košíku určité množství produktu, cena se automaticky změní tak, aby odpovídala slevě. ## Výukové materiály - [Správa množstevních cen](https://www.youtube.com/watch?v=ERE08UEDU58&t=10s) --- # Křížový prodej a související produkty „Křížový prodej“ (Cross-sells) a „Související produkty“ (Related products) jsou marketingové nástroje v nopCommerce, které můžete použít k nabídnutí dalších produktů, jež by se zákazníkům mohly líbit na základě jejich nákupního chování (prohlížení a přidávání určitých produktů do košíku). Je to pro vás také dobrá příležitost k prodeji dražších variant (up-sell). Oba nástroje můžete používat současně. Křížový prodej a související produkty můžete nastavit při vytváření nebo úpravě produktu na stránce úpravy produktu. Přejděte do **Katalog → Produkty** (Catalog → Products), vyberte produkt a klikněte na **Upravit** (Edit). Najděte panely *Křížový prodej* (Cross-sells) a *Související produkty* (Related products). > [!NOTE] > > Než budete moci přidat produkty pro křížový prodej a související produkty, musíte produkt uložit. ## Křížový prodej Možnost „produkty pro křížový prodej“ poskytuje příležitost prodat další produkty, které se obvykle kupují spolu s vybraným produktem; můžete však přidat jakýkoli produkt z katalogu, i takový, který produkt v košíku nedoplňuje. Produkty pro křížový prodej se zobrazují v dolní části stránky pokladny. Když například zákazník kupuje procesor, může potřebovat monitor a ještě něco dalšího. K produktu můžete přidat neomezený počet produktů pro křížový prodej. ![Křížový prodej](_static/cross-sells-and-related-products/Cross-sells.png) ### Přidání nových produktů pro křížový prodej Klikněte na **Přidat nový produkt pro křížový prodej** (Add new cross-sell product) a vyberte produkt(y) z katalogu. Pro snadné vyhledání produktu můžete použít následující kritéria: **Název produktu** (Product name), **Kategorie** (Category), **Dodavatel** (Vendor), **Obchod** (Store), **Typ produktu** (Product type) a **Výrobce** (Manufacturer). ![Přidání nových produktů pro křížový prodej](_static/cross-sells-and-related-products/add-new-cross-sells.png) Poté, co vyberete produkt pro křížový prodej a uložíte jej, můžete zkontrolovat, jak se budou produkty pro křížový prodej zobrazovat na stránce pokladny: ![Křížový prodej na stránce pokladny](_static/cross-sells-and-related-products/Cross-sells_on_checkout.png) ## Související produkty Možnost Související produkty poskytuje příležitost propagovat zákazníkům spolu s vybraným produktem i další produkty a prodat jim dražší varianty. Tyto produkty se zobrazují pod vybraným produktem na stránce detailu produktu. K produktu můžete přidat neomezený počet souvisejících produktů. ![Související_produkty](_static/cross-sells-and-related-products/Related.png) ### Přidání nových souvisejících produktů Klikněte na **Přidat nový související produkt** (Add new related product) a vyberte produkt(y) z katalogu. Pro snadné vyhledání produktu můžete použít následující kritéria: **Název produktu**, **Kategorie**, **Dodavatel**, **Obchod**, **Typ produktu** a **Výrobce**. ![Přidání nového souvisejícího produktu](_static/cross-sells-and-related-products/adiing-new-related.png) Poté, co vyberete související produkt a uložíte jej, můžete zkontrolovat, jak se budou související produkty zobrazovat na stránce detailu produktu: ![Související produkty na stránce detailu produktu](_static/cross-sells-and-related-products/rel-product-on-the-prod-det-page.png) ## Viz také - [Přidání produktů](xref:cs/running-your-store/catalog/products/add-products) - [Množstevní ceny](xref:cs/running-your-store/promotional-tools/tier-prices) ## Návody - [Jak funguje křížový prodej v nopCommerce](https://www.youtube.com/watch?v=J_6OlVarIFc) - [Správa souvisejících produktů](https://www.youtube.com/watch?v=FGuozvhyqYE&t=6s) --- # E-mailové kampaně Během registrace může zákazník zvolit možnost *Newsletter*, aby dostával newslettery z vašeho obchodu. Případně se lze k odběru newsletteru přihlásit později pomocí formuláře v patičce (ve výchozím motivu nopCommerce Default Clean). Dalším způsobem, jak naplnit seznam e-mailových odběratelů, je importovat seznam odběratelů z externího souboru CSV do nopCommerce. Seznam odběratelů můžete z nopCommerce také exportovat do externího souboru CSV. Jak spravovat odběratele newsletteru, se dozvíte v sekci [Odběratelé newsletteru](#multiple-newsletter-lists) níže. Využijte svůj seznam odběratelů k vytváření e-mailových kampaní, abyste snadno a rychle oslovili cílové publikum bez dalších marketingových aktivit. Kampaně pomáhají budovat důvěru a loajalitu ke společnosti a zároveň zvyšují prodeje. Existuje několik příkladů e-mailových marketingových kampaní, které můžete pro svůj obchod využít: začněte uvítacím e-mailem s poděkováním za přihlášení k odběru, pravidelně rozesílejte oznámení, novinky o vaší společnosti, kupóny na budoucí nákupy a mnoho dalšího. > [!NOTE] > > Ve výchozím stavu nejsou k dispozici žádné kampaně, takže je můžete vytvořit od začátku a řídit se vlastní marketingovou strategií. Chcete-li spravovat kampaně, přejděte do **Propagace → Kampaně** (Promotions → Campaigns). ![Správa kampaní](_static/email-campaigns/manage-campaigns.png) ## Přidání nové e-mailové kampaně Chcete-li vytvořit novou kampaň, klikněte na **Přidat nový** (Add new). ![Přidání kampaně](_static/email-campaigns/add_new.png) Definujte následující detaily kampaně: - **Název** (Name) kampaně. - **Předmět** (Subject) kampaně. - Zadejte text **Těla** (Body) e-mailu, který chcete rozeslat. - V části **Povolené tokeny zpráv** (Allowed message tokens) uvidíte seznam povolených tokenů zpráv, které můžete v e-mailové kampani použít. Všechny je zobrazíte kliknutím na **Zobrazit** (Show). - Zadejte **Plánované datum odeslání** (Planned date of sending) a čas. - V rozevíracím seznamu **Omezeno na obchod** (Limited to store) vyberte, odběratelé kterého obchodu tento e-mail dostanou. - V rozevíracím seznamu **Omezeno na roli zákazníka** (Limited to customer role) vyberte role odběratelů, kteří tento e-mail obdrží. - V rozevíracím seznamu **Omezeno na typy odběru** (Limited to subscription types) zvolte typ odběru, na který bude tento e-mail odeslán. Klikněte na **Uložit** (Save) nebo **Uložit a pokračovat v úpravách** (Save and continue editing) a pokračujte k odeslání kampaně. ## Odeslání kampaně Po uložení kampaně ji můžete odeslat zákazníkům. V horní části stránky uvidíte nový panel: ![Testovací e-mail](_static/email-campaigns/test.jpg) > [!NOTE] > > Před rozesláním kampaně většímu počtu zákazníků se ujistěte, že jste ji otestovali. Nejprve odešlete testovací e-mail a zkontrolujte, zda je vše provedeno správně. Za tímto účelem zvolte **E-mailový účet** (Email account), který bude použit k odeslání kampaně. Jak vytvořit e-mailový účet, se dozvíte v sekci [E-mailové účty](xref:cs/getting-started/email-accounts). Poté zadejte svou e-mailovou adresu do pole **Odeslat testovací e-mail na** (Send test email to) a klikněte na **Odeslat testovací e-mail** (Send test email). Až se ujistíte, že je vše v pořádku, odešlete kampaň zákazníkům pomocí tlačítka **Odeslat hromadný e-mail** (Send mass email). ## Více seznamů newsletterů Funkce **Více seznamů newsletterů** (Multiple Newsletter Lists) umožňuje majitelům obchodů vytvářet a spravovat pro své zákazníky více možností odběru newsletterů. Dříve byl k dispozici pouze jediný výchozí newsletter. Díky této funkci si nyní zákazníci mohou vybrat, které newslettery chtějí odebírat, a mají tak větší kontrolu nad komunikací, kterou dostávají. Ve výchozím stavu je k dispozici jeden seznam newsletteru s názvem **„Newsletter“**. Majitelé obchodů mohou vytvářet další seznamy, například **„Partner Newsletter“**, **„Special Offers“** nebo **„Promo Newsletter“**, a spravovat je z administrace. ### Zkušenost zákazníka Jsou-li nakonfigurovány více seznamů newsletterů, zákazníci uvidí všechny dostupné seznamy na: - **registrační stránce** - **stránce s informacemi o zákazníkovi** Zákazníci si mohou pomocí zaškrtávacích políček vybrat newslettery, které chtějí odebírat. ![Přihlašování zákazníků k odběru](_static/email-campaigns/customer_subs.png) Případně se zákazníci mohou přihlásit k odběru později pomocí formuláře v patičce (ve výchozím motivu nopCommerce Default Clean): ![Box newsletteru](_static/email-campaigns/newsletter-box.jpg) ### Správa odběratelů Na stránce **Propagace → Odběratelé newsletteru** (Promotions → Newsletter subscribers) můžete vyhledávat odběratele pomocí následujících polí: ![Odběratelé newsletteru](_static/email-campaigns/subscribers.png) - **E-mail** (Email) – Zadejte e-mail odběratele, chcete-li jej najít, nebo ponechte prázdné pro načtení všech odběratelů. - **Datum začátku / Datum konce** (Start date / End date) – Filtrování podle data přihlášení k odběru. - **Aktivní** (Active) – Vyberte mezi *Aktivní*, *Neaktivní* nebo *Všichni* odběratelé. - **Obchod** (Store) – Vyberte obchod. - **Role zákazníků** (Customer roles) – Vyberte roli zákazníka. - **Typ odběru** (Subscription type) – Vyberte typ odběru. Kliknutím na **Hledat** (Search) použijete filtry. Funkce vytváření a úprav odběrů je k dispozici prostřednictvím administrace. ![NewsLetterSubscription](_static/email-campaigns/newsletter_subscription_create.png) Odběratele newsletteru můžete spravovat také importem seznamu z externího souboru CSV do nopCommerce nebo exportem odběratelů do souboru CSV. Export nebo import odběratelů newsletteru: - Kliknutím na **Importovat z CSV** (Import from CSV) importujete seznamy odběratelů ve formátu CSV. - Kliknutím na **Exportovat do CSV** (Export to CSV) exportujete stávající seznam odběratelů. ### Správa typů odběru Kromě správy odběratelů mohou majitelé obchodů zobrazovat a upravovat **typy odběru**. To umožňuje plnou kontrolu nad tím, jaké druhy newsletterů jsou zákazníkům k dispozici. - V administraci přejděte do **Propagace → Typy odběru** (Promotions → Subscription types). - Můžete přidávat, upravovat nebo mazat typy odběru. - Tyto typy se zákazníkům zobrazí jako možnosti při přihlašování k odběru. **Příklady:** Správa existujících typů odběru: ![NewsLetterSubscription](_static/email-campaigns/newsletter_subscription_types.png) Úprava nebo vytvoření detailů typu odběru: ![NewsLetterSubscription](_static/email-campaigns/newsletter_subscription_type_create.png) ### Správa kampaní Při vytváření e-mailové kampaně mohou majitelé obchodů: - Vybrat **konkrétní seznam newsletteru**, na který se má kampaň zaměřit - Zvolit **„všechny seznamy newsletterů“** a odeslat kampaň všem zákazníkům přihlášeným k odběru alespoň jednoho newsletteru Tato funkcionalita je plně integrována s e-mailovými pluginy, jako je **Brevo**, což zajišťuje bezproblémové doručení kampaní. ## Výukové materiály - [Správa kampaní v nopCommerce](https://youtu.be/iW2m8LQyyWM) --- # Integrace Brevo ## Co je Brevo [Brevo](https://get.brevo.com/5f897rrc6cwa) je komplexní sada nástrojů pro digitální marketing, která dokáže pokrýt veškeré vaše marketingové potřeby. Brevo umožňuje budovat a rozvíjet vztahy pomocí e-mailových kampaní, SMS zpráv a pokročilé automatizace marketingových procesů. Integrace Brevo pro nopCommerce umožňuje majiteli obchodu: * navrhovat přehledné a profesionální newslettery * budovat a cílit publikum * automatizovat marketing (například obnovu opuštěných košíků) Projděte si následující kapitoly a zjistěte, jak: * [Nastavit plugin Brevo](xref:cs/running-your-store/promotional-tools/brevo-integration/set-up-brevo-plugin) * [Obnovit opuštěné košíky](xref:cs/running-your-store/promotional-tools/brevo-integration/recover-abandoned-carts) * [Odeslat e-mail s potvrzením objednávky](xref:cs/running-your-store/promotional-tools/brevo-integration/send-an-order-confirmation-email) --- # Nastavení pluginu Brevo Tato sekce popisuje, jak integrovat Brevo do vašeho obchodu. ## Instalace a povolení pluginu Plugin Brevo je plugin, který je součástí nopCommerce již při instalaci. Najdete jej zde: **Konfigurace → Místní pluginy** (Configuration → Local plugins). Chcete-li plugin najít rychleji, použijte pole **Skupina** (Group) ve vyhledávacím panelu a vyfiltrujte pluginy typu *Různé* (Misc): ![Vyhledání pluginu](_static/set-up-brevo-plugin/plugin-list.jpg) Pokud plugin není nainstalován, nainstalujte jej pomocí tlačítka **Instalovat** (Install). Poté jej povolte kliknutím na tlačítko **Upravit** (Edit). V takovém případě se zobrazí okno *Upravit podrobnosti pluginu* (Edit plugin details). Označte plugin jako povolený pomocí zaškrtávacího políčka **Je povoleno** (Is enabled) a klikněte na tlačítko **Uložit** (Save). ## Jak nakonfigurovat plugin 1. Klikněte na tlačítko **Konfigurovat** (Configure). Zobrazí se okno *Konfigurace – Brevo* (Configure - Brevo): ![Konfigurace – Brevo](_static/set-up-brevo-plugin/configure-window.jpg) 1. Budete si muset vytvořit bezplatný účet Brevo pomocí [tohoto odkazu](https://get.brevo.com/5f897rrc6cwa). 1. Zadejte svůj **API v3 klíč** (API v3 key) z účtu Brevo, který najdete na stránce [SMTP & API](https://account.brevo.com/advanced/api/). 1. Klikněte na tlačítko **Uložit**. 1. Jakmile to uděláte, měli byste vidět podrobnosti svého účtu. ![Po prvním uložení](_static/set-up-brevo-plugin/general-panel.jpg) 1. Přejděte do panelu **Kontakty** (Contacts) a synchronizujte zákazníky nopCommerce se svým účtem Brevo. ![Kontakty](_static/set-up-brevo-plugin/contacts-panel.jpg) * Chcete-li vytvořit nový seznam Brevo, klikněte na tlačítko **Vytvořit seznam** (Create a list) a budete přesměrováni do svého účtu Brevo. * V rozbalovacím seznamu vyberte seznam, do kterého budou přidáni vaši odběratelé z nopCommerce a jejich kontaktní údaje. Klikněte na tlačítko **Uložit**. ### Jaká data se synchronizují? Následující pole formuláře se synchronizují jako atributy kontaktu: * EMAIL * FIRSTNAME * LASTNAME * SMS * STORE_ID * USERNAME * PHONE * COUNTRY * GENDER * DATE_OF_BIRTH * COMPANY * ADDRESS_1 * ADDRESS_2 * ZIP_CODE * CITY * COUNTY * STATE * FAX > [!NOTE] > > Pro synchronizaci musí být tato pole formuláře pro zákazníky povolena. Přejděte do **Konfigurace → Nastavení → Nastavení zákazníků → Pole formuláře zákazníka** (Configuration → Settings → Customer settings → Customer form fields). Data objednávek se synchronizují jako transakční atributy: * ORDER_ID: ID objednávky * ORDER_PRICE: částka objednávky * ORDER_DATE: datum objednávky > [!NOTE] > > Objednávky se synchronizují, když je jejich stav platby „Zaplaceno“ (Paid). ### Jak často se kontakty synchronizují? Po počáteční synchronizaci je naplánována úloha, která se spouští každých 6000 sekund a automaticky přidává nové odběratele do vašeho seznamu Brevo. Chcete-li synchronizovat ihned, klikněte na tlačítko **Synchronizovat nyní** (Sync now). Chcete-li změnit frekvenci synchronizace, přejděte do **Systém → Plánované úlohy** (System → Schedule tasks). ![Plánované úlohy](_static/set-up-brevo-plugin/configure-task.jpg) ## Odesílání transakčních e-mailů Přejděte do panelu **Transakční e-maily** (Transactional emails), chcete-li odesílat transakční e-maily přes SMTP Brevo. ![Odesílání transakčních e-mailů](_static/set-up-brevo-plugin/email-panel.jpg) 1. Zaškrtněte políčko **Použít SMTP Brevo** (Use Brevo SMTP). 1. Vložte své heslo SMTP, které najdete na [stránce účtu Brevo](https://account.brevo.com/advanced/api). 1. V rozbalovacím seznamu vyberte odesílatele, ze kterého chcete e-maily odesílat. 1. Klikněte na tlačítko **Uložit**. Poté byste měli vidět seznam e-mailových oznámení. Obsahuje všechny transakční e-maily (například potvrzení objednávky), které odesíláte. ![Seznam oznámení](_static/set-up-brevo-plugin/email-list.jpg) U každé šablony můžete: * Zvolit, zda je aktivní, nebo neaktivní. * Zvolit mezi výchozí šablonou nopCommerce a šablonou Brevo. Postup: 1. Klikněte na tlačítko **Upravit** (Edit) 1. V rozbalovacím seznamu vyberte svou šablonu 1. Klikněte na **Aktualizovat** (Update) * Upravit její obsah. > [!NOTE] > > Pokud *jste vybrali* **e-mailovou šablonu Brevo** (Brevo email template), klikněte na **Upravit šablonu** (Edit template) a upravte obsah šablony ve svém účtu Brevo. Pokud *jste nevybrali* **e-mailovou šablonu Brevo**, kliknutím na **Upravit šablonu** budete přesměrováni na stránku úpravy šablony zprávy v administraci nopCommerce. Více o [procesu úpravy šablon zpráv](xref:cs/running-your-store/content-management/message-templates). Z této stránky můžete také odeslat testovací e-mail a zkontrolovat obsah. Upozorňujeme, že za každý testovací e-mail bude použit jeden e-mailový kredit. ## Odesílání SMS Přejděte do panelu **SMS**, chcete-li zákazníkům kromě e-mailů zasílat také SMS oznámení. ![Panel SMS](_static/set-up-brevo-plugin/sms-panel.jpg) 1. Zaškrtněte políčko **Použít SMS oznámení** (Use SMS notifications). 1. Zadejte alfanumerického odesílatele (maximálně 11 znaků). 1. Zadejte své telefonní číslo. 1. Klikněte na tlačítko **Uložit**. Odeslání SMS kampaně na seznam Brevo: ![Panel SMS](_static/set-up-brevo-plugin/sma-campaigns.jpg) 1. Přejděte do bloku **SMS kampaně** (SMS campaigns). 1. Zvolte **Seznam** (List) kontaktů, kterým se SMS kampaň odešle. 1. Do pole **Odeslat SMS kampaň od** (Send SMS campaign from) zadejte jméno odesílatele. Počet znaků je omezen na 11 (alfanumerický formát). 1. Obsah SMS kampaně zadejte do pole **Text**. Počet znaků je pro jednu zprávu omezen na 160. 1. Klikněte na **Uložit kampaň** (Save campaign). Plugin je nyní nakonfigurován. Ke všem statistikám transakčních e-mailů máte přístup přímo z Brevo. ## Nastavení pracovních postupů marketingové automatizace > [!NOTE] > > Aby se pracovní postup spustil, musí být zákazník identifikován svou e-mailovou adresou, to znamená, že zákazník musí být přihlášen ke svému účtu v obchodě nopCommerce nebo zadat svou e-mailovou adresu během pokladny. Přejděte do panelu **Marketingová automatizace** (Marketing Automation) a nainstalujte sledovací skript marketingové automatizace, který sleduje aktivitu nakupujících ve vašem obchodě. Budete moci automatizovat svůj marketing zasíláním série e-mailů nebo SMS, jakmile se návštěvník zaregistruje, potenciální zákazník opustí košík, zákazník provede nákup nebo v případě jiné události. ![Marketingová automatizace](_static/set-up-brevo-plugin/marketing-automation.jpg) 1. Zaškrtněte políčko **Použít marketingovou automatizaci** (Use Marketing Automation). 1. Pokud je ve vašem účtu Brevo povolena *platforma marketingové automatizace* (Marketing Automation platform), plugin automaticky vyplní vaše **ID sledování** (Tracker ID). 1. Vložte sledovací skript vygenerovaný službou Brevo do pole **Sledovací skript** (Tracking script). {TRACKING_ID} a {CUSTOMER_EMAIL} budou dynamicky nahrazeny. 1. Ujistěte se, že widget Brevo je aktivován na stránce **Konfigurace → Widgety** (Configuration → Widgets). 1. Klikněte na tlačítko **Uložit**. Jakmile je marketingová automatizace povolena a správně funguje, najdete ve svém účtu Brevo v části *Automation → Logs → Event logs* následující záznamy: * Page * Identify * Track events Plugin bude automaticky sledovat aktivitu nakupujících, abyste mohli nastavit pracovní postupy pro obnovení ztracených prodejů a pracovní postupy pro potvrzení objednávek. Předávají se 3 sledované události: * cart_updated se předává, když je položka přidána do košíku. * cart_deleted se předává, když je košík vyprázdněn. * order_completed se předává, když byla vytvořena objednávka. To znamená, že stav platby je „Zaplaceno“ (Paid). ![Záznamy](_static/set-up-brevo-plugin/logs.png) ## Další informace * Zjistěte, jak [vytvořit e-mail o opuštěném košíku](xref:cs/running-your-store/promotional-tools/brevo-integration/recover-abandoned-carts). * Zjistěte, jak [vytvořit e-mail s potvrzením objednávky](xref:cs/running-your-store/promotional-tools/brevo-integration/send-an-order-confirmation-email). --- # Obnova opuštěných košíků V tomto návodu se dozvíte, jak vytvořit e-mail pro opuštěný košík a jak nastavit workflow pro získání ztracených prodejů. Dozvíte se také, která data objednávek z nopCommerce jsou kompatibilní s platformou Brevo. ## Než začnete Budete potřebovat: * Přihlašovací údaje k účtu Brevo. Pokud účet nemáte, [zaregistrujte se zdarma](https://get.brevo.com/v70whp). * Ujistěte se, že je ve vašem účtu povolen [*New Template Language*](https://get.brevo.com/eg4z2v) pro e-maily od Brevo. * Nastavte plugin Brevo podle [těchto kroků](xref:cs/running-your-store/promotional-tools/brevo-integration/set-up-brevo-plugin). ## Vytvoření šablony e-mailu pro opuštěný košík Nejprve se přihlaste ke svému účtu Brevo a přejděte do platformy Automation > [Email Templates](https://get.brevo.com/e8j7a). Klikněte na tlačítko **New Template** vpravo nahoře. Šablonu e-mailu lze personalizovat několika typy dat: * [atributy kontaktů uložené ve vašem seznamu Brevo](#personalize-your-email-with-contact-attributes) * [podrobnosti o opuštěných položkách](#personalize-your-email-with-the-abandoned-items-details) * [podrobnosti o opuštěném košíku](#personalize-your-email-with-the-abandoned-cart-details) ### Personalizace e-mailu pomocí atributů kontaktů Začněme [personalizací pomocí atributů kontaktů](https://get.brevo.com/bynyff). V níže uvedeném příkladu jsme zahrnuli personalizaci: * křestního jména příjemce pomocí {{ contact.FIRSTNAME }} * příjmení příjemce pomocí {{ contact.LASTNAME }} > [!NOTE] > > FIRSTNAME a LASTNAME musí být existující atributy ve vašem účtu Brevo. ![Personalizace atributy](_static/recover-abandoned-carts/attribute-personalization.gif) Nyní personalizujme šablonu e-mailu pomocí proměnných objednávky, jako je název ponechaných položek, jejich obrázky, cena atd. K tomu použijeme *New Template Language* pro vložení dynamického seznamu. ### Personalizace e-mailu pomocí podrobností o opuštěných položkách Následující proměnné lze vložit přímo z dynamického seznamu v obsahu vaší šablony Brevo: | Data položek | Vložte do šablony tento zástupný symbol | | ------------- | ------------- | | Název | {{ item.name }} | | SKU | {{ item.sku }} | | Kategorie | {{ item.category }} | | ID | {{ item.id }} | | ID varianty položky | {{ item.variant_id }} | | Název varianty položky | {{ item.variant_name }} | | Cena | {{ item.price }} | | Množství | {{ item.quantity }} | | Odkaz na zakoupenou položku v obchodě | {{ item.url }} | | Obrázek | {{ item.image }} | V *Drag & Drop Editoru* vyberte požadovaný blok, ve kterém se budou zobrazovat opuštěné položky. 1. Kliknutím na **ikonu tužky** upravte nastavení designového bloku. 1. Povolte možnost **dynamic list**. 1. Do pole **parameter** napište `items`. 1. Do pole **variable** napište `item`. 1. Nastavte limit počtu zobrazených položek. Pokud například v košíku zůstalo 5 položek a vy nastavíte limit 3, zobrazí se v e-mailu pouze 3 položky. ![Editor e-mailu](_static/recover-abandoned-carts/items.jpg) Nyní do šablony e-mailu přidejte proměnné. Ve výše uvedeném příkladu jsme přidali: * `{{ item.name }}` – název položky * `{{ item.quantity }}` – množství položky * `{{ item.price | floatformat: 2 }}` – cenu položky Chcete-li přidat odkaz na položku, vyberte tlačítko **Call-To-Action (CTA)**. V pravém postranním panelu v části *Link* napište `{{ item.url }}`. ![item.url](_static/recover-abandoned-carts/item-url.jpg) Chcete-li přidat obrázek položky, vyberte obrázek. V pravém postranním panelu v části *Image source* zvolte *From URL* a napište `{{ item.image }}`. ![item.image](_static/recover-abandoned-carts/item-image.jpg) Po dokončení designu klikněte na zelené tlačítko **Save & Quit**. Poté klikněte na tlačítko **Save & Activate**. ### Personalizace e-mailu pomocí podrobností o opuštěném košíku Následující proměnné lze vložit přímo do obsahu vaší šablony Brevo: | Podrobnosti košíku | Vložte tento zástupný symbol | | ------------- | ------------- | | Afiliace | {{ params.affiliation }} | | Měna | {{ params.currency }} | | Sleva | {{ params.discount }} | | Doprava | {{ params.shipping }} | | Mezisoučet | {{ params.subtotal }} | | Daň | {{ params.tax }} | | Celkem před zdaněním | {{ params.tax }} | | Celkem | {{ params.total_before_tax }} | | Odkaz na košík | {{ params.url }} | > [!NOTE] > > Položky zobrazené na stránce, na kterou vede odkaz na košík, se budou lišit podle toho, odkud je relace otevřena. Řekněme například, že zákazník prochází obchod na notebooku. Pokud klikne na e-mail o opuštěném košíku z telefonu, jeho opuštěný košík se nezobrazí. V *Drag & Drop Editoru* vyberte požadovaný blok, ve kterém se budou zobrazovat informace o opuštěném košíku, a přidejte požadované proměnné objednávky. Doporučujeme formátovat čísla pomocí [floatformat](https://get.brevo.com/ogcn5b). V níže uvedeném příkladu jsme přidali: * `{{ params.currency }}` – měnu opuštěného košíku * `{{ params.subtotal | floatformat: 2 }}` – mezisoučet opuštěného košíku * `{{ params.discount | floatformat: 2 }}` – slevu opuštěného košíku * `{{ params.total | floatformat: 2 }}` – celkovou částku opuštěného košíku ![Košík](_static/recover-abandoned-carts/cart.jpg) Chcete-li přidat odkaz na opuštěný košík, vyberte tlačítko **Call-To-Action (CTA)**. V pravém postranním panelu v části *Link* napište `{{ params.url }}`. ![params.url](_static/recover-abandoned-carts/url.jpg) Po dokončení designu klikněte na zelené tlačítko **Save & Quit**. Poté klikněte na tlačítko **Save & Activate**. ## Vytvoření workflow pro opuštěný košík > [!NOTE] > > Aby se workflow spustilo, musí být zákazník identifikován svou e-mailovou adresou, tj. zákazník by měl být přihlášen ke svému účtu ve vašem obchodě nopCommerce nebo zadat svou e-mailovou adresu během pokladny. Přejděte na záložku [Automation](https://get.brevo.com/tvl7ng) ve svém účtu Brevo. Klikněte na **+ CREATE A NEW WORKFLOW**, poté vyberte **Detailed Abandoned Cart** a postupujte podle jednotlivých kroků. ![Detailed Abandoned Cart](_static/recover-abandoned-carts/detailed-abandoned-cart.jpg) V kroku *Send an email* vyberte z rozbalovacího seznamu šablonu e-mailu, kterou jste právě vytvořili a aktivovali. Po dokončení workflow jej kliknutím na **DONE** uložte a aktivujte. Při vytváření workflow vám může pomoci tento návod: * [Obnova opuštěných košíků: automatické odesílání e-mailů (krok 3)](https://get.brevo.com/gqqwh) ## Příklad Řekněme, že zákazník Jean Blue navštívil váš obchod, ale v košíku ponechal následující 3 položky. ![Příklad košíku](_static/recover-abandoned-carts/cart-example.jpg) Vaše šablona bude vypadat takto: ![Příklad košíku](_static/recover-abandoned-carts/template.jpg) E-mail, který Jean Blue obdrží, bude vypadat takto: ![Příklad košíku](_static/recover-abandoned-carts/email.jpg) ## Další informace * [Odeslání e-mailu s potvrzením objednávky](xref:cs/running-your-store/promotional-tools/brevo-integration/send-an-order-confirmation-email) --- # Odeslání e-mailu s potvrzením objednávky V tomto návodu se naučíte, jak vytvořit šablonu e-mailu s potvrzením objednávky a nastavit workflow, které udrží zájem kupujících. Dozvíte se také, která data objednávek nopCommerce jsou kompatibilní s platformou Brevo. ## Než začnete Budete potřebovat následující: * Přihlašovací údaje k účtu Brevo. Pokud účet nemáte, [zaregistrujte se zdarma](https://get.brevo.com/v70whp). * Ujistěte se, že je ve vašem účtu pro e-maily povolen [*New Template Language*](https://get.brevo.com/eg4z2v) od Brevo. * Podle [těchto kroků](xref:cs/running-your-store/promotional-tools/brevo-integration/set-up-brevo-plugin) nastavte plugin Brevo. ## Vytvoření šablony e-mailu s potvrzením objednávky Nejprve se přihlaste ke svému účtu Brevo a poté přejděte na platformu Automation > [Email Templates](https://get.brevo.com/e8j7a). Klikněte na tlačítko **New Template** vpravo nahoře. Šablonu e-mailu lze personalizovat pomocí několika typů dat: * [atributů kontaktu uložených ve vašem seznamu Brevo](#personalize-your-email-with-contact-attributes) * [podrobností objednávky](#personalize-your-email-with-the-order-details) * [podrobností objednaných položek](#personalize-your-email-with-the-ordered-items-details) ### Personalizace e-mailu pomocí atributů kontaktu Začněme personalizací pomocí [atributů kontaktu](https://get.brevo.com/bynyff). V níže uvedeném příkladu jsme zahrnuli personalizaci: * křestního jména příjemce pomocí `{{ contact.FIRSTNAME }}` * příjmení příjemce pomocí `{{ contact.LASTNAME }}` > [!NOTE] > > FIRSTNAME a LASTNAME musí být existující atributy ve vašem účtu Brevo. ![Personalizace pomocí atributů](_static/send-an-order-confirmation-email/attribute-personalization.gif) ### Personalizace e-mailu pomocí podrobností objednávky Následující proměnné lze vložit přímo do obsahu šablony Brevo: | Data objednávky | Data doručovací adresy | Data fakturační adresy | | ------------- | ------------- | ------------- | | {{ params.url }} | {{ params.shipping_address.firstname }} | {{ params.billing_address.firstname }} | | {{ params.currency }} | {{ params.shipping_address.lastname }} | {{ params.billing_address.lastname }} | | {{ params.date }} | {{ params.shipping_address.company }} | {{ params.billing_address.company }} | | {{ params.discount }} | {{ params.shipping_address.phone }} | {{ params.billing_address.phone }} | | {{ params.id }} | {{ params.shipping_address.address1 }} | {{ params.billing_address.address1 }} | | {{ params.revenue }} | {{ params.shipping_address.address2 }} | {{ params.billing_address.address2 }} | | {{ params.shipping }} | {{ params.shipping_address.city }} | {{ params.billing_address.city }} | | {{ params.subtotal }} | {{ params.shipping_address.country }} | {{ params.billing_address.country }} | | {{ params.tax }} | {{ params.shipping_address.state }} | {{ params.billing_address.state }} | | {{ params.total_before_tax }} | {{ params.shipping_address.zipcode }} | {{ params.billing_address.zipcode }} | V editoru *Drag & Drop Editor* vyberte požadovaný blok, ve kterém se budou zobrazovat informace o objednávce, a poté přidejte své proměnné. Doporučujeme formátovat čísla pomocí [floatformat](https://get.brevo.com/ogcn5b). V níže uvedeném příkladu jsme přidali: * `{{ params.currency | floatformat: 2 }}` – měna objednávky * `{{ params.subtotal | floatformat: 2 }}` – mezisoučet objednávky * `{{ params.discount | floatformat: 2 }}` – sleva objednávky * `{{ params.total | floatformat: 2 }}` – celková částka objednávky ![Souhrn objednávky](_static/send-an-order-confirmation-email/order.jpg) Nyní šablonu e-mailu personalizujeme pomocí objednaných položek. K tomu použijeme *New Template Language* pro vložení dynamického seznamu. ### Personalizace e-mailu pomocí podrobností objednaných položek Následující proměnné lze vložit přímo z dynamického seznamu do obsahu šablony Brevo: | Data položek | Vložte do šablony tento zástupný symbol | | ------------- | ------------- | | Název | {{ item.name }} | | SKU | {{ item.sku }} | | Kategorie | {{ item.category }} | | ID | {{ item.id }} | | ID varianty položky | {{ item.variant_id }} | | Název varianty položky | {{ item.variant_name }} | | Cena | {{ item.price }} | | Množství | {{ item.quantity }} | | Odkaz na zakoupenou položku ve výloze obchodu | {{ item.url }} | | Obrázek | {{ item.image }} | V editoru *Drag & Drop Editor* vyberte požadovaný blok, ve kterém se budou zobrazovat objednané položky. 1. Kliknutím na **ikonu tužky** upravte nastavení designového bloku. 1. Povolte možnost **dynamic list** (dynamický seznam). 1. Do pole **parameter** zadejte `items`. 1. Do pole **variable** zadejte `item`. 1. Nastavte limit počtu položek, které se zobrazí. Pokud je například položek 5 a nastavíte limit 3, zobrazí se v e-mailu pouze 3 položky. ![Položky](_static/send-an-order-confirmation-email/items.jpg) Nyní přidejte proměnné do šablony e-mailu. Ve výše uvedeném příkladu jsme přidali: * `{{ item.name }}` – název položky * `{{ item.quantity }}` – množství položky * `{{ item.price | floatformat: 2 }}` – cena položky Chcete-li přidat odkaz na položku, vyberte tlačítko **Call-To-Action (CTA)**. Na pravém bočním panelu v části *Link* zadejte `{{ item.url }}`. ![Položka](_static/send-an-order-confirmation-email/item.jpg) Chcete-li přidat obrázek položky, vyberte obrázek. Na pravém bočním panelu v části *Image source* zvolte *From URL* a poté zadejte `{{ item.image }}`. ![Obrázek](_static/send-an-order-confirmation-email/image.jpg) Po dokončení návrhu klikněte na zelené tlačítko **Save & Quit**. Poté klikněte na tlačítko **Save & Activate**. ## Vytvoření workflow pro potvrzení objednávky > [!NOTE] > > Aby se workflow spustilo, musí být zákazník identifikován svou e-mailovou adresou, to znamená, že zákazník musí být přihlášen ke svému účtu ve vašem obchodě nopCommerce nebo musí zadat svou e-mailovou adresu během pokladny. Přejděte na kartu [Automation](https://get.brevo.com/tvl7ng) ve svém účtu Brevo. Klikněte na **+ CREATE A NEW WORKFLOW**, poté vyberte **Product Purchase** a postupujte podle kroků. 1. **Krok 1/3** – Nastane událost * Vyberte *Custom Event (Track Event)*. * Zadejte `order_completed`. * Klikněte na **NEXT**. 1. **Krok 2/3** – Přidání zpoždění * Zvolte zpoždění. Například 5 sekund. * Klikněte na **NEXT**. 1. **Krok 3/3** – Odeslání e-mailu * Z rozbalovacího seznamu vyberte šablonu e-mailu, kterou jste právě vytvořili a aktivovali. * Vyberte **Use my event data to customize the email**. * Vyberte **The event data which triggered the workflow**. * Klikněte na **FINISH**. ![Vytvoření workflow](_static/send-an-order-confirmation-email/create-workflow.gif) Po dokončení workflow klikněte na **DONE**, čímž jej uložíte a aktivujete. ## Příklad Řekněme, že zákazník Jean Blue zakoupil ve vašem obchodě následující 3 položky. ![Položky objednávky](_static/send-an-order-confirmation-email/order-items.jpg) Vaše šablona bude vypadat takto: ![Šablona](_static/send-an-order-confirmation-email/template.jpg) E-mail, který Jean Blue obdrží na adrese , bude vypadat takto: ![E-mail](_static/send-an-order-confirmation-email/email.jpg) ## Další informace * [Obnovení opuštěných košíků](xref:cs/running-your-store/promotional-tools/brevo-integration/recover-abandoned-carts) --- # Plugin Facebook Pixel Tato část popisuje, jak integrovat Facebook pixel do vašeho obchodu. ## Co je Facebook pixel Facebook pixel umožňuje získávat informace o akcích provedených ve vašem obchodě, díky čemuž budou vaše reklamy na Facebooku pro vaše publikum relevantnější. Facebook pixel vám může pomoci pochopit chování návštěvníků vašeho obchodu a zjistit, která reklamní strategie nejlépe funguje pro dosažení vašich obchodních cílů. Sledované konverze se zobrazují v nástroji [Facebook Ads Manager](https://www.facebook.com/adsmanager) a na nástěnce [Facebook Analytics](https://business.facebook.com/analytics), kde je lze použít k měření účinnosti reklam, definování vlastních publik pro cílení reklam nebo kampaně dynamických reklam a k analýze účinnosti konverzních trychtýřů vašeho webu. ## Co plugin Facebook Pixel dělá Plugin Facebook Pixel pro nopCommerce vkládá úryvek kódu JavaScript, který umožňuje sledovat aktivitu návštěvníků na vašem webu. Funguje tak, že načte malou knihovnu funkcí, které se použijí pokaždé, když zákazník provede nějakou akci. ## Instalace a povolení pluginu Plugin Facebook Pixel je standardní součástí nopCommerce. Najdete jej zde: **Konfigurace → Místní pluginy** (Configuration → Local plugins). Chcete-li plugin najít rychleji, použijte pole **Skupina** (Group) na panelu vyhledávání a vyfiltrujte pluginy typu *Widgety*: ![Vyhledání pluginu](_static/facebook-pixel/plugin-list.jpg) Pokud plugin není nainstalován, nainstalujte jej pomocí tlačítka **Instalovat** (Install). Poté jej povolte kliknutím na tlačítko **Upravit** (Edit). V takovém případě se zobrazí okno *Upravit podrobnosti pluginu*. Označte plugin jako povolený pomocí zaškrtávacího políčka **Je povoleno** (Is enabled) a klikněte na tlačítko **Uložit** (Save). ## Jak plugin nakonfigurovat 1. Klikněte na tlačítko **Konfigurovat** (Configure). Zobrazí se okno stránky *Konfigurace - Facebook Pixel*: ![Konfigurace - Facebook Pixel](_static/facebook-pixel/configure-window.jpg) 1. Klikněte na tlačítko **Přidat novou konfiguraci** (Add new configuration). 1. Vyplňte následující formulář pro nastavení pluginu: ![Formulář](_static/facebook-pixel/form.jpg) * Zaškrtněte políčko **Povoleno** (Enabled), chcete-li tuto konfiguraci Facebook pixelu povolit. * Zadejte své **Pixel ID**, které najdete v [Ads Manager → Events Manager](https://business.facebook.com/events_manager). Pokud jste pixel ještě nevytvořili, [postupujte podle těchto pokynů](https://www.facebook.com/business/help/952192354843755) — potřebujete pouze ID pixelu. * **Rozšířené párování** (Advanced Matching): pokud je zaškrtnuto, Facebook pixel bude shromažďovat některá data návštěvníků (v hashované podobě). Pokud rozšířené párování implementujete automaticky pomocí nástroje Events Manager, toto nastavení zrušte. * **Zahrnout vlastnosti uživatele** (Include User properties): zaškrtněte, chcete-li do pixelu zahrnout *Vlastnosti uživatele*, tedy data o uživateli. Vlastnosti uživatele si pak můžete prohlédnout na nástěnce Facebook Analytics v části People → User Properties. Dále se zobrazí seznam událostí. Standardní události jsou předdefinované akce návštěvníků, které odpovídají běžným aktivitám souvisejícím s konverzí, jako je vyhledání produktu, zobrazení produktu nebo nákup produktu. * **Sledovat událost „PageView“** (Track "PageView" event): zaškrtněte, chcete-li povolit sledování standardní události, když osoba přejde na stránky webu. * **Sledovat událost „AddToCart“** (Track "AddToCart" event): zaškrtněte, chcete-li povolit sledování standardní události, když je produkt přidán do nákupního košíku. * **Sledovat událost „Purchase“** (Track "Purchase" event): zaškrtněte, chcete-li povolit sledování standardní události, když je vytvořena objednávka. * **Sledovat událost „ViewContent“** (Track "ViewContent" event): zaškrtněte, chcete-li povolit sledování standardní události, když osoba přejde na stránku podrobností produktu. * **Sledovat událost „AddToWishlist“** (Track "AddToWishlist" event): zaškrtněte, chcete-li povolit sledování standardní události, když je produkt přidán do seznamu přání. * **Sledovat událost „InitiateCheckout“** (Track "InitiateCheckout" event): zaškrtněte, chcete-li povolit sledování standardní události, když osoba vstoupí do procesu pokladny před jeho dokončením. * **Sledovat událost „Search“** (Track "Search" event): zaškrtněte, chcete-li povolit sledování standardní události, když je provedeno vyhledávání. * **Sledovat událost „Contact“** (Track "Contact" event): zaškrtněte, chcete-li povolit sledování standardní události, když osoba odešle dotaz prostřednictvím kontaktního formuláře. * **Sledovat událost „CompleteRegistration“** (Track "CompleteRegistration" event): zaškrtněte, chcete-li povolit sledování standardní události, když je vyplněn registrační formulář. > [!NOTE] > > Jako dodatečný parametr obsahují některé události SKU produktu nebo SKU kombinace produktu; ujistěte se, že jsou ve vašem katalogu vyplněny správně. * **Zakázat pro uživatele, kteří nepřijali souhlas s cookies** (Disable for users not accepting Cookie Consent): zaškrtněte, chcete-li Facebook pixel zakázat pro uživatele, kteří nepřijali souhlas s cookies. To se může hodit, pokud podnikáte v zemích, na které se vztahuje obecné nařízení o ochraně osobních údajů (GDPR). Abyste uživatelům zobrazili souhlas s cookies, musíte také aktivovat nastavení **DisplayEuCookieLawWarning** na stránce **Konfigurace → Nastavení → Obecná nastavení** (Configuration → Settings → General settings). > [!NOTE] > > Obecné nařízení o ochraně osobních údajů (GDPR) vstoupilo v platnost 25. května 2018 a zavádí jednotná pravidla ochrany údajů v celé Evropě. Firmy, které inzerují u společností Facebook, mohou nadále používat platformy a řešení Facebooku stejným způsobem jako dosud. ## Konfigurace vlastních událostí > [!NOTE] > > Tento panel uvidíte až poté, co aktuální konfiguraci vytvoříte a uložíte! Pokud předdefinované standardní události nevyhovují vašim potřebám, můžete sledovat vlastní události, které lze rovněž použít k definování vlastních publik pro optimalizaci reklam. Můžete je nakonfigurovat níže. Zadejte název a zvolte zóny widgetů, ve kterých bude vlastní událost sledována. Pokud nevíte, kterou zónu pro svou vlastní událost použít, můžete se zeptat na našich [fórech](https://www.nopcommerce.com/boards). ![Konfigurace vlastních událostí](_static/facebook-pixel/custom-events.jpg) ## Viz také [Jaká data Facebook Pixel shromažďuje?](https://developers.facebook.com/docs/facebook-pixel/support#pixelcollect) --- # Integrace Omnisend Tato sekce popisuje, jak do vašeho obchodu integrovat plugin Omnisend. Plugin podporuje všechny verze nopCommerce včetně dílčích verzí od 4.30 do 4.70. ## Co je Omnisend Omnisend je platforma pro automatizaci e-mailového a SMS marketingu, která pomáhá e-commerce obchodům navazovat a udržovat kontakt se zákazníky. Můžete vytvářet vyskakovací okna a registrační formuláře pro získávání nových odběratelů. Komunikujte s nimi prostřednictvím kanálů, jako jsou e-mail a SMS. Využijte data svého obchodu k segmentaci zákazníků a zvyšujte prodeje pomocí personalizované automatizace. ## Co dělá plugin Omnisend Plugin Omnisend pro nopCommerce umožňuje majiteli obchodu: * Synchronizovat kontakty – provádí synchronizaci zákazníků přihlášených k odběru newsletteru. * Synchronizovat produkty – synchronizuje kategorie a produkty. ## Instalace a povolení pluginu Plugin Omnisend je standardní součástí nopCommerce. Najdete jej zde: **Konfigurace → Místní pluginy** (Configuration → Local plugins). Abyste plugin našli rychleji, použijte pole **Skupina** (Group) na panelu hledání a vyfiltrujte pluginy typu *Misc*: ![Vyhledání pluginu](_static/omnisend/plugin-list.jpg) Pokud plugin není nainstalován, nainstalujte jej pomocí tlačítka **Instalovat** (Install). Poté jej povolte kliknutím na tlačítko **Upravit** (Edit). V takovém případě se zobrazí okno *Upravit podrobnosti pluginu* (Edit plugin details). Označte plugin jako povolený pomocí zaškrtávacího políčka **Je povolen** (Is enabled) a klikněte na tlačítko **Uložit** (Save). ## Jak plugin nakonfigurovat 1. Klikněte na tlačítko **Konfigurovat** (Configure). Zobrazí se okno *Konfigurace – Omnisend*: ![Konfigurace – Omnisend](_static/omnisend/configure-window.jpg) Abyste mohli Omnisend používat s nopCommerce, budete si muset v Omnisendu [vytvořit účet](https://your.omnisend.com/g1K9y2). Můžete začít s bezplatným tarifem a vyzkoušet funkce platformy – platební karta není potřeba. > [!NOTE] > > Pokud jste již Omnisend používali a máte účet připojený k jinému obchodu, nejprve [vytvořte nový prázdný obchod](https://support.omnisend.com/en/articles/3022953-managing-multiple-stores?irclickid=VWt1B4VIXxyPTkbVXw2OtWsaUkHVGdTU12dV0g0&irpartnerid=5274744&irprogramid=21260&irgwc=1#register-a-new-store-under-the-owners-account). 1. Připojení Omnisendu k vašemu obchodu: [Přihlaste se](https://app.omnisend.com/login?irclickid=VWt1B4VIXxyPTkbVXw2OtWsaUkHVGf2o12dV0g0&irpartnerid=5274744&irprogramid=21260&irgwc=1) ke svému účtu Omnisend. 1. Klikněte na *Connect store* (Připojit obchod) na nástěnce nebo v navigační nabídce účtu ![Připojení obchodu – Omnisend](_static/omnisend/connect-store.jpg) 1. Vygenerujte klíč API a vložte jej do příslušného pole na konfigurační stránce pluginu. ![Klíč API – Omnisend](_static/omnisend/store-api-key.jpg) 1. Klikněte na tlačítko **Uložit** (Save). 1. Přejděte na panel **Synchronizace** (Synchronization) a synchronizujte zákazníky a produkty z nopCommerce se svým účtem Omnisend. ![Synchronizace](_static/omnisend/sync.jpg) ### Jaké funkce jsou podporovány? * [E-mailové](https://support.omnisend.com/en/articles/6070131-building-an-email-campaign?irclickid=VWt1B4VIXxyPTkbVXw2OtWsaUkHVGqRM12dV0g0&irpartnerid=5274744&irprogramid=21260&irgwc=1) a [SMS kampaně](https://support.omnisend.com/en/articles/1918472-sms-in-campaigns?irclickid=VWt1B4VIXxyPTkbVXw2OtWsaUkHVGqQs12dV0g0&irpartnerid=5274744&irprogramid=21260&irgwc=1). * [Registrační formuláře Omnisend](https://support.omnisend.com/en/articles/1061792-types-of-signup-forms?irclickid=VWt1B4VIXxyPTkbVXw2OtWsaUkHVJfyY12dV0g0&irpartnerid=5274744&irprogramid=21260&irgwc=1). * [Další integrace třetích stran](https://support.omnisend.com/en/collections/35918-integrations-with-3rd-party-apps?irclickid=VWt1B4VIXxyPTkbVXw2OtWsaUkHVGM2w12dV0g0&irpartnerid=5274744&irprogramid=21260&irgwc=1). * Tyto automatizační workflow: * [Potvrzení objednávky](https://support.omnisend.com/en/articles/1421803-order-confirmation-automation?irclickid=VWt1B4VIXxyPTkbVXw2OtWsaUkHVGMw012dV0g0&irpartnerid=5274744&irprogramid=21260&irgwc=1) (události Paid for Order a Placed order), * [Potvrzení zrušení](https://support.omnisend.com/en/articles/1649441-cancellation-confirmation-automation?irclickid=VWt1B4VIXxyPTkbVXw2OtWsaUkHVGMyw12dV0g0&irpartnerid=5274744&irprogramid=21260&irgwc=1) (událost Order Cancelled), * [Narozeniny](https://support.omnisend.com/en/articles/1061790-birthday-email-automation?irclickid=VWt1B4VIXxyPTkbVXw2OtWsaUkHVGMRM12dV0g0&irpartnerid=5274744&irprogramid=21260&irgwc=1), * [Uvítací e-mail](https://support.omnisend.com/en/articles/1061818-welcome-email-automation?irclickid=VWt1B4VIXxyPTkbVXw2OtWsaUkHVGMTk12dV0g0&irpartnerid=5274744&irprogramid=21260&irgwc=1), * [Kontakt vstoupí do segmentu / opustí segment](https://support.omnisend.com/en/articles/2398171-contact-enters-exits-a-segment-automation?irclickid=VWt1B4VIXxyPTkbVXw2OtWsaUkHVGMQI12dV0g0&irpartnerid=5274744&irprogramid=21260&irgwc=1), * [Opuštěné prohlížení](https://support.omnisend.com/en/articles/1692754-browse-abandonment?irclickid=VWt1B4VIXxyPTkbVXw2OtWsaUkHVGMXU12dV0g0&irpartnerid=5274744&irprogramid=21260&irgwc=1), * [Opuštěný produkt](https://support.omnisend.com/en/articles/1690227-product-abandonment?irclickid=VWt1B4VIXxyPTkbVXw2OtWsaUkHVGMSM12dV0g0&irpartnerid=5274744&irprogramid=21260&irgwc=1), * [Opuštěná pokladna a opuštěný košík](https://support.omnisend.com/en/articles/6659889-abandoned-cart-and-abandoned-checkout?irclickid=VWt1B4VIXxyPTkbVXw2OtWsaUkHVGJx812dV0g0&irpartnerid=5274744&irprogramid=21260&irgwc=1). * [Segmentace](https://support.omnisend.com/en/articles/5945163-using-omnisend-segmentation?irclickid=VWt1B4VIXxyPTkbVXw2OtWsaUkHVGJzE12dV0g0&irpartnerid=5274744&irprogramid=21260&irgwc=1). K dispozici je většina filtrů segmentace kromě událostí stavů objednávky: Paid for order, Cancelled order, Had order shipped, Had partially shipped order, Refunded order, Had partially refunded order. Stále však můžete využít filtr „Placed order“. * [Živá aktivita](https://support.omnisend.com/en/articles/1689912-live-view-tracking-store-activity?irclickid=VWt1B4VIXxyPTkbVXw2OtWsaUkHVGJwY12dV0g0&irpartnerid=5274744&irprogramid=21260&irgwc=1). * Přidání vašich [prvků značky (Brand Assets)](https://support.omnisend.com/en/articles/6099524-brand-assets-management?irclickid=VWt1B4VIXxyPTkbVXw2OtWsaUkHVGJ3w12dV0g0&irpartnerid=5274744&irprogramid=21260&irgwc=1). ### Jaká data se synchronizují? Do Omnisendu se nyní budou synchronizovat následující data obchodu: * Údaje o zákaznících * Produkty a zobrazené kategorie * Události související s objednávkami * Události související s opuštěným košíkem > [!NOTE] > > Ruční synchronizaci je třeba provést pouze jednou; při opakované synchronizaci bude hromadné vkládání hlásit chyby vkládání dat. Další synchronizace bude probíhat automaticky a nebude vyžadovat zásah administrátora. ## Synchronizace kontaktů V pluginu jsou implementovány dva typy synchronizace kontaktů: * Počáteční import všech existujících kontaktů. Provádí se, když uživatel právě nainstaloval plugin a chce importovat všechny existující kontakty obchodu do účtu Omnisend. * Synchronizace kontaktů při přihlášení/odhlášení odběru. ## Události sledování zákazníků (JS snippet) Ke sledování akcí uživatelů v obchodě je na všech stránkách webu nainstalován skript JS. Ve výchozím nastavení skript sleduje návštěvy všech stránek včetně návštěv stránky produktu. K oznamování identifikace uživatele se používá také další skript. ## Události košíku, události objednávek Plugin sleduje řadu událostí, o kterých informuje službu Omnisend: * Přidání produktu do košíku. * Zadání objednávky. * Zaplacení objednávky. * Vrácení peněz za objednávku. * Zrušení objednávky. * Dokončení zpracování objednávky. * Zahájení procesu pokladny. * Změna produktu v košíku (zvýšení množství, slevy atd.). * Odstranění posledního produktu z košíku. * Změna stavu objednávky. * Obnovení košíku. Uživatel má možnost přejít do obchodu přes odkaz v e-mailu od Omnisendu (připomínka opuštěného košíku). ## Synchronizace produktů Plugin implementuje import kategorií a produktů. Po kliknutí na tlačítko **Synchronizovat produkty** (Sync products) proběhne proces synchronizace. > [!NOTE] > > Pokud existuje mnoho kategorií (>300), zobrazí se uživateli upozornění, že import může trvat dlouho. Kromě počátečního importu je implementována i synchronizace produktů v reálném čase, sledují se však pouze změny parametru `StockQuantity`, aby byl stav produktu (*inStock*, *outOfStock*, *notAvailable*) aktuální. --- # Připomínky Funkce **Připomínky** (Reminders) umožňuje zasílat uživatelům e-mailová upozornění na jejich opuštěné košíky, nedokončené registrace a nedokončené objednávky. Tato funkce pomáhá zvýšit zapojení uživatelů a konverze tím, že jim připomíná, aby své akce dokončili. ## Dostupné připomínky Uživatelům lze zasílat tři typy připomínek: 1. **Opuštěný košík** (Abandoned Cart) - Pro opuštěný košík lze odeslat až **3 připomínky**. - Připomínky se odesílají postupně na základě času poslední interakce uživatele s košíkem. - Připomínka se odešle pouze tehdy, pokud od poslední interakce uplynula prodleva nastavená pro danou připomínku. 1. **Opuštěná objednávka** (Abandoned Order) - Odesílají se až **2 připomínky**, ale pouze pro **nejstarší nedokončenou objednávku**. - Pokud byla pro objednávku odeslána připomínka, připomínky pro další objednávky se neodesílají, dokud nebude aktuální objednávka dokončena. 1. **Nedokončená registrace** (Incomplete Registration) - Odesílá se pouze **jedna připomínka**. - Tato připomínka se spouští pouze pro uživatele, jejichž **Způsob registrace** (Registration Method) je nastaven na *„Po registraci je vyžadováno ověření e-mailu“* (Email validation is required after registration). > [!Note] > Všechny připomínky počínaje druhou se odesílají pouze tehdy, pokud již byla odeslána předchozí připomínka. ## Administrace Administrátoři mohou připomínky spravovat na stránce **Připomínky** (Reminders) v sekci **Propagace** (Promotions): ![Připomínky](_static/reminders/reminders-config.png) - Připomínky lze povolit nebo zakázat pro celou skupinu nebo jednotlivě. - Každá připomínka má nastavitelnou **prodlevu** (delay), která určuje, kdy bude připomínka odeslána. - Každá připomínka je přiřazena k **šabloně zprávy** (Message Template). ![Připomínky](_static/reminders/reminders-message-templates.png) - Prodleva přímo ovlivňuje nastavení **Odložené odeslání** (Delay Send) v šabloně. ![Připomínky](_static/reminders/reminders-message-template-1.png) ## Tokeny pro připomínky košíku Pro připomínky košíku jsou k dispozici dva tokeny: - `%Customer.Cart%` – vloží tabulku produktů z košíku uživatele. - `%Customer.ShoppingCartUrl%` – URL odkazující přímo na košík uživatele (včetně přihlášení, je-li vyžadováno). ## Naplánované úlohy Každý typ připomínky zpracovává naplánovaná úloha: - **Zpracovat nedokončené registrace** (Process incomplete registrations) – spouští se **každou hodinu**. - **Zpracovat nedokončené objednávky** (Process incomplete orders) – spouští se **každou hodinu**. - **Zpracovat opuštěné košíky** (Process abandoned carts) – spouští se **každých 20 minut**. Tyto úlohy zajišťují včasné zpracování a odeslání připomínek podle nastavených prodlev. ![Připomínky](_static/reminders/reminders-tasks.png) --- # Správa obsahu Správa obsahu je soubor procesů a technologií, které podporují shromažďování, správu a publikování informací na vašem webu. nopCommerce vám umožňuje využívat všechny nástroje potřebné k tomu, aby byl váš internetový obchod informativnější a vaše komunikace se zákazníky lepší. ## Další informace - [Blog](xref:cs/running-your-store/content-management/blog) - [Novinky](xref:cs/running-your-store/content-management/news) - [Fóra](xref:cs/running-your-store/content-management/forums) - [Ankety](xref:cs/running-your-store/content-management/polls) - [Stránky (topics)](xref:cs/running-your-store/content-management/topics-pages) - [Menu](xref:cs/running-your-store/content-management/menu) - [Šablony zpráv](xref:cs/running-your-store/content-management/message-templates) - [SEO](xref:cs/running-your-store/search-engine-optimization) - [E-mailové kampaně](xref:cs/running-your-store/promotional-tools/email-campaigns) --- # Blog Blog je skvělý způsob, jak udržovat kontakt se stávajícími zákazníky, informovat je o nejnovější nabídce produktů nebo je vzdělávat, a také jak získat nové zákazníky. Příspěvky blogu spravujete v **Správa obsahu → Příspěvky blogu** (Content management → Blog posts). ![Příspěvky blogu](_static/blog/blog1.jpg) ## Přidání nového příspěvku blogu Klikněte na **Přidat nový** (Add new) a vyplňte informace o novém příspěvku blogu. ![Přidat nový příspěvek blogu](_static/blog/add-new.jpg) ### Informace Na panelu *Informace* (Info) definujte následující podrobnosti příspěvku blogu: * Pokud je povoleno více jazyků, vyberte z rozbalovacího seznamu **Jazyk** (Language) jazyk tohoto příspěvku. Zákazníci uvidí pouze příspěvky blogu ve svém zvoleném jazyce. * Zadejte **Název** (Title) tohoto příspěvku blogu. * Zadejte **Text** (Body) tohoto příspěvku blogu. * Můžete zadat **Přehled textu** (Body overview), pokud chcete, aby na hlavní stránce blogu, kde jsou uvedeny všechny příspěvky, byla viditelná pouze část textu. * Zadejte **Štítky** (Tags), které se zobrazí na stránce blogu ve veřejné části obchodu. Štítky jsou klíčová slova, podle kterých lze tento příspěvek také identifikovat. Zadejte čárkami oddělený seznam štítků spojených s tímto příspěvkem. Čím více příspěvků blogu je spojeno s určitým štítkem, tím větší velikost má v oblasti „Oblíbené štítky“ zobrazené na bočním panelu stránky blogu. ![p3](_static/blog/Blog3.png) * Zaškrtnutím políčka **Povolit komentáře** (Allow comments) umožníte zákazníkům přidávat k tomuto příspěvku komentáře. * Zaškrtnutím políčka **Zahrnout do mapy webu** (Include in sitemap) zahrnete příspěvek blogu do mapy webu. * Zadejte **Datum začátku** (Start date) a **Datum konce** (End date) zobrazování tohoto příspěvku v koordinovaném světovém čase (UTC). > [!NOTE] > > Pokud nechcete definovat datum začátku a konce příspěvku blogu, můžete tato pole ponechat prázdná. * Chcete-li tento příspěvek blogu povolit pouze pro určité obchody, vyberte je v poli **Omezeno na obchody** (Limited to stores). Pokud tuto funkci nepotřebujete, ponechte pole prázdné. > [!NOTE] > > Abyste mohli tuto funkci používat, musíte vypnout následující nastavení: **Nastavení katalogu → Ignorovat pravidla „omezení na obchod“ (v celém webu)** (Catalog settings → Ignore "limit per store" rules (sitewide)). Více o [funkci více obchodů](xref:cs/getting-started/advanced-configuration/multi-store). Při úpravě existujícího příspěvku blogu nebo po kliknutí na tlačítko **Uložit a pokračovat v úpravách** (Save and continue edit) u nového příspěvku můžete kliknout na tlačítko **Náhled** (Preview) vpravo nahoře a zobrazit, jak bude příspěvek na webu vypadat. ### SEO Na panelu *SEO* definujte následující podrobnosti příspěvku blogu: ![SEO pro příspěvky blogu](_static/blog/blog4.jpg) * Definujte **Název stránky přátelský k vyhledávačům** (Search engine friendly page name). Zadejte například „the-best-news“, aby vaše URL byla `http://yourStore.com/the-best-news`. Pokud pole ponecháte prázdné, vygeneruje se automaticky z názvu příspěvku blogu. * V poli **Meta titulek** (Meta title) přepište titulek stránky (výchozím titulkem je název příspěvku blogu). * Zadejte **Meta klíčová slova** (Meta keywords), která se přidají do hlavičky příspěvku blogu. Představují stručný a výstižný seznam nejdůležitějších témat stránky. * Zadejte **Meta popis** (Meta description), který se přidá do hlavičky příspěvku blogu. Značka meta description je stručné a výstižné shrnutí obsahu stránky. ## Správa komentářů blogu Komentáře blogu spravujete v **Správa obsahu → Komentáře blogu** (Content management → Blog comments). ![Komentáře blogu](_static/blog/blog5.jpg) Tlačítkem **Schválit vybrané** (Approve selected) schválíte vybrané komentáře a tlačítkem **Zamítnout vybrané** (Disapprove selected) je zamítnete. Komentář blogu můžete také upravit nebo smazat. Smazaný komentář bude ze systému odstraněn. ## Nastavení blogu Nastavení blogu spravujete v **Konfigurace → Nastavení → Nastavení blogu** (Configuration → Settings → Blog settings). Tato stránka je k dispozici ve 2 režimech: *rozšířeném* a *základním*. Tato stránka umožňuje konfiguraci pro více obchodů; to znamená, že stejná nastavení lze definovat pro všechny obchody, nebo se mohou mezi obchody lišit. Pokud chcete spravovat nastavení pro určitý obchod, vyberte jeho název z rozbalovacího seznamu konfigurace pro více obchodů a zaškrtněte vlevo všechna potřebná políčka, abyste pro ně nastavili vlastní hodnoty. Další podrobnosti naleznete v článku [Více obchodů](xref:cs/getting-started/advanced-configuration/multi-store). ![Nastavení blogu](_static/blog/Blog-Setting.png) ### Obecné Definujte následující *Obecná* (Common) nastavení: * Zaškrtnutím políčka **Blog povolen** (Blog enabled) povolíte ve svém obchodě funkci blogu. * V poli **Počet příspěvků na stránku** (Posts page size) nastavte počet příspěvků na stránku. * Do pole **Počet štítků (cloud)** (Number of tags (cloud)) zadejte počet štítků, které se zobrazí v cloudu štítků. * Zaškrtnutím políčka **Zobrazit odkaz na RSS kanál blogu v adresním řádku prohlížeče** (Display blog RSS feed link in the browser address bar) se odkaz na RSS kanál blogu zobrazí v adresním řádku prohlížeče. ### Komentáře blogu Definujte následující nastavení *Komentářů blogu* (Blog comments): * Zaškrtnutím políčka **Povolit hostům zanechávat komentáře** (Allow guests to leave comments) umožníte neregistrovaným uživatelům přidávat do blogu komentáře. * Zaškrtněte políčko **Komentáře blogu musí být schváleny** (Blog comments must be approved), pokud musí komentáře blogu schvalovat administrátor. * Zaškrtnutím políčka **Upozorňovat na nové komentáře blogu** (Notify about new blog comments) bude majitel obchodu upozorňován na nové komentáře blogu. * Zaškrtnutím políčka **Komentáře blogu podle obchodu** (Blog comments per store) se budou zobrazovat pouze komentáře blogu napsané v aktuálním obchodě. Klikněte na **Uložit** (Save). > [!NOTE] > > Z bezpečnostních důvodů můžete pro komentáře blogu povolit CAPTCHA. Další informace najdete v části [CAPTCHA](xref:cs/getting-started/advanced-configuration/security-settings#captcha). --- # Novinky nopCommerce vám umožňuje publikovat ve vašem obchodě novinky. Může jít o jakékoli důležité zprávy, například informace o nejnovějším vydání nopCommerce, aktuality o vaší společnosti a další. V nopCommerce je tato funkce implementována jako plugin *News* (systémový název *Misc.News*), dostupný od nopCommerce 5.00. Plugin patří do skupiny *Misc*. ## Jak to funguje Novinky se ve vašem obchodě zobrazují na úvodní stránce nebo v menu zápatí webu. ![p1](_static/news/news_1.png) Novinky spravujete v **Správa obsahu → Novinky** (Content management → News items). Zobrazí se seznam všech novinek: ![Novinky](_static/news/list.png) ## Přidání novinek Chcete-li přidat novou novinku, klikněte na tlačítko **Upravit** (Edit) a vyplňte informace o novince. ![Přidání novinek](_static/news/add-new.png) ### Informace Na panelu *Informace* (Info) zadejte následující údaje o novince: - Pokud je povoleno více jazyků, vyberte z rozbalovacího seznamu **Jazyk** (Language) jazyk této novinky. Zákazníci uvidí pouze novinky ve zvoleném jazyce. - Zadejte **Nadpis** (Title) této novinky. Například: „Spuštění našeho nového obchodu na nopCommerce.“ - Do pole **Krátký popis** (Short description) zadejte souhrn této novinky. Tento text uvidí návštěvníci v seznamu novinek ve veřejné části obchodu. - Do pole **Úplný popis** (Full description) zadejte text této novinky. - Zaškrtněte políčko **Povolit komentáře** (Allow comments), aby zákazníci mohli k novince přidávat komentáře. - Zadejte **Datum zahájení** (Start date) a **Datum ukončení** (End date) zobrazování této novinky v koordinovaném světovém čase (UTC). > [!NOTE] > > Pokud nechcete definovat datum zahájení a ukončení novinky, můžete tato pole ponechat prázdná. - V poli **Omezeno na obchody** (Limited to stores) vyberte obchody, chcete-li tuto novinku povolit pouze pro konkrétní obchody. Pokud tuto funkci nepotřebujete, ponechte pole prázdné. > [!NOTE] > > Abyste mohli tuto funkci používat, musíte zakázat následující nastavení: **Nastavení katalogu → Ignorovat pravidla „omezení na obchod“ (pro celý web)** (Catalog settings → Ignore "limit per store" rules (sitewide)). Přečtěte si více o [funkci více obchodů](xref:cs/getting-started/advanced-configuration/multi-store). - Zaškrtněte políčko **Publikováno** (Published), chcete-li tuto novinku ve svém obchodě zveřejnit. Při úpravě existující novinky nebo po kliknutí na tlačítko **Uložit a pokračovat v úpravách** (Save and continue edit) u nové novinky můžete kliknout na tlačítko **Náhled** (Preview) vpravo nahoře a zobrazit, jak bude novinka na webu vypadat. ### SEO Na panelu *SEO* zadejte následující údaje o novince: ![SEO pro novinku](_static/news/seo.png) - Definujte **Název stránky vhodný pro vyhledávače** (Search engine friendly page name). Například zadáním „the-best-news“ získáte URL `http://yourStore.com/the-best-news`. Pokud pole ponecháte prázdné, vygeneruje se automaticky podle nadpisu novinky. - V poli **Meta titulek** (Meta title) můžete přepsat titulek stránky (výchozím titulkem je nadpis novinky). - Zadejte **Meta klíčová slova** (Meta keywords), která se přidají do hlavičky novinky. Představují stručný a výstižný seznam nejdůležitějších témat stránky. - Zadejte **Meta popis** (Meta description), který se přidá do hlavičky novinky. Značka meta description je stručné a výstižné shrnutí obsahu stránky. ## Správa komentářů k novinkám Komentáře k novinkám spravujete v **Správa obsahu → Komentáře k novinkám** (Content management → News comments). ![Komentáře k novinkám](_static/news/news-comments.png) Tlačítkem **Schválit vybrané** (Approve selected) vybrané komentáře schválíte a tlačítkem **Zamítnout vybrané** (Disapprove selected) je zamítnete. Komentář můžete také upravit nebo smazat. Smazaný komentář bude ze systému odstraněn. ## Nastavení novinek Chcete-li plugin nakonfigurovat, přejděte do **Konfigurace → Lokální pluginy** (Configuration → Local plugins) a klikněte na **Konfigurovat** (Configure) vedle položky *News*. Tato stránka je dostupná ve 2 režimech: *rozšířeném* a *základním*. Tato stránka umožňuje konfiguraci pro více obchodů; to znamená, že stejná nastavení lze definovat pro všechny obchody, nebo se mohou mezi obchody lišit. Pokud chcete spravovat nastavení pro konkrétní obchod, vyberte jeho název z rozbalovacího seznamu konfigurace pro více obchodů a zaškrtněte vlevo všechna potřebná zaškrtávací políčka, abyste pro ně mohli nastavit vlastní hodnoty. Další podrobnosti najdete v části [Více obchodů](xref:cs/getting-started/advanced-configuration/multi-store). ![Nastavení novinek](_static/news/news-settings.png) ### Obecné Definujte následující *Obecná* (Common) nastavení: - Zaškrtněte políčko **Novinky povoleny** (News enabled), chcete-li ve svém obchodě povolit funkci novinek. - Zaškrtněte **Zobrazit na úvodní stránce** (Show on home page), chcete-li zobrazovat novinky na úvodní stránce obchodu. - Zadejte **Počet zobrazených položek** (Number of items to display) na úvodní stránce. - Zadejte **Velikost stránky archivu novinek** (News archive page size). Jde o počet novinek zobrazených na jedné stránce. - Zaškrtněte **Zobrazit odkaz na RSS kanál novinek v adresním řádku prohlížeče** (Display news RSS feed link in the browser address bar), chcete-li v adresním řádku prohlížeče zákazníků povolit odkaz na RSS kanál novinek. - Zaškrtněte **Mapa webu obsahuje novinky** (Sitemap includes news items), pokud chcete zahrnout novinky do mapy webu. - Zaškrtněte **sitemap.xml obsahuje novinky** (sitemap.xml includes news items), pokud chcete zahrnout novinky do souboru sitemap.xml. - Zaškrtněte **Zobrazit CAPTCHA na stránce novinek (komentáře)** (Show CAPTCHA on news page (comments)), chcete-li při psaní komentáře na stránce novinek zobrazovat CAPTCHA. ### Komentáře k novinkám Definujte následující nastavení *Komentářů k novinkám* (News comments): - Zaškrtněte políčko **Povolit hostům psát komentáře** (Allow guests to leave comments), aby mohli k novinkám přidávat komentáře i neregistrovaní uživatelé. - Zaškrtněte políčko **Komentáře k novinkám musí být schváleny** (News comments must be approved), pokud musí komentáře k novinkám schvalovat administrátor. - Zaškrtněte políčko **Upozorňovat na nové komentáře k novinkám** (Notify about new news comments), chcete-li majitele obchodu upozorňovat na nové komentáře k novinkám. - Zaškrtněte políčko **Komentáře k novinkám podle obchodu** (News comments per store), chcete-li zobrazovat pouze komentáře k novinkám napsané v aktuálním obchodě. Klikněte na **Uložit** (Save). ## Návody - [Správa novinek v nopCommerce](https://www.youtube.com/watch?v=ztLlRXvBQK4) --- # Fóra Fórum je online diskusní web, kde mohou lidé vést konverzace formou zveřejněných příspěvků. Fórum může obsahovat řadu podfór, z nichž každé má několik témat. V nopCommerce je tato funkce implementována jako plugin *Forums* (systémový název *Misc.Forums*), který je k dispozici od nopCommerce 5.00. Plugin patří do skupiny *Misc*. > [!NOTE] > > Od verze 4.90 musíte po povolení fór v případě potřeby [ručně přidat](xref:cs/running-your-store/content-management/menu) položku do nabídky nebo zápatí. ## Jak to funguje Chcete-li spravovat skupiny fór a fóra (uvnitř skupin fór), přejděte do **Správa obsahu → Fóra** (Content management → Forums). ![Správa fór](_static/forums/list.png) ## Přidání nové skupiny fór Klikněte na tlačítko **Přidat novou skupinu fór** (Add new forum group). ![Přidání nové skupiny fór](_static/forums/forums2.png) - Zadejte **Název** (Name) nové skupiny fór. - Do pole **Pořadí zobrazení** (Display order) zadejte pořadí zobrazení skupiny fór. Hodnota 1 představuje začátek seznamu. Klikněte na **Uložit** (Save). ## Přidání nového fóra ![Přidání nového fóra](_static/forums/forums3.png) - Z rozevíracího seznamu **Skupina fór** (Forum group) vyberte požadovanou skupinu fór. - Zadejte **Název** (Name) nového fóra. - Zadejte **Popis** (Description) nového fóra. - Zvolte **Pořadí zobrazení** (Display order) pro skupinu fór. Hodnota 1 představuje začátek seznamu. Klikněte na **Uložit** (Save). Příklad toho, jak by fóra měla fungovat, si můžete prohlédnout na . ![Fóra nopCommerce](_static/forums/example.png) ## Nastavení fór Chcete-li plugin nakonfigurovat, přejděte do **Konfigurace → Místní pluginy** (Configuration → Local plugins) a klikněte na **Konfigurovat** (Configure) vedle pluginu *Forums*. Tato stránka je k dispozici ve 2 režimech: *pokročilém* a *základním*. Tato stránka umožňuje konfiguraci pro více obchodů; to znamená, že pro všechny obchody lze definovat stejná nastavení, nebo se mohou mezi obchody lišit. Pokud chcete spravovat nastavení pro určitý obchod, zvolte jeho název z rozevíracího seznamu konfigurace více obchodů a zaškrtněte vlevo všechna potřebná políčka, abyste pro ně nastavili vlastní hodnoty. Další podrobnosti najdete v kapitole [Více obchodů](xref:cs/getting-started/advanced-configuration/multi-store). ### Obecné ![Obecná nastavení](_static/forums/common.png) Na panelu *Obecné* (Common) definujte následující nastavení fór: - Fóra povolíte zaškrtnutím políčka **Fóra povolena** (Forums enabled). - Zaškrtněte políčko **Zobrazit CAPTCHA na fóru** (Show CAPTCHA on forum), chcete-li na fóru zobrazovat CAPTCHA při úpravě a vytváření tématu nebo příspěvku. - Zaškrtnutím políčka **Relativní formátování data a času** (Relative date and time formatting) povolíte relativní datum a čas (například před 2 hodinami, před 1 dnem). - Zaškrtnutím **Podpis povolen** (Signature enabled) umožníte zákazníkům zadat podpis. - Zaškrtnutím políčka **Zobrazit počet příspěvků zákazníků** (Show customers post count) povolíte zobrazování počtu příspěvků vytvořených zákazníkem. - Z rozevíracího seznamu **Editor fóra** (Forum editor) vyberte typ editoru fóra, který se má použít: - Jednoduché textové pole. - Editor BBCode. - Editor Markdown > [!NOTE] > > Měnit typ editoru fóra v produkčním prostředí se nedoporučuje. ### Oprávnění ![Nastavení oprávnění](_static/forums/permissions.png) Na panelu *Oprávnění* (Permissions) definujte následující nastavení fór: - **Povolit hostům vytvářet příspěvky** (Allow guests to create posts). - **Povolit hostům vytvářet témata** (Allow guests to create topics). - **Povolit zákazníkům upravovat příspěvky** (Allow customers to edit posts). - **Povolit zákazníkům mazat příspěvky** (Allow customers to delete posts). - **Povolit zákazníkům spravovat odběry fór** (Allow customers to manage forum subscriptions). - Zaškrtnutím políčka **Povolit uživatelům hlasovat pro příspěvky** (Allow users to vote for posts) povolíte hlasování. - Pole **Maximální počet hlasů za den** (Maximum votes per day) určuje, kolik hlasů může uživatel za den udělit, pokud je předchozí nastavení povoleno. ### Velikosti stránek ![Nastavení velikostí stránek](_static/forums/page-sizes.png) Na panelu *Velikosti stránek* (Page sizes) definujte následující nastavení fór: - **Velikost stránky témat** (Topics page size) — velikost stránky pro témata ve fórech, například `10` témat na stránku. - **Velikost stránky příspěvků** (Posts page size) — velikost stránky pro příspěvky v tématech, například `10` příspěvků na stránku. - **Velikost stránky výsledků hledání** (Search results page size) — velikost stránky pro výsledky hledání, například `10` výsledků na stránku. - **Velikost stránky aktivních diskusí** (Active discussions page size) – velikost stránky aktivních diskusí, například `50` výsledků na stránku. ### Kanály ![Nastavení kanálů](_static/forums/feeds.png) Na panelu *Kanály* (Feeds) definujte následující nastavení fór: - Zaškrtnutím políčka **Kanály fór povoleny** (Forum feeds enabled) povolíte kanály RSS pro každé fórum. - V poli **Počet položek v kanálu fóra** (Forum feed count) nastavte počet témat, která budou zahrnuta v každém kanálu. - Zaškrtnutím políčka **Kanál aktivních diskusí povolen** (Active discussions feed enabled) povolíte kanály RSS pro témata aktivních diskusí. - V poli **Počet položek v kanálu aktivních diskusí** (Active discussions feed count) nastavte počet diskusí, které budou zahrnuty v kanálu „Aktivní diskuse“. ## Videonávody - [Správa fór v nopCommerce](https://www.youtube.com/watch?v=wW2QvC4WA_8) --- # Ankety Funkce anket v nopCommerce vám umožňuje učinit váš e-shop interaktivnějším. Ankety lze na e-shopu využít mnoha způsoby. Oblíbené je jejich použití jako krátkého průzkumu spokojenosti zákazníků. Lidé rádi, když se jich někdo ptá na názor, a je to dobrá příležitost zjistit, jak si jako internetový obchodník vedete. V nopCommerce je tato funkce implementována jako plugin *Polls* (systémový název *Misc.Polls*), dostupný od nopCommerce 5.00. Plugin patří do skupiny *Misc*. Anketa na úvodní stránce šablony Default Clean v nopCommerce vypadá takto: ![Anketa na úvodní stránce](_static/polls/polls_3.png) Chcete-li zobrazit všechny ankety a přidat nové, přejděte do **Správa obsahu → Ankety** (Content management → Polls). ![Seznam anket](_static/polls/polls_1.png) Chcete-li vyhledat ankety použité v určitém obchodě, vyberte název obchodu ze seznamu. ## Nastavení anket Chcete-li plugin nakonfigurovat, přejděte do **Konfigurace → Lokální pluginy** (Configuration → Local plugins) a klikněte na **Konfigurovat** (Configure) vedle položky *Polls*. Tato stránka je dostupná ve 2 režimech: *rozšířeném* a *základním*. Tato stránka umožňuje konfiguraci pro více obchodů; to znamená, že stejná nastavení lze definovat pro všechny obchody, nebo se mohou mezi obchody lišit. Pokud chcete spravovat nastavení pro konkrétní obchod, vyberte jeho název z rozbalovacího seznamu konfigurace pro více obchodů a zaškrtněte vlevo všechna potřebná zaškrtávací políčka, abyste pro ně mohli nastavit vlastní hodnoty. Další podrobnosti najdete v části [Více obchodů](xref:cs/getting-started/advanced-configuration/multi-store). ## Přidání anket Chcete-li přidat novou anketu, klikněte na tlačítko **Přidat nový** (Add new) vpravo nahoře. ![Přidat novou anketu](_static/polls/add-new.png) ### Informace o anketě Zadejte pro novou anketu následující údaje: - Pokud je povoleno více jazyků, vyberte z rozbalovacího seznamu **Jazyk** (Language) jazyk této ankety. Zákazníci uvidí pouze ankety ve zvoleném jazyce. - Zadejte popisný **Název** (Name) této ankety. Toto je text, který zákazníci uvidí. Například „Co si myslíte o našem obchodě?“ - Zaškrtněte políčko **Publikováno** (Published), aby byla anketa aktivní. - Zaškrtněte políčko **Zobrazit ankety na úvodní stránce** (Show polls on home page), pokud chcete anketu zobrazit na úvodní stránce. - Zaškrtněte políčko **Zobrazit v levém sloupci** (Show in the left-side columne), pokud chcete anketu zobrazit v levém sloupci. - Zaškrtněte políčko **Povolit hlasování hostům** (Allow guests to vote), aby v anketě mohli hlasovat i neregistrovaní uživatelé. - Zadejte **Datum zahájení** (Start date) a **Datum ukončení** (End date) v koordinovaném světovém čase (UTC). > [!NOTE] > > Pokud nechcete definovat datum zahájení a ukončení ankety, můžete tato pole ponechat prázdná. - V poli **Omezeno na obchody** (Limited to stores) vyberte obchody, chcete-li tuto anketu povolit pouze pro konkrétní obchody. Pokud tuto funkci nepotřebujete, ponechte pole prázdné. > [!NOTE] > > Abyste mohli tuto funkci používat, musíte zakázat následující nastavení: **Nastavení katalogu → Ignorovat pravidla „omezení na obchod“ (pro celý web)** (Catalog settings → Ignore "limit per store" rules (sitewide)). Přečtěte si více o [funkci více obchodů](xref:cs/getting-started/advanced-configuration/multi-store). - Zadejte **Pořadí zobrazení** (Display order) ankety. Hodnota 1 představuje začátek seznamu. Klikněte na **Uložit a pokračovat v úpravách** (Save and continue edit) a pokračujte na panel *Odpovědi ankety*. ### Odpovědi ankety Vyplňte následující informace o odpovědi ankety: - **Název** (Name), který se zobrazí zákazníkovi. - **Pořadí zobrazení** (Display order). Hodnota 1 představuje začátek seznamu. Poté klikněte na tlačítko **Přidat nový záznam** (Add new record) a odpověď uložte. Úplný seznam odpovědí může vypadat takto: ![Odpovědi ankety](_static/polls/answers.png) Záznamy pak můžete v případě potřeby **Upravit** (Edit) a **Smazat** (Delete). ## Návody - [Správa anket v nopCommerce](https://www.youtube.com/watch?v=RJP45cUhuZQ) --- # Stránky (topics) Stránky (topics) jsou bloky obsahu volného formátu, které lze na webu zobrazit buď vložené do jiných stránek, nebo na samostatné stránce. Často se používají pro stránky s častými dotazy (FAQ), stránky se zásadami, zvláštní pokyny a další. Chcete-li vytvořit vlastní stránku, vytvořte novou stránku (topic) a na stránce s jejími podrobnostmi zadejte vlastní obsah. Obsah lze napsat pro každý jazyk zvlášť. ## Seznam stránek Stránky zobrazíte v **Správa obsahu → Stránky (topics)** (Content management → Topics (pages)). Stránky v seznamu můžete vyhledat zadáním textu stránky nebo jeho části do pole **Klíčová slova pro vyhledávání** (Search keywords), případně mezi všemi stránkami určitého obchodu. ![p1](_static/topics-pages/topic-list.jpg) ## Přidání stránek Chcete-li přidat novou stránku, přejděte na **Správa obsahu → Stránky (topics)** (Content management → Topics (pages)). Klikněte na **Přidat nový** (Add new) a vyplňte informace o nové stránce. ![p2](_static/topics-pages/new-topic.jpg) ### Informace Na panelu *Informace* (Info) definujte následující podrobnosti stránky: * Zadejte **Název** (Title) stránky. * Obsah stránky přidejte pomocí editoru v poli **Text** (Body). * Pole **URL** slouží pouze pro informaci. Jde o URL stránky ve veřejné části obchodu. Můžete ji změnit úpravou pole **Název stránky přátelský k vyhledávačům** (Search engine friendly page name) níže. ### Zobrazení Na panelu *Zobrazení* (Display) definujte následující podrobnosti stránky: * Zaškrtnutím políčka **Publikováno** (Published) stránku publikujete. * Tuto stránku můžete zahrnout do **horního menu** (top menu), **zápatí (sloupec 1)** (footer (column 1)), zápatí (sloupec 2), zápatí (sloupec 3) a **mapy webu** (sitemap). Provedete to zaškrtnutím odpovídajícího políčka. * Zaškrtněte políčko **Chráněno heslem** (Password protected), pokud je tato stránka chráněna heslem. Na stránce ve veřejné části obchodu se zobrazí pole **Heslo** (Password). Zákazník bude muset pro přístup k obsahu této stránky zadat heslo. * Z rozbalovacího seznamu **Role zákazníků** (Customer roles) vyberte roli nebo role zákazníků, které mají k této stránce přístup. > [!NOTE] > > Abyste mohli tuto funkci používat, musíte vypnout následující nastavení: **Konfigurace → Nastavení katalogu → Ignorovat pravidla ACL (v celém webu)** (Configuration → Catalog settings → Ignore ACL rules (sitewide)). Více o [seznamu řízení přístupu](xref:cs/running-your-store/customer-management/access-control-list). * V rozbalovacím seznamu **Omezeno na obchody** (Limited to stores) vyberte obchody, ve kterých se stránka bude zobrazovat. > [!NOTE] > > Abyste mohli tuto funkci používat, musíte vypnout následující nastavení: **Nastavení katalogu → Ignorovat pravidla „omezení na obchod“ (v celém webu)** (Catalog settings → Ignore "limit per store" rules (sitewide)). Více o [funkci více obchodů](xref:cs/getting-started/advanced-configuration/multi-store). * Pomocí pole **Přístupné při uzavřeném obchodě** (Accessible when store closed) zpřístupníte tuto stránku i v době, kdy je obchod uzavřen. * Vyberte **Pořadí zobrazení** (Display order) stránky. Například 1 představuje první položku v seznamu. * Zadejte **Systémový název** (System name) této stránky. > [!NOTE] > > Pro různé stránky je možné použít stejný systémový název. Můžete například vytvořit dvě různé stránky se stejným systémovým názvem a zpřístupnit je různým rolím zákazníků, například rolím *Hosté* (Guest) a *Registrovaní* (Registered). To znamená, že hosté a registrovaní zákazníci uvidí na webu odlišný obsah. > [!NOTE] > > Při úpravě existující stránky nebo po kliknutí na tlačítko **Uložit a pokračovat v úpravách** (Save and continue edit) u nové stránky můžete kliknout na tlačítko **Náhled** (Preview) a zobrazit, jak bude stránka na webu vypadat. ### SEO Na panelu *SEO* definujte následující podrobnosti stránky: * Do pole **Název stránky přátelský k vyhledávačům** (Search engine friendly page name) zadejte název stránky používaný vyhledávači. Pokud nic nezadáte, URL webové stránky se vytvoří z názvu stránky. Pokud zadáte *custom-seo-page-name*, použije se následující URL: `http://www.yourStore.com/custom-seo-page-name`. * Do pole **Meta titulek** (Meta title) zadejte požadovaný titulek. Značka title určuje titulek webové stránky. Jde o kód vložený do hlavičky webové stránky v následujícím formátu: ```html Creating Title Tags for Search Engine Optimization & Web Usability <title> </head> ``` * Zadejte požadovaná **Meta klíčová slova** (Meta keywords), která představují stručný a výstižný seznam nejdůležitějších témat stránky. Značka meta keywords má následující formát: ```html <meta name="keywords" content="keywords, keyword, keyword phrase, etc."> ``` * Do pole **Meta popis** (Meta description) zadejte popis. Značka meta description je stručné a výstižné shrnutí obsahu stránky. Značka meta description má následující formát: ```html <meta name="description" content="Brief description of the contents of your page."> ``` Klikněte na **Uložit** (Save). Stránka se zobrazí ve veřejné části obchodu. ## Viz také * [SEO](xref:cs/running-your-store/search-engine-optimization) ## Výukové materiály * [Přidání nové šablony stránky (topic)](https://www.youtube.com/watch?v=M-g4Ux2GCaY) --- <!-- page: Menu | url: http://nopdocs.service.hedr.dev/cs/running-your-store/content-management/menu.html | source: cs/running-your-store/content-management/menu.md --> # Mega menu Od verze 4.90 může administrátor v administraci plně přizpůsobit hlavní menu i navigaci v patičce. ![Menu](_static/menu/public.png) ## Přístup ke správě menu Menu spravujete v **Správa obsahu -> Menu** (Content management -> Menus). Na této stránce můžete upravit existující menu nebo vytvořit nové. ![Menu](_static/menu/admin.png) ## Vytváření a správa menu Při vytváření nového menu musíte určit jeho umístění pomocí **Typu menu** (Menu type): - **Hlavní menu** (Main menu): Hlavní navigační lišta. - **Patička** (Footer): Navigační odkazy v patičce webu. ![Menu](_static/menu/add_menu.png) > [!WARNING] > > Ačkoli můžete vytvořit více instancí `Main menu`, ve veřejné části obchodu se v daném okamžiku zobrazí vždy jen jedna, a to podle její dostupnosti a pořadí vytvoření. Nastavení **„Zobrazit všechny kategorie“** ('Display all categories') automaticky generuje položky menu nejvyšší úrovně na základě kategorií vašeho obchodu a jejich podkategorií. Pokud je toto políčko zaškrtnuto, zobrazí se tyto odkazy na kategorie před všemi ručně vytvořenými položkami menu. Po úspěšném vytvoření menu do něj můžete začít přidávat položky. ![Menu](_static/menu/menu_items.png) ## Přidávání a konfigurace položek menu Při vytváření nebo úpravě položky menu jsou k dispozici následující parametry. ![Menu](_static/menu/menu_items_add.png) > [!WARNING] > > U menu typu `Footer` není vlastnost **„Nadřazená položka menu“** ('Parent menu item') k dispozici, protože navigace v patičce podporuje pouze jednu úroveň bez vnoření. ### Typ položky menu Tento parametr určuje chování a dostupná nastavení položky menu. ![Menu](_static/menu/menu_item_type.png) - **Standardní stránka** (Standard page): Odkazuje na předdefinovanou systémovou stránku s předem nakonfigurovanou cestou (route). - **Kategorie** (Category): - Zobrazit všechny kategorie (v rozložení mřížky nebo seznamu). - Zobrazit jednu kategorii (jako mřížku, seznam nebo jednoduchý odkaz). - **Výrobce** (Manufacturer): - Zobrazit všechny výrobce (v rozložení mřížky nebo seznamu). - Odkaz na stránku „Všichni výrobci“. - Odkaz na stránku konkrétního výrobce. - **Produkt** (Product): Odkazuje přímo na stránku vybraného produktu. - **Dodavatel** (Vendor): - Zobrazit všechny dodavatele (v rozložení mřížky nebo seznamu). - Odkaz na stránku „Všichni dodavatelé“. - Odkaz na stránku konkrétního dodavatele. - **Stránka (topic)** (Topic (page)): Odkazuje na vybranou stránku (topic). - **Vlastní odkaz** (Custom link): Jednoduchý odkaz, u kterého ručně zadáte text a URL. - **Text bez odkazu** (Text without link): Zobrazí neklikatelný text. To je užitečné pro nadřazené položky, které slouží jako nadpisy a nemusí nikam odkazovat. ### Další nastavení pro rozložení mřížky/seznamu Pro položky menu, které používají šablonu mřížky nebo seznamu (např. zobrazení všech kategorií), jsou k dispozici následující možnosti: - **Počet prvků na řádek (mřížka)** (Number of elements per row (grid)): Nastavuje maximální počet položek zobrazených v jednom řádku mřížky. - **Počet podkategorií na položku kategorie (mřížka)** (Number of subcategories per category item (grid)): Nastavuje maximální počet odkazů na podkategorie zobrazených v každé dlaždici mřížky. - **Maximální počet prvků** (Maximum number of elements): Nastavuje celkový maximální počet zobrazených podřízených položek. ![Menu](_static/menu/menu_items_add_grid.png) --- <!-- page: Šablony zpráv | url: http://nopdocs.service.hedr.dev/cs/running-your-store/content-management/message-templates.html | source: cs/running-your-store/content-management/message-templates.md --> # Šablony zpráv Šablony zpráv definují rozvržení, obsah a formátování automatických zpráv odesílaných z vašeho obchodu. Nazývají se transakční e-maily, protože každý z nich je spojen s určitým typem transakce. V nopCommerce je ve výchozím stavu k dispozici několik šablon zpráv, které informují uživatele a majitele obchodu o stavech objednávek a dalších událostech. Šablony zpráv najdete v **Správa obsahu → Šablony zpráv** (Content management → Message templates). ![MessageTemplate1](_static/message-templates/list.png) Filtrování: * Šablony zpráv můžete vyhledávat podle klíčových slov nebo obchodu. Klíčová slova se vyhledávají v názvu, těle nebo předmětu šablony zprávy. Seznam dostupných obchodů se zobrazí, pokud máte více než jeden obchod a nastavení **Výkon → Ignorovat pravidla „omezení na obchod“ (pro celý web)** (Performance → Ignore "limit per store" rules (sitewide)) na stránce *Nastavení katalogu* není aktivní. * **E-mailový účet** (Email account). Tento rozbalovací seznam se zobrazí, pokud má obchod dva nebo více e-mailových účtů. * Šablony zpráv můžete také filtrovat podle **Je aktivní** (Is active). ## Úprava šablony zprávy Najděte šablonu zprávy, kterou chcete upravit, a klikněte na **Upravit** (Edit). Zobrazí se okno *Upravit podrobnosti šablony zprávy*: ![Úprava šablon zpráv](_static/message-templates/edit.jpg) Pokud máte nainstalováno více jazyků, vyberte požadovanou **záložku jazyka**. > [!TIP] > > Ve výchozím stavu se v systému používá pouze angličtina. Jazyky můžete spravovat v **Konfigurace → Jazyky** (Configuration → Language). Více o jazycích v nopCommerce si přečtěte v části [Lokalizace](xref:cs/getting-started/advanced-configuration/localization). Upravte podrobnosti šablony zprávy takto: * Upravte **Předmět** (Subject) zprávy. Do předmětu můžete vložit tokeny. Seznam všech povolených tokenů najdete v horní části stránky. * Upravte **Tělo** (Body) zprávy. * Do pole **Skrytá kopie** (BCC) zadejte v případě potřeby příjemce skryté kopie této e-mailové zprávy. * Z rozbalovacího seznamu **E-mailový účet** (Email account) vyberte e-mailový účet, který se použije k odesílání této šablony zprávy. * Tuto šablonu zprávy můžete otestovat kliknutím na tlačítko **Otestovat šablonu** (Test template). Po kliknutí se zobrazí okno *Odeslat testovací e-mail*: ![Odeslat testovací e-mail](_static/message-templates/test-template.jpg) Zadejte svůj e-mail do pole **Odeslat e-mail na** (Send email to), vyplňte tokeny testovacími hodnotami a klikněte na tlačítko **Odeslat** (Send). > [!TIP] > > E-mailové účty se konfigurují v **Konfigurace → E-mailové účty** (Configuration → Email accounts). Více si o nich přečtěte v části [E-mailové účty](xref:cs/getting-started/email-accounts). * Zaškrtněte možnost **Je aktivní** (Is active), pokud se má tato zpráva odesílat. * Zaškrtněte políčko **Odeslat okamžitě** (Send immediately), pokud chcete, aby byl tento e-mail odeslán okamžitě. * Pokud je předchozí políčko nezaškrtnuté, zobrazí se pole **Odložené odeslání** (Delay send). * Zaškrtněte políčko **Připojený statický soubor** (Attached static file) a nahrajte soubor, který bude připojen ke každému odeslanému e-mailu. * V poli **Omezeno na obchody** (Limited to stores) vyberte obchody, pokud je šablona zprávy určena pouze pro konkrétní obchody. Pokud tuto funkci nepotřebujete, ponechte pole prázdné. > [!NOTE] > > Abyste mohli tuto funkci používat, musíte zakázat následující nastavení: **Nastavení katalogu → Ignorovat pravidla „omezení na obchod“ (pro celý web)** (Catalog settings → Ignore "limit per store" rules (sitewide)). Přečtěte si více o [funkci více obchodů](xref:cs/getting-started/advanced-configuration/multi-store). Klikněte na **Uložit** (Save). > [!NOTE] > > Chcete-li vytvořit úplnou kopii šablony zprávy, klikněte vpravo nahoře na **Kopírovat šablonu** (Copy template). To se hodí, pokud máte nakonfigurováno několik obchodů a chcete pro každý z nich vytvořit samostatné šablony. ## Viz také * [E-mailové účty](xref:cs/getting-started/email-accounts) * [Jazyky](xref:cs/getting-started/advanced-configuration/localization) ## Návody * [Přidávání podmínek do šablon zpráv](https://www.youtube.com/watch?v=5chrb1yH1v4&feature=youtu.be) --- <!-- page: Optimalizace pro vyhledávače | url: http://nopdocs.service.hedr.dev/cs/running-your-store/search-engine-optimization.html | source: cs/running-your-store/search-engine-optimization.md --> # Optimalizace pro vyhledávače SEO (search engine optimization) znamená optimalizaci pro vyhledávače; jde o proces získávání návštěvnosti z „bezplatných“, „organických“, „redakčních“ nebo „přirozených“ výsledků vyhledávání ve vyhledávačích. Všechny hlavní vyhledávače mají primární výsledky vyhledávání, ve kterých jsou webové stránky a další obsah, například videa nebo místní záznamy, zobrazovány a řazeny podle toho, co vyhledávač považuje pro uživatele za nejrelevantnější. nopCommerce podporuje techniky SEO pro různé typy stránek ve vašem obchodě. Jejich seznam najdete v části [Viz také](#see-also). ## Nastavení SEO V nopCommerce existují některá obecná nastavení SEO, která lze použít na celý obchod. Nastavení SEO upravíte v **Konfigurace → Nastavení → Obecná nastavení** (Configuration → Settings → General settings). Poté přejděte na panel *SEO*: ![Nastavení SEO](_static/search-engine-optimization/seo1.png) - Do pole **Výchozí titulek stránky** (Default page title) zadejte výchozí titulek stránek ve vašem obchodě. - V poli **Úprava SEO titulku stránky** (Page title SEO adjustment) vyberte požadovanou úpravu titulku stránky: - Název stránky následuje v titulku za názvem obchodu: `YOURSTORE.COM` | PAGENAME - Název obchodu následuje v titulku za názvem stránky: PAGENAME | `YOURSTORE.COM` - Určete **Oddělovač titulku stránky** (Page title separator). - Zadejte **Výchozí meta klíčová slova** (Default meta keywords) pro stránky ve vašem obchodě. Lze je přepsat u jednotlivých kategorií, výrobců, produktů a některých dalších stránek. - Zadejte **Výchozí meta popis** (Default meta description) pro stránky ve vašem obchodě. Lze jej přepsat u jednotlivých kategorií, výrobců, produktů a některých dalších stránek. - Zadejte **Titulek domovské stránky** (Home page title) pro domovskou stránku vašeho obchodu. - Zadejte **Meta popis domovské stránky** (Home page meta description) pro domovskou stránku vašeho obchodu. - Zaškrtnutím **Generovat meta popis produktu** (Generate product meta description) se budou META popisy produktů (pokud nejsou zadány na stránce detailu produktu) generovat automaticky na základě krátkého popisu produktu. - Zvolte **Požadavek na prefix WWW** (WWW prefix requirement). Například `http://yourStore.com/` lze automaticky přesměrovat na `http://www.yourStore.com/`. Vyberte jednu z následujících možností: - *Nezáleží na tom* - *Stránky by měly mít prefix WWW* - *Stránky by neměly mít prefix WWW* - Zaškrtnutím políčka **Převádět nezápadní znaky** (Convert non-western chars) odstraníte diakritiku v SEO názvech. Například převedete é na e. - Zaškrtnutím políčka **Povolit kanonické URL** (Enable canonical URLs) se URL převede na kanonickou URL, což umožňuje určit, zda dvě syntakticky odlišné URL mohou vést na stránku s ekvivalentním obsahem. - Zaškrtnutím políčka **Twitter META tagy** (Twitter META tags) se na stránce detailu produktu budou generovat META tagy pro Twitter. - Zaškrtnutím políčka **Open Graph META tagy** (Open Graph META tags) se na stránce detailu produktu budou generovat META tagy Open Graph. - Zaškrtnutím políčka **Microdata tagy** (Microdata tags) se na stránce detailu produktu budou generovat tagy Microdata. - Zadejte **Vlastní tag <head>** (Custom <head> tag). Například nějaký vlastní tag <meta>. Nebo ponechte prázdné, chcete-li toto nastavení ignorovat. <a id="seo-panels"></a> ## Panely SEO V nopCommerce existuje několik typů stránek, pro které můžete nastavit individuální nastavení SEO, včetně meta klíčových slov, meta popisu, meta titulku a názvů stránek vhodných pro vyhledávače. To se provádí na panelech SEO v příslušných sekcích administrace. ![Panel SEO](_static/search-engine-optimization/seo-panel.jpg) - Do pole **Název stránky vhodný pro vyhledávače** (Search engine friendly page name) zadejte název stránky používaný vyhledávači. Pokud nic nezadáte, URL webové stránky se vytvoří z názvu stránky. Pokud zadáte *custom-seo-page-name*, použije se tato vlastní URL: `http://www.yourStore.com/custom-seo-page-name`. - Do pole **Meta titulek** (Meta title) zadejte požadovaný titulek. Tag title určuje titulek vaší webové stránky. Načítají jej webové prohlížeče a používají jej také vyhledávače, například Google, k zobrazení webové stránky ve výsledcích vyhledávání: ![Meta titulek](_static/search-engine-optimization/meta-title.jpg) - Zadejte požadovaná **Meta klíčová slova** (Meta keywords). Stručně popisují obsah webové stránky, a jsou proto pro vyhledávače důležitým ukazatelem obsahu webu. Meta klíčová slova pomáhají vyhledávačům určit, jaké je téma stránky. Klíčová slova se obvykle píší malými písmeny. - Do pole **Meta popis** (Meta description) zadejte popis stránky. Meta popis poskytuje shrnutí webové stránky. Vyhledávače, například Google, často zobrazují meta popis ve výsledcích vyhledávání, což může ovlivnit míru prokliku: ![Meta popis](_static/search-engine-optimization/meta-description.jpg) Meta popis může mít libovolnou délku, ale Google obvykle zkracuje úryvky na ~155–160 znaků. Nejlepší je, aby byl meta popis dostatečně dlouhý, aby byl dostatečně výstižný, proto se doporučuje psát popisy v rozsahu 50–160 znaků. Mějte na paměti, že „optimální“ délka se bude lišit podle situace a vaším hlavním cílem by mělo být poskytnout hodnotu a získat prokliky. ## Názvy stránek vhodné pro vyhledávače Všechny názvy stránek vhodné pro vyhledávače používané v obchodě zobrazíte v **Systém → Názvy stránek vhodné pro vyhledávače** (System → Search engine friendly page names). ![Názvy stránek vhodné pro vyhledávače](_static/search-engine-optimization/seo-page-names-list.jpg) Zde můžete názvy stránek vhodné pro vyhledávače filtrovat podle vlastnosti **Název** (Name), **Jazyk** (Language) nebo **Je aktivní** (Is active). Pomocí tlačítka **Smazat vybrané** (Delete selected) můžete také smazat jeden nebo více vybraných názvů stránek. Ve sloupci **Upravit stránku** (Edit page) vidíte tlačítko, které slouží k přechodu na příslušnou stránku. <a id="see-also"></a> ## Viz také - [Přidávání produktů](xref:cs/running-your-store/catalog/products/add-products) - [Kategorie produktů](xref:cs/running-your-store/catalog/categories) - [Výrobci](xref:cs/running-your-store/catalog/manufacturers) - [Dodavatelé](xref:cs/running-your-store/vendor-management) - [Stránky (topics)](xref:cs/running-your-store/content-management/topics-pages) - [Novinky](xref:cs/running-your-store/content-management/news) - [Blog](xref:cs/running-your-store/content-management/blog) ## Návody - [Porozumění nastavení SEO v nopCommerce](https://youtu.be/UxqM_nJyv1Q) --- <!-- page: Přehledy | url: http://nopdocs.service.hedr.dev/cs/running-your-store/reports.html | source: cs/running-your-store/reports.md --> # Přehledy Přehledy jsou pro řízení důležité; umožňují sledovat výkonnost obchodu, klíčové ukazatele a podporují rozhodování. Přehledy nopCommerce poskytují přístup k informacím o prodejích a zákaznících. ## Nástěnka Nástěnka (Dashboard) je první stránka, kterou uvidíte po vstupu do administrace. Umožňuje zobrazit statistiky obchodu, včetně celkového počtu objednávek zpracovaných za zvolené období (rok, měsíc, týden), registrovaných zákazníků, produktů s nízkou zásobou a nejoblíbenějších produktů ve vašem obchodě. ![Nástěnka](_static/reports/dashboard.png) Nástěnka se skládá z několika bloků: ### Novinky nopCommerce Zobrazuje obecné novinky o nopCommerce, například vydání nových verzí. ![Novinky](_static/reports/news.png) ### Obecné statistiky ![Obecné](_static/reports/common.png) Zde najdete odkazy na podrobnější přehledy: - Prodej → Objednávky (Sales → Orders) - Prodej → Žádosti o vrácení (Sales → Return requests) - Zákazníci → Registrovaní zákazníci (Customers → Registered customers) - Přehledy → Nízká zásoba (Reports → Low stock) ### Objednávky Tento diagram zobrazuje počet objednávek zpracovaných za poslední týden, měsíc, rok. ![Objednávky](_static/reports/orders.jpg) ### Noví zákazníci Tento diagram zobrazuje počet zákazníků registrovaných za poslední týden, měsíc, rok. ![Noví zákazníci](_static/reports/customers.jpg) ### Součty objednávek Tato sekce zobrazuje součet objednávek zpracovaných za poslední den, týden, měsíc, rok. Objednávky jsou zobrazeny podle stavu objednávky. ![Součty objednávek](_static/reports/order-totals.png) ### Nedokončené objednávky Tato sekce zobrazuje počet objednávek, které jsou aktuálně nedokončené. ![Nedokončené objednávky](_static/reports/order-incomplete.png) ### Nejnovější objednávky Sekce Nejnovější objednávky zobrazuje naposledy vytvořené objednávky. ![Nejnovější objednávky](_static/reports/order-latest.png) ### Oblíbená klíčová slova vyhledávání Tento blok zobrazuje nejpoužívanější klíčová slova. ![Klíčová slova](_static/reports/keywords.png) ### Přehledy nejprodávanějších produktů Tato sekce zobrazuje nejprodávanější produkty podle množství a podle částky. ![Nejprodávanější](_static/reports/bestsellers.png) ## Souhrn prodejů Tento přehled představuje souhrn všech objednávek. K vytvoření přehledu můžete použít následující filtry: - **Datum od** (Start date) pro vyhledávání. - **Datum do** (End date) pro vyhledávání. - **Stav objednávky** (Order status) pro vyhledávání podle konkrétního stavu objednávky, například „Dokončeno“. - **Stav platby** (Payment status) pro vyhledávání podle konkrétního stavu platby, například „Zaplaceno“. - **Kategorie** (Category) pro vyhledávání v konkrétní kategorii. - **Výrobce** (Manufacturer) pro vyhledávání podle konkrétního výrobce. - **Fakturační země** (Billing country) pro filtrování podle fakturační země objednávky. - **Dodavatel** (Vendor) pro vyhledávání podle konkrétního dodavatele. - **Produkt** (Product) pro vyhledávání podle konkrétního produktu. - **Seskupit podle** (Group by) pro seskupení podle časových období. Pokud je tato volba nastavena na „Den“, zobrazí se seznam dat pro vybrané období (datum od/do). Například „8. listopadu 2020“, „7. listopadu 2020“ atd. Pokud je nastavena na „Týden“, zobrazí se seznam týdnů (například „7. prosince 2020 - 12. prosince 2020“ atd.). Pokud je nastavena na „Měsíc“, zobrazí se seznam měsíců (například „prosinec 2020“, „listopad 2020“ atd.). Poté klikněte na **Spustit přehled** (Run report). ![Souhrn prodejů](_static/reports/sales-summary.jpg) ## Přehled nízkých zásob Přehled nízkých zásob obsahuje seznam produktů, jejichž zásoba je aktuálně pod limitem. V níže uvedeném příkladu bylo minimální skladové množství nastaveno na 20 a skladové množství je 0; proto je pro tento produkt vygenerován přehled nízkých zásob. Nastavení nízkých zásob můžete určit při přidávání produktu. Chcete-li zobrazit přehledy nízkých zásob, přejděte do **Přehledy → Nízká zásoba** (Reports → Low stock). Zobrazí se okno přehledu *Nízká zásoba*: ![Přehled nízkých zásob](_static/reports/low-stock-reports.png) Přehledy nízkých zásob lze filtrovat podle vlastnosti **Publikováno** (Published), která představuje vlastnost *Publikováno* produktů. V zobrazené tabulce klikněte na **Zobrazit** (View), čímž zobrazíte stránku podrobností produktu, kde lze skladové množství aktualizovat. ## Nejprodávanější a nikdy nezakoupené produkty Znalost nejprodávanějších produktů a produktů, které nikdo nikdy nekoupil, je pro každého majitele obchodu zásadní. Především vám to může pomoci lépe se rozhodovat o nákupu: můžete navýšit zásoby oblíbených položek a neoblíbené vyřadit ze svého sortimentu. Při analýze zvažte například, zda se některé barvy prodávají rychleji nebo zda prodej vašich produktů závisí na sezóně. Za druhé, určení nejvíce a nejméně prodávaného zboží vám může pomoci *přehodnotit design produktů a marketing*. Možná se vaše nejlepší položky prodávají rychleji jen díky svému umístění ve vašem internetovém obchodě nebo lepšímu popisu. Vymyslete různé varianty a otestujte je. Abyste to dělali efektivněji, zapojte své zákazníky. *Provádějte různé průzkumy*, abyste zjistili, proč dávají přednost nejprodávanějším položkám a čím jsou pro vaše kupující výjimečné. Získané poznatky využijte ke zlepšení marketingu a zvýšení prodejů. ### Nejprodávanější Chcete-li v nopCommerce zobrazit nejprodávanější produkty, přejděte do **Přehledy → Nejprodávanější** (Reports → Bestsellers). Zadejte jedno nebo více z následujících kritérií vyhledávání a spusťte přehled: - **Datum od** (Start date) a/nebo **Datum do** (End date). - **Obchod** (Store), pokud chcete vybrat jeden ze svých obchodů. - **Stav objednávky** (Order status), například *Vše*, *Čekající*, *Zpracovává se*, *Dokončeno* nebo *Zrušeno*. - **Stav platby** (Payment status), například *Vše*, *Čekající*, *Autorizováno*, *Zaplaceno*, *Vráceno*, *Částečně vráceno* nebo *Zrušeno*. - Zvolte **Kategorii** (Category). - Zvolte **Výrobce** (Manufacturer). - Zvolte **Fakturační zemi** (Billing country). - Zvolte **Dodavatele** (Vendor). Poté klikněte na **Spustit přehled** (Run report). Přehled rozčlení vaše nejprodávanější produkty podle počtu prodaných kusů i podle tržeb: ![Nejprodávanější](_static/reports/bestsellers.jpeg) ### Nikdy nezakoupené produkty Chcete-li zobrazit produkty, které nikdy nikdo nekoupil, přejděte do **Přehledy → Nikdy nezakoupené produkty** (Reports → Products never purchased). Zadejte jedno nebo více z následujících kritérií vyhledávání a spusťte přehled: - Zvolte **Kategorii** (Category). - Zvolte **Výrobce** (Manufacturer). - **Obchod** (Store), pokud chcete vybrat jeden ze svých obchodů. - Zvolte **Dodavatele** (Vendor). - **Datum od** (Start date) a/nebo **Datum do** (End date). Poté klikněte na **Spustit přehled** (Run report). ![Nikdy nezakoupené produkty](_static/reports/never-purchased.jpg) ## Prodeje podle zemí Přehled podle zemí obsahuje seznam objednávek, který zahrnuje počet objednávek a celkovou částku objednávek v každé zemi. Majitelé obchodů tak mohou zobrazit objednávky podle jednotlivých zemí. Chcete-li zobrazit přehled prodejů podle zemí, přejděte do **Přehledy → Prodeje podle zemí** (Reports → Country sales). ![Prodeje podle zemí](_static/reports/country-report.png) Chcete-li přehled nastavit, zadejte jedno nebo více z následujících kritérií vyhledávání: - **Datum od** (Start date) pro vyhledávání. - **Datum do** (End date) pro vyhledávání. - **Stav objednávky** (Order status), například *Vše*, *Čekající*, *Zpracovává se*, *Dokončeno* nebo *Zrušeno*. - **Stav platby** (Payment status), například *Vše*, *Čekající*, *Autorizováno*, *Zaplaceno*, *Vráceno*, *Částečně vráceno* nebo *Zrušeno*. - **Obchod** (Store), pokud chcete vybrat jeden ze svých obchodů. Poté klikněte na **Spustit přehled** (Run report). ## Přehledy zákazníků Přehledy zákazníků poskytují majiteli obchodu obecné informace o registrovaných zákaznících a jejich objednávkách. Různé přehledy najdete v nabídce **Přehledy → Přehledy zákazníků** (Reports → Customer reports). ### Registrovaní zákazníci Chcete-li spustit tento přehled, přejděte do **Přehledy → Přehledy zákazníků → Registrovaní zákazníci** (Reports → Customer reports → Registered customers). Tento přehled zobrazuje počet registrovaných zákazníků za určité období. Můžete sledovat počet uživatelů registrovaných za poslední den, týden, dva týdny, měsíc a rok. ![Registrovaní zákazníci](_static/reports/customer-registered.png) ### Zákazníci podle celkové částky objednávek Chcete-li spustit tento přehled, přejděte do **Přehledy → Přehledy zákazníků → Zákazníci podle celkové částky objednávek** (Reports → Customer reports → Customers by order total). V tomto přehledu vidíte celkové částky utracené za objednávky a počet objednávek, které zákazníci provedli. ![Zákazníci podle celkové částky objednávek](_static/reports/Customers-by-order-total.png) Pro sestavení přehledu zadejte jedno nebo více kritérií vyhledávání: - **Datum od** (Start date) registrace. - **Datum do** (End date) registrace. - **Stav objednávky** (Order status), například *Vše*, *Čekající*, *Zpracovává se*, *Dokončeno* nebo *Zrušeno*. - **Stav platby** (Payment status), například *Vše*, *Čekající*, *Autorizováno*, *Zaplaceno*, *Vráceno*, *Částečně vráceno* nebo *Zrušeno*. - **Stav dopravy** (Shipping Status), například *Vše*, *Doprava není vyžadována*, *Dosud neodesláno*, *Částečně odesláno*, *Odesláno*, *Doručeno*. Poté klikněte na **Spustit přehled** (Run report). ### Zákazníci podle počtu objednávek Chcete-li spustit tento přehled, přejděte do **Přehledy → Přehledy zákazníků → Zákazníci podle počtu objednávek** (Reports → Customer reports → Customers by number of orders). Tento přehled zobrazuje 20 nejlepších zákazníků podle celkového počtu vytvořených objednávek. ![Zákazníci podle počtu objednávek](_static/reports/Customers-by-number-of-orders.png) Pro sestavení přehledu zadejte jedno nebo více kritérií vyhledávání: - **Datum od** (Start date) registrace. - **Datum do** (End date) registrace. - **Stav objednávky** (Order status), například *Vše*, *Čekající*, *Zpracovává se*, *Dokončeno* nebo *Zrušeno*. - **Stav platby** (Payment status), například *Vše*, *Čekající*, *Autorizováno*, *Zaplaceno*, *Vráceno*, *Částečně vráceno* nebo *Zrušeno*. - **Stav dopravy** (Shipping Status), například *Vše*, *Doprava není vyžadována*, *Dosud neodesláno*, *Částečně odesláno*, *Odesláno*, *Doručeno*. Poté klikněte na **Spustit přehled** (Run report). ## Videonávody - [Spouštění přehledů v nopCommerce](https://www.youtube.com/watch?v=IbfoppTG9tM) ## Viz také - [Microsoft Power BI](xref:cs/running-your-store/reports/microsoft-power-bi) --- <!-- page: Microsoft Power BI | url: http://nopdocs.service.hedr.dev/cs/running-your-store/reports/microsoft-power-bi.html | source: cs/running-your-store/reports/microsoft-power-bi.md --> # Microsoft Power BI [Pořiďte si oficiální integraci s Power BI](https://www.nopcommerce.com/microsoft-power-bi). ## Úvod Power BI je soubor softwarových služeb, aplikací a konektorů, které společně proměňují vaše nesouvisející zdroje dat v ucelené, vizuálně působivé a interaktivní poznatky. Power BI vám umožňuje snadno se připojit ke zdrojům dat, vizualizovat a objevovat to, co je důležité, a sdílet to s kýmkoli nebo se všemi, s kým chcete. Obsah není statický, takže se do něj můžete ponořit a hledat trendy, poznatky a další business intelligence. Obsah můžete různě dělit a filtrovat a dokonce mu klást otázky vlastními slovy. Nebo se pohodlně opřete a nechte svá data, aby za vás objevovala zajímavé poznatky, posílala vám upozornění při změně dat nebo vám e-mailem zasílala přehledy podle vámi nastaveného plánu. Veškerý obsah máte k dispozici kdykoli, v cloudu i v místním prostředí (on-premises), z jakéhokoli zařízení. A to je jen začátek toho, co Power BI dokáže. Více informací o [Power BI](https://learn.microsoft.com/en-us/power-bi/fundamentals/power-bi-overview). ## Dostupné přehledy Přehled (report) Power BI je pohled na datovou sadu z více perspektiv s vizuály, které představují různá zjištění a poznatky z této datové sady. Přehled může obsahovat jediný vizuál nebo celé stránky vizuálů. > [!TIP] > > Protože se plugin dodává se zdrojovým kódem, můžete přidávat nové přehledy nebo měnit datový model a přizpůsobit tak integraci svým konkrétním požadavkům. Můžete [se dozvědět více o tom, jak se přehledy vytvářejí](https://learn.microsoft.com/en-us/power-bi/consumer/end-user-experience). Základní balíček pluginu obsahuje 13 přehledů, které pokrývají různé analytické aspekty dostupných informací. Podrobný popis každého z nich je uveden níže. ### Souhrn prodejů Souhrn prodejů (Sales Summary) je často používaný přehled, který zobrazuje podrobné údaje o prodejích za zvolené časové období. ![Souhrn prodejů](_static/microsoft-power-bi/Sales_summary.png) Pro všechny karty v přehledu je k dispozici několik filtračních polí – zde a dále jim budeme říkat obecné filtry. > [!TIP] > > Každý prvek přehledu, ať už jde o tabulku, graf nebo diagram, je interaktivní a může sloužit jako další filtr pro celkový souhrn informací. Přehled Souhrn prodejů má několik sekcí neboli „karet“, které zobrazují různé informace o prodejích za zvolené časové období. - **Prodeje podle kategorie a produktu** (Sales by Category and Product) – Tato tabulka zobrazuje informace o tom, kolik produktů se prodalo v jednotlivých kategoriích. Přehled poskytuje celkový obraz prodejů. - **Nejprodávanější** (Bestsellers) – Tabulka zobrazuje produkty s nejvyšší částkou prodejů. Můžete také změnit pořadí řazení a zobrazit nejprodávanější produkty podle počtu prodejů. - **Prodeje podle zákazníků** (Sales by customers) – Přehled poskytuje představu o tom, kteří zákazníci nakupují nejvíce. - **Množství a prodeje podle měsíců** (Quantity and sales by month) – Tento graf ukazuje, jak byly prodeje rozloženy v čase. Sleduje se nejen výše tržeb, ale také počet prodaných kusů zboží. Prodeje podle dne v týdnu ![Prodeje podle dne v týdnu](_static/microsoft-power-bi/Sales_by_Days.png) Přehled zobrazuje rozložení prodejů podle dnů v týdnu. To může být užitečné při plánování prodejů nebo jednorázových slev. ### Historie prodejů ![Historie prodejů](_static/microsoft-power-bi/Sales_History.png) Tento přehled umožňuje analyzovat historii prodejů jednotlivého produktu i celé kategorie za celou dobu existence obchodu. Tyto informace jsou užitečné při studiu poptávky po určitém zboží a signalizují, zda zvolený produkt nevykazuje tendenci zastarávat nebo vycházet z módy. ### Prodeje podle dodací adresy ![Prodeje podle dodací adresy](_static/microsoft-power-bi/Sales_by_Shipping_Address.png) Pokud vás zajímá geografie odesílání vašeho zboží, tento přehled poskytuje poměrně podrobný popis toho, kolik produktů bylo za zvolené období odesláno do konkrétních míst. ### Průměrná hodnota objednávky ![Průměrná hodnota objednávky](_static/microsoft-power-bi/Average_order_value.png) Přehled pomáhá odhadnout průměrnou cenu objednávky podle kategorie, regionu a dodavatele. Tyto informace mohou být užitečné při posuzování kupní síly zákazníků z různých regionů a pochopení toho, kteří dodavatelé tento ukazatel ovlivňují. ### Přehled objednávek ![Přehled objednávek](_static/microsoft-power-bi/Orders_overview.png) Přehled se skládá z několika sekcí, podívejme se na každou z nich: - **Celková částka objednávek podle role zákazníka** (Order Total by Customer role) – Graf zobrazuje rozložení objednávek podle rolí uživatelů. Mějte však na paměti, že uživatel může mít několik rolí, a proto se informace o objednávkách zobrazí pro každou roli daného uživatele. Ve výše uvedeném příkladu jsou administrátoři zároveň registrovanými uživateli, takže se jejich objednávky zobrazují v obou souhrnech. - **Prodeje podle kategorií** (Sales by Categories) – Tento přehled umožňuje vyhodnotit podíl kategorií produktů na prodejích. - **Prodeje a počet objednávek podle roku a měsíce** (Sales and Number of orders by Year and Month) – Tento graf je pomocný a pomáhá pochopit dynamiku růstu prodejů v několika časových obdobích. Tyto informace lze využít k analýze sezónních prodejů určité kategorie produktů. Objednávky podle stavu ![Objednávky podle stavu](_static/microsoft-power-bi/Orders_by_status.png) Tento přehled je určen k zobrazení rozložení objednávek podle jejich stavů. To je důležité pro pochopení toho, kolik objednávek se za zvolené období zpracovává, kolik z nich již bylo zaplaceno a kolik bylo dokončeno. ### Měsíční výkonnost ![Měsíční výkonnost](_static/microsoft-power-bi/Monthly_performance.png) Přehled shromažďuje informace o prodejích za zvolený měsíc v porovnání s předchozím měsícem. Obchodníci tak mohou sledovat nejvýkonnější a nejméně výkonné produkty ve srovnání s předchozím měsícem. - **Celková částka objednávek podle kategorie** (Order Total by Category) – Přehled shromažďuje všechny prodeje produktů podle kategorií za zvolený měsíc a porovnává je s předchozím měsícem. - **Nejvýkonnější produkty** (Best performing products) – Přehled zahrnuje pouze ty produkty, jejichž prodeje v aktuálním měsíci převýšily prodeje v předchozím měsíci. - **Méně výkonné produkty** (Underperforming products) – Přehled zahrnuje pouze ty produkty, jejichž prodeje v aktuálním měsíci byly nižší než v předchozím měsíci. ### Meziroční srovnání ![Meziroční srovnání](_static/microsoft-power-bi/Year_to_year_comparison.png) Přehled umožňuje porovnat prodeje za daný rok s prodeji v předchozím roce. Zajímavou funkcí je implementace kumulativního grafu prodejů. Ten vám umožní analyzovat dynamiku tvorby zisku a předpovídat růst prodejů do budoucna. ### Nejlepší produkty ![Nejlepší produkty](_static/microsoft-power-bi/Top_products.png) Přehled umožňuje identifikovat lídry prodejů v zadané kategorii. Data se analyzují za celou historii prodejů. Přehled se skládá z několika sekcí, podívejme se na každou z nich: - **Nejlepší produkty podle celkové částky objednávek** (Top Products by Order Total) – Tento graf zobrazuje hodnocení produktů na základě celkové částky objednávek. - **Nejlepší produkty podle počtu objednávek** (Top Products by Number of Orders) – Graf řadí produkty sestupně podle počtu objednávek. Pomáhá vám sledovat nejčastěji objednávané produkty. - **Nejlepší produkty podle množství** (Top Products by Quantity) – Tento graf zobrazuje hodnocení produktů, které byly zakoupeny ve velkém množství. - **Nejlepší produkty podle počtu zákazníků** (Top Products by Customers Count) – Graf znázorňuje, kolik lidí zakoupilo konkrétní produkt. Hodnocení produktů se sestavuje bez ohledu na opakované nákupy od stejného kupujícího. Tímto způsobem můžete oslovit publikum, které se o produkt zajímá. - **Seznam produktů** (Product list) – Tento souhrnný přehled zobrazuje všechny předchozí grafy v tabulce. ### Posledních 20 objednávek ![Posledních 20 objednávek](_static/microsoft-power-bi/Latest_20_orders.png) Přehled umožňuje sledovat informace o posledních 20 objednávkách. Pro administrátora to může být pohodlný nástroj ke sledování aktuálního vytížení obchodu. ### Zákazníci ![Zákazníci](_static/microsoft-power-bi/Customers.png) Informace o počtu registrovaných uživatelů a o částce a počtu jejich objednávek. Přehled lze sestavit v závislosti na stavu objednávky, zásilky nebo plateb, a to vše lze zobrazit za zvolené časové období. ### Rozšířené vyhledávání produktů ![Rozšířené vyhledávání produktů](_static/microsoft-power-bi/Advanced_product_search.png) Přehled, který poskytuje možnost rozšířeného vyhledávání produktů. ## Instalace pluginu Tato část popisuje, jak integrovat službu Power BI do vašeho obchodu. 1. [Zakupte integraci](https://www.nopcommerce.com/microsoft-power-bi). 1. Stáhněte archiv pluginu. 1. Přejděte do administrace > Konfigurace > Lokální pluginy (configuration > local plugins). 1. Nahrajte archiv pluginu pomocí funkce „Nahrát plugin nebo šablonu“ (Upload plugin or theme). 1. Posuňte se v seznamu pluginů dolů a najděte nově nainstalovaný plugin. Kliknutím na tlačítko „Instalovat“ (Install) plugin nainstalujte. ## Předběžná konfigurace Níže jsou popsány nezbytné a postačující kroky k nastavení integrace Power BI s nopCommerce. 1. [Zaregistrujte se](https://app.powerbi.com/singleSignOn) nebo [se přihlaste](https://app.powerbi.com/home) ke službě Power BI. Účet musí být firemním účtem vaší společnosti. ### Power BI Gateway 1. [Nainstalujte](https://powerbi.microsoft.com/en-us/gateway/) standardní bránu **Power BI Gateway**. ![Instalace brány](_static/microsoft-power-bi/Install_Gateway.png) 1. Spusťte **bránu (Gateway)** – spusťte aplikaci **On-premises data gateway**. 1. Zadejte e-mailovou adresu svého účtu, kterou jste použili při registraci ke službě Power BI. > [!NOTE] > > Váš účet je uložen v tenantu **Azure AD**. ![On-premises data gateway](_static/microsoft-power-bi/OnPremisses_data_gateway.png) 1. Vyberte možnost **Register a new gateway on this computer** ![Registrace brány](_static/microsoft-power-bi/Register_Gateway.png) 1. Zadejte název brány. Název musí být v rámci klienta jedinečný. Zadejte také obnovovací klíč. Tento klíč budete potřebovat k obnovení nebo přesunu brány. ![Název brány](_static/microsoft-power-bi/Gateway_name.png) 1. Zkontrolujte, zda je brána připravena k použití. ![Kontrola brány](_static/microsoft-power-bi/Check_Gateway.png) ### Registrace aplikace Registrací aplikace v Microsoft Entra se vytvoří vztah důvěryhodnosti mezi vaší aplikací a platformou identit Microsoftu. Při vytváření registrace aplikace postupujte takto: 1. Přihlaste se do [centra pro správu Microsoft Entra](https://entra.microsoft.com/). 1. Pokud máte přístup k více tenantům, přepněte se pomocí ikony *Nastavení* (Settings) v horním menu do tenantu, ve kterém chcete aplikaci zaregistrovat. 1. Přejděte do **Identity > Applications > App registrations** a vyberte *New registration*. 1. Zadejte smysluplný **Název** (Name) aplikace. 1. V části **Supported account types** určete, kdo může aplikaci používat. Pro své aplikace doporučujeme vybrat *Accounts in this organizational directory only*. 1. Výběrem **Register** dokončete registraci aplikace. ![Azure portál](_static/microsoft-power-bi/register_app.png) 1. Zobrazí se stránka **Overview** aplikace. Poznamenejte si **Application (client) ID**, které jednoznačně identifikuje vaši aplikaci a používá se v nastavení pluginu při ověřování bezpečnostních tokenů, které aplikace přijímá od platformy identit Microsoftu. ![Azure portál](_static/microsoft-power-bi/app_id.png) > [!IMPORTANT] > > Nové registrace aplikací jsou ve výchozím stavu před uživateli skryté. Až budete připraveni, aby uživatelé aplikaci viděli na své stránce My Apps, můžete ji zpřístupnit. Chcete-li aplikaci zpřístupnit, přejděte v centru pro správu Microsoft Entra do **Identity > Applications > Enterprise applications** a vyberte aplikaci. Poté na stránce **Properties** nastavte **Visible to users?** na *Yes*. > ![Azure portál](_static/microsoft-power-bi/properties.png) 1. Udělte souhlas správce. Chcete-li přidat oprávnění k aplikaci Azure AD, postupujte takto: - Vlevo v části *Manage* vyberte **API permissions**. - Vyberte **Add a permission**. > ![Azure portál](_static/microsoft-power-bi/request_api.png) - V okně Request API permissions vyberte Power BI Service. - Vyberte **Delegated permissions**. Zobrazí se seznam rozhraní API. > ![Azure portál](_static/microsoft-power-bi/delegated_permission.png) - Rozbalte rozhraní API, ke kterému chcete přidat oprávnění, a vyberte oprávnění, která chcete přidat. - Vyberte **Add permissions**. > ![Azure portál](_static/microsoft-power-bi/all_permission.png) 1. Vlevo v části Manage vyberte **Authentication**. 1. V **Advanced settings** > **Allow public client flows** > **Enable the following mobile and desktop flows:** vyberte **Yes**. > ![Povolení toků veřejných klientů](_static/microsoft-power-bi/Allow_public_client_flows.png) 1. Přejděte na konfigurační stránku pluginu a vložte získané **Application ID**. > [!WARNING] > > Publikování přehledu je možné pouze v případě, že používáte databázi MSSQL. Konfigurace připojení k jiným typům databází nejsou v současné době podporovány. ## Publikování přehledů V této části se podíváme na proces publikování přehledu do Power BI. Pokud neplánujete měnit obsah přehledu ani upravovat jeho datový model, stačí tento postup provést pouze jednou. Poté bude integrace vašeho obchodu se službou Power BI trvalá. Stačí pouze aktualizovat data, a to buď podle plánu, nebo ručně ze svého účtu Power BI. Poté budete mít k dispozici všechny přehledy popsané v tomto článku. 1. Musíte zadat název, pod kterým bude přehled nahrán do služby Power BI. Datová sada (Dataset) bude pojmenována obdobně. ![Publikování PBIX](_static/microsoft-power-bi/Publish-PBIX.png) 1. Dále se vygeneruje ověřovací kód pro ověření uživatele. Ve výchozím stavu se zkopíruje do schránky, abyste jej mohli později vložit. Klikněte na tlačítko **Ověřit uživatele** (Verify user). ![Ověření](_static/microsoft-power-bi/Verify.png) 1. Vložte získaný kód do vyskakovacího okna. ![Zadání kódu](_static/microsoft-power-bi/Enter_code.png) 1. Dále vyberte svůj účet v Power BI. ![Výběr účtu](_static/microsoft-power-bi/Pick_an_account.png) 1. Dále potvrďte, že se připojujete ke své aplikaci v Power BI. Klikněte na **Continue**. ![Potvrzení připojení](_static/microsoft-power-bi/Confirm_connect.png) 1. Pokud jste se do aplikace úspěšně přihlásili, zobrazí se následující okno. Počkejte, až se samo zavře. ![Přihlášeno na zařízení](_static/microsoft-power-bi/Signed_on_device.png) 1. V tomto kroku máte možnost přepsat existující přehled v Power BI pod již existujícím názvem. V takovém případě se zobrazí následující zpráva: ![Nahrazení datové sady](_static/microsoft-power-bi/Replacing_dataset.png) 1. Dále je potřeba vybrat, která brána se má použít ke komunikaci s daty. Vyberte bránu, kterou jste vytvořili dříve. ![Výběr brány](_static/microsoft-power-bi/Select_gateway.png) 1. Poté bude soubor přehledu publikován. ![Publikování dokončeno](_static/microsoft-power-bi/Publish_complete.png) 1. Nyní můžete na panelu nastavení datové sady nastavit plán obnovování dat pro svůj přehled. ![Plán obnovování](_static/microsoft-power-bi/Refresh_schedule.png) ## Řešení problémů ### Problém – The request body must contain the following parameter: 'client_assertion' or 'client_secret' Pokud se během procesu autorizace aplikace setkáte s touto chybou, vyřešíte ji provedením několika níže popsaných kroků: 1. V [centru pro správu Microsoft Entra](https://entra.microsoft.com/) vyberte svou aplikaci v **App registrations** a poté vyberte **Authentication**. 1. V **Settings** > **Allow public client flows** vyberte **Enabled**. ![Povolení toků veřejných klientů](_static/microsoft-power-bi/Allow_public_client_flows.png) ### Kontrola správného připojení a nastavení (v případě problémů) - Chcete-li ověřit, že je brána správně připojena ke zdroji dat, můžete zkontrolovat stav připojení v sekci **Manage connections and gateways**. ![Správa připojení a bran](_static/microsoft-power-bi/Manage_connections_and_gateways.png) - Připojení k bráně Je potřeba se ujistit, že je brána propojena s vaším serverem. Název počítače je uveden ve sloupci „Device“. ![Připojení k bráně](_static/microsoft-power-bi/Connecting_to_the_gateway.png) - Připojení k databázi ![Připojení k databázi](_static/microsoft-power-bi/Connecting_to_the_database.png) Můžete zkontrolovat své připojení a to, na jaký server a databázi je nakonfigurováno. ![Připojení brány](_static/microsoft-power-bi/Connection_Gateway.png) - (Volitelné) Chcete-li ověřit, že je propojení dat s nastavením brány správné, přihlaste se ke svému účtu Power BI a otevřete nastavení datové sady. ![Nastavení datové sady](_static/microsoft-power-bi/Dataset_settings.png) - Zkontrolujte připojení k bráně v rozbalovacím seznamu: Pokud je ve sloupci stavu uvedeno „Running on [Your_Server_Name]“, je připojení k bráně nakonfigurováno správně. Podrobnosti můžete zkontrolovat ve sloupci „Actions“. ![Kontrola připojení k bráně](_static/microsoft-power-bi/Check_gateway_connection.png) ## Zobrazení přehledů Publikované přehledy lze zobrazit několika způsoby: 1. Přímo ve vašem účtu Power BI na [záložce](https://app.powerbi.com/groups/me/list?experience=power-bi) **My Workspace**. 1. Přímo na konfigurační stránce pluginu Power BI na panelu **Zobrazit přehledy** (View reports) pomocí Power BI embedded analytics. Podívejme se blíže na druhý scénář, protože je součástí integrace. > [!TIP] > > Více informací o [Power BI embedded analytics](https://learn.microsoft.com/en-us/power-bi/developer/embedded/embedded-analytics-power-bi). Postup zobrazení přehledů je podobný postupu publikování. Po úspěšném ověření uživatele budou na panelu **Zobrazit přehledy** (View reports) pluginu k dispozici všechny přehledy z vašeho Workspace. > [!WARNING] > > Při každém zobrazení přehledů musíte projít procesem autorizace uživatele, protože služba Power BI vydává přístupový token pouze na omezenou dobu. > ![Seznam přehledů](_static/microsoft-power-bi/Report_list.png) Výchozí měnou je *americký dolar*. Z technických důvodů integrace nepoužívá hlavní měnu obchodu, a pokud je potřeba ji v přehledech změnit, je nutné to provést ručně. Chcete-li změnit měnu, musíte upravit formát všech číselných ukazatelů v mírách (measures). ![Měna](_static/microsoft-power-bi/Currency.png) Ve výchozím stavu je formát měny nastaven na „*Currency General*“, což by mělo zajistit přeformátování měn při změně regionálního nastavení přehledu. ## Licence Plugin Power BI je licencován za následujících [podmínek](https://www.nopcommerce.com/microsoft-power-bi-license-terms). --- <!-- page: Správa systému | url: http://nopdocs.service.hedr.dev/cs/running-your-store/system-administration/index.html | source: cs/running-your-store/system-administration/index.md --> # Správa systému Tato kapitola pokrývá technické aspekty provozu obchodu nopCommerce. Popisuje, jak rozšířit funkčnost obchodu technickými prostředky, jako jsou další externí pluginy, externí ověřování pro snazší průchod pokladnou, konfigurace widgetů a nastavení e-mailových účtů. Tato kapitola se zaměřuje spíše na back end; front end je popsán v kapitole [Design](xref:cs/getting-started/design-your-store/index). ## Viz zde * [Informace o systému](xref:cs/running-your-store/system-administration/system-information) * [Protokol](xref:cs/running-your-store/system-administration/log) * [Varování](xref:cs/running-your-store/system-administration/warnings) * [Údržba](xref:cs/running-your-store/system-administration/maintenance) * [Fronta zpráv](xref:cs/running-your-store/system-administration/message-queue) * [Naplánované úlohy](xref:cs/running-your-store/system-administration/schedule-tasks) * [Šablony](xref:cs/running-your-store/system-administration/templates) --- <!-- page: Informace o systému | url: http://nopdocs.service.hedr.dev/cs/running-your-store/system-administration/system-information.html | source: cs/running-your-store/system-administration/system-information.md --> # Informace o systému Následující postup popisuje, jak zobrazit systémové informace o obchodu a systémovém serveru. Chcete-li zobrazit informace o systému, přejděte do nabídky **Systém** (System) a vyberte **Informace o systému** (System Information). Okno *Informace o systému* se zobrazí následovně: ![Informace o systému](_static/system-information/system-information.png) --- <!-- page: Protokol | url: http://nopdocs.service.hedr.dev/cs/running-your-store/system-administration/log.html | source: cs/running-your-store/system-administration/log.md --> # Protokol Systémový protokol zobrazuje seznam všech chyb, varování a informačních zpráv vytvořených v systému. Chcete-li zobrazit protokol, přejděte do **Systém → Protokol** (System → Log). Zobrazí se okno *Protokol* (Log) takto: ![Protokol](_static/log/log.png) Položka protokolu obsahuje typ protokolu, popis chyby a datum. Kliknutím na tlačítko **Smazat vybrané** (Delete selected) odstraníte vybrané položky protokolu, kliknutím na tlačítko **Vymazat protokol** (Clear log) vymažete celý protokol. Chcete-li vyhledávat v systémovém protokolu, zadejte jeden nebo více z následujících údajů: * V poli **Vytvořeno od** (Created from) vyberte počáteční datum vyhledávání. * V poli **Vytvořeno do** (Created to) vyberte koncové datum vyhledávání. * Do pole **Zpráva** (Message) zadejte zprávu nebo její část, podle které chcete vyhledávat. * V rozevíracím seznamu **Úroveň protokolu** (Log level) vyberte typ informací protokolu, které se mají zobrazit: * *Vše* (All) * *Ladění* (Debug) * *Informace* (Information) * *Varování* (Warning) * *Chyba* (Error) * *Kritická chyba* (Fatal) Klikněte na **Hledat** (Search). Okno systémového protokolu se zobrazí podle zadaných kritérií vyhledávání. ## Zobrazení detailů systémového protokolu Kliknutím na **Zobrazit** (View) se zobrazí další podrobnosti o chybě, ke které došlo: ![Záznam protokolu - Detaily](_static/log/log-details.jpg) V případě potřeby můžete kliknutím na **Smazat** (Delete) odstranit záznam protokolu ze systému. --- <!-- page: Varování | url: http://nopdocs.service.hedr.dev/cs/running-your-store/system-administration/warnings.html | source: cs/running-your-store/system-administration/warnings.md --> # Varování Následující postup popisuje, jak zobrazit všechna varování, která v obchodě aktuálně existují. Chcete-li zobrazit varování obchodu, přejděte do **Systém → Varování** (System → Warnings). Zobrazí se okno *Varování*: ![Varování](_static/warnings/warnings.jpg) Doporučujeme všechna existující varování opravit. Jinak budou mít vliv na efektivitu a výkon vašeho obchodu. K opravě existujících varování využijte následující články: * [Informace o vašem obchodě](xref:cs/getting-started/advanced-configuration/your-store-information) * [Měny](xref:cs/getting-started/configure-payments/advanced-configuration/currencies) * [Měrné jednotky](xref:cs/getting-started/configure-shipping/advanced-configuration/measures) * [Platební metody](xref:cs/getting-started/configure-payments/payment-methods/index) * [Pluginy v nopCommerce](xref:cs/getting-started/advanced-configuration/plugins-in-nopcommerce) --- <!-- page: Údržba | url: http://nopdocs.service.hedr.dev/cs/running-your-store/system-administration/maintenance.html | source: cs/running-your-store/system-administration/maintenance.md --> # Údržba V menu **Systém** (System) vyberte **Údržba** (Maintenance). ## Odstranění záznamů zákazníků typu host ![Údržba](_static/maintenance/deleting_guest_customers.png) V panelu *Odstranění zákazníků typu host* (Deleting guest customers) klikněte na tlačítko **Odstranit** (Delete). Tato možnost umožňuje odstranit záznamy zákazníků vytvořené pro návštěvníky, kteří jsou hosty. > [!NOTE] > > Odstraněni budou pouze hosté bez objednávek a bez obsahu vytvořeného zákazníkem (například recenzí produktů nebo komentářů k novinkám). ## Odstranění starých exportovaných souborů ![Údržba](_static/maintenance/old_export.png) V panelu *Odstranění starých exportovaných souborů* (Deleting old exported files) klikněte na tlačítko **Odstranit**. Všechny exportované a vygenerované soubory (například soubory PDF a Excel) budou smazány a odstraněny z databáze. ## Odstranění opuštěných nákupních košíků a seznamů přání ![Údržba](_static/maintenance/deleting_abandoned_sc.png) V panelu *Odstranění opuštěných nákupních košíků* (Deleting abandoned shopping carts) klikněte na tlačítko **Odstranit**. Všechny položky nákupních košíků a seznamů přání vytvořené před zadaným datem budou odstraněny. ## Přeindexování databázových tabulek ![Údržba](_static/maintenance/re-index.png) V panelu *Přeindexování databázových tabulek* (Re-index database tables) klikněte na tlačítko **Přeindexovat** (Re-index). Tento postup upravuje existující tabulky přestavěním indexu. Při přeindexování tabulky se aktualizují pouze statistiky spojené s indexy. Automatické nebo ruční statistiky vytvořené v tabulce (místo indexu) se neaktualizují. ## Zálohy databáze ![Údržba](_static/maintenance/db_backup.png) V panelu *Zálohy databáze* (Database backups) klikněte na tlačítko **Zálohovat nyní** (Backup now) a vytvořte zálohu databáze. > [!NOTE] > > Funkce zálohování databáze funguje pouze tehdy, je-li aplikace nopCommerce nasazena na stejném serveru jako databáze. V opačném případě se o zálohování musíte postarat sami (kontaktujte správce systému). ## Odstranění již odeslaných e-mailů ![Údržba](_static/maintenance/delete_already_sent_emails.png) ## Odstranění minifikovaných souborů ![Údržba](_static/maintenance/delete_min_files.png) ## Zmenšení databáze ![Údržba](_static/maintenance/shrink.png) ## Odstranění náhledů obrázků ![Údržba](_static/maintenance/delete_image_thumbs.png) ## Vymazání historie vyhledávání ![Údržba](_static/maintenance/clear_search_history.png) ## Návody [Přehled možností údržby systému](https://www.youtube.com/watch?v=CNgTJZoWHTA) --- <!-- page: Fronta zpráv | url: http://nopdocs.service.hedr.dev/cs/running-your-store/system-administration/message-queue.html | source: cs/running-your-store/system-administration/message-queue.md --> # Fronta zpráv V nopCommerce se e-maily neodesílají okamžitě. Jsou zařazovány do fronty. Fronta zpráv obsahuje všechny e-maily, které již byly odeslány nebo dosud odeslány nebyly. Chcete-li načíst frontu zpráv, vyberte v nabídce **Systém** (System) položku **Fronta zpráv** (Message queue). Zobrazí se okno *Fronta zpráv*: ![Fronta zpráv](_static/message-queue/message-queue.png) Zadejte jedno nebo více z následujících kritérií pro vyhledání zpráv: * V poli **Datum od** (Start date) vyberte počáteční datum. * V poli **Datum do** (End date) vyberte koncové datum. * Do pole **Adresa odesílatele** (From address) zadejte zdrojovou adresu zprávy. * Do pole **Adresa příjemce** (To address) zadejte cílovou adresu zprávy. * Zaškrtněte políčko **Načíst pouze neodeslané e-maily** (Load not sent emails only), chcete-li načíst pouze e-maily, které ještě nebyly odeslány. * Do pole **Maximální počet pokusů o odeslání** (Maximum send attempts) zadejte maximální počet pokusů o odeslání zprávy. * Do pole **Přejít přímo na e-mail č.** (Go directly to email #) zadejte číslo e-mailu a klikněte na **Přejít** (Go), čímž zobrazíte požadovaný e-mail. Kliknutím na **Hledat** (Search) načtete frontu zpráv odpovídající zadaným kritériím. Na této stránce můžete kliknutím na tlačítko **Smazat vybrané** (Delete selected) odstranit vybrané e-maily z tabulky. Kliknutím na **Smazat vše** (Delete all) odstraníte všechny e-maily. ## Podrobnosti položky fronty zpráv Chcete-li zobrazit podrobnosti položky fronty zpráv, klikněte na tlačítko **Upravit** (Edit) vedle zprávy. Zobrazí se okno *Upravit položku fronty zpráv*: ![Podrobnosti položky fronty zpráv](_static/message-queue/edit.png) V tomto okně můžete zprávu odstranit kliknutím na tlačítko **Smazat** (Delete). Nebo můžete zprávu znovu zařadit do fronty pomocí tlačítka **Znovu zařadit do fronty** (Requeue). Na této stránce můžete upravit následující podrobnosti zprávy: * E-mailovou adresu **Od** (From). * **Jméno odesílatele** (From name). * E-mailovou adresu **Komu** (To). * **Jméno příjemce** (To name). * E-mailovou adresu **Odpovědět komu** (ReplyTo). * **Jméno pro odpověď** (ReplyTo name). * E-mailovou adresu **Kopie** (Cc). * E-mailovou adresu **Skrytá kopie** (Bcc). * **Předmět** (Subject) e-mailové zprávy. * **Tělo** (Body) e-mailové zprávy. * Zaškrtněte políčko **Odeslat okamžitě** (Send immediately), chcete-li tuto zprávu odeslat okamžitě. * Zadejte **Počet pokusů o odeslání** (Sent attempts). Jde o počet pokusů o odeslání této zprávy. Kliknutím na **Uložit** (Save) nebo **Uložit a pokračovat v úpravách** (Save and continue edit) uložíte podrobnosti zprávy. --- <!-- page: Plánované úlohy | url: http://nopdocs.service.hedr.dev/cs/running-your-store/system-administration/schedule-tasks.html | source: cs/running-your-store/system-administration/schedule-tasks.md --> # Plánované úlohy Okno *Plánované úlohy* (Schedule tasks) umožňuje majiteli obchodu naplánovat úlohu tak, aby se v určitých intervalech spouštěla na pozadí, a zobrazit užitečné informace o úloze a o tom, zda byla úspěšně dokončena. nopCommerce například pravidelně odesílá e-maily ve frontě. Úlohy běží v samostatném vlákně z fondu vláken ASP.NET. Chcete-li zobrazit plánované úlohy, vyberte v menu **Systém** (System) položku **Plánované úlohy** (Schedule tasks). Zobrazí se okno *Plánované úlohy*: ![Plánované úlohy](_static/schedule-tasks/schedule-tasks.png) Chcete-li plánovanou úlohu upravit, klikněte na tlačítko **Upravit** (Edit) vedle úlohy. Okno se rozbalí takto: ![Plánované úlohy – úprava](_static/schedule-tasks/schedule-tasks-edit.png) Plánovanou úlohu můžete upravit takto: * Upravte **Název** (Name). * Upravte počet **Sekund (interval spouštění)** (Seconds (run period)). Interval úlohy by neměl přesáhnout 24 dní. * Zaškrtnutím políčka **Povoleno** (Enabled) úlohu povolíte. * Zaškrtnutím políčka **Zastavit při chybě** (Stop on error) se úloha při výskytu chyby zastaví. Kliknutím na **Aktualizovat** (Update) uložíte změny. > [!NOTE] > > Po úpravě úlohy nezapomeňte restartovat aplikaci. V případě potřeby můžete kliknutím na **Spustit nyní** (Run now) spustit plánovanou úlohu na vyžádání. --- <!-- page: Šablony | url: http://nopdocs.service.hedr.dev/cs/running-your-store/system-administration/templates.html | source: cs/running-your-store/system-administration/templates.md --> # Šablony V nopCommerce můžete pro kategorii, výrobce, produkt a stránku (topic) určit alternativní šablonu rozvržení. Seznam existujících šablon najdete na stránce **Systém → Šablony** (System → Templates): ![Šablony](_static/templates/templates.jpg) Ve výchozím stavu je v systému jedna šablona kategorie, jedna šablona výrobce, jedna šablona stránky (topic) a dvě šablony produktu. Každá stránka s podrobnostmi kategorie, výrobce, produktu a stránky (topic) v administraci umožňuje při úpravě entity zvolit šablonu. Například: ![Šablony kategorií](_static/templates/category-templates.jpg) > [!NOTE] > > Rozbalovací seznam šablon uvidíte pouze tehdy, pokud máte pro kategorie, výrobce a stránky (topics) vytvořeno více než jednu šablonu. > > [!NOTE] > > Protože máme dva typy produktů, *Jednoduchý* (Simple) a *Seskupený (produkt s variantami)* (Grouped (product with variants)), máme ve výchozím stavu vytvořeny dvě odpovídající šablony produktu: > ![Seznam šablon produktu](_static/templates/product-templates-list.jpg) > > Abyste tedy na stránce s podrobnostmi produktu viděli rozbalovací seznam šablon, musíte vytvořit dvě šablony produktu, které odpovídají zvolenému typu produktu. Jak to udělat, se dočtete níže. ## Přidání nové šablony Podívejme se, jak vytvořit šablonu, na příkladu šablony produktu. Řekněme, že ji chcete vytvořit pro typ produktu *Jednoduchý*. 1. Nejprve je třeba vytvořit odpovídající soubor šablony. Tento krok přeskočte, pokud již máte soubor umístěný ve správné složce. - Přejděte do složky `Views\Product`. - Zkopírujte soubor `ProductTemplate.Simple.cshtml` a přejmenujte jej. Řekněme, že to bude `ProductTemplate.MyNewOne.cshtml`. - Upravte kód souboru `ProductTemplate.MyNewOne.cshtml` podle svých potřeb. 1. Přejděte na stránku **Systém → Šablony** (System → Templates) a pokračujte na panel *Šablony produktu* (Product templates): ![Vytvoření šablony produktu](_static/templates/product-templates-with-form.jpg) 1. V bloku *Přidat nový záznam* (Add new record) vyplňte následující formulář: - Zadejte **Název** (Name) šablony. V našem případě je to `My New One`. - Zadejte **Cestu k view** (View path). V našem případě je to `ProductTemplate.MyNewOne`. - Zadejte **Pořadí zobrazení** (Display order) této šablony. 1 představuje začátek seznamu. - *Pouze pro šablonu produktu. Neplatí pro ostatní šablony:* Zadejte **Ignorovaná ID typů produktu (pokročilé)** (Ignored product type IDs (advanced)). Ve výchozím stavu máme dva typy produktů a odpovídající ID typů produktu: *Jednoduchý* (ID 5) a *Seskupený* (ID 10). Protože vytváříme šablonu pro typ produktu *Jednoduchý*, měli bychom ignorovat typ produktu *Seskupený* s ID 10. Formulář tedy bude vypadat takto: ![Formulář](_static/templates/form.jpg) 1. Kliknutím na tlačítko **Přidat nový záznam** (Add new record) novou šablonu uložte. Po uložení nové šablony ji uvidíte na stránce s podrobnostmi produktu a nyní můžete volit ze dvou šablon produktu: ![Stránka s podrobnostmi produktu](_static/templates/choose.jpg) > [!NOTE] > > Omezovat šablonu produktu pomocí pole **Ignorovaná ID typů produktu (pokročilé)** (Ignored product type IDs (advanced)) není povinné. Pokud toto pole ponecháte prázdné, budete moci šablonu produktu používat pro všechny typy produktů. --- <!-- page: Příručka pro vývojáře | url: http://nopdocs.service.hedr.dev/cs/developer/index.html | source: cs/developer/index.md --> # Příručka pro vývojáře Vývojářská dokumentace nopCommerce vás provede procesem přizpůsobení nopCommerce. Najdete zde několik sekcí: * [Návody pro vývojáře](xref:cs/developer/tutorials/index) * [Vytvoření pluginu pro nopCommerce](xref:cs/developer/plugins/index) * [Příručka pro designéry](xref:cs/developer/design/index) * [Dokumentace Web API](xref:cs/developer/web-api/index) * [Dokumentace mobilní aplikace](xref:cs/developer/mobile-app/index) * [Microsoft Dynamics 365](xref:cs/developer/ms-dynamics-365/index) --- <!-- page: Návody pro vývojáře | url: http://nopdocs.service.hedr.dev/cs/developer/tutorials/index.html | source: cs/developer/tutorials/index.md --> # Návody pro vývojáře Následuje seznam častých otázek, které si kladou vývojáři pracující s nopCommerce. Popisuje také některá architektonická rozhodnutí, která tým nopCommerce učinil. * [Systémové požadavky pro vývoj](xref:cs/developer/tutorials/system-requirements-for-developing) * [Standardy kódování](xref:cs/developer/tutorials/coding-standards) * [Architektura nopCommerce](xref:cs/developer/tutorials/architecture-of-nopCommerce) * [Organizace zdrojového kódu](xref:cs/developer/tutorials/source-code-organization) * [Začínáme s vývojem pro nopCommerce](xref:cs/developer/tutorials/instruction-on-how-to-start-developing-on-nopcommerce) * [Výchozí schéma databáze](xref:cs/developer/tutorials/db-schema) * [Úprava existující entity (jak přidat novou vlastnost)](xref:cs/developer/tutorials/update-existing-entity) * [Migrace databáze](xref:cs/developer/tutorials/migrations) * [Inverze řízení a vkládání závislostí](xref:cs/developer/tutorials/inversion-of-control) * [Registrace nových rout](xref:cs/developer/tutorials/register-new-routes) * [Úvod do systému pluginů](xref:cs/developer/tutorials/description-of-plugin-system) * [Vývoj nového pluginu](xref:cs/developer/tutorials/guide-to-expanding-the-functionality-of-the-basic-functions-of-nop-commerce-through-a-plugin) * [Používání DataTables](xref:cs/developer/tutorials/guide-to-creating-a-page-containing-a-reporting-table-of-datatables) * [Validace dat](xref:cs/developer/tutorials/data-validation) * [Vyvolávání a zpracování událostí](xref:cs/developer/tutorials/events) * [API nastavení](xref:cs/developer/tutorials/settings) * [Nastavení v appsettings.json](xref:cs/developer/tutorials/appsettings-json-file) * [Nastavení ve web.config](xref:cs/developer/tutorials/description-of-the-web-config-file-in-project) * [Rozšíření oprávnění](xref:cs/developer/tutorials/permissions) * [Naplánované úlohy](xref:cs/developer/tutorials/scheduled-tasks) * [Rozhraní ITypeFinder](xref:cs/developer/tutorials/type-finder) * [Nasazení na Azure pomocí Gitu a automatických sestavení](xref:cs/developer/tutorials/azure-deploy) * [Používání Dockeru](xref:cs/developer/tutorials/docker) * [Nasazení nopCommerce na virtuální počítač Azure](xref:cs/developer/tutorials/azure-publish) * [Hlavičky Content Security Policy (CSP)](xref:cs/developer/tutorials/csp-headers) * [Jednotkové testy](xref:cs/developer/tutorials/unit-tests) --- <!-- page: Systémové požadavky pro vývoj | url: http://nopdocs.service.hedr.dev/cs/developer/tutorials/system-requirements-for-developing.html | source: cs/developer/tutorials/system-requirements-for-developing.md --> # Systémové požadavky pro vývoj ## Operační systém ### Windows | OS | Verze | | ----------------- | ---------------------------------------- | | Windows 11 | 26H1, 25H2, 24H2 (IoT), 24H2 (E), 24H2, 23H2 (E) | | Windows 10 Client | 21H2 (E), 21H2 (IoT), 1809 (E), 1607 (E) | | Windows Server | 2025, 23H2, 2022, 2019, 2016 | | Nano Server | 2025, 2022, 2019 | ### Linux | OS | Verze | | ---------------------------- | ------------------- | | Red Hat Enterprise Linux | 10, 9, 8 | | Fedora | 44, 43 | | Debian | 13 | | Ubuntu | 26.04, 24.04, 22.04 | | openSUSE Leap | 16.0 | | SUSE Enterprise Linux | 16.0, 15.7 | | Alpine Linux | 3.24, 3.23, 3.22, 3.21 | Ostatní distribuce jsou podporovány v rámci možností, podle [.NET Support and Compatibility for Linux Distributions](https://github.com/dotnet/core/blob/main/linux.md). ### Apple | OS | Verze | | -------- | ---------- | |iOS |27, 26, 18 | |iPadOS |27, 26, 18 | |macOS |27, 26, 15 | |tvOS |27, 26 | ### Android | OS | Verze | | -------- | ---------- | |Android |17, 16, 15, 14| > [!NOTE] > > Najděte úplný [seznam podporovaných operačních systémů](https://github.com/dotnet/core/blob/main/release-notes/10.0/supported-os.md). > > [!IMPORTANT] > > Operační systémy **Windows Client 7 SP1, 8.1** již počínaje .NET 7.0 nejsou podporovány. > > Další informace o podporovaných verzích OS najdete na [této stránce](https://github.com/dotnet/core/blob/main/release-notes/10.0/supported-os.md). ## Podporované prohlížeče * Microsoft Edge. Microsoft Internet Explorer 9 a novější (IE6 a IE7 byly podporovány ve verzích před 3.60, IE8 byl podporován ve verzích před 4.10) * Mozilla Firefox 2.0 a novější * Google Chrome 1.x a novější * Apple Safari 12.x a novější <a id="tools-required-for-development"></a> ## Nástroje potřebné pro vývoj Protože je nopCommerce založen na Microsoft .NET 10, musíme před zahájením vývoje nad nopCommerce nainstalovat několik nástrojů. ### .NET 10 runtime a .NET 10 SDK nopCommerce 5.00 je založen na .NET 10. Před zahájením vývoje v nopCommerce proto musíme nainstalovat [.NET 10 runtime](https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-aspnetcore-10.0.12-windows-x64-installer) a [.NET 10 SDK](https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/sdk-10.0.401-windows-x64-installer). ### Visual Studio 2026 (v18.0) nebo novější / Visual Studio Code Jak víme, nopCommerce je založen na „Microsoft .NET 10“ a *Visual Studio IDE* je pro vývoj aplikací založených na .NET nejvhodnější. Protože je .NET Core nezávislý na platformě, můžeme aplikace založené na .NET vyvíjet a nasazovat na libovolné platformě. Jako alternativu k *Visual Studiu* můžeme pro vývoj ve Windows i na jiných platformách použít *Visual Studio Code*. > [!NOTE] > > Pokud používáte *Visual Studio Code*, budete muset nainstalovat oficiální rozšíření pro C# od společnosti Microsoft **C# Dev Kit**. ### Microsoft SQL Server 2016 nebo novější / MySQL Server 8 nebo novější / PostgreSQL 15 nebo novější Od verze 4.30 používá nopCommerce jako ORM framework *Linq2DB*. *Linq2DB* je objektově-relační mapper (ORM), který vývojářům v .NET umožňuje pracovat s databází pomocí objektů .NET. Dokáže mapovat objekty .NET na celou řadu databázových poskytovatelů. Můžete si vybrat mezi MS SQL Serverem, MySQL Serverem a PostgreSQL. > [!NOTE] > > Další informace o podporovaných databázích najdete na [této stránce](https://linq2db.github.io/articles/general/databases.html) ### Internet Information Service (IIS) 7.0 nebo novější Jednou z možností hostování aplikace/projektu nopCommerce je IIS, technologie společnosti Microsoft, která hostuje webové aplikace ve Windows. nopCommerce však může běžet i na Linuxu a macOS, které IIS nepodporují. V takovém případě můžete k hostování aplikace na linuxovém serveru použít alternativní nástroje, jako je Apache nebo Nginx. --- <!-- page: Standardy psaní kódu | url: http://nopdocs.service.hedr.dev/cs/developer/tutorials/coding-standards.html | source: cs/developer/tutorials/coding-standards.md --> # Standardy psaní kódu nopCommerce má specifická pravidla pro psaní kódu, která by vývojáři měli při vytváření zdrojového kódu dodržovat. Soubor [.editorconfig](https://github.com/nopSolutions/nopCommerce/blob/develop/.editorconfig) ve Visual Studiu pomáhá požadovaný styl kódu vynucovat. Existují tři podporované kategorie konvencí psaní kódu v .NET: - Jazykové konvence - Konvence formátování - Konvence pojmenování ## Jazykové konvence ### Nastavení stylu kódu .NET #### Kvalifikátory „this.“ Toto pravidlo stylu lze použít na pole, vlastnosti, metody nebo události. - Upřednostňujte, aby prvek kódu *nebyl* uvozen pomocí `this.` - Upřednostňujte, aby pole *nebyla* uvozena pomocí `this.` ```csharp //Right capacity = 0; ``` ```csharp //Wrong this.capacity = 0; ``` - Upřednostňujte, aby vlastnosti *nebyly* uvozeny pomocí `this.` ```csharp //Right ID = 0; ``` ```csharp //Wrong this.ID = 0; ``` - Upřednostňujte, aby metody *nebyly* uvozeny pomocí `this.` ```csharp //Right Display(); ``` ```csharp //Wrong this.Display(); ``` - Upřednostňujte, aby události *nebyly* uvozeny pomocí `this.` ```csharp //Right Elapsed += Handler; ``` ```csharp //Wrong this.Elapsed += Handler; ``` #### Klíčová slova jazyka místo názvů typů frameworku pro odkazy na typy Toto pravidlo stylu lze použít na lokální proměnné, parametry metod a členy tříd nebo jako samostatné pravidlo na výrazy přístupu ke členům typu. - U typů, které mají své klíčové slovo, upřednostňujte pro lokální proměnné, parametry metod a členy tříd klíčové slovo jazyka namísto názvu typu. ```csharp //Right private int _member; ``` ```csharp //Wrong private Int32 _member; ``` - U typů, které mají své klíčové slovo, upřednostňujte ve výrazech přístupu ke členům klíčové slovo jazyka namísto názvu typu. ```csharp //Right var local = int.MaxValue; ``` ```csharp //Wrong var local = Int32.MaxValue; ``` #### Předvolby modifikátorů Pravidla stylu v této části se týkají předvoleb modifikátorů, včetně vyžadování modifikátorů přístupnosti, určení požadovaného pořadí modifikátorů a vyžadování modifikátoru jen pro čtení. - Upřednostňujte deklarování modifikátorů přístupnosti s výjimkou veřejných členů rozhraní. ```csharp //Right class MyClass { private const string thisFieldIsConst = "constant"; } ``` ```csharp //Wrong class MyClass { const string thisFieldIsConst = "constant"; } ``` - Upřednostňujte uvedené pořadí: *`public, private, protected, internal, static, extern, new, virtual, abstract, sealed, override, readonly, unsafe, volatile, async:silent`* ```csharp //Right class MyClass { private static readonly int _daysInYear = 365; } ``` #### Předvolby závorek Pravidla stylu v této části se týkají předvoleb závorek, včetně používání závorek u aritmetických, relačních a dalších binárních operátorů. - Upřednostňujte závorky pro vyjasnění priority aritmetických operátorů (*, /, %, +, -, <<, >>, &, ^, |) ```csharp //Right var v = a + (b * c); ``` ```csharp //Wrong var v = a + b * c; ``` - Upřednostňujte závorky pro vyjasnění priority relačních operátorů (>, <, <=, >=, is, as, ==, !=) ```csharp //Right var v = (a < b) == (c > d); ``` ```csharp //Wrong var v = a < b == c > d; ``` - Upřednostňujte závorky pro vyjasnění priority ostatních binárních operátorů (&&, ||, ??) ```csharp //Right var v = a || (b && c); ``` ```csharp //Wrong var v = a || b && c; ``` - Upřednostňujte vynechání závorek, pokud je priorita operátorů zřejmá ```csharp //Right var v = a.b.Length; ``` ```csharp //Wrong var v = (a.b).Length; ``` #### Předvolby na úrovni výrazů Pravidla stylu v této části se týkají předvoleb na úrovni výrazů, včetně používání inicializátorů objektů, inicializátorů kolekcí, explicitních nebo odvozených názvů prvků n-tic a odvozených anonymních typů. - Upřednostňujte inicializaci objektů pomocí inicializátorů objektů, pokud je to možné ```csharp //Right var c = new Customer() { Age = 21 }; ``` ```csharp //Wrong var c = new Customer(); c.Age = 21; ``` - Upřednostňujte inicializaci kolekcí pomocí inicializátorů kolekcí, pokud je to možné ```csharp //Right var list = new List<int> { 1, 2, 3 }; ``` ```csharp //Wrong var list = new List<int>(); list.Add(1); list.Add(2); list.Add(3); ``` - Upřednostňujte názvy prvků n-tic před vlastnostmi ItemX ```csharp //Right (string name, int age) customer = GetCustomer(); var name = customer.name; ``` ```csharp //Wrong (string name, int age) customer = GetCustomer(); var name = customer.Item1; ``` - Upřednostňujte odvozené názvy prvků n-tic ```csharp //Right var tuple = (age, name); ``` ```csharp //Wrong var tuple = (age: age, name: name); ``` - Upřednostňujte explicitní názvy členů anonymních typů ```csharp //Right var anon = new { age = age, name = name }; ``` ```csharp //Wrong var anon = new { age, name }; ``` - Upřednostňujte automatické vlastnosti před vlastnostmi s privátními podkladovými poli ```csharp //Right private int Age { get; } ``` ```csharp //Wrong private int age; public int Age { get { return age; } } ``` - Upřednostňujte kontrolu null pomocí porovnávání vzorů (pattern matching) před *`object.ReferenceEquals`* ```csharp //Right if (value is null) return; ``` ```csharp //Wrong if (object.ReferenceEquals(value, null)) return; ``` - Upřednostňujte přiřazení s ternárním podmíněným operátorem před příkazem if-else ```csharp //Right string s = expr ? "hello" : "world"; ``` ```csharp //Wrong string s; if (expr) { s = "hello"; } else { s = "world"; } ``` - Upřednostňujte v příkazech return ternární podmíněný operátor před příkazem if-else ```csharp //Right return expr ? "hello" : "world"; ``` ```csharp //Wrong if (expr) { return "hello"; } else { return "world"; } ``` - Upřednostňujte složené výrazy přiřazení ```csharp //Right x += 1; ``` ```csharp //Wrong x = x + 1; ``` #### Předvolby kontroly null Pravidla stylu v této části se týkají předvoleb kontroly null. - Upřednostňujte výrazy s operátorem nulového sjednocení (null coalescing) před kontrolou ternárním operátorem ```csharp //Right var v = x ?? y; ``` ```csharp //Wrong var v = x != null ? x : y; // or var v = x == null ? y : x; ``` - Upřednostňujte používání podmíněného operátoru null (null-conditional), pokud je to možné ```csharp //Right var v = o?.ToString(); ``` ```csharp //Wrong var v = o == null ? null : o.ToString(); // or var v = o != null ? o.String() : null; ``` ### Nastavení stylu kódu C# #### Implicitní a explicitní typy Pravidla stylu v této části se týkají používání klíčového slova var oproti explicitnímu typu v deklaraci proměnné. Toto pravidlo lze uplatnit samostatně na vestavěné typy, na případy, kdy je typ zřejmý, a jinde. - Upřednostňujte *`var`* při deklaraci proměnných s vestavěnými systémovými typy, jako je *`int`* ```csharp //Right var x = 5; ``` ```csharp //Wrong int x = 5; ``` - Upřednostňujte *`var`*, pokud je typ již uveden na pravé straně deklaračního výrazu ```csharp //Right var obj = new Customer(); ``` ```csharp //Wrong Customer obj = new Customer(); ``` - Upřednostňujte *`var`* před explicitním typem ve všech případech, pokud to nepřepíše jiné pravidlo stylu kódu ```csharp //Right var f = this.Init(); ``` ```csharp //Wrong bool f = this.Init(); ``` #### Členy s tělem ve formě výrazu Pravidla stylu v této části se týkají používání [členů s tělem ve formě výrazu](https://docs.microsoft.com/dotnet/csharp/programming-guide/statements-expressions-operators/expression-bodied-members), pokud se logika skládá z jediného výrazu. Toto pravidlo lze použít na metody, konstruktory, operátory, vlastnosti, indexery a přístupové metody. - Upřednostňujte bloková těla u metod ```csharp //Right public int GetAge() { return this.Age; } ``` ```csharp //Wrong public int GetAge() => this.Age; ``` - Upřednostňujte bloková těla u konstruktorů ```csharp //Right public Customer(int age) { Age = age; } ``` ```csharp //Wrong public Customer(int age) => Age = age; ``` - Upřednostňujte bloková těla u operátorů ```csharp //Right public static ComplexNumber operator + (ComplexNumber c1, ComplexNumber c2) { return new ComplexNumber(c1.Real + c2.Real, c1.Imaginary + c2.Imaginary); } ``` ```csharp //Wrong public static ComplexNumber operator + (ComplexNumber c1, ComplexNumber c2) => new ComplexNumber(c1.Real + c2.Real, c1.Imaginary + c2.Imaginary); ``` - Upřednostňujte těla ve formě výrazu u vlastností, pokud se vejdou na jeden řádek ```csharp //Right public int Age => _age; ``` ```csharp //Wrong public int Age { get { return _age; }} ``` - Upřednostňujte těla ve formě výrazu u indexerů ```csharp //Right public T this[int i] => _values[i]; ``` ```csharp //Wrong public T this[int i] { get { return _values[i]; } } ``` - Upřednostňujte těla ve formě výrazu u přístupových metod ```csharp //Right public int Age { get => _age; set => _age = value; } ``` ```csharp //Wrong public int Age { get { return _age; } set { _age = value; } } ``` - Upřednostňujte těla ve formě výrazu u lambda výrazů ```csharp //Right Func<int, int> square = x => x * x; ``` ```csharp //Wrong Func<int, int> square = x => { return x * x; }; ``` #### Porovnávání vzorů Pravidla stylu v této části se týkají používání [porovnávání vzorů (pattern matching)](https://docs.microsoft.com/dotnet/csharp/pattern-matching) v C#. - Upřednostňujte porovnávání vzorů namísto výrazů is s přetypováním ```csharp //Right if (o is int i) {...} ``` ```csharp //Wrong if (o is int) {var i = (int)o; ... } ``` - Upřednostňujte porovnávání vzorů namísto výrazů *`as`* s kontrolou null pro zjištění, zda je něco určitého typu ```csharp //Right if (o is string s) {...} ``` ```csharp //Wrong var s = o as string; if (s != null) {...} ``` #### Vložené deklarace proměnných Toto pravidlo stylu se týká toho, zda jsou proměnné out deklarovány přímo na místě (inline), nebo ne. Od C# 7 můžete [deklarovat proměnnou out v seznamu argumentů volání metody](https://docs.microsoft.com/dotnet/csharp/language-reference/keywords/out-parameter-modifier#calling-a-method-with-an-out-argument) namísto samostatné deklarace proměnné. - Upřednostňujte deklaraci proměnných *`out`* přímo v seznamu argumentů volání metody, pokud je to možné ```csharp //Right if (int.TryParse(value, out int i)) {...} ``` ```csharp //Wrong int i; if (int.TryParse(value, out i)) {...} ``` #### Předvolby C# na úrovni výrazů Toto pravidlo stylu se týká používání [literálu default pro výrazy výchozí hodnoty](https://docs.microsoft.com/dotnet/csharp/programming-guide/statements-expressions-operators/default-value-expressions#default-literal-and-type-inference), pokud kompilátor dokáže typ výrazu odvodit. - Upřednostňujte *`default`* před *`default(T)`* ```csharp //Right void DoWork(CancellationToken cancellationToken = default) { ... } ``` ```csharp //Wrong void DoWork(CancellationToken cancellationToken = default(CancellationToken)) { ... } ``` #### Předvolby C# pro kontrolu null Tato pravidla stylu se týkají syntaxe kolem kontroly null, včetně používání výrazů throw nebo příkazů throw a toho, zda při volání [lambda výrazu](https://docs.microsoft.com/dotnet/csharp/lambda-expressions) provést kontrolu null, nebo použít podmíněný operátor (?.). - Upřednostňujte výrazy throw namísto příkazů throw ```csharp //Right this.s = s ?? throw new ArgumentNullException(nameof(s)); ``` ```csharp //Wrong if (s == null) { throw new ArgumentNullException(nameof(s)); } this.s = s; ``` - Při volání lambda výrazu upřednostňujte podmíněný operátor (?.) namísto provádění kontroly null ```csharp //Right func?.Invoke(args); ``` ```csharp //Wrong if (func != null) { func(args); } ``` #### Předvolby bloků kódu Toto pravidlo stylu se týká používání složených závorek { } k ohraničení bloků kódu. - Upřednostňujte vynechání složených závorek, pokud je to povoleno ```csharp //Right if (test) this.Display(); ``` ```csharp //Wrong if (test) { this.Display(); } ``` ## Konvence formátování ### Nastavení formátování .NET ### Uspořádání direktiv using Tato pravidla formátování se týkají řazení a zobrazení direktiv *`using`* a příkazů *`Imports`*. - Direktivy *`using`* `System.*` řaďte abecedně a umisťujte je před ostatní direktivy using. ```csharp //Right using System.Collections.Generic; using System.Threading.Tasks; using Octokit; ``` ```csharp //Wrong using System.Collections.Generic; using Octokit; using System.Threading.Tasks; ``` - Mezi skupiny direktiv using nevkládejte prázdný řádek. ```csharp //Right using System.Collections.Generic; using System.Threading.Tasks; using Octokit; ``` ```csharp //Wrong using System.Collections.Generic; using System.Threading.Tasks; using Octokit; ``` ### Nastavení formátování C# Pravidla formátování v této části platí pouze pro kód C#. #### Možnosti nových řádků Tato pravidla formátování se týkají používání nových řádků k formátování kódu. - Vyžadujte, aby složené závorky byly u všech výrazů na novém řádku (styl „Allman“). ```csharp //Right void MyMethod() { if (...) { ... } } ``` ```csharp //Wrong void MyMethod() { if (...) { ... } } ``` - Příkazy else umisťujte na nový řádek. ```csharp //Right if (...) { ... } else { ... } ``` ```csharp //Wrong if (...) { ... } else { ... } ``` - Příkazy catch umisťujte na nový řádek. ```csharp //Right try { ... } catch (Exception e) { ... } ``` ```csharp //Wrong try { ... } catch (Exception e) { ... } ``` - Vyžadujte, aby příkazy finally byly na novém řádku za uzavírací složenou závorkou. ```csharp //Right try { ... } catch (Exception e) { ... } finally { ... } ``` ```csharp //Wrong try { ... } catch (Exception e) { ... } finally { ... } ``` - Vyžadujte, aby členy inicializátorů objektů byly na samostatných řádcích ```csharp //Right var z = new B() { A = 3, B = 4 } ``` ```csharp //Wrong var z = new B() { A = 3, B = 4 } ``` - Vyžadujte, aby členy anonymních typů byly na samostatných řádcích ```csharp //Right var z = new { A = 3, B = 4 } ``` ```csharp //Wrong var z = new { A = 3, B = 4 } ``` - Vyžadujte, aby prvky klauzulí dotazových výrazů byly na samostatných řádcích ```csharp //Right var q = from a in e from b in e select a * b; ``` ```csharp //Wrong var q = from a in e from b in e select a * b; ``` #### Možnosti odsazení Tato pravidla formátování se týkají používání odsazení k formátování kódu. - Odsazujte obsah větví *`switch`* case ```csharp //Right switch(c) { case Color.Red: Console.WriteLine("The color is red"); break; case Color.Blue: Console.WriteLine("The color is blue"); break; default: Console.WriteLine("The color is unknown."); break; } ``` ```csharp //Wrong switch(c) { case Color.Red: Console.WriteLine("The color is red"); break; case Color.Blue: Console.WriteLine("The color is blue"); break; default: Console.WriteLine("The color is unknown."); break; } ``` - Odsazujte návěští *`switch`* ```csharp //Right switch(c) { case Color.Red: Console.WriteLine("The color is red"); break; case Color.Blue: Console.WriteLine("The color is blue"); break; default: Console.WriteLine("The color is unknown."); break; } ``` ```csharp //Wrong switch(c) { case Color.Red: Console.WriteLine("The color is red"); break; case Color.Blue: Console.WriteLine("The color is blue"); break; default: Console.WriteLine("The color is unknown."); break; } ``` - Návěští se umisťují na stejné odsazení jako aktuální kontext ```csharp //Right class C { private string MyMethod(...) { if (...) { goto error; } error: throw new Exception(...); } } ``` ```csharp //Wrong class C { private string MyMethod(...) { if (...) { goto error; } error: throw new Exception(...); } } ``` ```csharp //Wrong class C { private string MyMethod(...) { if (...) { goto error; } error: throw new Exception(...); } } ``` #### Možnosti mezer Tato pravidla formátování se týkají používání mezer k formátování kódu. - Odstraňte mezeru mezi přetypováním a hodnotou ```csharp //Right int y = (int)x; ``` ```csharp //Wrong int y = (int) x; ``` - Za klíčové slovo v příkazu řízení toku, jako je cyklus *`for`*, vložte mezeru ```csharp //Right for (int i;i<x;i++) { ... } ``` ```csharp //Wrong for(int i;i<x;i++) { ... } ``` - Před dvojtečku pro základní třídy nebo rozhraní v deklaraci typu vložte mezeru ```csharp //Right interface I { } class C : I { } ``` ```csharp //Wrong interface I { } class C: I { } ``` - Za dvojtečku pro základní třídy nebo rozhraní v deklaraci typu vložte mezeru ```csharp //Right interface I { } class C : I { } ``` ```csharp //Wrong interface I { } class C :I { } ``` - Vložte mezeru před binární operátor a za něj ```csharp //Right return x * (x - y); ``` ```csharp //Wrong return x*(x-y); ``` ```csharp //Wrong return x * (x-y); ``` - Odstraňte mezery za otevírací závorkou a před uzavírací závorkou seznamu parametrů v deklaraci metody ```csharp //Right void Bark(int x) { ... } ``` ```csharp //Wrong void Bark( int x ) { ... } ``` - Odstraňte mezeru v prázdných závorkách seznamu parametrů v deklaraci metody ```csharp //Right void Goo() { Goo(1); } void Goo(int x) { Goo(); } ``` ```csharp //Wrong void Goo( ) { Goo(1); } void Goo(int x) { Goo(); } ``` - Odstraňte mezery mezi názvem metody a otevírací závorkou v deklaraci metody ```csharp //Right void M() { } ``` ```csharp //Wrong void M () { } ``` - Odstraňte mezery za otevírací závorkou a před uzavírací závorkou při volání metody ```csharp //Right MyMethod(argument); ``` ```csharp //Wrong MyMethod( argument ); ``` - Odstraňte mezeru v prázdných závorkách seznamu argumentů ```csharp //Right void Goo() { Goo(1); } void Goo(int x) { Goo(); } ``` ```csharp //Wrong void Goo() { Goo(1); } void Goo(int x) { Goo( ); } ``` - Odstraňte mezeru mezi názvem volané metody a otevírací závorkou ```csharp //Right void Goo() { Goo(1); } void Goo(int x) { Goo(); } ``` ```csharp //Wrong void Goo() { Goo(1); } void Goo(int x) { Goo (); } ``` - Za čárku vložte mezeru ```csharp //Right int[] x = new int[] { 1, 2, 3, 4, 5 }; ``` ```csharp //Wrong int[] x = new int[] { 1,2,3,4,5 }; ``` - Odstraňte mezeru před čárkou ```csharp //Right int[] x = new int[] { 1, 2, 3, 4, 5 }; ``` ```csharp //Wrong int[] x = new int[] { 1 , 2 , 3 , 4 , 5 }; ``` - V příkazu for vložte mezeru za každý středník ```csharp //Right for (int i = 0; i < x.Length; i++) ``` ```csharp //Wrong for (int i = 0;i < x.Length;i++) ``` - V příkazu for odstraňte mezeru před každým středníkem ```csharp //Right for (int i = 0; i < x.Length; i++) ``` ```csharp //Wrong for (int i = 0 ; i < x.Length ; i++) ``` - Odstraňte nadbytečné mezery v deklaračních příkazech ```csharp //Right int x = 0; ``` ```csharp //Wrong int x = 0 ; ``` - Odstraňte mezeru před otevírací hranatou závorkou *`[`* ```csharp //Right int[] numbers = new int[] { 1, 2, 3, 4, 5 }; ``` ```csharp //Wrong int [] numbers = new int [] { 1, 2, 3, 4, 5 }; ``` - Odstraňte mezeru mezi prázdnými hranatými závorkami *`[]`* ```csharp //Right int[] numbers = new int[] { 1, 2, 3, 4, 5 }; ``` ```csharp //Wrong int[ ] numbers = new int[ ] { 1, 2, 3, 4, 5 }; ``` - Odstraňte mezery v neprázdných hranatých závorkách *`[0]`* ```csharp //Right int index = numbers[0]; ``` ```csharp //Wrong int index = numbers[ 0 ]; ``` #### Možnosti zalomení Tato pravidla formátování se týkají umístění příkazů a bloků kódu na jeden řádek oproti samostatným řádkům. - Ponechte příkazy a deklarace členů na různých řádcích ```csharp //Right int i = 0; string name = "John"; ``` ```csharp //Wrong int i = 0; string name = "John"; ``` - Ponechte blok kódu na jednom řádku ```csharp //Right public int Foo { get; set; } ``` ```csharp //Wrong public int MyProperty { get; set; } ``` ## Konvence pojmenování - Konstanty se pojmenovávají pouze velkými písmeny s oddělovačem *`_`* ```csharp //Right const int TEST_CONSTANT = 1; ``` ```csharp //Wrong const int Test_Constant = 1; ``` - Pole s přístupem *`public`* se pojmenovávají v notaci PascalCase ```csharp //Right public int TestField; ``` ```csharp //Wrong public int testField; ``` - Názvy rozhraní musí být v notaci PascalCase a mít předponu *`I`* ```csharp //Right public interface ITestInterface; ``` ```csharp //Wrong public interface testInterface; ``` - Názvy tříd, struktur, metod, výčtů, událostí, vlastností, jmenných prostorů a delegátů by měly být v notaci PascalCase ```csharp //Right public class SomeClass; ``` ```csharp //Wrong public class someClass; ``` - Pro parametr generického typu používejte popisný název v notaci PascalCase, pokud nestačí jedno písmeno a popisný název nepřináší žádnou přidanou hodnotu. ```csharp //Right public interface ISessionChannel<TSession> { /*...*/ } public delegate TOutput Converter<TInput, TOutput>(TInput from); public class List<T> { /*...*/ } ``` - Pro typy, které obsahují pouze jednopísmenný typový parametr, použijte jako název typového parametru *`T`* ```csharp //Right public int IComparer<T>() { return 0; } public delegate bool Predicate<T>(T item); public struct Nullable<T> where T : struct { /*...*/ } ``` - Pro popisné názvy typových parametrů používejte předponu *`T`* ```csharp //Right public interface ISessionChannel<TSession> { TSession Session { get; } } ``` Omezení spojená s typovým parametrem uveďte v jeho názvu. Například parametr s omezením *`ISession`* lze pojmenovat *`TSession`*. - Privátní a chráněná pole tříd musí začínat předponou *`_`* ```csharp //Right private int _testField; protected int _testField; ``` ```csharp //Wrong private int testField; protected int testField; ``` - Všechny ostatní prvky kódu, jako jsou proměnné, parametry metod a pole tříd (kromě veřejných), se pojmenovávají v notaci camelCase. ```csharp //Right var testVar = new Object(); public void Foo(int firstParam, string secondParam) ``` ```csharp //Wrong var TestVar = new Object(); public void Foo(int FirstParam, string SecondParam) ``` --- <!-- page: Architektura nopCommerce | url: http://nopdocs.service.hedr.dev/cs/developer/tutorials/architecture-of-nopCommerce.html | source: cs/developer/tutorials/architecture-of-nopCommerce.md --> # Architektura nopCommerce ## Úvod nopCommerce je vysoce přizpůsobitelné a flexibilní, plnohodnotné open-source e-commerce řešení s podporou více obchodů a více dodavatelů, optimalizované pro SEO. Je postaveno na frameworku Microsoft `ASP.NET Core`. nopCommerce drží krok s nejnovějšími technologiemi a dodržuje osvědčené postupy. ## Přehled Tento dokument poskytuje ucelený přehled architektury systému nopCommerce. Dokumentace je určena novým vývojářům nopCommerce. Projdeme v ní jednotlivé projekty v řešení (solution) nopCommerce, závislosti mezi nimi atd. ## Přehled architektury nopCommerce nopCommerce je jedním z nejpopulárnějších a nejúspěšnějších open-source `e-commerce` řešení `založených na .NET`. Úspěch nopCommerce nespočívá jen v tom, že obsahuje většinu funkcí, které moderní e-commerce řešení vyžaduje, hned po instalaci a že jeho uživatelské rozhraní je vysoce přizpůsobitelné a uživatelsky přívětivé, ale také v tom, že řešení nopCommerce je stejně dobře organizované a přívětivé k vývojářům. Hlavní silou nopCommerce je jeho flexibilní, rozšiřitelná architektura a dobře organizovaný zdrojový kód. Architektura nopCommerce má velmi blízko k cibulové architektuře (onion architecture), která se zaměřuje především na řízení provázanosti kódu. Podle této architektury může veškerý kód záviset na vrstvách blíže středu, ale nemůže záviset na vrstvách vzdálenějších od jádra. Jinými slovy, veškerá provázanost směřuje ke středu. ![Diagram architektury nopCommerce](_static/architecture-of-nopCommerce/nopCommerceArchitecture.png) To znamená, že projekty mohou záviset pouze na jiných projektech, které leží směrem dovnitř od aktuálního projektu. Například na výše uvedeném diagramu může projekt `Nop.Data` záviset na projektu `Nop.Core` a mít `Nop.Core` jako závislost, ale `Nop.Core` nemůže záviset na `Nop.Data`; podobně může mít `Nop.Services` jako závislosti `Nop.Data` a `Nop.Core`, ale ani `Nop.Core`, ani `Nop.Data` nemohou mít jako závislost `Nop.Service`. Projekt tedy může mít jiný projekt jako závislost pouze tehdy, pokud tento projekt leží směrem dovnitř, blíže středu, než vrstva, ve které se nachází aktuální projekt. To je klíčem k oddělení kódu. Hlavní výhodou tohoto přístupu/architektury je, že pokud chceme otestovat jádro aplikace (Application Core), můžeme tak učinit, i když pro naši aplikaci nemáme žádné `UI`, protože jádro aplikace nezávisí na `vrstvě UI`. Nebo můžeme změnit náš `UI framework` z view enginu `Razor` a `JQuery` na `Angular`, `React` nebo `Vue`, aniž bychom ovlivnili jádro aplikace, a stejné jádro můžeme použít k vytvoření mobilních nebo desktopových aplikací. To vše bez změny jediného řádku kódu v jádru aplikace. ## Projekty v řešení nopCommerce ### Jádro aplikace (Application Core) Toto je nejvnitřnější vrstva architektury nopCommerce. Je to jádro aplikace. V této vrstvě se nacházejí všechny třídy logiky přístupu k datům a obchodní logiky. V řešení nopCommerce najdeme všechny projekty této vrstvy v adresáři „Libraries“. Tato vrstva obsahuje tři projekty. #### Nop.Core Tento projekt obsahuje sadu základních tříd nopCommerce. Projekt je ve středu architektury a nemá žádné závislosti na jiných projektech v řešení. Obsahuje základní třídy sdílené celým řešením, jako jsou doménové entity, cache, události a další pomocné třídy. #### Nop.Data Projekt `Nop.Data` závisí na projektu `Nop.Core`, který je ve středu architektury. Nezávisí na žádném jiném projektu v řešení. Projekt `Nop.Data` obsahuje třídy a funkce pro čtení z databáze nebo jiného úložiště dat a zápis do nich. Odděluje logiku přístupu k datům od obchodních objektů. #### Nop.Services Projekt `Nop.Services` je nejvzdálenější vrstvou jádra aplikace v architektuře nopCommerce. Závisí na dalších dvou projektech jádra aplikace. Obsahuje základní služby, obchodní logiku, validace a výpočty nad daty. Někdo jej nazývá vrstvou obchodního přístupu (Business Access Layer, BAL) nebo vrstvou obchodní logiky (Business Logic Layer, BLL). Slouží jako fasáda pro všechny ostatní vrstvy. Obsahuje třídy služeb a ke zpřístupnění svých funkcí využívá návrhový vzor repository. Tento přístup odděluje jádro od ostatních vrstev mimo jádro. Zároveň zabraňuje změnám kódu v ostatních vrstvách nebo je omezuje, pokud se změní logika jádra aplikace. Tento přístup je ideální pro vkládání závislostí (dependency injection). ### Vrstva UI Tato vrstva leží mimo „jádro aplikace“. V řešení nopCommerce najdeme všechny projekty této vrstvy v adresáři „Presentation“. V této vrstvě se nachází veškerá prezentační logika a uživatelské rozhraní. Je to vrstva, ve které se nachází UI, se kterým mohou uživatelé interagovat. V nopCommerce se tato vrstva dělí na dvě další vrstvy. #### Nop.Web.Framework Projekt `Nop.Web.Framework` je vnitřní vrstvou prezentační vrstvy a závisí na vrstvě jádra aplikace. Jedná se o projekt knihovny tříd, který slouží jako framework pro prezentační vrstvu. Obsahuje sdílenou logiku pro veřejný web nopCommerce i pro administrační panel. #### Nop.Web Projekt `Nop.Web` je nejvzdálenější vrstvou prezentační vrstvy v architektuře nopCommerce. Obsahuje uživatelské rozhraní e-commerce webu (front end), se kterým mohou uživatelé interagovat. Jde o aplikaci ASP.NET Core, která závisí na `Nop.Web.Framework` a na jádru aplikace. `Nop.Web.Framework` využívá pro logiku sdílenou s administračním panelem. Jádro aplikace využívá pro přístup k datům a jejich zpracování. #### Admin V nopCommerce patří do stejné vrstvy jako projekt `Nop.Web`. Nachází se uvnitř projektu `Nop.Web` jako oblast (area). Jde rovněž o UI (uživatelské rozhraní), ale tato část prezentační vrstvy obsahuje UI administračního panelu. Administrační panel je místo, kde se spravuje veškerý obsah veřejného webu a odkud můžeme sledovat aktivity na veřejném webu. Veřejný web je přístupný bez jakýchkoli omezení, ale „administrační panel“ vyžaduje pro přístup ověření a autorizaci, protože obsahuje informace, ke kterým má právo přistupovat pouze administrátor webu. ### Testovací vrstva Tato vrstva leží ve stejné vrstvě jako „prezentační vrstva“, hned vně „jádra aplikace“. Tato vrstva se celá týká testování různých částí aplikace. Testování v nopCommerce je díky architektuře, kterou systém používá, snadné a spolehlivější. V řešení nopCommerce najdeme všechny projekty této vrstvy v adresáři „Tests“. nopCommerce používá pro *jednotkové testy* testovací framework **NUnit**. #### Nop.Tests Tato vrstva je vnitřní vrstvou „testovací vrstvy“ a má závislost na vrstvě „jádra aplikace“. Tento projekt obsahuje základní logiku pro testování. #### Nop.Core.Tests Tyto testy jsou vytvořeny pro *jednotkové testování* projektu `Nop.Core`; testují cache, doménové entity a podobně. #### Nop.Data.Tests Tyto testy jsou vytvořeny pro *jednotkové testování* projektu `Nop.Data`; testují práci různých poskytovatelů dat s operacemi nad entitou, jako je vložení, odstranění atd. #### Nop.Services.Tests Tyto testy jsou vytvořeny pro *jednotkové testování* projektu `Nop.Service`. Obsahují logiku pro testování každé třídy služeb pro každou operaci. #### Nop.Web.Tests Tyto testy lze použít k testování prezentační vrstvy nopCommerce, která obsahuje „veřejný web“ a „administrační panel“. --- <!-- page: Organizace zdrojového kódu | url: http://nopdocs.service.hedr.dev/cs/developer/tutorials/source-code-organization.html | source: cs/developer/tutorials/source-code-organization.md --> # Organizace zdrojového kódu Tento dokument je vývojářským průvodcem strukturou solution nopCommerce a má pomoci novým vývojářům seznámit se se zdrojovým kódem. Především je nopCommerce open-source aplikace, takže si ji můžete zdarma stáhnout z [GitHubu](https://github.com/nopSolutions/nopCommerce). Projekty a složky jsou uvedeny v pořadí, v jakém jsou seřazeny ve *Visual Studiu*. Doporučujeme otevřít si solution nopCommerce ve *Visual Studiu* a při čtení tohoto dokumentu si prohlížet projekty a soubory. ![Organizace zdrojového kódu](_static/source-code-organization/structure_of_projects.jpg) Většina projektů, adresářů a souborů je pojmenována tak, abyste si mohli udělat hrubou představu o jejich účelu. Například se ani nemusíte dívat dovnitř projektu `Nop.Plugin.Payments.PayPalStandard`, abyste uhodli, co dělá. ## `\Libraries\Nop.Core` Projekt `Nop.Core` obsahuje sadu základních tříd nopCommerce, jako je cache, události, pomocné třídy (helpers) a business objekty (například entity `Order` a `Customer`). ## `\Libraries\Nop.Data` Projekt `Nop.Data` obsahuje sadu tříd a funkcí pro čtení z databáze nebo jiného úložiště dat a zápis do nich. Knihovna `Nop.Data` pomáhá oddělit logiku přístupu k datům od vašich business objektů. nopCommerce používá přístup Code-First knihovny *Linq2DB*. Code-First umožňuje vývojáři definovat entity ve zdrojovém kódu (všechny základní entity jsou definovány v projektu `Nop.Core`) a poté pomocí *Linq2DB* a *FluentMigrator* vygenerovat databázi z tříd C#. Proto se tomu říká Code-First. Své objekty pak můžete dotazovat pomocí LINQ, který se na pozadí překládá do SQL a spouští se nad databází. nopCommerce používá [Fluent API](https://fluentmigrator.github.io/articles/technical/fluent-api-create.html) k plnému přizpůsobení mapování perzistence. ## `\Libraries\Nop.Services` Tento projekt obsahuje sadu základních služeb, business logiku, validace nebo výpočty související s daty, je-li to potřeba. Někdo tomu říká *Business Access Layer* (BAL). ## Projekty ve složce solution `\Plugins\` `Plugins` je složka solution ve *Visual Studiu*, která obsahuje projekty pluginů. Fyzicky se nachází v kořeni vaší solution. DLL knihovny pluginů se však automaticky kopírují do adresáře `\Presentation\Nop.Web\Plugins`, který se používá pro již nasazené pluginy, protože výstupní cesty sestavení všech pluginů jsou nastaveny na `..\..\Presentation\Nop.Web\Plugins\{Group}.{Name}`. To umožňuje, aby pluginy obsahovaly některé externí soubory, například statický obsah (soubory CSS nebo JS), aniž by bylo nutné kopírovat soubory mezi projekty, aby bylo možné projekt spustit. ## `\Presentation\Nop.Web` `Nop.Web` je projekt webové aplikace MVC, prezentační vrstva veřejné části obchodu, která obsahuje i administraci zahrnutou jako oblast (area). Pokud jste dosud `ASP.NET` nepoužívali, další informace naleznete [zde](http://www.asp.net/). Toto je aplikace, kterou spouštíte. Jde o spouštěcí projekt aplikace. ## `\Presentation\Nop.Web.Framework` `Nop.Web.Framework` je projekt knihovny tříd obsahující některé společné prezentační prvky pro projekt `Nop.Web`. ## `\Test\Nop.Tests` `Nop.Tests` je projekt knihovny tříd obsahující některé společné testovací třídy a pomocné třídy pro ostatní testovací projekty. Sám žádné testy neobsahuje. Více o UNIT testování v nopCommerce si přečtěte v následujícím článku: [UNIT testování](xref:cs/developer/tutorials/unit-tests). ### `\Nop.Core.Tests` Nop.Core.Tests je testovací projekt pro projekt Nop.Core. ### `\Nop.Services.Tests` Nop.Services.Tests je testovací projekt pro projekt Nop.Services. ### `\Nop.Web.Tests` `Nop.Web.Tests` je testovací projekt pro projekty prezentační vrstvy. ## Výukové materiály - [Architektura e-commerce platformy nopCommerce](https://www.youtube.com/watch?v=6gLbizzSA9o&list=PLnL_aDfmRHwtJmzeA7SxrpH3-XDY2ue0a) --- <!-- page: Začínáme s vývojem pro nopCommerce | url: http://nopdocs.service.hedr.dev/cs/developer/tutorials/instruction-on-how-to-start-developing-on-nopcommerce.html | source: cs/developer/tutorials/instruction-on-how-to-start-developing-on-nopcommerce.md --> # Začínáme s vývojem pro nopCommerce nopCommerce je open-source e-commerce řešení založené na Microsoft ASP.NET. Toto je základní průvodce pro vývojáře, jak začít s vývojem pro nopCommerce. ## 1. Nástroje potřebné pro vývoj O technologiích a systémových požadavcích se dozvíte v článku **„[Nástroje potřebné pro vývoj](xref:cs/developer/tutorials/system-requirements-for-developing#tools-required-for-development)“**. ## 2. Technologický stack používaný v nopCommerce Nejlepší na nopCommerce je, že jeho zdrojový kód je plně přizpůsobitelný a jeho modulární architektura umožňuje snadno vyvíjet vlastní funkce a plnit jakékoli obchodní požadavky pomocí systému pluginů. Řídí se známými softwarovými architekturami, návrhovými vzory a osvědčenými bezpečnostními postupy. A především běží na nejnovějších technologiích, aby koncovým uživatelům nabídl co nejlepší zážitek. K dosažení toho všeho používá nopCommerce ve své architektuře celou řadu technologií. * Aplikační vrstva * Razor View Engine Slouží k vykreslení HTML stránky na straně klienta. Razor View engine je značkovací syntaxe, která nám pomáhá psát HTML a kód na straně serveru ve webových stránkách pomocí C# nebo VB.NET. * JQuery Jde o javascriptovou knihovnu používanou k rozšíření funkčnosti UI a UX HTML stránek. * Obchodní vrstva * Fluent Validation Jde o validační knihovnu pro .NET, která k vytváření validačních pravidel používá fluent rozhraní a lambda výrazy. * Mapster Mapster je jednoduchá knihovna, která nám pomáhá převést jeden typ objektu na jiný. Jde o mapper objektů na objekty založený na konvencích, který vyžaduje jen velmi málo konfigurace. * Interní dependency injection v ASP.NET Core ASP IOC spravuje závislosti mezi třídami, aby aplikace zůstaly snadno změnitelné i s rostoucí velikostí a složitostí. * Linq2DB Linq2DB je open-source ORM framework pro aplikace .NET. Je to projekt .NET Foundation. Umožňuje vývojářům pracovat s daty pomocí objektů doménově specifických tříd, aniž by se museli zabývat podkladovými databázovými tabulkami a sloupci, kde jsou tato data uložena. Je tedy mostem mezi obchodní a datovou vrstvou. * FluentMigrator Fluent Migrator je migrační framework pro .NET. Migrace představují strukturovaný způsob změny databázového schématu a jsou alternativou k vytváření spousty SQL skriptů, které musí ručně spouštět každý zapojený vývojář. Migrace řeší problém vývoje databázového schématu pro více databází (například lokální databázi vývojáře, testovací databázi a produkční databázi). Změny databázového schématu jsou popsány ve třídách napsaných v C#, které lze uložit do systému správy verzí. * Datová vrstva * Microsoft SQL Server SQL Server je plnohodnotný systém pro správu relačních databází (RDBMS) od společnosti Microsoft. * MySQL MySQL je nejpopulárnější open-source databáze na světě. Díky prověřenému výkonu, spolehlivosti a snadnému použití se MySQL stala přední volbou databáze pro webové aplikace. * PostgreSQL PostgreSQL je výkonný open-source objektově-relační databázový systém s více než 30 lety aktivního vývoje, který si vysloužil pověst spolehlivosti, robustnosti funkcí a výkonu. * Redis (cache) Redis je open-source (licence BSD) úložiště datových struktur v paměti, používané jako databáze, cache a zprostředkovatel zpráv (message broker). V nopCommerce se Redis používá k ukládání starých dat jako datová sada cache v paměti. To zvyšuje rychlost a výkon aplikace. * Microsoft Azure (volitelné) Azure je veřejná cloudová platforma s řešeními zahrnujícími infrastrukturu jako službu (IaaS), platformu jako službu (PaaS) a software jako službu (SaaS), kterou lze využít pro služby jako analytika, virtuální výpočty, úložiště, síťování a mnoho dalšího. ## 3. Jak stáhnout projekt a spustit jej na lokálním počítači Než začneme s nopCommerce pracovat, musíme se ujistit, že je náš lokální počítač nakonfigurován a všechny potřebné nástroje jsou správně nainstalovány a fungují. Nyní přejděme k podrobnému návodu, jak stáhnout a spustit nopCommerce na lokálním počítači. ### Krok 1: Stažení zdrojového kódu nopCommerce Ke stažení navštivte [www.nopcommerce.com](https://www.nopcommerce.com/download-nopcommerce). Uvidíte zde dvě tlačítka pro stažení – jedno se zdrojovým kódem a jedno bez zdrojového kódu, jak je znázorněno na obrázku níže. ![image1](_static/instruction-on-how-to-start-developing-on-nopcommerce/image1.png) Protože nopCommerce stahujeme pro účely vývoje, musíme stáhnout balíček označený „Package with source code“, který obsahuje zdrojový kód nopCommerce. Ke stažení nopCommerce musíte být přihlášeni nebo si zaregistrovat nový účet. Nyní můžete nopCommerce stáhnout jako soubor RAR a rozbalit jej do požadované složky. ### Krok 2: Otevření řešení nopCommerce * Otevření v Microsoft Visual Studio Otevřete složku. Uvnitř uvidíte řadu souborů a složek, které tvoří zdrojový kód nopCommerce. ![image2](_static/instruction-on-how-to-start-developing-on-nopcommerce/image2.png) Uvidíte zde také soubor řešení s příponou `.sln`. Dvojitým kliknutím na tento soubor otevřete projekt nopCommerce v Microsoft Visual Studio. * Otevření ve Visual Studio Code Při spuštění zadejte kořenový adresář: ![image4](_static/instruction-on-how-to-start-developing-on-nopcommerce/image4.jpg) ### Krok 3: Spuštění projektu nopCommerce nopCommerce ke spuštění projektu nevyžaduje žádnou další konfiguraci. nopCommerce je připraven ke spuštění hned po stažení. * Spuštění v Microsoft Visual Studio Nyní můžete projekt spustit pomocí *Microsoft Visual Studio* stisknutím `ctrl+F5`, nebo jen `F5` pro spuštění projektu v režimu ladění, případně pomocí tlačítka s ikonou přehrávání v *Microsoft Visual Studio*. * Spuštění ve Visual Studio Code Soubor **launch.json** slouží k nastavení debuggeru ve *Visual Studio Code*. Tento soubor obsahuje informace o tom, jak bude projekt spuštěn. Při prvním spuštění *Visual Studio Code* tento soubor vygeneruje podle standardní šablony v cestě `.vscode/launch.json`. Kromě souboru *launch.json* nakonfigurujte nastavení spuštění pomocí souboru launchSettings.json. Výhodou souboru **launchSettings.json** je, že umožňuje sdílet nastavení mezi *Visual Studio Code* a plnou verzí *Visual Studio*. Tento soubor je již součástí zdrojového kódu nopCommerce. Stačí jen určit, který profil použijeme při spuštění projektu. ```json "launchSettingsProfile": "Nop.Web", ``` > [!NOTE] > > Podporovány jsou pouze profily s `"commandName": "Project"`. Profil `"IIS Express"` v tomto případě nelze použít. Ve výchozím stavu se projekt spustí na adrese `https://localhost:5001`, protože je v profilu uvedena jako první. Pokud to chcete změnit a nepoužívat SSL, musíte to uvést v nastavení souboru **launch.json**: ```json "serverReadyAction": { "action": "openExternally", "pattern": "\\bNow listening on:\\s+http://\\S+:([0-9]+)", "uriFormat": "http://localhost:%s" }, ``` Nyní můžete projekt spustit pomocí *Visual Studio Code* stisknutím `ctrl+F5`, nebo jen `F5` pro spuštění projektu v režimu ladění. Po prvním spuštění projektu uvidíte instalační stránku jako na obrázku níže: ![image3](_static/instruction-on-how-to-start-developing-on-nopcommerce/nop_install.jpg) Zde je třeba vyplnit všechny požadované údaje k dokončení instalace. #### Informace o obchodu Zde musíte zadat e-mailovou adresu a heslo, které pak budou sloužit jako váš administrátorský účet v obchodě nopCommerce. #### Informace o databázi Zde je třeba zadat informace, které chcete pro tento projekt použít. Zde musíte zvolit databázové úložiště. Můžete použít `MS SQL Server`, `MySQL` nebo `PostgreSQL`. Je na vás, které z nich chcete použít. Pro účely tohoto návodu budeme používat `MS SQL Server`. Uvidíte také zaškrtávací políčko s dotazem, zda chcete vytvořit databázi, pokud neexistuje – zaškrtněte jej. Dále je třeba nastavit připojovací řetězec. K tomu máte dvě možnosti. První je vyplnit formulář s poli „**Server name**“ a „**Database name**“. Do pole „Server name“ zadejte název svého serveru a do pole „Database name“ název databáze, kterou chcete vytvořit; pokud ji již máte, nebude se vytvářet, ale použije se stávající. Můžete však také zvolit možnost „**Enter raw connection string (advanced)**“ a celý připojovací řetězec napsat sami. Poté je třeba zadat přihlašovací údaje k SQL serveru pro ověření. Po vyplnění všech těchto údajů stiskněte tlačítko „install“. Dokončení instalace trvá přibližně 1 minutu, poté budete přesměrováni na domovskou stránku internetového obchodu. ### 4. Jak nakonfigurovat nopCommerce pro běh na HTTPS * Microsoft Visual Studio Chcete-li pro nopCommerce nastavit SSL/HTTPS, přejděte do okna vlastností projektu `Nop.Web` ve složce *Presentation*, protože jde o spouštěcí projekt nopCommerce. Okno vlastností otevřete kliknutím pravým tlačítkem na projekt `Nop.Web`; v dolní části kontextové nabídky uvidíte položku „Properties“. Klikněte na ni a zobrazí se okno vlastností. V okně vlastností přejděte na kartu „**Debug**“. ![image3](_static/instruction-on-how-to-start-developing-on-nopcommerce/image3.jpg) Zaškrtněte „**Use SSL**“ a vedle zadejte HTTPS URL. Poté projekt uložte. Nyní projekt znovu spusťte a přejděte na zadanou URL. Uvidíte, že nyní běží přes SSL/HTTPS. To je jeden způsob konfigurace HTTPS ve webovém projektu, existuje však i další způsob konfigurace SSL. Přejděte do projektu `Nop.Web` a rozbalte jej; ve struktuře projektu uvidíte virtuální soubor „Properties“ hned pod „Dependencies“. Uvnitř Properties najdete soubor JSON s názvem **launchSetting.json**. Otevřete tento soubor a uvidíte v něm již zapsanou řadu konfiguračních nastavení. V tomto souboru můžete mít sekci, jak je znázorněno na obrázku výše. Chcete-li povolit SSL, stačí ve vlastnosti „**sslPort**“ nahradit 0 portem, na kterém chcete provozovat SSL připojení; ujistěte se, že je port volný. Pro otestování spusťte projekt a přejděte na `https://localhost:{yourPort}`. * Visual Studio Code Chcete-li projekt spustit přes protokol *SSL*, ujistěte se, že je v souboru **launch.json** uvedeno následující nastavení: ```json "serverReadyAction": { "action": "openExternally", "pattern": "\\bNow listening on:\\s+(https?://\\S+)" } ``` > [!NOTE] > > Nastavení v **launch.json** mají přednost před nastaveními v **launchSettings.json**, takže pokud je například v launch.json již nastaveno args na něco jiného než prázdný řetězec/pole, obsah launchSettings.json bude ignorován. --- <!-- page: Výchozí schéma databáze | url: http://nopdocs.service.hedr.dev/cs/developer/tutorials/db-schema.html | source: cs/developer/tutorials/db-schema.md --> # Výchozí schéma databáze V tomto článku se podíváme na schéma databáze, které se vytváří při počáteční instalaci a které v 90 % případů zůstává beze změny. Nebudeme uvádět celé schéma jako celek, ale popíšeme výchozí instalaci, která počítá s vytvořením 126 tabulek. Abychom takové schéma snadno pochopili, rozdělme si ho na části. Níže jsme tabulky seskupili co nejpřirozeněji a nejsrozumitelněji: * [Informace o zákaznících](#customers-info) * [Informace o produktech](#products-info) * [Atributy produktu](#product-attributes) * [Množstevní ceny](#tier-price) * [Zásoby podle skladů](#inventory-by-warehouses) * [Objednávky](#orders) * [Zásilky](#shipments) * [Slevy](#discounts) * [Nákupní košík](#shopping-cart) * [Adresy](#addresses) * [Konvence pojmenování v databázi](#database-naming-convention) <a id="customers-info"></a> ## Informace o zákaznících ![Informace o zákaznících](_static/db-schema/customers-info.jpg) Tento diagram znázorňuje sadu tabulek, které obsahují základní informace o zákaznících. Uvádí také směr vazeb. Nebudeme se zabývat účelem tabulek a polí, protože jejich názvy jsou dostatečně výmluvné. ### Zvláštnosti (Informace o zákaznících) * V tabulce **Customer** máme tři pole, která by ve skutečnosti měla být definována jako cizí klíče, ale v praxi nejsou: 1. AffiliateId 1. VendorId 1. RegisteredInStoreId Je to tak záměrně, aby se systém nezatěžoval zbytečnými vazbami, protože tato pole se nepoužívají v každém internetovém obchodě. * Některá uživatelská data jsou uložena v tabulce **GenericAttribute**. Všechna je najdete v `\src\Libraries\Nop.Core\Domain\Customers\NopCustomerDefaults.cs`. Struktura této tabulky je uvedena níže: ![GenericAttribute](_static/db-schema/generic-attribute.jpg) Kromě zmíněných dat o zákaznících může tato tabulka ukládat libovolná data i pro jiné entity. Tuto tabulku jsme přidali záměrně, abyste mohli rozšířit jakoukoli entitu bez změny struktury tabulek. Tato tabulka navíc ukládá vlastní **atributy zákazníka** a **atributy dodavatele** se zvolenými hodnotami pro dodavatele a zákazníky ve formátu XML. Podívejte se na následující řádky, abyste pochopili, jak to vypadá: ![Xml](_static/db-schema/xml.jpg) Na příkladu řetězce XML ze sloupce *Value* vidíme, jak přesně jsou hodnoty atributů pro určitého dodavatele uloženy: ```csharp <Attributes><VendorAttribute ID="2"><VendorAttributeValue><Value>1</Value></VendorAttributeValue></VendorAttribute></Attributes> ``` Jak vidíte, dodavatel s ID 1 má vyplněný pouze jeden atribut dodavatele. Tento atribut má ID 2 a jeho hodnota je 1. Vlastní atributy zákazníka mají stejnou strukturu jako atributy dodavatele. Následující snímek obrazovky znázorňuje vztahy mezi **atributy zákazníka** a **atributy dodavatele** a jejich hodnotami: ![Xml](_static/db-schema/attributes.jpg) <a id="products-info"></a> ## Informace o produktech ![Informace o produktech](_static/db-schema/products-info.jpg) V diagramu vidíte základní data produktu (schéma tabulky s informacemi o produktu níže). Tato data se zpravidla používají v 99 % případů. ![Tabulka produktu](_static/db-schema/product.png) ### Zvláštnosti (Informace o produktech) V závislosti na nastavení obchodu mohou být k tomuto schématu připojeny další tabulky. Například pro rozdělení množství produktu mezi více skladů. ![Tabulka produktu](_static/db-schema/warehouse.jpg) Nebo pokud chcete používat funkci recenzí produktů: ![Tabulka produktu](_static/db-schema/product-review.jpg) <a id="product-attributes"></a> ### Atributy produktu Dále se podívejme na schéma atributů a jejich kombinací uvedené níže: ![Atributy produktu](_static/db-schema/product-attributes.jpg) <a id="tier-price"></a> ### Množstevní ceny Pokud u produktů používáte množstevní ceny, měli byste věnovat pozornost také následujícímu schématu: ![Množstevní ceny](_static/db-schema/tier-price.jpg) <a id="inventory-by-warehouses"></a> ### Zásoby podle skladů Přestože se tato funkce nepoužívá často, může být užitečné uvést schéma evidence zboží v konkrétním skladu: ![Zásoby podle skladů](_static/db-schema/stock-quantity-history.jpg) <a id="orders"></a> ## Objednávky ![objednávky](_static/db-schema/orders.jpg) V tomto diagramu vidíme tabulky související s daty objednávek. Tabulka **Order** má následující strukturu: ![objednávka](_static/db-schema/order.png) Není třeba nic komentovat, protože vše by mělo být jasné z diagramu a názvy polí jsou dostatečně výmluvné. Je třeba pouze poznamenat, že tabulka **RewardPointsHistory** se používá pouze tehdy, je-li pro obchod aktivován *systém věrnostních bodů*. <a id="shipments"></a> ## Zásilky ![zásilky](_static/db-schema/shipments.jpg) Účel všech tabulek v diagramu stejně jako dříve nevyvolává žádné otázky. Přesto se zastavme u několika bodů. Tabulka **ShippingMethod** slouží ke správě seznamu připojených pluginů a konkrétní způsob dopravy je uložen v polích *ShippingRateComputationMethodSystemName* a *ShippingMethod* tabulky **Order**. Pole *OrderItemId* tabulky **ShipmentItem** je v podstatě odkazem na tabulku **OrderItem**. <a id="discounts"></a> ## Slevy ![slevy](_static/db-schema/discounts.jpg) Z výše uvedeného diagramu vidíme, že slevy lze uplatnit na tři skupiny: **Produkty**, **Výrobce**, **Kategorie** a lze je konfigurovat pomocí různých pravidel, která jsou řízena pluginy (``IDiscountRequirementRule``). V tabulce **DiscountRequirement** musí pole *InteractionTypeId* obsahovat jednu z hodnot uvedených ve výčtu ``RequirementGroupInteractionType``: ```csharp /// <summary> /// Represents an interaction type within the group of requirements /// </summary> public enum RequirementGroupInteractionType { /// <summary> /// All requirements within the group must be met /// </summary> And = 0, /// <summary> /// At least one of the requirements within the group must be met /// </summary> Or = 2 } ``` <a id="shopping-cart"></a> ## Nákupní košík Další důležitou součástí obchodu je nákupní košík. V našem případě je schéma tohoto mechanismu velmi jednoduché: ![Nákupní košík](_static/db-schema/shopping-cart-item.jpg) Jediné, co stojí za zmínku, je, že toto schéma se používá také pro seznam přání. K rozlišení těchto dvou typů slouží pole *ShoppingCartTypeId*. Hodnoty v tomto poli musí odpovídat hodnotám z výčtu **ShoppingCartType**: ```csharp /// <summary> /// Represents a shopping cart type /// </summary> public enum ShoppingCartType { /// <summary> /// Shopping cart /// </summary> ShoppingCart = 1, /// <summary> /// Wishlist /// </summary> Wishlist = 2 } ``` <a id="addresses"></a> ## Adresy Možná vás bude zajímat také schéma tabulek, které se podílejí na ukládání adres, a to jak doručovacích adres, tak adres zákazníků: ![adresy](_static/db-schema/addresses.jpg) Jak jistě chápete, standardní instalace obsahuje mnohem více tabulek. Nepopisujeme je všechny, protože mnohé z nich nemají žádné vazby a slouží pouze ke specifickému účelu, zatímco jiné se používají velmi zřídka. <a id="database-naming-convention"></a> ## Konvence pojmenování v databázi Možná jste si všimli, že databáze používá k pojmenování tabulek a sloupců smíšený přístup (se znakem `_`, bez `_`, CamelCase). Kdysi dávno jsme používali znak `_`. Nyní jsme však zcela přešli na zápis **PascalCase**. Rozhodli jsme se neměnit názvy stávajících tabulek ani sloupců, protože mnoho našich uživatelů už napsalo vlastní skripty, které by jinak přestaly fungovat. Pro zachování zpětné kompatibility s novými standardy jsme zavedli rozhraní `INameCompatibility`. Umožňuje přejmenovat tabulky a sloupce tak, aby se objekty správně mapovaly na tabulky, které dodržují staré standardy pojmenování. Úplný seznam přepsání obsahuje třída [BaseNameCompatibility](https://github.com/nopSolutions/nopCommerce/blob/develop/src/Libraries/Nop.Data/Mapping/BaseNameCompatibility.cs) ve jmenném prostoru `Nop.Data.Mapping`. --- <!-- page: Úprava existující entity (jak přidat novou vlastnost) | url: http://nopdocs.service.hedr.dev/cs/developer/tutorials/update-existing-entity.html | source: cs/developer/tutorials/update-existing-entity.md --> # Úprava existující entity (jak přidat novou vlastnost) Tento návod popisuje, jak přidat vlastnost do entity „Category“, která je součástí zdrojového kódu nopCommerce. ## Datový model Entity mají dvě třídy, které se používají k mapování záznamů na tabulku. První třída definuje vlastnosti, pole a metody, které využívá webová aplikace. ```sh File System Location: [Project Root]\Libraries\Nop.Core\Domain\Catalog\Category.cs Assembly: Nop.Core Solution Location: Nop.Core.Domain.Catalog.Category.cs ``` Druhá třída slouží k mapování vlastností definovaných ve výše uvedené třídě na příslušné sloupce SQL. Mapovací třída je také zodpovědná za mapování vztahů mezi různými tabulkami SQL. ```sh File System Location: [Project Root]\Libraries\Nop.Data\Mapping\Builders\Catalog\CategoryBuilder.cs Assembly: Nop.Data Solution Location: Nop.Data.Mapping.Builders.Catalog.CategoryBuilder.cs ``` Doporučujeme ji však používat pouze pro vaše vlastní třídy entit. V našem případě místo mapovací třídy použijeme mechanismus migrací. Do třídy `Category` přidejte následující vlastnost. ```csharp public string SomeNewProperty { get; set; } ``` Přidejte novou třídu `Nop.Data.Migrations.AddSomeNewProperty` s následujícím kódem: ```csharp using FluentMigrator; using Nop.Core.Domain.Catalog; namespace Nop.Data.Migrations [NopSchemaMigration("2024-04-20 00:00:00", "Category. Add some new property")] public class AddSomeNewProperty: ForwardOnlyMigration { /// <summary> /// Collect the UP migration expressions /// </summary> public override void Up() { var categoryTableName = nameof(Category); if (!Schema.Table(categoryTableName).Column(nameof(Category.SomeNewProperty)).Exists()) Alter.Table(categoryTableName) .AddColumn(nameof(Category.SomeNewProperty)).AsInt32().AsString(255).Nullable(); } } ``` > [!NOTE] > > Procedura aktualizace migrací se provádí během inicializace databáze. > >```csharp >public virtual void InitializeDatabase() >{ > var migrationManager = EngineContext.CurrenResolve<IMigrationManager>(); > migrationManager.ApplyUpMigrations(typeof(NopDbStartup).Assembly); >} >``` ## Prezentační model Prezentační model slouží k přenosu informací z controlleru do view (více na asp.net/mvc). Modely mají ještě jeden účel: definování požadavků. Databázi jsme nakonfigurovali tak, aby pro `SomeNewProperty` ukládala pouze 255 znaků. Pokud se pokusíme uložit `SomeNewProperty` s 300 znaky, aplikace selže (nebo text zkrátí). Chceme, aby aplikace co nejlépe chránila uživatele před chybami, a naše view modely pomáhají vynucovat požadavky, jako je délka řetězce. ```sh File System Location: [Project Root]\Presentation\Nop.Web\Areas\Admin\Models\Catalog\CategoryModel.cs Assembly: Nop.Admin Solution Location: Nop.Web.Areas.Admin.Models.Catalog.CategoryModel.cs ``` Třída validátoru slouží k ověřování dat uložených ve třídě modelu (např. povinná pole, maximální délka a povolené rozsahy). ```sh File System Location: [Project Root]\Presentation\Nop.Web\Areas\Admin\Validators\Catalog\CategoryValidator.cs Assembly: Nop.Web Solution Location: Nop.Web.Areas.Admin.Validators.Catalog.CategoryValidator.cs ``` Přidejte vlastnost do našeho view modelu. ```csharp // The NopResourceDisplayName provides the "key" used during localization [NopResourceDisplayName("Admin.Catalog.Categories.Fields.SomeNewProperty")] public string SomeNewProperty { get; set; } ``` Kód požadavků se přidá do konstruktoru validátoru. ```csharp //I think this code can speak for itself RuleFor(m => m.SomeNewProperty).Length(0, 255); ``` ## View ```sh File System Location: [Project Root]\Presentation\Nop.Web\Areas\Admin\Views\Category\_CreateOrUpdate.Info.cshtml Assembly: Nop.Web ``` View obsahují HTML pro zobrazení dat modelu. Umístěte toto HTML pod sekci „PictureId“. ```csharp <div class="form-group"> <div class="col-md-3"> <nop-label asp-for="SomeNewProperty" /> </div> <div class="col-md-9"> <nop-editor asp-for="SomeNewProperty" /> <span asp-validation-for="SomeNewProperty"></span> </div> </div> ``` ## Controller V tomto případě je controller zodpovědný za mapování doménového datového modelu na náš view model a naopak. Model kategorie jsme pro úpravu zvolili kvůli jeho jednoduchosti. ```sh File System Location: [Project Root]\Presentation\Nop.Web\Areas\Admin\Controllers\CategoryController.cs Assembly: Nop.Admin Solution Location: Nop.Web.Areas.Admin.Controllers.CategoryController.cs ``` Ve třídě CategoryController provedeme tři úpravy. * Datový model → View model * Create: View model → Datový model * Edit: View model → Datový model Normálně bychom pro následující kód napsali testy a ověřili, že mapování modelu funguje správně, ale pro zjednodušení teď jednotkové testování vynecháme. Do příslušných metod („Create“, „Edit“ nebo „PrepareSomeModel“) přidejte kód pro nastavení této vlastnosti. Ve většině případů to není nutné, protože to automaticky zajišťuje *Mapster* v metodě `.ToModel()`. Ve veřejné metodě pro uložení entity (obvykle metody „Create“ nebo „Edit“ s atributem `[HttpPost]`) ```csharp // Edit View Model → Data Model category.SomeNewProperty = model.SomeNewProperty; ``` ## Řešení problémů * Znovu vytvořte databázi. Buď vlastním SQL skriptem, nebo pomocí instalátoru nopCommerce. * Mezi změnami schématu zastavte vývojový webový server. * Napište podrobný komentář na [naše fóra](http://www.nopcommerce.com/boards/). --- <!-- page: Databázové migrace | url: http://nopdocs.service.hedr.dev/cs/developer/tutorials/migrations.html | source: cs/developer/tutorials/migrations.md --> # Databázové migrace ## Stručný popis změn v přístupu k práci s databází Práce s databází byla ve verzi nopCommerce 4.30 výrazně přepracována. První změnou, které si lze všimnout, je úplné opuštění navigačních vlastností. O užitečnosti tohoto přístupu můžeme přemýšlet a polemizovat, ale má několik kladných stránek: 1. Zjednodušení porozumění kódu a jeho údržby. > [!NOTE] > > Během refaktoringu kódu jsme nalezli a opravili několik nepřesností, které ovlivňovaly výkon i funkčnost. 1. Plná kontrola nad dotazy a okamžikem jejich provedení (což pozitivně ovlivňuje výkon celého řešení). 1. Možnost zjednodušit proces migrace na libovolný databázový framework (to nejdůležitější). Protože nopCommerce zcela přešel na .NET Core (verze 4.10) a stal se multiplatformním řešením, podpora více databází se stala stále důležitějším aspektem. Tým nopCommerce provedl rozsáhlý výzkum a analýzu a rozhodl se upustit od používání standardního Entity Framework Core. Zároveň jsme se rozhodli nepracovat s databází prostřednictvím dotazů LINQ s využitím přístupu OOP (což je nejběžnější přístup, který používají vývojáři v C#). Konečná volba padla na kombinaci Linq2DB a FluentMigrator. Níže podrobně popíšu roli každého z těchto frameworků. ## Linq2DB > [!NOTE] > > Od verze 4.30 používá nopCommerce jako ORM framework Linq2DB. Linq2DB je objektově-relační mapper (ORM), který vývojářům v .NET umožňuje pracovat s databází pomocí objektů .NET. Dokáže mapovat objekty .NET na celou řadu databázových poskytovatelů. V nopCommerce se Linq2DB používá jako vrstva pro přístup k databázi. V současné době nopCommerce podporuje tři nejoblíbenější databáze: MS SQL Server, MySQL a PostgreSQL. Pokud kód analyzujeme, snadno zjistíme, že každá databáze je podporována vlastní třídou, která implementuje rozhraní INopDataProvider. Pokud však neplánujete vytvářet vlastního poskytovatele přístupu k databázi, můžete podrobnosti implementace zcela ignorovat. Pro většinu vývojových úloh postačí porozumět jen několika bodům: 1. Potřebujete objekt odpovídající tabulce v databázi (třídu POCO). 1. Veškerá práce s daty tabulky probíhá přes rozhraní `IRepository<TEntity>`. Nemusíte se ani starat o jeho umístění do IoC, protože je registrováno voláním příslušné tovární metody. 1. Musíte řídit vytvoření tabulky v databázi. Abychom vyřešili poslední bod, musíme se zabývat druhým frameworkem z této kombinace, a to FluentMigratorem. ## FluentMigrator > [!NOTE] > > Fluent Migrator je migrační framework pro .NET podobný migracím v Ruby on Rails. *Migrace* představují strukturovaný způsob změny databázového schématu a jsou alternativou k vytváření množství skriptů SQL, které musí ručně spouštět každý zapojený vývojář. Migrace řeší problém vývoje databázového schématu pro více databází (například lokální databázi vývojáře, testovací databázi a produkční databázi). Změny databázového schématu jsou popsány ve třídách napsaných v C#. Tyto třídy lze ukládat do systému správy verzí. Podrobný postup přidání vlastních entit je popsán v následujícím článku: [Plugin s přístupem k datům](xref:cs/developer/plugins/how-to-write-plugin-4.70). Zde se proto zastavíme pouze u obecných teoretických bodů: 1. Migrace jsou podporovány na úrovni samotného kódu nopCommerce. 1. Můžete vytvářet libovolné migrace zděděné z abstraktní třídy **MigrationBase**. 1. Pro zjednodušení správy verzí migrací jsme do kódu přidali atribut **NopMigrationAttribute** zděděný z **MigrationAttribute**. Nyní můžete místo obvyklého dlouhého čísla jednoduše uvést datum a čas vytvoření migrace. 1. Přidali jsme také atribut **SkipMigrationOnUpdateAttribute**, který určuje, zda se má migrace během procesu aktualizace přeskočit. 1. Tabulku v databázi můžete vytvořit dvěma způsoby: * Použijte metodu **Create.Table** v metodě **Up** vaší migrační třídy a všechny podrobnosti zadejte pomocí rozšiřujících metod. * Použijte metodu **IMigrationManager.BuildTable\<T\>** v metodě **Up** vaší migrační třídy a všechny podrobnosti v případě potřeby zadejte pomocí implementace rozhraní **IEntityBuilder** a **INameCompatibility** (v nopCommerce používáme tento přístup). > [!IMPORTANT] > > Abyste mohli spustit nové migrace, musíte zvýšit verzi v souboru plugin.json. --- <!-- page: Inverze řízení a dependency injection | url: http://nopdocs.service.hedr.dev/cs/developer/tutorials/inversion-of-control.html | source: cs/developer/tutorials/inversion-of-control.md --> # Inverze řízení a dependency injection Inverze řízení (Inversion of Control) a vkládání závislostí (Dependency Injection) jsou dva související způsoby, jak rozvolnit závislosti v aplikacích. [Inverze řízení (IoC)](https://en.wikipedia.org/wiki/Inversion_of_control) znamená, že objekty nevytvářejí jiné objekty, na které se při své práci spoléhají. Místo toho získávají potřebné objekty z vnějšího zdroje. [Dependency Injection (DI)](http://en.wikipedia.org/wiki/Dependency_injection) znamená, že se tak děje bez zásahu objektu, obvykle prostřednictvím komponenty frameworku, která předává parametry konstruktoru a nastavuje vlastnosti. Martin Fowler napsal skvělý popis Dependency Injection neboli *inverze řízení*. Jeho práci zde nebudeme opakovat, jeho článek najdete [zde](https://martinfowler.com/articles/injection.html). nopCommerce používá vestavěný DI kontejner ASP.NET Core, který je reprezentován rozhraním `IServiceProvider`. Tento kontejner je zodpovědný za mapování závislostí na konkrétní typy a za vkládání závislostí do různých objektů. Jakmile napíšete službu a odpovídající rozhraní, které služba implementuje, měli byste je zaregistrovat v libovolné třídě implementující rozhraní `INopStartup` (jmenný prostor `Nop.Core.Infrastructure`). Za registraci služeb v aplikaci je zodpovědná metoda `ConfigureServices`. Služby se do projektu přidávají prostřednictvím parametru `IServiceCollection`. ```csharp public class NopStartup : INopStartup { public virtual void ConfigureServices(IServiceCollection services, IConfiguration configuration) { services.AddScoped<IWebHelper, WebHelper>(); ... } public void Configure(IApplicationBuilder application) { } public int Order => 2000; } ``` Můžete vytvořit tolik tříd pro registraci závislostí, kolik potřebujete. Všimněte si, že každá třída implementující rozhraní **INopStartup** má vlastnost **Order**. Ta umožňuje nahradit existující závislosti. Chcete-li přepsat závislosti nopCommerce, nastavte vlastnost `Order` na hodnotu větší než 0. nopCommerce třídy závislostí seřadí a spouští je ve vzestupném pořadí. Čím vyšší číslo, tím později budou vaše objekty zaregistrovány. Tímto způsobem zaregistrujete jak vestavěné služby ASP.NET Core, tak své vlastní; stejný mechanismus registrace platí i pro registraci služeb v pluginech. --- <!-- page: Registrace nových rout | url: http://nopdocs.service.hedr.dev/cs/developer/tutorials/register-new-routes.html | source: cs/developer/tutorials/register-new-routes.md --> # Registrace nových rout [Routování ASP.NET Core](https://docs.microsoft.com/aspnet/core/fundamentals/routing) je zodpovědné za mapování příchozích požadavků prohlížeče na konkrétní akce MVC controllerů. nopCommerce obsahuje rozhraní `IRouteProvider`, které se používá k registraci rout při spuštění aplikace. Všechny hlavní routy jsou registrovány ve třídách `RouteProvider` a `GenericUrlRouteProvider` umístěných v projektu *`Nop.Web`*. Můžete vytvořit tolik tříd `RouteProvider`, kolik potřebujete. Pokud má například váš plugin vlastní routy, které chcete zaregistrovat, vytvořte novou třídu implementující rozhraní `IRouteProvider` a zaregistrujte routy specifické pro váš nový plugin. ```csharp /// <summary> /// Represents plugin route provider /// </summary> public class RouteProvider : IRouteProvider { /// <summary> /// Register routes /// </summary> /// <param name="endpointRouteBuilder">Route builder</param> public void RegisterRoutes(IEndpointRouteBuilder endpointRouteBuilder) { endpointRouteBuilder.MapControllerRoute(PayPalCommerceDefaults.ConfigurationRouteName, "Admin/PayPalCommerce/Configure", new { controller = "PayPalCommerce", action = "Configure" }); } /// <summary> /// Gets a priority of route provider /// </summary> public int Priority => 0; } ``` --- <!-- page: Úvod do systému pluginů | url: http://nopdocs.service.hedr.dev/cs/developer/tutorials/description-of-plugin-system.html | source: cs/developer/tutorials/description-of-plugin-system.md --> # Úvod do systému pluginů ## Jak inicializovat nový plugin (jak vytvořit nový projekt pluginu) nopCommerce používá k rozšíření funkčnosti obchodu nopCommerce systém pluginů. Pluginy jsou sadou nezávislých programů nebo komponent, které lze přidat do existujícího systému a rozšířit tak určitou konkrétní funkčnost, a které lze ze systému také odebrat, aniž by to během procesu ovlivnilo hlavní systém. > [!NOTE] > > Více informací o tom, jak vytvořit plugin, najdete na [**této stránce**.](xref:cs/developer/plugins/index) ## Jak vyhledávat a používat pluginy z obchodu nopCommerce nopCommerce již obsahuje několik předpřipravených pluginů, které jsou ihned k použití. Můžete také vyhledat řadu pluginů dostupných na oficiálním marketplace nopCommerce a zjistit, zda již někdo nevytvořil plugin, který vyhovuje vašim potřebám. Pokud ne, můžete si vždy vytvořit vlastní plugin podle svých požadavků. Zde se ale podívejme, jak najít a používat pluginy z obchodu nopCommerce. Pro tento účel má nopCommerce marketplace, kde najdeme různé motivy a pluginy. Najdete jej na adrese [nopCommerce Marketplace](https://www.nopcommerce.com/marketplace). ![image4](_static/description-of-plugin-system/image4.png) Zde vidíte tři karty. Karta **All** obsahuje všechny motivy a rozšíření, karta **Themes** obsahuje všechny motivy nopCommerce, které slouží jako vzhled webu nopCommerce, a konečně karta **Extensions**, kde najdeme pluginy. Přejděte tedy na kartu Extensions. Zde najdete všechny bezplatné i komerční pluginy. Konkrétní plugin, který hledáte, můžete vyhledat zde. Na pravé straně najdete sekci filtrování, pomocí které můžete výběr zúžit. Jakmile hledaný plugin najdete, stačí jej stáhnout a nainstalovat. Každý plugin má na své stránce ke stažení úplný popis toho, jak jej používat, takže si tyto popisy nezapomeňte přečíst. ## Rozhraní `IPlugin` `IPlugin` je rozhraní, které zpřístupňuje funkce používané při instalaci nebo odinstalaci pluginu. Každý projekt pluginu musí obsahovat třídu, která toto rozhraní implementuje, aby nopCommerce tento projekt považoval za plugin. ### Metoda `GetConfigurationPageUrl` ```cs string GetConfigurationPageUrl() ``` Tato metoda by měla vracet URL konfiguračního view. Když plugin nainstalujeme, uvidíme tlačítko `Configuration`; pokud tedy tuto metodu v naší třídě implementujeme, řetězec, který z ní vrátíme, bude použit jako URL tohoto tlačítka `configuration`. ### Vlastnost `PluginDescriptor` ```cs PluginDescriptor PluginDescriptor{ get; set; } ``` Tato vlastnost slouží k získání nebo nastavení informací popisujících aktuální plugin. Když píšeme nový plugin nebo widget, musíme vytvořit soubor **plugin.json**. nopCommerce používá tentýž soubor k inicializaci hodnoty této vlastnosti. ### Metoda `InstallAsync` ```cs Task InstallAsync(); ``` Metoda se spouští při instalaci pluginu; tato logika obvykle implementuje inicializaci nastavení, lokalizačních řetězců a další infrastruktury pro správnou konfiguraci pluginu. ### Metoda `UninstallAsync` ```cs Task UninstallAsync(); ``` Tato metoda je opakem metody „InstallAsync“; po odinstalaci pluginu by měla zcela odstranit všechny prostředky, které mu byly přiděleny. ### Metoda `UpdateAsync` ```cs Task UpdateAsync(string currentVersion, string targetVersion); ``` Metoda slouží k aktualizaci pluginu na zadanou verzi. ### Metoda `PreparePluginToUninstallAsync` ```cs Task PreparePluginToUninstallAsync() ``` Tato metoda se zavolá, když u pluginu klikneme na tlačítko `UninstallAsync`. Kód uvnitř této metody se spustí předtím, než nopCommerce plugin ze systému odinstaluje. V této metodě můžeme chtít napsat logiku, která ověří, zda lze náš plugin odinstalovat. Můžeme zde například zkontrolovat, zda existují jiné pluginy, které na pluginu, jejž se snažíme odinstalovat, závisejí. Pokud ano, můžeme chtít uživatelům zabránit v odinstalaci pluginu, dokud nebude odinstalován plugin, který na aktuálním pluginu závisí. ## Třída `PluginDescriptor` Tato třída, jak již název napovídá, uchovává informace popisující plugin. Pokud porovnáte *vlastnosti* této třídy s *klíči* ze souboru **plugin.json**, uvidíte podobnou strukturu. Je to proto, že tato třída **PluginDescriptor.cs** slouží k namapování souboru **plugin.json** na třídu C#, aby nopCommerce mohl informace uvedené v **plugin.json** používat. Kromě těchto vlastností obsahuje třída `PluginDescriptor` ještě několik dalších vlastností a pomocných metod. ### Vlastnost `Installed` ```cs public virtual bool Installed { get; set; } ``` Tato vlastnost slouží k ověření, zda je plugin v naší aplikaci nopCommerce nainstalován, či nikoli. ### Vlastnost `PluginType` ```cs public virtual Type PluginType { get; set; } ``` Slouží k získání nebo nastavení typu pluginu. Tento typ odkazuje na třídu, která v projektu pluginu implementuje rozhraní `IPlugin`. ### Vlastnost `OriginalAssemblyFile` ```cs public virtual string OriginalAssemblyFile { get; set; } ``` Slouží k získání nebo nastavení původního souboru sestavení (assembly), ze kterého byla vytvořena stínová kopie. ### Vlastnost `ReferencedAssembly` ```cs public virtual Assembly ReferencedAssembly { get; set; } ``` Slouží k získání nebo nastavení stínově zkopírovaného sestavení, které je v aplikaci aktivní. ### Vlastnost `ShowInPluginsList` ```cs public virtual bool ShowInPluginsList { get; set; } = true; ``` Tato vlastnost určuje, zda chceme plugin zobrazovat v seznamu pluginů, či nikoli. ### Metoda GetPluginDescriptorFromText ```cs public static PluginDescriptor GetPluginDescriptorFromText(string text) ``` Tato metoda přijímá jako vstup *řetězec json* a parsuje jej na typ `PluginDescriptor`. Vrací `PluginDescriptor` získaný z *řetězce json*. ### Metoda `Save` ```cs public virtual void Save() ``` Slouží k uložení popisu pluginu z `PluginDescriptor` do souboru **plugin.json**. ### Metoda `CompareTo` ```cs public int CompareTo(PluginDescriptor other) ``` Porovná aktuální instanci `PluginDescriptor` s jinou instancí `PluginDescriptor` předanou jako parametr, a to porovnáním vlastnosti *FriendlyName*. Vrací celé číslo, které udává, zda tato instance v pořadí řazení předchází zadanému parametru, následuje po něm, nebo se nachází na stejné pozici. ### Metoda `Instance` ```cs public virtual TPlugin Instance<TPlugin>() where TPlugin : class, IPlugin ``` Tato metoda slouží k získání instance *pluginu* typu daného vlastností `PluginType` z aktuálního `PluginDescriptor`. ## Rozhraní `IPluginManager` `IPluginManager` je generické rozhraní s typovým parametrem třídy. Obsahuje deklarace metod používaných k načítání pluginů pomocí různých parametrů filtrů. Implementaci tohoto rozhraní najdeme ve třídě `PluginManager`, která se nachází ve jmenném prostoru `{Nop.Services.Plugins}`. --- <!-- page: Vývoj nového pluginu | url: http://nopdocs.service.hedr.dev/cs/developer/tutorials/guide-to-expanding-the-functionality-of-the-basic-functions-of-nop-commerce-through-a-plugin.html | source: cs/developer/tutorials/guide-to-expanding-the-functionality-of-the-basic-functions-of-nop-commerce-through-a-plugin.md --> # Vývoj nového pluginu ## Přehled nopCommerce používá systém pluginů k rozšíření funkcí administrace a systém widgetů k rozšíření funkcí webu. Pluginy a widgety jsou sadou nezávislých programů nebo komponent, které lze přidat do existujícího systému a rozšířit tak určitou funkci, a které lze ze systému také odebrat, aniž by to ovlivnilo hlavní systém. Díky konceptu pluginů a widgetů tak můžeme do systému přidávat další funkce a vytvářet je bez změny nebo úprav zdrojového kódu jádra řešení nopCommerce. To nám umožňuje aktualizovat naše řešení nopCommerce na nejnovější verzi nebo se vrátit ke starší verzi podle potřeby, aniž bychom museli přepisovat již vytvořené pluginy a widgety. ## Pluginy vs. widgety Jak víme, pluginy i widgety slouží k rozšíření funkcí řešení nopCommerce. Možná se tedy zeptáte: „Jaký je mezi nimi rozdíl?“ V nopCommerce si widget můžete představit jako plugin s jednou funkcí navíc. Postup vytvoření widgetu je z velké části stejný jako u pluginu, ale pomocí widgetů můžeme na veřejném webu nopCommerce zobrazit určité UI (uživatelské rozhraní) v konkrétních oblastech předdefinovaných nopCommerce, které se nazývají zóny widgetů (widget-zones). Toho samotným pluginem dosáhnout nelze. Widget si můžete představit jako podmnožinu pluginu. >[!NOTE] > >Všechny dostupné zóny widgetů najdete ve jmenném prostoru `Nop.Web.Framework.Infrastructure`: > >- Zóny widgetů administrace najdete v souboru **AdminWidgetZones.cs**. > >- Zóny widgetů veřejné části obchodu najdete v souboru **PublicWidgetZones.cs**. Nyní byste už měli mít jasnější představu o tom, co jsou widgety a pluginy, kdy je lze použít a jaké jsou výhody jejich používání. Pojďme tedy vytvořit jednoduchý widget, který na veřejném webu zobrazí zprávu „Hello World“, abychom pochopili, jak se widget v nopCommerce vytváří. ## Inicializace projektu pluginu ### Krok 1: Vytvoření nového projektu Přejděte na oficiální web nopCommerce a stáhněte si nejnovější zdrojový kód nopCommerce. Otevřete řešení nopCommerce ve svém oblíbeném IDE (doporučujeme Microsoft Visual Studio). Pokud se chcete dozvědět více o struktuře projektu, přečtěte si nejprve článek [„Organizace zdrojového kódu“](xref:cs/developer/tutorials/source-code-organization). V horní části řešení uvidíte složku *Plugins*; po jejím rozbalení uvidíte seznam projektů pluginů, které jsou ve výchozím stavu dodávány s nopCommerce. ![image1](_static/guide-to-expanding-the-functionality-of-the-basic-functions-of-nop-commerce-through-a-plugin/image1.png) Chcete-li vytvořit nový projekt widgetu, klikněte pravým tlačítkem na složku *Plugins*: **Add** -> **New Project** a zobrazí se okno „add new project“. ![image2](_static/guide-to-expanding-the-functionality-of-the-basic-functions-of-nop-commerce-through-a-plugin/image2.png) Vyberte šablonu projektu **Class Library** a přejděte k dalšímu kroku, kde bude potřeba zadat název projektu. ![image2_1](_static/guide-to-expanding-the-functionality-of-the-basic-functions-of-nop-commerce-through-a-plugin/image2_1.png) nopCommerce dodržuje určité standardní konvence pojmenování, o kterých najdete více informací v dokumentaci nopCommerce. V souladu s konvencí pojmenování nopCommerce jsem jako název projektu zvolil `Nop.Plugin.Widget.HelloWorld`. Umístění by mělo být uvnitř adresáře */src/Plugins*. Nyní klikněte na **Next**. ![image2_2](_static/guide-to-expanding-the-functionality-of-the-basic-functions-of-nop-commerce-through-a-plugin/image2_2.png) Tím by se měl vytvořit nový projekt uvnitř adresáře Plugin. Ve svém řešení jej uvidíte takto: ![image3](_static/guide-to-expanding-the-functionality-of-the-basic-functions-of-nop-commerce-through-a-plugin/image3.png) ### Krok 2: Konfigurace nového projektu pro použití jako widget Aby bylo možné náš projekt použít jako *plugin* nebo *widget*, musíme v něm nakonfigurovat několik věcí. Po úspěšném vytvoření projektu otevřete jeho soubor `.csproj` – klikněte pravým tlačítkem na projekt, v kontextové nabídce zvolte položku `{Your_Project_Name.csproj}` a nahraďte jeho obsah následujícím kódem. ```xml <Project Sdk="Microsoft.NET.Sdk"> <PropertyGroup> <TargetFramework>net10.0</TargetFramework> <Copyright>SOME_COPYRIGHT</Copyright> <Company>YOUR_COMPANY</Company> <Authors>SOME_AUTHORS</Authors> <PackageLicenseUrl>PACKAGE_LICENSE_URL</PackageLicenseUrl> <PackageProjectUrl>PACKAGE_PROJECT_URL</PackageProjectUrl> <RepositoryUrl>REPOSITORY_URL</RepositoryUrl> <RepositoryType>Git</RepositoryType> <OutputPath>$(SolutionDir)\Presentation\Nop.Web\Plugins\{PLUGIN_OUTPUT_DIRECTORY}</OutputPath> <OutDir>$(OutputPath)</OutDir> <!--Set this parameter to true to get the dlls copied from the NuGet cache to the output of your project. You need to set this parameter to true if your plugin has a nuget package to ensure that the dlls copied from the NuGet cache to the output of your project--> <CopyLocalLockFileAssemblies>false</CopyLocalLockFileAssemblies> <ImplicitUsings>enable</ImplicitUsings> </PropertyGroup> <ItemGroup> <ProjectReference Include="$(SolutionDir)\Presentation\Nop.Web.Framework\Nop.Web.Framework.csproj" /> <ClearPluginAssemblies Include="$(SolutionDir)\Build\ClearPluginAssemblies.proj" /> </ItemGroup> <!-- This target execute after "Build" target --> <Target Name="NopTarget" AfterTargets="Build"> <!-- Delete unnecessary libraries from plugins path --> <MSBuild Projects="@(ClearPluginAssemblies)" Properties="PluginPath=$(OutDir)" Targets="NopClear" /> </Target> </Project> ``` Zde nahraďte `{Plugin_Output_Directory}` názvem svého projektu, v mém případě *Widget.HelloWorld*. Tím se všechny soubory DLL související s tímto projektem zkopírují do `Nop.Web/Plugin/{Plugin_Output_Directory}`, protože adresář *Plugin* uvnitř `Nop.Web` je místo, kde nopCommerce hledá pluginy a widgety, které zobrazuje v seznamu *pluginů* nebo *widgetů* v administraci. ### Krok 3: Vytvoření souboru plugin.json Tento soubor je povinný pro každý *plugin* nebo *widget*, který pro nopCommerce vytvoříme. Obsahuje metainformace, které náš plugin popisují. Obsahuje informace jako název pluginu, pro kterou verzi nopCommerce je určen/sestaven, popis pluginu, verzi pluginu a podobně. Více informací najdete v článku [Soubor plugin.json](xref:cs/developer/plugins/plugin_json). ### Krok 4: Vytvoření třídy, která dědí z třídy BasePlugin Potřebujeme třídu, která dědí z rozhraní `IPlugin`, aby nopCommerce považoval náš projekt za plugin. nopCommerce však již obsahuje třídu `BasePlugin`, která dědí z rozhraní `IPlugin` a implementuje všechny jeho metody. Místo dědění z rozhraní `IPlugin` tedy můžeme rozšířit třídu `BasePlugin`. Pokud máme nějakou logiku, která se má provést během instalace a odinstalace našeho pluginu/widgetu, můžeme v naší třídě přepsat metody `InstallAsync` a `UninstallAsync` třídy `BasePlugin`. Výsledná třída by měla vypadat takto ```cs public class HelloWorldPlugin: BasePlugin { public override async Task InstallAsync() { //Logic during installation goes here... await base.InstallAsync(); } public override async Task UninstallAsync() { //Logic during uninstallation goes here... await base.UninstallAsync(); } } ``` Nyní projekt sestavte a spusťte. Přejděte do administrace a v části **Konfigurace** (Configuration) klikněte na položku menu **Lokální pluginy** (Local plugins). Zde uvidíte seznam všech pluginů, které se nacházejí v adresáři `Nop.Web/Plugins`. Uvidíte zde i svůj nově vytvořený plugin. Pokud jej nevidíte, klikněte na tlačítko **Znovu načíst seznam pluginů** (Reload list of plugins); aplikace se poté restartuje a zobrazí všechny dostupné pluginy. Nyní byste měli svůj plugin vidět. Klikněte na zelené tlačítko **Instalovat** (Install) v řádku svého pluginu. ![image5](_static/guide-to-expanding-the-functionality-of-the-basic-functions-of-nop-commerce-through-a-plugin/image5.png) Po kliknutí na tlačítko instalace klikněte na tlačítko **Restartujte aplikaci pro použití změn** (Restart your application to apply changes). Aplikace se restartuje a plugin se nainstaluje. Po dokončení instalace uvidíte tlačítka *Konfigurovat* (Configure) a *Upravit* (Edit) a tlačítko *Odinstalovat* (Uninstall), jako na obrázku. ![image6](_static/guide-to-expanding-the-functionality-of-the-basic-functions-of-nop-commerce-through-a-plugin/image6.png) Nyní je váš plugin nainstalován. Tlačítko *Konfigurovat* však fungovat nebude, protože náš plugin nemá žádnou konfigurační stránku. ## Vytvoření widgetu pro zobrazení UI na veřejném webu Jak již bylo zmíněno, *widget* je totéž co plugin, ale s funkcemi navíc. Stejný projekt pluginu tedy můžeme převést na widget a vykreslit na veřejném webu nějaké UI. Podívejme se, jak tento plugin rozšířit a udělat z něj widget. Nejprve musíme vytvořit `ViewComponent`. V kořeni projektu vytvořte adresář *Components* a v něm třídu **`ViewComponent`**. Tato třída musí dědit ze základní třídy `NopViewComponent`. ```cs public class ExampleWidgetViewComponent: NopViewComponent { public IViewComponentResult Invoke(string widgetZone, object additionalData) { return Content("Hello World"); } } ``` Nyní se vraťte k dříve vytvořené třídě, která rozšiřuje `BasePlugin`, a nechte ji dědit také z rozhraní `IWidgetPlugin`. Toto rozhraní obsahuje deklarace dvou funkcí, `GetWidgetZones` a `GetWidgetViewComponent`, které musíme v naší třídě implementovat. ```cs public class HelloWorldPlugin: BasePlugin, IWidgetPlugin { /// <summary> /// Gets a value indicating whether to hide this plugin on the widget list page in the admin area /// </summary> public bool HideInWidgetList => false; /// <summary> /// Gets a type of a view component for displaying widget /// </summary> /// <param name="widgetZone">Name of the widget zone</param> /// <returns>View component type</returns> public Type GetWidgetViewComponent(string widgetZone) { return typeof(ExampleWidgetViewComponent); } /// <summary> /// Gets widget zones where this widget should be rendered /// </summary> /// <returns> /// A task that represents the asynchronous operation /// The task result contains the widget zones /// </returns> public Task<IList<string>> GetWidgetZonesAsync() { return Task.FromResult<IList<string>>(new List<string> { "home_page_before_categories" }); } public override async Task InstallAsync() { //Logic during installation goes here... await base.InstallAsync(); } public override async Task UninstallAsync() { //Logic during uninstallation goes here... await base.UninstallAsync(); } } ``` Pokud nyní projekt sestavíte, přejdete do administrace a otevřete **Konfigurace -> Widgety** (Configuration -> Widgets), uvidíte svůj widget v seznamu. ![image7](_static/guide-to-expanding-the-functionality-of-the-basic-functions-of-nop-commerce-through-a-plugin/image7.png) Můžete si všimnout, že tento widget nemá tlačítko *Konfigurovat* (Configure). Je to proto, že jsme pro tento widget nevytvořili konfigurační soubor view a nepřepsali metodu `GetConfigurationPageUrl` třídy `BasePlugin`. Protože jsme plugin již nainstalovali, nemusíme jej instalovat znovu, ale vidíte, že widget nyní není aktivní. Aktivovat jej můžeme kliknutím na tlačítko *Upravit* (Edit). ![image8](_static/guide-to-expanding-the-functionality-of-the-basic-functions-of-nop-commerce-through-a-plugin/image8.png) Po nastavení widgetu jako aktivního by měl widget fungovat podle očekávání. Pokud přejdeme na úvodní stránku, měli bychom před kategoriemi vidět zprávu „Hello World“, jak je znázorněno na obrázku (zvýrazněno žlutě). ![image9](_static/guide-to-expanding-the-functionality-of-the-basic-functions-of-nop-commerce-through-a-plugin/image9.png) --- <!-- page: Použití DataTables | url: http://nopdocs.service.hedr.dev/cs/developer/tutorials/guide-to-creating-a-page-containing-a-reporting-table-of-datatables.html | source: cs/developer/tutorials/guide-to-creating-a-page-containing-a-reporting-table-of-datatables.md --> # Použití DataTables V tomto návodu se naučíme, jak rozšířit funkčnost nopCommerce o vlastní funkce pro administraci a vytvořit stránku obsahující tabulku s daty jako report. Než s tímto návodem začnete, měli byste mít určité předchozí znalosti a porozumění následujícím tématům. * [Architektura nopCommerce](xref:cs/developer/tutorials/source-code-organization). * [Plugin nopCommerce](xref:cs/developer/tutorials/guide-to-expanding-the-functionality-of-the-basic-functions-of-nop-commerce-through-a-plugin). * [Routing v nopCommerce](xref:cs/developer/tutorials/register-new-routes). Pokud výše uvedená témata neznáte, důrazně doporučujeme se s nimi nejprve seznámit. Tento návod vám ukáže, jak vytvořit tabulku, která zobrazuje informace o rozložení uživatelů podle zemí (na základě fakturační adresy). Projděme si krok za krokem proces vytvoření této funkce. ## Vytvoření projektu pluginu nopCommerce Předpokládáme, že již víte, kde a jak vytvořit projekt pluginu nopCommerce a nakonfigurovat jej podle standardů nopCommerce. Pokud ne, navštivte [tuto stránku](xref:cs/developer/plugins/how-to-write-plugin-4.70), kde se dozvíte, jak projekt pluginu nopCommerce vytvořit a nakonfigurovat. Pokud jste projekt pluginu vytvořili a nakonfigurovali podle výše uvedeného odkazu, měli byste mít strukturu složek podobnou této. ![image1](_static/guide-to-creating-a-page-containing-a-reporting-table-of-datatables/image1.png) ### Models/CustomersDistribution.cs Nejprve vytvořme ve složce **Models** model s názvem **CustomersDistribution**. ```cs public record CustomersDistribution : BaseNopModel { /// <summary> /// Country based on the billing address. /// </summary> public string Country { get; set; } /// <summary> /// Number of customers from a specific country. /// </summary> public int NoOfCustomers { get; set; } } ``` Do složky *Models* přidejme také vyhledávací model s názvem `CustomersByCountrySearchModel`. ```cs public record CustomersByCountrySearchModel : BaseSearchModel { } ``` nopCommerce pro přístup k datům používá návrhový vzor repository, který je ideální pro mechanismus dependency injection. ### Services/ICustomersByCountry.cs Nyní vytvořme službu, která načítá potřebná data z databáze. Pro službu vytvoříme rozhraní a třídu služby, která toto rozhraní implementuje. ```cs public interface ICustomersByCountry { Task<List<CustomersDistribution>> GetCustomersDistributionByCountryAsync() } ``` ### Services/CustomersByCountry.cs Zde vytváříme třídu s názvem **CustomersByCountry**, která implementuje rozhraní **ICustomersByCountry**. ```cs public class CustomersByCountry : ICustomersByCountry { private readonly IAddressService _addressService; private readonly ICountryService _countryService; private readonly ICustomerService _customerService; public CustomersByCountry(IAddressService addressService, ICountryService countryService, ICustomerService customerService) { _addressService = addressService; _countryService = countryService; _customerService = customerService; } public async Task<List<CustomersDistribution>> GetCustomersDistributionByCountryAsync() { return await _customerService.GetAllCustomersAsync() .Where(c => c.ShippingAddressId != null) .Select(c => new { await (_countryService.GetCountryByAddressAsync(_addressService.GetAddressById(c.ShippingAddressId ?? 0))).Name, c.Username }) .GroupBy(c => c.Name) .Select(cbc => new CustomersDistribution { Country = cbc.Key, NoOfCustomers = cbc.Count() }).ToList(); } } ``` Implementovali jsme metodu rozhraní, která načítá data z databáze. Tento přístup jsme zvolili proto, abychom mohli tuto službu vložit do controlleru pomocí technik dependency injection. ### Infrastructure/PluginNopStartup.cs Abychom zaregistrovali naše rozhraní a jeho implementaci v kontejneru dependency injection (DI), musíme vytvořit třídu, která implementuje rozhraní INopStartup. Toto rozhraní obsahuje dvě metody a jednu vlastnost. Zaměříme se především na implementaci metody ConfigureServices, ve které naše rozhraní zaregistrujeme v DI kontejneru. ```cs /// <summary> /// Represents object for the configuring services on application startup /// </summary> public class PluginNopStartup : INopStartup { /// <summary> /// Add and configure any of the middleware /// </summary> /// <param name="services">Collection of service descriptors</param> /// <param name="configuration">Configuration of the application</param> public void ConfigureServices(IServiceCollection services, IConfiguration configuration) { //register custom services services.AddScoped<ICustomersByCountry, CustomersByCountry>(); } /// <summary> /// Configure the using of added middleware /// </summary> /// <param name="application">Builder for configuring an application's request pipeline</param> public void Configure(IApplicationBuilder application) { } /// <summary> /// Gets order of this startup configuration implementation /// </summary> public int Order => 3000; } ``` ### Controllers/CustomersByCountryController.cs Nyní vytvořme třídu controlleru. Osvědčeným postupem je pojmenovávat controllery pluginů ve tvaru *{Group}{Name}Controller.cs*. Například TutorialCustomersByCountryController, tedy *{Tutorial}{CustomersByCountry}Controller*. Pamatujte však, že pojmenování controlleru ve tvaru *{Group}{Name}* není povinné, jde pouze o způsob pojmenování doporučený nopCommerce; část Controller v názvu je však požadavkem .Net MVC. ```cs [AutoValidateAntiforgeryToken] [AuthorizeAdmin] //confirms access to the admin panel [Area(AreaNames.Admin)] //specifies the area containing a controller or action public class DistOfCustByCountryPluginController : BasePluginController { private readonly ICustomersByCountry _service; public DistOfCustByCountryPluginController(ICustomersByCountry service) { _service = service; } [HttpGet] public IActionResult Configure() { CustomersByCountrySearchModel customerSearchModel = new CustomersByCountrySearchModel { AvailablePageSizes = "10" }; return View("~/Plugins/Tutorial.DistOfCustByCountry/Views/Configure.cshtml", customerSearchModel); } [HttpPost] public async Task<IActionResult> GetCustomersCountByCountry() { try { return Ok(new DataTablesModel { Data = await _service.GetCustomersDistributionByCountryAsync() }); } catch (Exception ex) { return BadRequest(ex); } } } ``` Do controlleru vkládáme dříve vytvořenou službu **ICustomersByCountry**, abychom získali data z databáze. Vytvořili jsme zde dvě akce, jednu typu `HttpGet` a druhou typu `HttpPost`. Akce `Configure` vrací view s názvem „Configure.cshtml“, které jsme zatím nevytvořili. Akce `GetCustomersCountByCountry` pomocí vložené služby načítá data a vrací je ve formátu JSON. Tuto akci bude volat datová tabulka, která očekává odpověď jako objekt `DataTablesModel`. Nastavujeme zde proto vlastnost data, což jsou data, která se v tabulce vykreslí. ### Views/Configure.cshtml Nyní vytvořme view s *DataTables*, ve kterém zobrazíme naše data, aby si je mohli prohlížet naši uživatelé. ```cs @using Nop.Web.Framework.Models.DataTables @{ Layout = "_ConfigurePlugin"; } @await Html.PartialAsync("Table", new DataTablesModel { Name = "customersDistributionByCountry-grid", UrlRead = new DataUrl("GetCustomersCountByCountry", "TutorialCustomersByCountry"), Paging = false, ColumnCollection = new List<ColumnProperty> { new ColumnProperty(nameof(CustomersDistribution.Country)) { Title = "Country", Width = "300" }, new ColumnProperty(nameof(CustomersDistribution.NoOfCustomers)) { Title = "Number Of Customers", Width = "100" } } }) ``` ### Views/_ViewImports.cshtml Soubor *_ViewImports.cshtml* obsahuje kód pro import všech potřebných referencí pro naše soubory view. ```cs @inherits Nop.Web.Framework.Mvc.Razor.NopRazorPage<TModel> @addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers @addTagHelper *, Nop.Web.Framework @using Microsoft.AspNetCore.Mvc.ViewFeatures @using Nop.Web.Framework.UI @using Nop.Web.Framework.Extensions @using System.Text.Encodings.Web @using Nop.Plugin.Tutorial.DistOfCustByCountry.Models @using Nop.Web.Framework.Models.DataTables; @using Microsoft.AspNetCore.Routing; ``` * V `Configure.cshtml` používáme částečné view (partial view) s názvem **`Table`**. Jde o implementaci *JQuery DataTables* v nopCommerce. Tento soubor najdeme v `Nop.Web/Areas/Admin/Views/Shared/Table.cshtml`. Tam uvidíte kód implementace *DataTables*. Tento view model přijímá pro konfiguraci *DataTables* třídu `DataTablesModel`. Vysvětleme si vlastnosti, které jsme pro třídu `DataTablesModel` nastavili. * **Name:** Nastaví se jako id pro *DataTables*. * **UrlRead:** URL, ze které bude *DataTables* načítat data k vykreslení v tabulce. Zde nastavujeme URL na akci **`GetCustomersCountByCountry`** controlleru `TutorialCustomersByCountry`, ze které získáváme data pro *DataTables*. * **Paging:** Tato vlastnost slouží k zapnutí nebo vypnutí stránkování pro DataTables. * **ColumnCollection:** Tato vlastnost obsahuje konfiguraci sloupců. Existuje řada dalších vlastností, se kterými můžete experimentovat, abyste pochopili, k čemu každá z nich slouží. ### Infrastructure/RouteProvider Posledním krokem je registrace naší cesty (route) pro akci „GetCustomersCountByCountry“ controlleru „TutorialCustomersByCountry“. Cestu pro akci „Configure“ registrovat nemusíme, protože jsme ji již zaregistrovali ve třídě `DistOfCustByCountryPlugin`. ```cs /// <summary> /// Represents plugin route provider /// </summary> public class RouteProvider : IRouteProvider { /// <summary> /// Register routes /// </summary> /// <param name="endpointRouteBuilder">Route builder</param> public void RegisterRoutes(IEndpointRouteBuilder endpointRouteBuilder) { //add route for the access token callback endpointRouteBuilder.MapControllerRoute("CustomersDistributionByCountry", "Plugins/Tutorial/CustomerDistByCountry/", new { controller = "TutorialCustomersByCountry", action = "GetCustomersCountByCountry" }); } /// <summary> /// Gets a priority of route provider /// </summary> public int Priority => 0; } ``` >[!NOTE] > > Více o routingu v nopCommerce se dozvíte na [této stránce](xref:cs/developer/tutorials/register-new-routes) Nyní stačí projekt sestavit a spustit. Přihlaste se jako administrátor a přejděte do nabídky *Lokální pluginy* (Local plugins) v sekci *Konfigurace* (Configuration), kde uvidíte svůj nově vytvořený plugin. Nainstalujte jej. Po dokončení instalace uvidíte u svého pluginu tlačítko *Konfigurovat* (Configure). Pokud jste postupovali podle tohoto návodu správně, uvidíte výstup podobný obrázku níže: ![image2](_static/guide-to-creating-a-page-containing-a-reporting-table-of-datatables/image2.png) --- <!-- page: Validace dat | url: http://nopdocs.service.hedr.dev/cs/developer/tutorials/data-validation.html | source: cs/developer/tutorials/data-validation.md --> # Validace dat Validace dat je proces, který zajišťuje, že program pracuje s čistými a správnými daty. Většina vývojářů v .NET používá `Data Annotation Validators`. nopCommerce však používá **`Fluent Validation`**. Jde o malou validační knihovnu pro .NET, která k vytváření validačních pravidel pro vaše obchodní objekty používá fluent rozhraní a lambda výrazy. Chcete-li v nopCommerce přidat validaci pro model, postupujte takto: Vytvořte třídu odvozenou od třídy `AbstractValidator` a umístěte do ní veškerou potřebnou logiku. ```csharp public partial class AddressValidator : BaseNopValidator<AddressModel> { public AddressValidator(ILocalizationService localizationService) { RuleFor(x => x.FirstName) .NotEmpty() .WithMessageAwait(localizationService.GetResourceAsync("AddressFields.FirstName.Required")); } } ``` ASP.NET Core spustí příslušný validátor, když je view model odeslán do controlleru. --- <!-- page: Publikování a zpracování událostí | url: http://nopdocs.service.hedr.dev/cs/developer/tutorials/events.html | source: cs/developer/tutorials/events.md --> # Publikování a zpracování událostí Události jsou oznámení rozesílaná zainteresovaným stranám. Události se spouštějí při změnách dat, jako je vkládání, aktualizace a mazání. nopCommerce umožňuje vývojářům „naslouchat“ událostem, které je mohou zajímat. Vývojář může s událostmi pracovat dvěma způsoby. Buď chce publikovat události, které zpracují posluchači, nebo se chce přihlásit k odběru událostí, které programově publikovali jiní vývojáři. 1. Pro publikování události musí vývojář získat instanci **IEventPublisher** a zavolat metodu **PublishAsync** s příslušnými daty události. ```csharp await _eventPublisher.PublishAsync(new OrderPlacedEvent(order)); ``` Třída události vypadá takto: ```csharp public class OrderPlacedEvent { public OrderPlacedEvent(Order order) { Order = order; } public Order Order { get; } } ``` 1. Pro naslouchání události vytvoří vývojář novou implementaci generického rozhraní **IConsumer**. Jakmile je nová implementace konzumenta vytvořena, nopCommerce ji pomocí reflexe vyhledá a zaregistruje pro zpracování událostí. ```csharp public class EventConsumer : IConsumer<OrderPlacedEvent> { public async Task HandleEventAsync(OrderPlacedEvent eventMessage) { if (eventMessage?.Order != null) { //do something } } } ``` --- <!-- page: API nastavení | url: http://nopdocs.service.hedr.dev/cs/developer/tutorials/settings.html | source: cs/developer/tutorials/settings.md --> # API nastavení Stejně jako každá jiná webová platforma má i nopCommerce nastavení, jako je „Název obchodu“ (Store name) nebo „Povolena pokladna na jedné stránce“ (One page checkout enabled). Nastavení lze v nopCommerce spravovat dvěma způsoby. 1. K načítání a ukládání jednotlivých nastavení můžete použít metody **GetSettingByKeyAsync** a **SetSettingAsync** implementace **ISettingService**. ```csharp var setting = await GetSettingByKeyAsync<string>(key); ... await _settingService.SetSettingAsync(key, value); ``` 2. Upřednostňovaným přístupem k práci s nastaveními v nopCommerce je vytvoření nové implementace rozhraní **ISettings**. Každé nastavení je reprezentováno vlastností C# a vývojáři by se měli spoléhat na to, že třídy nastavení budou v případě potřeby vloženy (injected) prostřednictvím konstruktoru. Níže je příklad třídy nastavení. ```csharp public partial class MediaSettings : ISettings { public int AvatarPictureSize { get; set; } public int ProductThumbPictureSize { get; set; } public int ProductDetailsPictureSize { get; set; } public int ProductThumbPictureSizeOnProductDetailsPage { get; set; } public int AssociatedProductPictureSize { get; set; } public int CategoryThumbPictureSize { get; set; } public int ManufacturerThumbPictureSize { get; set; } public int VendorThumbPictureSize { get; set; } public int CartThumbPictureSize { get; set; } public int OrderThumbPictureSize { get; set; } public int MiniCartThumbPictureSize { get; set; } public int AutoCompleteSearchThumbPictureSize { get; set; } public int ImageSquarePictureSize { get; set; } public bool DefaultPictureZoomEnabled { get; set; } public bool AllowSVGUploads { get; set; } public int MaximumImageSize { get; set; } public int DefaultImageQuality { get; set; } public bool MultipleThumbDirectories { get; set; } public bool ImportProductImagesUsingHash { get; set; } public string AzureCacheControlHeader { get; set; } public bool UseAbsoluteImagePath { get; set; } public string VideoIframeAllow { get; set; } public int VideoIframeWidth { get; set; } public int VideoIframeHeight { get; set; } public int ProductDefaultImageId { get; set; } } ``` --- <!-- page: Nastavení v souboru appsettings.json | url: http://nopdocs.service.hedr.dev/cs/developer/tutorials/appsettings-json-file.html | source: cs/developer/tutorials/appsettings-json-file.md --> # Nastavení v souboru appsettings.json ## Přehled Tento článek obsahuje popis souboru *appsettings.json*. Vysvětlíme v něm, jaká nastavení jsou v tomto souboru k dispozici, k čemu slouží a jak je použít ke změně funkčnosti/chování projektu nopCommerce. >[!IMPORTANT] > >Všechna nastavení lze přepsat pomocí proměnných prostředí. ## Přehled souboru appsettings.json Pokud jste již dříve pracovali na projektu *ASP.NET Core* nebo `ASP.NET Core` znáte, pravděpodobně jste soubor *appsettings.json* používali a máte představu o tom, co tento soubor je a k čemu slouží. >[!NOTE] > >Tento soubor můžete upravit také na stránce **Konfigurace → Nastavení → Nastavení aplikace** (Configuration → Settings → App settings). Soubor *appsettings.json* se obecně používá k uložení konfiguračních nastavení aplikace, jako jsou připojovací řetězce k databázi, globální proměnné s rozsahem celé aplikace a mnoho dalších informací. Ve skutečnosti lze v *ASP.NET Core* konfigurační nastavení aplikace ukládat do různých konfiguračních zdrojů, jako je soubor *appsettings.json*, soubor **`appsettings.{EnvironmentName}.json`** (kde `{Environment}` je aktuální hostingové prostředí aplikace, například Development, Staging nebo Production), `User Secrets` (kam se ukládají citlivé informace) atd. ## Nastavení dostupná v souboru appsettings.json ### DataConfig Prostřednictvím této sekce se konfiguruje připojení k databázi. * **ConnectionString** Toto nastavení očekává řetězcovou hodnotu. >[!NOTE] > >Připojovací řetězec bude mít formát specifický pro zvoleného poskytovatele databáze. > Například připojovací řetězec pro **SqlServer** vypadá takto: > >```powershell >Data Source={localhost};Initial Catalog={your_data_base_name}};Integrated >Security=False;Persist Security Info=False;User ID={your_user_id}};Password={your_password}};>Trust Server Certificate=True >``` * **DataProvider** Můžete zadat jednoho z podporovaných poskytovatelů dat: * [**SqlServer**](https://www.microsoft.com/sql-server) * [**MySql**](https://www.mysql.com/) * [**PostgreSQL**](https://www.postgresql.org/) * **SQLCommandTimeout** Nastavuje dobu čekání (v sekundách) před ukončením pokusu o provedení příkazu a vygenerováním chyby. Ve výchozím stavu není časový limit nastaven a použije se výchozí hodnota aktuálního poskytovatele. Nastavte **`0`** pro neomezený časový limit. * **WithNoLock** Určuje, zda se má do příkazů SELECT přidávat hint NoLock (týká se pouze SQL Serveru). ### AzureBlobConfig >[!IMPORTANT] > >Tato sekce nastavení se týká verze 4.80 a starších. Pro nopCommerce verze 4.90 a novější jsou [nastavení Azure popsána zde](xref:cs/developer/plugins/cloudflare-images). K ukládání blob dat můžeme použít *Azure Blob Storage*. nopCommerce již má tuto funkci integrovanou, stačí jen správně nastavit následující informace. Hodnoty těchto nastavení získáte v *Azure* při vytváření účtu úložiště. * **ConnectionString** Toto nastavení očekává řetězcovou hodnotu. Zde je třeba zadat připojovací řetězec `AzureBlobStorage`. * **ContainerName** Hodnota tohoto nastavení je také typu řetězec. V tomto nastavení zadáváme název kontejneru pro *Azure BLOB storage*. * **EndPoint** Toto nastavení také očekává řetězcovou hodnotu. Zde je třeba nastavit koncový bod (endpoint) pro *Azure BLOB storage*. * **AppendContainerName** Toto nastavení očekává logickou hodnotu. Nastavte hodnotu na **`true`** nebo **`false`** podle toho, zda se má při sestavování URL připojit název kontejneru k `EndPoint`. * **StoreDataProtectionKeys** Toto nastavení očekává logickou hodnotu. Nastavte hodnotu na **`true`**, pokud chcete pro *Data Protection Keys* používat *Windows Azure BLOB storage*. * **DataProtectionKeysContainerName** Toto nastavení očekává řetězcovou hodnotu. Zde je třeba nastavit název kontejneru Azure pro ukládání *Data Protection Keys* (tento kontejner by měl být oddělený od kontejneru používaného pro média a měl by být soukromý). * **DataProtectionKeysVaultId (volitelné)** Toto nastavení také očekává řetězcovou hodnotu. Nastavte `Azure key vault ID`, pokud potřebujete *Data Protection Keys* šifrovat. ### CacheConfig Konfigurace cache. * **DefaultCacheTime** Toto nastavení určuje dobu životnosti dat v cache. Výchozí hodnota je **`60`** minut. * **LinqDisableQueryCache** Určuje, zda se má vypnout ukládání LINQ výrazů dotazů do cache. Tato cache zkracuje čas potřebný k parsování dotazů, ale má několik vedlejších účinků. Například výrazy LINQ v cache mohou obsahovat odkazy na externí objekty jako parametry, což může vést k únikům paměti, pokud tyto objekty již jiný kód nepoužívá. Nebo synchronizace přístupu ke cache může způsobit větší latence, než kolik ušetří. ### CommonConfig *CommonConfig* obsahuje nastavení používaná ke konfiguraci chování samotného nopCommerce. Jde o objekt JSON a obsahuje několik nastavení, jejichž úpravou lze chování nopCommerce změnit. * **DisplayFullErrorStack** Toto nastavení očekává logickou hodnotu. Výchozí hodnota je **`false`**. Hodnotu můžete nastavit na **`true`**, pokud chcete v produkčním prostředí vidět úplnou chybu. To obvykle nedoporučujeme. Pokud ale máte dobrý důvod zobrazovat úplnou chybu v produkčním prostředí, můžete to provést tímto nastavením. Ve vývojovém prostředí se toto nastavení ignoruje a bez ohledu na nastavenou hodnotu se zobrazí úplná chyba. Lze říci, že ve vývojovém prostředí je toto nastavení vždy zapnuté. * **UserAgentStringsPath** Toto nastavení uchovává cestu k souboru `Browscap.xml`. `Browscap.xml` je, jak název souboru napovídá, databáze schopností prohlížečů. V podstatě jde o seznam všech známých prohlížečů a botů spolu s jejich výchozími schopnostmi a omezeními. ```powershell ~/App_Data/browscap.xml ``` >[!NOTE] > > V informatice je user agent software (softwarový agent), který jedná jménem uživatele, například webový prohlížeč, který „načítá, vykresluje a usnadňuje interakci koncového uživatele s webovým obsahem“. Více informací najdete na stránce [UserAgent](https://en.wikipedia.org/wiki/User_agent). * **CrawlerOnlyUserAgentStringsPath** Toto nastavení uchovává umístění/cestu k souboru `browscap.crawlersonly.xml`. Ukládá user agenty pouze pro „CrawlerOnly“. ```powershell ~/App_Data/browscap.crawlersonly.xml ``` * **CrawlerOnlyAdditionalUserAgentStringsPath** Toto nastavení uchovává umístění/cestu k souboru `additional.crawlers.xml`. Ukládá user agenty pouze pro „crawlery“. ```powershell ~/App_Data/additional.crawlers.xml ``` * **UseSessionStateTempDataProvider** Toto nastavení očekává logickou hodnotu. Výchozí hodnota je **`false`**. Hodnotu můžete nastavit na **`true`**, pokud chcete `TempData` ukládat do stavu relace (session). Ve výchozím stavu se k ukládání `TempData` do cookies používá poskytovatel `TempData` založený na cookies. * **ScheduleTaskRunTimeout** umožňuje nastavit časový limit běhu naplánované úlohy v milisekundách. Nastavte **`null`** pro použití výchozí hodnoty. * **StaticFilesCacheControl** určuje hodnotu hlavičky 'Cache-Control' pro statický obsah (v sekundách). ```powershell public,max-age=31536000 ``` * **ServeUnknownFileTypes** určuje, zda se mají poskytovat soubory, které nemají rozpoznaný typ obsahu. Výchozí hodnota je **`false`**. * **UseAutofac**. Hodnota určující, zda se má používat *Autofac IoC kontejner*. Pokud je vypnuto, použije se výchozí *.Net IoC kontejner*. * **PermitLimit**. Maximální počet povolení (permit), který lze v okně (1 minuta) povolit. Musí být nastaven na hodnotu `> 0` v okamžiku, kdy jsou tyto možnosti předány konstruktoru `FixedWindowRateLimiter`. Pokud je nastaveno na **`0`**, omezení je vypnuto. * **QueueCount**. Maximální kumulativní počet povolení u požadavků čekajících ve frontě. Musí být nastaven na hodnotu `>= 0` v okamžiku, kdy jsou tyto možnosti předány konstruktoru `FixedWindowRateLimiter`. Pokud je nastaveno na **`0`**, fronta je vypnuta. * **RejectionStatusCode**. Výchozí stavový kód, který se nastaví v odpovědi při odmítnutí požadavku. ### DistributedCacheConfig Distribuovaná cache je cache sdílená více aplikačními servery, obvykle spravovaná jako externí služba vůči aplikačním serverům, které k ní přistupují. Distribuovaná cache může zlepšit výkon a škálovatelnost aplikace ASP.NET Core, zejména pokud je aplikace hostována v cloudové službě nebo na serverové farmě. * **DistributedCacheType** Můžete zvolit jednu z implementací: * **Memory** - Jde o implementaci `IDistributedCache` poskytovanou frameworkem, která ukládá položky do paměti. Distributed Memory Cache není distribuovaná cache. Položky cache ukládá instance aplikace na serveru, kde aplikace běží. * **SQL Server** - Implementace Distributed SQL Server Cache umožňuje distribuované cache používat jako úložiště databázi SQL Server. K vytvoření tabulky pro položky cache v instanci SQL Serveru můžete použít nástroj SQL-cache. Nástroj vytvoří tabulku se zadaným názvem a schématem. Pro tento účel se doporučuje použít samostatnou databázi. ```sh dotnet sql-cache create "Data Source=(localdb)\MSSQLLocalDB;Initial Catalog=DistCache;Integrated Security=True;" dbo nopCache ``` * **Redis** - nopCommerce podporuje *Redis* hned po instalaci. Chcete-li ve své aplikaci povolit *Redis*, musíte nastavit příslušná nastavení. Více informací o [Redis](https://azure.microsoft.com/documentation/articles/cache-dotnet-how-to-use-azure-redis-cache). * **Redis Synchronized Memory** - nopCommerce verze 4.70 přináší nový způsob ukládání do cache se synchronizací prostřednictvím mechanismu zpráv v *Redis*. Tato možnost má velmi vysoký výkon, protože samotná cache je uložena v paměti a *Redis* se používá pouze jako synchronizátor. Chcete-li tuto možnost ve své aplikaci povolit, musíte nastavit stejná nastavení jako pro základní cache *Redis*. * **Enabled** Toto nastavení očekává logickou hodnotu. Nastavte hodnotu na **`true`**, pokud chcete povolit `Distributed cache`. Systém používá cache v paměti (In-Memory), takže toto nastavení určuje, zda se má místo výchozí `in-memory caching` používat `Distributed Cache`. Použijte tedy toto nastavení, pokud chcete pro cache používat například *Redis*. * **ConnectionString (volitelné)** Toto nastavení se používá pouze ve spojení s *Redis* nebo *SQL Server*. Očekává řetězcovou hodnotu. Výchozí hodnota tohoto nastavení je ```powershell 127.0.0.1:{PORT},ssl=False ``` * **SchemaName (volitelné)** Toto nastavení se používá pouze ve spojení se `SQL Server`. * **TableName (volitelné)** Toto nastavení se používá pouze ve spojení se `SQL Server`. Název databáze SQL Server. * **InstanceName (volitelné)** Zadejte název instance (ve výchozím stavu „nopCommerce“). * **PublishIntervalMs (volitelné)** Zadejte interval publikování událostí změny klíčů v milisekundách. ### HostingConfig Hosting obsahuje nastavení používaná ke konfiguraci chování hostingu. Jde o objekt JSON a obsahuje několik nastavení, jejichž úpravou lze chování hostingu změnit. * **UseProxy** Toto nastavení očekává logickou hodnotu. Povolte toto nastavení, chcete-li přeposlané hlavičky (forwarded headers) aplikovat na odpovídající pole aktuálního HTTP požadavku. * **ForwardedProtoHeaderName** Toto nastavení očekává řetězcovou hodnotu. Zadejte vlastní název HTTP hlavičky pro identifikaci protokolu (HTTP nebo HTTPS), který klient použil k připojení k vaší proxy nebo load balanceru. * **ForwardedForHeaderName** Toto nastavení očekává řetězcovou hodnotu. Zadejte vlastní název HTTP hlavičky pro určení původní IP adresy (např. **`CF-Connecting-IP`**, **`X-ProxyUser-Ip`**). * **KnownProxies** Toto nastavení očekává řetězcovou hodnotu. Zadejte seznam IP adres (oddělených čárkou), ze kterých se mají přijímat přeposlané hlavičky. * **KnownNetworks** Toto nastavení očekává řetězcovou hodnotu. Zadejte seznam IP rozsahů v notaci CIDR (oddělených čárkou), ze kterých se mají přijímat přeposlané hlavičky, např. 172.64.0.0/13,162.158.0.0/15 ### InstallationConfig Obsahuje nastavení, která se používají ke konfiguraci chování nopCommerce během jeho instalace. * **DisableSampleData** Toto nastavení očekává logickou hodnotu. Určuje, zda může majitel obchodu během instalace nainstalovat ukázková data. Pokud nechcete, aby majitel obchodu během instalace instaloval ukázková data, nastavte hodnotu tohoto nastavení na **`true`**. * **DisabledPlugins** Toto nastavení očekává řetězcovou hodnotu. Zadejte seznam pluginů (oddělených čárkou), které se během instalace ignorují. * **InstallRegionalResources** Toto nastavení očekává logickou hodnotu. Umožňuje během instalace vybrat další jazykové zdroje. Volba země určuje nastavení, která budou na obchod aplikována (směnné kurzy, daně, měrné jednotky atd. – regionální specifika). ### PluginConfig * **UseUnsafeLoadAssembly** Toto nastavení očekává logickou hodnotu. Hodnotu můžete nastavit na **`true`**, pokud chcete načíst sestavení (assembly) do kontextu load-from a obejít tak některé bezpečnostní kontroly. ### WebOptimizer K minifikaci a sdružování (bundling) kódu *CSS* a *JavaScript* používáme nástroj [WebOptimizer](https://github.com/ligershark/WebOptimizer), což je middleware pro *ASP.NET Core*. Optimalizace se provádí za běhu s cachováním na straně serveru i klienta pro vysoký výkon. * **EnableJavaScriptBundling** Toto nastavení očekává logickou hodnotu. Můžete jej nastavit na **`true`**, pokud chcete povolit sdružování a minifikaci JS souborů. * **EnableCssBundling** Toto nastavení očekává logickou hodnotu. Můžete jej nastavit na **`true`**, pokud chcete povolit sdružování a minifikaci CSS souborů. * **JavaScriptBundleSuffix** Toto nastavení očekává řetězcovou hodnotu. Můžete nastavit příponu názvu js souboru generovaných balíčků (ve výchozím stavu **`.scripts`**). * **CssBundleSuffix** Toto nastavení očekává řetězcovou hodnotu. Můžete nastavit příponu názvu CSS souboru generovaných balíčků (ve výchozím stavu **`.styles`**). * **EnableCaching** Toto nastavení očekává logickou hodnotu. Můžete nastavit, zda je povoleno cachování na straně serveru (ve výchozím stavu **`true`**). * **EnableMemoryCache** Toto nastavení očekává logickou hodnotu. Můžete nastavit, zda je povoleno cachování založené na *Microsoft.Extensions.Caching.Memory.IMemoryCache* (ve výchozím stavu **`true`**). * **EnableDiskCache** Toto nastavení očekává logickou hodnotu. Určuje, zda se assety pipeline ukládají do cache na disk. To může urychlit restarty aplikace, protože se assety pipeline načtou z disku místo opětovného spuštění pipeline. Ve vývojovém režimu může být užitečné tuto možnost vypnout. * **EnableTagHelperBundling** Toto nastavení očekává logickou hodnotu. Můžete nastavit, zda je sdružování povoleno (ve výchozím stavu **`false`**). * **CdnUrl** Toto nastavení očekává řetězcovou hodnotu. Můžete nastavit URL CDN používanou pro TagHelpery (ve výchozím stavu **`null`**). * **CacheDirectory** Toto nastavení očekává řetězcovou hodnotu. Nastavuje adresář, do kterého se budou ukládat assety, pokud je **EnableDiskCache** nastaveno na **`true`** (ve výchozím stavu **`{ContentRootPath}\\wwwroot\\bundles`**). * **AllowEmptyBundle** Toto nastavení očekává logickou hodnotu. Můžete nastavit, zda je povoleno vygenerovat prázdný balíček místo vyvolání výjimky (ve výchozím stavu **`true`**). * **HttpsCompression** Toto nastavení očekává celočíselnou hodnotu. Můžete nastavit, zda se mají soubory komprimovat u HTTPS požadavků, pokud je k dispozici middleware Response Compression. Výchozí hodnota je **`2`**. Můžete zvolit jednu z možností: * **1** - Vypne kompresi přes HTTPS. * **2** - Zapne kompresi přes HTTPS. >[!NOTE] > > Povolení komprese u HTTPS požadavků pro obsah, se kterým lze vzdáleně manipulovat, může způsobit bezpečnostní problémy. * **MemoryCacheTimeToLive** Pokud je povoleno cachování v paměti *EnableMemoryCache*, určuje, jak dlouho je záznam uložen v paměti. Výchozí hodnota je 60 minut. --- <!-- page: Nastavení v souboru web.config | url: http://nopdocs.service.hedr.dev/cs/developer/tutorials/description-of-the-web-config-file-in-project.html | source: cs/developer/tutorials/description-of-the-web-config-file-in-project.md --> # Nastavení v souboru web.config ## Co je soubor web.config Soubor `web.config` je konfigurační soubor založený na XML, který se v aplikacích postavených na ASP.NET používá ke správě různých nastavení týkajících se konfigurace webu. Díky tomu můžeme oddělit aplikační logiku od konfigurační logiky. Hlavní výhodou je, že pokud chceme změnit některá konfigurační nastavení, nemusíme aplikaci restartovat, aby se nové změny projevily – ASP.NET změny automaticky rozpozná a použije je na běžící aplikaci ASP.NET. Framework ASP.NET používá hierarchický systém konfigurace. Soubor `web.config` můžete umístit do libovolného podadresáře aplikace. Soubor se pak vztahuje na všechny stránky umístěné ve stejném adresáři nebo v jeho podadresářích. ## web.config v nopCommerce nopCommerce používá soubor `web.config` v projektu `Nop.Web`, který najdete v adresáři Presentation. V kořenovém adresáři projektu uvidíte soubor web.config. Pokud je vaše řešení čerstvou instalací nopCommerce, obsah tohoto souboru vypadá přibližně takto: ```xml <?xml version="1.0" encoding="utf-8"?> <configuration> <system.webServer> <modules> <!-- Remove WebDAV module so that we can make DELETE requests --> <remove name="WebDAVModule" /> </modules> <handlers> <!-- Remove WebDAV module so that we can make DELETE requests --> <remove name="WebDAV" /> <add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModuleV2" resourceType="Unspecified" /> </handlers> <!-- When deploying on Azure, make sure that "dotnet" is installed and the path to it is registered in the PATH environment variable or specify the full path to it --> <aspNetCore requestTimeout="23:00:00" processPath="%LAUNCHER_PATH%" arguments="%LAUNCHER_ARGS%" forwardWindowsAuthToken="false" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout" startupTimeLimit="3600" hostingModel="InProcess"> </aspNetCore> <httpProtocol> <customHeaders> <remove name="X-Powered-By" /> <!-- Protects against XSS injections. ref.: https://www.veracode.com/blog/2014/03/guidelines-for-setting-security-headers/ --> <add name="X-XSS-Protection" value="1; mode=block" /> <!-- Protects against Clickjacking attacks. ref.: http://stackoverflow.com/a/22105445/1233379 --> <add name="X-Frame-Options" value="SAMEORIGIN" /> <!-- Protects against MIME-type confusion attack. ref.: https://www.veracode.com/blog/2014/03/guidelines-for-setting-security-headers/ --> <add name="X-Content-Type-Options" value="nosniff" /> <!-- Protects against Clickjacking attacks. ref.: https://www.owasp.org/index.php/HTTP_Strict_Transport_Security_Cheat_Sheet --> <add name="Strict-Transport-Security" value="max-age=31536000; includeSubDomains" /> <!-- CSP modern XSS directive-based defence, used since 2014. ref.: http://content-security-policy.com/ --> <add name="Content-Security-Policy" value="default-src 'self'; connect-src *; font-src * data:; frame-src *; img-src * data:; media-src *; object-src *; script-src * 'unsafe-inline' 'unsafe-eval'; style-src * 'unsafe-inline';" /> <!-- Prevents from leaking referrer data over insecure connections. ref.: https://scotthelme.co.uk/a-new-security-header-referrer-policy/ --> <add name="Referrer-Policy" value="same-origin" /> <!-- Permissions-Policy is a new header that allows a site to control which features and APIs can be used in the browser. ref.: https://w3c.github.io/webappsec-permissions-policy/ --> <add name="Permissions-Policy" value="accelerometer=(), camera=(), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), payment=*, usb=()" /> </customHeaders> </httpProtocol> </system.webServer> </configuration> ``` ```xml <configuration> ... </configuration> ``` Každé konfigurační pravidlo se zapisuje do elementu „`<configuration>`“. ```xml <system.webServer> ... </system.webServer> ``` Element `<system.webServer>` je kořenovým elementem pro mnoho konfiguračních nastavení IIS na úrovni webu a aplikace a obsahuje konfigurační elementy, které definují nastavení používaná jádrem webového serveru a moduly. ```xml <modules> <!-- Remove WebDAV module so that we can make DELETE requests --> <remove name="WebDAVModule" /> </modules> ``` Element `<modules>` definuje moduly v nativním kódu a moduly ve spravovaném kódu, které jsou pro aplikaci registrovány. Moduly běžně používáme k implementaci vlastní funkcionality. Element `<modules>` obsahuje kolekci elementů `<add>`, `<remove>` a `<clear>`. nopCommerce zde používá element `<remove>` k odebrání modulu WebDAVModule z aplikace. ```xml <handlers> <!-- Remove WebDAV module so that we can make DELETE requests --> <remove name="WebDAV" /> <add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModuleV2" resourceType="Unspecified" /> </handlers> ``` Obslužné rutiny (handlers) jsou komponenty IIS nakonfigurované ke zpracování požadavků na konkrétní obsah, obvykle za účelem vygenerování odpovědi pro požadovaný prostředek. Například webová stránka ASP.NET je jedním typem obslužné rutiny. Obslužné rutiny můžete použít ke zpracování požadavků na jakýkoli prostředek, který má uživatelům vracet informace a není statickým souborem. Element `<handlers>` obsahuje kolekci elementů `<add>`, `<remove>` a `<clear>`, z nichž každý definuje mapování obslužné rutiny pro aplikaci. Element `<add>` přidá obslužnou rutinu do kolekce obslužných rutin, element `<remove>` odebere odkazy na obslužnou rutinu z kolekce a element `<clear>` odebere z kolekce všechny odkazy na obslužné rutiny. Ve výše uvedeném kódu je odebrána obslužná rutina „WebDAV“ a přidána obslužná rutina pro modul `AspNetCoreModuleV2`. ```xml <aspNetCore requestTimeout="23:00:00" processPath="%LAUNCHER_PATH%" arguments="%LAUNCHER_ARGS%" forwardWindowsAuthToken="false" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout" startupTimeLimit="3600" hostingModel="InProcess"/> ``` ```xml <httpProtocol> <customHeaders> <remove name="X-Powered-By" /> <!-- Protects against XSS injections. ref.: https://www.veracode.com/blog/2014/03/guidelines-for-setting-security-headers/ --> <add name="X-XSS-Protection" value="1; mode=block" /> <!-- Protects against Clickjacking attacks. ref.: http://stackoverflow.com/a/22105445/1233379 --> <add name="X-Frame-Options" value="SAMEORIGIN" /> <!-- Protects against MIME-type confusion attack. ref.: https://www.veracode.com/blog/2014/03/guidelines-for-setting-security-headers/ --> <add name="X-Content-Type-Options" value="nosniff" /> <!-- Protects against Clickjacking attacks. ref.: https://www.owasp.org/index.php/HTTP_Strict_Transport_Security_Cheat_Sheet --> <add name="Strict-Transport-Security" value="max-age=31536000; includeSubDomains" /> <!-- CSP modern XSS directive-based defence, used since 2014. ref.: http://content-security-policy.com/ --> <add name="Content-Security-Policy" value="default-src 'self'; connect-src *; font-src * data:; frame-src *; img-src * data:; media-src *; object-src *; script-src * 'unsafe-inline' 'unsafe-eval'; style-src * 'unsafe-inline';" /> <!-- Prevents from leaking referrer data over insecure connections. ref.: https://scotthelme.co.uk/a-new-security-header-referrer-policy/ --> <add name="Referrer-Policy" value="same-origin" /> <!-- Permissions-Policy is a new header that allows a site to control which features and APIs can be used in the browser. ref.: https://w3c.github.io/webappsec-permissions-policy/ --> <add name="Permissions-Policy" value="accelerometer=(), camera=(), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), payment=*, usb=()" /> </customHeaders> </httpProtocol> ``` Element `<customHeaders>` elementu `<httpProtocol>` určuje vlastní hlavičky HTTP, které IIS vrátí v odpovědích HTTP z webového serveru. Hlavičky HTTP jsou dvojice názvů a hodnot, které se vracejí v odpovědích webového serveru. Vlastní hlavičky odpovědi se odesílají klientovi spolu s výchozí hlavičkou HTTP. Na rozdíl od hlaviček odpovědi pro přesměrování, které se vracejí pouze v případě přesměrování, se vlastní hlavičky odpovědi vracejí v každé odpovědi. ## Konfigurace pravidel přesměrování v IIS K výše uvedeným konfiguracím můžeme přidat další. Zde si ukážeme, jak nakonfigurovat pravidla přesměrování v IIS. Pravidlo přesměrování umožňuje, aby na jednu webovou stránku odkazovalo více URL. Důvodů, proč chcete přesměrovat požadavek z jednoho serveru na jiný, může být několik. Například se mohl změnit název vaší společnosti a vy chcete zaregistrovat novou doménu a přesunout na ni svůj web; v takovém případě budete chtít přesměrovat všechny požadavky ze staré domény na novou. Aby mohl náš web používat pravidla přesměrování, musíme nainstalovat modul „URL rewrite“, což je rozšíření IIS. Pro účely ukázky předpokládejme, že musíme přesměrovat požadavek ze starého webu na nový. K tomu musíme do souboru `web.config` zapsat následující pravidla. ```xml <rewrite> <rules> <rule name="[RULE NAME]" stopProcessing="true"> <match url="(.*)" /> <conditions logicalGrouping="MatchAny" trackAllCaptures="false"> <add input="{HTTP_HOST}{REQUEST_URI}" pattern="[OLD URL]" /> </conditions> <action type="Redirect" url="http://[NEW URL]/{R:1}" redirectType="Permanent"/> </rule> </rules> </rewrite> ``` > [!NOTE] > > Pomocí tohoto pravidla můžeme přesměrovat všechny stránky starého doménového jména na stejnou stránku na novém doménovém jménu. Zde musíme nahradit [RULE NAME], [OLD URL] a [NEW URL] příslušnými údaji. * [RULE NAME] může být cokoli, co popisuje, co toto pravidlo dělá * [OLD URL] je stará URL, ze které chcete přesměrovat. * [NEW URL] je nová URL, na kterou chcete přesměrovat. ```xml <match url="(.*)" /> ``` Výše uvedený element říká, že toto pravidlo bude odpovídat všem řetězcům URL. ```xml <add input="{HTTP_HOST}{REQUEST_URI}" pattern="[OLD URL]" /> ``` Výše uvedený element přidává k pravidlu podmínku, která načte hodnotu hostitele a URI požadavku ze serverových proměnných HTTP_HOST a REQUEST_URI a porovná ji se vzorem s hodnotou zadanou pro [OLD URL]. ```xml <action type="Redirect" url="http://[NEW URL]/{R:1}" redirectType="Permanent"/> ``` Tento element přesměruje odpovídající starou URL na novou URL. --- <!-- page: Rozšíření oprávnění | url: http://nopdocs.service.hedr.dev/cs/developer/tutorials/permissions.html | source: cs/developer/tutorials/permissions.md --> # Rozšíření oprávnění **Oprávnění** jsou důležitým prvkem zabezpečení prostředků aplikace. S jejich pomocí můžete omezit přístup k určité části aplikace, nebo naopak poskytnout potřebná práva ke čtení/změně konkrétní oblasti. Všechna dostupná oprávnění pro řízení rozsahu najdete v sekci *Seznam řízení přístupu (ACL)*. Stejně jako jakékoli jiné změny v aplikaci se doporučuje provádět je prostřednictvím pluginů. Podívejme se tedy na přidání oprávnění pomocí abstraktního pluginu. Cílem tohoto návodu je ukázat, jak spravovat oprávnění; informace o vytvoření samotného pluginu najdete na [této stránce](xref:cs/developer/plugins/index). ## Přidání vlastního oprávnění v nopCommerce 4.80 a novějších Nejprve vytvořme třídu, která popisuje nové oprávnění – bude to poskytovatel oprávnění. Je nutné a postačující, aby tato třída dědila z rozhraní `IPermissionConfigManager`. ```csharp public partial class WebApiBackendPermissionConfigManager : IPermissionConfigManager { public const string ACCESS_WEB_API = "AccessWebApi"; /// <summary> /// Gets all permission configurations /// </summary> public IList<PermissionConfig> AllConfigs => new List<PermissionConfig> { new("Access Web API Backend", ACCESS_WEB_API , nameof(StandardPermission.System), NopCustomerDefaults.AdministratorsRoleName) }; } ``` Zadané záznamy se do databáze nainstalují bez jakýchkoli dalších kroků. V tomto příkladu je oprávnění nastaveno pouze pro *roli administrátora*, ale v případě potřeby lze tento seznam rozšířit. Nezapomeňte oprávnění při odebírání pluginu také odstranit v metodě `UninstallAsync()`: ```csharp //delete permission var permissionRecord = (await _permissionService.GetAllPermissionRecordsAsync()) .FirstOrDefault(x => x.SystemName == WebApiBackendPermissionConfigManager.ACCESS_WEB_API); await _permissionService.DeletePermissionRecordAsync(permissionRecord); ``` Nyní na každém místě, kde potřebujeme ověřit oprávněnost přístupu uživatele ke konkrétnímu prostředku, musíme zavolat metodu `AuthorizeAsync()` služby `IPermissionService` s daným oprávněním: ```csharp //check whether current customer has access to Web API if (await _permissionService.AuthorizeAsync(WebApiBackendPermissionConfigManager.ACCESS_WEB_API)) return; ``` Další způsob použití oprávnění, a to jako atributu filtru akce controlleru, je následující: ```csharp [CheckPermission(WebApiBackendPermissionConfigManager.ACCESS_WEB_API)] public virtual async Task<IActionResult> Configure() { ... } ``` To je v podstatě vše – po instalaci pluginu uvidíte přidané oprávnění v sekci **ACL**. > [!NOTE] > > Pokud chcete použít výchozí vestavěná oprávnění, všechna jsou uvedena ve třídě `StandardPermission` (jmenný prostor `Nop.Services.Security`). > Například: > > ```csharp > [CheckPermission(StandardPermission.Configuration.MANAGE_SETTINGS)] > ``` ## Přidání vlastního oprávnění v nopCommerce 4.70 a starších Nejprve vytvořme třídu, která popisuje nové oprávnění – bude to poskytovatel oprávnění. Je nutné a postačující, aby tato třída dědila z rozhraní `IPermissionProvider`. ```csharp public partial class WebApiBackendPermissionProvider : IPermissionProvider { public static readonly PermissionRecord AccessWebApiBackend = new () { Name = "Access Web API Backend", SystemName = "AccessWebApi", Category= "Standard" }; /// <summary> /// Get permissions /// </summary> /// <returns>Permissions</returns> public virtual IEnumerable<PermissionRecord> GetPermissions() { return new[] { AccessWebApiBackend }; } /// <summary> /// Get default permissions /// </summary> /// <returns>Permissions</returns> public virtual HashSet<(string systemRoleName, PermissionRecord[]permissions)> GetDefaultPermissions() { return new () { (NopCustomerDefaults.AdministratorsRoleName, new [] { AccessWebApiBackend }) }; } } ``` V tomto příkladu je oprávnění nastaveno pouze pro *roli administrátora*, ale v případě potřeby lze tento seznam rozšířit. Nyní toto oprávnění přidáme při instalaci našeho pluginu. To je nutné provést v metodě `InstallAsync()`: ```csharp //add permission await _permissionService.InstallPermissionsAsync(new WebApiBackendPermissionProvider()); ``` Nezapomeňte oprávnění při odebírání pluginu také odstranit v metodě `UninstallAsync()`: ```csharp //delete permission var permissionRecord = (await _permissionService.GetAllPermissionRecordsAsync()) .FirstOrDefault(x => x.SystemName == WebApiBackendPermissionProvider.AccessWebApiBackend.SystemName); var listMappingCustomerRolePermissionRecord = await _permissionService.GetMappingByPermissionRecordIdAsync(permissionRecord.Id); foreach (var mappingCustomerPermissionRecord in listMappingCustomerRolePermissionRecord) await _permissionService.DeletePermissionRecordCustomerRoleMappingAsync( mappingCustomerPermissionRecord.PermissionRecordId, mappingCustomerPermissionRecord.CustomerRoleId); await _permissionService.DeletePermissionRecordAsync(permissionRecord); ``` Nyní na každém místě, kde potřebujeme ověřit oprávněnost přístupu uživatele ke konkrétnímu prostředku, musíme zavolat metodu `AuthorizeAsync()` služby `IPermissionService` s daným oprávněním: ```csharp //check whether current customer has access to Web API if (await _permissionService.AuthorizeAsync(WebApiBackendPermissionProvider.AccessWebApiBackend)) return; ``` To je v podstatě vše – po instalaci pluginu uvidíte přidané oprávnění v sekci **ACL**. ## Viz také - [Seznam řízení přístupu](xref:cs/running-your-store/customer-management/access-control-list) --- <!-- page: Naplánované úlohy | url: http://nopdocs.service.hedr.dev/cs/developer/tutorials/scheduled-tasks.html | source: cs/developer/tutorials/scheduled-tasks.md --> # Naplánované úlohy Pomocí naplánovaných úloh můžete naplánovat spouštění úlohy v určitých intervalech. Například nopCommerce pravidelně odesílá e-maily z fronty. Základní kroky pro vytvoření nové úlohy jsou: 1. Definujte třídu, která implementuje rozhraní **IScheduleTask**. Má pouze jednu metodu bez argumentů: **ExecuteAsync**. Jak jste jistě uhodli, tato metoda se volá, když má být úloha spuštěna. ```csharp public partial class KeepAliveTask : IScheduleTask { private readonly StoreHttpClient _storeHttpClient; public KeepAliveTask(StoreHttpClient storeHttpClient) { _storeHttpClient = storeHttpClient; } public async System.Threading.Tasks.Task ExecuteAsync() { await _storeHttpClient.KeepAliveAsync(); } } ``` 1. Pro naplánování úlohy musí vývojář vložit nový záznam **ScheduleTask** do příslušné databázové tabulky. K vložení takového záznamu můžete použít **IScheduleTaskService**. ```csharp await _scheduleTaskService.InsertTaskAsync(new ScheduleTask { Name = "Keep alive", Seconds = 300, Type = "Nop.Services.Common.KeepAliveTask, Nop.Services", Enabled = true, LastEnabledUtc = lastEnabledUtc, StopOnError = false }); ``` > [!IMPORTANT] > > Při vkládání nového záznamu do databázové tabulky **ScheduleTask** pro novou naplánovanou úlohu je důležité dodržet formát sloupce **Type** jako **Namespace.TaskClassName, AssemblyName**. ## Řešení problémů - Ujistěte se, že váš obchod má platnou adresu URL. - Po přidání nové naplánované úlohy restartujte aplikaci. --- <!-- page: Rozhraní ITypeFinder | url: http://nopdocs.service.hedr.dev/cs/developer/tutorials/type-finder.html | source: cs/developer/tutorials/type-finder.md --> # Rozhraní ITypeFinder ## ITypeFinder Jde o velmi jednoduché rozhraní. Obsahuje pouze dvě metody (přičemž jedna má dvě přetížení). Definici rozhraní vidíte níže: ```csharp /// <summary> /// Classes implementing this interface provide information about types /// to various services in the Nop engine. /// </summary> public interface ITypeFinder { /// <param name="onlyConcreteClasses">A value indicating whether to find only concrete classes</param> IEnumerable<Type> FindClassesOfType<T>(bool onlyConcreteClasses = true); /// <param name="assignTypeFrom">Assign type from</param> /// <param name="onlyConcreteClasses">A value indicating whether to find only concrete classes</param> IEnumerable<Type> FindClassesOfType(Type assignTypeFrom, bool onlyConcreteClasses = true); /// <summary> /// Gets the assemblies related to the current implementation. /// </summary> IList<Assembly> GetAssemblies(); } ``` Hlavním úkolem třídy, která toto rozhraní implementuje, je vyhledávat v sestaveních (assemblies) typy zadané třídy nebo rozhraní. Na příkladech ze zdrojového kódu nopCommerce se podíváme, kde se to může hodit. Nejprve se však podívejme na metodu ``GetAssemblies``. Úkolem této metody je jednoduše vrátit seznam sestavení, ve kterých se vyhledávání provádí. Jak přesně se tento seznam sestavuje, závisí na konkrétní implementaci rozhraní. ## Výchozí implementace ITypeFinder Hlavní výchozí implementací tohoto rozhraní je třída ``WebAppTypeFinder``. ``WebAppTypeFinder`` pak jen mírně rozšiřuje třídu ``AppDomainTypeFinder``, která v podstatě vykonává veškerou práci s vyhledáváním typů. Používáme však odvozenou třídu, protože rozšiřuje rozsah vyhledávání typů na všechna sestavení z adresáře **\Bin**, zatímco základní třída pracuje pouze se sestaveními z aktuální aplikační domény. Nebudeme se zdržovat podrobnostmi implementace metod ``FindClassesOfType`` (obě se totiž redukují na velmi jednoduchou funkci, jejíž kód je k dispozici na [tomto odkazu](https://github.com/nopSolutions/nopCommerce/blob/develop/src/Libraries/Nop.Core/Infrastructure/AppDomainTypeFinder.cs#L184)) a přejdeme k tomu nejdůležitějšímu na tomto rozhraní. ## K čemu tedy rozhraní ITypeFinder potřebujeme Toto rozhraní se používá v některých velmi důležitých aspektech fungování nopCommerce: 1. Vyhledávání sestavení pro konfiguraci mechanismu migrací ([Jak fungují migrace?](xref:cs/developer/tutorials/migrations)) 1. Vyhledávání tříd určitých rozhraní nezbytných pro správné spuštění webu, například: * ``IStartupTask`` – počáteční inicializace modulů a pluginů * ``INopStartup`` – konfigurace služeb a middleware při spuštění aplikace * ``IOrderedMapperProfile`` – vytvoření konfigurace **Mapster** * ``IEntityBuilder``, ``INameCompatibility`` – konfigurace builderu databázových entit pro zpětnou kompatibilitu pojmenování tabulek pro **Linq2Db** ([Vrstva přístupu k datům nopCommerce](xref:cs/developer/tutorials/source-code-organization#librariesnopdata)) * ``IRouteProvider`` – registrace rout * ``IConsumer<T>`` – registrace obslužných rutin interních událostí, jako jsou změny databázových entit * ``IExternalAuthenticationRegistrar`` – registrace a konfigurace externích metod ověřování 1. Vyhledávání vhodného sledovače zásilek v reálném čase ## Závěr Jak vidíte, rozhraní je malé, ale velmi cenné. Bez použití přístupu realizovaného prostřednictvím metod rozhraní `ITypeFinder` by bylo obtížné implementovat tak flexibilní modulární strukturu, jaká je v nopCommerce. --- <!-- page: Nasazení na Azure pomocí Gitu a automatických buildů | url: http://nopdocs.service.hedr.dev/cs/developer/tutorials/azure-deploy.html | source: cs/developer/tutorials/azure-deploy.md --> # Nasazení na Azure pomocí Gitu a automatických buildů ## Podrobný návod pro automatické nasazení nopCommerce pomocí gitu na Azure 1. **Nastavte si git repozitář** Výchozím způsobem nasazení nopCommerce je použití funkce „Publish“ ve Visual Studio. Pro publikování na Azure však potřebujete vlastní repozitář. Můžete použít Bitbucket a udržovat jej synchronizovaný s oficiálním repozitářem. Nebo můžete [nastavit git na Azure](https://azure.microsoft.com/documentation/articles/web-sites-publish-source-control/). K dispozici je [skvělé video](http://channel9.msdn.com/Shows/Azure-Friday/What-is-Kudu-Azure-Web-Sites-Deployment-with-David-Ebbo). 1. **Připravte se na lokální nasazení** Jakmile ověříte, že automatický build funguje, můžeme přizpůsobit naše skripty pro nasazení. To je nutné, protože výchozí automatický build sestavuje pouze projekt `Nop.Web`. Problém je v tom, že nesestavuje žádný z pluginů. Jejich referenci nelze přidat ani do projektu `Nop.Web', protože by vznikly cyklické reference. Musíme tedy zprovoznit vlastní build; k tomu potřebujeme nainstalovat tyto nástroje: - Nainstalujte NodeJs: [https://nodejs.org](https://nodejs.org) - Nainstalujte Azure CLI: [https://azure.microsoft.com/documentation/articles/xplat-cli-install/](https://azure.microsoft.com/documentation/articles/xplat-cli-install/) 1. **Zprovozněte NuGet na úrovni příkazového řádku.** Výchozím chováním skriptu KUDU (což je nástroj pro generování skriptů nasazení pro Azure App Service) je kontrola balíčků NuGet. - Soubor `Nuget.exe` můžete získat tak, že jej [stáhnete odsud](https://docs.nuget.org/consume/command-line-reference). Ve Visual Studio můžete také zapnout „Enable automatic restore of NuGet packages“ a soubor bude do projektu přidán automaticky. - Ujistěte se, že je NuGet v proměnné PATH. Zkopírujte soubor `nuget.exe` do preferovaného umístění (např. `c:/Program Files/Nuget/Nuget.exe`). Přidejte jej do proměnné prostředí PATH. - Ověřte, že je NuGet v PATH, spuštěním `cmd.exe` a napsáním *nuget*. Měli byste vidět možnosti příkazu. 1. **Vygenerujte skripty nasazení lokálně** - Otevřete „Microsoft Azure Command Prompt“ - Přejděte do složky src svého projektu, jak byste to běžně udělali v okně shellu - Spusťte generátor skriptů kudu (wiki najdete na [tomto odkazu](https://github.com/projectkudu/kudu/wiki) nebo se podívejte na [toto video](https://azure.microsoft.com/resources/videos/custom-web-site-deployment-scripts-with-kudu/)). Napsali byste tedy něco jako: `kuduscript site deploymentscript --aspNetCore Presentation\Nop.Web\Nop.Web.csproj -s NopCommerce.sln -y` - Ověřte, že byly vygenerovány 2 soubory (v kořeni lokálního repozitáře): `.deployment` `deploy.cmd` 1. **Spusťte vygenerovaný skript** - Soubory .deployment a deploy.cmd musíte ponechat v kořeni git repozitáře - Upravte `deploy.cmd`, protože proměnná `%DEPLOYMENT_SOURCE%` obsahuje kořen git repozitáře. Přidali bychom tedy `%DEPLOYMENT_SOURCE%\src\Presentation\Nop.Web\Nop.Web.csproj` místo `%DEPLOYMENT_SOURCE%\Presentation\Nop.Web\Nop.Web.csproj`. Všechny cesty v sekci nasazení musí být opraveny. - Spusťte `deploy.cmd` a ověřte, zda výchozí skript nasazení funguje lokálně. Měl by vytvořit složku `\artifact` hned vedle vašeho git repozitáře. 1. **Přizpůsobte skript nasazení** Nyní jsme v závěrečné části. Tady se veškerá práce vyplatí. Chceme upravit následující část: ```sh :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: :: Deployment :: ---------- echo Handling ASP.NET Core Web Application deployment. :: 1. Restore nuget packages call :ExecuteCmd dotnet restore "%DEPLOYMENT_SOURCE%\NopCommerce.sln" IF !ERRORLEVEL! NEQ 0 goto error :: 2. Build and publish call :ExecuteCmd dotnet publish "%DEPLOYMENT_SOURCE%\Presentation\Nop.Web\Nop.Web.csproj" --output "%DEPLOYMENT_TEMP%" --configuration Release IF !ERRORLEVEL! NEQ 0 goto error :: 3. KuduSync call :ExecuteCmd "%KUDU_SYNC_CMD%" -v 50 -f "%DEPLOYMENT_TEMP%" -t "%DEPLOYMENT_TARGET%" -n "%NEXT_MANIFEST_PATH%" -p "%PREVIOUS_MANIFEST_PATH%" -i ".git;.hg;.deployment;deploy.cmd" IF !ERRORLEVEL! NEQ 0 goto error :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: ``` Mezi ::1 a ::2 umístíme naše příkazy pro sestavení pluginů. Příklad pro první plugin by vypadal takto: ```sh :: 1.01 Build plugin customer roles to temporary path call :ExecuteCmd dotnet build "%DEPLOYMENT_SOURCE%\src\Plugins\Nop.Plugin.DiscountRules.CustomerRoles\Nop.Plugin.DiscountRules.CustomerRoles.csproj" -c Release ``` Nyní se plugin sestaví při spuštění skriptů nasazení. --- <!-- page: Používání Dockeru | url: http://nopdocs.service.hedr.dev/cs/developer/tutorials/docker.html | source: cs/developer/tutorials/docker.md --> # Používání Dockeru Tento dokument je podrobným návodem, jak sestavit a spustit kontejner Docker. 1. **Nainstalujte Docker** v prostředí Windows. Nejprve musíme na náš počítač nainstalovat Docker. Použijeme [Docker Desktop](https://www.docker.com/products/docker-desktop/) pro Windows, který nám pomáhá sestavovat a sdílet kontejnerizované aplikace a mikroslužby. Docker Desktop je k dispozici také pro Linux a Mac. Po instalaci a spuštění aplikace budete mít přístup ke všem možnostem kontejnerizace. Dále budeme veškerou práci provádět v PowerShellu, protože příkazový režim bude v jakémkoli prostředí stejný. 2. **Sestavte kontejner Docker**. Pro pohodlné spouštění příkazů přejděte do adresáře, ve kterém se nachází `Dockerfile` (kořenový adresář zdrojových souborů nopCommerce). Příkaz, který potřebujeme: ```csharp [docker build -t nopcommerce .] ``` Tento příkaz sestaví kontejner podle instrukcí popsaných v souboru „Dockerfile“. První spuštění sestavení zabere hodně času, protože bude vyžadovat stažení dvou základních obrazů pro aplikace .Net Core. První obraz obsahující SDK je potřeba pro zprostředkující kontejner, který sestaví aplikaci obnovením všech závislostí a poté provede proces publikování aplikace `Nop.Web` do samostatného adresáře, ze kterého později vytvoříte výsledný kontejner s názvem *nopcommerce* (obraz můžete vytvořit i bez názvu, ale s názvem je to pohodlnější. Chcete-li při sestavení zadat název kontejneru, musíte uvést příznak [–t], jak bylo provedeno v našem případě). Po instalaci, pokud vše proběhlo v pořádku, spusťte další příkaz: ```csharp [docker images] ``` Měli bychom vidět něco podobného jako na následujícím obrázku: ![docker_2](_static/docker/docker_2.png) Toto je seznam všech načtených kontejnerů, mezi kterými snadno uvidíme náš kontejner – je vytvořen a připraven k použití. 3. **Spusťte a otestujte kontejner** Nejprve spusťme kontejner příkazem: ```bash docker run -d -p 80:80 nopcommerce ``` Tento příkaz spustí náš kontejner na pozadí (příznak [-d]) a namapuje port 80 kontejneru na port 80 hostitelského počítače (příznak [–p]). > [!TIP] > > Seznam spuštěných kontejnerů můžete zobrazit pomocí následujícího příkazu: > > ```bash > docker ps > ``` V prohlížeči bychom měli vidět instalační stránku nopCommerce. ![docker_3](_static/docker/docker_3.png) To bude naším ověřením, že se kontejner vytváří, spouští a úspěšně funguje. 4. **Plně otestovat** fungování aplikace tímto způsobem však půjde pouze tehdy, pokud máte SQL server, ke kterému má náš kontejner přístup. Naše i uživatelská prostředí jsou ale zpravidla omezená, proto jsme připravili soubor kompozice, který vám umožní nasadit kontejner nopCommerce společně s kontejnerem obsahujícím SQL server. K nasazení kompozice kontejnerů použijte příkaz: ```bash docker-compose up -d ``` Tento příkaz používá k nasazení soubor docker-compose.yml, který popisuje vytvoření dvou kontejnerů „nopcommerce_web“ a „nopcommerce_database“, jež tvoří balíček aplikace a databáze. A po otevření stránky v prohlížeči budeme moci otestovat vše, co chceme. Pro připojení k databázovému serveru použijeme následující údaje (jak je popsáno v souboru docker-compose.yml): ```bash Server name: nopcommerce_mssql_server User: sa Password: nopCommerce_db_password ``` 5. Po dokončení testování můžete všechny kontejnery odstranit, aby příště nepřekážely. K tomu vám pomohou dva příkazy: ```bash docker stop $ (docker ps -a -q) ``` a ```bash docker system prune -a ``` ## Docker Hub Počínaje verzí nopCommerce 4.20 publikujeme hotový obraz na službě GitHub; dostupné verze si můžete prohlédnout na [tomto odkazu](https://hub.docker.com/r/nopcommerceteam/nopcommerce), nebo si nejnovější verzi stáhnout následujícím příkazem: ```bash docker pull nopcommerceteam/nopcommerce:latest ``` --- <!-- page: Nasazení nopCommerce na virtuální počítač Azure | url: http://nopdocs.service.hedr.dev/cs/developer/tutorials/azure-publish.html | source: cs/developer/tutorials/azure-publish.md --> # Nasazení nopCommerce na virtuální počítač Azure ## Vytvoření virtuálního počítače v Azure Tento návod popisuje kroky potřebné k nastavení virtuálního počítače Azure pro hostování webových aplikací nopCommerce a k umožnění jejich publikování pomocí **WebDeploy**. ### Vytvoření nového virtuálního počítače 1. Přihlaste se na [portál Azure](https://portal.azure.com/) 1. Klikněte na tlačítko **Add** ![azure-publish_1](_static/azure-publish/azure-publish_1.png) 1. Vyberte *Windows Server 2016 VM* v kategorii *Get Started* nebo libovolný Windows Server 2016 v kategorii Compute, například **Windows Server 2016 Datacenter** 1. Vyplňte povinná pole pro konfiguraci nového virtuálního počítače. - Uživatelské jméno/heslo. Budete je potřebovat pro přístup k virtuálnímu počítači. Jde o administrátorský účet pro připojení k virtuálnímu počítači přes RDP. - Skupina prostředků (Resource group). Jde o název „virtuální složky“, která obsahuje všechny prostředky vytvořené pro tento virtuální počítač. Všechny prostředky vytvořené během tohoto procesu můžete odstranit smazáním skupiny prostředků. ### Konfigurace komponent a funkcí na virtuálním počítači 1. DNS název: - Na [portálu Azure](https://portal.azure.com/) přejděte na stránku Overview svého virtuálního počítače. - Pod DNS názvem klikněte na **Configure** - Zadejte globálně jedinečný DNS název. (Po ověření názvu se zobrazí zelené zaškrtnutí.) - Kliknutím na **Save** konfiguraci uložte. ### Konfigurace pravidel brány firewall v Azure 1. Na portálu Azure nakonfigurujte příchozí pravidla brány firewall. V sekci Networking přidejte pravidlo příchozího portu pro vytvoření nových záznamů brány firewall: - http - port 80 (priorita 100) - WebDeploy - port 8172 (priorita 1010) - RDP - port 3389 (priorita 320) ![azure-publish_2](_static/azure-publish/azure-publish_2.png) 2. Na portálu Azure nakonfigurujte odchozí pravidla brány firewall. V sekci *Networking* přidejte pravidlo odchozího portu pro vytvoření nových záznamů brány firewall: - RDP - port 3389 (priorita 100) ### Připojení k virtuálnímu počítači (RDP) pomocí přihlašovacího jména a hesla ![azure-publish_3](_static/azure-publish/azure-publish_3.png) ### Instalace IIS (webového serveru) a ASP.NET 4.6 1. Otevřete **Server Manager Dashboard** (Server Manager - Dashboard se otevře při prvním spuštění) 1. Zvolte **2 Add roles and features** ![azure-publish_4](_static/azure-publish/azure-publish_4.png) 1. Přijměte výchozí hodnoty a třikrát stiskněte **Next**, abyste se dostali do sekce Server Roles. 1. Vyberte **Web Server (IIS)** ![azure-publish_5](_static/azure-publish/azure-publish_5.png) 1. Po vyzvání potvrďte dodatečnou instalaci *IIS Management Console*. 1. Třikrát stiskněte **Next**, abyste se dostali do sekce *Web Server Role (IIS) --> Roles Services* 1. Vyberte službu **Management**, která je nutná k povolení Web Deploy (přes port 8172). Po vyzvání potvrďte dodatečnou instalaci ASP.NET 4.6. ![azure-publish_6](_static/azure-publish/azure-publish_6.png) 1. Výběrem **Next** potvrďte konfiguraci a poté kliknutím na **Install** dokončete nastavení IIS. ![azure-publish_7](_static/azure-publish/azure-publish_7.png) Po dokončení instalace: - IIS je nainstalován a běží, přičemž je vytvořeno interní pravidlo brány firewall pro port 80. - Web Management Service je nainstalována, přičemž je vytvořeno interní pravidlo brány firewall pro port 8172. ### Konfigurace rozšířeného zabezpečení IE (vypnuto) Na novém virtuálním počítači Azure výchozí bezpečnostní pravidla brání stahování spustitelných souborů prostřednictvím Internet Exploreru. Chcete-li stáhnout spustitelný soubor WebDeploy, musíte nejprve vypnout rozšířené zabezpečení IE. 1. V **Server Manager** otevřete vlevo sekci **Local Server**. 1. V hlavním panelu vedle „**IE Enhanced Security Configuration:**“ vyberte On. 1. V zobrazeném dialogu vyberte **Off for Administrators**, vyberte **On for Users** a poté vyberte **OK**. ![azure-publish_8](_static/azure-publish/azure-publish_8.png) ### Instalace Web Deploy 1. Spusťte Internet Explorer. 1. Přijměte výchozí nastavení zabezpečení. 1. [Stáhněte](https://www.microsoft.com/download/details.aspx?id=43717) *WebDeploy_amd64_en-US.msi* 1. Postupujte podle instalačních kroků Web Deploy 1. Zvolte možnost Complete pro instalaci všech komponent ### Nainstalujte nejnovější verzi [NET Core SDK](https://www.microsoft.com/net/download/all) ### Nainstalujte balíček [.NET Core Windows Server Hosting](https://www.microsoft.com/net/download/all) ![azure-publish_9](_static/azure-publish/azure-publish_9.png) IIS se používá k hostování webových aplikací ASP.NET Core, přičemž jeho role se omezí na proxy server. Hostování aplikací ASP.NET Core na IIS probíhá pomocí nativního modulu *AspNetCoreModuleV2*, který je nakonfigurován k přesměrování požadavků na webový server *Kestrel*. Tento modul řídí spuštění externího procesu `dotnet.exe`, ve kterém je aplikace hostována, a přeposílá všechny požadavky z IIS do tohoto hostitelského procesu. Po instalaci tohoto balíčku spusťte na příkazovém řádku příkaz **iisreset** nebo ručně restartujte IIS, aby server změny uplatnil. ### Konfigurace IIS 1. Musíte udělit oprávnění ke složce `wwwroot`. S webem vybraným ve **IIS Manager** zvolte **Edit Permissions** a ujistěte se, že *IUSR*, *IIS_IUSRS* nebo uživatel nakonfigurovaný pro fond aplikací (Application Pool) je autorizovaný uživatel s právy Read & Execute. Pokud žádný z těchto uživatelů není přítomen, přidejte *IUSR* jako uživatele s právy *Read & Execute*. ![azure-publish_10](_static/azure-publish/azure-publish_10.png) 1. Kliknutím na **Restart** v pravém panelu restartujte IIS Nyní je vše připraveno k publikování projektu. ## Publikování nopCommerce na virtuální počítač Azure z Microsoft Visual Studio Publikování aplikace nopCommerce se neliší od publikování jakékoli jiné aplikace ASP.NET Core. Proto budou popsány pouze minimální požadavky ke spuštění publikování. Více podrobností najdete [zde](https://docs.microsoft.com/aspnet/core/tutorials/publish-to-azure-webapp-using-vs?view=aspnetcore-2.1#deploy-the-app-to-azure). ## Publikování projektu `Nop.Web` 1. Otevřete řešení své webové aplikace v Microsoft Visual Studio. Klikněte pravým tlačítkem na projekt v *Solution Explorer* a zvolte **Publish**. ![azure-publish_11](_static/azure-publish/azure-publish_11.png) 1. Pomocí šipky vpravo na stránce procházejte možnosti publikování, dokud nenajdete **Microsoft Azure Virtual Machines**. Ze seznamu Existing Virtual Machines vyberte příslušný virtuální počítač. 1. Klikněte na **Create Profile**. ![azure-publish_12](_static/azure-publish/azure-publish_12.png) 1. Chcete-li zobrazit a upravit nastavení profilu publikování, vyberte **Configure**. Pomocí tlačítka **Validate Connection** ověřte, že jste zadali správné údaje. ![azure-publish_13](_static/azure-publish/azure-publish_13.png) 1. Pokud chcete zajistit, aby webový server měl po každém nahrání čistou kopii webové aplikace (a aby z předchozího nasazení nezůstaly žádné jiné soubory), můžete na kartě **Settings** zaškrtnout políčko **Remove additional files at destination**. Upozornění: Publikování s tímto nastavením odstraní všechny soubory, které existují na webovém serveru (adresář *wwwroot*). Před publikováním s touto možností se ujistěte, že znáte stav počítače. ![azure-publish_14](_static/azure-publish/azure-publish_14.png) 1. Klikněte na **Save**. 1. Kliknutím na **Publish** zahajte publikování. Nyní jste publikovali svou webovou aplikaci na virtuální počítač Azure. ## Možné problémy a jejich řešení Chcete-li jakýkoli problém prozkoumat [podrobněji](https://docs.microsoft.com/aspnet/core/host-and-deploy/aspnet-core-module), musíte zapnout protokolování – povolte stdoutLog v `web.config`: ```sh stdoutLogEnabled="true" stdoutLogFile=".\logs\stdout" ``` ### IIS nemůže najít web.config Možné řešení najdete na: [support.microsoft.com](http://support.microsoft.com/kb/942055) --- <!-- page: Hlavičky Content Security Policy (CSP) | url: http://nopdocs.service.hedr.dev/cs/developer/tutorials/csp-headers.html | source: cs/developer/tutorials/csp-headers.md --> # Hlavičky Content Security Policy (CSP) Content-Security-Policy je název hlavičky HTTP odpovědi, kterou moderní prohlížeče používají ke zvýšení zabezpečení dokumentu (nebo webové stránky). Hlavička HTTP odpovědi Content Security Policy dává administrátorům webu kontrolu tím, že jim umožňuje omezit zdroje, jako je JavaScript a CSS, které smí uživatel v rámci webu načíst. Jinými slovy, můžete vytvořit seznam povolených zdrojů obsahu vašeho webu (whitelist). Přestože se primárně používá jako hlavička HTTP odpovědi, můžete ji uplatnit také pomocí meta značky. ```html <meta http-equiv="Content-Security-Policy" content="default-src 'self'; img-src 'self' https://img.nopcommerce.com; object-src 'none'; script-src 'self'; style-src 'self'; frame-ancestors 'self'; base-uri 'self'; form-action 'self';"> ``` Chcete-li přidat tuto vlastní meta značku, přejděte na `www.yourStore.com/Admin/Setting/GeneralCommon`, najděte **`Custom <head> tag`** a přidejte ji, jak je znázorněno na obrázku níže. ![obrázek vlastní CSP značky v head](_static/csp-headers/custom-csp-head-tag.png) Content Security Policy chrání před útoky typu **Cross Site Scripting (XSS)** a dalšími formami útoků, jako je **ClickJacking**. I když jejich možnost zcela neodstraní, dokáže škody rozhodně minimalizovat. Kompatibilita není problém, protože většina hlavních prohlížečů CSP podporuje. Internet Explorer ji nepodporuje. Zda váš prohlížeč podporuje CSP, můžete otestovat pomocí tohoto [odkazu](https://content-security-policy.com/browser-test/). ## Přehled direktiv CSP Hodnota hlavičky **Content-Security-Policy** se skládá z jedné nebo více direktiv (definovaných níže) a více direktiv se odděluje *středníkem (;)* ### default-src Direktiva *default-src* definuje výchozí zásadu pro načítání zdrojů, jako je JavaScript, obrázky, CSS, písma, požadavky AJAX, rámce a média HTML5. Ne všechny direktivy se vracejí k *default-src*. ```html default-src 'self' cdn.nopcommerce.com; ``` ### script-src Definuje platné zdroje JavaScriptu. ```html script-src 'self' js.nopcommerce.com; ``` ### style-src Definuje platné zdroje šablon stylů neboli CSS. ```html style-src 'self' css.nopcommerce.com; ``` ### img-src Definuje platné zdroje obrázků. ```html img-src 'self' img.nopcommerce.com; ``` ### connect-src Vztahuje se na *XMLHttpRequest (AJAX), WebSocket nebo EventSource*. Pokud není povoleno, prohlížeč emuluje stavový kód HTTP **400**. ```html connect-src 'self'; ``` ### font-src Definuje platné zdroje písem (načítaných pomocí *@font-face*). ```html font-src font.nopcommerce.com; ``` ### object-src Definuje platné zdroje pluginů, např. `<object>`, `<embed>` nebo `<applet>`. ```html object-src 'self'; ``` ### media-src Definuje platné zdroje zvuku a videa, např. elementů HTML5 `<audio>`, `<video>`. ```html media-src media.nopcommerce.com; ``` ### frame-src Definuje platné zdroje pro načítání rámců. ```html frame-src 'self'; ``` ### sandbox Povoluje pro požadovaný zdroj sandbox podobně jako atribut *iframe sandbox*. Sandbox uplatňuje zásadu stejného původu (same-origin policy) a zabraňuje vyskakovacím oknům, pluginům a spouštění skriptů. Hodnotu sandbox můžete ponechat prázdnou, aby zůstala zachována všechna omezení, nebo přidat hodnoty: *allow-forms allow-same-origin allow-scripts allow-popups, allow-modals, allow-orientation-lock, allow-pointer-lock, allow-presentation, allow-popups-to-escape-sandbox* a *allow-top-navigation* ```html sandbox allow-forms allow-scripts; ``` ### child-src Definuje platné zdroje pro web workery a vnořené kontexty procházení načítané pomocí elementů, jako jsou `<frame>` a `<iframe>` ```html child-src 'self' ``` ### form-action Definuje platné zdroje, které lze použít jako akci HTML `<form>`. ```html form-action 'self'; ``` ### frame-ancestors Definuje platné zdroje pro vkládání zdroje pomocí `<frame> <iframe> <object> <embed> <applet>`. Nastavení této direktivy na **'none'** by mělo být zhruba ekvivalentní **X-Frame-Options: DENY** ```html frame-ancestors 'none'; ``` ### plugin-types Definuje platné typy MIME pro pluginy volané pomocí `<object>` a `<embed>`. Pro načtení `<applet>` musíte zadat *application/x-java-applet*. ```html plugin-types application/pdf; ``` ### report-to Definuje název skupiny pro hlášení definovaný hlavičkou HTTP odpovědi *Report-To*. Více informací najdete v [Reporting API](https://w3c.github.io/reporting/). ```html report-to groupName; ``` ### worker-src Omezuje URL, které lze načíst jako Worker, SharedWorker nebo ServiceWorker. ```html worker-src 'none'; ``` ### manifest-src Omezuje URL, ze kterých lze načítat manifesty aplikací. ```html manifest-src 'none'; ``` ### navigate-to Omezuje URL, na které může dokument jakýmkoli způsobem přejít. Například při kliknutí na odkaz, odeslání formuláře nebo volání *window.location*. Pokud je přítomna direktiva *form-action*, je tato direktiva při odesílání formulářů ignorována. [Stav implementace](https://www.chromestatus.com/features/6457580339593216) ```html navigate-to nopcommerce.com ``` ## Příklady Content-Security-Policy ### Povolit vše, ale pouze ze stejného původu ```html default-src 'self'; ``` ### Povolit pouze skripty ze stejného původu ```html script-src 'self'; ``` ### Povolit Google Analytics, Google AJAX CDN a stejný původ ```html script-src 'self' www.google-analytics.com ajax.googleapis.com; ``` ### Výchozí zásada ```html default-src 'none'; script-src 'self'; connect-src 'self'; img-src 'self'; style-src 'self'; ``` Tato zásada povoluje obrázky, skripty, AJAX a CSS ze stejného původu a nepovoluje načítání žádných jiných zdrojů (např. object, frame, media atd.). Je to dobrý výchozí bod pro mnoho webů. ## Chybové zprávy Content-Security-Policy Chybové zprávy CSP se mohou v závislosti na prohlížeči lišit. Ve vývojářských nástrojích Chrome uvidíme následující zprávu. ```js Refused to load the script 'script-uri' because it violates the following Content Security Policy directive: "your CSP directive". ``` Ve vývojářských nástrojích Firefoxu vypadá takto. ```js Content Security Policy: A violation occurred for a report-only CSP policy ("An attempt to execute inline scripts has been blocked"). The behavior was allowed, and a CSP report was sent. ``` Kromě zprávy v konzoli je na objektu window vyvolána událost **securitypolicyviolation**. Více informací najdete na tomto [odkazu](https://www.w3.org/TR/CSP2/#firing-securitypolicyviolationevent-events.). --- <!-- page: Jednotkové testy | url: http://nopdocs.service.hedr.dev/cs/developer/tutorials/unit-tests.html | source: cs/developer/tutorials/unit-tests.md --> # Jednotkové testy Myslím, že koncept jednotkových (UNIT) testů zná každý. Víme, k čemu se jednotkové testy používají, a shodneme se, že jsou důležitou součástí procesu vývoje spolehlivého softwaru. V tomto článku se těmito otázkami zabývat nebudeme. Všechny potřebné informace snadno najdete na internetu, například pomocí těchto odkazů: * [https://en.wikipedia.org/wiki/Unit_testing](https://en.wikipedia.org/wiki/Unit_testing) * [https://docs.microsoft.com/dotnet/core/testing/unit-testing-best-practices](https://docs.microsoft.com/dotnet/core/testing/unit-testing-best-practices) * [https://en.wikipedia.org/wiki/Test-driven_development](https://en.wikipedia.org/wiki/Test-driven_development) V tomto článku se seznámíme se specifiky testování v projektu nopCommerce a naučíme se přidávat nové testy a ověřovat jejich funkčnost. Nebudeme testovat abstraktní úlohu, ale od nuly napíšeme plnohodnotný test pro existující funkcionalitu. Na konci článku najdete odkaz na příslušný commit se všemi popsanými změnami kódu. ## Přehled vlastností ![tests-project](_static/unit-tests/tests-project.png) Na snímku obrazovky vidíte strukturu projektu `Nop.Tests`. Složky jako `Nop.Core.Tests` obsahují testy pro odpovídající projekty řešení. Ostatní soubory zajišťují pomocné a základní třídy. Podívejme se na třídu `BaseNopTest`. ### BaseNopTest Jde o hlavní statickou třídu, která zpřístupňuje IoC kontejner pro testy a umožňuje nám využívat všech výhod DI. ![base-nop-test](_static/unit-tests/base-nop-test.png) Tato třída obsahuje dvě metody dostupné odvozeným třídám: * ``PropertiesShouldEqual``, která porovnává všechna pole databázové entity s poli modelu. * ``GetService``, která umožňuje využívat výhod DI a ušetří vytváření tříd potřebných pro testování. Inicializace **IoC** kontejneru probíhá ve statickém konstruktoru třídy; tento konstruktor obsahuje většinu kódu. ## IScheduleTaskService Jako příklad vytvoříme testy pro třídu, která implementuje rozhraní `IScheduleTaskService`. ```csharp public partial interface IScheduleTaskService { System.Threading.Tasks.Task DeleteTaskAsync(ScheduleTask task); Task<ScheduleTask> GetTaskByIdAsync(int taskId); Task<ScheduleTask> GetTaskByTypeAsync(string type); Task<IList<ScheduleTask>> GetAllTasksAsync(bool showHidden = false); System.Threading.Tasks.Task InsertTaskAsync(ScheduleTask task); System.Threading.Tasks.Task UpdateTaskAsync(ScheduleTask task); } ``` Jak vidíte, jde o jednoduché rozhraní. Zároveň však nopCommerce umožňuje provádět velmi důležité úlohy, jako je odesílání e-mailových zpráv zákazníkům. Musíme si tedy být jisti, že funguje správně. Dále napíšeme testy pro každou z metod rozhraní. > [!NOTE] > > Nepoužíváme **TDD**, ale nejsme proti tomuto přístupu. Důležitá je pro nás spolehlivost funkcionality, nikoli konkrétní přístup k testování. ## Třída ScheduleTaskServiceTests Přidejte do projektu novou třídu `ScheduleTaskServiceTests` (Nop.Tests\Nop.Services.Tests\Tasks). Její kód je uveden níže: ```csharp using NUnit.Framework; namespace Nop.Tests.Nop.Services.Tests.Tasks { [TestFixture] public class ScheduleTaskServiceTests : ServiceTest { } } ``` Toto je šablona třídy pro testování. Z tohoto kódu vidíme, že nopCommerce používá pro testy **framework NUnit**. Je třeba si všimnout dvou věcí: 1. Naše třída má atribut **TestFixture**, který enginu sděluje, že tato třída obsahuje testy. 1. Nedědíme přímo od třídy `BaseNopTest`, ale od jiné abstraktní třídy – `ServiceTest`, která do konfigurace přidává hlavní pluginy. Dalším krokem je přidání metody pro inicializaci našich testů. Taková metoda se zpravidla nazývá **SetUp**. V této metodě získáme instanci třídy implementující rozhraní ``IScheduleTaskService``, kterou budeme testovat. ```csharp private IScheduleTaskService _scheduleTaskService; [OneTimeSetUp] public void SetUp() { _scheduleTaskService = GetService<IScheduleTaskService>(); } ``` Jak vidíte, metoda **SetUp** by měla být deklarována s atributem **OneTimeSetUp**; můžete však použít i atribut **SetUp**. Rozdíl mezi těmito dvěma atributy je pouze v počtu volání samotné metody: v prvním případě se metoda **SetUp** volá jednou pro všechny testy, ve druhém pro každý test zvlášť. Dále přidejme testy pro metody CRUD. V této službě jde o metody jako: **InsertTaskAsync**, **GetTaskByIdAsync**, **UpdateTaskAsync** a **DeleteTaskAsync**. Nejprve však do třídy přidejme ještě jedno pole. Bude to instance třídy `ScheduleTask`, která bude použita pro testování: ```csharp private ScheduleTask _task; ``` Upravte metodu **SetUp** následujícím způsobem: ```csharp [OneTimeSetUp] public void SetUp() { _scheduleTaskService = GetService<IScheduleTaskService>(); _task = new ScheduleTask { Enabled = true, Name = "Test task", Seconds = 60, Type = "nop.test.task" }; } ``` Všechny testovací metody CRUD jsou uvedeny níže a jak vidíte, není v nich nic složitého: ```csharp #region CRUD tests [Test] public async System.Threading.Tasks.Task CanInsertAndGetTask() { _task.Id = 0; await _scheduleTaskService.InsertTaskAsync(_task); var task = await _scheduleTaskService.GetTaskByIdAsync(_task.Id); await _scheduleTaskService.DeleteTaskAsync(_task); _task.Id.Should().NotBe(0); task.Id.Should().Be(_task.Id); task.Name.Should().Be(_task.Name); } [Test] public void InsertTaskShouldRaiseExceptionIfTaskIsNull() { Assert.Throws<AggregateException>(() => _scheduleTaskService.InsertTaskAsync(null).Wait()); } [Test] public async System.Threading.Tasks.Task GetTaskByIdShouldReturnNullIfTaskIdIsZero() { var task = await _scheduleTaskService.GetTaskByIdAsync(0); task.Should().BeNull(); } [Test] public async System.Threading.Tasks.Task GetTaskByIdShouldReturnNullIfTaskIdIsNotExists() { var task = await _scheduleTaskService.GetTaskByIdAsync(int.MaxValue); task.Should().BeNull(); } [Test] public async System.Threading.Tasks.Task CanUpdateTask() { _task.Id = 0; await _scheduleTaskService.InsertTaskAsync(_task); var task = await _scheduleTaskService.GetTaskByIdAsync(_task.Id); task.Name = "new test name"; await _scheduleTaskService.UpdateTaskAsync(task); var task2 = await _scheduleTaskService.GetTaskByIdAsync(_task.Id); await _scheduleTaskService.DeleteTaskAsync(_task); task.Id.Should().Be(task2.Id); task2.Name.Should().NotBe(_task.Name); } [Test] public void UpdateTaskShouldRaiseExceptionIfTaskIsNull() { Assert.Throws<AggregateException>(() => _scheduleTaskService.UpdateTaskAsync(null).Wait()); } public async System.Threading.Tasks.Task CanDeleteTask() { _task.Id = 0; await _scheduleTaskService.InsertTaskAsync(_task); await _scheduleTaskService.DeleteTaskAsync(_task); var task = await _scheduleTaskService.GetTaskByIdAsync(_task.Id); task.Should().BeNull(); } [Test] public void DeleteTaskShouldRaiseExceptionIfTaskIsNull() { Assert.Throws<AggregateException>(() => _scheduleTaskService.DeleteTaskAsync(null).Wait()); } #endregion ``` Kromě toho byl změněn seznam připojených jmenných prostorů. Aktualizovaný seznam je uveden níže: ```csharp using System; using FluentAssertions; using Nop.Core.Domain.Tasks; using Nop.Services.Tasks; using NUnit.Framework; ``` > [!NOTE] > > Všechny změny provedené testem musíme z databáze odstranit. V našem případě k tomu používáme metodu `DeleteTaskAsync`. Všimněte si také, že je třeba to provést těsně předtím, než zavoláme ověřovací metody, jako jsou `task.Should().BeNull();`, `task2.Name.Should().NotBe(_task.Name);` atd., protože pokud test selže, zůstanou v databázi data, která mohou ovlivnit další testovací procesy. Poté otestujme dvě zbývající metody: ```csharp [Test] public async System.Threading.Tasks.Task CanGetTaskByType() { _task.Id = 0; var task = await _scheduleTaskService.GetTaskByTypeAsync(_task.Type); task.Should().BeNull(); await _scheduleTaskService.InsertTaskAsync(_task); task = await _scheduleTaskService.GetTaskByTypeAsync(_task.Type); await _scheduleTaskService.DeleteTaskAsync(_task); task.Should().NotBeNull(); } [Test] public async System.Threading.Tasks.Task GetTaskByTypeShouldReturnNullIfTypeIsNull() { var task = await _scheduleTaskService.GetTaskByTypeAsync(null); task.Should().BeNull(); } [Test] public async System.Threading.Tasks.Task GetTaskByTypeShouldReturnNullIfTypeIsEmpty() { var task = await _scheduleTaskService.GetTaskByTypeAsync(string.Empty); task.Should().BeNull(); } [Test] public async System.Threading.Tasks.Task CanGetAllTasks() { _task.Id = 0; var tasks = await _scheduleTaskService.GetAllTasksAsync(true); tasks.Count.Should().Be(0); tasks = await _scheduleTaskService.GetAllTasksAsync(false); tasks.Count.Should().Be(0); await _scheduleTaskService.InsertTaskAsync(_task); var tasksWithHidden = await _scheduleTaskService.GetAllTasksAsync(true); var tasksWitoutHidden = await _scheduleTaskService.GetAllTasksAsync(false); await _scheduleTaskService.DeleteTaskAsync(_task); tasksWithHidden.Count.Should().Be(1); tasksWitoutHidden.Count.Should().Be(1); _task.Enabled = false; await _scheduleTaskService.InsertTaskAsync(_task); tasksWithHidden = await _scheduleTaskService.GetAllTasksAsync(true); tasksWitoutHidden = await _scheduleTaskService.GetAllTasksAsync(false); await _scheduleTaskService.DeleteTaskAsync(_task); _task.Enabled = true; tasksWithHidden.Count.Should().Be(1); tasksWitoutHidden.Count.Should().Be(0); } ``` Nakonec přidejme ještě jednu standardní metodu, kterou má mnoho testů a která se obvykle nazývá **TearDown**. V této metodě provedeme závěrečné vyčištění databáze od případných změn, které jsme provedli během testování. Tato metoda musí mít atribut **OneTimeTearDown** nebo **TearDown**, obdobně jako atributy metody SetUp. ```csharp [OneTimeTearDown] public async System.Threading.Tasks.Task TearDown() { var tasks = await _scheduleTaskService.GetAllTasksAsync(true); foreach (var task in tasks.Where(t=>t.Type.Equals(_task.Type, StringComparison.InvariantCultureIgnoreCase))) await _scheduleTaskService.DeleteTaskAsync(task); } ``` A je to, naše testovací třída je hotová! Jak jsme slíbili na začátku, všechny materiály najdete na odkazech níže: * **[Úplný zdrojový kód: ScheduleTaskServiceTests](https://github.com/nopSolutions/nopCommerce/blob/develop/src/Tests/Nop.Tests/Nop.Services.Tests/ScheduleTasks/ScheduleTaskServiceTests.cs)** — finální verze testovací třídy v repozitáři. * **[Git commit](https://github.com/nopSolutions/nopCommerce/commit/81c31e1ee754f771ddfdc26e9b95a729e38b2d29)** — konkrétní commit se všemi přidanými a změněnými částmi. --- <!-- page: Vytvoření pluginu pro nopCommerce | url: http://nopdocs.service.hedr.dev/cs/developer/plugins/index.html | source: cs/developer/plugins/index.md --> # Vytvoření pluginu pro nopCommerce * [Jak napsat plugin pro nopCommerce 5.00](xref:cs/developer/plugins/how-to-write-plugin-5.00) * [Jak napsat plugin pro nopCommerce 4.90](xref:cs/developer/plugins/how-to-write-plugin-4.90) * [Jak napsat plugin pro nopCommerce 4.80](xref:cs/developer/plugins/how-to-write-plugin-4.80) * [Jak napsat plugin pro nopCommerce 4.70](xref:cs/developer/plugins/how-to-write-plugin-4.70) * [Jak napsat plugin pro nopCommerce 4.60](xref:cs/developer/plugins/how-to-write-plugin-4.60) * [Jak napsat plugin pro nopCommerce 4.50](xref:cs/developer/plugins/how-to-write-plugin-4.50) * [Jak napsat plugin pro nopCommerce 4.40](xref:cs/developer/plugins/how-to-write-plugin-4.40) * [Jak napsat plugin pro nopCommerce 4.30](xref:cs/developer/plugins/how-to-write-plugin-4.30) * [Jak napsat plugin pro nopCommerce 4.20](xref:cs/developer/plugins/how-to-write-plugin-4.20) * [Jak napsat plugin pro nopCommerce 4.10](xref:cs/developer/plugins/how-to-write-plugin-4.10) * [Jak napsat plugin pro nopCommerce 4.00](xref:cs/developer/plugins/how-to-write-plugin-4.00) * [Jak napsat plugin pro nopCommerce 3.90 (a předchozí verze)](xref:cs/developer/plugins/how-to-write-plugin-3.90) * [Jak naprogramovat vlastní platební metodu](xref:cs/developer/plugins/payment-method) * [Jak naprogramovat vlastní metodu výpočtu ceny dopravy](xref:cs/developer/plugins/shipping-plugin) * [Cloudflare Images](xref:cs/developer/plugins/cloudflare-images) * [Plugin s přístupem k datům](xref:cs/developer/plugins/plugin-with-data-access) * [Plugin s přístupem k datům pro verze 4.20 a starší](xref:cs/developer/plugins/plugin-with-data-access-4.20) * [Jak z pluginu přidat položku nabídky do administrace](xref:cs/developer/plugins/menu-item) * [Přidání souborů prostředků CSS a JS do pluginu nopCommerce](xref:cs/developer/plugins/resource-files) * [Jak napsat widget pro nopCommerce](xref:cs/developer/plugins/how-to-write-widget-for-nopCommerce) * [Jak napsat daňový plugin pro nopCommerce 4.20](xref:cs/developer/plugins/how-to-write-tax-plugin-4.20) * [Popis struktury souboru plugin.json](xref:cs/developer/plugins/plugin_json) --- <!-- page: Jak napsat plugin pro nopCommerce | url: http://nopdocs.service.hedr.dev/cs/developer/plugins/how-to-write-plugin-5.00.html | source: cs/developer/plugins/how-to-write-plugin-5.00.md --> # Jak napsat plugin pro nopCommerce Pluginy slouží k rozšíření funkčnosti nopCommerce. nopCommerce má několik typů pluginů. Například platební metody (jako PayPal), poskytovatele daní, metody výpočtu ceny dopravy (jako UPS, USP, FedEx), widgety (jako blok „live chat“) a mnoho dalších. nopCommerce je již distribuován s mnoha různými pluginy. Na [oficiálním webu nopCommerce](https://www.nopcommerce.com/marketplace) můžete také vyhledávat různé pluginy a zjistit, zda již někdo nevytvořil plugin, který vyhovuje vašim potřebám. Pokud ne, tento článek vás provede procesem vytvoření vlastního pluginu. ## Struktura pluginu, požadované soubory a umístění 1. Nejprve musíte v řešení (solution) vytvořit nový projekt typu *`Class Library`*. Je dobrým zvykem umisťovat všechny pluginy do adresáře `\Plugins` v kořeni řešení (nezaměňujte s podadresářem `\Plugins` v adresáři `\Nop.Web`, který slouží pro již nasazené pluginy). Je dobrým zvykem umisťovat všechny pluginy do složky řešení `Plugins`. Doporučený název projektu pluginu je **`Nop.Plugin.{Group}.{Name}`**. **`{Group}`** je skupina vašeho pluginu (například *Payment* nebo *Shipping*). **`{Name}`** je název vašeho pluginu (například *PayPalCommerce*). Například platební plugin PayPal Commerce má následující název: **`Nop.Plugin.Payments.PayPalCommerce`**. Upozorňujeme však, že nejde o povinnost. Pro plugin si můžete zvolit libovolný název. Například `MyGreatPlugin`. ![p1](_static/how-to-write-plugin-5.00/write_plugin_5.00_all_plugins.png) 1. Jakmile je projekt pluginu vytvořen, otevřete jeho soubor `.csproj` v libovolném textovém editoru a nahraďte jeho obsah následujícím: ```xml <Project Sdk="Microsoft.NET.Sdk"> <PropertyGroup> <TargetFramework>net10.0</TargetFramework> <Copyright>SOME_COPYRIGHT</Copyright> <Company>YOUR_COMPANY</Company> <Authors>SOME_AUTHORS</Authors> <PackageLicenseUrl>PACKAGE_LICENSE_URL</PackageLicenseUrl> <PackageProjectUrl>PACKAGE_PROJECT_URL</PackageProjectUrl> <RepositoryUrl>REPOSITORY_URL</RepositoryUrl> <RepositoryType>Git</RepositoryType> <OutputPath>$(SolutionDir)\Presentation\Nop.Web\Plugins\PLUGIN_OUTPUT_DIRECTORY</OutputPath> <OutDir>$(OutputPath)</OutDir> <!--Set this parameter to true to get the dlls copied from the NuGet cache to the output of your project. You need to set this parameter to true if your plugin has a nuget package to ensure that the dlls copied from the NuGet cache to the output of your project--> <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies> <ImplicitUsings>enable</ImplicitUsings> </PropertyGroup> <ItemGroup> <ProjectReference Include="$(SolutionDir)\Presentation\Nop.Web.Framework\Nop.Web.Framework.csproj" /> <ClearPluginAssemblies Include="$(SolutionDir)\Build\ClearPluginAssemblies.proj" /> </ItemGroup> <!-- This target executes after "Build" target --> <Target Name="NopTarget" AfterTargets="Build"> <!-- Delete unnecessary libraries from plugins path --> <MSBuild Projects="@(ClearPluginAssemblies)" Properties="PluginPath=$(OutDir)" Targets="NopClear" /> </Target> </Project> ``` > [!TIP] > > Kde **PLUGIN_OUTPUT_DIRECTORY** je třeba nahradit názvem pluginu, například `Payments.PayPalCommerce`. > > Děláme to takto, abychom mohli využít nový způsob přidávání referencí třetích stran, který byl zaveden v .NET Core. Ve skutečnosti to však není povinné. Navíc reference z již referencovaných knihoven se načtou automaticky. Je to tedy velmi pohodlné. 1. Dalším krokem je vytvoření souboru `plugin.json`, který je vyžadován pro každý plugin. Tento soubor obsahuje metainformace popisující váš plugin. Stačí tento soubor zkopírovat z jakéhokoli jiného existujícího pluginu a upravit jej podle svých potřeb. Informace o souboru `plugin.json` najdete v části [soubor plugin.json](xref:cs/developer/plugins/plugin_json) 1. Posledním povinným krokem je vytvoření třídy, která implementuje rozhraní **`IPlugin`** (jmenný prostor `Nop.Services.Plugins`). nopCommerce obsahuje třídu **`BasePlugin`**, která již implementuje některé metody `IPlugin` a umožňuje vám vyhnout se duplikaci zdrojového kódu. nopCommerce vám také poskytuje některá specifická rozhraní odvozená od `IPlugin`. Máme například rozhraní `IPaymentMethod`, které se používá k vytváření nových pluginů platebních metod. Obsahuje některé metody specifické pouze pro platební metody, například *`ProcessPaymentAsync()`* nebo *`GetAdditionalHandlingFeeAsync()`*. V současnosti má nopCommerce následující specifická rozhraní pluginů: - **IPaymentMethod**. Tyto pluginy slouží ke zpracování plateb. - **IShippingRateComputationMethod**. Tyto pluginy slouží k získání přípustných způsobů doručení a odpovídajících cen dopravy. Například UPS, UPS, FedEx atd. - **IPickupPointProvider**. Tyto pluginy slouží k poskytování výdejních míst. - **ITaxProvider**. Poskytovatelé daní slouží k získávání daňových sazeb. - **IExchangeRateProvider**. Slouží k získávání směnného kurzu měn. - **IDiscountRequirementRule**. Umožňuje vytvářet nová pravidla slev, například „Fakturační země zákazníka musí být…“ - **IExternalAuthenticationMethod**. Slouží k vytváření metod externího ověřování, jako je Facebook, X (Twitter), OpenID atd. - **IMultiFactorAuthenticationMethod**. Slouží k vytváření metod vícefaktorového ověřování, jako je *GoogleAuthenticator* atd. >[!NOTE] > > Jde o nové rozhraní; od verze 4.40 poskytujeme odpovídající infrastrukturu pro integrace MFA přímo v základu. - **IWidgetPlugin**. Umožňuje vytvářet widgety. Widgety se vykreslují v určitých částech vašeho webu. Může to být například blok „Live chat“ v levém sloupci webu. - **IMiscPlugin**. Pokud váš plugin neodpovídá žádnému z výše uvedených rozhraní. > [!IMPORTANT] > > Po každém sestavení projektu vyčistěte řešení, než provedete změny. Některé prostředky se ukládají do cache, což může vývojáře přivést k šílenství. > > Po přidání pluginu může být nutné řešení znovu sestavit. Pokud nevidíte knihovny DLL svého pluginu v `Nop.Web\Plugins\PLUGIN_OUTPUT_DIRECTORY`, musíte řešení znovu sestavit. nopCommerce nezobrazí váš plugin na stránce *Místní pluginy* (Local Plugins), pokud vaše knihovny DLL neexistují ve správné složce v `Nop.Web`. ## Zpracování požadavků. Controllery, modely a view Nyní můžete plugin zobrazit v **Administrace → Konfigurace → Místní pluginy** (Admin area → Configuration → Local Plugins). Jak ale tušíte, náš plugin nic nedělá. Nemá ani uživatelské rozhraní pro svou konfiguraci. Vytvořme tedy stránku pro konfiguraci pluginu. Nyní musíme vytvořit controller, model a view. 1. MVC controllery odpovídají na požadavky odeslané na web ASP.NET Core MVC. Každý požadavek prohlížeče je namapován na konkrétní controller. 1. View obsahuje HTML značky a obsah, který se odesílá do prohlížeče. View je při práci s aplikací `ASP.NET Core MVC` ekvivalentem stránky. 1. MVC model obsahuje veškerou logiku aplikace, která není obsažena ve view ani v controlleru. Více informací o [návrhovém vzoru MVC najdete zde](https://docs.microsoft.com/aspnet/core/mvc/overview). Začněme tedy: - **Vytvořte model**. Do nového pluginu přidejte složku **Models** a poté přidejte novou třídu modelu, která odpovídá vašim potřebám. - **Vytvořte view**. Do nového pluginu přidejte složku **Views** a poté přidejte soubor `*.cshtml` s názvem `Configure.cshtml`. U souboru view nastavte vlastnost **„Build Action“** na **„Content“** a vlastnost **„Copy to Output Directory“** na **„Copy always“**. Upozorňujeme, že konfigurační stránka by měla používat layout `_ConfigurePlugin`. - Ujistěte se také, že máte v adresáři \Views soubor `_ViewImports.cshtml`. Můžete jej jednoduše zkopírovat z jakéhokoli jiného existujícího pluginu. - **Vytvořte controller**. Do nového pluginu přidejte složku **Controllers** a poté přidejte novou třídu controlleru. Je dobrým zvykem pojmenovávat controllery pluginů `{Group}{Name}Controller.cs`. Například PaymentPayPalStandardController. Pojmenovávat controllery tímto způsobem samozřejmě není povinné (jde jen o doporučení). Poté vytvořte odpovídající akční metodu pro konfigurační stránku (v administraci). Pojmenujme ji *`Configure`*. Připravte třídu modelu a předejte ji následujícímu view pomocí fyzické cesty k view: `~/Plugins/{PluginOutputDirectory}/Views/Configure.cshtml`. - U své akční metody použijte následující atributy: ```csharp [AutoValidateAntiforgeryToken] [AuthorizeAdmin] //confirms access to the admin panel [Area(AreaNames.ADMIN)] //specifies the area containing a controller or action public class PayPalCommerceController : BasePluginController { public async Task<IActionResult> Configure(bool showtour = false) { return View("~/Plugins/Payments.PayPalCommerce/Views/Admin/Configure.cshtml"); } } ``` > [!TIP] > > Tyto atributy můžete přidat také přímo ke controlleru. V takovém případě jimi nemusíte označovat každou metodu. Otevřete například platební plugin `PayPalCommerce` a podívejte se na jeho implementaci `PayPalCommerceController`. Poté byste pro každý plugin, který má konfigurační stránku, měli zadat konfigurační URL. Základní třída s názvem `BasePlugin` obsahuje metodu `GetConfigurationPageUrl`, která vrací konfigurační URL: ```csharp private readonly INopUrlHelper _nopUrlHelper; public PayPalCommercePaymentMethod(INopUrlHelper nopUrlHelper) { _nopUrlHelper = nopUrlHelper; } public override string GetConfigurationPageUrl() { return _nopUrlHelper.RouteUrl(PayPalCommerceDefaults.Route.Configuration); } ``` Pro routování mimo controllery se nyní používá *INopUrlHelper*. Názvy standardních rout jsou uloženy jako konstanty ve výchozích hodnotách (defaults) pluginu. ```csharp /// <summary> /// Represents the plugin constants /// </summary> public class PayPalCommerceDefaults { /// <summary> /// Represents the route names /// </summary> public class Route { /// <summary> /// Gets the configuration route name /// </summary> public static string Configuration => "Plugin.Payments.PayPalCommerce.Configure"; } } ``` Registrace routy ke konfigurační stránce pluginu bude vypadat následovně. ```csharp endpointRouteBuilder.MapControllerRoute(name: PayPalCommerceDefaults.Route.Configuration, pattern: "Admin/PayPalCommerce/Configure", defaults: new { controller = "{CONTROLLER_NAME}", action = "{ACTION_NAME}", area = AreaNames.ADMIN }); ``` Kde **{CONTROLLER_NAME}** je název vašeho controlleru a **{ACTION_NAME}** je název akce (obvykle `Configure`). Jakmile plugin nainstalujete a přidáte konfigurační metodu, najdete odkaz pro konfiguraci pluginu v **Administrace → Konfigurace → Místní pluginy** (Admin → Configuration → Local Plugins). > [!TIP] > > Nejsnazší způsob, jak dokončit výše popsané kroky, je otevřít jakýkoli jiný plugin a zkopírovat tyto soubory do projektu svého pluginu. Poté stačí přejmenovat příslušné třídy a adresáře. Struktura projektu pluginu *PayPalCommerce* vypadá například jako na obrázku níže: ![p3](_static/how-to-write-plugin-5.00/write_plugin_5.00_proj_struct.png) ## Zpracování metod „InstallAsync“, „UninstallAsync“ a „UpdateAsync“ Tento krok je volitelný. Některé pluginy mohou během instalace vyžadovat další logiku. Plugin může například vkládat nové lokalizační řetězce. Otevřete tedy svou implementaci `IPlugin` (ve většině případů bude odvozena od třídy `BasePlugin`) a přepište následující metody: 1. **InstallAsync**. Tato metoda se zavolá během instalace pluginu. Zde můžete inicializovat libovolná nastavení, vložit nové lokalizační řetězce nebo vytvořit nové databázové tabulky (je-li to potřeba). 1. **UninstallAsync**. Tato metoda se zavolá během odinstalace pluginu. 1. **UpdateAsync**. Tato metoda se zavolá během aktualizace pluginu (když se změní jeho verze v souboru `plugin.json`). > [!IMPORTANT] > > Pokud některou z těchto metod přepíšete, neskrývejte její základní implementaci. Například přepsaná metoda `InstallAsync` by měla obsahovat následující volání metody: *`base.Install()`*. Metoda `InstallAsync` pluginu *PayPalStandard* vypadá jako kód níže ```csharp public override async Task InstallAsync() { await _settingService.SaveSettingAsync(new PayPalStandardPaymentSettings { UseSandbox = true }); await _localizationService.AddOrUpdateLocaleResourceAsync(new Dictionary<string, string> { ... }); await base.InstallAsync(); } ``` > [!TIP] > > Seznam nainstalovaných pluginů se nachází v souboru `\App_Data\plugins.json`. Seznam se vytváří během instalace. ## Routy Zde se podíváme, jak registrovat routy pluginu. Routování v ASP.NET Core zajišťuje mapování příchozích požadavků prohlížeče na konkrétní akce MVC controllerů. Více [informací o routování najdete zde](https://docs.microsoft.com/aspnet/core/fundamentals/routing). Postupujte tedy podle následujících kroků: Pokud potřebujete přidat vlastní routu, vytvořte soubor `RouteProvider.cs`. Ten informuje systém nopCommerce o routách pluginu. Například následující třída `RouteProvider` přidává novou routu, ke které lze přistoupit otevřením webového prohlížeče a přechodem na URL `http://www.yourStore.com/Plugins/PayPalCommerceWebhook/WebhookHandler`: ```csharp public class RouteProvider : IRouteProvider { /// <summary> /// Register routes /// </summary> /// <param name="endpointRouteBuilder">Route builder</param> public void RegisterRoutes(IEndpointRouteBuilder endpointRouteBuilder) { ... endpointRouteBuilder.MapControllerRoute(name: PayPalCommerceDefaults.Route.Webhook, pattern: "Plugins/PayPalCommerce/Webhook", defaults: new { controller = "PayPalCommerceWebhook", action = "WebhookHandler" }); } /// <summary> /// Gets a priority of route provider /// </summary> public int Priority => 0; } ``` ## Aktualizace nopCommerce může pluginy rozbít Některé pluginy mohou zastarat a přestat fungovat s novější verzí nopCommerce. Pokud máte po aktualizaci na novější verzi problémy, plugin odstraňte a navštivte oficiální web nopCommerce, abyste zjistili, zda je k dispozici novější verze. Mnoho autorů pluginů své pluginy aktualizuje, aby vyhovovaly novější verzi, někteří to však neudělají a jejich pluginy se s vylepšeními nopCommerce stanou zastaralými. Ve většině případů však můžete jednoduše otevřít příslušný soubor `plugin.json` a aktualizovat pole **SupportedVersions**. ## Závěr Doufáme, že vám to pomůže začít s nopCommerce a připraví vás na vytváření propracovanějších pluginů. ## Šablona pluginu Pro nové pluginy nopCommerce můžete použít [naši šablonu pro Visual Studio](https://github.com/nopSolutions/nopCommerce-plugin-template-VS/). Vývojářům může ušetřit spoustu času, protože již nemusí ručně provádět všechny počáteční kroky, jako je vytváření složek (Controllers, Views, Models atd.), dalších požadovaných souborů (PluginNopStartup.cs, _ViewImports.cshtml, ObjectContex, plugin.json, konfigurace, reference projektů atd.). --- <!-- page: Jak napsat plugin pro nopCommerce | url: http://nopdocs.service.hedr.dev/cs/developer/plugins/how-to-write-plugin-4.90.html | source: cs/developer/plugins/how-to-write-plugin-4.90.md --> # Jak napsat plugin pro nopCommerce Pluginy slouží k rozšíření funkčnosti nopCommerce. nopCommerce má několik typů pluginů. Například platební metody (jako PayPal), poskytovatelé daní, metody výpočtu dopravy (jako UPS, USP, FedEx), widgety (jako blok „live chat“) a mnoho dalších. nopCommerce je již distribuován s mnoha různými pluginy. Na [oficiálním webu nopCommerce](https://www.nopcommerce.com/marketplace) můžete také vyhledávat různé pluginy a zjistit, zda už někdo nevytvořil plugin, který vyhovuje vašim potřebám. Pokud ne, tento článek vás provede procesem vytvoření vlastního pluginu. ## Struktura pluginu, potřebné soubory a jejich umístění 1. Jako první musíte vytvořit v řešení (solution) nový projekt typu *`Class Library`*. Osvědčeným postupem je umístit všechny pluginy do adresáře `\Plugins` v kořeni řešení (nezaměňujte s podadresářem `\Plugins` v adresáři `\Nop.Web`, který se používá pro již nasazené pluginy). Osvědčeným postupem je umístit všechny pluginy do složky řešení `Plugins`. Doporučený název projektu pluginu je **`Nop.Plugin.{Group}.{Name}`**. **`{Group}`** je skupina vašeho pluginu (například *Payment* nebo *Shipping*). **`{Name}`** je název vašeho pluginu (například *PayPalCommerce*). Například platební plugin PayPal Commerce má následující název: **`Nop.Plugin.Payments.PayPalCommerce`**. Upozorňujeme však, že to není povinné. Pro plugin můžete zvolit libovolný název. Například `MyGreatPlugin`. ![p1](_static/how-to-write-plugin-4.90/write_plugin_4.90_all_plugins.png) 1. Po vytvoření projektu pluginu musíte otevřít jeho soubor `.csproj` v libovolném textovém editoru a nahradit jeho obsah následujícím: ```xml <Project Sdk="Microsoft.NET.Sdk"> <PropertyGroup> <TargetFramework>net9.0</TargetFramework> <Copyright>SOME_COPYRIGHT</Copyright> <Company>YOUR_COMPANY</Company> <Authors>SOME_AUTHORS</Authors> <PackageLicenseUrl>PACKAGE_LICENSE_URL</PackageLicenseUrl> <PackageProjectUrl>PACKAGE_PROJECT_URL</PackageProjectUrl> <RepositoryUrl>REPOSITORY_URL</RepositoryUrl> <RepositoryType>Git</RepositoryType> <OutputPath>$(SolutionDir)\Presentation\Nop.Web\Plugins\PLUGIN_OUTPUT_DIRECTORY</OutputPath> <OutDir>$(OutputPath)</OutDir> <!--Set this parameter to true to get the dlls copied from the NuGet cache to the output of your project. You need to set this parameter to true if your plugin has a nuget package to ensure that the dlls copied from the NuGet cache to the output of your project--> <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies> <ImplicitUsings>enable</ImplicitUsings> </PropertyGroup> <ItemGroup> <ProjectReference Include="$(SolutionDir)\Presentation\Nop.Web.Framework\Nop.Web.Framework.csproj" /> <ClearPluginAssemblies Include="$(SolutionDir)\Build\ClearPluginAssemblies.proj" /> </ItemGroup> <!-- This target executes after "Build" target --> <Target Name="NopTarget" AfterTargets="Build"> <!-- Delete unnecessary libraries from plugins path --> <MSBuild Projects="@(ClearPluginAssemblies)" Properties="PluginPath=$(OutDir)" Targets="NopClear" /> </Target> </Project> ``` > [!TIP] > Kde **PLUGIN_OUTPUT_DIRECTORY** je třeba nahradit názvem pluginu, například `Payments.PayPalCommerce`. > > Děláme to takto, abychom mohli využít nový přístup k přidávání referencí třetích stran, který byl zaveden v .NET Core. Ve skutečnosti to však není povinné. Navíc se reference z již odkazovaných knihoven načtou automaticky. Je to tedy velmi pohodlné. 1. Dalším krokem je vytvoření souboru `plugin.json`, který je vyžadován pro každý plugin. Tento soubor obsahuje metainformace popisující váš plugin. Stačí tento soubor zkopírovat z jakéhokoli jiného existujícího pluginu a upravit jej podle svých potřeb. Informace o souboru `plugin.json` najdete v části [Soubor plugin.json](xref:cs/developer/plugins/plugin_json) 1. Posledním povinným krokem je vytvoření třídy, která implementuje rozhraní **`IPlugin`** (jmenný prostor `Nop.Services.Plugins`). nopCommerce obsahuje třídu **`BasePlugin`**, která již implementuje některé metody `IPlugin` a umožňuje vyhnout se duplikaci zdrojového kódu. nopCommerce také poskytuje některá specifická rozhraní odvozená od `IPlugin`. Například máme rozhraní `IPaymentMethod`, které se používá k vytváření nových pluginů platebních metod. Obsahuje některé metody, které jsou specifické pouze pro platební metody, například *`ProcessPaymentAsync()`* nebo *`GetAdditionalHandlingFeeAsync()`*. V současnosti má nopCommerce následující specifická rozhraní pluginů: - **IPaymentMethod**. Tyto pluginy se používají ke zpracování plateb. - **IShippingRateComputationMethod**. Tyto pluginy se používají k získání podporovaných způsobů doručení a odpovídajících cen dopravy. Například UPS, UPS, FedEx atd. - **IPickupPointProvider**. Tyto pluginy se používají k poskytování výdejních míst. - **ITaxProvider**. Poskytovatelé daní se používají k získání daňových sazeb. - **IExchangeRateProvider**. Používá se k získání směnného kurzu měny. - **IDiscountRequirementRule**. Umožňuje vytvářet nová pravidla slev, například „Fakturační země zákazníka musí být…“ - **IExternalAuthenticationMethod**. Používá se k vytváření externích metod ověřování, jako jsou Facebook, X (Twitter), OpenID atd. - **IMultiFactorAuthenticationMethod**. Používá se k vytváření metod vícefaktorového ověřování, jako je *GoogleAuthenticator* atd. >[!NOTE] > Jde o nové rozhraní; od verze 4.40 poskytujeme odpovídající infrastrukturu pro integrace MFA přímo v základu. - **IWidgetPlugin**. Umožňuje vytvářet widgety. Widgety se vykreslují v určitých částech vašeho webu. Může jít například o blok „Live chat“ v levém sloupci webu. - **IMiscPlugin**. Pokud váš plugin neodpovídá žádnému z výše uvedených rozhraní. > [!IMPORTANT] > Po každém sestavení projektu vyčistěte řešení (solution) před provedením změn. Některé prostředky budou uloženy v cache, což může vývojáře přivést k šílenství. > > Po přidání pluginu může být nutné řešení znovu sestavit. Pokud v `Nop.Web\Plugins\PLUGIN_OUTPUT_DIRECTORY` nevidíte knihovny DLL svého pluginu, musíte řešení znovu sestavit. nopCommerce nezobrazí váš plugin na stránce *Lokální pluginy* (Local Plugins), pokud vaše knihovny DLL neexistují ve správné složce v `Nop.Web`. ## Zpracování požadavků. Controllery, modely a view Nyní můžete plugin zobrazit v **Administrace → Konfigurace → Lokální pluginy** (Admin area → Configuration → Local Plugins). Jak jste ale jistě uhodli, náš plugin nic nedělá. Nemá ani uživatelské rozhraní pro svou konfiguraci. Vytvořme tedy stránku pro konfiguraci pluginu. Nyní potřebujeme vytvořit controller, model a view. 1. MVC controllery odpovídají za reakci na požadavky odeslané na web ASP.NET Core MVC. Každý požadavek prohlížeče je namapován na konkrétní controller. 1. View obsahuje HTML značky a obsah, který se odesílá do prohlížeče. Při práci s aplikací `ASP.NET Core MVC` je view ekvivalentem stránky. 1. MVC model obsahuje veškerou logiku vaší aplikace, která není obsažena ve view ani v controlleru. Více informací o [vzoru MVC najdete zde](https://docs.microsoft.com/aspnet/core/mvc/overview). Pojďme tedy na to: - **Vytvořte model**. Přidejte do nového pluginu složku **Models** a poté přidejte novou třídu modelu, která vyhovuje vašim potřebám. - **Vytvořte view**. Přidejte do nového pluginu složku **Views** a poté přidejte soubor `*.cshtml` s názvem `Configure.cshtml`. Nastavte vlastnost **"Build Action"** souboru view na **"Content"** a vlastnost **"Copy to Output Directory"** na **"Copy always"**. Upozorňujeme, že konfigurační stránka by měla používat layout `_ConfigurePlugin`. - Ujistěte se také, že máte v adresáři \Views soubor `_ViewImports.cshtml`. Stačí jej zkopírovat z jakéhokoli jiného existujícího pluginu. - **Vytvořte controller**. Přidejte do nového pluginu složku **Controllers** a poté přidejte novou třídu controlleru. Osvědčeným postupem je pojmenovávat controllery pluginů `{Group}{Name}Controller.cs`. Například PaymentPayPalStandardController. Pojmenovávat controllery tímto způsobem samozřejmě není povinné (jde pouze o doporučení). Poté vytvořte příslušnou akční metodu pro konfigurační stránku (v administraci). Pojmenujme ji *`Configure`*. Připravte třídu modelu a předejte ji následujícímu view pomocí fyzické cesty k view: `~/Plugins/{PluginOutputDirectory}/Views/Configure.cshtml`. - Pro svou akční metodu použijte následující atributy: ```csharp [AutoValidateAntiforgeryToken] [AuthorizeAdmin] //confirms access to the admin panel [Area(AreaNames.ADMIN)] //specifies the area containing a controller or action public class PayPalCommerceController : BasePluginController { public async Task<IActionResult> Configure(bool showtour = false) { return View("~/Plugins/Payments.PayPalCommerce/Views/Admin/Configure.cshtml"); } } ``` > [!TIP] > Tyto atributy můžete přidat také přímo ke controlleru. V takovém případě není nutné jimi označovat každou metodu. Otevřete například platební plugin `PayPalCommerce` a podívejte se na jeho implementaci `PayPalCommerceController`. Poté byste pro každý plugin, který má konfigurační stránku, měli určit konfigurační URL. Základní třída `BasePlugin` má metodu `GetConfigurationPageUrl`, která vrací konfigurační URL: ```csharp private readonly INopUrlHelper _nopUrlHelper; public PayPalCommercePaymentMethod(INopUrlHelper nopUrlHelper) { _nopUrlHelper = nopUrlHelper; } public override string GetConfigurationPageUrl() { return _nopUrlHelper.RouteUrl(PayPalCommerceDefaults.Route.Configuration); } ``` Pro routing mimo controllery se nyní používá *INopUrlHelper*. Názvy standardních cest (routes) jsou uloženy jako konstanty ve výchozích hodnotách pluginu (defaults). ```csharp /// <summary> /// Represents the plugin constants /// </summary> public class PayPalCommerceDefaults { /// <summary> /// Represents the route names /// </summary> public class Route { /// <summary> /// Gets the configuration route name /// </summary> public static string Configuration => "Plugin.Payments.PayPalCommerce.Configure"; } } ``` Registrace cesty ke konfigurační stránce pluginu bude vypadat takto. ```csharp endpointRouteBuilder.MapControllerRoute(name: PayPalCommerceDefaults.Route.Configuration, pattern: "Admin/PayPalCommerce/Configure", defaults: new { controller = "{CONTROLLER_NAME}", action = "{ACTION_NAME}", area = AreaNames.ADMIN }); ``` Kde **{CONTROLLER_NAME}** je název vašeho controlleru a **{ACTION_NAME}** je název akce (obvykle `Configure`). Jakmile plugin nainstalujete a přidáte konfigurační metodu, najdete odkaz na konfiguraci pluginu v **Administrace → Konfigurace → Lokální pluginy** (Admin → Configuration → Local Plugins). > [!TIP] > Nejjednodušší způsob, jak výše popsané kroky provést, je otevřít jakýkoli jiný plugin a zkopírovat tyto soubory do projektu svého pluginu. Poté stačí přejmenovat příslušné třídy a adresáře. Například struktura projektu pluginu *PayPalCommerce* vypadá jako na obrázku níže: ![p3](_static/how-to-write-plugin-4.90/write_plugin_4.90_proj_struct.png) ## Zpracování metod "InstallAsync", "UninstallAsync" a "UpdateAsync" Tento krok je volitelný. Některé pluginy mohou během instalace vyžadovat dodatečnou logiku. Plugin může například vložit nové lokalizační prostředky. Otevřete tedy svou implementaci `IPlugin` (ve většině případů bude odvozena od třídy `BasePlugin`) a přepište následující metody: 1. **InstallAsync**. Tato metoda se zavolá během instalace pluginu. Zde můžete inicializovat jakákoli nastavení, vložit nové lokalizační prostředky nebo vytvořit nové databázové tabulky (pokud je to potřeba). 1. **UninstallAsync**. Tato metoda se zavolá během odinstalace pluginu. 1. **UpdateAsync**. Tato metoda se zavolá během aktualizace pluginu (když se změní jeho verze v souboru `plugin.json`). > [!IMPORTANT] > Pokud některou z těchto metod přepíšete, nezakrývejte její základní implementaci. Například přepsaná metoda `InstallAsync` by měla obsahovat následující volání metody: *`base.Install()`*. Metoda `InstallAsync` pluginu *PayPalStandard* vypadá jako kód níže ```csharp public override async Task InstallAsync() { await _settingService.SaveSettingAsync(new PayPalStandardPaymentSettings { UseSandbox = true }); await _localizationService.AddOrUpdateLocaleResourceAsync(new Dictionary<string, string> { ... }); await base.InstallAsync(); } ``` > [!TIP] > Seznam nainstalovaných pluginů se nachází v `\App_Data\plugins.json`. Seznam se vytváří během instalace. ## Cesty (routes) Zde se podíváme, jak registrovat cesty (routes) pluginu. Routing v ASP.NET Core odpovídá za mapování příchozích požadavků prohlížeče na konkrétní akce MVC controllerů. [Více informací o routingu najdete zde](https://docs.microsoft.com/aspnet/core/fundamentals/routing). Postupujte tedy podle následujících kroků: Pokud potřebujete přidat vlastní cestu, vytvořte soubor `RouteProvider.cs`. Ten informuje systém nopCommerce o cestách pluginu. Například následující třída `RouteProvider` přidává novou cestu, ke které lze přistoupit otevřením webového prohlížeče a přechodem na URL `http://www.yourStore.com/Plugins/PayPalCommerceWebhook/WebhookHandler` : ```csharp public class RouteProvider : IRouteProvider { /// <summary> /// Register routes /// </summary> /// <param name="endpointRouteBuilder">Route builder</param> public void RegisterRoutes(IEndpointRouteBuilder endpointRouteBuilder) { ... endpointRouteBuilder.MapControllerRoute(name: PayPalCommerceDefaults.Route.Webhook, pattern: "Plugins/PayPalCommerce/Webhook", defaults: new { controller = "PayPalCommerceWebhook", action = "WebhookHandler" }); } /// <summary> /// Gets a priority of route provider /// </summary> public int Priority => 0; } ``` ## Aktualizace nopCommerce může pluginy rozbít Některé pluginy mohou zastarat a přestat fungovat s novější verzí nopCommerce. Pokud máte po aktualizaci na novější verzi problémy, plugin smažte a navštivte oficiální web nopCommerce, abyste zjistili, zda je k dispozici novější verze. Mnoho autorů pluginů své pluginy aktualizuje, aby vyhovovaly novější verzi, někteří to však neudělají a jejich pluginy se s vylepšeními nopCommerce stanou zastaralými. Ve většině případů však stačí otevřít příslušný soubor `plugin.json` a aktualizovat pole **SupportedVersions**. ## Závěr Doufáme, že vám to pomůže začít s nopCommerce a připraví vás na tvorbu propracovanějších pluginů. ## Šablona pluginu Pro nové pluginy nopCommerce můžete použít [naši šablonu pro Visual Studio](https://github.com/nopSolutions/nopCommerce-plugin-template-VS/). Vývojářům může ušetřit spoustu času, protože již nemusí ručně provádět všechny úvodní kroky. Například vytváření složek (Controllers, Views, Models atd.), dalších potřebných souborů (PluginNopStartup.cs, _ViewImports.cshtml, ObjectContex, plugin.json, konfigurace, reference projektu atd.). --- <!-- page: Jak napsat plugin pro nopCommerce | url: http://nopdocs.service.hedr.dev/cs/developer/plugins/how-to-write-plugin-4.80.html | source: cs/developer/plugins/how-to-write-plugin-4.80.md --> # Jak napsat plugin pro nopCommerce Pluginy slouží k rozšíření funkcí nopCommerce. nopCommerce má několik typů pluginů. Například platební metody (jako PayPal), poskytovatele daní, metody výpočtu dopravy (jako UPS, USP, FedEx), widgety (jako blok „live chat“) a mnoho dalších. nopCommerce je již distribuován s mnoha různými pluginy. Na [oficiálním webu nopCommerce](https://www.nopcommerce.com/marketplace) můžete také vyhledat různé pluginy a zjistit, zda už někdo nevytvořil plugin, který vyhovuje vašim potřebám. Pokud ne, tento článek vás provede procesem vytvoření vlastního pluginu. ## Struktura pluginu, povinné soubory a umístění 1. Nejprve je potřeba vytvořit v řešení nový projekt typu *`Class Library`*. Je dobrou praxí umístit všechny pluginy do adresáře `\Plugins` v kořeni řešení (nezaměňujte s podadresářem `\Plugins` v adresáři `\Nop.Web`, který se používá pro již nasazené pluginy). Je dobrou praxí umístit všechny pluginy do složky řešení `Plugins`. Doporučený název projektu pluginu je **`Nop.Plugin.{Group}.{Name}`**. **`{Group}`** je skupina vašeho pluginu (například *Payment* nebo *Shipping*). **`{Name}`** je název vašeho pluginu (například *PayPalCommerce*). Například platební plugin PayPal Commerce má název **`Nop.Plugin.Payments.PayPalCommerce`**. Upozorňujeme však, že to není povinné. Pro plugin můžete zvolit libovolný název. Například `MyGreatPlugin`. ![p1](_static/how-to-write-plugin-4.80/write_plugin_4.80_1.jpg) 1. Po vytvoření projektu pluginu otevřete jeho soubor `.csproj` v libovolném textovém editoru a nahraďte jeho obsah následujícím: ```xml <Project Sdk="Microsoft.NET.Sdk"> <PropertyGroup> <TargetFramework>net9.0</TargetFramework> <Copyright>SOME_COPYRIGHT</Copyright> <Company>YOUR_COMPANY</Company> <Authors>SOME_AUTHORS</Authors> <PackageLicenseUrl>PACKAGE_LICENSE_URL</PackageLicenseUrl> <PackageProjectUrl>PACKAGE_PROJECT_URL</PackageProjectUrl> <RepositoryUrl>REPOSITORY_URL</RepositoryUrl> <RepositoryType>Git</RepositoryType> <OutputPath>$(SolutionDir)\Presentation\Nop.Web\Plugins\PLUGIN_OUTPUT_DIRECTORY</OutputPath> <OutDir>$(OutputPath)</OutDir> <!--Set this parameter to true to get the dlls copied from the NuGet cache to the output of your project. You need to set this parameter to true if your plugin has a nuget package to ensure that the dlls copied from the NuGet cache to the output of your project--> <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies> <ImplicitUsings>enable</ImplicitUsings> </PropertyGroup> <ItemGroup> <ProjectReference Include="$(SolutionDir)\Presentation\Nop.Web.Framework\Nop.Web.Framework.csproj" /> <ClearPluginAssemblies Include="$(SolutionDir)\Build\ClearPluginAssemblies.proj" /> </ItemGroup> <!-- This target executes after "Build" target --> <Target Name="NopTarget" AfterTargets="Build"> <!-- Delete unnecessary libraries from plugins path --> <MSBuild Projects="@(ClearPluginAssemblies)" Properties="PluginPath=$(OutDir)" Targets="NopClear" /> </Target> </Project> ``` > [!TIP] > Kde **PLUGIN_OUTPUT_DIRECTORY** je potřeba nahradit názvem pluginu, například `Payments.PayPalStandard`. > > Děláme to takto, abychom mohli používat nový způsob přidávání referencí třetích stran, který byl zaveden v .NET Core. Ve skutečnosti to však není povinné. Navíc se reference z již referencovaných knihoven načtou automaticky. Je to tedy velmi pohodlné. 1. Dalším krokem je vytvoření souboru `plugin.json`, který je povinný pro každý plugin. Tento soubor obsahuje metainformace popisující váš plugin. Stačí jej zkopírovat z jakéhokoli jiného existujícího pluginu a upravit podle svých potřeb. Informace o souboru `plugin.json` najdete v článku [Soubor plugin.json](xref:cs/developer/plugins/plugin_json) 1. Posledním povinným krokem je vytvoření třídy, která implementuje rozhraní **`IPlugin`** (jmenný prostor `Nop.Services.Plugins`). nopCommerce obsahuje třídu **`BasePlugin`**, která již implementuje některé metody `IPlugin` a umožňuje vyhnout se duplicitě zdrojového kódu. nopCommerce poskytuje také některá specifická rozhraní odvozená od `IPlugin`. Například rozhraní `IPaymentMethod` se používá k vytváření nových pluginů platebních metod. Obsahuje některé metody specifické pouze pro platební metody, jako je *`ProcessPaymentAsync()`* nebo *`GetAdditionalHandlingFeeAsync()`*. V současné době má nopCommerce následující specifická rozhraní pluginů: - **IPaymentMethod**. Tyto pluginy se používají ke zpracování plateb. - **IShippingRateComputationMethod**. Tyto pluginy se používají k získání podporovaných způsobů doručení a odpovídajících sazeb za dopravu. Například UPS, UPS, FedEx atd. - **IPickupPointProvider**. Tyto pluginy se používají k poskytování výdejních míst. - **ITaxProvider**. Poskytovatelé daní se používají k získání daňových sazeb. - **IExchangeRateProvider**. Používá se k získání směnného kurzu měny. - **IDiscountRequirementRule**. Umožňuje vytvářet nová pravidla slev, například „Fakturační země zákazníka musí být…“ - **IExternalAuthenticationMethod**. Používá se k vytváření externích metod ověřování, jako je Facebook, X (Twitter), OpenID atd. - **IMultiFactorAuthenticationMethod**. Používá se k vytváření metod vícefaktorového ověřování, jako je *GoogleAuthenticator* atd. >[!NOTE] > Jde o nové rozhraní; od verze 4.40 poskytujeme odpovídající infrastrukturu pro integrace MFA přímo v základu. - **IWidgetPlugin**. Umožňuje vytvářet widgety. Widgety se vykreslují v určitých částech vašeho webu. Může to být například blok „Live chat“ v levém sloupci webu. - **IMiscPlugin**. Pokud váš plugin neodpovídá žádnému z výše uvedených rozhraní. > [!IMPORTANT] > Po každém sestavení projektu vyčistěte řešení, než provedete změny. Některé prostředky se ukládají do cache, což může vývojáře přivést k šílenství. > > Po přidání pluginu může být nutné řešení znovu sestavit. Pokud nevidíte DLL svého pluginu v `Nop.Web\Plugins\PLUGIN_OUTPUT_DIRECTORY`, musíte řešení znovu sestavit. nopCommerce nezobrazí váš plugin na stránce *Lokální pluginy* (Local Plugins), pokud vaše DLL neexistují ve správné složce v `Nop.Web`. ## Zpracování požadavků. Controllery, modely a view Nyní můžete plugin zobrazit v **Administrace → Konfigurace → Lokální pluginy** (Admin area → Configuration → Local Plugins). Jak jste ale asi uhodli, náš plugin nic nedělá. Nemá ani uživatelské rozhraní pro svou konfiguraci. Vytvořme tedy stránku pro konfiguraci pluginu. Nyní je potřeba vytvořit controller, model a view. 1. Controllery MVC odpovídají na požadavky odeslané na web ASP.NET Core MVC. Každý požadavek prohlížeče je namapován na konkrétní controller. 1. View obsahuje HTML značky a obsah, který se odesílá do prohlížeče. View je při práci s aplikací `ASP.NET Core MVC` ekvivalentem stránky. 1. Model MVC obsahuje veškerou logiku aplikace, která není obsažena ve view nebo controlleru. Více informací najdete v popisu [vzoru MVC](https://docs.microsoft.com/aspnet/core/mvc/overview). Pojďme tedy na to: - **Vytvořte model**. Přidejte do nového pluginu složku **Models** a poté do ní přidejte novou třídu modelu podle svých potřeb. - **Vytvořte view**. Přidejte do nového pluginu složku **Views** a poté do ní přidejte soubor `*.cshtml` s názvem `Configure.cshtml`. Nastavte vlastnost **„Build Action“** souboru view na **„Content“** a vlastnost **„Copy to Output Directory“** na **„Copy always“**. Upozorňujeme, že konfigurační stránka by měla používat rozvržení `_ConfigurePlugin`. - Ujistěte se také, že máte v adresáři \Views soubor `_ViewImports.cshtml`. Stačí jej zkopírovat z jakéhokoli jiného existujícího pluginu. - **Vytvořte controller**. Přidejte do nového pluginu složku **Controllers** a poté do ní přidejte novou třídu controlleru. Je dobrou praxí pojmenovávat controllery pluginů `{Group}{Name}Controller.cs`. Například PaymentPayPalStandardController. Takové pojmenování samozřejmě není povinné (jde pouze o doporučení). Poté vytvořte odpovídající akční metodu pro konfigurační stránku (v administraci). Pojmenujme ji *`Configure`*. Připravte třídu modelu a předejte ji následujícímu view pomocí fyzické cesty k view: `~/Plugins/{PluginOutputDirectory}/Views/Configure.cshtml`. - Pro svou akční metodu použijte následující atributy: ```csharp [AutoValidateAntiforgeryToken] [AuthorizeAdmin] //confirms access to the admin panel [Area(AreaNames.ADMIN)] //specifies the area containing a controller or action public class PayPalCommerceController : BasePluginController { public async Task<IActionResult> Configure(bool showtour = false) { return View("~/Plugins/Payments.PayPalCommerce/Views/Configure.cshtml"); } } ``` > [!TIP] > Tyto atributy můžete přidat také přímo na controller. V takovém případě není nutné jimi označovat každou metodu. Otevřete například platební plugin `PayPalStandard` a podívejte se na jeho implementaci `PaymentPayPalStandardController`. Poté pro každý plugin, který má konfigurační stránku, musíte zadat konfigurační URL. Základní třída `BasePlugin` má metodu `GetConfigurationPageUrl`, která vrací konfigurační URL: ```csharp protected readonly IWebHelper _webHelper; public PaymentPayPalStandardProvider(IWebHelper webHelper) { _webHelper = webHelper; } public override string GetConfigurationPageUrl() { return $"{_webHelper.GetStoreLocation()}Admin/{CONTROLLER_NAME}/{ACTION_NAME}"; } ``` Kde **{CONTROLLER_NAME}** je název vašeho controlleru a **{ACTION_NAME}** je název akce (obvykle `Configure`). Jakmile plugin nainstalujete a přidáte konfigurační metodu, najdete odkaz na konfiguraci pluginu v **Administrace → Konfigurace → Lokální pluginy** (Admin → Configuration → Local Plugins). > [!TIP] > Nejjednodušší způsob, jak provést výše popsané kroky, je otevřít jakýkoli jiný plugin a zkopírovat tyto soubory do projektu svého pluginu. Poté stačí přejmenovat příslušné třídy a adresáře. Například struktura projektu pluginu *PayPalCommerce* vypadá jako na obrázku níže: ![p3](_static/how-to-write-plugin-4.80/write_plugin_4.80_3.jpg) ## Zpracování metod „InstallAsync“, „UninstallAsync“ a „UpdateAsync“ Tento krok je volitelný. Některé pluginy mohou během instalace vyžadovat dodatečnou logiku. Plugin může například vkládat nové lokalizační prostředky. Otevřete tedy svou implementaci `IPlugin` (ve většině případů bude odvozena od třídy `BasePlugin`) a přepište následující metody: 1. **InstallAsync**. Tato metoda se volá během instalace pluginu. Zde můžete inicializovat libovolná nastavení, vložit nové lokalizační prostředky nebo vytvořit nové databázové tabulky (je-li to potřeba). 1. **UninstallAsync**. Tato metoda se volá během odinstalace pluginu. 1. **UpdateAsync**. Tato metoda se volá během aktualizace pluginu (když se změní jeho verze v souboru `plugin.json`). > [!IMPORTANT] > Pokud některou z těchto metod přepíšete, neskrývejte její základní implementaci. Například přepsaná metoda `InstallAsync` by měla obsahovat následující volání metody: *`base.Install()`*. Metoda `InstallAsync` pluginu *PayPalStandard* vypadá jako kód níže ```csharp public override async Task InstallAsync() { await _settingService.SaveSettingAsync(new PayPalStandardPaymentSettings { UseSandbox = true }); await _localizationService.AddOrUpdateLocaleResourceAsync(new Dictionary<string, string> { ... }); await base.InstallAsync(); } ``` > [!TIP] > Seznam nainstalovaných pluginů se nachází v `\App_Data\plugins.json`. Seznam se vytváří během instalace. ## Routy Zde se podíváme, jak registrovat routy pluginu. Routing v ASP.NET Core odpovídá za mapování příchozích požadavků prohlížeče na konkrétní akce controllerů MVC. Více [informací o routingu](https://docs.microsoft.com/aspnet/core/fundamentals/routing) najdete v dokumentaci. Postupujte podle následujících kroků: Pokud potřebujete přidat vlastní routu, vytvořte soubor `RouteProvider.cs`. Ten informuje systém nopCommerce o routách pluginu. Například následující třída `RouteProvider` přidává novou routu, ke které se dostanete otevřením webového prohlížeče a přechodem na URL `http://www.yourStore.com/Plugins/PayPalCommerceWebhook/WebhookHandler` : ```csharp public class RouteProvider : IRouteProvider { /// <summary> /// Register routes /// </summary> /// <param name="endpointRouteBuilder">Route builder</param> public void RegisterRoutes(IEndpointRouteBuilder endpointRouteBuilder) { endpointRouteBuilder.MapControllerRoute(PayPalCommerceDefaults.ConfigurationRouteName, "Admin/PayPalCommerce/Configure", new { controller = "PayPalCommerce", action = "Configure" }); endpointRouteBuilder.MapControllerRoute(PayPalCommerceDefaults.WebhookRouteName, "Plugins/PayPalCommerce/Webhook", new { controller = "PayPalCommerceWebhook", action = "WebhookHandler" }); } /// <summary> /// Gets a priority of route provider /// </summary> public int Priority => 0; } ``` ## Aktualizace nopCommerce může pluginy rozbít Některé pluginy mohou zastarat a s novější verzí nopCommerce přestat fungovat. Pokud po aktualizaci na novější verzi narazíte na problémy, plugin smažte a na oficiálním webu nopCommerce zjistěte, zda je k dispozici jeho novější verze. Mnoho autorů pluginů své pluginy pro novější verzi aktualizuje, někteří to však neudělají a jejich pluginy se s vylepšeními nopCommerce stanou zastaralými. Ve většině případů však stačí otevřít příslušný soubor `plugin.json` a aktualizovat pole **SupportedVersions**. ## Závěr Doufáme, že vám to pomůže začít s nopCommerce a připraví vás na tvorbu propracovanějších pluginů. ## Šablona pluginu Pro nové pluginy nopCommerce můžete použít [naši šablonu pro Visual Studio](https://github.com/nopSolutions/nopCommerce-plugin-template-VS/). Vývojářům může ušetřit spoustu času, protože již nemusí ručně provádět všechny počáteční kroky, jako je vytváření složek (Controllers, Views, Models atd.), dalších povinných souborů (PluginNopStartup.cs, _ViewImports.cshtml, ObjectContex, plugin.json atd.), konfigurace, referencí projektu atd. --- <!-- page: Jak napsat plugin pro nopCommerce | url: http://nopdocs.service.hedr.dev/cs/developer/plugins/how-to-write-plugin-4.70.html | source: cs/developer/plugins/how-to-write-plugin-4.70.md --> # Jak napsat plugin pro nopCommerce Pluginy se používají k rozšíření funkcionality nopCommerce. nopCommerce má několik typů pluginů. Například platební metody (jako PayPal), poskytovatele daní, metody výpočtu dopravy (jako UPS, USP, FedEx), widgety (jako blok „živého chatu“) a mnoho dalších. nopCommerce je již distribuován s mnoha různými pluginy. Na [oficiálním webu nopCommerce](https://www.nopcommerce.com/marketplace) můžete také vyhledávat různé pluginy a zjistit, zda už někdo nevytvořil plugin, který vyhovuje vašim potřebám. Pokud ne, tento článek vás provede procesem vytvoření vlastního pluginu. ## Struktura pluginu, požadované soubory a umístění 1. Nejprve je potřeba v solution vytvořit nový projekt typu *`Class Library`*. Dobrou praxí je umístit všechny pluginy do adresáře `\Plugins` v kořeni vaší solution (nezaměňujte s podadresářem `\Plugins` v adresáři `\Nop.Web`, který se používá pro již nasazené pluginy). Dobrou praxí je také umístit všechny pluginy do složky solution `Plugins`. Doporučený název projektu pluginu je **`Nop.Plugin.{Group}.{Name}`**. **`{Group}`** je skupina vašeho pluginu (například *Payment* nebo *Shipping*). **`{Name}`** je název vašeho pluginu (například *PayPalCommerce*). Například platební plugin PayPal Commerce má následující název: **`Nop.Plugin.Payments.PayPalCommerce`**. Upozorňujeme však, že nejde o povinnost. Pro plugin si můžete zvolit libovolný název. Například `MyGreatPlugin`. ![p1](_static/how-to-write-plugin-4.70/write_plugin_4.70_1.jpg) 1. Jakmile je projekt pluginu vytvořen, otevřete jeho soubor `.csproj` v libovolném textovém editoru a nahraďte jeho obsah následujícím: ```xml <Project Sdk="Microsoft.NET.Sdk"> <PropertyGroup> <TargetFramework>net8.0</TargetFramework> <Copyright>SOME_COPYRIGHT</Copyright> <Company>YOUR_COMPANY</Company> <Authors>SOME_AUTHORS</Authors> <PackageLicenseUrl>PACKAGE_LICENSE_URL</PackageLicenseUrl> <PackageProjectUrl>PACKAGE_PROJECT_URL</PackageProjectUrl> <RepositoryUrl>REPOSITORY_URL</RepositoryUrl> <RepositoryType>Git</RepositoryType> <OutputPath>..\..\Presentation\Nop.Web\Plugins\PLUGIN_OUTPUT_DIRECTORY</OutputPath> <OutDir>$(OutputPath)</OutDir> <!--Set this parameter to true to get the dlls copied from the NuGet cache to the output of your project. You need to set this parameter to true if your plugin has a nuget package to ensure that the dlls copied from the NuGet cache to the output of your project--> <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies> <ImplicitUsings>enable</ImplicitUsings> </PropertyGroup> <ItemGroup> <ProjectReference Include="..\..\Presentation\Nop.Web.Framework\Nop.Web.Framework.csproj" /> <ClearPluginAssemblies Include="$(MSBuildProjectDirectory)\..\..\Build\ClearPluginAssemblies.proj" /> </ItemGroup> <!-- This target executes after "Build" target --> <Target Name="NopTarget" AfterTargets="Build"> <!-- Delete unnecessary libraries from plugins path --> <MSBuild Projects="@(ClearPluginAssemblies)" Properties="PluginPath=$(MSBuildProjectDirectory)\$(OutDir)" Targets="NopClear" /> </Target> </Project> ``` > [!TIP] > Kde **PLUGIN_OUTPUT_DIRECTORY** je třeba nahradit názvem pluginu, například `Payments.PayPalStandard`. > > Děláme to takto, abychom mohli využít nový přístup k přidávání referencí třetích stran, který byl zaveden v .NET Core. Ve skutečnosti to ale není nutné. Navíc se reference z již odkazovaných knihoven načtou automaticky. Je to tedy velmi pohodlné. 1. Dalším krokem je vytvoření souboru `plugin.json`, který je vyžadován pro každý plugin. Tento soubor obsahuje metainformace popisující váš plugin. Stačí tento soubor zkopírovat z jakéhokoli jiného existujícího pluginu a upravit jej podle svých potřeb. Informace o souboru `plugin.json` naleznete v článku [Soubor plugin.json](xref:cs/developer/plugins/plugin_json) 1. Posledním povinným krokem je vytvoření třídy, která implementuje rozhraní **`IPlugin`** (jmenný prostor `Nop.Services.Plugins`). nopCommerce obsahuje třídu **`BasePlugin`**, která již implementuje některé metody `IPlugin` a umožňuje vyhnout se duplikaci zdrojového kódu. nopCommerce vám také poskytuje některá specifická rozhraní odvozená od `IPlugin`. Máme například rozhraní `IPaymentMethod`, které se používá k vytváření nových pluginů platebních metod. Obsahuje některé metody, které jsou specifické pouze pro platební metody, například *`ProcessPaymentAsync()`* nebo *`GetAdditionalHandlingFeeAsync()`*. V současné době má nopCommerce následující specifická rozhraní pluginů: - **IPaymentMethod**. Tyto pluginy slouží ke zpracování plateb. - **IShippingRateComputationMethod**. Tyto pluginy slouží k získání akceptovaných způsobů doručení a odpovídajících sazeb za dopravu. Například UPS, UPS, FedEx atd. - **IPickupPointProvider**. Tyto pluginy slouží k poskytování výdejních míst. - **ITaxProvider**. Poskytovatelé daní slouží k získání daňových sazeb. - **IExchangeRateProvider**. Slouží k získání směnného kurzu měny. - **IDiscountRequirementRule**. Umožňuje vytvářet nová pravidla slev, například „Fakturační země zákazníka by měla být…“ - **IExternalAuthenticationMethod**. Slouží k vytváření externích metod ověřování, jako jsou Facebook, X (Twitter), OpenID atd. - **IMultiFactorAuthenticationMethod**. Slouží k vytváření metod vícefaktorového ověřování, jako je *GoogleAuthenticator* atd. >[!NOTE] > Jde o nové rozhraní; od verze 4.40 poskytujeme odpovídající infrastrukturu pro integrace MFA přímo v základu. - **IWidgetPlugin**. Umožňuje vytvářet widgety. Widgety se vykreslují v určitých částech vašeho webu. Může to být například blok „Živý chat“ v levém sloupci vašeho webu. - **IMiscPlugin**. Pokud váš plugin neodpovídá žádnému z výše uvedených rozhraní. > [!IMPORTANT] > Po každém sestavení projektu vyčistěte solution, než začnete provádět změny. Některé zdroje budou uloženy v cache, což může vývojáře přivést k šílenství. > > Po přidání pluginu může být nutné solution znovu sestavit (rebuild). Pokud v `Nop.Web\Plugins\PLUGIN_OUTPUT_DIRECTORY` nevidíte DLL knihovny svého pluginu, musíte solution znovu sestavit. nopCommerce nezobrazí váš plugin na stránce *Lokální pluginy* (Local Plugins), pokud vaše DLL knihovny neexistují ve správné složce v `Nop.Web`. ## Zpracování požadavků. Controllery, modely a view Nyní můžete plugin vidět v **Administrace → Konfigurace → Lokální pluginy** (Admin area → Configuration → Local Plugins). Jak jste ale jistě uhodli, náš plugin nic nedělá. Nemá ani uživatelské rozhraní pro svou konfiguraci. Vytvořme stránku pro konfiguraci pluginu. Nyní potřebujeme vytvořit controller, model a view. 1. MVC controllery odpovídají na požadavky vůči webu ASP.NET Core MVC. Každý požadavek prohlížeče je namapován na konkrétní controller. 1. View obsahuje HTML značky a obsah, který se odesílá do prohlížeče. View je při práci s aplikací `ASP.NET Core MVC` ekvivalentem stránky. 1. MVC model obsahuje veškerou logiku aplikace, která není obsažena ve view ani v controlleru. Více informací naleznete o [vzoru MVC](https://docs.microsoft.com/aspnet/core/mvc/overview). Pojďme tedy začít: - **Vytvořte model**. Do nového pluginu přidejte složku **Models** a poté přidejte novou třídu modelu, která vyhovuje vašim potřebám. - **Vytvořte view**. Do nového pluginu přidejte složku **Views** a poté přidejte soubor `*.cshtml` s názvem `Configure.cshtml`. U souboru view nastavte vlastnost **„Build Action“** na **„Content“** a vlastnost **„Copy to Output Directory“** na **„Copy always“**. Upozorňujeme, že konfigurační stránka by měla používat layout `_ConfigurePlugin`. - Ujistěte se také, že máte ve svém adresáři \Views soubor `_ViewImports.cshtml`. Můžete jej jednoduše zkopírovat z jakéhokoli jiného existujícího pluginu. - **Vytvořte controller**. Do nového pluginu přidejte složku **Controllers** a poté přidejte novou třídu controlleru. Dobrou praxí je pojmenovávat controllery pluginů `{Group}{Name}Controller.cs`. Například PaymentPayPalStandardController. Takové pojmenování controllerů samozřejmě není povinné (jde jen o doporučení). Poté vytvořte odpovídající akční metodu pro konfigurační stránku (v administraci). Pojmenujme ji *`Configure`*. Připravte třídu modelu a předejte ji následujícímu view pomocí fyzické cesty k view: `~/Plugins/{PluginOutputDirectory}/Views/Configure.cshtml`. - Pro svou akční metodu použijte následující atributy: ```csharp [AutoValidateAntiforgeryToken] [AuthorizeAdmin] //confirms access to the admin panel [Area(AreaNames.ADMIN)] //specifies the area containing a controller or action public class PayPalCommerceController : BasePluginController { public async Task<IActionResult> Configure(bool showtour = false) { return View("~/Plugins/Payments.PayPalCommerce/Views/Configure.cshtml"); } } ``` > [!TIP] > Tyto atributy můžete přidat také přímo na controller. V takovém případě není nutné jimi označovat každou metodu. Otevřete například platební plugin `PayPalStandard` a podívejte se na jeho implementaci `PaymentPayPalStandardController`. Poté byste pro každý plugin, který má konfigurační stránku, měli zadat konfigurační URL. Základní třída `BasePlugin` má metodu `GetConfigurationPageUrl`, která vrací konfigurační URL: ```csharp protected readonly IWebHelper _webHelper; public PaymentPayPalStandardProvider(IWebHelper webHelper) { _webHelper = webHelper; } public override string GetConfigurationPageUrl() { return $"{_webHelper.GetStoreLocation()}Admin/{CONTROLLER_NAME}/{ACTION_NAME}"; } ``` Kde **{CONTROLLER_NAME}** je název vašeho controlleru a **{ACTION_NAME}** je název akce (obvykle `Configure`). Jakmile plugin nainstalujete a přidáte konfigurační metodu, najdete odkaz na konfiguraci pluginu v **Administrace → Konfigurace → Lokální pluginy** (Admin → Configuration → Local Plugins). > [!TIP] > Nejjednodušší způsob, jak provést výše popsané kroky, je otevřít jakýkoli jiný plugin a zkopírovat tyto soubory do projektu svého pluginu. Poté stačí přejmenovat příslušné třídy a adresáře. Například struktura projektu pluginu *PayPalCommerce* vypadá jako na obrázku níže: ![p3](_static/how-to-write-plugin-4.70/write_plugin_4.70_3.jpg) ## Obsluha metod „InstallAsync“, „UninstallAsync“ a „UpdateAsync“ Tento krok je volitelný. Některé pluginy mohou během instalace vyžadovat dodatečnou logiku. Plugin může například vložit nové lokalizační zdroje. Otevřete tedy svou implementaci `IPlugin` (ve většině případů bude odvozena od třídy `BasePlugin`) a přepište následující metody: 1. **InstallAsync**. Tato metoda bude volána během instalace pluginu. Zde můžete inicializovat libovolná nastavení, vložit nové lokalizační zdroje nebo vytvořit nové databázové tabulky (pokud je to potřeba). 1. **UninstallAsync**. Tato metoda bude volána během odinstalace pluginu. 1. **UpdateAsync**. Tato metoda bude volána během aktualizace pluginu (když se změní jeho verze v souboru `plugin.json`). > [!IMPORTANT] > Pokud některou z těchto metod přepíšete, neskrývejte její základní implementaci. Například přepsaná metoda `InstallAsync` by měla obsahovat následující volání metody: *`base.Install()`*. Metoda `InstallAsync` pluginu *PayPalStandard* vypadá jako kód níže ```csharp public override async Task InstallAsync() { await _settingService.SaveSettingAsync(new PayPalStandardPaymentSettings { UseSandbox = true }); await _localizationService.AddOrUpdateLocaleResourceAsync(new Dictionary<string, string> { ... }); await base.InstallAsync(); } ``` > [!TIP] > Seznam nainstalovaných pluginů se nachází v `\App_Data\plugins.json`. Seznam se vytváří během instalace. ## Routy Zde se podíváme, jak registrovat routy pluginu. Směrování (routing) v ASP.NET Core je zodpovědné za mapování příchozích požadavků prohlížeče na konkrétní akce MVC controllerů. Více [informací o směrování](https://docs.microsoft.com/aspnet/core/fundamentals/routing) naleznete v dokumentaci. Postupujte tedy podle následujících kroků: Pokud potřebujete přidat vlastní routu, vytvořte soubor `RouteProvider.cs`. Ten informuje systém nopCommerce o routách pluginu. Například následující třída `RouteProvider` přidává novou routu, ke které lze přistoupit otevřením webového prohlížeče a přechodem na URL `http://www.yourStore.com/Plugins/PayPalCommerceWebhook/WebhookHandler`: ```csharp public class RouteProvider : IRouteProvider { /// <summary> /// Register routes /// </summary> /// <param name="endpointRouteBuilder">Route builder</param> public void RegisterRoutes(IEndpointRouteBuilder endpointRouteBuilder) { endpointRouteBuilder.MapControllerRoute(PayPalCommerceDefaults.ConfigurationRouteName, "Admin/PayPalCommerce/Configure", new { controller = "PayPalCommerce", action = "Configure" }); endpointRouteBuilder.MapControllerRoute(PayPalCommerceDefaults.WebhookRouteName, "Plugins/PayPalCommerce/Webhook", new { controller = "PayPalCommerceWebhook", action = "WebhookHandler" }); } /// <summary> /// Gets a priority of route provider /// </summary> public int Priority => 0; } ``` ## Aktualizace nopCommerce může pluginy rozbít Některé pluginy mohou zastarat a přestat fungovat s novější verzí nopCommerce. Pokud po aktualizaci na novější verzi narazíte na problémy, plugin odstraňte a navštivte oficiální web nopCommerce, abyste zjistili, zda je k dispozici novější verze. Mnoho autorů pluginů své pluginy aktualizuje pro novější verzi, někteří to však neudělají a jejich pluginy se s vylepšeními v nopCommerce stanou zastaralými. Ve většině případů ale stačí otevřít příslušný soubor `plugin.json` a aktualizovat pole **SupportedVersions**. ## Závěr Doufáme, že vám to pomůže začít s nopCommerce a připraví vás na tvorbu propracovanějších pluginů. ## Šablona pluginu Pro nové pluginy nopCommerce můžete použít [naši šablonu pro Visual Studio](https://github.com/nopSolutions/nopCommerce-plugin-template-VS/). Vývojářům může ušetřit spoustu času, protože už nemusí ručně provádět všechny počáteční kroky. Například vytváření složek (Controllers, Views, Models atd.), dalších požadovaných souborů (PluginNopStartup.cs, _ViewImports.cshtml, ObjectContex, plugin.json atd.), konfiguraci, reference projektů atd.). --- <!-- page: Jak napsat plugin pro nopCommerce | url: http://nopdocs.service.hedr.dev/cs/developer/plugins/how-to-write-plugin-4.60.html | source: cs/developer/plugins/how-to-write-plugin-4.60.md --> # Jak napsat plugin pro nopCommerce Pluginy slouží k rozšíření funkčnosti nopCommerce. nopCommerce má několik typů pluginů. Například platební metody (jako PayPal), poskytovatele daní, metody výpočtu dopravy (jako UPS, USP, FedEx), widgety (jako blok „live chat“) a mnoho dalších. nopCommerce je již distribuován s mnoha různými pluginy. Na [oficiálním webu nopCommerce](https://www.nopcommerce.com/marketplace) můžete také vyhledávat různé pluginy a zjistit, zda už někdo nevytvořil plugin, který vyhovuje vašim potřebám. Pokud ne, tento článek vás provede procesem vytvoření vlastního pluginu. ## Struktura pluginu, požadované soubory a umístění 1. Nejprve je třeba v řešení (solution) vytvořit nový projekt typu *`Class Library`*. Je dobrým zvykem umístit všechny pluginy do adresáře `\Plugins` v kořeni řešení (nezaměňujte s podadresářem `\Plugins` v adresáři `\Nop.Web`, který se používá pro již nasazené pluginy). Je dobrým zvykem umístit všechny pluginy do složky řešení `Plugins`. Doporučený název projektu pluginu je **`Nop.Plugin.{Group}.{Name}`**. **`{Group}`** je skupina vašeho pluginu (například *Payment* nebo *Shipping*). **`{Name}`** je název vašeho pluginu (například *PayPalCommerce*). Například platební plugin PayPal Commerce má následující název: **`Nop.Plugin.Payments.PayPalCommerce`**. Upozorňujeme však, že to není povinné. Pro plugin můžete zvolit libovolný název, například `MyGreatPlugin`. ![p1](_static/how-to-write-plugin-4.60/write_plugin_4.60_1.jpg) 1. Po vytvoření projektu pluginu otevřete jeho soubor `.csproj` v libovolném textovém editoru a nahraďte jeho obsah následujícím: ```xml <Project Sdk="Microsoft.NET.Sdk"> <PropertyGroup> <TargetFramework>net7.0</TargetFramework> <Copyright>SOME_COPYRIGHT</Copyright> <Company>YOUR_COMPANY</Company> <Authors>SOME_AUTHORS</Authors> <PackageLicenseUrl>PACKAGE_LICENSE_URL</PackageLicenseUrl> <PackageProjectUrl>PACKAGE_PROJECT_URL</PackageProjectUrl> <RepositoryUrl>REPOSITORY_URL</RepositoryUrl> <RepositoryType>Git</RepositoryType> <OutputPath>..\..\Presentation\Nop.Web\Plugins\PLUGIN_OUTPUT_DIRECTORY</OutputPath> <OutDir>$(OutputPath)</OutDir> <!--Set this parameter to true to get the dlls copied from the NuGet cache to the output of your project. You need to set this parameter to true if your plugin has a nuget package to ensure that the dlls copied from the NuGet cache to the output of your project--> <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies> </PropertyGroup> <ItemGroup> <ProjectReference Include="..\..\Presentation\Nop.Web.Framework\Nop.Web.Framework.csproj" /> <ClearPluginAssemblies Include="$(MSBuildProjectDirectory)\..\..\Build\ClearPluginAssemblies.proj" /> </ItemGroup> <!-- This target execute after "Build" target --> <Target Name="NopTarget" AfterTargets="Build"> <!-- Delete unnecessary libraries from plugins path --> <MSBuild Projects="@(ClearPluginAssemblies)" Properties="PluginPath=$(MSBuildProjectDirectory)\$(OutDir)" Targets="NopClear" /> </Target> </Project> ``` > [!TIP] > Kde **PLUGIN_OUTPUT_DIRECTORY** je třeba nahradit názvem pluginu, například `Payments.PayPalStandard`. > > Děláme to takto, abychom mohli využít nový způsob přidávání referencí na knihovny třetích stran, který byl zaveden v .NET Core. Ve skutečnosti to ale není nutné. Navíc se reference z již referencovaných knihoven načtou automaticky. Je to tedy velmi pohodlné. 1. Dalším krokem je vytvoření souboru `plugin.json`, který je vyžadován pro každý plugin. Tento soubor obsahuje metainformace popisující váš plugin. Stačí tento soubor zkopírovat z jakéhokoli jiného existujícího pluginu a upravit jej podle svých potřeb. Informace o souboru `plugin.json` naleznete v článku [Soubor plugin.json](xref:cs/developer/plugins/plugin_json). 1. Posledním povinným krokem je vytvoření třídy, která implementuje rozhraní **`IPlugin`** (jmenný prostor `Nop.Services.Plugins`). nopCommerce obsahuje třídu **`BasePlugin`**, která již implementuje některé metody `IPlugin` a umožňuje vyhnout se duplikaci zdrojového kódu. nopCommerce vám také poskytuje některá specifická rozhraní odvozená od `IPlugin`. Například máme rozhraní `IPaymentMethod`, které se používá k vytváření nových pluginů platebních metod. Obsahuje některé metody, které jsou specifické pouze pro platební metody, například *`ProcessPaymentAsync()`* nebo *`GetAdditionalHandlingFeeAsync()`*. V současné době má nopCommerce následující specifická rozhraní pluginů: - **IPaymentMethod**. Tyto pluginy se používají ke zpracování plateb. - **IShippingRateComputationMethod**. Tyto pluginy se používají k získání přijatelných způsobů doručení a odpovídajících sazeb za dopravu. Například UPS, UPS, FedEx atd. - **IPickupPointProvider**. Tyto pluginy se používají k poskytování výdejních míst. - **ITaxProvider**. Poskytovatelé daní se používají k získání daňových sazeb. - **IExchangeRateProvider**. Používá se k získání směnného kurzu měn. - **IDiscountRequirementRule**. Umožňuje vytvářet nová pravidla slev, například „Fakturační země zákazníka musí být…“ - **IExternalAuthenticationMethod**. Používá se k vytváření externích metod ověřování, jako jsou Facebook, X (Twitter), OpenID atd. - **IMultiFactorAuthenticationMethod**. Používá se k vytváření metod vícefaktorového ověřování, jako je *GoogleAuthenticator* atd. >[!NOTE] > Jde o nové rozhraní; od verze 4.40 poskytujeme odpovídající infrastrukturu pro integrace MFA přímo v základu. - **IWidgetPlugin**. Umožňuje vytvářet widgety. Widgety se vykreslují v některých částech webu. Může to být například blok „Live chat“ v levém sloupci webu. - **IMiscPlugin**. Pokud váš plugin neodpovídá žádnému z výše uvedených rozhraní. > [!IMPORTANT] > Po každém sestavení projektu vyčistěte řešení (clean) před provedením změn. Některé prostředky se ukládají do cache a mohou vývojáře přivést k šílenství. > > Po přidání pluginu může být nutné řešení znovu sestavit (rebuild). Pokud nevidíte knihovny DLL svého pluginu v `Nop.Web\Plugins\PLUGIN_OUTPUT_DIRECTORY`, musíte řešení znovu sestavit. nopCommerce nezobrazí váš plugin na stránce *Lokální pluginy* (Local Plugins), pokud vaše knihovny DLL neexistují ve správné složce v `Nop.Web`. ## Zpracování požadavků. Controllery, modely a view Nyní můžete plugin vidět v **Administrace → Konfigurace → Lokální pluginy** (Admin area → Configuration → Local Plugins). Jak jste ale jistě uhodli, náš plugin nic nedělá. Nemá ani uživatelské rozhraní pro svou konfiguraci. Vytvořme stránku pro konfiguraci pluginu. Nyní potřebujeme vytvořit controller, model a view. 1. MVC controllery jsou zodpovědné za odpovídání na požadavky odeslané na web ASP.NET Core MVC. Každý požadavek prohlížeče je namapován na konkrétní controller. 1. View obsahuje HTML značky a obsah, který se odesílá do prohlížeče. View je při práci s aplikací `ASP.NET Core MVC` ekvivalentem stránky. 1. MVC model obsahuje veškerou aplikační logiku, která není obsažena ve view ani v controlleru. Více informací naleznete o [vzoru MVC](https://docs.microsoft.com/aspnet/core/mvc/overview?view=aspnetcore-6.0). Pojďme tedy začít: - **Vytvořte model**. Do nového pluginu přidejte složku **Models** a poté přidejte novou třídu modelu, která odpovídá vašim potřebám. - **Vytvořte view**. Do nového pluginu přidejte složku **Views** a poté přidejte soubor `*.cshtml` s názvem `Configure.cshtml`. Nastavte vlastnost **"Build Action"** souboru view na **"Content"** a vlastnost **"Copy to Output Directory"** na **"Copy always"**. Upozorňujeme, že konfigurační stránka by měla používat layout `_ConfigurePlugin`. - Také se ujistěte, že máte v adresáři \Views soubor `_ViewImports.cshtml`. Můžete jej jednoduše zkopírovat z jakéhokoli jiného existujícího pluginu. - **Vytvořte controller**. Do nového pluginu přidejte složku **Controllers** a poté přidejte novou třídu controlleru. Dobrým zvykem je pojmenovávat controllery pluginů `{Group}{Name}Controller.cs`. Například PaymentPayPalStandardController. Samozřejmě to není povinné (jde pouze o doporučení). Poté vytvořte odpovídající akční metodu pro konfigurační stránku (v administraci). Pojmenujme ji *`Configure`*. Připravte třídu modelu a předejte ji následujícímu view pomocí fyzické cesty k view: `~/Plugins/{PluginOutputDirectory}/Views/Configure.cshtml`. - Pro akční metodu použijte následující atributy: ```csharp [AutoValidateAntiforgeryToken] [AuthorizeAdmin] //confirms access to the admin panel [Area(AreaNames.Admin)] //specifies the area containing a controller or action ``` > [!TIP] > Tyto atributy můžete přidat také přímo ke controlleru. V takovém případě není nutné jimi označovat každou metodu. Otevřete například platební plugin `PayPalStandard` a podívejte se na jeho implementaci `PaymentPayPalStandardController`. Poté byste pro každý plugin, který má konfigurační stránku, měli zadat konfigurační URL. Základní třída `BasePlugin` má metodu `GetConfigurationPageUrl`, která vrací konfigurační URL: ```csharp public override string GetConfigurationPageUrl() { return $"{_webHelper.GetStoreLocation()}Admin/{CONTROLLER_NAME}/{ACTION_NAME}"; } ``` Kde **{CONTROLLER_NAME}** je název vašeho controlleru a **{ACTION_NAME}** je název akce (obvykle `Configure`). Jakmile plugin nainstalujete a přidáte konfigurační metodu, najdete odkaz na konfiguraci pluginu v **Administrace → Konfigurace → Lokální pluginy** (Admin → Configuration → Local Plugins). > [!TIP] > Nejjednodušší způsob, jak provést výše popsané kroky, je otevřít jakýkoli jiný plugin a zkopírovat tyto soubory do projektu svého pluginu. Pak stačí přejmenovat příslušné třídy a adresáře. Například struktura projektu pluginu *PayPalCommerce* vypadá jako na obrázku níže: ![p3](_static/how-to-write-plugin-4.60/write_plugin_4.60_3.jpg) ## Zpracování metod „InstallAsync“, „UninstallAsync“ a „UpdateAsync“ Tento krok je volitelný. Některé pluginy mohou během instalace vyžadovat dodatečnou logiku. Plugin může například vložit nové lokalizační zdroje. Otevřete tedy svou implementaci `IPlugin` (ve většině případů bude odvozena od třídy `BasePlugin`) a přepište následující metody: 1. **InstallAsync**. Tato metoda bude volána během instalace pluginu. Zde můžete inicializovat libovolná nastavení, vložit nové lokalizační zdroje nebo vytvořit nové databázové tabulky (pokud je to potřeba). 1. **UninstallAsync**. Tato metoda bude volána během odinstalace pluginu. 1. **UpdateAsync**. Tato metoda bude volána během aktualizace pluginu (když se změní jeho verze v souboru `plugin.json`). > [!IMPORTANT] > Pokud přepíšete některou z těchto metod, neskrývejte její základní implementaci. Například přepsaná metoda `InstallAsync` by měla obsahovat následující volání metody: *`base.Install()`*. Metoda `InstallAsync` pluginu *PayPalStandard* vypadá jako kód níže ```csharp public override async Task InstallAsync() { await _settingService.SaveSettingAsync(new PayPalStandardPaymentSettings { UseSandbox = true }); await _localizationService.AddLocaleResourceAsync(new Dictionary<string, string> { ... }); await base.InstallAsync(); } ``` > [!TIP] > Seznam nainstalovaných pluginů se nachází v `\App_Data\plugins.json`. Seznam se vytváří během instalace. ## Routy Zde se podíváme na to, jak registrovat routy pluginu. Routování ASP.NET Core je zodpovědné za mapování příchozích požadavků prohlížeče na konkrétní akce MVC controllerů. Více informací naleznete o [routování](https://docs.microsoft.com/aspnet/core/fundamentals/routing). Postupujte tedy podle následujících kroků: Pokud potřebujete přidat vlastní routu, vytvořte soubor `RouteProvider.cs`. Ten informuje systém nopCommerce o routách pluginu. Například následující třída `RouteProvider` přidává novou routu, ke které lze přistoupit otevřením webového prohlížeče a přechodem na URL `http://www.yourStore.com/Plugins/PayPalCommerceWebhook/WebhookHandler`: ```csharp public class RouteProvider : IRouteProvider { /// <summary> /// Register routes /// </summary> /// <param name="endpointRouteBuilder">Route builder</param> public void RegisterRoutes(IEndpointRouteBuilder endpointRouteBuilder) { endpointRouteBuilder.MapControllerRoute(PayPalCommerceDefaults.WebhookRouteName, "Plugins/PayPalCommerce/Webhook", new { controller = "PayPalCommerceWebhook", action = "WebhookHandler" }); } /// <summary> /// Gets a priority of route provider /// </summary> public int Priority => 0; } ``` ## Aktualizace nopCommerce může pluginy rozbít Některé pluginy mohou zastarat a přestat fungovat s novější verzí nopCommerce. Pokud máte po aktualizaci na novější verzi problémy, plugin odstraňte a navštivte oficiální web nopCommerce, abyste zjistili, zda je k dispozici novější verze. Mnoho autorů pluginů své pluginy aktualizuje pro novější verzi, někteří to však neudělají a jejich plugin se s vylepšeními nopCommerce stane zastaralým. Ve většině případů ale stačí otevřít příslušný soubor `plugin.json` a aktualizovat pole **SupportedVersions**. ## Závěr Doufáme, že vám tento článek pomůže začít s nopCommerce a připraví vás na vytváření propracovanějších pluginů. ## Šablona pluginu Pro nové pluginy nopCommerce můžete použít [naši šablonu pro Visual Studio](https://github.com/nopSolutions/nopCommerce-plugin-template-VS/). Vývojářům může ušetřit spoustu času, protože již nemusí ručně provádět všechny úvodní kroky, jako je vytváření složek (Controllers, Views, Models atd.), dalších požadovaných souborů (PluginNopStartup.cs, _ViewImports.cshtml, ObjectContex, plugin.json atd.), konfigurace, referencí projektu atd. --- <!-- page: Jak napsat plugin pro nopCommerce | url: http://nopdocs.service.hedr.dev/cs/developer/plugins/how-to-write-plugin-4.50.html | source: cs/developer/plugins/how-to-write-plugin-4.50.md --> # Jak napsat plugin pro nopCommerce Pluginy slouží k rozšíření funkčnosti nopCommerce. nopCommerce má několik typů pluginů. Například platební metody (jako PayPal), poskytovatele daní, metody výpočtu ceny dopravy (jako UPS, USP, FedEx), widgety (jako blok „live chat“) a mnoho dalších. nopCommerce je již distribuován s mnoha různými pluginy. Na [oficiálním webu nopCommerce](https://www.nopcommerce.com/marketplace) můžete také vyhledávat různé pluginy a zjistit, zda již někdo nevytvořil plugin, který vyhovuje vašim potřebám. Pokud ne, tento článek vás provede procesem vytvoření vlastního pluginu. ## Struktura pluginu, požadované soubory a umístění 1. Nejprve musíte v řešení (solution) vytvořit nový projekt typu *`Class Library`*. Je dobrým zvykem umisťovat všechny pluginy do adresáře `\Plugins` v kořeni řešení (nezaměňujte s podadresářem `\Plugins` v adresáři `\Nop.Web`, který slouží pro již nasazené pluginy). Je dobrým zvykem umisťovat všechny pluginy do složky řešení `Plugins`. Doporučený název projektu pluginu je **`Nop.Plugin.{Group}.{Name}`**. **`{Group}`** je skupina vašeho pluginu (například *Payment* nebo *Shipping*). **`{Name}`** je název vašeho pluginu (například *PayPalStandard*). Například platební plugin PayPal Standard má následující název: **`Nop.Plugin.Payments.PayPalStandard`**. Upozorňujeme však, že nejde o povinnost. Pro plugin si můžete zvolit libovolný název. Například `MyGreatPlugin`. ![p1](_static/how-to-write-plugin-4.50/write_plugin_4.50_1.jpg) 1. Jakmile je projekt pluginu vytvořen, otevřete jeho soubor `.csproj` v libovolném textovém editoru a nahraďte jeho obsah následujícím: ```xml <Project Sdk="Microsoft.NET.Sdk"> <PropertyGroup> <TargetFramework>net6.0</TargetFramework> <Copyright>SOME_COPYRIGHT</Copyright> <Company>YOUR_COMPANY</Company> <Authors>SOME_AUTHORS</Authors> <PackageLicenseUrl>PACKAGE_LICENSE_URL</PackageLicenseUrl> <PackageProjectUrl>PACKAGE_PROJECT_URL</PackageProjectUrl> <RepositoryUrl>REPOSITORY_URL</RepositoryUrl> <RepositoryType>Git</RepositoryType> <OutputPath>..\..\Presentation\Nop.Web\Plugins\PLUGIN_OUTPUT_DIRECTORY</OutputPath> <OutDir>$(OutputPath)</OutDir> <!--Set this parameter to true to get the dlls copied from the NuGet cache to the output of your project. You need to set this parameter to true if your plugin has a nuget package to ensure that the dlls copied from the NuGet cache to the output of your project--> <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies> </PropertyGroup> <ItemGroup> <ProjectReference Include="..\..\Presentation\Nop.Web.Framework\Nop.Web.Framework.csproj" /> <ClearPluginAssemblies Include="$(MSBuildProjectDirectory)\..\..\Build\ClearPluginAssemblies.proj" /> </ItemGroup> <!-- This target execute after "Build" target --> <Target Name="NopTarget" AfterTargets="Build"> <!-- Delete unnecessary libraries from plugins path --> <MSBuild Projects="@(ClearPluginAssemblies)" Properties="PluginPath=$(MSBuildProjectDirectory)\$(OutDir)" Targets="NopClear" /> </Target> </Project> ``` > [!TIP] > Kde **PLUGIN_OUTPUT_DIRECTORY** je třeba nahradit názvem pluginu, například `Payments.PayPalStandard`. > > Děláme to takto, abychom mohli využít nový způsob přidávání referencí třetích stran, který byl zaveden v .NET Core. Ve skutečnosti to však není povinné. Navíc reference z již referencovaných knihoven se načtou automaticky. Je to tedy velmi pohodlné. 1. Dalším krokem je vytvoření souboru `plugin.json`, který je vyžadován pro každý plugin. Tento soubor obsahuje metainformace popisující váš plugin. Stačí tento soubor zkopírovat z jakéhokoli jiného existujícího pluginu a upravit jej podle svých potřeb. Informace o souboru `plugin.json` najdete v části [soubor plugin.json](xref:cs/developer/plugins/plugin_json) 1. Posledním povinným krokem je vytvoření třídy, která implementuje rozhraní **`IPlugin`** (jmenný prostor `Nop.Services.Plugins`). nopCommerce obsahuje třídu **`BasePlugin`**, která již implementuje některé metody `IPlugin` a umožňuje vám vyhnout se duplikaci zdrojového kódu. nopCommerce vám také poskytuje některá specifická rozhraní odvozená od `IPlugin`. Máme například rozhraní `IPaymentMethod`, které se používá k vytváření nových pluginů platebních metod. Obsahuje některé metody specifické pouze pro platební metody, například *`ProcessPaymentAsync()`* nebo *`GetAdditionalHandlingFeeAsync()`*. V současnosti má nopCommerce následující specifická rozhraní pluginů: - **IPaymentMethod**. Tyto pluginy slouží ke zpracování plateb. - **IShippingRateComputationMethod**. Tyto pluginy slouží k získání přípustných způsobů doručení a odpovídajících cen dopravy. Například UPS, UPS, FedEx atd. - **IPickupPointProvider**. Tyto pluginy slouží k poskytování výdejních míst. - **ITaxProvider**. Poskytovatelé daní slouží k získávání daňových sazeb. - **IExchangeRateProvider**. Slouží k získávání směnného kurzu měn. - **IDiscountRequirementRule**. Umožňuje vytvářet nová pravidla slev, například „Fakturační země zákazníka musí být…“ - **IExternalAuthenticationMethod**. Slouží k vytváření metod externího ověřování, jako je Facebook, X (Twitter), OpenID atd. - **IMultiFactorAuthenticationMethod**. Slouží k vytváření metod vícefaktorového ověřování, jako je *GoogleAuthenticator* atd. >[!NOTE] > Jde o nové rozhraní; od verze 4.40 poskytujeme odpovídající infrastrukturu pro integrace MFA přímo v základu. - **IWidgetPlugin**. Umožňuje vytvářet widgety. Widgety se vykreslují v určitých částech vašeho webu. Může to být například blok „Live chat“ v levém sloupci webu. - **IMiscPlugin**. Pokud váš plugin neodpovídá žádnému z výše uvedených rozhraní. > [!IMPORTANT] > Po každém sestavení projektu vyčistěte řešení, než provedete změny. Některé prostředky se ukládají do cache a mohou vývojáře přivést k šílenství. > > Po přidání pluginu může být nutné řešení znovu sestavit. Pokud nevidíte knihovny DLL svého pluginu v `Nop.Web\Plugins\PLUGIN_OUTPUT_DIRECTORY`, musíte řešení znovu sestavit. nopCommerce nezobrazí váš plugin na stránce *Místní pluginy* (Local Plugins), pokud vaše knihovny DLL neexistují ve správné složce v `Nop.Web`. ## Zpracování požadavků. Controllery, modely a view Nyní můžete plugin zobrazit v **Administrace → Konfigurace → Místní pluginy** (Admin area → Configuration → Local Plugins). Jak ale tušíte, náš plugin nic nedělá. Nemá ani uživatelské rozhraní pro svou konfiguraci. Vytvořme tedy stránku pro konfiguraci pluginu. Nyní musíme vytvořit controller, model a view. 1. MVC controllery odpovídají na požadavky odeslané na web ASP.NET Core MVC. Každý požadavek prohlížeče je namapován na konkrétní controller. 1. View obsahuje HTML značky a obsah, který se odesílá do prohlížeče. View je při práci s aplikací `ASP.NET Core MVC` ekvivalentem stránky. 1. MVC model obsahuje veškerou logiku aplikace, která není obsažena ve view ani v controlleru. Více informací najdete o [návrhovém vzoru MVC](https://docs.microsoft.com/aspnet/core/mvc/overview?view=aspnetcore-6.0). Začněme tedy: - **Vytvořte model**. Do nového pluginu přidejte složku **Models** a poté přidejte novou třídu modelu, která odpovídá vašim potřebám. - **Vytvořte view**. Do nového pluginu přidejte složku **Views** a poté přidejte soubor `*.cshtml` s názvem `Configure.cshtml`. U souboru view nastavte vlastnost **„Build Action“** na **„Content“** a vlastnost **„Copy to Output Directory“** na **„Copy always“**. Upozorňujeme, že konfigurační stránka by měla používat layout `_ConfigurePlugin`. - Ujistěte se také, že máte v adresáři \Views soubor `_ViewImports.cshtml`. Můžete jej jednoduše zkopírovat z jakéhokoli jiného existujícího pluginu. - **Vytvořte controller**. Do nového pluginu přidejte složku **Controllers** a poté přidejte novou třídu controlleru. Je dobrým zvykem pojmenovávat controllery pluginů `{Group}{Name}Controller.cs`. Například PaymentPayPalStandardController. Pojmenovávat controllery tímto způsobem samozřejmě není povinné (jde jen o doporučení). Poté vytvořte odpovídající akční metodu pro konfigurační stránku (v administraci). Pojmenujme ji *`Configure`*. Připravte třídu modelu a předejte ji následujícímu view pomocí fyzické cesty k view: `~/Plugins/{PluginOutputDirectory}/Views/Configure.cshtml`. - U své akční metody použijte následující atributy: ```csharp [AutoValidateAntiforgeryToken] [AuthorizeAdmin] //confirms access to the admin panel [Area(AreaNames.Admin)] //specifies the area containing a controller or action ``` > [!TIP] > Tyto atributy můžete přidat také přímo ke controlleru. V takovém případě jimi nemusíte označovat každou metodu. Otevřete například platební plugin `PayPalStandard` a podívejte se na jeho implementaci `PaymentPayPalStandardController`. Poté byste pro každý plugin, který má konfigurační stránku, měli zadat konfigurační URL. Základní třída s názvem `BasePlugin` obsahuje metodu `GetConfigurationPageUrl`, která vrací konfigurační URL: ```csharp public override string GetConfigurationPageUrl() { return $"{_webHelper.GetStoreLocation()}Admin/{CONTROLLER_NAME}/{ACTION_NAME}"; } ``` Kde **{CONTROLLER_NAME}** je název vašeho controlleru a **{ACTION_NAME}** je název akce (obvykle `Configure`). Jakmile plugin nainstalujete a přidáte konfigurační metodu, najdete odkaz pro konfiguraci pluginu v **Administrace → Konfigurace → Místní pluginy** (Admin → Configuration → Local Plugins). > [!TIP] > Nejsnazší způsob, jak dokončit výše popsané kroky, je otevřít jakýkoli jiný plugin a zkopírovat tyto soubory do projektu svého pluginu. Poté stačí přejmenovat příslušné třídy a adresáře. Struktura projektu pluginu *PayPalStandard* vypadá například jako na obrázku níže: ![p3](_static/how-to-write-plugin-4.50/write_plugin_4.50_3.jpg) ## Zpracování metod „InstallAsync“, „UninstallAsync“ a „UpdateAsync“ Tento krok je volitelný. Některé pluginy mohou během instalace vyžadovat další logiku. Plugin může například vkládat nové lokalizační řetězce. Otevřete tedy svou implementaci `IPlugin` (ve většině případů bude odvozena od třídy `BasePlugin`) a přepište následující metody: 1. **InstallAsync**. Tato metoda se zavolá během instalace pluginu. Zde můžete inicializovat libovolná nastavení, vložit nové lokalizační řetězce nebo vytvořit nové databázové tabulky (je-li to potřeba). 1. **UninstallAsync**. Tato metoda se zavolá během odinstalace pluginu. 1. **UpdateAsync**. Tato metoda se zavolá během aktualizace pluginu (když se změní jeho verze v souboru `plugin.json`). > [!IMPORTANT] > Pokud některou z těchto metod přepíšete, neskrývejte její základní implementaci. Například přepsaná metoda `InstallAsync` by měla obsahovat následující volání metody: *`base.Install()`*. Metoda `InstallAsync` pluginu *PayPalStandard* vypadá jako kód níže ```csharp public override async Task InstallAsync() { await _settingService.SaveSettingAsync(new PayPalStandardPaymentSettings { UseSandbox = true }); await _localizationService.AddLocaleResourceAsync(new Dictionary<string, string> { ... }); await base.InstallAsync(); } ``` > [!TIP] > Seznam nainstalovaných pluginů se nachází v souboru `\App_Data\plugins.json`. Seznam se vytváří během instalace. ## Routy Zde se podíváme, jak registrovat routy pluginu. Routování v ASP.NET Core zajišťuje mapování příchozích požadavků prohlížeče na konkrétní akce MVC controllerů. Více informací najdete o [routování](https://docs.microsoft.com/aspnet/core/fundamentals/routing). Postupujte tedy podle následujících kroků: Pokud potřebujete přidat vlastní routu, vytvořte soubor `RouteProvider.cs`. Ten informuje systém nopCommerce o routách pluginu. Například následující třída `RouteProvider` přidává novou routu, ke které lze přistoupit otevřením webového prohlížeče a přechodem na URL `http://www.yourStore.com/Plugins/PaymentPayPalStandard/PDTHandler` (používá ji plugin *PayPal*): ```csharp public partial class RouteProvider : IRouteProvider { public void RegisterRoutes(IEndpointRouteBuilder endpointRouteBuilder) { //PDT endpointRouteBuilder.MapControllerRoute("Plugin.Payments.PayPalStandard.PDTHandler", "Plugins/PaymentPayPalStandard/PDTHandler", new { controller = "PaymentPayPalStandard", action = "PDTHandler" }); } public int Priority => -1; } ``` ## Aktualizace nopCommerce může pluginy rozbít Některé pluginy mohou zastarat a přestat fungovat s novější verzí nopCommerce. Pokud máte po aktualizaci na novější verzi problémy, plugin odstraňte a navštivte oficiální web nopCommerce, abyste zjistili, zda je k dispozici novější verze. Mnoho autorů pluginů své pluginy aktualizuje, aby vyhovovaly novější verzi, někteří to však neudělají a jejich plugin se s vylepšeními nopCommerce stane zastaralým. Ve většině případů však můžete jednoduše otevřít příslušný soubor `plugin.json` a aktualizovat pole **SupportedVersions**. ## Závěr Doufáme, že vám to pomůže začít s nopCommerce a připraví vás na vytváření propracovanějších pluginů. ## Šablona pluginu Pro nové pluginy nopCommerce můžete použít [naši šablonu pro Visual Studio](https://github.com/nopSolutions/nopCommerce-plugin-template-VS/). Vývojářům může ušetřit spoustu času, protože již nemusí ručně provádět všechny počáteční kroky, jako je vytváření složek (Controllers, Views, Models atd.), dalších požadovaných souborů (DependencyRegistrar.cs, _ViewImports.cshtml, ObjectContex, plugin.json atd.), konfigurace, referencí projektů atd. --- <!-- page: Jak napsat plugin pro nopCommerce | url: http://nopdocs.service.hedr.dev/cs/developer/plugins/how-to-write-plugin-4.40.html | source: cs/developer/plugins/how-to-write-plugin-4.40.md --> # Jak napsat plugin pro nopCommerce Pluginy slouží k rozšíření funkčnosti nopCommerce. nopCommerce má několik typů pluginů. Například platební metody (jako PayPal), poskytovatelé daní, metody výpočtu dopravy (jako UPS, USP, FedEx), widgety (jako blok „live chat“) a mnoho dalších. nopCommerce je již distribuován s mnoha různými pluginy. Na [oficiálním webu nopCommerce](https://www.nopcommerce.com/marketplace) můžete také vyhledávat různé pluginy a zjistit, zda už někdo nevytvořil plugin, který vyhovuje vašim potřebám. Pokud ne, tento článek vás provede procesem vytvoření vlastního pluginu. ## Struktura pluginu, potřebné soubory a jejich umístění 1. Jako první musíte vytvořit v řešení (solution) nový projekt typu *`Class Library`*. Osvědčeným postupem je umístit všechny pluginy do adresáře `\Plugins` v kořeni řešení (nezaměňujte s podadresářem `\Plugins` v adresáři `\Nop.Web`, který se používá pro již nasazené pluginy). Osvědčeným postupem je umístit všechny pluginy do složky řešení `Plugins`. Doporučený název projektu pluginu je **`Nop.Plugin.{Group}.{Name}`**. **`{Group}`** je skupina vašeho pluginu (například *Payment* nebo *Shipping*). **`{Name}`** je název vašeho pluginu (například *PayPalStandard*). Například platební plugin PayPal Standard má následující název: **`Nop.Plugin.Payments.PayPalStandard`**. Upozorňujeme však, že to není povinné. Pro plugin můžete zvolit libovolný název. Například `MyGreatPlugin`. ![p1](_static/how-to-write-plugin-4.40/write_plugin_4.40_1.jpg) 1. Po vytvoření projektu pluginu musíte otevřít jeho soubor `.csproj` v libovolném textovém editoru a nahradit jeho obsah následujícím: ```xml <Project Sdk="Microsoft.NET.Sdk"> <PropertyGroup> <TargetFramework>net5.0</TargetFramework> <Copyright>SOME_COPYRIGHT</Copyright> <Company>YOUR_COMPANY</Company> <Authors>SOME_AUTHORS</Authors> <PackageLicenseUrl>PACKAGE_LICENSE_URL</PackageLicenseUrl> <PackageProjectUrl>PACKAGE_PROJECT_URL</PackageProjectUrl> <RepositoryUrl>REPOSITORY_URL</RepositoryUrl> <RepositoryType>Git</RepositoryType> <OutputPath>..\..\Presentation\Nop.Web\Plugins\PLUGIN_OUTPUT_DIRECTORY</OutputPath> <OutDir>$(OutputPath)</OutDir> <!--Set this parameter to true to get the dlls copied from the NuGet cache to the output of your project. You need to set this parameter to true if your plugin has a nuget package to ensure that the dlls copied from the NuGet cache to the output of your project--> <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies> </PropertyGroup> <ItemGroup> <ProjectReference Include="..\..\Presentation\Nop.Web.Framework\Nop.Web.Framework.csproj" /> <ClearPluginAssemblies Include="$(MSBuildProjectDirectory)\..\..\Build\ClearPluginAssemblies.proj" /> </ItemGroup> <!-- This target execute after "Build" target --> <Target Name="NopTarget" AfterTargets="Build"> <!-- Delete unnecessary libraries from plugins path --> <MSBuild Projects="@(ClearPluginAssemblies)" Properties="PluginPath=$(MSBuildProjectDirectory)\$(OutDir)" Targets="NopClear" /> </Target> </Project> ``` > [!TIP] > Kde **PLUGIN_OUTPUT_DIRECTORY** je třeba nahradit názvem pluginu, například `Payments.PayPalStandard`. > > Děláme to takto, abychom mohli využít nový přístup k přidávání referencí třetích stran, který byl zaveden v .NET Core. Není to však povinné. Navíc se reference z již odkazovaných knihoven načtou automaticky. Je to tedy velmi pohodlné. 1. Dalším krokem je vytvoření souboru `plugin.json`, který je vyžadován pro každý plugin. Tento soubor obsahuje metainformace popisující váš plugin. Stačí tento soubor zkopírovat z jakéhokoli jiného existujícího pluginu a upravit jej podle svých potřeb. Informace o souboru `plugin.json` najdete v části [Soubor plugin.json](xref:cs/developer/plugins/plugin_json) 1. Posledním povinným krokem je vytvoření třídy, která implementuje rozhraní **`IPlugin`** (jmenný prostor `Nop.Services.Plugins`). nopCommerce obsahuje třídu **`BasePlugin`**, která již implementuje některé metody `IPlugin` a umožňuje vyhnout se duplikaci zdrojového kódu. nopCommerce také poskytuje některá specifická rozhraní odvozená od `IPlugin`. Například máme rozhraní `IPaymentMethod`, které se používá k vytváření nových pluginů platebních metod. Obsahuje některé metody, které jsou specifické pouze pro platební metody, například *`ProcessPayment()`* nebo *`GetAdditionalHandlingFee()`*. V současnosti má nopCommerce následující specifická rozhraní pluginů: - **IPaymentMethod**. Tyto pluginy se používají ke zpracování plateb. - **IShippingRateComputationMethod**. Tyto pluginy se používají k získání podporovaných způsobů doručení a odpovídajících cen dopravy. Například UPS, UPS, FedEx atd. - **IPickupPointProvider**. Tyto pluginy se používají k poskytování výdejních míst. - **ITaxProvider**. Poskytovatelé daní se používají k získání daňových sazeb. - **IExchangeRateProvider**. Používá se k získání směnného kurzu měny. - **IDiscountRequirementRule**. Umožňuje vytvářet nová pravidla slev, například „Fakturační země zákazníka musí být…“ - **IExternalAuthenticationMethod**. Používá se k vytváření externích metod ověřování, jako jsou Facebook, X (Twitter), OpenID atd. - **IMultiFactorAuthenticationMethod**. Používá se k vytváření metod vícefaktorového ověřování, jako je *GoogleAuthenticator* atd. >[!NOTE] > Jde o nové rozhraní; od verze 4.40 poskytujeme odpovídající infrastrukturu pro integrace MFA přímo v základu. - **IWidgetPlugin**. Umožňuje vytvářet widgety. Widgety se vykreslují v určitých částech vašeho webu. Může jít například o blok „Live chat“ v levém sloupci webu. - **IMiscPlugin**. Pokud váš plugin neodpovídá žádnému z výše uvedených rozhraní. > [!IMPORTANT] > Po každém sestavení projektu vyčistěte řešení (solution) před provedením změn. Některé prostředky budou uloženy v cache a mohou vývojáře přivést k šílenství. > > Po přidání pluginu může být nutné řešení znovu sestavit. Pokud v `Nop.Web\Plugins\PLUGIN_OUTPUT_DIRECTORY` nevidíte knihovny DLL svého pluginu, musíte řešení znovu sestavit. nopCommerce nezobrazí váš plugin na stránce *Lokální pluginy* (Local Plugins), pokud vaše knihovny DLL neexistují ve správné složce v `Nop.Web`. ## Zpracování požadavků. Controllery, modely a view Nyní můžete plugin zobrazit v **Administrace → Konfigurace → Lokální pluginy** (Admin area → Configuration → Local Plugins). Jak jste ale jistě uhodli, náš plugin nic nedělá. Nemá ani uživatelské rozhraní pro svou konfiguraci. Vytvořme tedy stránku pro konfiguraci pluginu. Nyní potřebujeme vytvořit controller, model a view. 1. MVC controllery odpovídají za reakci na požadavky odeslané na web ASP.NET Core MVC. Každý požadavek prohlížeče je namapován na konkrétní controller. 1. View obsahuje HTML značky a obsah, který se odesílá do prohlížeče. Při práci s aplikací `ASP.NET Core MVC` je view ekvivalentem stránky. 1. MVC model obsahuje veškerou logiku vaší aplikace, která není obsažena ve view ani v controlleru. Více informací najdete v článku o [vzoru MVC](https://docs.microsoft.com/aspnet/core/mvc/overview?view=aspnetcore-5.0). Pojďme tedy na to: - **Vytvořte model**. Přidejte do nového pluginu složku **Models** a poté přidejte novou třídu modelu, která vyhovuje vašim potřebám. - **Vytvořte view**. Přidejte do nového pluginu složku **Views** a poté přidejte soubor cshtml s názvem `Configure.cshtml`. Nastavte vlastnost **"Build Action"** souboru view na **"Content"** a vlastnost **"Copy to Output Directory"** na **"Copy always"**. Upozorňujeme, že konfigurační stránka by měla používat layout `_ConfigurePlugin`. - Ujistěte se také, že máte v adresáři \Views soubor `_ViewImports.cshtml`. Stačí jej zkopírovat z jakéhokoli jiného existujícího pluginu. - **Vytvořte controller**. Přidejte do nového pluginu složku **Controllers** a poté přidejte novou třídu controlleru. Osvědčeným postupem je pojmenovávat controllery pluginů `{Group}{Name}Controller.cs`. Například PaymentPayPalStandardController. Pojmenovávat controllery tímto způsobem samozřejmě není povinné (jde pouze o doporučení). Poté vytvořte příslušnou akční metodu pro konfigurační stránku (v administraci). Pojmenujme ji *`Configure`*. Připravte třídu modelu a předejte ji následujícímu view pomocí fyzické cesty k view: `~/Plugins/{PluginOutputDirectory}/Views/Configure.cshtml`. - Pro svou akční metodu použijte následující atributy: ```csharp [AutoValidateAntiforgeryToken] [AuthorizeAdmin] //confirms access to the admin panel [Area(AreaNames.Admin)] //specifies the area containing a controller or action ``` > [!TIP] > Tyto atributy můžete přidat také přímo ke controlleru. V takovém případě není nutné jimi označovat každou metodu. Otevřete například platební plugin `PayPalStandard` a podívejte se na jeho implementaci `PaymentPayPalStandardController`. Poté byste pro každý plugin, který má konfigurační stránku, měli určit konfigurační URL. Základní třída `BasePlugin` má metodu `GetConfigurationPageUrl`, která vrací konfigurační URL: ```csharp public override string GetConfigurationPageUrl() { return $"{_webHelper.GetStoreLocation()}Admin/{CONTROLLER_NAME}/{ACTION_NAME}"; } ``` Kde **{CONTROLLER_NAME}** je název vašeho controlleru a **{ACTION_NAME}** je název akce (obvykle `Configure`). Jakmile plugin nainstalujete a přidáte konfigurační metodu, najdete odkaz na konfiguraci pluginu v **Administrace → Konfigurace → Lokální pluginy** (Admin → Configuration → Local Plugins). > [!TIP] > Nejjednodušší způsob, jak výše popsané kroky provést, je otevřít jakýkoli jiný plugin a zkopírovat tyto soubory do projektu svého pluginu. Poté stačí přejmenovat příslušné třídy a adresáře. Například struktura projektu pluginu *PayPalStandard* vypadá jako na obrázku níže: ![p3](_static/how-to-write-plugin-4.40/write_plugin_4.40_3.jpg) ## Zpracování metod "InstallAsync", "UninstallAsync" a "UpdateAsync" Tento krok je volitelný. Některé pluginy mohou během instalace vyžadovat dodatečnou logiku. Plugin může například vložit nové lokalizační prostředky. Otevřete tedy svou implementaci `IPlugin` (ve většině případů bude odvozena od třídy `BasePlugin`) a přepište následující metody: 1. **InstallAsync**. Tato metoda se zavolá během instalace pluginu. Zde můžete inicializovat jakákoli nastavení, vložit nové lokalizační prostředky nebo vytvořit nové databázové tabulky (pokud je to potřeba). 1. **UninstallAsync**. Tato metoda se zavolá během odinstalace pluginu. 1. **UpdateAsync**. Tato metoda se zavolá během aktualizace pluginu (když se změní jeho verze v souboru `plugin.json`). > [!IMPORTANT] > Pokud některou z těchto metod přepíšete, nezakrývejte její základní implementaci. Například přepsaná metoda `InstallAsync` by měla obsahovat následující volání metody: *`base.Install()`*. Metoda `InstallAsync` pluginu *PayPalStandard* vypadá jako kód níže ```csharp public override async Task InstallAsync() { await _settingService.SaveSettingAsync(new PayPalStandardPaymentSettings { UseSandbox = true }); await _localizationService.AddLocaleResourceAsync(new Dictionary<string, string> { ... }); await base.InstallAsync(); } ``` > [!TIP] > Seznam nainstalovaných pluginů se nachází v `\App_Data\plugins.json`. Seznam se vytváří během instalace. ## Cesty (routes) Zde se podíváme, jak registrovat cesty (routes) pluginu. Routing v ASP.NET Core odpovídá za mapování příchozích požadavků prohlížeče na konkrétní akce MVC controllerů. Více informací najdete v článku o [routingu](https://docs.microsoft.com/aspnet/core/fundamentals/routing). Postupujte tedy podle následujících kroků: Pokud potřebujete přidat vlastní cestu, vytvořte soubor `RouteProvider.cs`. Ten informuje systém nopCommerce o cestách pluginu. Například následující třída `RouteProvider` přidává novou cestu, ke které lze přistoupit otevřením webového prohlížeče a přechodem na URL `http://www.yourStore.com/Plugins/PaymentPayPalStandard/PDTHandler` (používá ji plugin *PayPal*): ```csharp public partial class RouteProvider : IRouteProvider { public void RegisterRoutes(IEndpointRouteBuilder endpointRouteBuilder) { //PDT endpointRouteBuilder.MapControllerRoute("Plugin.Payments.PayPalStandard.PDTHandler", "Plugins/PaymentPayPalStandard/PDTHandler", new { controller = "PaymentPayPalStandard", action = "PDTHandler" }); } public int Priority => -1; } ``` ## Aktualizace nopCommerce může pluginy rozbít Některé pluginy mohou zastarat a přestat fungovat s novější verzí nopCommerce. Pokud máte po aktualizaci na novější verzi problémy, plugin smažte a navštivte oficiální web nopCommerce, abyste zjistili, zda je k dispozici novější verze. Mnoho autorů pluginů své pluginy aktualizuje, aby vyhovovaly novější verzi, někteří to však neudělají a jejich pluginy se s vylepšeními nopCommerce stanou zastaralými. Ve většině případů však stačí otevřít příslušný soubor `plugin.json` a aktualizovat pole **SupportedVersions**. ## Závěr Doufáme, že vám to pomůže začít s nopCommerce a připraví vás na tvorbu propracovanějších pluginů. ## Šablona pluginu Pro nové pluginy nopCommerce můžete použít [naši šablonu pro Visual Studio](https://github.com/nopSolutions/nopCommerce-plugin-template-VS/). Vývojářům může ušetřit spoustu času, protože již nemusí ručně provádět všechny úvodní kroky. Například vytváření složek (Controllers, Views, Models atd.), dalších potřebných souborů (DependencyRegistrar.cs, _ViewImports.cshtml, ObjectContex, plugin.json atd.), konfigurace, reference projektu atd.). --- <!-- page: Jak napsat plugin pro nopCommerce | url: http://nopdocs.service.hedr.dev/cs/developer/plugins/how-to-write-plugin-4.30.html | source: cs/developer/plugins/how-to-write-plugin-4.30.md --> # Jak napsat plugin pro nopCommerce Pluginy slouží k rozšíření funkčnosti nopCommerce. nopCommerce má několik typů pluginů. Například platební metody (jako PayPal), poskytovatele daní, metody výpočtu dopravy (jako UPS, USP, FedEx), widgety (jako blok „live chat“) a mnoho dalších. nopCommerce je již distribuován s mnoha různými pluginy. Na [oficiálním webu nopCommerce](https://www.nopcommerce.com/marketplace) můžete také vyhledávat různé pluginy a zjistit, zda už někdo nevytvořil plugin, který vyhovuje vašim potřebám. Pokud ne, tento článek vás provede procesem vytvoření vlastního pluginu. ## Struktura pluginu, požadované soubory a umístění 1. Nejprve je potřeba v solution vytvořit nový projekt typu „Class Library“. Je dobrým zvykem umístit všechny pluginy do adresáře `\Plugins` v kořeni solution (nezaměňujte s podadresářem \Plugins umístěným v adresáři `\Nop.Web`, který se používá pro již nasazené pluginy). Je dobrým zvykem umístit všechny pluginy do složky solution „Plugins“. Doporučený název projektu pluginu je „Nop.Plugin.{Group}.{Name}“. {Group} je skupina vašeho pluginu (například „Payment“ nebo „Shipping“). {Name} je název vašeho pluginu (například „PayPalStandard“). Například platební plugin PayPal Standard má následující název: Nop.Plugin.Payments.PayPalStandard. Upozorňujeme však, že to není podmínkou. Pro plugin můžete zvolit libovolný název. Například „MyGreatPlugin“. ![p1](_static/how-to-write-plugin-4.30/write_plugin_4.30_1.jpg) 1. Po vytvoření projektu pluginu musíte otevřít jeho soubor `.csproj` v libovolném textovém editoru a nahradit jeho obsah následujícím: ```xml <Project Sdk="Microsoft.NET.Sdk"> <PropertyGroup> <TargetFramework>netcoreapp3.1</TargetFramework> <Copyright>SOME_COPYRIGHT</Copyright> <Company>YOUR_COMPANY</Company> <Authors>SOME_AUTHORS</Authors> <PackageLicenseUrl>PACKAGE_LICENSE_URL</PackageLicenseUrl> <PackageProjectUrl>PACKAGE_PROJECT_URL</PackageProjectUrl> <RepositoryUrl>REPOSITORY_URL</RepositoryUrl> <RepositoryType>Git</RepositoryType> <OutputPath>..\..\Presentation\Nop.Web\Plugins\PLUGIN_OUTPUT_DIRECTORY</OutputPath> <OutDir>$(OutputPath)</OutDir> <!--Set this parameter to true to get the dlls copied from the NuGet cache to the output of your project. You need to set this parameter to true if your plugin has a nuget package to ensure that the dlls copied from the NuGet cache to the output of your project--> <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies> </PropertyGroup> <ItemGroup> <ProjectReference Include="..\..\Presentation\Nop.Web.Framework\Nop.Web.Framework.csproj" /> <ClearPluginAssemblies Include="$(MSBuildProjectDirectory)\..\..\Build\ClearPluginAssemblies.proj" /> </ItemGroup> <!-- This target execute after "Build" target --> <Target Name="NopTarget" AfterTargets="Build"> <!-- Delete unnecessary libraries from plugins path --> <MSBuild Projects="@(ClearPluginAssemblies)" Properties="PluginPath=$(MSBuildProjectDirectory)\$(OutDir)" Targets="NopClear" /> </Target> </Project> ``` > [!TIP] > PLUGIN_OUTPUT_DIRECTORY nahraďte názvem pluginu, například Payments.PayPalStandard. > > Děláme to takto, abychom mohli využít nový způsob přidávání referencí třetích stran, který byl zaveden v .NET Core. Není to však povinné. Navíc se reference z již odkazovaných knihoven načtou automaticky. Je to tedy velmi pohodlné. 1. Dalším krokem je vytvoření souboru `plugin.json`, který je vyžadován pro každý plugin. Tento soubor obsahuje metainformace popisující váš plugin. Stačí tento soubor zkopírovat z jakéhokoli jiného existujícího pluginu a upravit jej podle svých potřeb. Informace o souboru `plugin.json` naleznete v části [Soubor plugin.json](xref:cs/developer/plugins/plugin_json) 1. Posledním povinným krokem je vytvoření třídy, která implementuje rozhraní **IPlugin** (jmenný prostor Nop.Services.Plugins). nopCommerce má třídu **BasePlugin**, která již implementuje některé metody IPlugin a umožňuje vám vyhnout se duplikaci zdrojového kódu. nopCommerce vám také poskytuje některá specifická rozhraní odvozená od IPlugin. Máme například rozhraní „IPaymentMethod“, které se používá pro vytváření nových pluginů platebních metod. Obsahuje některé metody specifické pouze pro platební metody, například *ProcessPayment()* nebo *GetAdditionalHandlingFee()*. V současné době má nopCommerce následující specifická rozhraní pluginů: - **IPaymentMethod**. Tyto pluginy se používají ke zpracování plateb. - **IShippingRateComputationMethod**. Tyto pluginy se používají k získání podporovaných způsobů doručení a odpovídajících sazeb za dopravu. Například UPS, UPS, FedEx apod. - **IPickupPointProvider**. Tyto pluginy se používají k poskytování výdejních míst. - **ITaxProvider**. Poskytovatelé daní se používají k získání daňových sazeb. - **IExchangeRateProvider**. Používá se k získání směnného kurzu měny. - **IDiscountRequirementRule**. Umožňuje vytvářet nová pravidla slev, například „Fakturační země zákazníka musí být…“ - **IExternalAuthenticationMethod**. Používá se k vytváření externích metod ověřování, jako jsou Facebook, X (Twitter), OpenID apod. - **IWidgetPlugin**. Umožňuje vytvářet widgety. Widgety se vykreslují v určitých částech vašeho webu. Může to být například blok „Live chat“ v levém sloupci webu. - **IMiscPlugin**. Pokud váš plugin neodpovídá žádnému z výše uvedených rozhraní. > [!IMPORTANT] > Důležitá poznámka: Po každém sestavení projektu vyčistěte solution, než provedete změny. Některé prostředky se ukládají do mezipaměti a mohou vývojáře přivést k šílenství. > > Po přidání pluginu může být nutné solution znovu sestavit. Pokud ve složce Nop.Web\Plugins\PLUGIN_OUTPUT_DIRECTORY nevidíte DLL svého pluginu, musíte solution znovu sestavit. nopCommerce nezobrazí váš plugin na stránce Místní pluginy (Local Plugins), pokud vaše DLL neexistují ve správné složce v Nop.Web. ## Zpracování požadavků. Controllery, modely a view Nyní můžete plugin zobrazit, když přejdete do **Administrace → Konfigurace → Místní pluginy** (Admin area → Configuration → Local Plugins). Jak jste ale jistě uhodli, náš plugin nic nedělá. Nemá dokonce ani uživatelské rozhraní pro svou konfiguraci. Vytvořme tedy stránku pro konfiguraci pluginu. Nyní potřebujeme vytvořit controller, model a view. 1. MVC controllery jsou zodpovědné za odpovídání na požadavky zaslané webu ASP.NET MVC. Každý požadavek prohlížeče je namapován na konkrétní controller. 1. View obsahuje HTML značky a obsah, který se odesílá do prohlížeče. Při práci s aplikací ASP.NET MVC je view ekvivalentem stránky. 1. MVC model obsahuje veškerou logiku aplikace, která není obsažena ve view ani v controlleru. Více informací naleznete o [vzoru MVC](https://docs.microsoft.com/aspnet/core/mvc/overview?view=aspnetcore-3.1). Pojďme tedy začít: - **Vytvořte model**. Do nového pluginu přidejte složku **Models** a poté přidejte novou třídu modelu, která vyhovuje vašim potřebám. - **Vytvořte view**. Do nového pluginu přidejte složku **Views** a poté přidejte soubor cshtml s názvem `Configure.cshtml`. Nastavte vlastnost **„Build Action“** souboru view na **„Content“** a vlastnost **„Copy to Output Directory“** na **„Copy always“**. Upozorňujeme, že konfigurační stránka by měla používat layout „_ConfigurePlugin“. - Ujistěte se také, že máte v adresáři \Views soubor `_ViewImports.cshtml`. Můžete jej jednoduše zkopírovat z jakéhokoli jiného existujícího pluginu. - **Vytvořte controller**. Do nového pluginu přidejte složku **Controllers** a poté přidejte novou třídu controlleru. Je dobrým zvykem pojmenovávat controllery pluginů `{Group}{Name}Controller.cs`. Například PaymentPayPalStandardController. Takové pojmenování controllerů samozřejmě není povinné (jde jen o doporučení). Poté vytvořte odpovídající metodu akce pro konfigurační stránku (v administraci). Pojmenujme ji *„Configure“*. Připravte třídu modelu a předejte ji následujícímu view pomocí fyzické cesty k view: `~/Plugins/{PluginOutputDirectory}/Views/Configure.cshtml`. - Pro metodu akce použijte následující atributy: ```csharp [AuthorizeAdmin] //confirms access to the admin panel [Area(AreaNames.Admin)] //specifies the area containing a controller or action ``` Otevřete například platební plugin PayPalStandard a podívejte se na jeho implementaci PaymentPayPalStandardController. Poté byste pro každý plugin, který má konfigurační stránku, měli zadat konfigurační URL. Základní třída s názvem `BasePlugin` má metodu `GetConfigurationPageUrl`, která vrací konfigurační URL: ```csharp public override string GetConfigurationPageUrl() { return $"{_webHelper.GetStoreLocation()}Admin/{CONTROLLER_NAME}/{ACTION_NAME}"; } ``` Kde *{CONTROLLER_NAME}* je název vašeho controlleru a *{ACTION_NAME}* je název akce (obvykle „Configure“). Jakmile plugin nainstalujete a přidáte konfigurační metodu, najdete odkaz pro konfiguraci pluginu v **Administrace → Konfigurace → Místní pluginy** (Admin → Configuration → Local Plugins). > [!TIP] > Nejjednodušší způsob, jak provést výše popsané kroky, je otevřít jakýkoli jiný plugin a zkopírovat tyto soubory do projektu svého pluginu. Pak už jen stačí přejmenovat příslušné třídy a adresáře. Struktura projektu pluginu PayPalStandard vypadá například jako na obrázku níže: ![p3](_static/how-to-write-plugin-4.30/write_plugin_4.30_3.jpg) ## Zpracování metod „Install“, „Uninstall“ a „Update“ Tento krok je volitelný. Některé pluginy mohou během instalace vyžadovat dodatečnou logiku. Plugin může například vložit nové lokalizační prostředky. Otevřete tedy svou implementaci IPlugin (ve většině případů bude odvozena od třídy BasePlugin) a přepište následující metody: 1. **Install**. Tato metoda bude vyvolána během instalace pluginu. Zde můžete inicializovat libovolná nastavení, vložit nové lokalizační prostředky nebo vytvořit nové databázové tabulky (pokud je to potřeba). 1. **Uninstall**. Tato metoda bude vyvolána během odinstalace pluginu. 1. **Update**. Tato metoda bude vyvolána během aktualizace pluginu (když se změní jeho verze v souboru `plugin.json`). > [!IMPORTANT] > Důležitá poznámka: Pokud přepíšete některou z těchto metod, neskrývejte její základní implementaci. Například přepsaná metoda „Install“ by měla obsahovat následující volání metody: *base.Install()*. Metoda „Install“ pluginu PayPalStandard vypadá jako kód níže ```csharp public override void Install() { var settings = new PayPalStandardPaymentSettings() { UseSandbox = true }; _settingService.SaveSetting(settings); ... base.Install(); } ``` > [!TIP] > Seznam nainstalovaných pluginů se nachází v `\App_Data\plugins.json`. Seznam se vytváří během instalace. ## Routy Nyní se podíváme, jak registrovat routy pluginu. Routing v ASP.NET Core je zodpovědný za mapování příchozích požadavků prohlížeče na konkrétní akce MVC controllerů. Více informací naleznete o [routingu](https://docs.microsoft.com/aspnet/core/fundamentals/routing). Postupujte tedy podle následujících kroků: Pokud potřebujete přidat vlastní routu, vytvořte soubor `RouteProvider.cs`. Ten informuje systém nopCommerce o routách pluginu. Například následující třída RouteProvider přidává novou routu, ke které lze přistoupit otevřením webového prohlížeče a přechodem na URL `http://www.yourStore.com/Plugins/PaymentPayPalStandard/PDTHandler` (používá ji plugin PayPal): ```csharp public partial class RouteProvider : IRouteProvider { public void RegisterRoutes(IEndpointRouteBuilder endpointRouteBuilder) { //PDT endpointRouteBuilder.MapControllerRoute("Plugin.Payments.PayPalStandard.PDTHandler", "Plugins/PaymentPayPalStandard/PDTHandler", new { controller = "PaymentPayPalStandard", action = "PDTHandler" }); } public int Priority => -1; } ``` ## Aktualizace nopCommerce může pluginy rozbít Některé pluginy mohou zastarat a přestat fungovat s novější verzí nopCommerce. Pokud máte po aktualizaci na novější verzi problémy, plugin odstraňte a navštivte oficiální web nopCommerce, abyste zjistili, zda je k dispozici novější verze. Mnoho autorů pluginů své pluginy aktualizuje, aby odpovídaly novější verzi, někteří to však neudělají a jejich plugin se s vylepšeními nopCommerce stane zastaralým. Ve většině případů však stačí otevřít příslušný soubor `plugin.json` a aktualizovat pole **SupportedVersions**. ## Závěr Doufáme, že vám to pomůže začít s nopCommerce a připraví vás na tvorbu propracovanějších pluginů. ## Šablona pluginu Pro nové pluginy nopCommerce můžete použít [naši šablonu pro Visual Studio](https://github.com/nopSolutions/nopCommerce-plugin-template-VS/). Vývojářům může ušetřit spoustu času, protože již nemusí ručně provádět všechny úvodní kroky. Například vytváření složek (Controllers, Views, Models atd.), dalších požadovaných souborů (DependencyRegistrar.cs, _ViewImports.cshtml, ObjectContex, plugin.json atd.), konfiguraci, reference projektů atd. --- <!-- page: Jak napsat plugin pro nopCommerce | url: http://nopdocs.service.hedr.dev/cs/developer/plugins/how-to-write-plugin-4.20.html | source: cs/developer/plugins/how-to-write-plugin-4.20.md --> # Jak napsat plugin pro nopCommerce 4.20 Pluginy se používají k rozšíření funkcionality nopCommerce. nopCommerce má několik typů pluginů. Například platební metody (jako PayPal), poskytovatele daní, metody výpočtu dopravy (jako UPS, USP, FedEx), widgety (jako blok „živého chatu“) a mnoho dalších. nopCommerce je již distribuován s mnoha různými pluginy. Na [oficiálním webu nopCommerce](https://www.nopcommerce.com/marketplace) můžete také vyhledávat různé pluginy a zjistit, zda už někdo nevytvořil plugin, který vyhovuje vašim potřebám. Pokud ne, tento článek vás provede procesem vytvoření vlastního pluginu. ## Struktura pluginu, požadované soubory a umístění 1. Nejprve je potřeba v solution vytvořit nový projekt typu „Class Library“. Dobrou praxí je umístit všechny pluginy do adresáře `\Plugins` v kořeni vaší solution (nezaměňujte s podadresářem \Plugins v adresáři `\Nop.Web`, který se používá pro již nasazené pluginy). Dobrou praxí je také umístit všechny pluginy do složky solution „Plugins“ (více informací o [složkách solution](http://msdn.microsoft.com/library/sx2027y2.aspx) naleznete v dokumentaci). Doporučený název projektu pluginu je „Nop.Plugin.{Group}.{Name}“. {Group} je skupina vašeho pluginu (například „Payment“ nebo „Shipping“). {Name} je název vašeho pluginu (například „PayPalStandard“). Například platební plugin PayPal Standard má následující název: Nop.Plugin.Payments.PayPalStandard. Upozorňujeme však, že nejde o povinnost. Pro plugin si můžete zvolit libovolný název. Například „MyGreatPlugin“. ![p1](_static/how-to-write-plugin-4.20/write_plugin_4.20_1.jpg) 1. Jakmile je projekt pluginu vytvořen, otevřete jeho soubor `.csproj` v libovolném textovém editoru a nahraďte jeho obsah následujícím: ```xml <Project Sdk="Microsoft.NET.Sdk"> <PropertyGroup> <TargetFramework>netcoreapp2.2</TargetFramework> <Copyright>SOME_COPYRIGHT</Copyright> <Company>YOUR_COMPANY</Company> <Authors>SOME_AUTHORS</Authors> <PackageLicenseUrl>PACKAGE_LICENSE_URL</PackageLicenseUrl> <PackageProjectUrl>PACKAGE_PROJECT_URL</PackageProjectUrl> <RepositoryUrl>REPOSITORY_URL</RepositoryUrl> <RepositoryType>Git</RepositoryType> <OutputPath>..\..\Presentation\Nop.Web\Plugins\PLUGIN_OUTPUT_DIRECTORY</OutputPath> <OutDir>$(OutputPath)</OutDir> <!--Set this parameter to true to get the dlls copied from the NuGet cache to the output of your project. You need to set this parameter to true if your plugin has a nuget package to ensure that the dlls copied from the NuGet cache to the output of your project--> <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies> </PropertyGroup> <ItemGroup> <ProjectReference Include="..\..\Presentation\Nop.Web.Framework\Nop.Web.Framework.csproj" /> <ClearPluginAssemblies Include="$(MSBuildProjectDirectory)\..\..\Build\ClearPluginAssemblies.proj" /> </ItemGroup> <!-- This target execute after "Build" target --> <Target Name="NopTarget" AfterTargets="Build"> <!-- Delete unnecessary libraries from plugins path --> <MSBuild Projects="@(ClearPluginAssemblies)" Properties="PluginPath=$(MSBuildProjectDirectory)\$(OutDir)" Targets="NopClear" /> </Target> </Project> ``` > [!TIP] > Kde PLUGIN_OUTPUT_DIRECTORY je třeba nahradit názvem pluginu, například Payments.PayPalStandard. > > Děláme to takto, abychom mohli využít nový přístup k přidávání referencí třetích stran, který byl zaveden v .NET Core. Není to ale nutné. Navíc se reference z již odkazovaných knihoven načtou automaticky. Je to tedy velmi pohodlné. 1. Dalším krokem je vytvoření souboru `plugin.json`, který je vyžadován pro každý plugin. Tento soubor obsahuje metainformace popisující váš plugin. Stačí tento soubor zkopírovat z jakéhokoli jiného existujícího pluginu a upravit jej podle svých potřeb. Informace o souboru `plugin.json` naleznete v článku [Soubor plugin.json](xref:cs/developer/plugins/plugin_json) 1. Posledním povinným krokem je vytvoření třídy, která implementuje rozhraní **IPlugin** (jmenný prostor Nop.Services.Plugins). nopCommerce obsahuje třídu **BasePlugin**, která již implementuje některé metody IPlugin a umožňuje vyhnout se duplikaci zdrojového kódu. nopCommerce vám také poskytuje některá specifická rozhraní odvozená od IPlugin. Máme například rozhraní „IPaymentMethod“, které se používá k vytváření nových pluginů platebních metod. Obsahuje některé metody, které jsou specifické pouze pro platební metody, například *ProcessPayment()* nebo *GetAdditionalHandlingFee()*. V současné době má nopCommerce následující specifická rozhraní pluginů: - **IPaymentMethod**. Tyto pluginy slouží ke zpracování plateb. - **IShippingRateComputationMethod**. Tyto pluginy slouží k získání akceptovaných způsobů doručení a odpovídajících sazeb za dopravu. Například UPS, UPS, FedEx atd. - **IPickupPointProvider**. Tyto pluginy slouží k poskytování výdejních míst. - **ITaxProvider**. Poskytovatelé daní slouží k získání daňových sazeb. - **IExchangeRateProvider**. Slouží k získání směnného kurzu měny. - **IDiscountRequirementRule**. Umožňuje vytvářet nová pravidla slev, například „Fakturační země zákazníka by měla být…“ - **IExternalAuthenticationMethod**. Slouží k vytváření externích metod ověřování, jako jsou Facebook, X (Twitter), OpenID atd. - **IWidgetPlugin**. Umožňuje vytvářet widgety. Widgety se vykreslují v určitých částech vašeho webu. Může to být například blok „Živý chat“ v levém sloupci vašeho webu. - **IMiscPlugin**. Pokud váš plugin neodpovídá žádnému z výše uvedených rozhraní. > [!IMPORTANT] > Po každém sestavení projektu vyčistěte solution, než začnete provádět změny. Některé zdroje budou uloženy v cache, což může vývojáře přivést k šílenství. > > Po přidání pluginu může být nutné solution znovu sestavit (rebuild). Pokud v Nop.Web\Plugins\PLUGIN_OUTPUT_DIRECTORY nevidíte DLL knihovny svého pluginu, musíte solution znovu sestavit. nopCommerce nezobrazí váš plugin na stránce Lokální pluginy (Local Plugins), pokud vaše DLL knihovny neexistují ve správné složce v Nop.Web. ## Zpracování požadavků. Controllery, modely a view Nyní můžete plugin vidět v **Administrace → Konfigurace → Lokální pluginy** (Admin area → Configuration → Local Plugins). Jak jste ale jistě uhodli, náš plugin nic nedělá. Nemá ani uživatelské rozhraní pro svou konfiguraci. Vytvořme stránku pro konfiguraci pluginu. Nyní potřebujeme vytvořit controller, model a view. 1. MVC controllery odpovídají na požadavky vůči webu ASP.NET MVC. Každý požadavek prohlížeče je namapován na konkrétní controller. 1. View obsahuje HTML značky a obsah, který se odesílá do prohlížeče. View je při práci s aplikací ASP.NET MVC ekvivalentem stránky. 1. MVC model obsahuje veškerou logiku aplikace, která není obsažena ve view ani v controlleru. Více informací naleznete o [vzoru MVC](http://www.asp.net/mvc/tutorials/older-versions/overview/understanding-models-views-and-controllers-cs). Pojďme tedy začít: - **Vytvořte model**. Do nového pluginu přidejte složku **Models** a poté přidejte novou třídu modelu, která vyhovuje vašim potřebám. - **Vytvořte view**. Do nového pluginu přidejte složku **Views** a poté přidejte soubor cshtml s názvem `Configure.cshtml`. U souboru view nastavte vlastnost **„Build Action“** na **„Content“** a vlastnost **„Copy to Output Directory“** na **„Copy always“**. Upozorňujeme, že konfigurační stránka by měla používat layout „_ConfigurePlugin“. - Ujistěte se také, že máte ve svém adresáři \Views soubor `_ViewImports.cshtml`. Můžete jej jednoduše zkopírovat z jakéhokoli jiného existujícího pluginu. - **Vytvořte controller**. Do nového pluginu přidejte složku **Controllers** a poté přidejte novou třídu controlleru. Dobrou praxí je pojmenovávat controllery pluginů `{Group}{Name}Controller.cs`. Například PaymentPayPalStandardController. Takové pojmenování controllerů samozřejmě není povinné (jde jen o doporučení). Poté vytvořte odpovídající akční metodu pro konfigurační stránku (v administraci). Pojmenujme ji *„Configure“*. Připravte třídu modelu a předejte ji následujícímu view pomocí fyzické cesty k view: `~/Plugins/{PluginOutputDirectory}/Views/Configure.cshtml`. - Pro svou akční metodu použijte následující atributy: ```csharp [AuthorizeAdmin] //confirms access to the admin panel [Area(AreaNames.Admin)] //specifies the area containing a controller or action ``` Otevřete například platební plugin PayPalStandard a podívejte se na jeho implementaci PaymentPayPalStandardController. Poté byste pro každý plugin, který má konfigurační stránku, měli zadat konfigurační URL. Základní třída `BasePlugin` má metodu `GetConfigurationPageUrl`, která vrací konfigurační URL: ```csharp public override string GetConfigurationPageUrl() { return $"{_webHelper.GetStoreLocation()}Admin/{CONTROLLER_NAME}/{ACTION_NAME}"; } ``` Kde *{CONTROLLER_NAME}* je název vašeho controlleru a *{ACTION_NAME}* je název akce (obvykle „Configure“). Jakmile plugin nainstalujete a přidáte konfigurační metodu, najdete odkaz na konfiguraci pluginu v **Administrace → Konfigurace → Lokální pluginy** (Admin → Configuration → Local Plugins). > [!TIP] > Nejjednodušší způsob, jak provést výše popsané kroky, je otevřít jakýkoli jiný plugin a zkopírovat tyto soubory do projektu svého pluginu. Poté stačí přejmenovat příslušné třídy a adresáře. Například struktura projektu pluginu PayPalStandard vypadá jako na obrázku níže: ![p3](_static/how-to-write-plugin-4.20/write_plugin_4.20_3.jpg) ## Obsluha metod „Install“ a „Uninstall“ Tento krok je volitelný. Některé pluginy mohou během instalace vyžadovat dodatečnou logiku. Plugin může například vložit nové lokalizační zdroje. Otevřete tedy svou implementaci IPlugin (ve většině případů bude odvozena od třídy BasePlugin) a přepište následující metody: 1. **Install**. Tato metoda bude volána během instalace pluginu. Zde můžete inicializovat libovolná nastavení, vložit nové lokalizační zdroje nebo vytvořit nové databázové tabulky (pokud je to potřeba). 1. **Uninstall**. Tato metoda bude volána během odinstalace pluginu. > [!IMPORTANT] > Pokud některou z těchto metod přepíšete, neskrývejte její základní implementaci. Například přepsaná metoda „Install“ by měla obsahovat následující volání metody: *base.Install()*. Metoda „Install“ pluginu PayPalStandard vypadá jako kód níže ```csharp public override void Install() { var settings = new PayPalStandardPaymentSettings() { UseSandbox = true }; _settingService.SaveSetting(settings); ... base.Install(); } ``` > [!TIP] > Seznam nainstalovaných pluginů se nachází v `\App_Data\Plugins.json`. Seznam se vytváří během instalace. ## Routy Zde se podíváme, jak registrovat routy pluginu. Směrování (routing) v ASP.NET Core je zodpovědné za mapování příchozích požadavků prohlížeče na konkrétní akce MVC controllerů. Více informací o [směrování](https://docs.microsoft.com/aspnet/core/fundamentals/routing) naleznete v dokumentaci. Postupujte tedy podle následujících kroků: 1. Pokud potřebujete přidat vlastní routu, vytvořte soubor `RouteProvider.cs`. Ten informuje systém nopCommerce o routách pluginu. Například následující třída RouteProvider přidává novou routu, ke které lze přistoupit otevřením webového prohlížeče a přechodem na URL `http://www.yourStore.com/Plugins/PaymentPayPalStandard/PDTHandler` (používá ji plugin PayPal): ```csharp public partial class RouteProvider : IRouteProvider { public void RegisterRoutes(IRouteBuilder routeBuilder) { routeBuilder.MapRoute("Plugin.Payments.PayPalStandard.PDTHandler", "Plugins/PaymentPayPalStandard/PDTHandler", new { controller = "PaymentPayPalStandard", action = "PDTHandler" }); } public int Priority => -1; } ``` ## Aktualizace nopCommerce může pluginy rozbít Některé pluginy mohou zastarat a přestat fungovat s novější verzí nopCommerce. Pokud po aktualizaci na novější verzi narazíte na problémy, plugin odstraňte a navštivte oficiální web nopCommerce, abyste zjistili, zda je k dispozici novější verze. Mnoho autorů pluginů své pluginy aktualizuje pro novější verzi, někteří to však neudělají a jejich plugin se s vylepšeními v nopCommerce stane zastaralým. Ve většině případů ale stačí otevřít příslušný soubor `plugin.json` a aktualizovat pole **SupportedVersions**. ## Závěr Doufáme, že vám to pomůže začít s nopCommerce a připraví vás na tvorbu propracovanějších pluginů. ## Šablona pluginu Pro nové pluginy nopCommerce můžete použít [naši šablonu pro Visual Studio](https://github.com/nopSolutions/nopCommerce-plugin-template-VS/). Vývojářům může ušetřit spoustu času. Už totiž nemusí ručně provádět všechny počáteční kroky. Například vytváření složek (Controllers, Views, Models atd.), dalších požadovaných souborů (DependencyRegistrar.cs, _ViewImports.cshtml, ObjectContex, plugin.json atd.), konfiguraci, reference projektů atd.). --- <!-- page: Jak napsat plugin pro nopCommerce | url: http://nopdocs.service.hedr.dev/cs/developer/plugins/how-to-write-plugin-4.10.html | source: cs/developer/plugins/how-to-write-plugin-4.10.md --> # Jak napsat plugin pro nopCommerce 4.10 > V informatice je plug-in (neboli plugin) sada softwarových komponent, které přidávají specifické schopnosti větší softwarové aplikaci (Wikipedie). Pluginy slouží k rozšíření funkčnosti nopCommerce. nopCommerce má několik typů pluginů. Například platební metody (jako PayPal), poskytovatele daní, metody výpočtu dopravy (jako UPS, USP, FedEx), widgety (jako blok „live chat“) a mnoho dalších. nopCommerce je již distribuován s mnoha různými pluginy. Na [oficiálním webu nopCommerce](https://www.nopcommerce.com/marketplace) můžete také vyhledávat různé pluginy a zjistit, zda už někdo nevytvořil plugin, který vyhovuje vašim potřebám. Pokud ne, tento článek vás provede procesem vytvoření vlastního pluginu. ## Struktura pluginu, požadované soubory a umístění 1. Nejprve je třeba v řešení (solution) vytvořit nový projekt typu „Class Library“. Je dobrým zvykem umístit všechny pluginy do adresáře `\Plugins` v kořeni řešení (nezaměňujte s podadresářem \Plugins v adresáři `\Nop.Web`, který se používá pro již nasazené pluginy). Je dobrým zvykem umístit všechny pluginy do složky řešení „Plugins“ (více informací o [složkách řešení](http://msdn.microsoft.com/library/sx2027y2.aspx)). Doporučený název projektu pluginu je „Nop.Plugin.{Group}.{Name}“. {Group} je skupina vašeho pluginu (například „Payment“ nebo „Shipping“). {Name} je název vašeho pluginu (například „PayPalStandard“). Například platební plugin PayPal Standard má následující název: Nop.Plugin.Payments.PayPalStandard. Upozorňujeme však, že to není povinné. Pro plugin můžete zvolit libovolný název, například „MyGreatPlugin“. ![p1](_static/how-to-write-plugin-4.10/write_plugin_4.10_1.jpg) 1. Po vytvoření projektu pluginu otevřete jeho soubor `.csproj` v libovolném textovém editoru a nahraďte jeho obsah následujícím: ```xml <Project Sdk="Microsoft.NET.Sdk"> <PropertyGroup> <TargetFramework>netcoreapp2.1</TargetFramework> </PropertyGroup> <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|AnyCPU'"> <OutputPath>..\..\Presentation\Nop.Web\Plugins\PLUGIN_OUTPUT_DIRECTORY</OutputPath> <OutDir>$(OutputPath)</OutDir> </PropertyGroup> <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|AnyCPU'"> <OutputPath>..\..\Presentation\Nop.Web\Plugins\PLUGIN_OUTPUT_DIRECTORY</OutputPath> <OutDir>$(OutputPath)</OutDir> </PropertyGroup> <!-- This target execute after "Build" target --> <Target Name="NopTarget" AfterTargets="Build"> <!-- Delete unnecessary libraries from plugins path --> <MSBuild Projects="$(MSBuildProjectDirectory)\..\..\Build\ClearPluginAssemblies.proj" Properties="PluginPath=$(MSBuildProjectDirectory)\$(OutDir)" Targets="NopClear" /> </Target> </Project> ``` Kde PLUGIN_OUTPUT_DIRECTORY je třeba nahradit názvem pluginu, například Payments.PayPalStandard. Děláme to takto, abychom mohli využít nový způsob přidávání referencí na knihovny třetích stran, který byl zaveden v .NET Core. Není to však nutné. Navíc se reference z již referencovaných knihoven načtou automaticky. Je to tedy velmi pohodlné. 1. Dalším krokem je vytvoření souboru `plugin.json`, který je vyžadován pro každý plugin. Tento soubor obsahuje metainformace popisující váš plugin. Stačí tento soubor zkopírovat z jakéhokoli jiného existujícího pluginu a upravit jej podle svých potřeb. Informace o souboru `plugin.json` naleznete v článku [Soubor plugin.json](xref:cs/developer/plugins/plugin_json). 1. Posledním povinným krokem je vytvoření třídy, která implementuje rozhraní `IPlugin` (jmenný prostor Nop.Core.Plugins). nopCommerce obsahuje třídu `BasePlugin`, která již implementuje některé metody IPlugin a umožňuje vyhnout se duplikaci zdrojového kódu. nopCommerce vám také poskytuje některá specifická rozhraní odvozená od `IPlugin`. Například máme rozhraní „IPaymentMethod“, které se používá k vytváření nových pluginů platebních metod. Obsahuje některé metody, které jsou specifické pouze pro platební metody, například ProcessPayment() nebo GetAdditionalHandlingFee(). V současné době má nopCommerce následující specifická rozhraní pluginů: - **IPaymentMethod**. Tyto pluginy se používají ke zpracování plateb. - **IShippingRateComputationMethod**. Tyto pluginy se používají k získání přijatelných způsobů doručení a odpovídajících sazeb za dopravu. Například UPS, UPS, FedEx atd. - **IPickupPointProvider**. Tyto pluginy se používají k poskytování výdejních míst. - **ITaxProvider**. Poskytovatelé daní se používají k získání daňových sazeb. - **IExchangeRateProvider**. Používá se k získání směnného kurzu měn. - **IDiscountRequirementRule**. Umožňuje vytvářet nová pravidla slev, například „Fakturační země zákazníka musí být…“ - **IExternalAuthenticationMethod**. Používá se k vytváření externích metod ověřování, jako jsou Facebook, X (Twitter), OpenID atd. - **IWidgetPlugin**. Umožňuje vytvářet widgety. Widgety se vykreslují v některých částech webu. Může to být například blok „Live chat“ v levém sloupci webu. - **IMiscPlugin**. Pokud váš plugin neodpovídá žádnému z výše uvedených rozhraní. > [!IMPORTANT] > Po každém sestavení projektu vyčistěte řešení (clean) před provedením změn. Některé prostředky se ukládají do cache a mohou vývojáře přivést k šílenství. ## Zpracování požadavků. Controllery, modely a view Nyní můžete plugin vidět v **Administrace → Konfigurace → Pluginy** (Admin area → Configuration → Plugins). Jak jste ale jistě uhodli, náš plugin nic nedělá. Nemá ani uživatelské rozhraní pro svou konfiguraci. Vytvořme stránku pro konfiguraci pluginu. Nyní potřebujeme vytvořit controller, model a view. - MVC controllery jsou zodpovědné za odpovídání na požadavky odeslané na web ASP.NET MVC. Každý požadavek prohlížeče je namapován na konkrétní controller. - View obsahuje HTML značky a obsah, který se odesílá do prohlížeče. View je při práci s aplikací ASP.NET MVC ekvivalentem stránky. - MVC model obsahuje veškerou aplikační logiku, která není obsažena ve view ani v controlleru. Více informací naleznete o [vzoru MVC](http://www.asp.net/mvc/tutorials/older-versions/overview/understanding-models-views-and-controllers-cs). Pojďme tedy začít: - **Vytvořte model**. Do nového pluginu přidejte složku Models a poté přidejte novou třídu modelu, která odpovídá vašim potřebám. - **Vytvořte view**. Do nového pluginu přidejte složku Views a poté přidejte soubor cshtml s názvem `Configure.cshtml`. Nastavte vlastnost „Build Action“ souboru view na „Content“ a vlastnost „Copy to Output Directory“ na „Copy if newer“. Upozorňujeme, že konfigurační stránka by měla používat layout `_ConfigurePlugin`. Také se ujistěte, že máte v adresáři \Views soubor `_ViewImports`. Můžete jej jednoduše zkopírovat z jakéhokoli jiného existujícího pluginu. - **Vytvořte controller**. Do nového pluginu přidejte složku Controllers a poté přidejte novou třídu controlleru. Dobrým zvykem je pojmenovávat controllery pluginů `{Group}{Name}Controller.cs`. Například PaymentPayPalStandardController. Samozřejmě to není povinné (jde pouze o doporučení). Poté vytvořte odpovídající akční metodu pro konfigurační stránku (v administraci). Pojmenujme ji „Configure“. Připravte třídu modelu a předejte ji následujícímu view pomocí fyzické cesty k view: - `~/Plugins/{PluginOutputDirectory}/Views/Configure.cshtml`. - Pro akční metodu použijte následující atributy: ```csharp [AuthorizeAdmin] //confirms access to the admin panel [Area(AreaNames.Admin)] //specifies the area containing a controller or action ``` Otevřete například platební plugin PayPalStandard a podívejte se na jeho implementaci PaymentPayPalStandardController. Poté byste pro každý plugin, který má konfigurační stránku, měli zadat konfigurační URL. Základní třída `BasePlugin` má metodu `GetConfigurationPageUrl`, která vrací konfigurační URL: ```csharp return $"{_webHelper.GetStoreLocation()}Admin/ControllerName/ActionName"; ``` Kde ControllerName je název vašeho controlleru a ActionName je název akce (obvykle „Configure“). Jakmile plugin nainstalujete a přidáte konfigurační metodu, najdete odkaz na konfiguraci pluginu v Administrace → Konfigurace → Pluginy (Admin → Configuration → Plugins). > [!TIP] > Nejjednodušší způsob, jak provést výše popsané kroky, je otevřít jakýkoli jiný plugin a zkopírovat tyto soubory do projektu svého pluginu. Pak stačí přejmenovat příslušné třídy a adresáře. Například struktura projektu pluginu PayPalStandard vypadá jako na obrázku níže: ![p3](_static/how-to-write-plugin-4.10/write_plugin_4.10_3.jpg) ## Zpracování metod „Install“ a „Uninstall“ Tento krok je volitelný. Některé pluginy mohou během instalace vyžadovat dodatečnou logiku. Plugin může například vložit nové lokalizační zdroje. Otevřete tedy svou implementaci IPlugin (ve většině případů bude odvozena od třídy BasePlugin) a přepište následující metody: - Install. Tato metoda bude volána během instalace pluginu. Zde můžete inicializovat libovolná nastavení, vložit nové lokalizační zdroje nebo vytvořit nové databázové tabulky (pokud je to potřeba). - Uninstall. Tato metoda bude volána během odinstalace pluginu. > [!IMPORTANT] > Pokud přepíšete některou z těchto metod, neskrývejte její základní implementaci. Například přepsaná metoda „Install“ by měla obsahovat následující volání metody: base.Install(). Metoda „Install“ pluginu PayPalStandard vypadá jako kód níže ```csharp public override void Install() { var settings = new PayPalStandardPaymentSettings() { UseSandbox = true }; _settingService.SaveSetting(settings); base.Install(); } ``` > [!TIP] > Seznam nainstalovaných pluginů se nachází v `\App_Data\installedPlugins.json`. Seznam se vytváří během instalace. ## Routy Zde se podíváme na to, jak registrovat routy pluginu. Routování ASP.NET Core je zodpovědné za mapování příchozích požadavků prohlížeče na konkrétní akce MVC controllerů. Více informací naleznete o [routování](https://docs.microsoft.com/aspnet/core/fundamentals/routing). Postupujte tedy podle následujících kroků: - Pokud potřebujete přidat vlastní routu, vytvořte soubor `RouteProvider.cs`. Ten informuje systém nopCommerce o routách pluginu. Například následující třída RouteProvider přidává novou routu, ke které lze přistoupit otevřením webového prohlížeče a přechodem na URL `http://www.yourStore.com/Plugins/PaymentPayPalStandard/PDTHandler` (používá ji plugin PayPal): ```csharp public partial class RouteProvider : IRouteProvider { public void RegisterRoutes(IRouteBuilder routeBuilder) { routeBuilder.MapRoute("Plugin.Payments.PayPalStandard.PDTHandler", "Plugins/ PaymentPayPalStandard/PDTHandler", new { controller = "PaymentPayPalStandard", action = "PDTHandler" }); } public int Priority { get { return -1; } } } ``` ## Aktualizace nopCommerce může pluginy rozbít Některé pluginy mohou zastarat a přestat fungovat s novější verzí nopCommerce. Pokud máte po aktualizaci na novější verzi problémy, plugin odstraňte a navštivte oficiální web nopCommerce, abyste zjistili, zda je k dispozici novější verze. Mnoho autorů pluginů své pluginy aktualizuje pro novější verzi, někteří to však neudělají a jejich plugin se s vylepšeními nopCommerce stane zastaralým. Ve většině případů ale stačí otevřít příslušný soubor `plugin.json` a aktualizovat pole **SupportedVersions**. ## Závěr Doufáme, že vám tento článek pomůže začít s nopCommerce a připraví vás na vytváření propracovanějších pluginů. --- <!-- page: Jak napsat plugin pro nopCommerce | url: http://nopdocs.service.hedr.dev/cs/developer/plugins/how-to-write-plugin-4.00.html | source: cs/developer/plugins/how-to-write-plugin-4.00.md --> # Jak napsat plugin pro nopCommerce 4.00 > V informatice je plug-in (nebo plugin) sada softwarových komponent, které rozšiřují větší softwarovou aplikaci o konkrétní schopnosti (Wikipedie). Pluginy slouží k rozšíření funkčnosti nopCommerce. nopCommerce má několik typů pluginů. Například platební metody (jako PayPal), poskytovatele daní, metody výpočtu ceny dopravy (jako UPS, USP, FedEx), widgety (jako blok „live chat“) a mnoho dalších. nopCommerce je již distribuován s mnoha různými pluginy. Na [oficiálním webu nopCommerce](https://www.nopcommerce.com/marketplace) můžete také vyhledávat různé pluginy a zjistit, zda již někdo nevytvořil plugin, který vyhovuje vašim potřebám. Pokud ne, tento článek vás provede procesem vytvoření vlastního pluginu. ## Struktura pluginu, požadované soubory a umístění 1. Nejprve musíte v řešení (solution) vytvořit nový projekt typu „Class Library“. Je dobrým zvykem umisťovat všechny pluginy do adresáře `\Plugins` v kořeni řešení (nezaměňujte s podadresářem \Plugins v adresáři `\Nop.Web`, který slouží pro již nasazené pluginy). Je dobrým zvykem umisťovat všechny pluginy do složky řešení „Plugins“ (více informací o [složkách řešení](http://msdn.microsoft.com/library/sx2027y2.aspx)). Doporučený název projektu pluginu je „Nop.Plugin.{Group}.{Name}“. {Group} je skupina vašeho pluginu (například „Payment“ nebo „Shipping“). {Name} je název vašeho pluginu (například „PayPalStandard“). Například platební plugin PayPal Standard má následující název: Nop.Plugin.Payments.PayPalStandard. Upozorňujeme však, že nejde o povinnost. Pro plugin si můžete zvolit libovolný název. Například „MyGreatPlugin“. ![p1](_static/how-to-write-plugin-4.00/write_plugin_4.00_1.jpg) 1. Jakmile je projekt pluginu vytvořen, otevřete jeho soubor `.csproj` v libovolném textovém editoru a nahraďte jeho obsah následujícím: ```xml <Project Sdk="Microsoft.NET.Sdk"> <PropertyGroup> <TargetFramework>net461</TargetFramework> </PropertyGroup> <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|AnyCPU'"> <OutputPath>..\..\Presentation\Nop.Web\Plugins\PLUGIN_OUTPUT_DIRECTORY</OutputPath> <OutDir>$(OutputPath)</OutDir> </PropertyGroup> <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|AnyCPU'"> <OutputPath>..\..\Presentation\Nop.Web\Plugins\PLUGIN_OUTPUT_DIRECTORY</OutputPath> <OutDir>$(OutputPath)</OutDir> </PropertyGroup> <!-- This target execute after "Build" target --> <Target Name="NopTarget" AfterTargets="Build"> <!-- Delete unnecessary libraries from plugins path --> <MSBuild Projects="$(MSBuildProjectDirectory)\..\..\Build\ClearPluginAssemblies.proj" Properties="PluginPath=$(MSBuildProjectDirectory)\$(OutDir)" Targets="NopClear" /> </Target> </Project> ``` Kde PLUGIN_OUTPUT_DIRECTORY je třeba nahradit názvem pluginu, například Payments.PayPalStandard. Děláme to takto, abychom mohli využít nový způsob přidávání referencí třetích stran, který byl zaveden v .NET Core. Není to však povinné. Navíc reference z již referencovaných knihoven se načtou automaticky. Je to tedy velmi pohodlné. 1. Dalším krokem je vytvoření souboru `plugin.json`, který je vyžadován pro každý plugin. Tento soubor obsahuje metainformace popisující váš plugin. Stačí tento soubor zkopírovat z jakéhokoli jiného existujícího pluginu a upravit jej podle svých potřeb. Informace o souboru `plugin.json` najdete v části [soubor plugin.json](xref:cs/developer/plugins/plugin_json). 1. Posledním povinným krokem je vytvoření třídy, která implementuje rozhraní `IPlugin` (jmenný prostor Nop.Core.Plugins). nopCommerce obsahuje třídu `BasePlugin`, která již implementuje některé metody `IPlugin` a umožňuje vám vyhnout se duplikaci zdrojového kódu. nopCommerce vám také poskytuje některá specifická rozhraní odvozená od `IPlugin`. Máme například rozhraní „IPaymentMethod“, které se používá k vytváření nových pluginů platebních metod. Obsahuje některé metody specifické pouze pro platební metody, například `ProcessPayment()` nebo `GetAdditionalHandlingFee()`. V současnosti má nopCommerce následující specifická rozhraní pluginů: - **IPaymentMethod**. Tyto pluginy slouží ke zpracování plateb. - **IShippingRateComputationMethod**. Tyto pluginy slouží k získání přípustných způsobů doručení a odpovídajících cen dopravy. Například UPS, UPS, FedEx atd. - **IPickupPointProvider**. Tyto pluginy slouží k poskytování výdejních míst. - **ITaxProvider**. Poskytovatelé daní slouží k získávání daňových sazeb. - **IExchangeRateProvider**. Slouží k získávání směnného kurzu měn. - **IDiscountRequirementRule**. Umožňuje vytvářet nová pravidla slev, například „Fakturační země zákazníka musí být…“ - **IExternalAuthenticationMethod**. Slouží k vytváření metod externího ověřování, jako je Facebook, X (Twitter), OpenID atd. - **IWidgetPlugin**. Umožňuje vytvářet widgety. Widgety se vykreslují v určitých částech vašeho webu. Může to být například blok „Live chat“ v levém sloupci webu. - **IMiscPlugin**. Pokud váš plugin neodpovídá žádnému z výše uvedených rozhraní. > [!IMPORTANT] > Po každém sestavení projektu vyčistěte řešení, než provedete změny. Některé prostředky se ukládají do cache a mohou vývojáře přivést k šílenství. ## Zpracování požadavků. Controllery, modely a view Nyní můžete plugin zobrazit v **Administrace → Konfigurace → Pluginy** (Admin area → Configuration → Plugins). Jak ale tušíte, náš plugin nic nedělá. Nemá ani uživatelské rozhraní pro svou konfiguraci. Vytvořme tedy stránku pro konfiguraci pluginu. Nyní musíme vytvořit controller, model a view. - MVC controllery odpovídají na požadavky odeslané na web ASP.NET MVC. Každý požadavek prohlížeče je namapován na konkrétní controller. - View obsahuje HTML značky a obsah, který se odesílá do prohlížeče. View je při práci s aplikací ASP.NET MVC ekvivalentem stránky. - MVC model obsahuje veškerou logiku aplikace, která není obsažena ve view ani v controlleru. Více informací najdete o [návrhovém vzoru MVC](http://www.asp.net/mvc/tutorials/older-versions/overview/understanding-models-views-and-controllers-cs). Začněme tedy: - **Vytvořte model**. Do nového pluginu přidejte složku Models a poté přidejte novou třídu modelu, která odpovídá vašim potřebám. - **Vytvořte view**. Do nového pluginu přidejte složku Views a poté přidejte soubor cshtml s názvem `Configure.cshtml`. U souboru view nastavte vlastnost „Build Action“ na „Content“ a vlastnost „Copy to Output Directory“ na „Copy if newer“. Upozorňujeme, že konfigurační stránka by měla používat layout `_ConfigurePlugin`. Ujistěte se také, že máte v adresáři `\Views` soubor `_ViewImports`. Můžete jej jednoduše zkopírovat z jakéhokoli jiného existujícího pluginu. - **Vytvořte controller**. Do nového pluginu přidejte složku Controllers a poté přidejte novou třídu controlleru. Je dobrým zvykem pojmenovávat controllery pluginů `{Group}{Name}Controller.cs`. Například PaymentPayPalStandardController. Pojmenovávat controllery tímto způsobem samozřejmě není povinné (jde jen o doporučení). Poté vytvořte odpovídající akční metodu pro konfigurační stránku (v administraci). Pojmenujme ji „Configure“. Připravte třídu modelu a předejte ji následujícímu view pomocí fyzické cesty k view: - `~/Plugins/{PluginOutputDirectory}/Views/Configure.cshtml`. - U své akční metody použijte následující atributy: ```csharp [AuthorizeAdmin] //confirms access to the admin panel [Area(AreaNames.Admin)] //specifies the area containing a controller or action ``` Otevřete například platební plugin PayPalStandard a podívejte se na jeho implementaci PaymentPayPalStandardController. Poté byste pro každý plugin, který má konfigurační stránku, měli zadat konfigurační URL. Základní třída s názvem `BasePlugin` obsahuje metodu `GetConfigurationPageUrl`, která vrací konfigurační URL: ```csharp return $"{_webHelper.GetStoreLocation()}Admin/ControllerName/ActionName"; ``` Kde ControllerName je název vašeho controlleru a ActionName je název akce (obvykle „Configure“). Jakmile plugin nainstalujete a přidáte konfigurační metodu, najdete odkaz pro konfiguraci pluginu v Administrace → Konfigurace → Pluginy. > [!TIP] > Nejsnazší způsob, jak dokončit výše popsané kroky, je otevřít jakýkoli jiný plugin a zkopírovat tyto soubory do projektu svého pluginu. Poté stačí přejmenovat příslušné třídy a adresáře. Struktura projektu pluginu PayPalStandard vypadá například jako na obrázku níže: ![p3](_static/how-to-write-plugin-4.00/write_plugin_4.00_3.jpg) ## Zpracování metod „Install“ a „Uninstall“ Tento krok je volitelný. Některé pluginy mohou během instalace vyžadovat další logiku. Plugin může například vkládat nové lokalizační řetězce. Otevřete tedy svou implementaci IPlugin (ve většině případů bude odvozena od třídy BasePlugin) a přepište následující metody: - Install. Tato metoda se zavolá během instalace pluginu. Zde můžete inicializovat libovolná nastavení, vložit nové lokalizační řetězce nebo vytvořit nové databázové tabulky (je-li to potřeba). - Uninstall. Tato metoda se zavolá během odinstalace pluginu. > [!IMPORTANT] > Pokud některou z těchto metod přepíšete, neskrývejte její základní implementaci. Například přepsaná metoda „Install“ by měla obsahovat následující volání metody: base.Install(). Metoda „Install“ pluginu PayPalStandard vypadá jako kód níže ```csharp public override void Install() { var settings = new PayPalStandardPaymentSettings() { UseSandbox = true }; _settingService.SaveSetting(settings); base.Install(); } ``` > [!TIP] > Seznam nainstalovaných pluginů se nachází v souboru `\App_Data\installedPlugins.json`. Seznam se vytváří během instalace. ## Routy Zde se podíváme, jak registrovat routy pluginu. Routování v ASP.NET Core zajišťuje mapování příchozích požadavků prohlížeče na konkrétní akce MVC controllerů. Více informací najdete o [routování](https://docs.microsoft.com/aspnet/core/fundamentals/routing). Postupujte tedy podle následujících kroků: - Pokud potřebujete přidat vlastní routu, vytvořte soubor `RouteProvider.cs`. Ten informuje systém nopCommerce o routách pluginu. Například následující třída RouteProvider přidává novou routu, ke které lze přistoupit otevřením webového prohlížeče a přechodem na URL `http://www.yourStore.com/Plugins/PaymentPayPalStandard/PDTHandler` (používá ji plugin PayPal): ```csharp public partial class RouteProvider : IRouteProvider { public void RegisterRoutes(IRouteBuilder routeBuilder) { routeBuilder.MapRoute("Plugin.Payments.PayPalStandard.PDTHandler", "Plugins/ PaymentPayPalStandard/PDTHandler", new { controller = "PaymentPayPalStandard", action = "PDTHandler" }); } public int Priority { get { return -1; } } } ``` ## Aktualizace nopCommerce může pluginy rozbít Některé pluginy mohou zastarat a přestat fungovat s novější verzí nopCommerce. Pokud máte po aktualizaci na novější verzi problémy, plugin odstraňte a navštivte oficiální web nopCommerce, abyste zjistili, zda je k dispozici novější verze. Mnoho autorů pluginů své pluginy aktualizuje, aby vyhovovaly novější verzi, někteří to však neudělají a jejich plugin se s vylepšeními nopCommerce stane zastaralým. Ve většině případů však můžete jednoduše otevřít příslušný soubor `plugin.json` a aktualizovat pole **SupportedVersions**. ## Závěr Doufáme, že vám to pomůže začít s nopCommerce a připraví vás na vytváření propracovanějších pluginů. --- <!-- page: Jak napsat plugin pro nopCommerce | url: http://nopdocs.service.hedr.dev/cs/developer/plugins/how-to-write-plugin-3.90.html | source: cs/developer/plugins/how-to-write-plugin-3.90.md --> # Jak napsat plugin pro nopCommerce 3.90 (a předchozí verze) > V informatice je plug-in (neboli plugin) sada softwarových komponent, které přidávají specifické schopnosti větší softwarové aplikaci (Wikipedie). Pluginy se používají k rozšíření funkčnosti nopCommerce. nopCommerce má několik typů pluginů. Například platební metody (jako PayPal), poskytovatele daní, metody výpočtu dopravy (jako UPS, USP, FedEx), widgety (jako blok „live chat“) a mnoho dalších. nopCommerce je již distribuován s mnoha různými pluginy. Můžete také vyhledávat různé pluginy na [oficiálním webu nopCommerce](https://www.nopcommerce.com/marketplace) a zjistit, zda už někdo nevytvořil plugin, který vyhovuje vašim potřebám. Pokud ne, tento článek vás provede procesem vytvoření vlastního pluginu. ## Struktura pluginu, požadované soubory a umístění 1. Nejprve musíte v řešení (solution) vytvořit nový projekt typu „Class Library“. Je dobrým zvykem umístit všechny pluginy do adresáře `\Plugins` v kořeni vašeho řešení (nezaměňujte s podadresářem \Plugins umístěným v adresáři `\Nop.Web`, který slouží pro již nasazené pluginy). Je dobrým zvykem umístit všechny pluginy do složky řešení „Plugins“ (více [informací o složkách řešení](http://msdn.microsoft.com/library/sx2027y2.aspx)). Doporučený název projektu pluginu je „Nop.Plugin.{Group}.{Name}“. {Group} je skupina vašeho pluginu (například „Payment“ nebo „Shipping“). {Name} je název vašeho pluginu (například „PayPalStandard“). Například platební plugin PayPal Standard má následující název: Nop.Plugin.Payments.PayPalStandard. Upozorňujeme však, že to není povinné. Pro plugin můžete zvolit libovolný název. Například „MyGreatPlugin“. ![p1](_static/how-to-write-plugin-3.90/write_plugin_3.90_4.jpg) 1. Jakmile je projekt pluginu vytvořen, aktualizujte výstupní cestu sestavení projektu. Nastavte ji na `..\..\Presentation\Nop.Web\Plugins\{Group}.{Name}`. Například platební plugin Authorize.NET má následující výstupní cestu: `..\..\Presentation\Nop.Web\Plugins\Payments.AuthorizeNet`. Poté budou příslušné knihovny DLL pluginu automaticky kopírovány do adresáře `\Presentation\Nop.Web\Plugins`, ve kterém jádro nopCommerce hledá platné pluginy. Upozorňujeme však, že ani to není povinné. Pro plugin můžete zvolit libovolný název výstupního adresáře. ![p1](_static/how-to-write-plugin-3.90/write_plugin_3.90_1.jpg) - V nabídce Project klikněte na Properties. - Klikněte na kartu Build. - Klikněte na tlačítko Browse vedle pole Output path a vyberte nový výstupní adresář sestavení. Výše popsané kroky byste měli provést pro všechny existující konfigurace („Debug“ a „Release“). 1. Dalším krokem je vytvoření souboru `Description.txt`, který je vyžadován pro každý plugin. Tento soubor obsahuje metainformace popisující váš plugin. Stačí tento soubor zkopírovat z jakéhokoli jiného existujícího pluginu a upravit jej podle svých potřeb. Například platební plugin PayPal Standard má následující soubor `Description.txt`: ```txt Group: Payment methods FriendlyName: PayPal Standard SystemName: Payments.PayPalStandard Version: 1.28 SupportedVersions: 3.90 Author: nopCommerce team DisplayOrder: 1 FileName: Nop.Plugin.Payments.PayPalStandard.dll Description: This plugin allows paying with PayPal Standard ``` Všechna pole jsou samovysvětlující, ale zde je několik poznámek. Pole **SystemName** by mělo být jedinečné. Pole **Version** je číslo verze vašeho pluginu; můžete jej nastavit na libovolnou hodnotu. Pole **SupportedVersions** může obsahovat seznam podporovaných verzí nopCommerce oddělených čárkami (ujistěte se, že aktuální verze nopCommerce je v tomto seznamu zahrnuta, jinak se plugin nenačte). Pole **FileName** má formát *Nop.Plugin.{Group}.{Name}.dll* (jde o název souboru sestavení vašeho pluginu). Ujistěte se, že vlastnost „Copy to Output Directory“ tohoto souboru je nastavena na „Copy if newer“. ![p2](_static/how-to-write-plugin-3.90/write_plugin_3.90_2.jpg) 1. Měli byste také vytvořit soubor web.config a zajistit, aby byl kopírován na výstup. Stačí jej zkopírovat z jakéhokoli existujícího pluginu. > [!IMPORTANT] > Do budoucna se ujistěte, že vlastnosti „Copy local“ všech referencí na sestavení třetích stran (včetně základních knihoven, jako jsou Nop.Services.dll nebo Nop.Web.Framework.dll) jsou nastaveny na „False“ (nekopírovat) 1. Posledním povinným krokem je vytvoření třídy, která implementuje rozhraní IPlugin (jmenný prostor Nop.Core.Plugins). nopCommerce obsahuje třídu BasePlugin, která již implementuje některé metody IPlugin a umožňuje vyhnout se duplikaci zdrojového kódu. nopCommerce vám také poskytuje některá specifická rozhraní odvozená od IPlugin. Máme například rozhraní „IPaymentMethod“, které se používá k vytváření nových pluginů platebních metod. Obsahuje některé metody, které jsou specifické pouze pro platební metody, jako ProcessPayment() nebo GetAdditionalHandlingFee(). V současné době má nopCommerce následující specifická rozhraní pluginů: - **IPaymentMethod**. Tyto pluginy se používají ke zpracování plateb. - **IShippingRateComputationMethod**. Tyto pluginy se používají k získání přijatelných způsobů doručení a příslušných cen dopravy. Například UPS, UPS, FedEx atd. - **IPickupPointProvider**. Tyto pluginy se používají k poskytování výdejních míst. - **ITaxProvider**. Poskytovatelé daní se používají k získání daňových sazeb. - **IExchangeRateProvider**. Používá se k získání směnného kurzu měny. - **IDiscountRequirementRule**. Umožňuje vytvářet nová pravidla slev, například „Fakturační země zákazníka musí být…“ - **IExternalAuthenticationMethod**. Používá se k vytváření metod externího ověřování, jako jsou Facebook, X (Twitter), OpenID atd. - **IWidgetPlugin**. Umožňuje vytvářet widgety. Widgety se vykreslují v některých částech vašeho webu. Může jít například o blok „Live chat“ v levém sloupci vašeho webu. - **IMiscPlugin**. Pokud váš plugin neodpovídá žádnému z výše uvedených rozhraní. > [!IMPORTANT] > Po každém sestavení projektu vyčistěte řešení, než provedete změny. Některé prostředky budou uloženy v cache a mohou vývojáře přivést k šílenství. ## Zpracování požadavků. Controllery, modely a views Nyní můžete plugin vidět v **Administrace → Konfigurace → Pluginy** (Admin area → Configuration → Plugins). Jak ale jistě tušíte, náš plugin nic nedělá. Nemá ani uživatelské rozhraní pro svou konfiguraci. Vytvořme stránku pro konfiguraci pluginu. Nyní musíme vytvořit controller, model a view. - MVC controllery jsou zodpovědné za odpovídání na požadavky vůči webu ASP.NET MVC. Každý požadavek prohlížeče je namapován na konkrétní controller. - View obsahuje HTML značky a obsah, který se odesílá do prohlížeče. Při práci s aplikací ASP.NET MVC je view ekvivalentem stránky. - MVC model obsahuje veškerou logiku vaší aplikace, která není obsažena ve view ani v controlleru. Více [informací o vzoru MVC](http://www.asp.net/mvc/tutorials/older-versions/overview/understanding-models-views-and-controllers-cs). Pojďme tedy začít: - **Vytvořte model**. V novém pluginu přidejte složku Models a poté přidejte novou třídu modelu, která odpovídá vašim potřebám. - **Vytvořte view**. V novém pluginu přidejte složku Views, poté složku {Name} (kde {Name} je název vašeho pluginu) a nakonec přidejte soubor cshtml s názvem `Configure.cshtml`. Důležitá poznámka: pro verze 2.00–3.30 by mělo být view označeno jako vložený prostředek (embedded resource). A od verze 3.40 se u views ujistěte, že vlastnost „Build Action“ souboru view je nastavena na „Content“ a vlastnost „Copy to Output Directory“ je nastavena na „Copy if newer“. - **Vytvořte controller**. V novém pluginu přidejte složku Controllers a poté přidejte novou třídu controlleru. Je dobrým zvykem pojmenovávat controllery pluginů `{Group}{Name}Controller.cs`. Například PaymentAuthorizeNetController. Takové pojmenování controllerů samozřejmě není povinné (jde jen o doporučení). Poté vytvořte příslušnou metodu akce pro konfigurační stránku (v administraci). Pojmenujme ji „Configure“. Připravte třídu modelu a předejte ji následujícímu view. Pro verze nopCommerce 2.00–3.30 byste měli předat cestu k vloženému view – „Nop.Plugin.{Group}.{Name}.Views. {Group}{Name}.Configure“. A od verze nopCommerce 3.40 byste měli předat fyzickou cestu k view – `~/Plugins/{PluginOutputDirectory}/Views/{ControllerName}/Configure.cshtml`. Otevřete například platební plugin Authorize.NET a podívejte se na jeho implementaci PaymentAuthorizeNetController. > [!TIP] > > - Nejjednodušší způsob, jak výše popsané kroky provést, je otevřít jakýkoli jiný plugin a zkopírovat tyto soubory do projektu vašeho pluginu. Poté stačí přejmenovat příslušné třídy a adresáře. > > - Pokud chcete omezit přístup k určité metodě akce controlleru pouze na administrátory (majitele obchodu), stačí ji označit atributem [AdminAuthorize]. Například struktura projektu pluginu Authorize.NET vypadá jako na obrázku níže ![p3](_static/how-to-write-plugin-3.90/write_plugin_3.90_3.jpg) ## Routy Nyní musíme zaregistrovat příslušné routy pluginu. Směrování (routing) ASP.NET je zodpovědné za mapování příchozích požadavků prohlížeče na konkrétní akce MVC controllerů. Více [informací o směrování](http://www.asp.net/mvc/tutorials/older-versions/controllers-and-routing/asp-net-mvc-routing-overview-cs). Postupujte tedy podle následujících kroků: - Některá specifická rozhraní pluginů (popsaná výše) a rozhraní „IMiscPlugin“ obsahují metodu „GetConfigurationRoute“. Ta by měla vracet routu k akci controlleru, která se používá pro konfiguraci pluginu. Implementujte metodu „GetConfigurationRoute“ rozhraní svého pluginu. Tato metoda informuje nopCommerce o tom, jaká routa se používá pro konfiguraci pluginu. Pokud váš plugin nemá konfigurační stránku, měla by metoda „GetConfigurationRoute“ vracet null. Viz například níže uvedený kód: ```csharp public void GetConfigurationRoute(out string actionName, out string controllerName, out RouteValueDictionary routeValues) { actionName = "Configure"; controllerName = "PaymentAuthorizeNet"; routeValues = new RouteValueDictionary() { { "Namespaces", "Nop.Plugin.Payments.AuthorizeNet.Controllers" }, { "area", null } }; } ``` - (volitelné) Pokud potřebujete přidat nějakou vlastní routu, vytvořte soubor `RouteProvider.cs`. Ten informuje systém nopCommerce o routách pluginu. Například následující třída RouteProvider přidává novou routu, ke které lze přistoupit otevřením webového prohlížeče a přechodem na URL `http://www.yourStore.com/Plugins/PaymentPayPalStandard/PDTHandler` (používá ji plugin PayPal): ```csharp public partial class RouteProvider : IRouteProvider { public void RegisterRoutes(RouteCollection routes) { routes.MapRoute("Plugin.Payments.PayPalStandard.PDTHandler", "Plugins/PaymentPayPalStandard/PDTHandler", new { controller = "PaymentPayPalStandard", action = "PDTHandler" }, new[] { "Nop.Plugin.Payments.PayPalStandard.Controllers" } ); } public int Priority { get { return 0; } } } ``` Jakmile plugin nainstalujete a přidáte konfigurační metodu, najdete odkaz na konfiguraci pluginu v Administrace → Konfigurace → Pluginy (Admin → Configuration → Plugins). ## Zpracování metod „Install“ a „Uninstall“ Tento krok je volitelný. Některé pluginy mohou během instalace vyžadovat dodatečnou logiku. Plugin může například vložit nové lokalizační prostředky. Otevřete tedy svou implementaci IPlugin (ve většině případů bude odvozena od třídy BasePlugin) a přepište následující metody: - Install. Tato metoda bude vyvolána během instalace pluginu. Zde můžete inicializovat libovolná nastavení, vložit nové lokalizační prostředky nebo vytvořit nové databázové tabulky (je-li to potřeba). - Uninstall. Tato metoda bude vyvolána během odinstalace pluginu. > [!IMPORTANT] > Pokud přepíšete jednu z těchto metod, neskrývejte její základní implementaci. Například struktura projektu pluginu Authorize.NET vypadá jako na obrázku níže ```csharp public override void Install() { var settings = new AuthorizeNetPaymentSettings() { UseSandbox = true, TransactMode = TransactMode.Authorize, TransactionKey = "123", LoginId = "456" }; _settingService.SaveSetting(settings); base.Install(); } ``` > [!TIP] > Seznam nainstalovaných pluginů se nachází v `\App_Data\InstalledPlugins.txt`. Seznam se vytváří během instalace. ## Aktualizace nopCommerce může pluginy rozbít Některé pluginy mohou zastarat a s novější verzí nopCommerce přestat fungovat. Pokud máte po aktualizaci na novější verzi potíže, odstraňte plugin a navštivte oficiální web nopCommerce, abyste zjistili, zda je k dispozici novější verze. Mnoho autorů pluginů své pluginy aktualizuje, aby vyhovovaly novější verzi, někteří to však neudělají a jejich plugin se s vylepšeními nopCommerce stane zastaralým. Ve většině případů však stačí otevřít příslušný soubor `plugin.json` a aktualizovat pole **SupportedVersions**. ## Závěr Doufáme, že vám to pomůže začít s nopCommerce a připraví vás na vytváření propracovanějších pluginů. --- <!-- page: Jak naprogramovat vlastní platební metodu | url: http://nopdocs.service.hedr.dev/cs/developer/plugins/payment-method.html | source: cs/developer/plugins/payment-method.md --> # Jak naprogramovat vlastní platební metodu Platební metody jsou v nopCommerce implementovány jako pluginy. Než začnete programovat novou platební metodu, doporučujeme přečíst si článek [Jak napsat plugin pro nopCommerce 5.00](xref:cs/developer/plugins/how-to-write-plugin-5.00). Vysvětlí vám, jaké kroky jsou nutné k vytvoření pluginu. Platební metoda je tedy ve skutečnosti běžný plugin, který implementuje rozhraní **`IPaymentMethod`** (*jmenný prostor Nop.Services.Payments*). Jak jste již jistě uhodli, rozhraní *IPaymentMethod* se používá k vytváření pluginů platebních metod. Obsahuje některé metody specifické pouze pro platební metody, například `ProcessPaymentAsync()` nebo `GetAdditionalHandlingFeeAsync()`. Přidejte tedy do solution nový projekt platebního pluginu (*class library*) a pojďme začít. ## Controllery, view, modely Nejprve je potřeba vytvořit controller. Tento controller je zodpovědný za odpovídání na požadavky zaslané webu ASP.NET MVC. 1. Při implementaci nové platební metody by měl být tento controller odvozen od speciální abstraktní třídy **BasePaymentController**. 1. Poté implementujte metody akcí **Configure**, které slouží ke konfiguraci pluginu (majitelem obchodu v administraci). Tato metoda a odpovídající view definují, jak majitel obchodu uvidí možnosti konfigurace v administraci (*Systém → Konfigurace → Platební metody*). ## Veřejná view komponenta.GetPublicViewComponent Poté musíte vytvořit view komponentu pro zobrazení pluginu ve veřejném obchodě. Tato view komponenta a odpovídající view definují, jak vaši zákazníci uvidí stránku s platebními informacemi během pokladny. Nejprve vytvořme třídu view komponenty. Měla by být umístěna ve složce *`/Components`*. Podívejte se, jak je to provedeno v pluginu *PayPalCommerce*: ```csharp public class PaymentInfoViewComponent : NopViewComponent { public IViewComponentResult Invoke(string widgetZone, object additionalData) { return View("~/Plugins/Payments.PayPalCommerce/Views/Public/PaymentInfo.cshtml"); } } ``` Metoda **Invoke** vrací odpovídající view `PaymentInfo` ze složky */Views* vašeho pluginu. Všimněte si, že jako základní třídu používáme naši vlastní třídu NopViewComponent namísto existující vestavěné ViewComponent. Poté vytvořme view `PaymentInfo`, které zobrazuje platební informace. V něm pouze vykreslíme text oznamující, že zákazník bude přesměrován na platební stránku. V případě potřeby je však možné vytvořit i složitější view komponentu. Pokud například chcete na stránce s platebními informacemi shromažďovat informace o zákazníkovi, podívejte se, jak je to již provedeno v platebním pluginu `PayPalDirect`. ## Zpracování platby Nyní musíte vytvořit třídu, která implementuje rozhraní **IPaymentMethod**. Právě tato třída bude vykonávat veškerou skutečnou práci při komunikaci s vaší platební bránou. Když někdo vytvoří objednávku, zavolá se buď metoda `ProcessPayment`, nebo `PostProcessPayment` vaší třídy. Takto je definována třída **CheckMoneyOrderPaymentProcessor** (platební metoda `CheckMoneyOrder`): ```csharp public class CheckMoneyOrderPaymentProcessor : BasePlugin, IPaymentMethod ``` Rozhraní **IPaymentMethod** má několik metod a vlastností, které je nutné implementovat. - **ValidatePaymentFormAsync** se používá ve veřejném obchodě k ověření vstupu zákazníka. Vrací seznam varování (například že zákazník nezadal jméno na platební kartě). Pokud vaše platební metoda nežádá po zákazníkovi zadání dalších informací, měla by `ValidatePaymentFormAsync` vrátit prázdný seznam: ```csharp public Task<IList<string>> ValidatePaymentFormAsync(IFormCollection form) { return Task.FromResult<IList<string>>(new List<string>()); } ``` - Metoda **GetPaymentInfoAsync** se používá ve veřejném obchodě ke zpracování vstupu zákazníka, například informací o platební kartě. Tato metoda vrací objekt ProcessPaymentRequest se zpracovaným vstupem zákazníka (například informacemi o platební kartě). Pokud vaše platební metoda nežádá po zákazníkovi zadání dalších informací, vrátí `GetPaymentInfoAsync` prázdný objekt ProcessPaymentRequest: ```csharp public Task<ProcessPaymentRequest> GetPaymentInfoAsync(IFormCollection form) { return Task.FromResult(new ProcessPaymentRequest()); } ``` - **ProcessPaymentAsync**. Tato metoda se vždy volá těsně předtím, než zákazník odešle objednávku. Použijte ji, když potřebujete zpracovat platbu před uložením objednávky do databáze. Například stržení (capture) nebo autorizaci platby kartou. Obvykle se tato metoda používá, když zákazník není k dokončení platby přesměrován na web třetí strany a všechny platby se zpracovávají na vašem webu (například *PayPalCommerce*). ```csharp public Task<ProcessPaymentResult> ProcessPaymentAsync(ProcessPaymentRequest processPaymentRequest) { return Task.FromResult(new ProcessPaymentResult()); } ``` - **PostProcessPaymentAsync**. Tato metoda se volá hned poté, co zákazník odešle objednávku. Obvykle se používá, když potřebujete zákazníka k dokončení platby přesměrovat na web třetí strany (například PayPal Standard). - **HidePaymentMethodAsync**. Sem můžete vložit libovolnou logiku. Například skrýt tuto platební metodu, pokud jsou všechny produkty v košíku stahovatelné. Nebo skrýt tuto platební metodu, pokud je aktuální zákazník z určité země. - **GetAdditionalHandlingFeeAsync**. Můžete vrátit libovolné dodatečné manipulační poplatky, které budou přičteny k celkové částce objednávky. - **CaptureAsync**. Některé platební brány umožňují platby nejprve autorizovat a teprve poté strhnout. Majitelé obchodů tak mohou před provedením platby zkontrolovat podrobnosti objednávky. V takovém případě platbu pouze autorizujete v metodě **ProcessPaymentAsync** nebo **PostProcessPaymentAsync** (popsáno výše) a poté ji jen strhnete. V tomto případě bude na stránce podrobností objednávky v administraci viditelné tlačítko *Strhnout* (Capture). Upozorňujeme, že objednávka by již měla být autorizována a vlastnost **SupportCapture** by měla vracet **`true`**. - **RefundAsync**. Tato metoda umožňuje provést refundaci. V tomto případě bude na stránce podrobností objednávky v administraci viditelné tlačítko *Refundovat* (Refund). Upozorňujeme, že objednávka by měla být zaplacena a vlastnost **SupportRefund** nebo **SupportPartiallyRefund** by měla vracet **`true`**. - **VoidAsync**. Tato metoda umožňuje zrušit autorizovanou, ale dosud nestrženou platbu. V tomto případě bude na stránce podrobností objednávky v administraci viditelné tlačítko *Zrušit platbu* (Void). Upozorňujeme, že objednávka by měla být autorizována a vlastnost **SupportVoid** by měla vracet **`true`**. - **ProcessRecurringPaymentAsync**. Tuto metodu použijte ke zpracování opakovaných plateb. - **CancelRecurringPaymentAsync**. Tuto metodu použijte ke zrušení opakovaných plateb. - **CanRePostProcessPaymentAsync**. Obvykle se tato metoda používá, když zákazníka k dokončení platby přesměrovává na web třetí strany. Pokud platba u třetí strany selže, umožní tato možnost zákazníkům pokusit se o zaplacení objednávky později, aniž by museli vytvářet novou objednávku. Aby byla tato funkce povolena, měla by **CanRePostProcessPaymentAsync** vracet **`true`**. - **GetConfigurationPageUrl**. Jak si pamatujete, v předchozím kroku jsme vytvořili controller. Tato metoda by měla vracet URL jeho metody `Configure`. Například: ```csharp public override string GetConfigurationPageUrl() { return $"{_webHelper.GetStoreLocation()}Admin/PaymentCheckMoneyOrder/Configure"; } ``` - **GetPaymentMethodDescriptionAsync**. Tato metoda získá popis platební metody, který se zobrazí na stránkách pokladny ve veřejném obchodě. ```csharp public async Task<string> GetPaymentMethodDescriptionAsync() { return await _localizationService.GetResourceAsync("Plugins.Payment.CheckMoneyOrderPaymentMethodDescription"); } ``` - **SupportCapture, SupportPartiallyRefund, SupportRefund, SupportVoid**. Tyto vlastnosti udávají, zda jsou podporovány příslušné metody platební metody. - **RecurringPaymentType**. Tato vlastnost udává, zda jsou podporovány opakované platby. - **PaymentMethodType**. Tato vlastnost udává typ platební metody. V současné době existují tři typy. **`Standard`** používají platební metody, kdy zákazník není přesměrován na web třetí strany. **`Redirection`** se používá, když je zákazník přesměrován na web třetí strany. A **`Button`** je podobný platebním metodám **`Redirection`**. Jediný rozdíl spočívá v tom, že se zobrazuje jako tlačítko na stránce nákupního košíku (například *Google Checkout*). - **SkipPaymentInfo**. Udává, zda se má pro tento plugin zobrazovat stránka s platebními informacemi. ## Závěr Doufáme, že vám to pomůže začít s přidáváním nové platební metody. --- <!-- page: Jak naprogramovat vlastní metodu výpočtu ceny dopravy | url: http://nopdocs.service.hedr.dev/cs/developer/plugins/shipping-plugin.html | source: cs/developer/plugins/shipping-plugin.md --> # 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](xref:cs/developer/plugins/how-to-write-plugin-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](xref:cs/getting-started/configure-shipping/shipping-providers/index). ![shipping-plugin_1](_static/shipping-plugin/shipping-plugin_1.png) 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“): ```csharp 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. --- <!-- page: Cloudflare Images | url: http://nopdocs.service.hedr.dev/cs/developer/plugins/cloudflare-Images.html | source: cs/developer/plugins/cloudflare-Images.md --> # Integrace Cloudflare Images ## Přehled Od verze 4.90 byla správa náhledů (thumbnails) přepracována pro větší flexibilitu. Bylo zavedeno nové rozhraní `IThumbService`, které obsluhuje všechny operace související s náhledy, jež dříve spravovala služba 'IPictureService`. Do `IThumbService` byly přesunuty následující metody: - `GetThumbLocalPathAsync` - `GeneratedThumbExistsAsync` - `SaveThumbAsync` - `GetThumbLocalPathByFileNameAsync` - `GetThumbUrlAsync` - `DeletePictureThumbsAsync` V rámci této změny byla logika ukládání náhledů oddělena od jádra aplikace do samostatných pluginů. Stávající funkcionalita **Azure Blob Storage** je nyní samostatným pluginem. Byl vyvinut nový plugin pro integraci **Cloudflare Images** jako řešení pro ukládání náhledů. > [!NOTE] > > Ve výchozím stavu jsou oba pluginy, Azure Blob i Cloudflare Images (`Misc.AzureBlob` a `Misc.CloudflareImages`), uvedeny ve vlastnosti `InstallationConfig.DisabledPlugins`. Tím je zajištěno, že ani jeden z pluginů nebude nainstalován při nové instalaci, a majitelé obchodů si tak mohou zvolit a nainstalovat řešení úložiště, které nejlépe vyhovuje jejich potřebám. ## Konfigurace Azure Blob Storage K ukládání blob dat můžeme použít *Azure Blob Storage*. nopCommerce již má tuto funkci integrovanou, stačí jen správně nastavit následující informace. Hodnoty těchto nastavení lze získat z *Azure* při vytváření účtu úložiště. ![Obrázek](_static/cloudflare-images/azure-blob.png) - **ConnectionString** Toto nastavení očekává řetězcovou hodnotu. Zde je třeba přidat připojovací řetězec `AzureBlobStorage`. - **ContainerName** Hodnota tohoto nastavení je rovněž typu řetězec. V tomto nastavení nastavujeme název kontejneru pro *Azure BLOB storage*. - **EndPoint** Toto nastavení rovněž očekává řetězcovou hodnotu. Zde je třeba nastavit endpoint pro *Azure BLOB storage*. - **AppendContainerName** Toto nastavení očekává logickou hodnotu (boolean). Nastavte hodnotu na **`true`** nebo **`false`** podle toho, zda se má při sestavování URL k `EndPoint` připojit název kontejneru. ## Konfigurace Cloudflare Images Nastavení pluginu jsou jednoduchá a kromě hlavního přepínače povolení/zakázání se skládají ze čtyř polí. ![Obrázek](_static/cloudflare-images/cloudflare-images.png) Zásadním polem je **Delivery URL**. Musí být nakonfigurováno v následujícím specifickém formátu: ```bash https://imagedelivery.net/[account_hash]/<image_id>/<variant_name> ``` Tato URL slouží jako šablona. Plugin do ní dynamicky vloží požadované `image_id` a `variant_name`, čímž vygeneruje výsledné URL náhledů zobrazovaných na webu. ## Použití Po konfiguraci a povolení pracuje plugin automaticky na pozadí, podobně jako integrace Azure Blob storage. Bezproblémově zajišťuje: - Nahrávání nových náhledů do služby Cloudflare Images. - Nahrazení lokálních URL náhledů odpovídajícími URL Cloudflare Images na všech veřejných stránkách. --- <!-- page: Plugin s přístupem k datům | url: http://nopdocs.service.hedr.dev/cs/developer/plugins/plugin-with-data-access.html | source: cs/developer/plugins/plugin-with-data-access.md --> # Plugin s přístupem k datům V tomto návodu použiji architekturu pluginů nopCommerce k implementaci sledování zobrazení produktů. Než začneme s vývojem, musíte si přečíst, pochopit a dokončit níže uvedené návody. Některá vysvětlení, která byla probrána v předchozích článcích, přeskočím, ale můžete si je zopakovat pomocí uvedených odkazů. - [Návody pro vývojáře](xref:cs/developer/tutorials/index) - [Aktualizace existující entity. Jak přidat novou vlastnost.](xref:cs/developer/tutorials/update-existing-entity) - [Jak napsat plugin pro nopCommerce 5.00](xref:cs/developer/plugins/how-to-write-plugin-5.00) Začneme psát kód vrstvou přístupu k datům, přejdeme k vrstvě služeb a nakonec skončíme u vkládání závislostí (dependency injection). ## Začínáme Vytvořte nový projekt knihovny tříd „Nop.Plugin.Misc.ProductViewTracker“. Přidejte soubor `plugin.json`. > [!TIP] > > Informace o souboru `plugin.json` naleznete v článku [Soubor plugin.json](xref:cs/developer/plugins/plugin_json). Poté přidejte reference na projekty **Nop.Web.Framework**. To nám bude stačit, protože ostatní závislosti, jako **Nop.Core** a **Nop.Data**, budou připojeny automaticky ## Vrstva přístupu k datům (neboli vytváření nových entit v nopCommerce) Uvnitř jmenného prostoru „*domain*“ vytvoříme veřejnou třídu s názvem **`ProductViewTrackerRecord`**. Tato třída rozšiřuje **`BaseEntity`**, jinak je to ale velmi jednoduchý soubor. Je třeba si zapamatovat, že nemáme navigační vlastnosti (relační vlastnosti), protože framework *Linq2DB*, který používáme pro práci s databázemi, navigační vlastnosti nepodporuje. ```csharp namespace Nop.Plugin.Misc.ProductViewTracker.Domain public class ProductViewTrackerRecord : BaseEntity { public int ProductId { get; set; } public string ProductName { get; set; } public int CustomerId { get; set; } public string IpAddress { get; set; } public bool IsRegistered { get; set; } } ``` Další třídou, kterou vytvoříme, je třída builderu entity pro *FluentMigrator*. V mapovací třídě mapujeme sloupce, vztahy mezi tabulkami a databázovou tabulku. ```csharp using FluentMigrator.Builders.Create.Table; using Nop.Core.Domain.Catalog; using Nop.Core.Domain.Customers; using Nop.Data.Mapping.Builders; using Nop.Plugin.Other.ProductViewTracker.Domains; using Nop.Data.Extensions; using System.Data; namespace Nop.Plugin.Other.ProductViewTracker.Mapping.Builders public class ProductViewTrackerRecordBuilder : NopEntityBuilder<ProductViewTrackerRecord> { /// <summary> /// Apply entity configuration /// </summary> /// <param name="table">Create table expression builder</param> public override void MapEntity(CreateTableExpressionBuilder table) { //map the primary key (not necessary if it is Id field) table.WithColumn(nameof(ProductViewTrackerRecord.Id)).AsInt32().PrimaryKey() //map the additional properties as foreign keys .WithColumn(nameof(ProductViewTrackerRecord.ProductId)).AsInt32().ForeignKey<Product>(onDelete: Rule.Cascade) .WithColumn(nameof(ProductViewTrackerRecord.CustomerId)).AsInt32().ForeignKey<Customer>(onDelete: Rule.Cascade) //avoiding truncation/failure //so we set the same max length used in the product name .WithColumn(nameof(ProductViewTrackerRecord.ProductName)).AsString(400) //not necessary if we don't specify any rules .WithColumn(nameof(ProductViewTrackerRecord.IpAddress)).AsString() .WithColumn(nameof(ProductViewTrackerRecord.IsRegistered)).AsInt32(); } } ``` Další důležitou třídou pro nás bude třída migrace, která vytvoří naši tabulku přímo v databázi. Ve svém pluginu můžete vytvořit libovolný počet migrací, jediné, co musíte sledovat, je verze vaší migrace. Speciálně pro vás jsme vytvořili atribut **NopMigration**, aby to bylo snazší. Uvedením co nejúplnějšího a nejpřesnějšího data vytvoření souboru prakticky zaručíte jedinečnost čísla vaší migrace. ```csharp using FluentMigrator; using Nop.Data.Extensions; using Nop.Data.Migrations; using Nop.Plugin.Other.ProductViewTracker.Domains; namespace Nop.Plugin.Other.ProductViewTracker.Migrations [NopSchemaMigration("2020-05-27 08:40:55:1687541", "Other.ProductViewTracker base schema", MigrationProcessType.Installation)] public class SchemaMigration : ForwardOnlyMigration { public override void Up() { Create.TableFor<ProductViewTrackerRecord>(); } } ``` ## Vrstva služeb Vrstva služeb propojuje vrstvu přístupu k datům a prezentační vrstvu. Protože sdílení jakéhokoli typu odpovědnosti v kódu je špatný postup, musí být každá vrstva izolovaná. Vrstva služeb obaluje datovou vrstvu obchodní logikou a prezentační vrstva závisí na vrstvě služeb. Protože je náš úkol velmi malý, naše vrstva služeb nedělá nic jiného, než že komunikuje s repozitářem (repozitář v nopCommerce funguje jako fasáda pro kontext objektů). ```csharp using Nop.Data; using Nop.Plugin.Other.ProductViewTracker.Domains; using System; namespace Nop.Plugin.Other.ProductViewTracker.Services public interface IProductViewTrackerService { /// <summary> /// Logs the specified record. /// </summary> /// <param name="record">The record.</param> void Log(ProductViewTrackerRecord record); } namespace Nop.Plugin.Misc.ProductViewTracker.Services public class ProductViewTrackerService : IProductViewTrackerService { private readonly IRepository<ProductViewTrackerRecord> _productViewTrackerRecordRepository; public ProductViewTrackerService(IRepository<ProductViewTrackerRecord> productViewTrackerRecordRepository) { _productViewTrackerRecordRepository = productViewTrackerRecordRepository; } /// <summary> /// Logs the specified record. /// </summary> /// <param name="record">The record.</param> public virtual void Log(ProductViewTrackerRecord record) { if (record == null) throw new ArgumentNullException(nameof(record)); _productViewTrackerRecordRepository.Insert(record); } } ``` ## Vkládání závislostí Martin Fowler napsal skvělý popis vkládání závislostí neboli inverze řízení (Inversion of Control). Nebudu jeho práci opakovat; [jeho článek najdete zde](https://martinfowler.com/articles/injection.html). Vkládání závislostí spravuje životní cyklus objektů a poskytuje instance, které mohou závislé objekty používat. Nejprve musíme nakonfigurovat kontejner závislostí, aby věděl, které objekty bude řídit a jaká pravidla se mohou uplatnit při vytváření těchto objektů. ```csharp using Microsoft.AspNetCore.Builder; using Microsoft.Extensions.Configuration; using Microsoft.Extensions.DependencyInjection; using Nop.Core.Infrastructure; using Nop.Plugin.Other.ProductViewTracker.Services; namespace Nop.Plugin.Other.ProductViewTracker.Infrastructure /// <summary> /// Represents object for the configuring services on application startup /// </summary> public class NopStartup : INopStartup { /// <summary> /// Add and configure any of the middleware /// </summary> /// <param name="services">Collection of service descriptors</param> /// <param name="configuration">Configuration of the application</param> public void ConfigureServices(IServiceCollection services, IConfiguration configuration) { services.AddScoped<IProductViewTrackerService, ProductViewTrackerService>(); } /// <summary> /// Configure the using of added middleware /// </summary> /// <param name="application">Builder for configuring an application's request pipeline</param> public void Configure(IApplicationBuilder application) { } /// <summary> /// Gets order of this startup configuration implementation /// </summary> public int Order => 3000; } ``` Ve výše uvedeném kódu registrujeme různé typy objektů, aby je bylo později možné vkládat do controllerů, služeb a repozitářů. Nyní, když jsme probrali nová témata, vrátím se k některým starším, abychom mohli plugin dokončit. ## Komponenta view Vytvořme komponentu view (view component): ```csharp using Microsoft.AspNetCore.Mvc; using Nop.Core; using Nop.Plugin.Other.ProductViewTracker.Domains; using Nop.Plugin.Other.ProductViewTracker.Services; using Nop.Services.Catalog; using Nop.Services.Customers; using Nop.Web.Framework.Components; using Nop.Web.Models.Catalog; namespace Nop.Plugin.Other.ProductViewTracker.Components public class ProductViewTrackerViewComponent : NopViewComponent { private readonly ICustomerService _customerService; private readonly IProductService _productService; private readonly IProductViewTrackerService _productViewTrackerService; private readonly IWorkContext _workContext; public ProductViewTrackerViewComponent(ICustomerService customerService, IProductService productService, IProductViewTrackerService productViewTrackerService, IWorkContext workContext) { _customerService = customerService; _productService = productService; _productViewTrackerService = productViewTrackerService; _workContext = workContext; } public async Task<IViewComponentResult> InvokeAsync(string widgetZone, object additionalData) { if (!(additionalData is ProductDetailsModel model)) return Content(""); //Read from the product service var productById = await _productService.GetProductByIdAsync(model.Id); //If the product exists we will log it if (productById != null) { var currentCustomer = await _workContext.CurrentCustomerAsync(); //Setup the product to save var record = new ProductViewTrackerRecord { ProductId = model.Id, ProductName = productById.Name, CustomerId = currentCustomer.Id, IpAddress = currentCustomer.LastIpAddress, IsRegistered = await _customerService.Async(currentCustomer) }; //Map the values we're interested in to our new entity _productViewTrackerService.Log(record); } return Content(""); } } ``` ## Hlavní třída pluginu > [!IMPORTANT] > > Náš plugin implementujeme jako widget. V tomto případě nebudeme muset upravovat soubor `cshtml`. ```csharp using Nop.Services.Cms; using Nop.Services.Plugins; using Nop.Web.Framework.Infrastructure; using System.Collections.Generic; namespace Nop.Plugin.Other.ProductViewTracker public class ProductViewTrackerPlugin : BasePlugin, IWidgetPlugin { /// <summary> /// Gets a value indicating whether to hide this plugin on the widget list page in the admin area /// </summary> public bool HideInWidgetList => true; /// <summary> /// Gets a type of a view component for displaying widget /// </summary> /// <param name="widgetZone">Name of the widget zone</param> /// <returns>View component type</returns> public Type GetWidgetViewComponent(string widgetZone) { return typeof(ProductViewTrackerViewComponent); } /// <summary> /// Gets widget zones where this widget should be rendered /// </summary> /// <returns>Widget zones</returns> public Task<IList<string>> GetWidgetZonesAsync() { return Task.FromResult<IList<string>>(new List<string> { PublicWidgetZones.ProductDetailsTop }); } } ``` --- <!-- page: Plugin s přístupem k datům | url: http://nopdocs.service.hedr.dev/cs/developer/plugins/plugin-with-data-access-4.20.html | source: cs/developer/plugins/plugin-with-data-access-4.20.md --> # Plugin s přístupem k datům (4.20 a starší) V tomto návodu použiji architekturu pluginů nopCommerce k implementaci sledování zobrazení produktů. Než se pustíme do vývoje, je velmi důležité, abyste si přečetli, pochopili a úspěšně dokončili níže uvedené návody. Některá vysvětlení, která byla probrána v předchozích článcích, přeskočím, ale můžete si je zopakovat pomocí uvedených odkazů. - [Návody pro vývojáře](xref:cs/developer/tutorials/index) - [Aktualizace existující entity. Jak přidat novou vlastnost.](xref:cs/developer/tutorials/update-existing-entity) - [Jak napsat plugin pro nopCommerce 4.20](xref:cs/developer/plugins/how-to-write-plugin-4.20) Začneme programovat vrstvou pro přístup k datům, přesuneme se na servisní vrstvu a nakonec skončíme u vkládání závislostí (dependency injection). > [!NOTE] > > Praktické využití tohoto pluginu je sporné, ale nenapadla mě žádná funkce, která by nebyla součástí nopCommerce a vešla by se do článku rozumné délky. Pokud tento plugin použijete v produkčním prostředí, neposkytuji žádné záruky. Vždy mě zajímají příběhy úspěchu a rád uslyším, že článek přinesl více než jen vzdělávací hodnotu. ## Začínáme Vytvořte nový projekt knihovny tříd „Nop.Plugin.Other.ProductViewTracker“. ![plugin-with-data-access_1](_static/plugin-with-data-access/plugin-with-data-access_1.jpg) Přidejte následující složky a soubor `plugin.json`. ![plugin-with-data-access_2](_static/plugin-with-data-access/plugin-with-data-access_2.jpg) Informace o souboru `plugin.json` naleznete v článku [Soubor plugin.json](xref:cs/developer/plugins/plugin_json). Poté přidejte reference na následující projekty: Nop.Core, Nop.Data, Nop.Web.Framework ## Vrstva pro přístup k datům (neboli vytváření nových entit v nopCommerce) V jmenném prostoru „domain“ vytvoříme veřejnou třídu s názvem ProductViewTrackerRecord. Tato třída rozšiřuje BaseEntity, jinak je to ale velmi nezáživný soubor. Je třeba si zapamatovat, že všechny vlastnosti jsou označeny jako virtual, a není to jen pro zábavu. Virtuální vlastnosti jsou u databázových entit vyžadovány kvůli tomu, jak Entity Framework vytváří instance tříd a sleduje je. Další věcí, které je třeba si všimnout, je, že nemáme navigační vlastnosti (relační vlastnosti); těm se podrobněji budu věnovat později. ```csharp namespace Nop.Plugin.Other.ProductViewTracker.Domain { public class ProductViewTrackerRecord : BaseEntity { public virtual int ProductId { get; set; } public virtual string ProductName { get; set; } public virtual int CustomerId { get; set; } public virtual string IpAddress { get; set; } public virtual bool IsRegistered { get; set; } } } ``` **Umístění souborů**: Chcete-li zjistit, kde mají jednotlivé soubory být, prozkoumejte jmenný prostor a soubor podle něj vytvořte. Další třídou, kterou vytvoříme, je mapovací třída Entity Framework. V mapovací třídě mapujeme sloupce, vztahy mezi tabulkami a databázovou tabulku. ```csharp namespace Nop.Plugin.Other.ProductViewTracker.Data { public class ProductViewTrackerRecordMap : NopEntityTypeConfiguration<ProductViewTrackerRecord> { /// <summary> /// Configures the entity /// </summary> /// <param name="builder">The builder to be used to configure the entity</param> public override void Configure(EntityTypeBuilder<ProductViewTrackerRecord> builder) { builder.ToTable(nameof(ProductViewTrackerRecord)); //Map the primary key builder.HasKey(record => record.Id); //Map the additional properties builder.Property(record => record.ProductId); //Avoiding truncation/failure //so we set the same max length used in the product tame builder.Property(record => record.ProductName).HasMaxLength(400); builder.Property(record => record.IpAddress); builder.Property(record => record.CustomerId); builder.Property(record => record.IsRegistered); } } } ``` Následující třída je nejsložitější a nejdůležitější třídou ve vrstvě pro přístup k datům. Objektový kontext Entity Framework je průchozí třída, která nám poskytuje přístup k databázi a pomáhá sledovat stav entit (např. přidání, aktualizace, odstranění). Kontext se také používá ke generování databázového schématu nebo k aktualizaci existujícího schématu. Ve vlastních třídách kontextu nemůžeme odkazovat na dříve existující entity, protože tyto typy jsou již přidruženy k jinému objektovému kontextu. To je také důvod, proč v našem sledovacím záznamu nemáme složité navigační vlastnosti. ```csharp namespace Nop.Plugin.Other.ProductViewTracker.Data { public class ProductViewTrackerRecordObjectContext : DbContext, IDbContext { public ProductViewTrackerRecordObjectContext(DbContextOptions<ProductViewTrackerRecordObjectContext> options) : base(options) { } protected override void OnModelCreating(ModelBuilder modelBuilder) { modelBuilder.ApplyConfiguration(new ProductViewTrackerRecordMap()); base.OnModelCreating(modelBuilder); } public new virtual DbSet<TEntity> Set<TEntity>() where TEntity : BaseEntity { return base.Set<TEntity>(); } public virtual string GenerateCreateScript() { return Database.GenerateCreateScript(); } public virtual IQueryable<TQuery> QueryFromSql<TQuery>(string sql) where TQuery : class { throw new NotImplementedException(); } public virtual IQueryable<TEntity> EntityFromSql<TEntity>(string sql, params object[] parameters) where TEntity : BaseEntity { throw new NotImplementedException(); } public virtual int ExecuteSqlCommand(RawSqlString sql, bool doNotEnsureTransaction = false, int? timeout = null, params object[] parameters) { using (var transaction = Database.BeginTransaction()) { var result = Database.ExecuteSqlCommand(sql, parameters); transaction.Commit(); return result; } } public void Install() { //create the table this.ExecuteSqlScript(GenerateCreateScript()); } public void Uninstall() { //drop the table this.DropPluginTable(nameof(ProductViewTrackerRecord)); } public IList<TEntity> ExecuteStoredProcedureList<TEntity>(string commandText, params object[] parameters) where TEntity : BaseEntity, new() { throw new NotImplementedException(); } public IEnumerable<TElement> SqlQuery<TElement>(string sql, params object[] parameters) { throw new NotImplementedException(); } public int ExecuteSqlCommand(string sql, bool doNotEnsureTransaction = false, int? timeout = null, params object[] parameters) { throw new NotImplementedException(); } public virtual void Detach<TEntity>(TEntity entity) where TEntity : BaseEntity { throw new NotImplementedException(); } public IQueryable<TQuery> QueryFromSql<TQuery>(string sql, params object[] parameters) where TQuery : class { throw new NotImplementedException(); } public virtual bool ProxyCreationEnabled { get => ProxyCreationEnabled; set => ProxyCreationEnabled = value; } public virtual bool AutoDetectChangesEnabled { get => AutoDetectChangesEnabled; set => AutoDetectChangesEnabled = value; } } } ``` ## Spuštění aplikace Tato část registruje objektový kontext záznamu, který jsme vytvořili v předchozím kroku. ```csharp using Microsoft.AspNetCore.Builder; using Microsoft.Extensions.Configuration; using Microsoft.Extensions.DependencyInjection; using Nop.Core.Infrastructure; using Nop.Plugin.Other.ProductViewTracker.Data; using Nop.Web.Framework.Infrastructure.Extensions; namespace Nop.Plugin.Misc.RepCred.Infrastructure { /// <summary> /// Represents object for the configuring plugin DB context on application startup /// </summary> public class PluginDbStartup : INopStartup { /// <summary> /// Add and configure any of the middleware /// </summary> /// <param name="services">Collection of service descriptors</param> /// <param name="configuration">Configuration of the application</param> public void ConfigureServices(IServiceCollection services, IConfiguration configuration) { //add object context services.AddDbContext<ProductViewTrackerRecordObjectContext>(optionsBuilder => { optionsBuilder.UseSqlServerWithLazyLoading(services); }); } /// <summary> /// Configure the using of added middleware /// </summary> /// <param name="application">Builder for configuring an application's request pipeline</param> public void Configure(IApplicationBuilder application) { } /// <summary> /// Gets order of this startup configuration implementation /// </summary> public int Order => 11; } } ``` ## Servisní vrstva Servisní vrstva propojuje vrstvu pro přístup k datům a prezentační vrstvu. Protože sdílet v kódu jakýkoli typ odpovědnosti je špatný zvyk, musí být každá vrstva izolovaná. Servisní vrstva obaluje datovou vrstvu obchodní logikou a prezentační vrstva závisí na servisní vrstvě. Protože je náš úkol velmi malý, naše servisní vrstva nedělá nic jiného, než že komunikuje s repozitářem (repozitář v nopCommerce funguje jako fasáda objektového kontextu). ```csharp namespace Nop.Plugin.Other.ProductViewTracker.Services { public interface IProductViewTrackerService { /// <summary> /// Logs the specified record. /// </summary> /// <param name="record">The record.</param> void Log(ProductViewTrackerRecord record); } } namespace Nop.Plugin.Other.ProductViewTracker.Services { public class ProductViewTrackerService : IProductViewTrackerService { private readonly IRepository<ProductViewTrackerRecord> _productViewTrackerRecordRepository; public ViewTrackingService(IRepository<ProductViewTrackingRecord> productViewTrackerRecordRepository) { _productViewTrackerRecordRepository = productViewTrackerRecordRepository; } /// <summary> /// Logs the specified record. /// </summary> /// <param name="record">The record.</param> public virtual void Log(ProductViewTrackerRecord record) { if (record == null) throw new ArgumentNullException(nameof(record)); _productViewTrackerRecordRepository.Insert(record); } } } ``` ## Vkládání závislostí (Dependency Injection) Martin Fowler napsal skvělý popis vkládání závislostí neboli obrácení řízení (Inversion of Control). Nebudu jeho práci opakovat, jeho článek najdete zde. Vkládání závislostí spravuje životní cyklus objektů a poskytuje instance, které mohou používat závislé objekty. Nejprve musíme nakonfigurovat kontejner závislostí, aby věděl, které objekty bude řídit a jaká pravidla se mohou vztahovat na vytváření těchto objektů. ```csharp namespace Nop.Plugin.Other.ProductViewTracker.Infrastructure { public class DependencyRegistrar : IDependencyRegistrar { private const string CONTEXT_NAME = "nop_object_context_product_view_tracker"; public virtual void Register(ContainerBuilder builder, ITypeFinder typeFinder, NopConfig config) { builder.RegisterType<ProductViewTrackerService>().As<IProductViewTrackerService>().InstancePerLifetimeScope(); //data context builder.RegisterPluginDataContext<ProductViewTrackerRecordObjectContext>(CONTEXT_NAME); //override required repository with our custom context builder.RegisterType<EfRepository<ProductViewTrackerRecord>>() .As<IRepository<ProductViewTrackerRecord>>() .WithParameter(ResolvedParameter.ForNamed<IDbContext>(CONTEXT_NAME)) .InstancePerLifetimeScope(); } public int Order => 1; } } ``` Ve výše uvedeném kódu registrujeme různé typy objektů, aby je bylo možné později vložit do controllerů, služeb a repozitářů. Nyní, když jsme probrali nová témata, se vrátím k některým starším, abychom mohli plugin dokončit. ## Komponenta view Vytvořme komponentu view (view component): ```csharp namespace Nop.Plugin.Other.ProductViewTracker.Components { [ViewComponent(Name = "ProductViewTracker")] public class ProductViewTrackerViewComponent : NopViewComponent { private readonly IProductService _productService; private readonly IProductViewTrackerService _productViewTrackerService; private readonly IWorkContext _workContext; public ProductViewTrackerViewComponent(IWorkContext workContext, IProductViewTrackerService productViewTrackerService, IProductService productService) { _workContext = workContext; _productViewTrackerService = productViewTrackerService; _productService = productService; } public IViewComponentResult Invoke(int productId) { //Read from the product service Product productById = _productService.GetProductById(productId); //If the product exists we will log it if (productById != null) { //Setup the product to save var record = new ProductViewTrackerRecord(); record.ProductId = productId; record.ProductName = productById.Name; record.CustomerId = _workContext.CurrentCustomer.Id; record.IpAddress = _workContext.CurrentCustomer.LastIpAddress; record.IsRegistered = _workContext.CurrentCustomer.IsRegistered(); //Map the values we're interested in to our new entity _productViewTrackerService.Log(record); } return Content(""); } } } ``` ## Instalátor pluginu ```csharp namespace Nop.Plugin.Other.ProductViewTracker { public class ProductViewTrackerPlugin : BasePlugin { private readonly ProductViewTrackerRecordObjectContext _context; public ProductViewTrackerPlugin(ProductViewTrackerRecordObjectContext context) { _context = context; } public override void Install() { _context.Install(); base.Install(); } public override void Uninstall() { _context.Uninstall(); base.Uninstall(); } } } ``` ## Použití Sledovací kód je třeba přidat do souborů `ProductTemplate.Simple.cshtml` a `ProductTemplate.Grouped.cshtml`. Jde o šablony produktů. ```csharp @await Component.InvokeAsync("ProductViewTrackerIndex", new { productId = Model.Id }) ``` P.S. Můžete jej implementovat také jako widget. V takovém případě nebudete muset upravovat soubor cshtml. --- <!-- page: Jak přidat položku menu do administrace z pluginu | url: http://nopdocs.service.hedr.dev/cs/developer/plugins/menu-item.html | source: cs/developer/plugins/menu-item.md --> # Jak přidat položku menu do administrace z pluginu (pro verzi 4.80 a vyšší) Pro přidání položek menu použijte událost **AdminMenuCreatedEvent**. Můžete použít následující ukázku kódu, kterou přidejte do souboru `*.cs` svého pluginu. Do této metody můžete také vložit libovolnou bezpečnostní logiku (ACL). Například ověřit, zda má aktuální zákazník oprávnění „Spravovat pluginy“ (Manage plugins). ```csharp public class EventConsumer: IConsumer<AdminMenuCreatedEvent> { private readonly IPermissionService _permissionService; public EventConsumer(IPermissionService permissionService) { _permissionService = permissionService; } public Task HandleEventAsync(AdminMenuCreatedEvent eventMessage) { if (!await _permissionService.AuthorizeAsync(StandardPermission.Configuration.MANAGE_PLUGINS)) return; eventMessage.RootMenuItem.InsertBefore("Local plugins", new AdminMenuItem { SystemName = "YourCustomSystemName", Title = "Plugin Title", Url = eventMessage.GetMenuItemUrl("CONTROLLER_NAME", "ACTION_NAME"), IconClass = "far fa-dot-circle", Visible = true, }); return Task.CompletedTask; } } ``` > [!NOTE] > > V nopCommerce verze 4.70 a nižší se menu administrace sestavuje ze souboru *sitemap.config*, který se nachází ve *složce ~/Areas/Admin*. > > Chcete-li dosáhnout téhož, můžete použít následující ukázkový kód, který je potřeba přidat do souboru `*.cs` vašeho pluginu. Nejprve v hlavní třídě pluginu implementujte rozhraní *IAdminMenuPlugin*. > >```csharp > public class CustomPlugin : BasePlugin, IAdminMenuPlugin > { > > public Task ManageSiteMapAsync(SiteMapNode rootNode) > { > var menuItem = new SiteMapNode() > { > SystemName = "YourCustomSystemName", > Title = "Plugin Title", > ControllerName = "ControllerName", > ActionName = "List", > IconClass = "far fa-dot-circle", > Visible = true, > RouteValues = new RouteValueDictionary() { { "area", AreaNames.Admin } }, > }; > var pluginNode = rootNode.ChildNodes.FirstOrDefault(x => x.SystemName == "Third party plugins"); > if(pluginNode != null) > pluginNode.ChildNodes.Add(menuItem); > else > rootNode.ChildNodes.Add(menuItem); > > return Task.CompletedTask; > } >} > > ``` --- <!-- page: Přidání souborů prostředků CSS a JS do pluginu nopCommerce | url: http://nopdocs.service.hedr.dev/cs/developer/plugins/resource-files.html | source: cs/developer/plugins/resource-files.md --> # Přidání souborů prostředků CSS a JS do pluginu nopCommerce Aby se soubory prostředků načetly správně, musíte do souborů view svého pluginu přidat odkazy na ně. Můžete použít pomocné metody `AddScriptParts()` nebo `AddCssFileParts()` z `INopHtmlHelper`. - `@NopHtml.AddCssFileParts()` - `@NopHtml.AddScriptParts()` Další podrobnosti o těchto metodách zjistíte tak, že ve svém projektu nopCommerce přejdete na jejich definici. ```js //Loading CSS file @NopHtml.AddCssFileParts("~/Plugins/{PluginName}/Content/{CSSFileName.Css}", excludeFromBundle: false); //Loading js file //Third parameter value indicating whether to exclude this script from bundling @NopHtml.AddScriptParts(ResourceLocation.Footer, "~/Plugins/{PluginName}/Scripts/{JSFileName.js}", excludeFromBundle: true); ``` Pokud chcete přidat odkaz na prostředek do hlavičky, můžete použít **ResourceLocation.Head**, a pro patičku **ResourceLocation.Footer**. Co když ale chcete na stránku přidat externí skripty? V takovém případě musíte Tag Helper vypnout na úrovni elementu pomocí znaku pro vyřazení z Tag Helperu („!“): ```js <!script async src="https://www.googletagmanager.com/gtag/js"></!script> ``` > [!NOTE] > > Pokud z nějakého důvodu chcete, aby se váš skript vygeneroval na místě, kam jste jej přidali, musíte v tomto případě také použít `!` v atributu `script`, aby jej nezpracoval vestavěný tag helper. Pokud chcete zadané prostředky umístit do značky `head` stránky, musíte přidat následující kód: ```js @NopHtml.GenerateScripts(ResourceLocation.Head) ``` Obdobně, pokud potřebujete prostředky přesunout do `Footer`: ```js @NopHtml.GenerateScripts(ResourceLocation.Footer) ``` Pokud potřebujete na stránku pouze přidat svůj kód `js`, zde je příklad, jak to udělat. Všimněte si, že umístění, kde bude kód vygenerován, je určeno v metodě tag helperu `GenerateScripts`. ```js <script> $(document).ready(function () { //enable "back top" arrow $('#backTop').backTop(); //enable tooltips $('[data-toggle="tooltip"]').tooltip({ placement: 'bottom' }); }); </script> @NopHtml.GenerateScripts(ResourceLocation.Footer) ``` --- <!-- page: Popis struktury souboru plugin.json | url: http://nopdocs.service.hedr.dev/cs/developer/plugins/plugin.json.html | source: cs/developer/plugins/plugin.json.md --> # Popis struktury souboru `plugin.json` Tento soubor obsahuje popis metainformací pluginu, které nopCommerce používá k určení, do které skupiny plugin patří, zda je plugin kompatibilní s aktuální verzí nopCommerce, jaká je verze pluginu, a k několika dalším informacím. Každý plugin nopCommerce musí tento soubor mít. ## Struktura souboru ```json { "Group": "Payment methods", "FriendlyName": "PayPal Commerce", "SystemName": "Payments.PayPalCommerce", "Version": "4.70.1", "SupportedVersions": [ "4.70" ], "Author": "nopCommerce team", "DisplayOrder": -1, "FileName": "Nop.Plugin.Payments.PayPalCommerce.dll", "Description": "" } ``` - **Group**. nopCommerce ji používá k identifikaci, vyhledávání nebo filtrování pluginů podle názvu skupiny v seznamu pluginů v nabídce `Admin/Configuration/LocalPlugin`. Může to být název vaší společnosti. - **FriendlyName**. Zobrazovaný název pluginu. Slouží k identifikaci našeho pluginu v seznamu pluginů. - **SystemName**. nopCommerce jej používá k jednoznačné identifikaci pluginu, proto se musí lišit od všech ostatních pluginů. Nelze zaregistrovat více než jeden plugin se stejným `SystemName`. - **Version**. Číslo verze pluginu, které můžete nastavit na libovolnou hodnotu. Toto číslo slouží k identifikaci verze pluginu, která je aktuálně nainstalována v aplikaci nopCommerce. Doporučujeme však dodržovat následující formát – `"{nopCommerce_version_number}.{build_number}"`. - **SupportedVersions**. Jde o pole řetězců. Obsahuje jednu nebo více verzí nopCommerce, na kterých je tento plugin podporován, neboli pro které je plugin určen. Během vývoje zajistěte, aby byla v tomto seznamu uvedena aktuální verze nopCommerce, ve které plugin vyvíjíte, jinak se plugin v seznamu pluginů nenačte. - **Author**. Informace o tvůrci pluginu. Může to být jméno osoby, název společnosti nebo tým, který plugin vytvořil. - **DisplayOrder**. Slouží k nastavení pořadí, ve kterém se má plugin zobrazovat v seznamu pluginů. Jeho hodnota je typu číslo. - **FileName**. Má následující formát **Nop.Plugin.{Group}.{Name}.dll** (jde o název souboru sestavení (assembly) vašeho pluginu). - **Description**. Obsahuje krátký popis vašeho pluginu, například o čem plugin je a co dělá. Zobrazuje se v seznamu pluginů pod názvem pluginu. - **LimitedToStores** – Seznam identifikátorů obchodů, ve kterých je tento plugin k dispozici. Je-li prázdný, je plugin k dispozici ve všech obchodech. - **LimitedToCustomerRoles** – Seznam identifikátorů rolí zákazníků, pro které je tento plugin k dispozici. Je-li prázdný, je plugin k dispozici pro všechny. - **DependsOnSystemNames** – Seznam systémových názvů pluginů, na kterých tento plugin závisí. > [!TIP] > > Po úpravě obsahu souboru **plugin.json** je třeba nastavit hodnotu jeho vlastnosti `Copy to Output Directory` na `Copy if newer`. > ![obrázek3](_static/plugin.json/plugin_json_0.jpg) > Je to nutné, protože tento soubor musí být zkopírován do kompilovaného adresáře, odkud k němu nopCommerce může přistupovat a zobrazit náš plugin v seznamu pluginů v administraci. ## Příklady - Plugin **FixedOrByCountryStateZip** má následující soubor `plugin.json`: ```json { "Group": "Tax providers", "FriendlyName": "Manual (Fixed or By Country/State/Zip)", "SystemName": "Tax.FixedOrByCountryStateZip", "Version": "4.70.1", "SupportedVersions": [ "4.70" ], "Author": "nopCommerce team", "DisplayOrder": 1, "FileName": "Nop.Plugin.Tax.FixedOrByCountryStateZip.dll", "Description": "This plugin allow to configure fix tax rates or tax rates by countries, states and zip codes" } ``` - Widget **Google Analytics** má následující soubor *plugin.json*: ```json { "Group": "Widgets", "FriendlyName": "Google Analytics", "SystemName": "Widgets.GoogleAnalytics", "Version": "4.70.1", "SupportedVersions": [ "4.70" ], "Author": "nopCommerce team, Nicolas Muniere", "DisplayOrder": 1, "FileName": "Nop.Plugin.Widgets.GoogleAnalytics.dll", "Description": "This plugin integrates with Google Analytics. It keeps track of statistics about the visitors and ecommerce conversion on your website" } ``` --- <!-- page: Příručka pro designéry | url: http://nopdocs.service.hedr.dev/cs/developer/design/index.html | source: cs/developer/design/index.md --> # Příručka pro designéry * [Přehled (Příručka pro designéry)](xref:cs/developer/design/overview) * [Instalace / použití motivu v nopCommerce](xref:cs/developer/design/installing-theme) * [Vytvoření / napsání vlastního motivu (s využitím aktuálního / výchozího motivu)](xref:cs/developer/design/new-theme) * [Porozumění layoutu / designu](xref:cs/developer/design/understanding-layout) * [Přizpůsobení motivů nopCommerce](xref:cs/developer/design/customizing-theme) * [Motiv zprava doleva](xref:cs/developer/design/right-to-left-theme) * [Widgety (Příručka pro designéry)](xref:cs/developer/design/widgets) * [Responzivní design](xref:cs/developer/design/responsive) * [Tipy a triky](xref:cs/developer/design/tips-and-tricks) * [Přispění motivem](xref:cs/developer/design/contributing-theme) * [Systém událostí entit](xref:cs/developer/design/entity-events-system) --- <!-- page: Přehled (Příručka pro designéry) | url: http://nopdocs.service.hedr.dev/cs/developer/design/overview.html | source: cs/developer/design/overview.md --> # Přehled (Příručka pro designéry) ## Co je téma Téma je kolekce nastavení vlastností, která umožňují definovat vzhled stránek a ovládacích prvků a poté tento vzhled konzistentně použít napříč stránkami webové aplikace, v celé webové aplikaci nebo ve všech webových aplikacích na serveru. Témata se skládají ze sady prvků: skinů, kaskádových stylů (CSS), obrázků a dalších prostředků. Téma obsahuje minimálně skiny. Témata jsou definována ve speciálních adresářích na vašem webu nebo webovém serveru. Téma může obsahovat také kaskádový styl (soubor `.CSS`). Když umístíte soubor `.CSS` do složky tématu, styl se automaticky použije jako součást tématu. Styl definujete pomocí souboru s příponou `.CSS` ve složce tématu. (Zdroj: [msdn.microsoft.com](https://msdn.microsoft.com)) ## Definice tématu nopCommerce Téma nopCommerce slouží k zajištění jednotného rozvržení a vzhledu na všech stránkách nebo na celém webu. Téma nopCommerce se skládá z několika podpůrných souborů, včetně stylů určujících vzhled stránek a podpůrných obrázků. ![umístění témat](_static/overview/location-of-themes.png) **Umístění témat v nopCommerce**: Všechna témata se nacházejí ve složce `[nopCommerce root folder]/Themes/`. --- <!-- page: Instalace / použití motivu v nopCommerce | url: http://nopdocs.service.hedr.dev/cs/developer/design/installing-theme.html | source: cs/developer/design/installing-theme.md --> # Instalace / použití motivu v nopCommerce Předpokládejme, že jste si právě stáhli nový motiv, který je v souboru zip. 1. Rozbalte obsah souboru zip a zkopírujte jej do složky „Themes“, jak je znázorněno na obrázku níže: ![rozbalení motivu](_static/installing-theme/extracting-theme.jpg) 1. Přejděte do administrace (`http://www.yourdomain.com/admin`) 1. Přejděte do **Konfigurace → Nastavení → Obecná nastavení** (Configuration → Settings → General And Miscellaneous settings) 1. Vyberte nový motiv v poli **Výchozí motiv obchodu** (Default Store Theme) a klikněte na **Uložit** (Save). Nyní přejděte do veřejné části obchodu. Na svém webu byste měli vidět nový motiv. --- <!-- page: Vytvoření / napsání vlastního motivu (s využitím aktuálního / výchozího motivu) | url: http://nopdocs.service.hedr.dev/cs/developer/design/new-theme.html | source: cs/developer/design/new-theme.md --> # Vytvoření / napsání vlastního motivu (s využitím aktuálního/výchozího motivu) Otevřete svou solution nopCommerce nebo web (webovou verzi) v Microsoft Visual Studiu – přejděte do tohoto umístění: * Pokud používáte zdrojový kód: `\Nop.Web\Themes\` * Pokud používáte webovou verzi: `\[Project Root]\Themes\` 1. Vyberte libovolný výchozí / aktuální motiv ![krok-1](_static/new-theme/new-theme-step-1.jpg) 1. Nyní klikněte pravým tlačítkem na motiv → vyberte **COPY** (Kopírovat) ![krok-2](_static/new-theme/new-theme-step-2.jpg) 1. Nyní vyberte složku „Theme“ → klikněte pravým tlačítkem → **PASTE** (Vložit) ![krok-3](_static/new-theme/new-theme-step-3.jpg) 1. Získáte něco jako „Copy of default/current theme“ ![krok-4](_static/new-theme/new-theme-step-4.jpg) 1. Přejmenujte ji – na cokoli, co má být názvem vašeho nového motivu – například: MyFirstTheme ![krok-5](_static/new-theme/new-theme-step-5.jpg) 1. Nyní ve složce nového motivu „MyFirstTheme“ → otevřete `theme.json` ![krok-6](_static/new-theme/new-theme-step-6.jpg) 1. Změňte název aktuálního/stávajícího motivu na název nového motivu „MyFirstTheme“ ![krok-7](_static/new-theme/new-theme-step-7.jpg) 1. Nyní ve složce nového motivu **„MyFirstTheme“ → Content → Images** přidejte do adresáře „images“ své nové obrázky a začněte aktualizovat/přizpůsobovat svůj `style.css` podle svých požadavků. Pokud chcete změny otestovat → přejděte do administrace → použijte svůj nový motiv → uložte změnu a prohlédněte si veřejnou část obchodu. ![krok-8](_static/new-theme/new-theme-step-8.jpg) --- <!-- page: Porozumění rozvržení / designu | url: http://nopdocs.service.hedr.dev/cs/developer/design/understanding-layout.html | source: cs/developer/design/understanding-layout.md --> # Porozumění rozvržení / designu Co jsou rozvržení (layouty)? Každý webový vývojář či designér chce zachovat konzistentní vzhled a chování na všech stránkách webu. Kdysi byl v ASP.NET 2.0 představen koncept „Master Pages“, který pomáhá udržovat konzistentní vzhled webu jeho propojením se stránkami .aspx. Razor podporuje obdobný koncept prostřednictvím funkce zvané „Layouts“. Umožňuje definovat společnou šablonu webu a její vzhled a chování pak zdědit ve všech view/stránkách vašeho webu. V nopCommerce existují 2 různé druhy rozvržení: * `_ColumnsOne.cshtml` * `_ColumnsTwo.cshtml` Obě tato rozvržení dědí z jednoho hlavního rozvržení s názvem `_Root.cshtml`. Samotný `_Root.cshtml` dědí z `_Root.Head.cshtml`. `_Root.Head.cshtml` je soubor, do kterého se musíte podívat, pokud připojujete šablony stylů CSS a soubory jQuery (zde můžete přidat/připojit další soubory `.css` a `.js`). Všechna tato rozvržení se v nopCommerce nacházejí v umístění: `[nopCommerce root directory]/Views/Shared/...`. Pokud používáte verzi se zdrojovým kódem, pak: `\Presentation\Nop.Web\Views\Shared\...` * **Rozvržení _Root.cshtml** ![root-layout](_static/understanding-layout/root-layout.jpg) * **Rozvržení `_Root.cshtml` (z hlediska tříd CSS)** ![root-layout-css](_static/understanding-layout/root-layout-css.jpg) Následující 2 rozvržení nyní přepisují tělo (body) `_Root.cshtml`: * `_ColumnsOne.cshtml` V tomto případě nedochází ke změně rozvržení těla, takže struktura zůstává v podstatě stejná jako u `_Root.cshtml`: ![columns-one](_static/understanding-layout/column-one.jpg) * `_ColumnsTwo.cshtml` V tomto případě má struktura těla 2 sloupce: ![column-two](_static/understanding-layout/column-two.jpg) --- <!-- page: Přizpůsobení šablon nopCommerce | url: http://nopdocs.service.hedr.dev/cs/developer/design/customizing-theme.html | source: cs/developer/design/customizing-theme.md --> # Přizpůsobení šablon nopCommerce ## Nahrání loga obchodu Logo obchodu lze na web nopCommerce nahrát 2 způsoby: ### První způsob Nahrajte logo prostřednictvím administrace. Postup najdete v článku [Nahrání loga](xref:cs/getting-started/design-your-store/uploading-your-logo). ### Druhý způsob 1. Přejděte v kořenové složce nopCommerce do `/Themes/YOUR THEME/Content/images/` 1. Najděte obrázek logo.png 1. Nahraďte `logo.png` logem svého obchodu a pojmenujte jej `logo.png` (se stejnou šířkou 250px a výškou 50px) Pokud chcete v šabloně stylů provést změny týkající se loga, vyhledejte v souboru `styles.css` následující kód: ```css .header-logo { margin: 0 0 20px; text-align: center; } .header-logo a { display: inline-block; max-width: 100%; line-height: 0; /*firefox line-height bug fix*/ } .header-logo a img { max-width: 100%; opacity: 1; } ``` > [!IMPORTANT] > > Abyste viděli změny (nové logo obchodu), možná bude nutné vymazat mezipaměť prohlížeče (nebo obnovit stránku klávesami Ctrl+F5). ## Jak změnit rozvržení 1. Pokud chcete přizpůsobit/upravit základní rozvržení (tj. `_Root.cshtml`) svého webu nopCommerce, vyhledejte v souboru `styles.css` tento kód CSS ```css .master-wrapper-content { position: relative; z-index: 0; width: 90%; margin: 0 auto; } .master-column-wrapper { position: relative; z-index: 0; } .master-column-wrapper:after { content: ""; display: block; clear: both; } ``` 1. Pokud chcete přizpůsobit/upravit rozvržení `_ColumnOne.cshtml`, vyhledejte v souboru `style.css` tento kód CSS ```css .center-1 { margin: 0 0 100px; } ``` 1. Pokud chcete přizpůsobit/upravit rozvržení `_ColumnTwo.cshtml`, vyhledejte v souboru `style.css` tento kód CSS ```css .center-2, .side-2 { margin: 0 0 50px; } .side-2:after { content: ""; display: block; clear: both; } ``` ## Jak upravit menu v záhlaví (horní menu) 1. Pokud chcete přizpůsobit/upravit menu v záhlaví (horní menu) svého webu nopCommerce, přejděte do následujícího umístění: Přejděte v kořenové složce nopCommerce do `/Views/Shared/Components/TopMenu/Default.cshtml` 1. Otevřete soubor `Default.cshtml` – podle potřeby můžete přidávat nebo odebírat položky menu v `<li>`. ## Jak upravit zápatí (nebo odkazy v zápatí) 1. Pokud chcete přizpůsobit/upravit zápatí (nebo odkazy v zápatí) svého webu nopCommerce, přejděte do následujícího umístění: Přejděte v kořenové složce nopCommerce do `/Views/Shared/Components/Footer/Default.cshtml` 1. Otevřete soubor `Default.cshtml` – podle potřeby můžete přidávat nebo odebírat odkazy v `<li>` nebo celé `<ul>`. --- <!-- page: Šablona zprava doleva | url: http://nopdocs.service.hedr.dev/cs/developer/design/right-to-left-theme.html | source: cs/developer/design/right-to-left-theme.md --> # Šablona zprava doleva nopCommerce podporuje také RTL (zprava doleva) verzi šablony veřejné části obchodu. Výchozí šablona veřejné části obchodu nopCommerce **DefaultClean** obsahuje šablonu stylů pro verzi zprava doleva. Chcete-li povolit verzi šablony „zprava doleva“, přejděte do `Administration → Configuration → Languages`, klikněte na **Upravit** (Edit) u jazyka a ujistěte se, že je povolena možnost **Zprava doleva** (Right-to-Left). ![rtm-settings](_static/right-to-left-theme/rtm-settings.png) Pokud se nyní podíváte na veřejnou část obchodu, bude vypadat takto: ![rtm-public](_static/right-to-left-theme/rtm-public.jpg) Styly používané pro podporu RTL jsou umístěny v souboru `styles.rtl.css`. ![rtm-css](_static/right-to-left-theme/rtm-css.jpg) --- <!-- page: Widgety (příručka pro designéry) | url: http://nopdocs.service.hedr.dev/cs/developer/design/widgets.html | source: cs/developer/design/widgets.md --> # Widgety (příručka pro designéry) > Widget je samostatná aplikace, kterou může libovolný uživatel vložit do stránky na webu třetí strany. Je to malá aplikace, kterou může koncový uživatel nainstalovat a spustit v rámci webové stránky. (Wikipedie). V nopCommerce umožňuje widget plugin vložit kód/aplikaci třetí strany do veřejného obchodu v určitých oblastech (například do tagu head, za tag body, do bloku levého sloupce a do bloku pravého sloupce). V současné době výchozí instalace nopCommerce umožňuje administrátorovi obchodu vložit několik widget pluginů: 1. Google Analytics 1. Swiper 1. Facebook Pixel ## Widget Google Analytics Google Analytics je bezplatný nástroj od Googlu pro statistiky webu. Sleduje statistiky o návštěvnících a e-commerce konverzích na vašem webu. Tento blok widgetu lze vykreslit: * V HTML tagu záhlaví (Header) * Za koncovým HTML tagem `<body>`. Chcete-li nakonfigurovat widget Google Analytics, přejděte do `Administration → Configuration → Widgets`, klikněte na **Konfigurovat** (Configure) u položky **Google Analytics** a přidejte svůj kód Google Analytics. ## Swiper Swiper je pěkný a čistý jquery slider obrázků pro váš web/domovskou stránku, který zobrazuje několik rolujících obrázků s jedinečnými přechodovými efekty. Ve výchozím nastavení je nopCommerce dodáván s integrací Swiper jako widgetem (ve výchozím nastavení povoleným), který vám umožňuje zobrazit na domovské stránce několik automaticky rolujících obrázků. ## Facebook Pixel *Facebook Pixel* je analytický nástroj, který sleduje, jak se uživatelé na webu chovají: jaké stránky navštěvují, na jaká tlačítka a odkazy klikají, jaké formuláře vyplňují a další akce. Umožňuje vám vytvářet publika pro reklamní kampaně na Facebooku. --- <!-- page: Responzivní design | url: http://nopdocs.service.hedr.dev/cs/developer/design/responsive.html | source: cs/developer/design/responsive.md --> # Responzivní design **Co je responzivní design.** Responzivní webový design je jednoduše design webu, který mění své rozvržení podle velikosti obrazovky tak, aby se obsah správně zobrazil na počítači, chytrých telefonech, tabletech i dalších mobilních zařízeních. V této definici je klíčové slovo „správně“ – v tomto kontextu „správně“ znamená konzistentně. Při práci na responzivním designu musí weboví vývojáři zajistit, aby uživatelský zážitek z webu zůstal konzistentní na všech zařízeních bez ohledu na velikost jejich obrazovky. (Zdroj: [nopCommerce Blog](https://www.nopcommerce.com/why-a-responsive-design-should-be-a-priority-for-your-business-website)) * Počet mobilních zařízení roste velmi rychle a kvůli různým velikostem a rozlišením obrazovek používají weboví vývojáři responzivní přístup k designu, aby byl uživatelský zážitek na celém webu stejný nebo podobný. * Ano, výchozí rozvržení/šablona nopCommerce podporuje responzivní design optimalizovaný pro všechny velikosti obrazovek a tento přístup je řešen pomocí media queries v CSS. Díky tomu rozvržení vašeho internetového obchodu zobrazuje obsah webu tak, že automaticky přizpůsobuje zobrazovací oblast podle velikosti obrazovky. **Zobrazení responzivního designu.** Stačí měnit velikost okna prohlížeče a postupně jej zmenšovat. Jak se bude velikost okna prohlížeče zmenšovat, uvidíte, že web nopCommerce odpovídajícím způsobem přizpůsobí obsah. ![responsive](_static/responsive/Responsive.jpg) --- <!-- page: Tipy a triky | url: http://nopdocs.service.hedr.dev/cs/developer/design/tips-and-tricks.html | source: cs/developer/design/tips-and-tricks.md --> # Tipy a triky 1. Jedním z hlavních problémů při vývoji/návrhu webu je, že různé prohlížeče používají pro různé vlastnosti CSS různé výchozí hodnoty. Při přizpůsobování nebo vytváření motivu se vždy ujistěte, že jsou vaše styly kompatibilní se všemi prohlížeči. Testujte svůj web v hlavních prohlížečích, jako jsou Edge, Firefox, Opera, Safari a Chrome. 1. Pokud při práci se styly CSS nevidíte na webu žádnou změnu – nepanikařte. Zkuste smazat historii a cookies prohlížeče a poté to zkuste znovu obnovením stránky. 1. Ujistěte se, že rozumíte rozdílu mezi id a třídami. Třídy můžete použít na více prvků, zatímco id odkazuje pouze na jeden prvek. 1. Styly CSS neumožňují začínat názvy id a tříd číslicí nebo jiným než abecedním znakem. 1. Neomezujte se pouze na značky span a div. CSS nabízí ke stylování stránky spoustu dalších / lepších funkcí. > [!TIP] > > Využijte doplněk **Firefox Developer Tools** od Mozilly. Jde o velmi užitečný nástroj, který umožňuje živě upravovat, ladit a sledovat CSS, HTML a JavaScript na libovolné webové stránce. Více se o něm dozvíte zde: [Firefox Developer Tools.](https://developer.mozilla.org/en-US/docs/Tools) > > Nebo můžete použít nástroj **Chrome DevTools**, který je součástí prohlížeče Chrome. Více se o něm dozvíte zde: [Chrome DevTools.](https://developers.google.com/web/tools/chrome-devtools) --- <!-- page: Příspěvek vlastní šablony vzhledu | url: http://nopdocs.service.hedr.dev/cs/developer/design/contributing-theme.html | source: cs/developer/design/contributing-theme.md --> # Příspěvek vlastní šablony vzhledu nopCommerce podporuje velmi aktivní komunita. Jakýkoli příspěvek je proto vysoce ceněn. Svou šablonu vzhledu (theme) nyní můžete sdílet s ostatními uživateli prostřednictvím sekce [Marketplace](https://www.nopcommerce.com/marketplace) na webu nopCommerce. Stačí přejít na stránku [Můj účet](https://www.nopcommerce.com/customer/info) a poté na kartu **Your contributions and extensions**. Kliknutím na tlačítko **Upload a new extension** nahrajete novou šablonu vzhledu. --- <!-- page: Systém událostí entit | url: http://nopdocs.service.hedr.dev/cs/developer/design/entity-events-system.html | source: cs/developer/design/entity-events-system.md --> # Systém událostí entit ## Přehled nopCommerce implementuje architekturu řízenou událostmi (event-driven), která vývojářům umožňuje přihlásit se k odběru nebo zpracovávat události vysílané vydavateli (publishery) nebo zdroji událostí, když je provedena nějaká akce/událost, a zároveň nám umožňuje provést určitou obchodní logiku, když je vyvolána konkrétní událost. V nopCommerce se můžeme přihlásit k odběru nebo naslouchat různým událostem publikovaným systémem nopCommerce, nebo dokonce můžeme napsat logiku, která událost vyšle/publikuje, a té pak lze naslouchat nebo se k jejímu odběru přihlásit. Předpokládejme například, že chceme synchronizovat údaje o zákaznících s nějakým jiným externím systémem; v takovém případě můžeme vyvolat událost, když se v našem obchodě zaregistruje nový zákazník nebo když zákazník změní svůj profil. Této události můžeme naslouchat a provést obchodní logiku, která nově vytvořeného zákazníka získá a odešle jej k synchronizaci do externí služby. A nejlepší na tom je, že to vše můžeme udělat bez změny zdrojového kódu nopCommerce. Vývojáři mohou událost buď publikovat, nebo zpracovávat: - Chce-li vývojář událost publikovat, musí získat instanci **IEventPublisher** a zavolat metodu **Publish** s příslušnými daty události. - Chce-li vývojář naslouchat události, vytvoří novou implementaci generického rozhraní **IConsumer**. Jakmile je nová implementace konzumenta vytvořena, nopCommerce ji pomocí reflexe najde a zaregistruje pro zpracování událostí. Pro události změn dat se používají tři rozšiřující metody vydavatele událostí s názvy `EntityInsertedAsync`, `EntityUpdatedAsync` a `EntityDeletedAsync` s **BaseEntity** rozšiřující rozhraní **IEventPublisher**, které odpovídají za vysílání událostí vložení, aktualizace a smazání entity. ## EntityInsertedAsync Tato rozšiřující metoda přijímá jako parametr entitu modelu typu `BaseEntity`. Používá se k publikování/vysílání události vložení entity typu `BaseEntity` při vložení nových dat. Tato rozšiřující metoda poté zavolá parametrizovaný konstruktor generické třídy EntityInsertedEvent a zpřístupní vloženou entitu prostřednictvím její vlastnosti Entity. Tu pak může vývojář odebírat/zpracovat implementací rozhraní IConsumer typu EntityInsertedEvent s typem entity, kterou jsme právě vložili, např.: `IConsumer<EntyInsertedEvent<BaseEntity>>`. Zde `BaseEntity` může být jakákoli třída modelu, která dědí od třídy `BaseEntity`. ### Implementace publisheru pro událost EntityInserted ```cs public class MyFirstPublisherClass { IEventPublisher _eventPublisher; public MyFirstPublisherClass(IEventPublisher eventPublisher) { this._eventPublisher = eventPublisher; } public async Task MyFirstProductInsertMethod(Product product) { //Logic to insert goes here await _eventPublisher.EntityInsertedAsync(product); } } ``` Ve výše uvedeném příkladu vkládáme rozhraní `IEventPublisher`, abychom pomocí mechanismu dependency injection přes konstruktor získali instanci třídy EventPublisher. V metodě `MyFirstProductInsertMethod` po dokončení logiky vložení produktu voláme metodu `EntityInserted` s generickým typem `Product` (který musí dědit od třídy BaseEntity) a nově vytvořeným objektem produktu jako parametrem. Zavoláním této rozšiřující metody se vyšle událost vložení entity pro typ produkt a kdokoli, kdo tuto událost odebírá/jí naslouchá, obdrží tento objekt produktu jako parametr události. Nyní se podívejme, jak tuto událost zpracovat. ### Implementace konzumenta pro událost EntityInserted ```cs public class MyFirstConsumerClass : IConsumer<EntityInsertedEvent<Product>> { public async Task HandleEventAsync(EntityInsertedEvent<Product> insertEvent) { //you can access entity using insertEvent.Entity var insertedEntity = insertEvent.Entity; //Here goes the business logic you want to perform... } } ``` Zde vytváříme třídu, která dědí od `IConsumer<EntityInsertedEvent<Product>>`. Rozhraní `IConsumer` má pouze jednu metodu, kterou je třeba implementovat, a to metodu `HandleEvent`. Kdykoli je nyní vyvolána událost EntityInserted typu Product, zavolá se tato metoda `HandleEvent` s objektem `EntityInsertedEvent` entity typu produkt. A zde uvnitř této třídy můžeme provést svou obchodní logiku pro další zpracování těchto dat. ## EntityUpdatedAsync Tato rozšiřující metoda rozhraní `IEventPublisher` je implementována stejným způsobem jako EntityInserted. Rovněž přijímá jako argument/parametr entitu modelu typu `BaseEntity`. Používá se k publikování/vysílání události aktualizace entity typu `BaseEntity` při aktualizaci existující entity. Tato rozšiřující metoda zavolá parametrizovaný konstruktor generické třídy `EntityUpdatedEvent` a zpřístupní aktualizovanou entitu prostřednictvím její vlastnosti Entity. Tu pak může vývojář odebírat/zpracovat implementací rozhraní IConsumer typu `EntityUpdatedEvent` s typem `Entity`, kterou jsme právě vložili, např.: `IConsumer<EntityUpdatedEvent<BaseEntity>>`. ### Implementace publisheru pro událost EntityUpdated ```cs public class MyFirstPublisherClass { IEventPublisher _eventPublisher; public MyFirstPublisherClass(IEventPublisher eventPublisher) { this._eventPublisher = eventPublisher; } public async Task MyFirstProductUpdateMethod(Product product) { //Logic to insert goes here await _eventPublisher.EntityUpdatedAsync(product); } } ``` Implementace této třídy je v podstatě stejná jako v příkladu u `EntityInserted`. V metodě `MyFirstProductInsertMethod` po dokončení logiky aktualizace produktu voláme metodu `EntityUpdatedAsync` s generickým typem a právě aktualizovaným objektem produktu jako parametrem. Zavoláním této rozšiřující metody se vyšle událost aktualizace entity pro typ produkt a kdokoli, kdo tuto událost odebírá/jí naslouchá, obdrží tento objekt produktu jako parametr události. Nyní se podívejme, jak tuto událost zpracovat. ### Implementace konzumenta pro událost EntityUpdated ```cs public class MyFirstConsumerClass : IConsumer<EntityUpdatedEvent<Product>> { public async Task HandleEventAsync(EntityUpdatedEvent<Product> updateEvent) { //you can access entity using updateEvent.Entity var updatedEntity = updateEvent.Entity; //Here goes the business logic you want to perform... } } ``` I toto je stejné jako třída konzumenta pro událost vložení entity. Zde vytváříme třídu, která dědí od `IConsumer<EntityUpdatedEvent<Product>>`. Kdykoli je nyní vyvolána událost `EntityUpdated` typu `Product`, zavolá se metoda `HandleEvent` této třídy s parametrem typu `EntityUpdatedEvent` s objektem entity produktu. A zde uvnitř této třídy můžeme provést svou obchodní logiku pro další zpracování těchto dat. ## EntityDeletedAsync Logika implementace této rozšiřující metody je rovněž stejná jako u rozšiřujících metod `EntityInsertedAsync` a `EntityUpdatedAsync` rozhraní `IEventPublisher`. Tato rozšiřující metoda také přijímá jako argument entitu modelu typu `BaseEntity`. Používá se k publikování/vysílání události smazání entity `BaseEntity` při smazání existující entity. Tato rozšiřující metoda zavolá konstruktor generické třídy `EntityDeletedEvent` a zpřístupní smazanou entitu prostřednictvím její vlastnosti Entity. Tu pak může vývojář odebírat/zpracovat implementací `IConsumer<EntityDeletedEvent<BaseEntity>>`. ### Implementace publisheru pro událost EntityDeleted ```cs public class MyFirstPublisherClass { IEventPublisher _eventPublisher; public ExamplePublisherClass(IEventPublisher eventPublisher) { this._eventPublisher = eventPublisher; } public async Task MyFirstProductDeleteMethod(Product product) { //Logic to insert goes here await _eventPublisher.EntityDeletedAsync(product); } } ``` Implementace této třídy je také stejná jako ve výše uvedeném příkladu. V metodě `MyFirstProductDeleteMethod` po dokončení logiky smazání produktu voláme metodu `EntityDeleted` s právě smazaným objektem produktu jako parametrem. Zavoláním této rozšiřující metody se vyšle událost smazání entity pro typ produkt a kdokoli, kdo tuto událost odebírá/jí naslouchá, obdrží tento objekt produktu jako parametr události. Nyní se podívejme, jak tuto událost zpracovat. ### Implementace konzumenta pro událost EntityDeleted ```cs public class MyFirstConsumerClass : IConsumer<EntityDeletedEvent<Product>> { public async Task HandleEventAsync(EntityDeletedEvent<Product> deleteEvent) { //you can access entity using deleteEvent.Entity var updatedEntity = deleteEvent.Entity; //Here goes the business logic you want to perform... } } ``` I toto je stejné jako třída konzumenta pro událost vložení nebo aktualizace entity. Zde vytváříme třídu, která dědí od `IConsumer<EntityDeletedEvent<Product>>`. Kdykoli je nyní vyvolána událost `EntityDeleted` typu `Product`, zavolá se metoda `HandleEvent` této třídy s parametrem typu `EntityDeletedEvent` s objektem entity produktu. A zde uvnitř této třídy můžeme provést svou obchodní logiku pro další zpracování těchto dat. --- <!-- page: Dokumentace Web API | url: http://nopdocs.service.hedr.dev/cs/developer/web-api/index.html | source: cs/developer/web-api/index.md --> # Dokumentace Web API ## Úvod [Web API](https://www.nopcommerce.com/web-api) pro nopCommerce poskytuje přístup ke všem funkcím platformy i plnou kontrolu nad databázovými entitami. Jde o RESTful API vytvořené podle [specifikace OpenAPI 3.0 (OAS)](https://swagger.io/). Pomocí nástroje, jako je Swagger UI, nebo v rámci [platformy SwaggerHub](https://swagger.io/tools/swaggerhub/) můžete svůj OAS kontrakt převést na interaktivní konzoli API, kterou mohou vývojáři používat k interakci s API a rychle se naučit, jak se má API chovat. nopCommerce nabízí sadu API, která vývojářům umožňují používat a rozšiřovat vestavěné funkce platformy. Tato API umožňují vývojářům číst a zapisovat data obchodníka, spolupracovat s jinými systémy a platformami a přidávat do nopCommerce nové funkce. ## Dostupná API (pokrytí metod) Framework Web API poskytuje integrátorům a vývojářům prostředky k používání webových služeb, které komunikují se systémem nopCommerce. ### Metody frontendu Web API Frontend vám nabízí způsob, jak implementovat nákupní možnosti nopCommerce v jakékoli aplikaci, ať už jde o web nebo mobilní aplikaci. Použití API je nezbytné, když chtějí prodejci oslovit širší publikum a jejich požadavky přesahují standardní funkčnost nopCommerce. Web API Frontend poskytuje metody, které umožňují používat vestavěné funkce veřejné části obchodu mimo obchod nopCommerce. I když máte v obchodě nopCommerce vlastní úpravy, budete moci tento plugin používat, protože je dodáván se zdrojovým kódem. Po instalaci pluginu si budete moci zobrazit seznam existujících metod API pomocí následujícího endpointu Swagger UI: **`{store location}/api/index.html`** > [!TIP] > > Prostřednictvím Frontend API nelze používat vícefaktorové ověřování (MFA). ### Metody backendu Web API Backend poskytuje přístup ke všem funkcím administrace nopCommerce. To znamená, že pomocí metod Web API Backend můžete získat plnou kontrolu nad funkcemi, jako je správa zákazníků, vytváření a aktualizace produktů, sledování prodejů a vlastně čímkoli, co chcete v administraci obchodu nopCommerce ovládat. Toto API použijte k vytváření aplikací, jako jsou systémy CRM a ERP, integrace se sociálními sítěmi a další aplikace, které vyžadují přístup k obchodním procesům obchodu. Po instalaci pluginu si budete moci zobrazit seznam existujících metod API pomocí následujícího endpointu Swagger UI: **`{store location}/api/index.html`** > [!IMPORTANT] > > Po instalaci backendového a frontendového API se přepínání mezi nimi provádí přímo na stránce Swagger UI v rozbalovacím seznamu dostupných definic. > ![obrázek](./_static/index/SwaggerUI_1.png) #### Rozsahy a oprávnění Aby mohla klientská aplikace API používat, musí mít odpovídající oprávnění (ACL) v obchodě nopCommerce, kde je plugin API nainstalován. Například pro přístup k metodám backendu (administrace) prostřednictvím API je vyžadováno speciální oprávnění „Access Web API Backend“. Ve výchozím stavu je toto oprávnění přiděleno pouze roli administrátora. Tato nastavení můžete změnit prostřednictvím standardního ACL používaného v nopCommerce. ## Ověřování Aby byly transakce na platformě nopCommerce bezpečné, musí se všechny aplikace připojující se k našim API při volání API ověřit. Aby mohl klient API, například mobilní aplikace, provést volání webového API, musí prokázat svou identitu. K tomu API s každým požadavkem poskytuje přístupový token v hlavičce Authorization pomocí autorizačního schématu HTTP Bearer. Tento token funguje jako elektronický klíč, který vám umožňuje přístup k API. Po instalaci pluginu Web API je třeba na konfigurační stránce pluginu vygenerovat tajný klíč. Tento klíč bude sloužit k podepisování a ověřování každého JWT tokenu. ### Vyžádání tokenu 1. Endpoint Pro každé API existuje nezabezpečený endpoint, který slouží k získání přístupového tokenu: * **`/api-backend/Authenticate/GetToken`** * **`/api-frontend/Authenticate/GetToken`** 1. Typ obsahu Typ obsahu těla požadavku. Nastavte tuto hodnotu na `Content-Type:application/json-patch+json` 1. Přihlašovací údaje Uživatelské jméno a heslo k účtu nopCommerce. Chcete-li tyto přihlašovací údaje zadat v těle požadavku JSON, zahrňte do volání kód podobný následujícímu: ```json { "username":"<user name>", "email":"<Email>", "password":"<password>" } ``` #### Příklady Následující příklad používá příkaz curl k vyžádání tokenu pro zákaznický účet: ```rest curl -X 'POST' \ 'http://localhost:15536/api-backend/Authenticate/GetToken' \ -H 'accept: application/json' \ -H 'Content-Type: application/json-patch+json' \ -d '{ "username": "admin@yourstore.com", "email": "admin@yourstore.com", "password": "123456" }' ``` ### Odpověď s ověřovacím tokenem Úspěšný požadavek vrátí tělo odpovědi s tokenem takto: ```json { "username": "admin@yourStore.com", "customer_id": 1, "token": <authentication token> } ``` ### Použití tokenu v požadavku Web API Každé volání webového API, které přistupuje k prostředku vyžadujícímu vyšší úroveň oprávnění než anonymní, by mělo v hlavičce obsahovat ověřovací token. K tomu se HTTP hlavička odesílá v následujícím formátu: ```rest curl -X 'GET' \ 'http://localhost:15536/api-backend/BlogPost/GetById/1' \ -H 'accept: application/json' \ -H 'Authorization: <authentication token>' ``` ## Testování Pro pohodlné testování endpointů API je k dispozici *Vývojářský režim* (Developer mode). Aktivací tohoto režimu na konfigurační stránce pluginu se ověřování tokenu v podstatě vypne. API můžete testovat pomocí následujících nástrojů: 1. [Swagger UI](https://swagger.io/swagger-ui/). Nabízí webové rozhraní, které poskytuje informace o službě pomocí vygenerované specifikace OpenAPI. 1. [Postman](https://www.getpostman.com/). Jde o nástroj pro testování API. Níže najdete návod, jak pomocí nástroje Postman ověřit uživatele a získat z API JWT token a poté provést ověřený požadavek s JWT tokenem k načtení seznamu stránek (topics) z API. ### Jak ověřit uživatele pomocí nástroje Postman Chcete-li ověřit uživatele a získat JWT token, postupujte takto: 1. Otevřete kartu *nového požadavku* kliknutím na tlačítko plus (+) na konci karet. 1. Pomocí rozbalovacího výběru vlevo od vstupního pole URL změňte metodu HTTP požadavku na „POST“. 1. Do pole URL zadejte ověřovací URL svého API: **`{storeURL}/api-backend/Authenticate/GetToken`**. 1. Pod polem URL vyberte kartu „Body“, přepněte přepínač typu těla na „raw“ a pomocí rozbalovacího výběru změňte formát na „JSON (application/json)“. 1. Do textového pole „Body“ zadejte objekt JSON obsahující testovací uživatelské jméno a heslo. 1. Klikněte na tlačítko „Send“. Měli byste obdržet odpověď „200 OK“ s údaji o uživateli včetně JWT tokenu v těle odpovědi. Hodnotu tokenu zkopírujte, protože ji v dalším kroku použijeme k provedení ověřeného požadavku. Zde je snímek obrazovky nástroje Postman po odeslání požadavku a ověření uživatele: ![obrázek](./_static/index/Postman_1.png) ### Jak provést ověřený požadavek k načtení stránky (topic) podle ID Chcete-li provést ověřený požadavek pomocí JWT tokenu z předchozího kroku, postupujte takto: 1. Otevřete kartu nového požadavku kliknutím na tlačítko plus (+) na konci karet. 1. Pomocí rozbalovacího výběru vlevo od vstupního pole URL změňte metodu HTTP požadavku na „GET“. 1. Do pole URL zadejte URL „Get topic“ svého API: `{storeURL}/api-backend/Topic/GetById/:id`. 1. Pod polem URL vyberte kartu „Authorization“, v rozbalovacím výběru typu změňte typ na „Bearer Token“ a do pole „Token“ vložte JWT token z předchozího kroku ověření. ![obrázek](./_static/index/Postman_2.png) 1. Klikněte na tlačítko „Send“. Měli byste obdržet odpověď „200 OK“ obsahující pole JSON se všemi záznamy uživatelů v systému (v příkladu jen jeden testovací uživatel). Zde je snímek obrazovky nástroje Postman po provedení ověřeného požadavku na získání stránky (topic) podle ID: ![obrázek](./_static/index/Postman_3.png) ## Licence Plugin Web API je licencován za [následujících podmínek](https://www.nopcommerce.com/web-api-license-terms). --- <!-- page: Dokumentace mobilní aplikace | url: http://nopdocs.service.hedr.dev/cs/developer/mobile-app/index.html | source: cs/developer/mobile-app/index.md --> # Dokumentace mobilní aplikace ## Úvod Tým nopCommerce nabízí [mobilní aplikaci pro iOS a Android](https://www.nopcommerce.com/ecommerce-mobile-app). Přinese vašemu podnikání obrovskou hodnotu. Mobilní aplikace je zcela připravená k použití, takže můžete okamžitě začít prodávat své produkty a služby. Stejně jako platforma nopCommerce je i mobilní aplikace dodávána se zdrojovým kódem a nabízí neomezené možnosti přizpůsobení. Navíc se dokáže hladce přizpůsobit designu a funkcím vašeho internetového obchodu. K propojení aplikace s vaším obchodem nopCommerce, konfiguraci jejího obsahu a funkcí, publikaci v obchodech Google Play a App Store a ke správě jejího chodu nejsou potřeba žádné programátorské ani grafické dovednosti. Zde jsou další významné funkce, které zajistí efektivní spuštění, přizpůsobení a údržbu mobilního e-commerce: - Postaveno na nejnovější verzi Flutter a Dart - Kompatibilní s Androidem a iOS - Využívá funkce Riverpod (správa stavu) - Snadno použitelné uživatelské rozhraní a krásný Material design 3 - Autentizace založená na tokenech - Podpora internacionalizace - Podpora tmavého a světlého motivu - Ikony zdarma ## Nastavení Pomocí pluginu „nopCommerce mobile app“ lze kromě pluginu „Web API Frontend“ spravovat některá nastavení aplikace. ![obrázek](./_static/index/app_plugin.png) K dispozici jsou následující funkce: 1. Do mobilní aplikace lze přenést určitá nastavení. Je to tak záměrně, aby nebyl umožněn přístup k úplně všem nastavením aplikace. Pokud potřebujete další nastavení, musíte zajistit, aby je mobilní aplikace podporovala. 1. Ovládání slideru na hlavní obrazovce. Můžete také určit, na které produkty budou uživatelé přesměrováni po kliknutí na jednotlivé obrázky slideru. ## Visual Studio Code Doporučeným vývojovým prostředím pro Flutter je [Android Studio](https://developer.android.com/studio). Pohodlnou alternativou je editor VS Studio Code; níže jsou uvedena základní nastavení, která vám pomohou pohodlně pracovat s kódem, a také sada rozšíření nezbytných pro vývoj a ladění. ### Nastavení editoru ```json { "[dart]": { "editor.codeActionsOnSave": { "source.fixAll": true }, "editor.selectionHighlight": false, "editor.suggest.snippetsPreventQuickSuggestions": false, "editor.suggestSelection": "first", "editor.tabCompletion": "onlySnippets", "editor.wordBasedSuggestions": false, }, "dart.warnWhenEditingFilesOutsideWorkspace": false, "dart.renameFilesWithClasses": "prompt", "editor.bracketPairColorization.enabled": true, "editor.inlineSuggest.enabled": true, "editor.formatOnSave": true, "explorer.compactFolders": false, "dart.debugExternalPackageLibraries": false, "dart.debugSdkLibraries": false, "editor.minimap.enabled": false } ``` ### Rozšíření Pro vývoj budete potřebovat nainstalovat následující rozšíření: Název: **Flutter**\ Id: Dart-Code.flutter\ Popis: Podpora Flutteru a debugger pro Visual Studio Code.\ Vydavatel: Dart Code\ Odkaz na VS Marketplace: <https://marketplace.visualstudio.com/items?itemName=Dart-Code.flutter> Název: **Dart**\ Id: Dart-Code.dart-code\ Popis: Podpora jazyka Dart a debugger pro Visual Studio Code.\ Vydavatel: Dart Code\ Odkaz na VS Marketplace: <https://marketplace.visualstudio.com/items?itemName=Dart-Code.dart-code> ## Zahájení vývoje a přizpůsobení Otevřete v editoru Visual Studio Code zdrojový kód z archivu, který obdržíte po zakoupení aplikace. Ihned po otevření projektu v editoru kódu budete vyzváni ke stažení zahrnutých knihoven. Můžete to udělat i sami spuštěním následujícího příkazu v terminálu: ```bash flutter pub get ``` Nyní je potřeba zadat endpoint pro připojení k serveru kvůli přístupu k API. Toto nastavení se nachází v souboru `lib\constants\app_constants.dart`: ```dart class AppConstants { static const String storeUrl = 'https://yourstore.com'; } ``` Nyní je vše připraveno ke spuštění aplikace: ```bash flutter run ``` > [!IMPORTANT] > > Ujistěte se, že je nastavení `paymentSettings.BypassPaymentMethodSelectionIfOnlyOne` vypnuté. > > Další obecné doporučení k nastavení průběhu pokladny: nepovolujte nastavení, která vypínají nebo přeskakují kroky (například `ordersettings.disablebillingaddresscheckoutstep`). Taková nastavení nebudou mít v mobilní aplikaci žádný účinek. ## Struktura projektu Mobilní aplikace vyvinutá ve Flutteru zajišťuje funkce interakce s veřejnou částí obchodu pomocí Web API (Frontend). Všechny hlavní procesy interakce uživatele s aplikací jsou znázorněny na diagramu níže: ![obrázek](./_static/index/app_flow.png) Používá se přístup, podle kterého jsou funkce aplikace kořenovými složkami. Uvnitř takové složky pak popisujeme architektonické vrstvy příslušející této konkrétní funkci v podobě podsložek. Vše, co souvisí s funkcionalitou, která nás zajímá, se tak nachází v jedné složce, což výrazně usnadňuje pochopení kódu. ![obrázek](./_static/index/app_structure.png) ## Technologický stack Použité frameworky a knihovny: - Flutter SDK 3.35.1 - Dart SDK 3.9.0 - flutter_riverpod: 2.6.1 - go_router: 16.1.0 - flutter_secure_storage: 9.2.4 - dio: 5.9.0 > [!IMPORTANT] > > Pro správnou funkci aplikace se doporučuje používat verze balíčků uvedené v konfiguraci. ## Architektura aplikace Architektura aplikace je postavena podle obecně přijímaných standardů popsaných v [dokumentaci Androidu](https://developer.android.com/topic/architecture). Protože projekt používá systém správy stavu Riverpod, byla architektura rozšířena a vypadá takto: ![obrázek](./_static/index/app_arch.png) ## Navigace – go_router Pro navigaci v aplikaci se používá knihovna [go_router](https://pub.dev/packages/go_router). Jde o deklarativní systém směrování postavený nad [Flutter Router API](https://api.flutter.dev/flutter/widgets/Router-class.html). Navigační mapa aplikace vypadá takto: ```bash ├─/splash (SplashScreen) └─ (ShellRoute) ├─/home ├─/catalog │ ├─/catalog/category/:id (CategoryDetailsScreen) │ ├─/catalog/manufacturer/:id (ManufacturerDetailsScreen) │ ├─/catalog/vendor/:id (VendorDetailsScreen) │ ├─/catalog/productsByTag/:id (ProductsByTagScreen) │ ├─/catalog/productSearch/:q (ProductsSearchScreen) │ └─/catalog/product/:id (ProductDetailsScreen) │ ├─/catalog/product/:id/review (ProductReviewScreen) │ └─/catalog/product/:id/addReview ├─/cart │ └─/cart/checkout └─/account ├─/account/logincheckout ├─/account/login │ └─/account/login/forgotPassword (ForgotPasswordScreen) ├─/account/register ├─/account/settings ├─/account/contactUs ├─/account/wishlist (WishlistScreen) ├─/account/accountInfo (AccountInfoScreen) ├─/account/accountAddresses (AccountAddressesScreen) │ └─/account/accountAddresses/createUpdateAddress/:id teAddressScreen) ├─/account/accountOrders (AccountOrdersScreen) │ └─/account/accountOrders/orderDetails/:id (OrderDetailsScreen) ├─/account/accountDownloadableProducts nloadableProductsScreen) ├─/account/accountBackInStock (AccountBackInStockScreen) ├─/account/accountRewardPoints (AccountRewardPointsScreen) ├─/account/accountChangePassword (AccountChangePassword) ├─/account/accountProductReviews (AccountProductReviewsScreen) ├─/account/accountGdprTools (AccountGdprToolsScreen) ├─/account/accountReturnRequests (AccountReturnRequestsScreen) └─/account/returnRequest/:id (ReturnRequestScreen) ``` ## Generování klienta Web API Nainstalujte [OpenAPI Generator](https://openapi-generator.tech/) (vyžaduje [Node.js](https://nodejs.org/en/download/)) Chcete-li aktualizovat verzi OpenAPI Generatoru, použijte následující příkaz a ze zobrazeného seznamu vyberte nejnovější stabilní verzi. ```bash openapi-generator-cli version-manager list ``` Vytvořte soubor *openapitools.json*. Použijte generátor [dart-dio](https://openapi-generator.tech/docs/generators/dart-dio). ```json { "$schema": "node_modules/@openapitools/openapi-generator-cli/config.schema.json", "spaces": 2, "generator-cli": { "version": "7.14.0", "generators": { "frontend": { "input-spec": "swagger.json", "generator-name": "dart-dio", "output": "frontend_api", "additionalProperties": { "pubName": "frontend_api" } } } } } ``` > [!NOTE] > > Chcete-li aktualizovat verzi generátoru, spusťte následující příkaz: > > ```bash > openapi-generator-cli version-manager list >``` Je nutné, aby se schéma OpenAPI *swagger.json* nacházelo v adresáři s nainstalovaným generátorem. 1. Pro vygenerování klienta zavolejte následující příkaz: ```bash openapi-generator-cli generate ``` 1. Standardní openapi-generator vygeneruje pouze základní kód, který používá knihovny spoléhající na vlastní generování kódu v Dartu. Proto je po dokončení základního generování nutné spustit generátor Dartu: ```bash cd frontend_api flutter pub get dart run build_runner build -d ``` Výsledkem je hotový balíček, který se bude nacházet tam, kde jste určili v konfiguračním souboru nebo v příkazu konzole. Zbývá ho zahrnout do *pubspec.yaml*: ```yaml frontend_api: # <- nopCommerce generated api library path: lib/frontend_api ``` ## Lokalizace Chcete-li lokalizovat rozhraní samotné aplikace, je třeba umístit soubor s lokalizacemi do složky `\lib\localization`. Je důležité, aby název souboru měl následující formát: `intl_`**{your_language_code_from_server}**`.arb` Jako základ můžete vzít soubor *intl_en.arb*, který je již součástí sady, a přeložit jeho zdroje do cílového jazyka. Spusťte v terminálu následující příkaz pro vygenerování potřebných zdrojových souborů pro lokalizaci. ```bash flutter gen-l10n ``` Správnost vygenerování všech potřebných zdrojů si můžete ověřit v cestě `lib\localization\generated\i18n`. ![obrázek](./_static/index/localization.png) > [!WARNING] > > Neprovádějte v tomto souboru žádné změny, protože tato část kódu je generována automaticky. Všechny změny lokalizace by měly být prováděny výhradně v souboru `intl_`**{your_language_code_from_server}**`.arb` umístěném v cestě `\lib\localization`. Nyní bude při přepnutí jazyka v nastavení aplikace lokalizováno i rozhraní aplikace. > [!IMPORTANT] > > Kód jazyka, který bude součástí názvu lokalizačního souboru, se musí shodovat s kódem přidaným na vašem serveru. V opačném případě bude rozhraní lokalizováno výchozími lokalizacemi (tj. `en`). ## Návrh uživatelského rozhraní Abychom zachovali jednotný a konzistentní vzhled napříč zařízeními, využili jsme potenciál design tokenů, které poskytuje Material 3. Tyto tokeny umožňují ukládat styly, písma a hodnoty animací, takže můžeme používat stejné hodnoty stylů v návrhových souborech i v kódu. Používání tokenů přináší několik výhod: - Konzistence: Tokeny zajišťují konzistentní design napříč obrazovkami a komponentami. - Motivy: Snadné přepínání mezi světlým/tmavým/dynamickým motivem výměnou ColorScheme nebo ThemeData. - Udržovatelnost: Vzhled celé aplikace změníte z jednoho místa (není nutné hledat a nahrazovat kódy barev). - Spolupráce designu a vývoje: Tokeny slouží jako most mezi Figmou a Flutterem. ### Integrace tokenů z návrhových nástrojů **Material Theme Builder** (MTB) je nástroj pro designéry a vývojáře k vytváření barevných a typografických tokenů Material Design 3 (M3) a jejich exportu jako kódu (Flutter, Compose, Android XML, design tokeny atd.). Pomáhá vytvořit koordinované světlé/tmavé `ColorScheme` z výchozí/značkové barvy, zobrazit náhled komponent a exportovat artefakty připravené k implementaci. #### Vygenerování barevného schématu 1. Otevřete **[Material Theme Builder](https://m3.material.io/theme-builder)**. 1. Vyberte výchozí / primární barvu - Zadejte hexadecimální hodnotu, použijte výběr barvy nebo kapátko. Výchozí (primární) barva je jediný výchozí bod, ze kterého se generují tónové palety. ![obrázek](./_static/index/color-picker.png) - Můžete také povolit vstup *dynamické barvy* (tapeta/obrázek) nebo importovat obrázek pro extrakci barev — MTB z tohoto zdroje odvodí tónové palety. ![obrázek](./_static/index/source-image.png) 1. Zvolte nebo upravte sekundární / terciární / chybovou / neutrální barvu MTB zobrazuje pole pro běžné role (sekundární, terciární, chybová, neutrální atd.). Můžete přijmout automaticky vygenerované hodnoty nebo přepsat barvy konkrétních rolí (ručním zadáním hexadecimálních hodnot). Builder udržuje vztahy mezi rolemi v souladu s pravidly M3. ![obrázek](./_static/index/core-colors.png) Zde je potřeba vybrat základní barvy pro celé schéma. Můžete je zadat ručně, například pokud už máte definované barvy své značky. Na panelu **Dynamic** můžete nahrát obrázek a extrahovat z něj barvy. Pro generování harmonických barev se doporučuje použít službu [https://coolors.co/](https://coolors.co/). Klikněte na **Start the generator**: ![obrázek](./_static/index/make_colors.png) Přebytečné bloky můžete odstranit, dokud nezůstanou jen 3, a poté stisknutím mezerníku vygenerovat varianty. 1. Přepínejte mezi světlým a tmavým náhledem Přepínáním Light/Dark okamžitě uvidíte obě schémata; ![obrázek](./_static/index/light-scheme.png) MTB generuje párová světlá/tmavá `ColorScheme`, takže kontrast a vizuální hierarchie zůstávají zachovány v obou režimech jasu. ![obrázek](./_static/index/dark-scheme.png) 1. Náhled komponent a ploch Builder nabízí živé náhledy (app bary, tlačítka, čipy, karty, položky seznamu, navigační lišty, dialogy). Pomocí nich ověřte, jak se vaše paleta chová na plochách, v textu, ikonách a interaktivních ovládacích prvcích. ![obrázek](./_static/index/preview-components.gif) 1. Použijte sladění / harmonizaci barev Pokud máte barvy značky, které kolidují s vygenerovanými tónovými paletami, MTB nabízí režimy sladění nebo harmonizace barev, které palety posunou tak, aby ladily s odstíny značky, a přitom stále dodržovaly tónová pravidla M3. To se hodí, když začínáte s více barvami značky. ![obrázek](./_static/index/extended-colors.png) 1. Typografie Vyberte základní rodinu písma. MTB dokáže k barevným tokenům vytvořit i tokeny pro typografii (řezy, velikosti, výšky řádků). ![obrázek](./_static/index/choose-fonts.png) 1. Export Zvolte formát exportu – **Flutter (Dart)** – a poté exportujte/stáhněte ZIP s artefakty kódu a soubory tokenů. Pro Flutter builder obvykle vygeneruje soubor `theme.dart`, který můžete vložit do svého projektu. ![obrázek](./_static/index/export.png) #### Přehled souboru theme.dart Jakmile vytvoříte barevnou paletu v *Material Theme Builder* a vyexportujete ji, získáte soubor `theme.dart`. Tento soubor je výchozím bodem pro stylování vaší aplikace. Jeho hlavním obsahem jsou obvykle dva objekty `ColorScheme`: - `lightScheme`: Definuje sadu barev pro světlý motiv aplikace (např. barvy pozadí, textu a zvýraznění ve světlém režimu). - `darkScheme`: Definuje stejné barvy pro tmavý motiv. Tato schémata jsou generována na základě zvolené výchozí barvy a zajišťují harmonickou a konzistentní kombinaci barev v celé aplikaci v souladu s principy Material Design 3. #### Integrace `theme.dart` do projektu Aby struktura projektu zůstala přehledná, doporučuje se ukládat soubory související s motivem do samostatného adresáře. Nahraďte vygenerované objekty `ColorScheme` z `theme.dart` v souboru `lib/themes/material_theme.dart`. S růstem vašeho design systému můžete potřebovat zavést vlastní tokeny (např. specifické barvy značky, sémantické stavy). Použijte rozšíření (extensions). Tento kód ukazuje, které tokeny rozšíření se v mobilní aplikaci používají. ```dart ThemeData theme(ColorScheme colorScheme) => ThemeData( useMaterial3: true, brightness: colorScheme.brightness, colorScheme: colorScheme, textTheme: textTheme.apply( bodyColor: colorScheme.onSurface, displayColor: colorScheme.onSurface, ), scaffoldBackgroundColor: colorScheme.surface, canvasColor: colorScheme.surface, // defailt extensions - BEGIN extensions: [ CustomColors( subTextColor: colorScheme.onSurfaceVariant, ratingStarColor: colorScheme.secondary, pictureIndicatorColor: colorScheme.surfaceContainerHighest, pictureIndicatorCurrentColor: colorScheme.primary, inStockColor: colorScheme.tertiary, outOfStockColor: colorScheme.error, ), ], // defailt extensions - END ); ``` >[!NOTE] > > Můžete použít celý obsah souboru `theme.dart`, ale nezapomeňte zahrnout výchozí rozšíření, která jsou k dispozici v souboru `custom_color_scheme.dart`. To je vše — restartujte aplikaci a užijte si nové barevné schéma. ## Publikování v obchodě Google Play Proces vydání vaší aplikace ve Flutteru v obchodě Google Play zahrnuje přípravu, sestavení a poté nahrání aplikace do Google Play Console. Klíčové kroky: 1. Registrace vývojářského účtu Google Play: Budete se muset zaregistrovat k vývojářskému účtu. 1. Příprava aplikace k vydání: Zahrnuje konfiguraci názvu aplikace, ikony a čísla verze v souboru `pubspec.yaml` a nastavení potřebných oprávnění. 1. Podepsání aplikace: Musíte vygenerovat upload keystore a podepsat jím aplikaci, abyste ověřili svou identitu. 1. Sestavení verze pro vydání: Pomocí příkazu `flutter build appbundle` vytvořte Android App Bundle (*.aab*) vaší aplikace. 1. Publikování v Google Play Console: Vytvořte v Play Console nový záznam aplikace, vyplňte všechny požadované údaje záznamu v obchodě (název, popis, snímky obrazovky, zásady ochrany osobních údajů) a nahrajte soubor *.aab* ke kontrole. Oficiální dokumentace: [Build and release an Android app](https://docs.flutter.dev/deployment/android) ## Publikování v Apple App Store Nasazení do Apple App Store vyžaduje registraci v programu Apple Developer Program a použití Xcode ke správě závěrečných kroků procesu. Klíčové kroky: 1. Registrace do Apple Developer Program: Jde o placené roční předplatné, které vám umožní publikovat v App Store. 1. Konfigurace projektu v Xcode: Otevřete v Xcode složku `ios` vašeho projektu a nastavte Bundle ID, číslo verze a nastavení podepisování kódu. 1. Vytvoření záznamu v App Store Connect: Přihlaste se do App Store Connect a vytvořte nový záznam aplikace. Zde zadáte všechna metadata aplikace, jako je její název, popis, snímky obrazovky, klíčová slova a informace o ochraně soukromí. 1. Sestavení a archivace aplikace: Pomocí Xcode vytvořte archiv sestavení (*.ipa*) vaší aplikace. 1. Nahrání do App Store Connect: Nahrajte archivované sestavení pomocí Xcode nebo nástroje Transporter. 1. Odeslání ke kontrole: Jakmile je sestavení zpracováno a všechna metadata jsou kompletní, můžete aplikaci odeslat společnosti Apple ke kontrole. Oficiální dokumentace: [Build and release an iOS app](https://docs.flutter.dev/deployment/ios) --- <!-- page: Microsoft Dynamics 365 | url: http://nopdocs.service.hedr.dev/cs/developer/ms-dynamics-365/index.html | source: cs/developer/ms-dynamics-365/index.md --> # Microsoft Dynamics 365 [Dynamics 365](https://www.microsoft.com/en-us/dynamics-365) je portfolio inteligentních podnikových aplikací, které přináší vynikající provozní efektivitu a průlomové zákaznické zážitky a umožňuje firmám být agilnější a snižovat složitost bez navyšování nákladů. Tato sekce popisuje, jak do svého obchodu integrovat plugin Dynamics 365. Pořiďte si prosím [oficiální integraci s Dynamics 365](https://www.nopcommerce.com/microsoft-dynamics-365). ## Co plugin Dynamics 365 dělá Plugin Dynamics 365 pro nopCommerce umožňuje majiteli obchodu jednosměrně synchronizovat následující data mezi obchodem nopCommerce a Dynamics 365: - Zákazníky. - Produkty. - Objednávky. ## Připojení k Microsoft Dataverse Chcete-li synchronizovat data svého obchodu do Dynamics 365, musíte se připojit k prostředí Dataverse, k čemuž potřebujete URL prostředí a přihlašovací údaje uživatelského účtu s přístupem k tomuto prostředí. Pro připojení k Microsoft Dataverse můžete použít buď přihlašovací údaje běžného uživatele, nebo vytvořit aplikačního uživatele prostřednictvím Microsoft Entra ID. Použití přihlašovacích údajů běžného uživatele není doporučený přístup, protože by vyžadovalo placenou licenci. Toto omezení lze obejít vytvořením speciálního aplikačního uživatele, který je svázán s aplikací registrovanou v Microsoft Entra ID, a použitím tajného klíče nakonfigurovaného pro tuto aplikaci. Další výhodou tohoto přístupu je, že nevyžaduje placenou licenci. Když vytváříte klientské aplikace využívající webové služby Dataverse, musíte se pro získání přístupu k datům ověřit. Upřednostňovaným způsobem ověření je OAuth, protože poskytuje přístup ke všem webovým službám. > [!NOTE] > > Klientské aplikace musí podporovat použití OAuth pro přístup k datům prostřednictvím Web API. > OAuth vyžaduje pro ověření poskytovatele identity. Pro Dataverse je poskytovatelem identity Microsoft Entra ID. ### Požadavky na připojení jako aplikace Pro připojení jako aplikace budete potřebovat: - Registrovanou aplikaci - Uživatele Dataverse svázaného s registrovanou aplikací - Připojení pomocí tajného klíče aplikace ## Registrace aplikace Při připojení pomocí OAuth musíte nejprve zaregistrovat aplikaci ve svém tenantovi Microsoft Entra ID. Aby se aplikace mohla ověřit vůči Dataverse a získat přístup k podnikovým datům, musíte ji nejprve zaregistrovat v Microsoft Entra ID. Tato registrace aplikace se pak použije během procesu ověřování. Vytvoření klientské aplikace usnadňuje ověřování a autorizaci a můžete podle toho udělit přístupová oprávnění. ### Postup vytvoření aplikace Registrací aplikace se vytvoří vztah důvěry mezi vaší aplikací a platformou identit Microsoft. Důvěra je jednosměrná: vaše aplikace důvěřuje platformě identit Microsoft, nikoli naopak. Po vytvoření nelze objekt aplikace přesouvat mezi různými tenanty. 1. Přihlaste se do [centra pro správu Microsoft Entra](https://entra.microsoft.com/) 1. Přejděte na **Identity > Applications > App registrations a vyberte New registration**. 1. Zadejte zobrazovaný **Name** (název) vaší aplikace. 1. Určete, kdo může aplikaci používat – Accounts in any organizational directory (účty v libovolném adresáři organizace) 1. Do pole **Redirect URI (optional)** nic nezadávejte. URI přesměrování nakonfigurujete v další části. 1. Vyberte **Register** a dokončete úvodní registraci aplikace. ![obrázek](./_static/register_app.png) Po dokončení registrace zobrazí centrum pro správu Microsoft Entra podokno **Overview** (Přehled) registrace aplikace. Uvidíte **Application (client) ID**. Tato hodnota, nazývaná také *ID klienta*, jednoznačně identifikuje vaši aplikaci na platformě identit Microsoft. ![obrázek](./_static/app_overview.png) ### Konfigurace aplikace 1. Na stránce **Overview** v části **Essentials** vyberte odkaz **Add a Redirect URI**. URI přesměrování nastavíte tak, že nejprve vyberete **Add a platform**, zadáte hodnotu URI a poté vyberete **Configure**. Použijte hodnotu URI `http://localhost`. 1. Na stránce **Overview** nově vytvořené aplikace najeďte kurzorem na hodnotu **Application (client) ID** a vyberte ikonu kopírování do schránky, čímž hodnotu ID zkopírujete. Hodnotu si někam zaznamenejte. Budete ji později potřebovat. 1. Přidejte přihlašovací údaje. Přihlašovací údaje umožňují aplikaci ověřit se sama za sebe, bez nutnosti interakce uživatele za běhu. ![obrázek](./_static/app_client_secrets.png) - V centru pro správu Microsoft Entra v části **App registrations** vyberte svou aplikaci. - Vyberte **Certificates & secrets > Client secrets > New client secret**. - Přidejte popis tajného klíče klienta. - Vyberte dobu platnosti tajného klíče nebo zadejte vlastní dobu platnosti. - Doba platnosti tajného klíče klienta je omezena na dva roky (24 měsíců) nebo méně. Nelze zadat vlastní dobu platnosti delší než 24 měsíců. - Microsoft doporučuje nastavit dobu platnosti kratší než 12 měsíců. - Vyberte **Add**. > [!NOTE] > > Zaznamenejte si hodnotu tajného klíče pro použití v kódu klientské aplikace. > Tato hodnota tajného klíče se po opuštění této stránky již nikdy znovu nezobrazí. 1. Poté přejděte do **Manage > Manifest**, kde uvidíte mnoho vlastností. Nás zde zajímá **allowPublicClient**. Nastavte *allowPublicClient* na *true* a **uložte**. ![obrázek](./_static/manifest.png) 1. Nakonec v **Manage > API permissions > Add permission** vyhledejte **Dynamics CRM**, vyberte **user_impersonation** a přidejte jej. ![obrázek](./_static/api_permission.png) 1. Udělte také souhlas správce pro vaši organizaci, protože bez souhlasu správce může připojení vyvolávat chyby. ![obrázek](./_static/request_api_permission.png) ### Vytvoření nového aplikačního uživatele Podle těchto kroků vytvořte aplikačního uživatele a svažte jej s registrací aplikace. 1. Přihlaste se do [centra pro správu Power Platform](https://admin.powerplatform.microsoft.com/) pomocí účtu ve stejném tenantovi, ve kterém je registrace vaší aplikace. 1. V levém navigačním podokně vyberte **Environments** a poté v seznamu vyberte cílové prostředí, aby se zobrazily informace o prostředí. 1. Vyberte odkaz **S2S** na pravé straně stránky. ![obrázek](./_static/power_platform_admin_center_environments.png) 1. Vyberte **New app user**. 1. Ve vysouvacím panelu Create a new app user vyberte **+ Add app**. 1. Začněte do vyhledávacího pole psát název registrace aplikace a poté ji v seznamu výsledků vyberte (zaškrtněte). Dále vyberte **Add**. ![obrázek](./_static/environment_app_user.png) 1. Zpět ve vysouvacím panelu **Create a new app user** vyberte z rozbalovacího seznamu cílovou **Business unit** (obchodní jednotku) a přidejte aplikačnímu uživateli (označovanému také jako instanční objekt – service principal) roli zabezpečení. 1. Vyberte **Save** a poté **Create**. V zobrazeném seznamu aplikačních uživatelů byste měli vidět svého nového aplikačního uživatele. ![obrázek](./_static/environment_business_unit.png) 1. Nakonec se zobrazí oznámení potvrzující, že Power Apps byl úspěšně propojen s naší klientskou aplikací. ![obrázek](./_static/environment_app_user_successfull.png) ## Nastavení integrace Dynamics 365 Sales a Business Central Plugin Microsoft Dynamics 365 od nopCommerce podporuje synchronizaci se dvěma hlavními aplikacemi Dynamics 365 – Business Central a Sales. Dynamics 365 Business Central je kompletní ERP řešení pro správu financí, provozu a zásob. Dynamics 365 Sales je CRM řešení, které nabízí automatizaci prodejního procesu, přehled o chování zákazníků a sledování výkonnosti prodeje. ![obrázek](./_static/sales_hub.png) ### Propojení Microsoft Dataverse s Dynamics365 Business Central Integrace s Business Central probíhá prostřednictvím Dataverse a integrace poskytuje mnoho výchozích nastavení a tabulek. V Business Central zvolte **Settings -> Advanced settings**. ![obrázek](./_static/advanced_settings.png) > [!NOTE] > > V Business Central zvolte **Settings -> Assisted setup**. > Můžete také najít skupinu nastavení „Connect with other systems“ a dozvědět se více o možnostech integrace. > ![obrázek](./_static/assisted_setup.png) Integrace s Business Central probíhá prostřednictvím Dataverse a integrace poskytuje mnoho výchozích nastavení a tabulek. Proto musíte nejprve nakonfigurovat připojení k Dataverse. > [!WARNING] > > Nepokoušejte se nejprve připojit k *Dynamics 365 Sales*. ![obrázek](./_static/dataverse_connection_setup.png) Zvolte **Next**. ![obrázek](./_static/dataverse_connection_setup_1.png) Klikněte na „Install Bussiness Central Virtual Table“. ![obrázek](./_static/dataverse_connection_setup_2.png) Vyberte URL svého prostředí Dynamics 365 a poté zvolte **OK**. Přihlaste se pomocí uživatelského účtu správce a udělte oprávnění aplikaci, která bude použita pro připojení k Dataverse. Zvolte **Sign in with administrator user**. ![obrázek](./_static/dataverse_connection_setup_3.png) Tento odkaz můžete ověřit v [centru pro správu Power Platform](https://admin.powerplatform.microsoft.com/environments). Jakmile se *Sign in with administrator user* zobrazí zeleně a tučně, zvolte **Next**. ![obrázek](./_static/dataverse_connection_setup_3_1.png) Zvolte model vlastnictví. Doporučuje se **Team**. ![obrázek](./_static/dataverse_connection_setup_4.png) Zvolením **Finish** dokončete nastavení. ![obrázek](./_static/dataverse_connection_setup_5.png) Můžete zkusit otestovat připojení k Dataverse. Své nastavení zkontrolujete na stránce **Dataverse Connection Setup**. ![obrázek](./_static/dataverse_connection_setup_6.png) Nyní můžete v Business Central otevírat stránky Dataverse. ![obrázek](./_static/dataverse_connection_setup_7.png) ### Připojení k Dynamics 365 Sales Po dokončení nastavení integrace Dataverse můžete zahájit integraci s Dynamics 365 Sales. Na stránce **Assisted Setup** zvolte **Set up a connection to Dynamics 365 Sales**. ![obrázek](./_static/sales_connection_setup_1.png) Všechny kroky nastavení integrace jsou podobné jako u integrace s Dataverse. Musíte zadat stejné prostředí jako minule. Pokud vše proběhlo bez chyb, uvidíte, že obě vaše připojení jsou nakonfigurována a fungují správně. ![obrázek](./_static/sales_connection_setup_2.png) ![obrázek](./_static/sales_connection_setup_3.png) Nyní můžete v Business Central otevírat stránky Dynamics 365 Sales. ![obrázek](./_static/sales_connection_setup_4.png) Například **Products – Microsoft Dynamics 365 Sales**: ![obrázek](./_static/sales_connection_setup_5.png) Například **Sales Order – Microsoft Dynamics 365 Sales**: ![obrázek](./_static/sales_connection_setup_6.png) > [!NOTE] > > Aby proces integrace fungoval správně, ujistěte se, že v nastavení na stránce „All Solutions“ jsou přítomny následující řádky: > ![obrázek](./_static/sales_connection_setup_7.png) > > Položky fronty úloh (Job Queue Entries) budou vytvořeny automaticky: > ![obrázek](./_static/sales_connection_setup_8.png) ### Měna Ujistěte se, že se měny v Business Central a Dataverse shodují, abyste předešli chybám synchronizace. Ověřte to v následujících nastaveních. ![obrázek](./_static/currencies.png) Základní měnu organizace v Dynamics 365 Sales lze nastavit pouze při vytváření organizace. ![obrázek](./_static/currencies_1.png) ## Instalace pluginu Tato sekce popisuje, jak do svého obchodu integrovat službu Dynamics 365. 1. [Zakupte integraci](https://www.nopcommerce.com/microsoft-dynamics-365). 1. Stáhněte archiv pluginu. 1. Přejděte do **Administrace > Konfigurace > Místní pluginy** (Admin area > Configuration > Local plugins). 1. Nahrajte archiv pluginu pomocí tlačítka „Nahrát plugin nebo motiv“ (Upload plugin or theme). 1. Posuňte se v seznamu pluginů dolů a najděte nově nahraný plugin. 1. Kliknutím na tlačítko **Instalovat** (Install) plugin nainstalujete. ![Vyhledání pluginu](_static/plugin_list.png) ## Jak nakonfigurovat plugin Klikněte na tlačítko **Konfigurovat** (Configure). Zobrazí se okno *Konfigurace – Dynamics 365* (Configure - Dynamics 365): ![Vyhledání pluginu](_static/plugin_disconnected.png) Abyste mohli používat Dynamics 365 s nopCommerce, musíte nejprve zaregistrovat a nastavit svůj účet v MS Dynamics 365, jak bylo popsáno výše, a zadat všechna potřebná nastavení do polí konfiguračního formuláře pluginu: - **Application (client) ID**. ID klienta registrované na portálu Azure. - **Directory (tenant) ID**. ID tenanta registrované na portálu Azure. - **Client secret**. Tajný klíč klienta pro Application ID. Tajný řetězec, kterým aplikace při žádosti o token prokazuje svou identitu. - **Environment URL**. Přímá URL instance Dataverse, ke které se má připojit. - **Currency code** (Kód měny). Zobrazuje kód primární měny vašeho obchodu. > [!NOTE] > > Pokud změníte primární měnu obchodu, nastavení pluginu se aktualizuje až po jejich uložení. - **Image sync enabled** (Synchronizace obrázků povolena). Určuje, zda se mají ve výchozím nastavení synchronizovat obrázky vybraných produktů. - **Check Dynamics product exists enabled** (Kontrola existence produktu v Dynamics povolena). Když je toto nastavení povoleno, bude se při synchronizaci objednávek kontrolovat, zda v Dataverse existují záznamy o produktech obsažených v objednávce. POZOR: výrazně to zvýší provoz a negativně to ovlivní výkon. - **Enable auto synchronization** (Povolit automatickou synchronizaci). Určuje, zda povolit automatickou synchronizaci. Pokud je vypnuta, musí se synchronizace spouštět ručně na této stránce. - **Auto synchronization period** (Interval automatické synchronizace). Nastavuje interval (v minutách) automatické synchronizace. Klikněte na tlačítko **Uložit** (Save). ![Vyhledání pluginu](_static/plugin_connected.png) Přejděte do panelu **Synchronizace** (Synchronization) a synchronizujte zákazníky, produkty a objednávky nopCommerce se svým prostředím Dynamics 365. ![Vyhledání pluginu](_static/plugin_connected_sync.png) ## Synchronizace kontaktů Plugin zajišťuje počáteční import všech existujících kontaktů (zákazníků). Provádí se, když uživatel právě nainstaloval plugin a chce importovat všechny existující kontakty obchodu do Dynamics 365. Poté se přidávání a úpravy zákazníků provádějí automaticky na základě příslušné události. ![obrázek](_static/sales_hub_contacts.png) ## Synchronizace produktů Plugin zajišťuje import produktů. Podporována je synchronizace dvou typů produktů: - Jednoduché produkty - Seskupené produkty ![obrázek](_static/sales_hub_products.png) Plugin sleduje řadu událostí, o kterých informuje službu Dynamics 365: - Vytvoření produktu. - Změna produktu (navýšení množství, přidání obrázků apod.). ## Synchronizace objednávek Plugin sleduje řadu událostí, o kterých informuje službu Dynamics 365: - Vytvoření objednávky. - Zaplacení objednávky. - Zrušení objednávky. - Dokončení zpracování objednávky. - Změna stavu objednávky. ![obrázek](_static/sales_hub_orders.png) ### Scénáře změn stavů objednávek pro jejich přenos do Dynamics 365 Níže uvedený diagram znázorňuje vztah mezi změnami stavu objednávky v systému nopCoomerce a Dynamcs 365. ![Vyhledání pluginu](_static/Dynamics_365_Order_status.png) > [!NOTE] > > Existuje omezení týkající se mazání objednávek se stavem Zaplaceno (Paid); takové zaplacené objednávky nelze ze systému Dynamics 365 odstranit. --- <!-- page: Přispívání | url: http://nopdocs.service.hedr.dev/cs/developer/contribute/index.html | source: cs/developer/contribute/index.md --> # Přispívání Budeme velmi rádi, když přispějete k úspěchu nopCommerce – ať už pomocí při realizaci projektu, účastí ve fórech, nebo jen tím, že o nás budete šířit povědomí! Pokud máte web, napište o nás nebo na nás umístěte odkaz! Usilujeme o neustálý růst komunity nopCommerce! nopCommerce má mladou, ale rostoucí komunitu přispěvatelů. Je to velmi aktivní komunita, která s nadšením vyvíjí velmi robustní open source e-commerce aplikaci na platformě .NET Core. nopCommerce zaznamenal za poslední měsíc přes 30 000 stažení, takže je poměrně populární. Připojte se tedy ke komunitě a zjistěte, co se můžete naučit a o co se můžete podělit! * [Možné způsoby přispívání](xref:cs/developer/contribute/possible-ways) * [Sdílení vašich pluginů, motivů a jazykových balíčků](xref:cs/developer/contribute/sharing) * [Práce se zdrojovým kódem a příspěvky](xref:cs/developer/contribute/source-code) --- <!-- page: Možnosti, jak přispět | url: http://nopdocs.service.hedr.dev/cs/developer/contribute/possible-ways.html | source: cs/developer/contribute/possible-ways.md --> # Možnosti, jak přispět ## Zde je několik způsobů, jak můžete přispět do projektu nopCommerce * Pokud máte web, napište o nás nebo umístěte odkaz * Odpovězte na otázku na našich [fórech](http://www.nopcommerce.com/boards/). * Pomozte nám ověřovat zaslané opravy chyb. * Podělte se o nápad na novou funkci nebo lepší způsob, jak něco udělat, na [fórech](http://www.nopcommerce.com/boards/). * Vytvořte nový jazykový balíček. * Vytvořte novou grafickou šablonu a sdílejte ji s komunitou. * Implementujte nový plugin (modul platební brány apod.). * Řekněte o nopCommerce svým přátelům. * Naše loga. PNG: [250x250](http://www.nopcommerce.com/images/nopLogos/nopcommerce_logo_250x250-trans.png) a [340x140](http://www.nopcommerce.com/images/nopLogos/nopcommerce_logo-340x140-trans.png). PSD: [250x250](http://www.nopcommerce.com/images/nopLogos/250x250.psd) a [340x140](http://www.nopcommerce.com/images/nopLogos/340x140.psd) a [1600x1200](http://www.nopcommerce.com/images/nopLogos/1600x1200.psd) --- <!-- page: Sdílení vašich pluginů a šablon | url: http://nopdocs.service.hedr.dev/cs/developer/contribute/sharing.html | source: cs/developer/contribute/sharing.md --> # Sdílení vašich pluginů a šablon Svůj plugin můžete snadno nahrát do našeho adresáře [Marketplace](http://www.nopcommerce.com/marketplace) a sdílet ho s ostatními uživateli. Stačí přejít na stránku [Můj účet](http://www.nopcommerce.com/customer/info) a poté na záložku „Your extensions“. Kliknutím na tlačítko „Upload a new extension“ nahrajete nové rozšíření. Zde jsou některé z výhod umístění pluginu v adresáři [Marketplace](http://www.nopcommerce.com/marketplace): * Sledování základních statistik o tom, kolik lidí plugin stahuje * Větší zviditelnění vašeho pluginu v komunitě * Hodnocení vašeho pluginu v porovnání s mnoha dalšími zveřejněnými pluginy * Centralizované místo, kde mohou uživatelé zanechávat komentáře a zpětnou vazbu Tým nopCommerce kontroluje kvalitu každého rozšíření a ověřuje, že splňuje všechny naše požadavky (včetně dokumentace a obrázků). Pokud vaše rozšíření kontrolou neprojde, sdělíme vám důvod a jak jej opravit. V opačném případě bude vaše úspěšně odeslané rozšíření zveřejněno na našem marketplace. Úplný seznam našich požadavků a informace o procesu kontroly najdete [zde](https://www.nopcommerce.com/submitting-plugins-to-nopcommerce-marketplace). --- <!-- page: Práce se zdrojovým kódem a příspěvky | url: http://nopdocs.service.hedr.dev/cs/developer/contribute/source-code.html | source: cs/developer/contribute/source-code.md --> # Práce se zdrojovým kódem a příspěvky ## Stažení zdrojového kódu nopCommerce spravuje repozitář na GitHubu ([https://github.com/nopSolutions/nopCommerce](https://github.com/nopSolutions/nopCommerce)). Vždy si tak můžete stáhnout nejnovější zdrojový kód! Přístup ke Git SCM (Source Code Management – správa zdrojového kódu) je veřejný a umožňuje vám v reálném čase získat nejnovější verzi nopCommerce! Můžete tak sledovat každodenní vývoj a vylepšení nopCommerce a získat nejnovější opravy bez čekání na další vydání. Pokud Git neznáte, dobrou a bezplatnou dokumentaci najdete [zde](https://git-scm.com/docs). Další informace o podpoře GitHubu najdete [zde](https://opensource.guide/how-to-contribute/). Upozorňujeme, že tyto verze by neměly být používány v produkčním prostředí. Nezaručujeme, že jakákoli funkce nebo kód z našeho SCM (správy zdrojového kódu) bude dostupný v oficiálních vydáních. Nejlepší způsob, jak získat zdrojový kód, je naklonovat repozitář. Git obsahuje vestavěné grafické nástroje pro commitování (git-gui) a procházení (gitk), ale existuje i několik nástrojů třetích stran pro uživatele, kteří hledají řešení pro konkrétní platformu. Najdete je na [https://git-scm.com/downloads/guis](https://git-scm.com/downloads/guis) (my používáme [SourceTree](https://www.sourcetreeapp.com/)). ## Popis a pojmenování větví Nedávno jsme začali používat model větvení Vincenta Driessena (viz zde: [http://nvie.com/posts/a-successful-git-branching-model/](https://nvie.com/posts/a-successful-git-branching-model/)) včetně používání feature větví, vývojové větve (pro integraci) a větve master (pro publikování/produkci). Dříve (do ledna 2016) jsme měli pouze větev „master“. * Produkční větev: master * Vývojová větev: develop * Větve pro pracovní položky (issues): Měly by začínat slovem „issue“. Následuje ID issue (podle našeho seznamu issues na GitHubu) a nějaký srozumitelný název (například „multistore“). Výsledek by měl vypadat například takto: „issue-35-paypal-redirection-bug“ * Větve vydání: Měly by začínat slovem „release“. Následuje číslo verze (například „3.00“). Výsledek by měl vypadat takto: „release-3.00“ ## Vytvoření forku a odesílání pull requestů Pokud chcete přispět zdrojovým kódem do jádra nopCommerce (oprava chyby nebo nová funkce), postupujte následovně. Zde je stručný seznam kroků pro přispění: * Nejprve si musíte vytvořit fork. Více o vytváření forku repozitáře na GitHubu najdete na [https://help.github.com/articles/fork-a-repo/](https://help.github.com/articles/fork-a-repo/). * Naklonujte jej lokálně. * Vytvořte novou větev z větve „develop“. Pro každý příspěvek vždy vytvořte novou větev. Vytvářejte ji pouze z naší větve „develop“. Nepoužívejte „master“. * Napište kód a odešlete (push) jej zpět do svého forku na GitHubu. * Vytvořte pull request. Více informací najdete na [https://help.github.com/articles/using-pull-requests/](https://help.github.com/articles/using-pull-requests/). Před jeho vytvořením se prosím vždy synchronizujte s naším repozitářem. --- <!-- page: Jak napsat daňový plugin pro nopCommerce 4.20 | url: http://nopdocs.service.hedr.dev/cs/developer/plugins/how-to-write-tax-plugin-4.20.html | source: cs/developer/plugins/how-to-write-tax-plugin-4.20.md --> # Jak napsat daňový plugin pro nopCommerce Funkčnost nopCommerce se rozšiřuje pomocí pluginů. Existují různé typy pluginů, například „PickupInStore“ a „PayPal Standard“, které jsou již součástí distribuce nopCommerce. Na [oficiálním webu nopCommerce](https://www.nopcommerce.com/marketplace) můžete také vyhledávat různé pluginy a zjistit, zda už někdo nevytvořil plugin, který vyhovuje vašim potřebám. Pokud jste žádný nenašli, jste na správném místě, protože tento článek vás provede procesem vytvoření pluginu, konkrétně daňového pluginu, podle vašich potřeb. ## Struktura pluginu, potřebné soubory a jejich umístění 1. Začněte vytvořením nového projektu typu „Class Library“ v řešení (solution). Doporučuje se umístit plugin do adresáře **Plugins** v kořenové složce zdrojového kódu, kde se již nacházejí ostatní pluginy a widgety. ![image1](_static/how-to-write-a-tax-plugin-4.20/image1.png) > [!NOTE] > Nezaměňujte tento adresář s adresářem, který existuje v adresáři `Presentation\Nop.Web`. Adresář Plugins v adresáři Nop.Web obsahuje zkompilované soubory pluginů. Doporučený název projektu pluginu je `Nop.Plugin.{Group}.{Name}`. `{Group}` je skupina vašeho pluginu (například `Payment` nebo `Shipping`). `{Name}` je název vašeho pluginu (například `FixedOrByCountryStateZip`). Například daňový plugin `FixedOrByCountryStateZip` má následující název: `Nop.Plugin.Tax.FixedOrByCountryStateZip`. Upozorňujeme však, že to není povinné. Pro plugin můžete zvolit libovolný název. Například `MyFirstTaxPlugin`. Struktura adresáře Plugins v řešení vypadá následovně. ![image2](_static/how-to-write-a-tax-plugin-4.20/image2.png) 1. Po vytvoření projektu pluginu je třeba aktualizovat obsah souboru **.csproj** v libovolném dostupném textovém editoru. Nahraďte obsah následujícím: ```xml <Project Sdk="Microsoft.NET.Sdk"> <PropertyGroup> <TargetFramework>netcoreapp2.2</TargetFramework> <Copyright>SOME_COPYRIGHT</Copyright> <Company>YOUR_COMPANY</Company> <Authors>SOME_AUTHORS</Authors> <PackageLicenseUrl>PACKAGE_LICENSE_URL</PackageLicenseUrl> <PackageProjectUrl>PACKAGE_PROJECT_URL</PackageProjectUrl> <RepositoryUrl>REPOSITORY_URL</RepositoryUrl> <RepositoryType>Git</RepositoryType> <OutputPath>..\..\Presentation\Nop.Web\Plugins\PLUGIN_OUTPUT_DIRECTORY</OutputPath> <OutDir>$(OutputPath)</OutDir> <!--Set this parameter to true to get the dlls copied from the NuGet cache to the output of your project. You need to set this parameter to true if your plugin has a nuget package to ensure that the dlls copied from the NuGet cache to the output of your project--> <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies> </PropertyGroup> <ItemGroup> <ProjectReference Include="..\..\Presentation\Nop.Web.Framework\Nop.Web.Framework.csproj" /> <ClearPluginAssemblies Include="$(MSBuildProjectDirectory)\..\..\Build\ClearPluginAssemblies.sproj" /> </ItemGroup> <!-- This target execute after "Build" target --> <Target Name="NopTarget" AfterTargets="Build"> <!-- Delete unnecessary libraries from plugins path --> <MSBuild Projects="@(ClearPluginAssemblies)" Properties="PluginPath=$(MSBuildProjectDirectory)\ $ (OutDir)" Targets="NopClear" /> </Target> </Project> ``` > [!NOTE] > **PLUGIN_OUTPUT_DIRECTORY** je třeba nahradit názvem pluginu, například `Tax.FixedOrByCountryStateZip`. 1. Po aktualizaci souboru **.csproj** je třeba přidat soubor `plugin.json`, který je pro plugin vyžadován. Tento soubor obsahuje metainformace popisující váš plugin. Stačí tento soubor zkopírovat z jakéhokoli jiného existujícího pluginu/widgetu a upravit jej podle svých potřeb. Informace o souboru `plugin.json` najdete v části [Soubor plugin.json](xref:cs/developer/plugins/plugin_json). 1. Posledním povinným krokem je vytvoření třídy, která implementuje `BasePlugin` (jmenný prostor `Nop.Core.Plugins`) a rozhraní `ITaxProvider` (jmenný prostor `Nop.Services.Tax`). **ITaxProvider** implementuje metodu `GetTaxRate`, která vrací typ **CalculateTaxResult** (obsahuje daňovou sazbu, případné chyby a stav úspěchu typu `Boolean`) na základě vlastní logiky, obvykle podle adresy zákazníka. ## Zpracování požadavků. Controllery, modely a view Nyní můžete plugin zobrazit v **Administrace** (Admin area) → **Konfigurace** (Configuration) → **Lokální pluginy** (Local Plugins). ![image4](_static/how-to-write-a-tax-plugin-4.20/image4.png) Když je plugin/widget nainstalován, uvidíte tlačítko **Odinstalovat** (Uninstall). Pro zlepšení výkonu je dobrým zvykem odinstalovat pluginy/widgety, které nejsou potřeba. ![image5](_static/how-to-write-a-tax-plugin-4.20/image5.png) Když plugin/widget není nainstalován nebo byl odinstalován, zobrazí se tlačítka **Instalovat** (Install) a **Smazat** (Delete). > [!NOTE] > Smazáním se ze serveru odstraní fyzické soubory. Jak jste ale jistě uhodli, náš plugin nic nedělá. Nemá ani uživatelské rozhraní pro svou konfiguraci. Vytvořme tedy stránku pro konfiguraci pluginu. Nyní potřebujeme vytvořit controller, model, view a view komponentu. * MVC controllery odpovídají za reakci na požadavky odeslané na web `ASP.NET MVC`. Každý požadavek prohlížeče je namapován na konkrétní controller. * View obsahuje HTML značky a obsah, který se odesílá do prohlížeče. Při práci s aplikací `ASP.NET MVC` je view ekvivalentem stránky. * View komponenta, která implementuje **NopViewComponent** a obsahuje logiku a kód pro vykreslení view. * MVC model obsahuje veškerou logiku vaší aplikace, která není obsažena ve view ani v controlleru. Pojďme tedy na to: * **Vytvořte model**. Přidejte do nového pluginu složku `Models` a poté přidejte novou třídu modelu, která vyhovuje vašim potřebám. * **Vytvořte view**. Přidejte do nového pluginu složku `Views` a poté přidejte soubor `.cshtml` s názvem `Configure.cshtml`. Nastavte vlastnost **Build Action** souboru view na **Content** a vlastnost **Copy to Output Directory** na **Copy always**. Upozorňujeme, že konfigurační stránka by měla používat layout *_ConfigurePlugin*. ```html @model Nop.Plugin.Tax.FixedOrByCountryStateZip.Models.ConfigurationModel @{ Layout = "_ConfigurePlugin"; } <div class="form-group"> <div class="col-md-12"> <div class="onoffswitch"> <input type="checkbox" name="onoffswitch" class="onoffswitch-checkbox" id="advanced-settings-mode" checked="@Model.CountryStateZipEnabled"> <label class="onoffswitch-label" for="advanced-settings-mode"> <span class="onoffswitch-inner" data-locale-basic="@T("Plugins.Tax.FixedOrByCountryStateZip.Fixed")" data-locale-advanced="@T("Plugins.Tax.FixedOrByCountryStateZip.TaxByCountryStateZip")"></span> <span class="onoffswitch-switch"></span> </label> </div> </div> </div> <script> function checkAdvancedSettingsMode(advanced) { if (advanced) { $("body").addClass("advanced-settings-mode"); $("body").removeClass("basic-settings-mode"); } else { $("body").removeClass("advanced-settings-mode"); $("body").addClass("basic-settings-mode"); } } checkAdvancedSettingsMode($("#advanced-settings-mode").is(':checked')); $(document).ready(function() { $("#advanced-settings-mode").click(function() { checkAdvancedSettingsMode($(this).is(':checked')); $.ajax({ cache: false, url: "@Url.Action("SaveMode", "FixedOrByCountryStateZip")", type: "POST", data: { value: $(this).is(':checked') }, dataType: "json", error: function (jqXHR, textStatus, errorThrown) { $("#saveModeAlert").click(); } }); ensureDataTablesRendered(); }); }); </script> <nop-alert asp-alert-id="saveModeAlert" asp-alert-message="@T("Admin.Common.Alert.Save.Error")" /> @await Html.PartialAsync("~/Plugins/Tax.FixedOrByCountryStateZip/Views/_FixedRate.cshtml") @await Html.PartialAsync("~/Plugins/Tax.FixedOrByCountryStateZip/Views/_CountryStateZip.cshtml", Model) ``` * Ujistěte se také, že máte v adresáři `Views` soubor **_ViewImports.cshtml**. Stačí jej zkopírovat z jakéhokoli jiného existujícího pluginu nebo widgetu. ![image6](_static/how-to-write-a-tax-plugin-4.20/image6.png) * **Vytvořte controller**. Přidejte do nového pluginu složku `Controllers` a poté přidejte novou třídu controlleru. Osvědčeným postupem je pojmenovávat controllery pluginů **{Group}{Name}Controller.cs**. Například `FixedOrByCountryStateZipController`. Pojmenovávat controllery tímto způsobem samozřejmě není povinné (jde pouze o doporučení). Poté vytvořte příslušnou akční metodu pro konfigurační stránku (v administraci). Pojmenujme ji `Configure`. Připravte třídu modelu a předejte ji následujícímu view pomocí fyzické cesty k view: **~/Plugins/{PluginOutputDirectory}/Views/Configure.cshtml**. ```cs public IActionResult Configure() { if (!_permissionService.Authorize(StandardPermissionProvider.ManageTaxSettings)) return AccessDeniedView(); var taxCategories = _taxCategoryService.GetAllTaxCategories(); if (!taxCategories.Any()) return Content("No tax categories can be loaded"); var model = new ConfigurationModel { CountryStateZipEnabled = _countryStateZipSettings.CountryStateZipEnabled }; //stores model.AvailableStores.Add(new SelectListItem { Text = "*", Value = "0" }); var stores = _storeService.GetAllStores(); foreach (var s in stores) model.AvailableStores.Add(new SelectListItem { Text = s.Name, Value = s.Id.ToString() }); //tax categories foreach (var tc in taxCategories) model.AvailableTaxCategories.Add(new SelectListItem { Text = tc.Name, Value = tc.Id.ToString() }); //countries var countries = _countryService.GetAllCountries(showHidden: true); foreach (var c in countries) model.AvailableCountries.Add(new SelectListItem { Text = c.Name, Value = c.Id.ToString() }); //states model.AvailableStates.Add(new SelectListItem { Text = "*", Value = "0" }); var defaultCountry = countries.FirstOrDefault(); if (defaultCountry != null) { var states = _stateProvinceService.GetStateProvincesByCountryId(defaultCountry.Id); foreach (var s in states) model.AvailableStates.Add(new SelectListItem { Text = s.Name, Value = s.Id.ToString() }); } return View("~/Plugins/Tax.FixedOrByCountryStateZip/Views/Configure.cshtml", model); } ``` * Pro svou akční metodu použijte následující atributy: ```cs [AuthorizeAdmin] //confirms access to the admin panel [Area(AreaNames.Admin)] //specifies the area containing a controller or action [AdminAntiForgery] //Helps prevent malicious scripts from submitting forged page requests. ``` Otevřete například plugin `FixedOrByCountryStateZip` a podívejte se na jeho implementaci `FixedOrByCountryStateZipController`. Poté byste pro každý plugin, který má konfigurační stránku, měli určit konfigurační URL. Základní třída `BasePlugin` má metodu `GetConfigurationPageUrl`, která vrací konfigurační URL: ```cs public override string GetConfigurationPageUrl() { return $"{_webHelper.GetStoreLocation()}Admin/{CONTROLLER_NAME}/{ACTION_NAME}"; } ``` Kde *{CONTROLLER_NAME}* je název vašeho controlleru a *{ACTION_NAME}* je název akce (obvykle `Configure`). Pro přiřazení různých daňových sazeb podle adresy zákazníka je potřeba nová tabulka, která uchovává všechna data související s daní. Za tímto účelem se přidá složka `Domain`, do které přidáme třídu rozšiřující třídu **BaseEntity**. V tomto případě `TaxRate.cs` ![image7](_static/how-to-write-a-tax-plugin-4.20/image7.png) Přidá se také další složka `Data`, která obsahuje mapovací třídu (třídy) a třídu (třídy) Object Context. Mapovací třída implementuje **`NopEntityTypeConfiguration<T>`** (jmenný prostor `Nop.Data.Mapping`). Zde je přepsána metoda configure. ```cs public override void Configure(EntityTypeBuilder<TaxRate> builder) { builder.ToTable(nameof(TaxRate)); builder.HasKey(rate => rate.Id); builder.Property(rate => rate.Percentage).HasColumnType("decimal(18, 4)"); } ``` Třída Object Context implementuje třídu **DbContext** (jmenný prostor `Microsoft.EntityFrameworkCore`) a rozhraní **IDbContext** (jmenný prostor `Nop.Data`). Toto rozhraní `IDbContext` obsahuje metody související s vytvářením a mazáním tabulek a dalšími vlastními akcemi, jako je provedení nezpracovaného SQL dotazu podle modelu, který byl dříve přidán do složky `Domain`. ```cs public class CountryStateZipObjectContext : DbContext, IDbContext { #region Ctor public CountryStateZipObjectContext(DbContextOptions<CountryStateZipObjectContext> options) : base(options) { } #endregion #region Utilities /// <summary> /// Further configuration the model /// </summary> /// <param name="modelBuilder">Model muilder</param> protected override void OnModelCreating(ModelBuilder modelBuilder) { modelBuilder.ApplyConfiguration(new TaxRateMap()); base.OnModelCreating(modelBuilder); } #endregion #region Methods /// <summary> /// Creates a DbSet that can be used to query and save instances of entity /// </summary> /// <typeparam name="TEntity">Entity type</typeparam> /// <returns>A set for the given entity type</returns> public new virtual DbSet<TEntity> Set<TEntity>() where TEntity : BaseEntity { return base.Set<TEntity>(); } /// <summary> /// Generate a script to create all tables for the current model /// </summary> /// <returns>A SQL script</returns> public virtual string GenerateCreateScript() { return Database.GenerateCreateScript(); } /// <summary> /// Creates a LINQ query for the query type based on a raw SQL query /// </summary> /// <typeparam name="TQuery">Query type</typeparam> /// <param name="sql">The raw SQL query</param> /// <param name="parameters">The values to be assigned to parameters</param> /// <returns>An IQueryable representing the raw SQL query</returns> public virtual IQueryable<TQuery> QueryFromSql<TQuery>(string sql, params object[] parameters) where TQuery : class { throw new NotImplementedException(); } /// <summary> /// Creates a LINQ query for the entity based on a raw SQL query /// </summary> /// <typeparam name="TEntity">Entity type</typeparam> /// <param name="sql">The raw SQL query</param> /// <param name="parameters">The values to be assigned to parameters</param> /// <returns>An IQueryable representing the raw SQL query</returns> public virtual IQueryable<TEntity> EntityFromSql<TEntity>(string sql, params object[] parameters) where TEntity : BaseEntity { throw new NotImplementedException(); } /// <summary> /// Executes the given SQL against the database /// </summary> /// <param name="sql">The SQL to execute</param> /// <param name="doNotEnsureTransaction">true - the transaction creation is not ensured; false - the transaction creation is ensured.</param> /// <param name="timeout">The timeout to use for command. Note that the command timeout is distinct from the connection timeout, which is commonly set on the database connection string</param> /// <param name="parameters">Parameters to use with the SQL</param> /// <returns>The number of rows affected</returns> public virtual int ExecuteSqlCommand(RawSqlString sql, bool doNotEnsureTransaction = false, int? timeout = null, params object[] parameters) { using (var transaction = Database.BeginTransaction()) { var result = Database.ExecuteSqlCommand(sql, parameters); transaction.Commit(); return result; } } /// <summary> /// Detach an entity from the context /// </summary> /// <typeparam name="TEntity">Entity type</typeparam> /// <param name="entity">Entity</param> public virtual void Detach<TEntity>(TEntity entity) where TEntity : BaseEntity { throw new NotImplementedException(); } /// <summary> /// Install object context /// </summary> public void Install() { //create tables this.ExecuteSqlScript(GenerateCreateScript()); } /// <summary> /// Uninstall object context /// </summary> public void Uninstall() { //drop the table this.DropPluginTable(nameof(TaxRate)); } #endregion } ``` Pro operace **CRUD** s daňovými sazbami se vytvářejí služby. V tomto případě se vytvoří rozhraní **ICountryStateZipService** a třída **CountryStateZipService**. Obsahují metody jako `InsertTaxRate`, `UpdateTaxRate`, `DeleteTaxRate`, `GetAllTaxRates` a `GetTaxRateById`. Názvy těchto metod jsou samovysvětlující a budou je využívat controllery. Další metody lze zavést/přidat podle požadavků. ### ICountryStateZipService.cs ```cs public partial interface ICountryStateZipService { /// <summary> /// Deletes a tax rate /// </summary> /// <param name="taxRate">Tax rate</param> void DeleteTaxRate(TaxRate taxRate); /// <summary> /// Gets all tax rates /// </summary> /// <returns>Tax rates</returns> IPagedList<TaxRate> GetAllTaxRates(int pageIndex = 0, int pageSize = int.MaxValue); /// <summary> /// Gets a tax rate /// </summary> /// <param name="taxRateId">Tax rate identifier</param> /// <returns>Tax rate</returns> TaxRate GetTaxRateById(int taxRateId); /// <summary> /// Inserts a tax rate /// </summary> /// <param name="taxRate">Tax rate</param> void InsertTaxRate(TaxRate taxRate); /// <summary> /// Updates the tax rate /// </summary> /// <param name="taxRate">Tax rate</param> void UpdateTaxRate(TaxRate taxRate); } ``` #### CountryStateZipService.cs ```cs public partial class CountryStateZipService : ICountryStateZipService { #region Fields private readonly IEventPublisher _eventPublisher; private readonly IRepository<TaxRate> _taxRateRepository; private readonly ICacheManager _cacheManager; #endregion #region Ctor /// <summary> /// Ctor /// </summary> /// <param name="eventPublisher">Event publisher</param> /// <param name="cacheManager">Cache manager</param> /// <param name="taxRateRepository">Tax rate repository</param> public CountryStateZipService(IEventPublisher eventPublisher, ICacheManager cacheManager, IRepository<TaxRate> taxRateRepository) { _eventPublisher = eventPublisher; _cacheManager = cacheManager; _taxRateRepository = taxRateRepository; } #endregion #region Methods /// <summary> /// Deletes a tax rate /// </summary> /// <param name="taxRate">Tax rate</param> public virtual void DeleteTaxRate(TaxRate taxRate) { if (taxRate == null) throw new ArgumentNullException(nameof(taxRate)); _taxRateRepository.Delete(taxRate); //event notification _eventPublisher.EntityDeleted(taxRate); } /// <summary> /// Gets all tax rates /// </summary> /// <returns>Tax rates</returns> public virtual IPagedList<TaxRate> GetAllTaxRates(int pageIndex = 0, int pageSize = int.MaxValue) { var key = string.Format(ModelCacheEventConsumer.TAXRATE_ALL_KEY, pageIndex, pageSize); return _cacheManager.Get(key, () => { var query = from tr in _taxRateRepository.Table orderby tr.StoreId, tr.CountryId, tr.StateProvinceId, tr.Zip, tr.TaxCategoryId select tr; var records = new PagedList<TaxRate>(query, pageIndex, pageSize); return records; }); } /// <summary> /// Gets a tax rate /// </summary> /// <param name="taxRateId">Tax rate identifier</param> /// <returns>Tax rate</returns> public virtual TaxRate GetTaxRateById(int taxRateId) { if (taxRateId == 0) return null; return _taxRateRepository.GetById(taxRateId); } /// <summary> /// Inserts a tax rate /// </summary> /// <param name="taxRate">Tax rate</param> public virtual void InsertTaxRate(TaxRate taxRate) { if (taxRate == null) throw new ArgumentNullException(nameof(taxRate)); _taxRateRepository.Insert(taxRate); //event notification _eventPublisher.EntityInserted(taxRate); } /// <summary> /// Updates the tax rate /// </summary> /// <param name="taxRate">Tax rate</param> public virtual void UpdateTaxRate(TaxRate taxRate) { if (taxRate == null) throw new ArgumentNullException(nameof(taxRate)); _taxRateRepository.Update(taxRate); //event notification _eventPublisher.EntityUpdated(taxRate); } #endregion } ``` Poslední věcí, kterou potřebujeme, je registrace služeb a konfigurace DB kontextu pluginu při spuštění aplikace. Za tímto účelem se přidá složka **Infrastructure**, která obsahuje třídy `DependencyRegister` a `PluginDbStartup`. Třída **DependencyRegister** implementuje rozhraní `IDependencyRegister` (jmenný prostor `Nop.Core.Infrastructure.DependencyManagement`), které má metodu `Register`. ```cs public class DependencyRegistrar : IDependencyRegistrar { /// <summary> /// Register services and interfaces /// </summary> /// <param name="builder">Container builder</param> /// <param name="typeFinder">Type finder</param> /// <param name="config">Config</param> public virtual void Register(ContainerBuilder builder, ITypeFinder typeFinder, NopConfig config) { builder.RegisterType<FixedOrByCountryStateZipTaxProvider>().As<ITaxProvider>().InstancePerLifetimeScope(); builder.RegisterType<CountryStateZipService>().As<ICountryStateZipService>().InstancePerLifetimeScope(); //data context builder.RegisterPluginDataContext<CountryStateZipObjectContext>("nop_object_context_tax_country_state_zip"); //override required repository with our custom context builder.RegisterType<EfRepository<TaxRate>>().As<IRepository<TaxRate>>() .WithParameter(ResolvedParameter.ForNamed<IDbContext>("nop_object_context_tax_country_state_zip")) .InstancePerLifetimeScope(); } /// <summary> /// Order of this dependency registrar implementation /// </summary> public int Order => 1; } ``` Podobně třída **PluginDbStartup** implementuje rozhraní `INopStartup` (jmenný prostor `Nop.Core.Infrastructure`), které má metody `ConfigureServices` a `Configure`. V tomto příkladu se object context přidává v metodě `ConfigureServices`. ```cs public class PluginDbStartup : INopStartup { /// <summary> /// Add and configure any of the middleware /// </summary> /// <param name="services">Collection of service descriptors</param> /// <param name="configuration">Configuration of the application</param> public void ConfigureServices(IServiceCollection services, IConfiguration configuration) { //add object context services.AddDbContext<CountryStateZipObjectContext>(optionsBuilder => { optionsBuilder.UseSqlServerWithLazyLoading(services); }); } /// <summary> /// Configure the using of added middleware /// </summary> /// <param name="application">Builder for configuring an application's request pipeline</param> public void Configure(IApplicationBuilder application) { } /// <summary> /// Gets order of this startup configuration implementation /// </summary> public int Order => 11; } ``` ## Struktura projektu daňového pluginu ![image8](_static/how-to-write-a-tax-plugin-4.20/image8.png) ## Zpracování metod "Install" a "Uninstall" Tento krok je volitelný. Některé pluginy mohou během instalace vyžadovat dodatečnou logiku. Plugin může například vložit nové lokalizační prostředky nebo přidat potřebné tabulky či hodnoty nastavení. Otevřete tedy svou implementaci `BasePlugin` a přepište následující metody: * `Install`. Tato metoda se zavolá během instalace pluginu. Zde můžete inicializovat jakákoli nastavení, vložit nové lokalizační prostředky nebo vytvořit nové databázové tabulky (pokud je to potřeba). ```cs public override void Install() { //database objects _objectContext.Install(); //settings _settingService.SaveSetting(new FixedOrByCountryStateZipTaxSettings()); //locales _localizationService.AddOrUpdatePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fixed", "Fixed rate"); _localizationService.AddOrUpdatePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.TaxByCountryStateZip", "By Country"); _localizationService.AddOrUpdatePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.TaxCategoryName", "Tax category"); _localizationService.AddOrUpdatePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.Rate", "Rate"); _localizationService.AddOrUpdatePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.Store", "Store"); _localizationService.AddOrUpdatePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.Store.Hint", "If an asterisk is selected, then this shipping rate will apply to all stores."); _localizationService.AddOrUpdatePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.Country", "Country"); _localizationService.AddOrUpdatePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.Country.Hint", "The country."); _localizationService.AddOrUpdatePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.StateProvince", "State / province"); _localizationService.AddOrUpdatePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.StateProvince.Hint", "If an asterisk is selected, then this tax rate will apply to all customers from the given country, regardless of the state."); _localizationService.AddOrUpdatePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.Zip", "Zip"); _localizationService.AddOrUpdatePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.Zip.Hint", "Zip / postal code. If zip is empty, then this tax rate will apply to all customers from the given country or state, regardless of the zip code."); _localizationService.AddOrUpdatePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.TaxCategory", "Tax category"); _localizationService.AddOrUpdatePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.TaxCategory.Hint", "The tax category."); _localizationService.AddOrUpdatePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.Percentage", "Percentage"); _localizationService.AddOrUpdatePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.Percentage.Hint", "The tax rate."); _localizationService.AddOrUpdatePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.AddRecord", "Add tax rate"); _localizationService.AddOrUpdatePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.AddRecordTitle", "New tax rate"); base.Install(); } ``` * `Uninstall`. Tato metoda se zavolá během odinstalace pluginu. Můžete odstranit nastavení, lokalizační prostředky nebo databázové tabulky, které plugin inicializoval během instalace. ```cs public override void Uninstall() { //settings _settingService.DeleteSetting<FixedOrByCountryStateZipTaxSettings>(); //fixed rates var fixedRates = _taxCategoryService.GetAllTaxCategories() .Select(taxCategory => _settingService.GetSetting(string.Format(FixedOrByCountryStateZipDefaults.FixedRateSettingsKey, taxCategory.Id))) .Where(setting => setting != null).ToList(); _settingService.DeleteSettings(fixedRates); //database objects _objectContext.Uninstall(); //locales _localizationService.DeletePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fixed"); _localizationService.DeletePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.TaxByCountryStateZip"); _localizationService.DeletePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.TaxCategoryName"); _localizationService.DeletePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.Rate"); _localizationService.DeletePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.Store"); _localizationService.DeletePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.Store.Hint"); _localizationService.DeletePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.Country"); _localizationService.DeletePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.Country.Hint"); _localizationService.DeletePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.StateProvince"); _localizationService.DeletePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.StateProvince.Hint"); _localizationService.DeletePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.Zip"); _localizationService.DeletePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.Zip.Hint"); _localizationService.DeletePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.TaxCategory"); _localizationService.DeletePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.TaxCategory.Hint"); _localizationService.DeletePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.Percentage"); _localizationService.DeletePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.Percentage.Hint"); _localizationService.DeletePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.AddRecord"); _localizationService.DeletePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.AddRecordTitle"); base.Uninstall(); } ``` > [!IMPORTANT] > Pokud některou z těchto metod přepíšete, nezakrývejte její základní implementaci – base.Install() a base.Uninstall(). --- <!-- page: Jak napsat widget pro nopCommerce | url: http://nopdocs.service.hedr.dev/cs/developer/plugins/how-to-write-widget-for-nopCommerce.html | source: cs/developer/plugins/how-to-write-widget-for-nopCommerce.md --> # Jak napsat widget pro nopCommerce K rozšíření funkcionality nopCommerce se používají widgety. Existují různé typy widgetů, například [Swiper](https://github.com/nopSolutions/nopCommerce/tree/master/src/Plugins/Nop.Plugin.Widgets.Swiper) a [Google Analytics](https://github.com/nopSolutions/nopCommerce/tree/master/src/Plugins/Nop.Plugin.Widgets.GoogleAnalytics), které jsou již součástí repozitáře nopCommerce. Marketplace nopCommerce již obsahuje různé widgety (bezplatné i placené), které mohou splňovat vaše požadavky. Pokud jste žádný vhodný nenašli, jste na správném místě, protože tento článek vás provede procesem vytvoření widgetu podle vašich potřeb. ## Struktura widgetu, požadované soubory a umístění 1. Začněte vytvořením nového projektu **Class Library** (knihovna tříd) v řešení. Doporučujeme umístit widget do adresáře **Plugins** v kořenové složce zdrojového kódu, kde se již nacházejí ostatní widgety a pluginy. ![image1](_static/how-to-write-a-widget-for-nopCommerce/image1.png) > [!NOTE] > > Nezaměňujte tento adresář s adresářem, který existuje v adresáři *Presentation\Nop.Web*. Adresář *Plugins* v adresáři *Nop.Web* obsahuje zkompilované soubory pluginů. Doporučený název projektu widgetu je `Nop.Plugin.Widgets.{Name}`. `{Name}` je název vašeho widgetu (například „**GoogleAnalytics**“). Například *widget Google Analytics* má následující název: `Nop.Plugin.Widgets.GoogleAnalytics`. Upozorňujeme však, že to není povinné a pro widget můžete zvolit libovolný název. Například „*MyFirstNopWidget*“. Struktura adresáře *Plugins* v řešení vypadá následovně. ![image2](_static/how-to-write-a-widget-for-nopCommerce/image2.png) 1. Po vytvoření projektu widgetu je třeba upravit obsah souboru **.csproj** pomocí libovolného dostupného textového editoru. Nahraďte obsah následujícím: ```xml <Project Sdk="Microsoft.NET.Sdk"> <PropertyGroup> <TargetFramework>net9.0</TargetFramework> <Copyright>SOME_COPYRIGHT</Copyright> <Company>YOUR_COMPANY</Company> <Authors>SOME_AUTHORS</Authors> <PackageLicenseUrl>PACKAGE_LICENSE_URL</PackageLicenseUrl> <PackageProjectUrl>PACKAGE_PROJECT_URL</PackageProjectUrl> <RepositoryUrl>REPOSITORY_URL</RepositoryUrl> <RepositoryType>Git</RepositoryType> <OutputPath>$(SolutionDir)\Presentation\Nop.Web\Plugins\WIDGET_OUTPUT_DIRECTORY</OutputPath> <OutDir>$(OutputPath)</OutDir> <!--Set this parameter to true to get the dlls copied from the NuGet cache to the output of your project. You need to set this parameter to true if your plugin has a nuget package to ensure that the dlls copied from the NuGet cache to the output of your project--> <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies> <ImplicitUsings>enable</ImplicitUsings> </PropertyGroup> <ItemGroup> <ProjectReference Include="$(SolutionDir)\Presentation\Nop.Web.Framework\Nop.Web.Framework.csproj" /> <ClearPluginAssemblies Include="$(SolutionDir)\Build\ClearPluginAssemblies.csproj" /> </ItemGroup> <!-- This target execute after "Build" target --> <Target Name="NopTarget" AfterTargets="Build"> <!-- Delete unnecessary libraries from plugins path --> <MSBuild Projects="@(ClearPluginAssemblies)" Properties="PluginPath=$(OutDir)" Targets="NopClear" /> </Target> </Project> ``` > [!NOTE] > > Hodnotu **WIDGET_OUTPUT_DIRECTORY** je třeba nahradit názvem pluginu, například *Widgets.GoogleAnalytics*. 1. Po úpravě souboru *.csproj* je třeba přidat soubor **plugin.json**, který je pro widget povinný. Tento soubor obsahuje metainformace popisující váš widget. Stačí tento soubor zkopírovat z jakéhokoli jiného existujícího pluginu/widgetu a upravit jej podle svých potřeb. Informace o souboru `plugin.json` naleznete v článku [Soubor plugin.json](xref:cs/developer/plugins/plugin_json). Posledním povinným krokem je vytvoření třídy, která implementuje **BasePlugin** (jmenný prostor *Nop.Core.Plugins*) a rozhraní **IWidgetPlugin** (jmenný prostor *Nop.Services.Cms*). IWidgetPlugin umožňuje vytvářet widgety. Widgety se vykreslují v určitých částech vašeho webu. Může to být například blok živého chatu v pravém dolním rohu webu. ## Zpracování požadavků. Controllery, modely a view Nyní můžete widget zobrazit přechodem na **Administrace** → **Konfigurace** → **Lokální pluginy** (Admin area → Configuration → Local Plugins). ![image4](_static/how-to-write-a-widget-for-nopCommerce/image4.png) Když je plugin/widget nainstalován, uvidíte tlačítko **Odinstalovat** (Uninstall). *Pro zlepšení výkonu je dobrým zvykem odinstalovat pluginy/widgety, které nejsou potřeba*. ![image5](_static/how-to-write-a-widget-for-nopCommerce/image5.png) Pokud plugin/widget není nainstalován nebo byl odinstalován, zobrazí se tlačítka **Instalovat** (Install) a **Smazat** (Delete). *Smazáním se ze serveru odstraní fyzické soubory*. Jak jste ale jistě uhodli, náš widget nic nedělá. Nemá ani uživatelské rozhraní pro svou konfiguraci. Vytvořme tedy stránku pro konfiguraci widgetu. Nyní potřebujeme vytvořit controller, model, view a komponentu view (view component). - **MVC controllery** odpovídají na požadavky odeslané na web *ASP.NET MVC*. Každý požadavek prohlížeče je namapován na konkrétní controller. - View obsahuje značky **HTML** a obsah, který se odesílá do prohlížeče. Při práci s aplikací *ASP.NET MVC* je view ekvivalentem stránky. - Komponenta view, která implementuje **NopViewComponent** a obsahuje logiku a kód pro vykreslení view. - **MVC model** obsahuje veškerou logiku aplikace, která není obsažena ve view ani v controlleru. Pojďme tedy začít: 1. Vytvořte model. Do nového widgetu přidejte složku `Models` a poté přidejte novou třídu modelu, která odpovídá vašim potřebám. 1. Vytvořte view. Do nového widgetu přidejte složku `Views` a poté přidejte soubor `cshtml` s názvem `Configure.cshtml`. Nastavte vlastnost „**Build Action**“ souboru view na „**Content**“ a vlastnost „**Copy to Output Directory**“ na „**Copy always**“. Upozorňujeme, že konfigurační stránka by měla používat layout „**_ConfigurePlugin**“. ```cs @{ Layout = "_ConfigurePlugin"; } ``` 1. Ujistěte se také, že máte v adresáři `Views` soubor **_ViewImports.cshtml**. Stačí jej zkopírovat z jakéhokoli jiného existujícího pluginu nebo widgetu. ![image7](_static/how-to-write-a-widget-for-nopCommerce/image7.png) 1. Vytvořte controller. Do nového widgetu přidejte složku `Controllers` a poté přidejte novou třídu controlleru. Dobrým zvykem je pojmenovávat controllery pluginů `Widgets{Name}Controller.cs`. Například **WidgetsGoogleAnalyticsController**. Pojmenovávat controllery tímto způsobem samozřejmě není povinné, jde pouze o doporučení. Poté vytvořte odpovídající metodu akce pro konfigurační stránku (v administraci). Pojmenujme ji `Configure`. Připravte třídu modelu a předejte ji následujícímu view pomocí fyzické cesty k view: `~/Plugins/{PluginOutputDirectory}/Views/Configure.cshtml`. ```cs public async Task<IActionResult> Configure() { if (!await _permissionService.AuthorizeAsync(StandardPermissionProvider.ManageWidgets)) return AccessDeniedView(); //load settings for a chosen store scope var storeScope = await _storeContext.GetActiveStoreScopeConfigurationAsync(); var myWidgetSettings = await _settingService.LoadSettingAsync<MyWidgetSettings>(storeScope); var model = new ConfigurationModel { // configuration model settings here }; if (storeScope > 0) { // override settings here based on store scope } return View("~/Plugins/Widgets.MyFirstNopWidget/Views/Configure.cshtml", model); } ``` 1. Pro metodu akce použijte následující atributy: ```cs [AutoValidateAntiforgeryToken] [AuthorizeAdmin] //confirms access to the admin panel [Area(AreaNames.Admin)] //specifies the area containing a controller or action [AdminAntiForgery] //Helps prevent malicious scripts from submitting forged page requests. ``` Otevřete například widget `GoogleAnalytics` a podívejte se na jeho implementaci `WidgetsGoogleAnalyticsController`. Poté byste pro každý widget, který má konfigurační stránku, měli zadat konfigurační URL. Základní třída s názvem **BasePlugin** má metodu `GetConfigurationPageUrl`, která vrací konfigurační URL: ```cs public override string GetConfigurationPageUrl() { return $"{_webHelper.GetStoreLocation()}Admin/{CONTROLLER_NAME}/{ACTION_NAME}"; } ``` Kde `{CONTROLLER_NAME}` je název vašeho controlleru a `{ACTION_NAME}` je název akce (obvykle „Configure“). Každý widget by měl určit seznam zón widgetů. Základní třída s názvem **IWidgetPlugin** má metodu `GetWidgetZones`, která vrací seznam zón widgetů, ve kterých se bude vykreslovat. ```cs public Task<IList<string>> GetWidgetZonesAsync() { return Task.FromResult<IList<string>>(new List<string> {PublicWidgetZones.HeadHtmlTag }); } ``` [Seznam veřejných zón widgetů najdete na tomto odkazu](https://github.com/nopSolutions/nopCommerce/blob/master/src/Presentation/Nop.Web.Framework/Infrastructure/PublicWidgetZones.cs) a [zóny widgetů administrace na tomto odkazu](https://github.com/nopSolutions/nopCommerce/blob/master/src/Presentation/Nop.Web.Framework/Infrastructure/AdminWidgetZones.cs). Kromě `GetWidgetZonesAsync` má **IWidgetPlugin** metodu `GetWidgetViewComponentName`, která vrací název ViewComponent. Jako parametr přijímá název „*widgetZone*“ a lze ji použít k vykreslení různých view v závislosti na zvolené zóně widgetu. ```cs public string GetWidgetViewComponentName(string widgetZone) { return "MyFirstWidget"; } ``` ## Struktura projektu widgetu Google Analytics ![image11](_static/how-to-write-a-widget-for-nopCommerce/image11.png) ## Zpracování metod „InstallAsync“ a „UninstallAsync“ Tento krok je volitelný. Některé widgety mohou během instalace vyžadovat další logiku. Widget může například vložit nové lokalizační zdroje nebo hodnoty nastavení. Otevřete tedy svou implementaci **IWidgetPlugin** (ve většině případů bude odvozena od třídy **BasePlugin**) a přepište následující metody: 1. **InstallAsync**. Tato metoda se volá během instalace pluginu. Můžete zde inicializovat libovolná nastavení, vložit nové lokalizační zdroje nebo vytvořit nové databázové tabulky (je-li to potřeba). ```cs public override async Task InstallAsync() { // custom logic like adding settings, locale resources, and database table(s) here await base.InstallAsync(); } ``` 1. **UninstallAsync**. Tato metoda se volá během odinstalace pluginu. Můžete zde odstranit nastavení, lokalizační zdroje nebo databázové tabulky, které widget vytvořil během instalace. ```cs public override async Task UninstallAsync() { // custom logic like removing settings, locale resources, and database table(s) which was created during widget installation await base.UninstallAsync(); } ``` > [!IMPORTANT] > > Pokud jednu z těchto metod přepíšete, neskrývejte její základní implementaci – **base.InstallAsync()** a **base.UninstallAsync()**, které jsou vyznačeny na obrázcích výše. --- <!-- page: Automatický překlad obsahu | url: http://nopdocs.service.hedr.dev/cs/getting-started/advanced-configuration/translation.html | source: cs/getting-started/advanced-configuration/translation.md --> # Automatický překlad obsahu ## Přehled Tato funkce integruje do jádra aplikace možnosti automatického překladu a umožňuje administrátorům obchodu překládat obsah webu do více jazyků pomocí dvou nejoblíbenějších platforem strojového překladu: **DeepL** a **Google Translate**. V současné době je automatický překlad podporován pro následující entity: - Kategorie - Výrobce - Produkt - Atribut produktu - Atribut specifikace ## Konfigurace Všechna nastavení této funkce se nacházejí na stránce **Obecná nastavení** (General settings) v sekci **Překlad** (Translation). ![Překlad](_static/translation/settings.png) Mezi klíčové možnosti konfigurace patří: - **Povolit předběžný překlad** (Allow to pre-translate): Hlavní přepínač pro zapnutí nebo vypnutí celé funkce překladu. - **Překládat z jazyka** (Translate from the language): Na kartě „standardní“ můžete určit výchozí jazyk, ze kterého budou generovány všechny překlady. - **Ignorované jazyky** (Languages to ignore): Seznam jazyků, které mají být z procesu automatického překladu vyloučeny. - **Překladová služba** (Translation service): Rozbalovací nabídka pro výběr překladové služby, která se má použít (DeepL nebo Google Translate). - **DeepL**: Vyžaduje **ověřovací klíč** (Auth key). - **Google Translate**: Vyžaduje **API klíč** (API key). > [!NOTE] > > Systém automaticky nepřeloží pole, které již obsahuje ručně uloženou hodnotu. ## Jak funkci používat Jakmile je funkce povolena, její používání je velmi jednoduché. Na stránkách úprav všech podporovaných entit se v hlavním kontejneru tlačítek objeví nové tlačítko. Například na stránce úprav produktu vypadá takto: ![Překlad](_static/translation/pretranslate.png) 1. Klikněte na tlačítko **„Předběžně přeložit“** (Pre-translate). 1. Pokud je překlad úspěšný, zobrazí se potvrzující zpráva. Lokalizovaná pole pro ostatní jazyky budou vyplněna přeloženým textem. ![Překlad](_static/translation/translate.png) 1. Pokud během překladu dojde k chybě, zobrazí se varovná zpráva. ![Překlad](_static/translation/error.png) > [!WARNING] > > Je důležité si uvědomit, že tato funkce slouží jako nástroj pro **předběžný překlad**. Přeložený obsah se doplní do polí, ale **neuloží se automaticky**. Uživatel tak má plnou kontrolu nad tím, zda překlady zkontroluje, upraví nebo zahodí, než změny ručně uloží. --- <!-- page: PayPal Commerce | url: http://nopdocs.service.hedr.dev/cs/getting-started/configure-payments/payment-methods/paypal-commerce-old-version.html | source: cs/getting-started/configure-payments/payment-methods/paypal-commerce-old-version.md --> > [!NOTE] > > Tato stránka dokumentace popisuje staré verze pluginu (před 4.70.10). Aktuální dokumentaci naleznete na [této stránce](xref:cs/getting-started/configure-payments/payment-methods/paypal-commerce). # PayPal Commerce `PayPal Commerce` nabízí vašim kupujícím zjednodušené a bezpečné prostředí pokladny. PayPal automaticky a inteligentně zobrazuje vašim nakupujícím nejrelevantnější platební typy, takže mohou snáze dokončit nákup pomocí metod, jako jsou Pay with Venmo, PayPal Credit, platby kreditní kartou, iDEAL, Bancontact, Sofort a další platební typy. ## Konfigurace platební metody Chcete-li nakonfigurovat plugin `PayPal Commerce`, přejděte do **Konfigurace → Platební metody** (Configuration → Payment methods). Poté v seznamu platebních metod najděte platební metodu **PayPal Commerce**: ![Seznam](_static/paypal-commerce-old-version/list.jpg) Při konfiguraci `PayPal Commerce` postupujte podle těchto kroků: ### 1. Aktivace platební metody Klikněte na tlačítko **Upravit** (Edit) v řádku pluginu na stránce seznamu platebních metod. Aktivujte plugin zaškrtnutím políčka **Je aktivní** (Is active). Klikněte na tlačítko **Aktualizovat** (Update). Vaše změny budou uloženy. ### 2. Vytvoření účtu PayPal Pokud již máte účet PayPal, pokračujte do [další sekce](#3-set-up-the-paypal-developer-dashboard). Pokud ne, zaregistrujte si firemní účet (Business). Máte dvě možnosti: účet můžete zaregistrovat na webu PayPal, nebo to můžete provést z konfigurační stránky pluginu. Pojďme stručně projít obě možnosti: #### Registrace účtu na webu PayPal 1. Zaregistrujte si firemní účet na [PayPal](https://www.paypal.com/us/webapps/mpp/referral/paypal-business-account2?partner_id=9JJPJNNPQ7PZ8). Stačí tam kliknout na tlačítko **Sign up**: ![Registrační stránka](_static/paypal-commerce-old-version/sign-up-page.png) 1. Poté vyplňte informace o sobě a svém podnikání: ![Registrační formulář](_static/paypal-commerce-old-version/sign-up-form.png) > [!NOTE] > > Pokud již účet máte, budete přesměrováni na přihlášení. #### Registrace účtu z konfigurační stránky pluginu 1. Otevřete v administraci konfigurační stránku PayPal Commerce. Zobrazí se následující formulář: ![Konfigurační stránka PayPal Commerce](_static/paypal-commerce-old-version/auto-configure.jpg) 1. Zadejte svou e-mailovou adresu a kliknutím na tlačítko **Uložit** (Save) nechte PayPal vše zkontrolovat. 1. Pokud je vše v pořádku, zobrazí se následující zelené oznámení a nově přidané tlačítko **Sign up for PayPal**: ![Když je e-mail již zadán](_static/paypal-commerce-old-version/configure-entered-email.png) 1. Klikněte na toto tlačítko a zobrazí se následující vyskakovací okno, ve kterém můžete vyplnit potřebné údaje a zaregistrovat účet: ![Konfigurační stránka PayPal Commerce](_static/paypal-commerce-old-version/popup-form-first-page.png) K vyplnění všech požadovaných údajů musíte projít několika kroky. V posledním z nich budete požádáni o potvrzení e-mailu pro aktivaci účtu. <a id="3-set-up-the-paypal-developer-dashboard"></a> ### 3. Nastavení PayPal Developer Dashboard 1. Přihlaste se do [Developer Dashboard](https://developer.paypal.com/developer/applications?partner_id=9JJPJNNPQ7PZ8) pomocí přihlašovacích údajů ke svému účtu PayPal. 1. V **My Apps & Credentials** pomocí přepínače přepínejte mezi živými (live) a sandboxovými testovacími aplikacemi. ![My Apps & Credentials](_static/paypal-commerce-old-version/my-apps.jpg) 1. Přejděte do sekce *REST API apps* a klikněte na **Create App**. ![Create App](_static/paypal-commerce-old-version/rest.jpg) 1. Zadejte název své aplikace a klikněte na **Create App**. Otevře se stránka s detaily aplikace a zobrazí vaše přihlašovací údaje. 1. Zkopírujte a uložte si **Client ID** a **Secret** své aplikace. 1. Zkontrolujte detaily aplikace a pokud jste provedli nějaké změny, aplikaci uložte. ### 4. Konfigurace platební metody v nopCommerce 1. Najděte platební metodu **PayPal Commerce** na stránce **Konfigurace → Platební metody** (Configuration → Payment methods) a klikněte na **Konfigurovat** (Configure). Zobrazí se stránka *Konfigurovat - PayPal Commerce* (Configure - PayPal Commerce) takto: ![Konfigurace](_static/paypal-commerce-old-version/configure.jpg) 1. Na stránce *Konfigurovat - PayPal Commerce* definujte následující nastavení: * **Zadat přihlašovací údaje API ručně** (Specify API credentials manually) – určete, zda potřebujete přihlašovací údaje nastavit ručně. Tuto možnost vyberte, pokud již máte vytvořenou aplikaci nebo pokud chcete používat režim sandbox. V opačném případě se plugin nastaví automaticky a po dokončení registrace v PayPal budete moci ve svém obchodě začít přijímat platby PayPal. ![Automatická konfigurace](_static/paypal-commerce-old-version/auto-configure.jpg) * **Použít sandbox** (Use sandbox), pokud chcete platební metodu nejprve otestovat. * Zadejte **Client ID**, které jste si uložili v předchozích krocích. * Zadejte **Secret**, který jste si uložili v předchozích krocích. * Zvolte **Typ platby** (Payment type), chcete-li platbu buď zachytit (capture) okamžitě, nebo platbu za objednávku po jejím vytvoření pouze autorizovat. 1. Poté přejděte na panel *Výrazné zobrazení PayPal* (PayPal Prominently): ![Create App](_static/paypal-commerce-old-version/display.jpg) Na tomto panelu definujte nastavení zobrazení: * Zaškrtněte políčko **Zobrazit tlačítka v nákupním košíku** (Display buttons on shopping cart), chcete-li na stránce nákupního košíku zobrazit tlačítka PayPal místo výchozího tlačítka pokladny. * Zaškrtněte **Zobrazit tlačítka v detailu produktu** (Display buttons on product details), chcete-li zobrazit tlačítka PayPal na stránkách s detaily produktu; kliknutí na ně se chová stejně jako výchozí tlačítko „Přidat do košíku“. * Zaškrtněte políčko **Zobrazit zprávy Pay Later** (Display Pay Later messages), chcete-li na svém webu využít funkci zpráv o platbě později. Zpráva se zobrazuje na stránkách produktu a pokladny a ukazuje, kolik zákazník zaplatí ve čtyřech splátkách. ![Zprávy Pay Later](_static/paypal-commerce-old-version/pay_later.jpg) * Zaškrtněte políčko **Zobrazit logo v odkazech záhlaví** (Display logo in header links), chcete-li v odkazech záhlaví zobrazit logo PayPal. Tato loga a bannery jsou skvělým způsobem, jak dát kupujícím najevo, že k bezpečnému zpracování jejich plateb jste zvolili PayPal. * Je-li předchozí políčko zaškrtnuto, zobrazí se pole **Zdrojový kód loga** (Logo source code). Do tohoto pole zadejte zdrojový kód loga. Další loga a bannery najdete v PayPal Logo Center. Kód můžete také upravit tak, aby správně zapadal do vašeho motivu a stylu webu. * Zaškrtněte políčko **Zobrazit logo v patičce** (Display logo in footer), chcete-li v patičce zobrazit logo PayPal. Tato loga a bannery jsou skvělým způsobem, jak dát kupujícím najevo, že k bezpečnému zpracování jejich plateb jste zvolili PayPal. * Je-li předchozí políčko zaškrtnuto, zobrazí se pole **Zdrojový kód loga** (Logo source code). Do tohoto pole zadejte zdrojový kód loga. Další loga a bannery najdete v PayPal Logo Center. Kód můžete také upravit tak, aby správně zapadal do vašeho motivu a stylu webu. Kliknutím na **Uložit** (Save) uložte nastavení pluginu. ## Omezení na obchody a role zákazníků Jakoukoli platební metodu můžete omezit na obchod a roli zákazníka. To znamená, že metoda bude k dispozici pouze určitým obchodům nebo rolím zákazníků. Můžete to provést na stránce *seznamu pluginů*. 1. Přejděte do **Konfigurace → Lokální pluginy** (Configuration → Local plugins). Najděte plugin, který chcete omezit. V našem případě jde o **PayPal Commerce**. Pro rychlejší nalezení použijte panel *Hledat* (Search) v horní části stránky a vyhledávejte podle **Názvu pluginu** (Plugin name) nebo **Skupiny** (Group) pomocí možnosti *Platební metody* (Payment methods). ![Pluginy](_static/paypal-commerce-old-version/plugins.jpg) 1. Klikněte na tlačítko **Upravit** (Edit) a zobrazí se okno *Upravit detaily pluginu* (Edit plugin details) takto: ![Úprava](_static/paypal-commerce-old-version/edit.jpg) 1. Můžete nastavit následující omezení: * V poli **Omezeno na role zákazníků** (Limited to customer roles) zvolte jednu nebo několik rolí zákazníků, tj. administrátory, dodavatele, hosty, kteří budou moci tento plugin používat. Pokud tuto možnost nepotřebujete, ponechte pole prázdné. > [!Important] > > Abyste mohli tuto funkci používat, musíte vypnout následující nastavení: **Nastavení katalogu → Ignorovat pravidla ACL (pro celý web)** (Catalog settings → Ignore ACL rules (sitewide)). Přečtěte si více o [seznamu řízení přístupu](xref:cs/running-your-store/customer-management/access-control-list). * Pomocí možnosti **Omezeno na obchody** (Limited to stores) omezíte tento plugin na určitý obchod. Pokud máte více obchodů, vyberte ze seznamu jeden nebo několik. Pokud tuto možnost nepoužíváte, ponechte pole prázdné. > [!Important] > > Abyste mohli tuto funkci používat, musíte vypnout následující nastavení: **Nastavení katalogu → Ignorovat pravidla „omezení na obchod“ (pro celý web)** (Catalog settings → Ignore "limit per store" rules (sitewide)). Přečtěte si více o [funkcionalitě více obchodů](xref:cs/getting-started/advanced-configuration/multi-store). Klikněte na **Uložit** (Save).