WebToDate/Soutěže/Začínáme

Základní funkce a principy

Soutěže z pohledu návštěvníka webu

Jedna soutěž je sada otázek a odpovědí. Otázky a výběr odpovědí na otázky je jeden formulář, jehož součástí jsou navíc typicky pole pro zadání vybraných personálních údajů.

Na daném URL se zobrazuje stránka jedné dané vypsané soutěže, stránka je přístupná všem anonymním uživatelům nebo může být určena jen pro registrované uživatele. Soutěž může mít časovou platnost, tudíž se v čase může na stejném URL zobrazit jiný obsah - pokud soutěž probíhá, je hlavní částí stránky soutěžní formulář k vyplnění, pokud je soutěž již uzavřena, zobrazí se stránka pouze pro čtení, kde jsou typicky uvedeny správné odpovědi na otázky.

Stránka dané soutěže v aktivním stavu zobrazuje:

1. části, které jsou pro uživatele pouze pro čtení (název, popis, obrázek, časová platnost apod.)
2. vlastní soutěžní formulář - jednotlivé otázky, k nim výběr odpovědí formou radiopřepínačů, počet otázek je proměnlivý, tj. může se soutěž od soutěže lišit.
3. textová pole formuláře (jméno, adresa, e-mail apod.) - u různých soutěží se mohou zobrazovat různá takováto pole (celková množina je daná, ale mohou být použita jen některá), některá vyžadují vyplnění, některá se vyplňují nepovinně.

Uživatel u každé otázky vybere právě jednu odpověď (je povinné vybrat odpověď na každou otázku) a vyplní přinejmenším povinná textová pole.

Po odeslání formuláře se objeví stránka s potvrzením uložení záznamu soutěže nebo případně stejná stránka s formulářem v případě, že se zobrazuje nějaká chybová hláška (typicky nevyplnění povinné položky).

Soutěže z pohledu obsluhy

Lze založit libovolný počet soutěží, uživatel zakládající soutěž typicky vyplňuje název, popis a seznam otázek a odpovědí. Každé soutěži se automaticky přidělí URL stránky, na které se soutěží. Modul podporuje zobrazování jednotlivých soutěží na jejich URL v různých stavech, ale nemá v prezentační vrstvě funkci pro výpis nějakého seznamu existujících soutěží. Proto se zpravidla odkaz na stránku soutěže umístí prostředky WebToDate do nějaké zprávy či fragmentu a tím vzniká na webové prezentaci upozornění na existující soutěž

Grafické zobrazení stránky soutěže je dáno výběrem předpisu, administrátor může připravit několik předpisů pro různé grafické podoby. Součástí předpisu je zde i výběr sady polí s personálními údaji, takže lze připravit několik typů soutěží, kde v jednom typu uživatelé vyplňují např. jen e-mail, v jiném typu zadávají celou svoji adresu a telefonní čísla apod.

Z formuláře pro definici soutěže lze rovnou zobrazit náhledy stránky se soutěží. Tento náhled se liší podle časové platnosti – lze zobrazit náhled soutěže v průběhu časové platnosti (typicky s aktivním formulářem pro výběr odpovědí) a náhled soutěže po ukončení platnosti (typicky zobrazuje správné výsledky, tj. třeba jen seznam otázek a správných odpovědí na ně).

V náhledovém režimu může obsluha soutěž otestovat. Ve formuláři pro definici soutěže je pak funkce Odstranit výsledky, kterou lze odstranit všechny testovací záznamy.

Obsluha má k dispozici i funkce pro procházení výsledků, čímž se rozumí statistika toho, kolik uživatelů se účastnilo soutěže, kdo měl největší počet správných odpovědí apod. Webové administrační rozhraní modulu poskytuje pouze základní statistické sestavy těchto výsledků, pro složitější zpracování, výběr vítězů na základě nějakých složitějších kritérií apod. je k dispozici export, kterým lze potřebná data dostat např. do aplikace MS Excel apod.

První kroky

Modul nemá žádné složitější předvolby, před vlastní definicí grafiky soutěží stačí založit předpis a nastavit zadávání osobních údajů.

Osobní údaje

Přejděte do nabídky Nastavení – Osobní údaje. V pravém horním rohu okna prohlížeče klepněte na Přidat. Zobrazí se formulář, ve kterém se definuje pojmenovaná sada výběru osobních údajů, které uživatelé zadávají. V poli Název sady zadejte libovolný název této sady nastavení (např. "Soutěže běžné"). Níže pak zaškrtejte, které údaje mají uživatelé zadávat, pro testovací účely postačuje např. zvolit Jméno a Příjmení.

