--- site_name: Toret dokumentace site_url: https://documentation.toret.cz contact_email: info@toret.cz title: Dokumentace pluginu Toret Smart Emailing url: https://documentation.toret.cz/smart-emailing/ date: 2024-06-21 modified: 2026-10-23 author: tcirkl type: page --- # Dokumentace pluginu Toret Smart Emailing Nacházíte se na stránkách dokumentace pluginu Smart Emailing pro WooCommerce, který **automaticky propojí WooCommerce obchod a službu Smart Emailing.** Plugin Smart Emailing zakoupíte zde: [Toret Smart Emailing pro WooCommerce](https://toret.cz/produkt/woo-smart-emailing/) Obsah 1. Minimální požadavky 2. Instalace pluginu 3. Aktivace pluginu 4. Nastavení pluginu - Připojení ke Smart Emailingu - - Přiřazování kontaktů do seznamů - - Souhlas v pokladně a odesílání kontaktu - - Double opt-in - - Vlastní pole 5. Seznamy u produktu a varianty 6. Odesílání kontaktů a kontrola v objednávce 7. Testování pluginu ## Minimální požadavky - WordPress 6.9 nebo vyšší - WooCommerce 11.0 nebo vyšší - PHP 8.2 nebo vyšší ## Instalace pluginu Po zakoupení pluginu obdržíte e-mailem licenční klíč a odkaz na stažení zip souboru s pluginem. Detailní návod, jak do WordPress nainstalovat plugin z počítače, najdete [zde](https://documentation.toret.cz/instalace-pluginu/). Na starší verzi PHP se plugin nenačte a v administraci zobrazí upozornění – v takovém případě požádejte svůj hosting o přepnutí na novější PHP. ## Aktivace pluginu Po instalaci pluginu si otevřete plugin Smart Emailing pro WooCommerce *(Toret plugins > Smart Emailing)*, do příslušného pole vložte licenční klíč a klikněte na *Ověřit licenci*. ![Plugin Toret Smart E-mailing - aktivace licence](https://documentation.toret.cz/wp-content/uploads/2026/09/Plugin-Toret-Smart-Emailing-%E2%80%93-aktivace-licence.png "Plugin Toret Smart E-mailing - aktivace licence") ## Nastavení pluginu Po instalaci a aktivaci pluginu je třeba napojit plugin na Smart Emailing. To, stejně jako aktivaci, provedete v pluginu *(Toret plugins > Smart Emailing).* Díky propojení bude moci služba Smart Emailing vytvářet kontakty na zákazníky e-shopu. ### Připojení ke Smart Emailingu - Api klíč – vložte API klíč ze Smart Emailing. - Přihlašovací e-mail – vložte e-mail, pod kterým se přihlašujete na Smart Emailing. Obě pole nejprve **uložte** tlačítkem *Uložit* a poté klikněte na *Ověřit připojení* (dole na stránce). Plugin zkontroluje, že jsou přihlašovací údaje platné. Po úspěšném ověření se do nabídek v nastavení načtou seznamy kontaktů, účely a vlastní pole z vašeho účtu Smart Emailing. ![Plugin Toret Smart Emailing – napojení na API](https://documentation.toret.cz/wp-content/uploads/2026/09/Plugin-Toret-Smart-Emailing-%E2%80%93-napojeni.png "Plugin Toret Smart Emailing – napojení na API") Pokud ve Smart Emailingu později založíte nový seznam, účel nebo vlastní pole, klikněte na *Znovu načíst seznamy ze Smart Emailingu*, aby se v nastavení pluginu objevily. ### Přiřazování kontaktů do seznamů Další nastavení se týká propojení WooCommerce a služby: **Režim přiřazování do seznamů** – určuje, do kterých seznamů se kontakt zákazníka po objednávce přidá: *Pouze globální seznamy* – každý zákazník se přidá do seznamů vybraných níže v poli *Seznamy kontaktů*. --- *Dle produktu — vyhrává poslední produkt se seznamy* – seznamy se nastavují v detailu produktu (nebo varianty). Pokud objednávka obsahuje více produktů se seznamy, použijí se seznamy posledního takového produktu v objednávce. Vhodné, pokud zákazníci kupují po jednom produktu. --- *Všechny seznamy všech produktů v objednávce* – kontakt se přiřadí do seznamů všech produktů (nebo variant) v objednávce. --- --- **Přiřadit zároveň i do globálních „Seznamů kontaktů“** – doplňková volba k režimu *Všechny seznamy všech produktů v objednávce*. Kontakt se kromě seznamů produktů přidá také do seznamů vybraných v poli *Seznamy kontaktů*. --- **Automaticky vyjmout kontakt z blacklistu** – pokud bude vytvořena objednávka s kontaktem, který je v blacklistu Smart Emailing, při aktivaci této funkce bude z blacklistu vyjmut a zařazen do aktivního seznamu. --- **Nikdy znovu nepřihlašovat odhlášené kontakty** – doporučujeme nechat zapnuté. Nová objednávka pak nepřepíše dřívější odhlášení kontaktu ze seznamu ve Smart Emailingu. --- **Seznamy kontaktů** – vyberte jeden nebo více seznamů, do kterých chcete přidat každého zákazníka (více seznamů vyberete s podrženou klávesou Ctrl, na Macu Cmd). Pole se použije v režimu *Pouze globální seznamy* a pro volbu *Přiřadit zároveň i do globálních „Seznamů kontaktů“*; v ostatních režimech se ignoruje. --- **Účel souhlasu** – vyberte účel zpracování osobních údajů. Účel musíte nejprve vytvořit ve Smart Emailingu v sekci *Kontakty a Seznamy → Účely zpracování osobních údajů*. --- **Platnost souhlasu (dny)** – počet dní, po které bude souhlas k vybranému účelu platný. Pokud pole necháte prázdné, použije se výchozí platnost nastavená ve Smart Emailingu. --- **Jazyk** – vyberte jazyk kontaktu (čeština, slovenština nebo angličtina). --- ![Plugin Toret Smart Emailing – přiřazování do seznamů](https://documentation.toret.cz/wp-content/uploads/2026/09/Plugin-Toret-Smart-Emailing-%E2%80%93-seznamy-kontaktu-ucel-souhlasu-a-souhlas-v-pokladne.png "Plugin Toret Smart Emailing – přiřazování do seznamů") ### Souhlas v pokladně a odesílání kontaktu **Zobrazit souhlas na stránce pokladny** – v případě, že nebude zaškrtnuto, bude kontakt vytvořen automaticky po každé objednávce. V opačném případě se v pokladně zobrazí vámi zadaný text (v poli *Text souhlasu*) a zaškrtávací pole pro souhlas; kontakt se odešle jen tehdy, když zákazník souhlas zaškrtne. Souhlas funguje v klasické pokladně i v blokové pokladně WooCommerce. --- **Text souhlasu** – zadejte text pro zobrazení souhlasu v pokladně (např. *Souhlasím s odběrem novinek* atp.). --- **Předzaškrtnout souhlas?** – zde nastavíte, zda bude pole pro souhlas v pokladně předem zaškrtnuté, nebo jej bude muset zákazník aktivně zaškrtnout. --- **Kdy odesílat kontakt do Smart Emailingu** – nastavení spouštěče pro odesílání do Smart Emailingu (*Na děkovné stránce* / *Při označení objednávky – Zpracovává se* / *Při označení objednávky – Dokončena*). --- Do Smart Emailingu se u kontaktu předává e-mail, jméno a příjmení, fakturační adresa, telefon a zvolený jazyk zákazníka. ![Plugin Toret Smart Emailing – souhlas v pokladně](https://documentation.toret.cz/wp-content/uploads/2026/09/Plugin-Toret-Smart-Emailing-%E2%80%93-souhlas-v-pokladne-1024x165.png "Plugin Toret Smart Emailing – souhlas v pokladně") ### Double opt-in Při zapnutém double opt-in dostane zákazník potvrzovací e-mail a kontakt se do seznamu uloží až po kliknutí na odkaz v něm. **Bez potvrzení se kontakt ve Smart Emailingu vůbec nevytvoří.** Volbu nechte vypnutou, pokud potvrzení už řešíte automatizací přímo ve Smart Emailingu – jinak by zákazníkům chodily dva potvrzovací e-maily. - Použít double opt-in – zapne potvrzování souhlasu e-mailem. - ID potvrzovacího e-mailu – ID potvrzovacího e-mailu, který jste si vytvořili ve Smart Emailingu. Pro double opt-in je povinné. - E-mail odesílatele,Jméno odesílatele,E-mail pro odpověď – volitelné údaje odesílatele potvrzovacího e-mailu. ![Plugin Toret Smart Emailing – double opt-in](https://documentation.toret.cz/wp-content/uploads/2026/09/Plugin-Toret-Smart-Emailing-%E2%80%93-double-opt-in-1024x247.png "Plugin Toret Smart Emailing – double opt-in") ### Vlastní pole Plugin umí spolu s kontaktem odeslat i vybrané údaje z objednávky do **vlastních polí** ve Smart Emailingu. V každém řádku vlevo vyberte údaj z objednávky a vpravo vlastní pole ve Smart Emailingu, do kterého se má uložit. Prázdné řádky se ignorují. Vlastní pole si nejprve vytvořte ve svém účtu Smart Emailing a poté v pluginu klikněte na *Znovu načíst seznamy ze Smart Emailingu*. K dispozici jsou tyto údaje objednávky: číslo objednávky, celková cena objednávky, měna, datum objednávky, platební metoda, doprava, fakturační firma, kód země fakturace a poznámka zákazníka. Dbejte na to, aby typ vlastního pole ve Smart Emailingu odpovídal údaji (např. cenu ukládejte do číselného pole, datum do pole typu datum). Po každé změně nastavení nezapomeňte kliknout na *Uložit*. ![Plugin Toret Smart Emailing – vlastní pole](https://documentation.toret.cz/wp-content/uploads/2026/09/Plugin-Toret-Smart-Emailing-%E2%80%93-vlastni-pole-1024x303.png "Plugin Toret Smart Emailing – vlastní pole") ## Seznamy u produktu a varianty Pokud používáte režim *Dle produktu* nebo *Všechny seznamy všech produktů v objednávce*, nastavíte seznamy přímo v detailu produktu *(Produkty > Upravit produkt)* v panelu **Smart Emailing seznamy** v pravém sloupci: **Smart Emailing seznamy** – vyberte jeden nebo více seznamů, do kterých se přidají kontakty z objednávek obsahujících tento produkt. --- **Minimální počet kusů** – seznamy se použijí jen tehdy, když objednávka obsahuje alespoň tento počet kusů produktu. Prázdné pole = libovolný počet. --- ![Plugin Toret Smart Emailing – nastavení v detailu produktu](https://documentation.toret.cz/wp-content/uploads/2026/09/Plugin-Toret-Smart-Emailing-%E2%80%93-nastaveni-v-detailu-produktu.png "Plugin Toret Smart Emailing – nastavení v detailu produktu") U produktů s variantami můžete seznamy nastavit i pro **každou variantu zvlášť** – v záložce *Varianty* otevřete danou variantu a v polích *Smart Emailing seznamy (přebíjí produkt)* a *Minimální počet kusů* zvolte seznamy pro tuto variantu. Nastavení na variantě má přednost před nastavením produktu; varianta bez vybraných seznamů použije seznamy nadřazeného produktu. ## Odesílání kontaktů a kontrola v objednávce Kontakty se do Smart Emailingu odesílají na pozadí, takže neprodlužují dokončení objednávky. Pokud se odeslání nezdaří (např. při dočasném výpadku služby), plugin je automaticky několikrát zopakuje. V detailu každé objednávky najdete panel **Smart Emailing** s přehledem, do kterých seznamů byl kontakt odeslán, a s logem jednotlivých pokusů (čas, výsledek a seznam). Tlačítkem *Odeslat znovu* můžete kontakt z objednávky odeslat ručně – například když byla objednávka vytvořena před nastavením pluginu nebo když odeslání selhalo. Seznamy, do kterých už byl kontakt odeslán, se při tom přeskočí. ![Plugin Toret Smart Emailing – nastavení v detailu objednávky](https://documentation.toret.cz/wp-content/uploads/2026/09/Plugin-Toret-Smart-Emailing-%E2%80%93-nastaveni-v-detailu-objednavky.png "Plugin Toret Smart Emailing – nastavení v detailu objednávky") Kromě automatického odesílání kontaktů je možné také využít hromadné akce *Odeslat do Smart Emailingu* z přehledu objednávek – označte objednávky, v nabídce *Hromadné akce* zvolte *Odeslat do Smart Emailingu* a klikněte na *Použít*. I zde platí nastavený režim přiřazování, souhlas zákazníka i přeskakování již odeslaných seznamů. ![Plugin Toret Smart Emailing – hromadná akce](https://documentation.toret.cz/wp-content/uploads/2026/09/Plugin-Toret-Smart-Emailing-%E2%80%93-hromadna-akce.png "Plugin Toret Smart Emailing – hromadná akce") ## Testování pluginu Pro účely testování můžete využít: - subdoménu “dev.doménalicence” (se stejnou licencí jako pro produkční web) - localhost (127.0.0.1) Na těchto umístěních budou zakoupené pluginy fungovat také a můžete zde otestovat implementaci a kompatibilitu před ostrým nasazením na web i v průběhu jeho užívání.