Mapování vstupů – ruční nastavení

Tento návod je pro uživatele, kteří nechtějí mapovat vstupy pomocí webového konfigurátoru, což je jednodušší způsob. Tato varianta je určena spíše pro pokročilejší uživatele, kteří mají alespoň základní znalost HTML

  • Ujistěte se, že máte na svém webu či formuláři vložený script Foxentry
  • Ve vašem projektu přejděte do nastavení a v horním menu klikněte na službu, kterou chcete nastavit. (bod č. 1)
  • Klikněte na Nastavit ručně v dolní části obrazovky (bod č. 2)

Nyní přidáváte nový validátor

Po kliknutí na tlačítko Nastavit ručně se vám otevře okénko přidání nového validátoru. Validátor si představte jako skupinu kolonek, které s sebou souvisí – v případě našeptání adres je to např. Ulice a č. p., Obec, PSČ. Pokud tedy vyberete nějakou ulici z našeptávače, vyplní se všechny kolonky. Někdy se stává, že těchto validátorů, ale potřebujete víc (v nejčastějších případech je to např. fakturační adresa a dodací adresa – tedy 2 odlišné adresy, které potřebujete mít oddělené).

Zadejte HTML identifikátor jednotlivých vstupů

Nyní je potřeba zadat ID jednotlivých kolonek na vašem webu a přiřadit k nim naše označení (funkcionalitu kolonky). Každý web je trochu jiný, takže se jednotlivé identifikátory mohou lišit. Nejjednoduší způsob, jak je zjistit je např. pomocí nástroje pro vývojáře ve vašem prohlížeči. Stačí kliknout pravým tlačítkem na kolonku a dát Prozkoumat.

Můžete narazit na různé typy zápisu, zde jsou některé nejrozšířenější:

#email – takto označíte v administraci foxentry prvek, který má nastavený parametr id=“email“ (bod č. 4)
.email – tímto způsobem zadáte v administraci prvek, který je označen parametrem class=“email“
[name=email] – označuje prvek, který obsahuje parametr „name“ s hodnotou „email“ – tedy name=“email“

a tak dále.

U přidávání nového vstupu (bod č. 5) tedy vyplńte správný HTML identifikátor, vyberte z nabídky našeho označení správnou hodnotu vstupu a následně zvolte funkcionalitu, kterou by vstup měl mít:

  • Našeptávač: tato funkcionalita bude zobrazovat u kolonky našeptávač výsledků (např. výběr firem nebo adres po zadání pár písmenek)
  • Vyplňení: kolonka se automaticky vyplní informacemi po zvolení nějakého výsledku z našeptávače (např. pokud zvolíte adresu Jeseniova 1151/55, Praha 3, tak se do této kolonky automaticky doplní PSČ)
  • Validace: informace v kolonce se budou na základě této funkcionality validovat. (uživatel zadá např. do kolonky e-mail abc@neco.cz a zobrazí se mu např. hláška, že e-mail neexistuje)
  • Země: Tuhle funkcionalitu volte pouze v případě, že se jedná o prvek formuláře, který přepíná jazykové mutace. Hodnota (kód) země může být „cz“ nebo „sk“

Příklad: při nastavování vstupu „Ulice a č. p.“ byste standardně měli zvolit našeptávač, vyplnění a validaci. Země neaktivní.

Dodatečné nastavení validátoru

V okně validátoru máte možnost ještě níže nastavit dodatečné věci, které nejsou povinné:

Propouštění jen validních údajů – Pokud máte toto nastavení povolené, může se stát že nějaký údaj ve formuláři bude vyhodnocen jako nevalidní (červené ohraničení s křížkem), a tedy správně by formulář neměl jít odeslat (tady záleží na nastavení vašeho webu viz. callback). Pokud jste tohle nastavení nepovolili, nevalidní vstupy se označí maximálně výstrahou (oranžové ohraničení s ikonkou vykřičníku) a formulář by měl jít po správném nastavení odeslat.

Omezení pouze na některé URL adresy – pokud máte vložen script Foxentry na všechny vaše podstránky, může se stát, že na některých z nich nebudete chtít využívat nějaký validátor. Právě k těmto situacím je vhodné omezení podle URL adres. Pomocí jednoduchých podmínek můžete např. na všech URL, co začínají určitým slovem, povolit či zakázat tento validátor.

Příklad: používám e-mailový validátor ve sběru mailů k newsletteru na úvodní stránce webu. Nechci ho ale používat i v administraci webu. Zvolím teda podmínku URL začíná na /admin a dám zakázat