Soubor:Image002.jpg

Založení předpisu

Přejděte do nabídky Nastavení – Seznam předpisů modulu, klepněte na odkaz Přidat v pravém horním rohu okna prohlížeče a založte první předpis.

Soubor:Image003.jpg

V tomto formuláři se zadává pouze název předpisu. Předpis je souhrn grafických a funkčních nastavení, který definuje chování a vzhled dané části modulu, v tomto případě dané soutěže. Pojmenujte proto předpis podle zamýšleného způsobu užití.

Vlastní definice předpisu, tj. výběry různých WebToDate stylů, předloh apod. se neprovádějí zde, ale v nabídce Nastavení – Předpisy, jak je popsáno v příslušné kapitole níže.

Definice předpisu

Minimální sada nastavení potřebná pro vytváření a otestování soutěží, je:

• Nastavení stránky pro zobrazení probíhající soutěže – je třeba vytvořit předlohu stránky a styl pro seznam otázek a odpovědí
• Nastavení stránky pro potvrzení uložení výsledků – je třeba vytvořit předlohu stránky.

Nejprve ve WebToDate založte novou předlohu pro probíhající soutěž. V hlavní nabídce WebToDate zvolte Vzhled – Předlohy. Klepněte na ikonu složky vedle názvu kategorie předloh Soutěže a následně v pravém horním rohu klepněte na Přidat. Formulář vyplňte dle následujícího vzoru.

Soubor:Image004.jpg

Volba šablony musí být taková, aby tato šablona obsahovala vhodnou oblast, do které lze umístit prvky jako seznam otázek a odpovědí či část formuláře pro zadání osobních údajů. Pokud takovou šablonu v tuto chvíli nemáte, zvolte Šablona: Nejvyšší úroveň a vložte v záložce Obsah zhruba následující HTML kód:

<html>
<head>
</head>
<body>
<div id="main1">
<!--WTD_A(stred_stranky)-->
</div>
</body>
</html>

Oblast pak bude pojmenovaná stred_stranky, definici této oblasti je třeba vytvořit ve Vzhled – Oblasti (viz Referenční příručka WebToDate).

Nyní založte nový fragment WebToDate, který bude mít v poli Tělo následující kód:

<form action="<!--WTD_QUIZ(ADDURL)--> " method="post">
<h3><!--WTD_QUIZ(NAME)--></h3>
<div><!--WTD_QUIZ(DESCRIPTION)--><div>
<br />
Soutěž probíhá od <!--WTD_QUIZ(DATEFROM)--> do <!--WTD_QUIZ(DATETO)-->. Odpovězte prosím na všech <!--WTD_QUIZ(QUESTIONCOUNT)--> otázek soutěže.<br />
<!--WTD_IF(QUIZINCOMPLETE,"<strong>U všech otázek musí být zvolena odpověď.</strong>")-->
<!--WTD_IF(MANDATORYERROR,"Některé povinné pole formuláře není vyplněno.")--> 
<br/><br/><div><strong>Soutěžní otázky:</strong><br/><!--WTD_QUIZ(LIST)--></div>
<hr />
<label for="firstname">Jméno</label>
<input type="text" id="firstname" name="firstname" value="<!--WTD_QUIZ(FIRSTNAME)-->" maxlenght="40" />
<br />
<label for="lastname">Příjmení</label>
<input type="text" id="lastname" name="lastname" value="<!--WTD_QUIZ(LASTNAME)-->" maxlenght="40" />
<br />
<input type="submit" value="Odeslat">
</form>

V horní části formuláře jsou klíčová slova pro základní údaje soutěže (nadpis, popis, počet otázek apod.), dále je zde umístěn seznam otázek a odpovědí a ve spodní části je seznam polí pro osobní údaje.

HTML kód části formuláře pro zadání osobních údajů lze eventuálně získat pomocí funkce Nástroje – Osobní údaje. Funkce generuje fragment, který má v těle HTML kód té části formuláře, kde se zadávají osobní údaje. Zvolte zde příslušnou sadu osobních údajů a vhodnou kategorii a publikaci a použijte tlačítko Přidat HTML fragment. Zobrazí se formulář potvrzující vytvoření fragmentu, použijte tlačítko Vyhledat, které přejde do formuláře pro úpravy fragmentu.

Výše uvedený fragment přiřaďte na oblast na předloze vytvořené v předchozím kroku pod stylem, který vkládá jen tělo fragmentu. Pokud jej nemáte, založte ve WebToDate nový styl (Vzhled - Styly) a do jeho těla vložte kód

<!--WTD_F(BODY)-->

