WebToDate/Poradny a rozhovory/Začínáme

První kroky

Při prvotní konfiguraci směřující k vytvoření první funkční poradny se postupuje v následujících krocích:

1. Základní nastavení celého modulu (např. předvoleb apod.)
2. Založení prvního předpisu
3. Založení první poradny
4. Vlastní definice předpisu, tj. potřebných WebToDate stylů a předloh pro jednotlivé typy stránek a jejich nastavení pro danou poradnu
5. Testování funkčnosti poradny

Postupy uvedené v této kapitole předpokládají, že uživatel je přihlášen k WebToDate jako člen týmu Administrátoři.

Základní nastavení

V prvé řadě je vhodné nastavit předvolby. Přejděte do nabídky modulu Administrace – Předvolby.

Pro tuto chvíli vypněte obě funkce pro odesílání e-mailů, volbu Automatické formátování je možné ponechat, stejně tak ponechte volbu Standardní práva.

I když jsou ve formuláři nastaveny nějaké výchozí hodnoty, po instalaci nejsou tyto hodnoty uloženy v databázi systému. I v případě, že chcete ponechat všechny výchozí hodnoty, použijte nejprve v tomto i ve všech ostatních formulářích tlačítko Uložit.

Nyní přejděte do nabídky Administrace – Údaje. V tomto formuláři se volí, která pole budou přístupná v formulářích pro vkládání nových dotazů a která z nich budou vyžadovat povinné vyplnění.

Význam polí je zřejmý z popisu, snad pouze pole "Osobní" vyžaduje komentář. Ve formuláři lze eventuálně zpřístupnit zaškrtávací okénko, kterým uživatel žádá, že odpověď má být určena jen pro něj. Takový dotaz je v databázi dotazů v poradně označen příznakem Neveřejný dotaz a správce poradny může tento příznak buď ponechat nastavený, nebo jej zrušit a dotaz zpřístupnit ke čtení všem návštěvníkům poradny.

Dále přejděte do nabídky Nastavení – Globální – Navigační lišta a formulář pro definici tvaru navigačních stránkovacích lišt uložte beze změny hodnot v jednotlivých polích. Pokud máte v systému definován více než jeden jazyk, rozlišují se tyto nabídky ještě na úrovni jazyka, pak toto proveďte pro výchozí jazyk, typicky češtinu.

Založení předpisu

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

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é poradny. 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ům 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.

Založení poradny

Přejděte do nabídky Administrace – Poradny. Pomocí odkazu Přidat v pravém horním rohu okna prohlížeče založte první poradnu. Formulář vyplňte dle následujícího vzoru a uložte.

Poznámka: Pokud máte v poli Přihlašovací režim méně voleb než je na tomto otisku obrazovky, nemáte nainstalován modul Registrace a personalizace. Ten není pro modul Poradny a rozhovory vyžadován, nelze pak ale používat funkce modulu vyžadující registrace.

Definice předpisu a testování výsledku

Cílová funkcionalita

Dle následujícího postupu lze vytvořit jednoduchou poradnu demonstrující základní možnosti modulu. Poradna se skládá ze tří typů stránek:

• Výchozí stránka poradny zobrazuje základní informace o poradně a obsahuje odkazy na výpisy dotazů v poradně a vkládání nových dotazů
• Stránka pro seznam dotazů zobrazuje stránkovaný seznam zodpovězených dotazů včetně odpovědí a základních informací o položce (tazatel, data vložení a zodpovězení apod.)
• Stránka pro vložení nového dotazu obsahuje formulář pro zadávání dotazů

Nejsou zde využity další funkce jako je např. možnost v seznamu prezentovat jen dotazy a vytvořit detailní stránku pro zobrazení dotazu a odpovědi, fulltextové hledání, odesílání e-mailů s dotazem či odpovědí, možnost kategorizace dotazů a procházení obsahu poradny dle těchto kategorií apod.

Vytvoření stránky pro vložení nového dotazu

