Entityform: jak na lepší formuláře v Drupalu (+ videnonávod)

Modul Webform mám rád. Stále jej používám na většině webů, které stavím. Je odladěný, existuje pro něj řada doplňků, snadno se používá. Vytvoříte obsahový uzel, přiřadíte k němu formulářová políčka, data od lidí sbíráte do Excelu a případně si je necháváte odesílat na mail.

Nevýhodou Webformu je však jeho odlišný přístup k práci s políčky. Zřejmě z historických důvodů využívá vlastní implementaci formulářových polí na rozdíl od zbytku Drupalu a dalších modulů, které staví na entitách a formulářových polích pro ně. Z toho vyplývá, že nemůžete využívat výhod, které to nabízí.

Když si tedy do Drupalu nainstalujete například modul Link přidávající políčko pro zadávání webové adresy, nebudete jej moci automaticky použít ve formulářích tvořených Webformem. Podobně pole pro telefon či adresu, a to už vůbec nemluvím o „vícepolíčkových“ polích, které jste si schopni sami sestrojit díky Field collection.

Jelikož Webform nepoužívá drupalovské entity, tak vůbec není jednoduché dostat data z něj odeslaná například do Views. Chcete-li údaje z formuláře zobrazovat v nějakém výpisu, musíte buď sáhnout přímo do databáze, nebo použít poměrně složité řešení na propojení Webformu a Views. Navíc není úplně komfortní.

Entityform jako vylepšené formuláře pro Drupal

Tohle všechno výše uvedené však řeší modul Entityform. Funguje podobně jako Webform, tedy vytvoříte si úvodní nadpis a text k formuláři, přidáte k němu políčka a data z formuláře se vám pak ukládají do databáze.

Typy políček v tomto formuláři vycházejí z toho, co máte momentálně ve svém Drupalu dostupné. Propojení s Views je bez problémů. O něco složitější je konfigurace mailů, které mají odcházet po vyplnění formuláře. Na druhou stranu se zde využívá spojení s modulem Rules, takže při troše snahy jste schopni nastavit flexibilnější pravidla pro mailování.

Tvorba formuláře s Entityform krok za krokem

1. Modul Entityform vyžaduje k instalaci také moduly Views a Entity API. Předpokládám, že tyto ale už ve své instalaci Drupalu stejně máte.
2. Budete-li chtít zprovoznit také e-mailová upozornění po vyplnění formuláře, doinstalujte si ještě moduly Entity_rules, Entity To Text a Rules.
3. Zapněte součástky Entityforms (základ formulářů) a Entityforms Notifications (chcete-li posílat e-mailová upozornění).
4. Přejděte do nové administrační části Struktura > Entityform Types > Add Entityform Type, kde vytvoříte nový formulář. Vyplňte jeho název, cestu, na kterou se má případně přesměrovat, pokud nechcete vidět standardní stránku po vyplnění tohoto formuláře. Zadejte rovněž volitelný popisek zobrazený nad formulářem.
   
5. Ve spodní části definice formuláře najdete několik vertikálních záložek s nastavením. Nejprve určete, které uživatelské role mohou formulář vyplňovat. Na dalších kartách nastavte titulek a text děkovací stránky (aplikuje se v případě, že jste nahoře nenastavili redirekt). Můžete rovněž upravit URL adresy pro zobrazení formuláře a přepsat texty tlačítek ve formuláři.
6. Po uložení jste v rámci formuláře přesunuti na kartu Správa polí, kam se ostatně můžete vrátit i později přes Struktura > Entityform Types. Zde zadáváte konkrétní políčka ve formuláři, podobně, jako když je definujete u typů obsahu. Všimněte si, že můžete kombinovat skutečně všechny typy polí, které nabízí jádro Drupalu i doplňkové moduly.
   
7. Na kartě Správa zobrazení zase nastavíte zobrazení políček poté, co si někdo prohlédne stránku s odeslanými údaji.

Tím je formulář hotov. Zobrazíte si jej na adrese, kterou jste zvolili v položce Nastavení URL > Submit URL alias v základním nastavení formuláře při jeho vytváření. Pokud si ji nepamatujete, najdete ji v Struktura > Entityform Types pod odkazem Submit link. Výsledek může vypadat například takto:

Tip: Často používám umístění formuláře do nějakého bloku, který mohu zobrazit na libovolné jiné URL adrese u jiného obsahu. Tuto funkcionalitu vám doplní modul Entityform block, aktivaci formuláře coby bloku najdete při jeho vytváření nebo editaci ve vertikálních záložkách.

Prohlížení dat z formuláře

Údaje, které lidé do formuláře napsali, si můžete prohlédnout poté, co použijete odkaz Uložené výsledky v administrační části Struktura > Entityform Types. Uvidíte zde jména uživatelů, kteří formulář odeslali. Po klepnutí na odkaz Zobrazit pak i konkrétní údaje.

K dispozici je i tabulkové zobrazení v horní části administračního přehledu. Data jsou pak zobrazena v následující podobě:

Odeslání e-mailu po vyplnění formuláře

Jestliže jste aktivovali i součástku, která slouží k odesílání e-mailového upozornění na vyplněný formulář, postupujte k dokončení tohoto nastavení následovně:

1. V editaci formuláře se přepněte na záložku Rules. Z nabídky si vyberte, zda chcete přidat mailovací pravidlo pro admina nebo pro toho, kdo formulář vyplnil. Vyzkoušíme upozornění pro administrátora. Vyberte tedy volbu Entityform Notification Email Admin a klepněte na tlačítko Přidat.
2. V seznamu přibude nový řádek, ve kterém vyplňte předmět e-mailu, tělo e-mailu a adresu, na kterou se má odeslat. Rovněž můžete zapnout volbu Show Submission, kterou připojíte data z formuláře k tělu e-mailu.
   

Těch pravidel pro mailování si můžete přidat opakovaně celou řadu. Pokud umíte pracovat s modulem Rules a chcete se podívat trochu hlouběji, jak jsou tato pravidla definována, případně si vytvořit úplně nové na míru, koukněte se do administrační části Nastavení > Postup práce > Entity Rules a přepněte se tam na záložku Entityform Submission Rules.

Zobrazení dat z formuláře ve Views

Vzhledem k tomu, že Entityform, jak název napovídá, pracuje s entitami v Drupalu, není problém data z formuláře zpracovat pomocí Views. Vyzkoušíme si vytvoření nového administračního přehledu pro konkrétní formulář s využitím AJAXu a uživatelského filtrování.

1. Zavolejte funkci Struktura > Views > Přidat nový pohled. V nabídce, co chcete ukázat, si místo obsahu zvolte Entityform Submission. Aby se vám do zobrazení nedostala data ze všech formulářů definovaných tímto modulem, tak z nabídky Typu zvolte konkrétní formulář. Dále si nastavte adresu, na které bude pohled na data zobrazen a jako Formát zobrazení použijte Tabulku. Klepněte na tlačítko Pokračovat a upravit.
2. V upřesňujícím nastavení pohledu přidejte do Polí jednotlivá políčka z formuláře. Nechejte zobrazeny jejich popisky, aby se vám nadepsaly sloupečky tabulky.
3. Já mám ve formuláři položku Věk, takže si zkusím vytvořit filtrování na základě věku odesilatelů. Máte-li to podobně, pak přidejte nové filtrovací kritérium podle hodnot políčka Věk, zapněte volbu Expose, nadepište název filtrovacího políčka a zapněte rovněž volbu Expose operator.
4. V sekci Pokročilé > Jiné zapněte volbu Použít AJAX. Nakonec nezapomeňte upravit pravidla pro přístup k tomuto pohledu tak, aby si je mohl zobrazit pouze správce obsahu na webu. Tedy klepněte v prostřední části nahoře na Přístup: Žádné a nastavte zde Oprávnění: Spravovat obsah.
5. Pohled uložte a přejděte na adresu, kterou jste zvolili pro jeho zobrazení. Výsledek by měl být takovýto:
   

Tolik tedy k vytváření formulářů pomocí modulu Entityform, odesílání e-mailového upozornění a zobrazování odeslaných dat pomocí modulu Views. Pokud dáte přednost videonávodu před stručným popisem, můžete si jej pustit z mého YouTube kanálu.

Na videu ukazuji i využití modulu Address Field. Entityform pro Drupal 8 funguje podobně, jen se jmenuje EForm.