Stránku vygenerujte.

Dále budeme potřebovat WebToDate styl formátující seznam otázek a odpovědí. Založte nový styl nazvaný např. "Soutěže - platná soutěž" a vyplňte jej následujícím způsobem:

Tělo

<input type="radio" name="<!--WTD_QUIZ(QUESTIONIDENT)-->" value="<!--WTD_QUIZ(ANSWERID)-->" <!--WTD_QUIZ(CHECKED)-->/> 
<!--WTD_QUIZ(ANSWERORDERID)-->) <!--WTD_QUIZ(ANSWER)-->
<br />

Začátek sekce

<strong><!--WTD_QUIZ(QUESTIONORDERID)-->. <!--WTD_QUIZ(QUESTION)--><br /><br/></strong>

Konec sekce

<br />

Styl zařaďte do kategorie stylů Soutěže.

Nyní přejděte do nabídky modulu Soutěže na formulář Nastavení – Předpisy – název předpisu – Probíhající soutěž. Formulář vyplňte dle následujícího vzoru. V prvním poli se zvolí předloha založená v prvním kroku, v druhém poli styl založený výše, v posledním poli se volí sada osobních údajů založená při přípravě konfigurace modulu.

Soubor:Image005.jpg

Tím je definovaná stránka zobrazující seznam otázek a odpovědí v aktivním stavu, čili v době kdy lze volit odpovědi na otázky a účastnit se soutěže. Ke zprovoznění této funkce ještě chybí předloha, která se použije ve chvíli odeslání formuláře s vyplněnou soutěží. Kompletnost vyplnění formuláře kontroluje již stránka s formulářem, tato druhá předloha pak slouží pouze pro potvrzení, že data soutěžícího byla uložena.

Založte další předlohu identickým způsobem, jako je popsáno výše, nazvěte ji např. "Uložení soutěže". V předloze musí být jedna oblast, do které lze vložit část stránky informující o úspěšném uložení.

Dále založte nový fragment, do těla fragmentu vložte kód

Děkujeme za účast v soutěži.<br />
<!--WTD_IF(GENERALERROR,"Obsah formuláře nelze zapsat.")-->
<!--WTD_IF(SUCCESS,"Vaše odpovědi byly uloženy.")-->

Fragment vložte do předlohy "Uložení soutěže" pod stylem vkládajícím jen tělo fragmentu a stránku vygenerujte.

Nyní přejděte do nabídky modulu Soutěže na formulář Nastavení – Globální – Stránky. V poli Potvrzení uložení výsledků zvolte právě vytvořenou předlohu a formulář uložte.

Soubor:Image006.jpg

V tuto chvíli je možné zobrazovat soutěže v aktivním stavu a účastnit se soutěže. Není ještě nakonfigurována podoba stránky po ukončení platnosti soutěže, kdy už nelze soutěžit, ale lze zobrazit správné výsledky, pro tyto účely se postupuje podobně jako u pracovního postupu popsaného v této kapitole, potřebné informace naleznete v referenční části tohoto manuálu.

Založení soutěže a testování výsledků

Soutěže se zakládají a spravují nabídce Data – Soutěže modulu, klepnutím na Přidat v pravém horním rohu stránky prohlížeče se ve spodním rámci zobrazí formulář pro soutěž.

Soubor:Image007.jpg

Formulář má dvě záložky Základní a Otázky, druhá záložka se ale objevuje až po prvním uložení formuláře.

Vyplňte formulář dle výše uvedeného otisku obrazovky, důležité je zejména zvolit předpis založený v předchozích krocích. Formulář uložte.

Po uložení je možné přejít do záložky Otázky, kde se definuje seznam otázek a odpovědí.

Soubor:Image008.jpg

Nová otázka se přidává tlačítkem Přidat otázku. Tlačítko otevírá v novém okně prohlížeče formulář, ve kterém je pouze pole pro text otázky a tlačítko Přidat odpověď, kterým je třeba vložit tolik možných odpovědí, kolik jich má otázka mít.

Soubor:Image009.jpg

Před uložením formuláře je povinné označit pomocí radiopřepínačů vlevo právě jednu odpověď jako Správně, pak je možné formulář uložit.

Po vložení několika otázek použijte v záložce Základní tlačítko Náhled – probíhající soutěž, které by mělo zobrazit zhruba následující obsah stránky.

Soubor:Image010.jpg

Soutěž je možné vyplnit a otestovat. Po ukončení testování je možné použít tlačítko Odstranit výsledky ve formuláři pro správu soutěže, aby byly odstraněny všechny testovací záznamy výsledků.