Nejprve vytvoříme HTML kód formuláře pro vložení nového dotazu. První možností je využít vestavěné funkce pro vygenerování tohoto kódu do těla fragmentu. Přejděte do nabídky Nástroje – Nový dotaz. Zobrazí se formulář pro generování pomocného fragmentu obsahujícího HTML kód formuláře. Zvolte vhodnou kategorii pro fragment a použijte tlačítko Přidat HTML fragment a následně tlačítko Vyhledat. Funkce přejde zpět do WebToDate na formulář pro úpravy nově založeného fragmentu. HTML kód formuláře zde můžete upravit dle potřeby, je ale třeba zachovat všechna URL a názvy parametrů ve formuláři. Tato funkce pro generování formuláře zohledňuje nastavení výběru vstupních polí v nabídce Administrace – Údaje, do HTML kódu formuláře se vygenerují jen ty pole, která jsou v tomto nastavení zvolena.

Druhou možností je ručně založit nový fragment. Do těla fragmentu vložte následující kód.

<h3>Nový dotaz do poradny <!--WTD_ADVICE(ANAME)--></h3>
<i><!--WTD_ADVICE(ADESCRITPION)--><br></i>

<form name="formular" id="formular" action="/scripts/modules/advice/newquestion.php?id=<!--WTD_ADVICE(AID)-->" method="post">
<!--WTD_IF(REQUIRED,"Vyplňte prosím všechny povinné údaje")-->
<!--WTD_IF(WRONGEMAIL,"Vložená e-mailová adresa je neplatná.")-->

<table>
<tr>
 <td align="right">
  <label for="name">Název</label>
 </td>
 <td>
  <input type="text" name="name" id="name" value="<!--WTD_ADVICE(NAME)-->" size="60" />
 </td>
</tr>
<tr>
 <td align="right">
  <label for="firstname">Jméno</label>
 </td>
 <td>
  <input type="text" name="firstname" id="firstname" value="<!--WTD_USER(FIRSTNAME)-->" size="60" />
 </td>
</tr>
<tr> 
 <td align="right">
  <label for="lastname">Příjmení</label>
 </td>
 <td>
  <input type="text" name="lastname" id="lastname" value="<!--WTD_USER(LASTNAME)-->" size="60" />
 </td>
</tr>
<tr> 
 <td align="right">
  <label for="nickname">Přezdívka</label>
 </td>
 <td>
  <input type="text" name="nickname" id="nickname" value="<!--WTD_USER(NICKNAME)-->" size="60" />
 </td>
</tr>
<tr> 
 <td align="right">
  <label for="email">E-mail</label>
 </td>
 <td>
  <input type="text" name="email" id="email" value="<!--WTD_USER(EMAIL)-->" maxlength="80" size="60" />
 </td>
</tr>
<tr> 
 <td align="right">
  <label for="question">Dotaz</label>
 </td>
 <td>
  <textarea cols="50" rows="12" name="question"><!--WTD_ADVICE(QUESTION)--></textarea>
 </td>
</tr>
<tr>
 <td align="right" colspan="2">
  <input type="submit" name="send" id="send" value="Odeslat" />
 </td>
</tr>
</table>
</form>

Tento HTML kód předpokládá, že v nastavení Administrace – Údaje jsou zaškrtnuta všechna pole kromě PRIVATE. Pokud máte v tomto formuláři nastaveno méně polí, odstraňte odpovídající části HTML tabulky z uvedeného kódu.

Poznámka: použití a povinné vyplnění vstupních polí modul vyhodnocuje ve chvíli pokusu o vložení nového dotazu podle aktuálního nastavení formuláře Administrace – Údaje. Pokud např. není zaškrtnuto použití pole LASTNAME, příjmení se do databáze nezapíše i když odpovídající textové vstupní pole ve formuláři pro vkládání dotazů je a je vyplněno. Naopak pokud je zaškrtnuto povinné vyplnění nějakého pole, které v HTML kódu vstupního formuláře vůbec není, znamená to, že nikdy žádný dotaz nebude možné do databáze vložit.

