Drupal a Webform: jak zpracovávat data z formulářů pomocí PHP

Vytvoření webového formuláře pomocí modulu Webform je čistě klikací záležitost. Webform poskytuje různé typy políček, od textových, k různým vybíračkám. Umí také validovat základní vstupní formáty, další kontrolu zadaných dat si pro formulář doplníte pomocí vlastního kódu v PHP. Stačí jej doplnit do nastavení formuláře.

Nevýhodou formuláře Webform je „nemožnost" ihned zpracovat data vyplněná pomocí tohoto modulu. Typickým požadavkem je zpracování vstupu od uživatele a jeho následné zobrazení nebo využití na jiné stránce v rámci webu. Pokud něco potřebujete, je podle mého názoru vhodnější připravit si vlastní modul přímo na míru. Ovšem v některých případech si vystačíte i s Webformem. Nemožnost zpracovat vložená data je totiž jen zdánlivá. Stačí základní znalosti PHP pro práci se sessions. Jak na to?

Uložení dat z Webformu do sessions

V první řadě si tedy nainstalujte modul Webform a naklikejte si jeho prostřednictvím formulář. V následujícím textu budu předpokládat, že tuto základní činnost zvládnete bez problémů. Kdyžtak vše potřebné najdete v mé knize o Drupalu.

Při definici políček ve Webformu se ujistěte, že vzniknou se srozumitelným strojovým názvem, který využijete při dalším zpracování. Najdete jej při definici nového prvku formuláře v sekci Pokročilé volby jako Identifikátor pole. Pro příklad použiji formulář s jediným políčkem, které bude mít identifikátor nastavený na jmeno.

Drupal a Webform

Po vytvoření políček se přepněte zpátky do Konfigurace formuláře. Rozklepněte sekci Pokročilá nastavení a najděte pole Dodatečné zpracování. Sem vložte kód, kterým budete data z formuláře nějakým způsobem zpracovávat. K dispozici máte pole $form a $form_state, se kterými lze mimochodem pracovat stejným způsobem, jako při tvorbě samostatného modulu a nějakého formuláře.

Obsah pole $form_state udržujícího vyplněné hodnoty si zobrazíte příkazem print_r následovně:

<?php
print '<pre>';
print_r($form_state);
print '</pre>';
die;
?>

Příkaz die je na konci uveden zcela záměrně. Zastaví totiž následné provádění skriptů, takže vám zůstane jen bílá stránka s obsahem pole. Značky <pre></pre> zajistí přehledné zformátování tohoto výstupu.

Jak tedy zjistíte, hodnoty z políček jsou uloženy ve $form_state['values']['submitted_tree']. S touto znalostí je můžete jednoduše uložit do sessions. Předchozí kód vypisující obsah z formulářového pole odstraňte a namísto něj vložte kód, který nejprve nastartuje práci se sessions a poté do jednotlivých session uloží hodnoty z políček. V naší ukázce uložíme jen jednu hodnotu, a to z políčka pro zadání jména:

<?php
session_start();
$_SESSION['jmeno'] = $form_state['values']['submitted_tree']['jmeno'];
?>

Nyní jsou hodnoty z formuláře uloženy v session a může dojít k přesměrování na stránku, kde je zpracujete. V konfiguraci Webformu zadejte adresu této stránky do pole Potvrzovací zpráva nebo uzel pro přesměrování a stránku se zadanou adresou v Drupalu vytvořte.

Zpracování dat ze sessions

Vytvořte novou stránku na adrese, kterou jste ve Webformu nastavili pro přesměrování vyplněného formuláře. Do stránky vložte kód, který data ze sessions načte a následně je zobrazí. Následující ukázka opět nastartuje práci se sessions a následně zobrazí řetězec, ke kterému doplní hodnotu načtenou ze session. Konkrétně v předchozím kroku uložené jméno z formuláře:

<?php
session_start();
print 'Zadané jméno je '.$_SESSION['jmeno'];
?>

Nyní můžete celou kombinaci vyzkoušet. Protože kód ve stránce se provede i v případě, že někdo zadá přímo její adresu bez toho, že by nejprve vyplnil formulář, můžete jej vylepšit následujícím způsobem. Doplňte podmínku ověřující, že je zadána nějaká hodnota v sessions (které nastavilo zpracování formuláře). Pokud tomu tak nebude, dojde k nastavení upozorňujícího hlášení a přesměrování na stránku s formulářem:

{syntaxhighlighter brush:php} <?php session_start(); if ($_SESSION['jmeno'] == NULL || $_SESSION['jmeno'] == '') { drupal_set_message('Nejprve musíte vyplnit formulář'); drupal_goto('node/12'); } print 'Zadané jméno je '.$_SESSION['jmeno']; ?> {/syntaxhighlighter}

Adresu node/12 si samozřejmě upravte tak, aby došlo k přesměrování na uzel ve vašem webu. Kód v této ukázce je velmi jednoduchý, ale věřím, že vám pomůže pochopit způsob zpracování dat z formuláře a brzy se v komentářích pochlubíte, kde jste jej prakticky využili.