0 Kč s DPH

2. Podrobný popis parametrů

Nestačí Vám pro komunikaci s návštěvníky Vašich stránek Kontakní formulář systému inPage? Ačkoliv je tento prvek inPage dostatečně variabilní, můžou nastat situace, kdy potřebuje od uživatele získat speciální informace nebo dokonce potřebujete formulářů více.

Nyní máte možnost využívat knihovnu na odesílání e-mailů (mailform), kterou používá i samotný Kontaktní formulář. K úspěšnému zprovoznění vlastního formuláře budete ale potřebovat znalost HTML jazyka (xHTML), popř. také Javascriptu. Pokud tedy tyto technologie neovládáte, navštivte nejprve např. stránky Jak psát web, kde se vše potřebné jistě rychle naučíte.

Nejsnažší cestou k pochopení používání vlastních formulářů bude zobrazení HTML kódu stránky Kontaktní formulář, kde na konkrétním příkladu uvidíte použití pravidel pro odeslání jednotlivých položek.

1. Nadefinování formuláře

Aplikace mailform se nachází na adrese /mailform/ (nutné poslední lomítko), kterou je nutné zadat jako hodnotu atributu action tagu form, methoda odeslání dat musí být POST, a také je vhodné nadefinovat tag enctype jako multipart/form-data (dokonce nutné, pokud ve svém formuláři používáte odesílání souborů).

<form method="post" action="/mailform/" enctype="multipart/form-data"></form>

2. Nastavení položek formuláře

Každá položka formuláře je pole, které má pevně definované povinné, nepovinné klíče a speciální parametry, definované podle následujících podmínek:

Povinné parametry

  • _value - hodnota položky, které vyplní (vybere) uživatel
  • _title - název položky (např. 'Jméno a příjmení')

Položka, která nebude mít definované tyto dva klíče, nebude zpracována! Vyjímkou je položka pole k odeslání souboru.

Volitelné parametry

  • _required - značí, zda je položka povinná (dříve parameter _obligate)
  • _regex - Perl-compatible regulární výraz, proti kterému se ověřuje zadaná hodnota

Pokud dostatečně neovládáte Perl-compatible regulární výrazy, tento parametr nepoužívejte.

Speciální parametry

  • _attachment - určuje hodnotu atributu name vstupního pole k odeslání souboru
  • _captcha - definuje identifikační známku ochrany proti spamu CAPTCHA

Následující příklad ukazuje nadefinování povinné položky e-mail včetně ověření proti regulárnímu výrazu:

<input type="text" name="email[_value]" value="" size="35" maxlength="60" />
<input type="hidden" name="email[_title]" value="E-mail" />
<input type="hidden" name="email[_required]" value="1" />
<input type="hidden" name="email[_regex]" value="/^(.+)@([^@]+)$/" />

3. Zobrazení výsledku formuláře

Aplikace mailform zpracuje nadefinovaný formulář a vrátí se zpět na původní stránku s informací o zpracování. K tomu, aby se tato informace zobrazila uživateli, je nutné samotný formulář uložit jako samostatnou stránku a vybrat jej jako Podpis článku, který se zobrazí uživateli. Pokud byste zobrazovali přímo článek s formulářem, uživatel by neměl informaci o konečném zpracovaní formuláře.


Všechny díly seriálu:

  1. Tvorba jednoduchého formuláře
  2. Podrobný popis parametrů
  3. Pokročilé vlastnosti
  4. Validace dat pomocí javascriptu
  5. Příklad

Přidat komentář

Přehled komentářů

  • změna hlášky po odeslání

    6.12.2016 12:41:52 | michal jirkovský

    Dobrý den, je možné abych nějak ovlivnil hlášení, které se objeví odesílajícímu po odeslání formuláře? Nevyhovuje mi text - Váš dotaz byl odeslán... raději bych si tam dal něco jako Odeslání formuláře se zdařilo. Formulář bude mít totiž pokaždé jinou funkci, někdy dotaz jinkdy registraci atp.


    Děkuji

    Odpovědět | Zobrazit odpovědi

    • Re: změna hlášky po odeslání

      13.12.2016 9:41:35 | Tým inPage

      Dobrý den,
      možnost úpravy tohoto hlášení je uvedena v třetím dílu o vlastních formulářích https://blog.inpage.cz/inpage/3-pokrocile-vlastnosti/ v bodě 4: Vlastní závěrečná hlášení.

      Odpovědět

  • Re: Více vlastních formulářů - různí příjemci

    17.8.2012 14:02:10 | pk

    Je to trošku složitější. Vytvoříme si "sběrný mailbox" form@mojedomena.cz, kam chodi všechny e-maily z formulářů. Poté:

    1/ Vložte do formuláře 1
    <input type="hidden" name="subject[_value]" value=Můj formulář 1 [my-form-1]" />
    (tento kód rovněž způsobí, že příchozí e-mail s daty formuláře 1 bude mít tento subject)

    2/ V mailboxu form@mojedomena.cz, kam se posílají formuláže, si vytvořte pravidlo přesmerování:
    "Když hlavička "Subject" obsahuje "[my-form-1]", pak přesměruj jej na emailovou adresu myform1@mojedomena.cz."
    (myform1@mojedomena.cz musí existovat, příp. si jej vytvoříme - způsob zadávání pravidel se liší od použitého mailboxu, toto řešení je pro webmail z-mail od ZONERu)

    Tímto se přesměruje email do daného mailboxu. V tomto sběrném mailboxu můžete buď nechávat všechyn e-maily, přip. je hned po přeposlání smazat. Stejným způsobem vytvoříme vlastní mailbox i pro druhý formulář a přidáme do form@mojedomena.cz podobné pravidlo.

    Odpovědět

  • Více vlastních formulářů - různí příjemci

    16.8.2012 11:41:42 | Kateřina Schreibová

    Dobrý den,
    chtěla bych se zeptat, jak zajistit, aby se různé vlastní formuláře odesílaly na různé adresy příjemců. Mám vytvořeny 2 vlastní formuláře, ale potřebovala bych, aby se obsah vyplěného formuláře 1 zasílal na zvolený e-mail 1, obsah 2. formuláře na e-mail 2 - tedy, aby údaje ze 2 různých vlastních formulářů mohli zpracovávat 2 různí lidé. Děkuji.

    Odpovědět

inPage.cz - webové stránky, doména a webhosting snadno.