Nyní založíme předlohu pro stránku pro vkládání dotazů. V hlavní nabídce WebToDate použijte Vzhled – Předlohy, klepněte na ikonu složky vedle názvu Poradny a rozhovory a použijte odkaz Přidat v pravém horním rohu. Formulář pro založení předlohy vyplňte dle následujícího vzoru. Jako šablonu použijte vhodnou stránku, která má oblast, na kterou bude možné vložit fragment s formulářem založený v prvním kroku.

Po uložení stránky klepněte na název stránky v seznamu předloh, v hlavní nabídce WebToDate přejděte na Obsah – Fragmenty a vložte fragment na vhodnou oblast v předloze pod stylem, který vkládá jen tělo fragmentu; tyto fragmenty přiřazujte vždy staticky. Pokud vhodný styl nemáte, založte ve WebToDate nový styl (Vzhled - Styly) a do jeho těla vložte kód

<!--WTD_F(BODY)-->

Stránku pak vygenerujte.

Přejděte do nabídky modulu Nastavení – Předpisy – název předpisu – Nový dotaz. V poli Předloha vyberte stránku založenou v předchozím kroku a formulář uložte.

Formulář nyní můžete zobrazit na stránce /scripts/modules/advice/newquestion.php?id==xxx, kde xxx je ID poradny založené v kapitole Založení poradny. Formulář zde můžete zkontrolovat a případně ještě graficky upravit jeho kód v těle fragmentu, nový dotaz ale ještě nevkládejte, protože chybí další stránky modulu.

Vytvoření stránky pro seznam dotazů a odpovědí

Nejprve vytvoříme fragment obsahující hlavní kód stránky zobrazující seznam dotazů. Založte nový fragment ve vhodné kategorii a do těla vložte následující kód.

<h3><a href="<!--WTD_ADVICE(AURL)--> "><!--WTD_ADVICE(ANAME)--></a></h3>
Seznam dotazů: <strong>
<!--WTD_IF(ALL,"Všechny dotazy")-->
<!--WTD_IF(FREQUENT,"Nejčastější dotazy")-->
<!--WTD_IF(NOREPLY,"Dotazy, které nebudou zodpovězeny")-->
</strong>
<div>
<!--WTD_IF(QNOTFOUND,"Těmto kritériím nevyhovuje žádný dotaz.")-->
<!--WTD_ADVICE(NAVIG)-->
</div>
<div><!--WTD_ADVICE(ITEMSLIST)--></div>
<div><!--WTD_ADVICE(NAVIG)--></div>

Klíčové slovo <!--WTD_ADVICE(ITEMSLIST)--> zde reprezentuje místo, kde se bude zobrazovat vlastní seznam dotazů, ostatní klíčová slova reprezentují např. stránkovací lištu, název poradny apod.

Nyní založte novou předlohu pro tento typ stránky. Postupujte identicky jako v předchozí kapitole, na stránku vložte fragment založený v předchozím kroku a stránku vygenerujte.

Dále založíme WebToDate styl pro formátování seznamu příspěvků. Založte nový styl v kategorii stylů Poradny a rozhovory následujícím způsobem:

Hlavička

<table border="0" cellspacing="1" cellpadding="4">

Tělo

<tr bgcolor="#efefef">
<td><!--WTD_ADVICE(ID)--></td><td><!--WTD_ADVICE(NAME)--></td>
</tr>
<tr bgcolor="#f6f6f6">
<td colspan="2">
<em>Zadáno <!--WTD_ADVICE(QDATE)-->, zodpovězeno <!--WTD_ADVICE(ADATE)--><br />
Tazatel <!--WTD_USER(FIRSTNAME)--> <!--WTD_USER(LASTNAME)--> (<!--WTD_USER(NICKNAME)-->) <a href="mailto:<!--WTD_USER(EMAIL)-->"><!--WTD_USER(EMAIL)--></a></em>
</td>
</tr>
<tr><td colspan="2"><strong>Dotaz:</strong><br /><!--WTD_ADVICE(QUESTION)--></td></tr>
<tr><td colspan="2"><strong>Odpověď:</strong><br /><!--WTD_ADVICE(ANSWER)--></td></tr>

Patička

</table>

Separátor

<tr><td colspan="2"> </td></tr>

Nyní je třeba v modulu provést příslušné nastavení pro stránku zobrazující seznam dotazů v poradně. Přejděte do nabídky modulu Nastavení – Předpisy – název předpisu – Seznam dotazů. Formulář vyplňte dle následujícího otisku obrazovky, nastavení Styl seznamu kategorií můžete zvolit libovolné, protože v tuto chvíli poradna žádné kategorie nemá a jejich seznam se na stránku nevkládá.

V poli Předloha zde zvolte předlohu založenou v této kapitole, v poli Styl seznamu dotazů styl založený v předchozím kroku. Stránku pro seznam dotazů nyní můžete zobrazit na URL /scripts/modules/advice/questionlist.php?id=xxx, kde xxx je ID poradny založené dle kapitoly Založení poradny.

Vytvoření výchozí stránky poradny

Modul podporuje pro každou poradnu tzv. výchozí stránku, která typicky může vypadat zhruba tak, jak je naznačeno na následujícím otisku obrazovky. Kromě základních informací o poradně může prezentovat základní odkazy (seznam dotazů, vložení nového dotazu), vyhledávací formulář či prohlížení obsahu poradny dle kategorií. Funkce se používá zejména v implementacích, kde je založeno více poraden, existence této stránky není ale povinná – minimální konfigurace se skládá ze dvou stránek – seznam dotazů a stránka pro vložení nového dotazu.

Nejprve založíme nový fragment, který bude použit jako hlavní část předlohy pro výchozí stránku poradny. Založte nový fragment ve vhodné kategorii a do těla vložte následující kód.

<h2><!--WTD_ADVICE(ANAME)--></h2>
<p><em><!--WTD_ADVICE(ADESCRITPION)--></em></p>
<p>Poslední modifikace poradny: <strong><!--WTD_ADVICE(ALASTUPDATE)--></strong><br />
Počet zodpovězených dotazů: <strong><!--WTD_ADVICE(ANUMOFITEMS)--></strong></p>
<p><strong>
<a href="questionlist.php?id=<!--WTD_ADVICE(AID)-->">Všechny dotazy</a> | 
<a href="questionlist.php?id=<!--WTD_ADVICE(AID)-->&frequent=y">Nejčastější dotazy</a> | 
<a href="questionlist.php?id=<!--WTD_ADVICE(AID)-->&noreply=y">Nebude zodpovězeno</a> | 
<a href="newquestion.php?id=<!--WTD_ADVICE(AID)-->">Nový dotaz</a>
</strong></p>

Nyní založte novou předlohu pro tento typ stránky. Postupujte identicky jako v předchozí kapitole, na stránku vložte fragment založený v předchozím kroku a stránku vygenerujte.

Posledním krokem je příslušné nastavení pro připravovanou úvodní stránku poradny. Přejděte do nabídky modulu Nastavení – Předpisy – název předpisu – Úvodní stránka. Formulář vyplňte dle následujícího otisku obrazovky, nastavení Styl seznamu kategorií můžete zvolit libovolné, protože v tuto chvíli poradna žádné kategorie nemá a jejich seznam se na stránku nevkládá.

Testování výsledku

Pokud jste postupovali podle výše uvedených návodů, měly by být stránky první jednoduché poradny připraveny. Přejděte ve veřejné části prezentace na stránku /scripts/modules/advice/firstpage.php?id=xxx, kde xxx je ID poradny, vyzkoušejte všechny odkazy na této stránce a zadejte nový dotaz.

Nejjednodušší postup pro zodpovězení dotazu a otestování jeho zobrazení ve veřejné části prezentace je následující:

1. po vložení nového dotazu z veřejné části prezentace přejděte v administrační části modulu do nabídky Data – Poradny – název poradny.
2. V seznamu dotazů v pravé horní části okna prohlížeče by se měl zobrazit tento dotaz. Klepněte na jeho název.
3. V záložce Odpověď formuláře doplňte nějakou odpověď a použijte tlačítko Zodpovědět.
4. Na veřejné části prezentace použijte na úvodní stránce poradny odkaz Všechny dotazy, měl by se zobrazit seznam dotazů zobrazující právě zodpovězený dotaz.