WebToDate - Příspěvky [cs]

WebToDate/Poradny a rozhovory/Reference

2010-04-08T09:50:23Z

Vitas: přidána doplňující informace o problému při použití parametru id ve formě skrytého pole

[[Category:WebToDate Poradny a rozhovory]]
[[Category:Poradny a rozhovory]]
== Administrační rozhraní ==
=== Nabídka modulu ===

Nabídka modulu vypadá následovně:

'''Nástroje'''

:Nový dotaz

:Vyhledávání

'''Nastavení'''

:Seznam předpisů

:Globální

::Seznam poraden

::Vyhledávání

::Navigační lišta

::Filtr slov

::Odpověď – e-mail

::Odmítnutí přístupu

:Předpisy

::''název předpisu''

:::Úvodní stránka

:::Seznam dotazů

:::Detail

:::Nový dotaz

'''Administrace'''

:Předvolby

:Údaje

:Práva

:Poradny

:Kategorie

:Antispamové profily

'''Data'''

:Poradny

:Zvolit poradnu

:Vybraná poradna

:Zakázané IP adresy

K administrační části modulu mají přístup pouze administrátoři WebToDate. Výjimkou je sekce '''Data''' nabídky, kterou lze zpřístupnit i jiným týmům pomocí funkce '''Práva'''.
<div class="note">'''Poradny''': Položka ''Poradny'' je umístěna v nabídce dle přístupových práv.Je-li uživatel členem týmu ''Administrátoři'', je položka ''Poradny'' v sekci '''Administrace''' nabídky. Je-li modul přepnut v předvolbách na Zjednodušená práva a uživatel je přihlášen jako editor jiného týmu spravujícího poradny, je položka ''Poradny'' v sekci '''Data''' nabídky modulu.</div>

=== Nástroje ===

Funkce '''Nástroje''' obsahuje možnosti generování vybraných formulářů jako fragmentů, kde v těle fragmentu je výchozí HTML kód s vhodnými klíčovými slovy, který lze způsobem vyžadovaným grafickým designem prezentace upravit a pak použít pro přípravu předloh.

Jedná se o následující nástroje:

* '''Nový dotaz''' – vygeneruje fragment obsahující HTML kód formuláře pro vkládání nových příspěvků; výsledek je závislý na aktuálním nastavení formuláře '''Údaje''', do HTML kódu se generují jen ta vstupní pole, která jsou označena jako používaná.
* '''Vyhledávání''' – generuje HTML kód vyhledávacího formuláře pro prohledávání poraden (textová vyhledávací podmínka, výběr prohledávané poradny apod.)

=== Administrace ===
====Předvolby====
Ve formuláři '''Předvolby''' se nastavují některé základní údaje definující chování celého modulu. Tento formulář je vhodné nastavit co nejdříve po instalaci modulu.

[[Image:poradnyarozhovory-reference-img011.png|center]]

Je-li zaškrtnuta volba '''Odesílat nové dotazy e-mailem''', odesílá se ve chvíli vložení nového dotazu do databáze z veřejné části webové prezentace e-mail s tímto dotazem na adresu správce dané poradny. Funkce pro odeslání e-mailu se spouští pouze v případě, že

# je vyplněna e-mailová adresa pro danou poradnu ve formuláři '''Administrace''' – '''Poradny'''
# je nakonfigurována předloha a další parametry tohoto e-mailu ve formuláři '''Nastavení''' – '''Globální''' – '''Odpověď – e-mail'''.

Je-li zaškrtnuta volba '''Odesílat odpověď e-mailem''', odesílá se odpověď na adresu tazatele ve chvíli, kdy se použije ve formuláři pro editaci dotazu v administračním rozhraní modulu tlačítko '''Zodpovědět'''. Podmínkou pro spuštění této funkce je navíc opět to, aby parametry těchto e-mailů byly nakonfigurovány ve formuláři '''Nastavení''' – '''Globální''' – '''Odpověď – e-mail'''.

Volba '''Automatické formátování''' nastavená na ''zaškrtnuto'' znamená, že se při zobrazování textů otázek a odpovědí (klíčové slovo <nowiki> a </nowiki>) nahrazují konce odstavů stejným způsobem, jako tomu je při zapnutém automatickém formátování u těla zpráv.

Volba '''Práva''' definuje režim modulu z hlediska přístupových práv ke správě dat modulu, s volbou je spojen i interface, který se pro správu obsahu poraden používá.

Pokud je radiopřepínač '''Práva''' v předvolbách nastaven na ''Standardní práva'', znamená to, že

* Funkce '''Poradny''' (tj. administrace seznamu poraden) je pouze v části nabídky '''Administrace''' modulu
* Funkce '''Administrace''' - '''Práva''' je v hlavní nabídce modulu
* Seznam poraden může spravovat pouze administrátor, který pak v nabídce '''Administrace''' - '''Práva''' může nastavit, který tým spravuje obsah které poradny.

Pokud je radiopřepínač '''Práva''' v předvolbách nastaven na ''Zjednodušená práva'', je třeba pomocí tlačítka '''Tým''' vybrat, který tým spravuje data modulu. Pak to znamená, že

* Pokud je přihlášený uživatel členem týmu ''Administrátoři'', má k dispozici nabídku '''Administrace''' - '''Poradny''', pomocí které spravuje seznam poraden.
* Pokud je přihlášený uživatel členem týmu, který je vybrán v předvolbách modulu v roli ''Editor'', má k dispozici nabídku '''Data''' - '''Poradny''', která vypisuje to samé co '''Administrace''' - '''Poradny''', tj. lze kompletně spravovat seznam poraden.
* Nabídka '''Administrace''' - '''Práva''' při této volbě vůbec není k dispozici.
* Pokud je přihlášený uživatel členem týmu, který je vybrán v předvolbách modulu v roli ''Editor'' nebo ''Redaktor'', má možnost spravovat obsah všech poraden, tj. má přístup k dalším funkcím v sekci '''Data''' nabídky.

Výsledkem tedy v tomto zjednodušeném režimu je, že sekce '''Administrace''' nabídky je určena pouze administrátorům, sekce '''Data''' je v tomto režimu přístupná jednomu vybranému týmu a editoři tohoto týmu mají oproti redaktorům jednu položku v sekci [[#Data|Data]] navíc (tj. položku '''Poradny''', pomocí níž spravují seznam poraden).

====Údaje====
Pomocí formuláře '''Údaje''' se nastavuje, které možné vstupní prvky jsou součástí vstupních formulářů pro zadávání nových dotazů a které z nich je povinné vyplnit. Tato volba je globální pro všechny poradny.

[[Image:poradnyarozhovory-reference-img012.png|center]]

Jedná se o následující možná pole

* FIRSTNAME – křesní jméno
* LASTNAME – příjmení
* NICKNAME – přezdívka
* EMAIL – e-mailová adresa
* QUESTION – otázka
* NAME – název otázky (nadpis)
* PRIVATE – označení otázky jako privátní, tj. tazatel žádá o nezveřejnění odpovědi na veřejné části webové prezentace

Všechna pole se generují do HTML kódu vstupního formuláře jako textová pole s výjimkou QUESTION (zaškrtávací okénko).

V každém řádku je možné nastavit:

* '''Popis''' – popisek generovaný do vstupního formuláře
* '''Aktivní''' – zda se do pole zapisuje
* '''Povinný''' – zda je vyžadováno povinné vyplnění

Při manipulaci s tímto formuláře je třeba si uvědomit, že zpětné změny nemají vliv na jednou vygenerované vstupní formuláře, ale ovlivňují dotazy, které jsou vkládány. Např. deaktivace pole NICKNAME znamená, že do tohoto pole nebude při vložení nového dotazu nikdy zapisováno, neznamená to ale, že automaticky zmizí ze vstupního formuláře, pokud již takový existuje. Vstupní formulář je v případě potřeby změny třeba upravit ručně nebo jej znovu vygenerovat jako fragment a nahradit jím ten původní.

====Práva====
Pomocí funkce '''Práva''' se způsobem obvyklým ve všech modulech WebToDate nastavují práva pro přístup k datům modulu. V levém seznamu se zobrazuje seznam poraden, v prostředním poli se nastavují týmy uživatelů, které mají přístup k datům vybrané poradny.

<div class="note">Poznámka: můžete využít toho, že uživatel WebToDate může být členem více týmů. Lze tedy např. vytvořit tým speciálně pro účely správy poradny a do něj přidat vybrané uživatele v roli ''Redaktor''.</div>

====Poradny====
Pomocí položky '''Poradny''' v sekci '''Administrace''' nabídky se zakládají nové poradny a nastavují jejich základní vlastnosti. Stejná funkce se nabízí editorům zvoleného týmu v případě, že je radiopřepínač '''Práva''' v předvolbách nastaven na ''Zjednodušená práva''.

V pravém horním rámci se zobrazuje seznam poraden. Seznam obsahuje název poradny a popis a dále sloupec ''Změněno'', který vyznačuje,kdy naposledy se změnil obsah poradny (např.
kdy byl naposledy zodpovězen či editován nějaký dotaz.). Klepnutím na popisek sloupce ''ID'', ''Název'' nebo ''Změněno'' se seznam přetřídí podle tohoto sloupce, výchozí třídění
seznamu je podle ID poradny sestupně. Klepnutím na '''Vyhledat''' se zobrazí formuláře pro vyhledávání v seznamu poraden, do textového pole se zadává text, který se hledá
v názvu i popisu poraden.

Klepnutím na název poradny se v pravém spodním rámci zobrazí formulář pro nastavení vlastností poradny.

[[Image:poradnyarozhovory-reference-img013.png|center]]

Ve formuláři se nastavují následující vlastnosti:

* '''Název''' – povinně se vyplňuje název poradny
* '''Popis''' – nepovinně je možné doplnit další textový popis, který pak lze zobrazovat např. na výchozí stránce poradny
* '''E-mail –''' jedná se o e-mailovou adresu, na kterou jsou eventuálně zasílány nové dotazy vložené do této poradny z veřejné části webové prezentace
* '''Data jsou přístupná pro čtení''' - určuje, kteří uživatelé mohou zobrazovat data (seznamy a detaily dotazů) dané poradny. Možné volby jsou ''Nikomu'' / ''Všem'' / ''Registrovaným''.
* '''Vkládat data mohou''' - určuje, kteří uživatelé mohou do poradny vkládat nové dotazy. Možné volby jsou ''Nikdo'' / ''Všichni'' / ''Registrovaní''.
* '''Přihlašovací režim''' – definuje, kteří návštěvníci webové prezentace mají do dané poradny přístup a jak se zpracovávají jejich údaje
* '''Předpis''' – předpis je připravená sada nastavení týkajících se zejména formátovacích funkcí prezentace. Všechny stránky týkající se dané poradny jsou formátovány pomocí nastavení daných ve vybraném předpisu. Více o předpisech je uvedeno v kapitole [[../Reference#Nastavení|Nastavení]].
* '''Jazyk''' – u vícejazyčných www prezentací lze vybrat jazyk, který se v dané poradně používá

Dále se ve formuláři zobrazuje bez možnosti změny celkový počet dotazů v poradně a datum a čas poslední modifikace obsahu poradny.

Speciální možností pro tvorbu stránek s poradnami, které v popisu obsahují bohaté formátování včetně např. obrázků apod. je funkce '''Vložit zprávu''' vedle pole '''Popis'''. Tato funkce zobrazí dialogové okno pro výběr zprávy / zdroje / fragmentu z databáze WebToDate.

[[Image:poradnyarozhovory-reference-img014.png|center]]

Dialogové okno se obsluhuje podobně jako vyhledávání ve zprávách WebToDate. Základní rozdíl je v tom, že šipka v levém sloupci seznamu zpráv vkládá do textového pole s popisem klíčové slovo typu <nowiki></nowiki>, za které se pak při zobrazení akce dosazuje kompletní zobrazení zprávy / zdroje / fragmentu jako kdyby byl zobrazován přes prezentační skript ''/scripts/detail.php'' WebToDate.

Aby byla tato funkce využitelná, je tedy třeba:

* Vytvořit předlohu pro zprávy, která ze zpráv používaných k tomuto účelu zobrazuje jen žádoucí pole (např. jen tělo zprávy), nemá smysl, aby předloha zobrazovala navigační elementy a další prvky layoutu celého webu.
* Zvolit pro ukládání takových zpráv vhodnou kategorii ve stromu kategorií, která nebude fulltextově prohledávaná.

Pole pro popis poradny pak může obsahovat buď jen jednu, nebo několik značek typu <nowiki></nowiki>, nebo jen prostý text s popisem, nebo kombinaci obojího. I když do popisu lze ručně vkládat HTML formátování, při potřebě složitějšího bohatě formátovaného textu zobrazujícího se ve stránce s akcí je vhodnější využít tuto funkci '''Vložit zprávu'''.

Nastavení ''Data jsou přístupná pro čtení'' se vztahuje na následující skripty:

* ''questionlist.php'' (výpis seznamu dotazů)
* ''detail.php'' (detail jednoho dotazu)

To znamená, že pokud je např. zvoleno ''Registrovaným'', vyžadují tyto dvě stránky pro danou poradnu přihlášení, pokud je zvoleno ''Nikomu'', nelze pro danou poradnu tyto dvě stránky zobrazit apod. Nastavení se nevztahuje na skripty ''default.php'' (seznam poraden) a ''firstpage.php'' (úvodní stránka poradny), tyto dvě stránky mohou vždy zobrazit všichni anonymní uživatelé.

Nastavení ''Vkládat data mohou'' se vztahuje na skript ''newquestion.php'' (vložení nového dotazu). Pokud je např. zvoleno ''Registrovaní'', je pro vstup na tuto stránku vyžadováno přihlášení, pokud je zvoleno ''Nikdo'', nelze tuto stránku vůbec zobrazit apod. Kontrola se provádí vždy. To znamená, že i když se vloží formulář pro vložení dotazu začínající kódem

<code>
<nowiki><form action="/scripts/modules/advice/newquestion.php" method="post"></nowiki>
</code>

kamkoli (tj. jinam než na předlohu pro stránku pro vložení nového dotazu) a je nastaveno např. ''Nikdo'', nelze žádný dotaz do poradny vložit apod.

Pokud se uživatel pokouší zobrazit stránku, ke které nemá přístup, zobrazí se stránka typu odmítnutí přístupu.

Možnosti nastavení hodnoty ''Přihlašovací režim'' jsou následující:

* Anonymní uživatelé – přístup do poradny je povolen všem anonymním uživatelům. S uživatelskými údaji (s e-mailovou adresou, přezdívkou apod.) se nijak aktivně nepracuje.
* Rozpoznávat anonymní uživatele – poradna je přístupná všem anonymním uživatelům. S uživatelskými údaji se pracuje aktivně. To znamená, že pokud již v nějakém modulu uživatel zadal např. e-mailovou adresu, je mu předvyplněna (za klíčové slovo <nowiki></nowiki> ve formuláři pro vložení nového dotazu), naopak když ji zde zadá, je uložena do záznamu anonymního uživatele v databázi.
* Rozpoznávat registrované uživatele – poradna je povolena pouze registrovaným uživatelům. Pokud je uživatel registrován a registrace je rozpoznána (pomocí cookies), je automaticky přihlášen, jinak je před vstupem do poradny přesměrován na přihlašovací stránku modulu '''Registrace a personalizace'''.
* Vyžadovat přihlášení vždy – poradna je povolena pouze registrovaným uživatelům. Je vyžadováno přihlášení k modulu '''Registrace a personalizace''', pokud není (v rámci session) uživatel přihlášen, je přesměrován na přihlašovací stránku.

Poslední dva režimy se v předvolbách zobrazují, jen pokud je modul '''Registrace a personalizace''' instalován.

====Kategorie====
Poslední položkou nabídky '''Administrace''' je položka '''Kategorie''', která slouží k definici seznamu kategorií v jednotlivých poradnách. Každá poradna může mít vlastní kategorie, kategorie v poradnách jsou nepovinné, pokud se používají, nelze jednu kategorii sdílet mezi více poradnami.

Seznam kategorií dané poradny lze měnit jen, když je vybrána nějaká poradna v uživatelské session. Pokud tomu tak není, objeví se v pravém horním rámci text

[[Image:poradnyarozhovory-reference-img015.png|center]]

Po klepnutí na ''zvolit'' se zobrazí seznam poraden, klikem na název poradny se daná poradna vybírá. Teprve pak je možné zobrazit seznam kategorií vybrané poradny.

V pravé horní části okna prohlížeče se zobrazuje seznam kategorií zvolené poradny, ve spodním rámci se pak zobrazuje formulář pro úpravu vybrané kategorie.

[[Image:poradnyarozhovory-reference-img016.png|center]]

Kategorií může být v jedné poradně libovolný počet. Přidávat kategorie lze bez omezení, mazat jen pokud již kategorie není použita. Stejně tak lze změnit poradnu, ve které má kategorie figurovat jen pokud ještě do dané kategorie nejsou zařazeny nějaké dotazy. Přejmenovat kategorii lze vždy.

<div class="note">Zařazení dotazu do kategorie se provádí ve formuláři pro úpravy dotazu. Tento úkon může provádět pouze uživatel editující dotaz v administračním rozhraní modulu, do kategorií nemohou dotazy řadit uživatelé vkládající dotaz z veřejné části webové prezentace.</div>

====Antispamové profily====
V nabídce '''Antispamové profily''' se definují nastavení ochrany proti formulářovému spamu. Antispamový profil je pojmenovaná sada nastavení, pomocí kterých se vybírá, jaký typ ochrany se pro vkládání dotazů aplikuje. Na úrovni definice poradny se pak vybírá odpovídající profil, který daná poradna použije. Všechny poradny mohou využívat stejný profil nebo je možné nadefinovat více profilů a ty pak nastavit u různých poraden dle potřeby.

V horní části okna prohlížeče je seznam profilů, klepnutím na název profilu se zobrazí formulář pro definici profilu.

[[Image:poradny-administrace-antispamoveho-profilu.png|center]]

Přidávat profily a měnit jejich nastavení je možné bez omezení, smazat profil lze jen když není použit u nějaké poradny.

V následující tabulce je stručně uveden význam jednotlivých voleb, problematice spamu je věnována samostatná kapitola [[../Ochrana proti spamu#Ochrana proti spamu|Ochrana proti spamu]].

{| class="prettytable"
| '''Položka'''
| '''Význam'''
| '''Kroky potřebné pro implementaci'''

|-
| Kontrola URL volající stránky
| Pomocí http ''referer'' se kontroluje, že skript pro vložení dotazu je volán z formuláře zobrazovaného pomocí tohoto modulu na daném serveru. Pokud se cizí aplikace pokouší přímo přes http protokol vložit příspěvek (nevyplňuje formulář na serveru), je příspěvek detekován jako spam.
| Kontrola nevyžaduje žádné další kroky.

|-
| Formulářová návnada
| Do pole '''Názvy polí formuláře''' se zadá jeden nebo několik názvů HTML polí ve vstupním formuláři (názvy se oddělují středníkem). Kontrola zjišťuje, jestli některé z těchto polí není čímkoli vyplněno, pokud zjistí, že některé pole má hodnotu, je příspěvek označen za spam.
| Kontrola vyžaduje vložení jednoho nebo několika formulářových polí do HTML kódu vstupního formuláře pro zadávání nových dotazů. Pole musí být skryta před uživatelem (jako typ ''hidden'' či pomocí CSS). Člověk pak takové pole nevyplňuje, spamovací robot jej může vyplnit.

|-
| Seznam zakázaných IP adres
| Při vložení se kontroluje, zda IP adresa, ze které dotaz přichází, není na seznamu zakázaných adres. Pokud tomu tak je, je položka označena za spam.
| Nevyžaduje žádné změny v prezentaci, ale vyžaduje zadání zakázaných IP adres pomocí funkce '''Data''' - '''Zakázané IP adresy''' nebo vložením IP adresy přímo z formuláře pro úpravu dotazu.

|-
| Vyhledávání spamu podle obsahu příspěvků
| V textu příspěvků se před vložením vyhledávají slova zadaná ve funkci '''Filtr slov''' s volbou '''Spam'''.
| Nevyžaduje žádné změny v prezentaci, ale vyžaduje naplnění seznamu nežádoucích výrazů pomocí funkce '''Filtr slov'''.

|-
| Opisování kontrolních kódů
| Uživateli jsou generovány do stránky kontrolní kódy, které musí opsat do daného textového pole. Lze navolit parametry kontrolních kódů - délku, zda se jedná o číslice či písmena apod.
| Vyžaduje do HTML kódu vstupního formuláře doplnění několika vstupních polí a klíčových slov modulu, aby bylo zajištěno zobrazení kontrolních kódů a zobrazilo se vstupní pole pro jejich opsání.

|}

=== Nastavení ===

V této sekci nabídky se nastavuje grafický vzhled a chování všech veřejně přístupných stránek modulu.

Pro poradny se podobně jako pro některé další moduly používají tzv. předpisy. Předpis je sada grafických a případně i funkčních nastavení, který se může týkat více různých typů stránek najednou. V tomto modulu každý definovaný předpis reprezentuje jednu sadu grafických nastavení pro poradnu. V jednom předpisu lze nadefinovat zobrazování stránek typu úvodní stránka poradny – samostatný výpis seznamu dotazů – detail jednoho dotazu – vložení nového dotazu. Všechny poradny pak mohou používat jeden předpis, nebo (pokud se zobrazují graficky odlišně) používat několik různých předpisů.
====Seznam předpisů====
Předpis se zakládá pomocí funkce '''Seznam předpisů'''. Ve formuláři se vyplňuje pouze název, který lze volit dle potřeby. Existující předpis lze libovolně přejmenovávat, smazat jen v případě, že není někde (u nějaké poradny) použit.

====Globální nastavení====
V této části nabídky je jako první sekce '''Globální''' – tato sekce sdružuje nastavení, která jsou společná pro všechny poradny.
=====Seznam poraden=====
Pomocí formuláře '''Seznam poraden''' se nastavuje zobrazení stránky vypisující seznam všech založených poraden ''(/''scripts/modules/advice/default.php'').

[[Image:poradnyarozhovory-reference-img017.png|center]]

Zde se povinně vybírá '''Předloha''' (šablona pro stránku ''/scripts/modules/advice/default.php'') a '''Styl seznamu poraden''', který definuje formátování seznamu těchto poraden. Počet záznamů poraden na jednu stránku se specifikuje v poli '''Počet záznamů na str'''. Dále lze zvolit třídění tohoto seznamu:

* Podle abecedy – seznam je tříděn podle názvu poradny
* Podle data poslední aktualizace – seznam je tříděn podle data poslední změny v obsahu poradny, takže poradny, ve kterých se v poslední době měnil obsah, jsou na začátku seznamu.

V nastavené předloze je seznam poraden reprezentován klíčovým slovem <nowiki></nowiki>.

<div class="note">Tuto stránku je výhodné nadefinovat, pokud se na serveru provozuje několik poraden. Je-li vytvořena jen jedna poradna, lze do ní vstoupit rovnou pomocí úvodní stránky poradny ''/scripts/modules/advice/firstpage.php?id=xxx '' a definice seznamu poraden není potřebná.</div>

=====Vyhledávání=====
Pomocí formuláře '''Vyhledávání''' lze nastavit vyhledávací stránku pro tento modul ''(/''scripts/modules/advice/fulltxt.php'').

[[Image:poradnyarozhovory-reference-img018.png|center]]

Opět se nastavuje předloha, styl seznamu nalezených položek a počet záznamů na stránku. Kromě toho je vhodné nadefinovat '''Uvozující nadpis výpisu''', který umožňuje zobrazit text informující o tom, jaká část výsledku vyhledávání se právě ve stránce nachází ("Dotazy 1 až 5 z 15:"). Seznam nalezených položek je v předloze pro stránku reprezentován klíčovým slovem <nowiki>, uvozující nadpis klíčovým slovem  a navigační stránkovací lišta klíčovým slovem . Dále pak je ve stránce zpravidla obvyklý vyhledávací formulář s klíčovými slovy jako </nowiki> apod. .; jednoduchý formulář tohoto typu se vygeneruje pomocí funkce '''Nástroje''' – '''Vyhledávání'''. Pokud není třeba v rámci dané implementace možnost prohledávání poraden zpřístupnit, nemusí se tato stránka vůbec nastavovat.

=====Navigační lišta=====
Ve formuláři '''Navigační lišta''' je definován vzhled lišty, která je používána pro stránkování seznamů položek.

[[Image:poradnyarozhovory-reference-img019.png|center]]

Grafický vzhled jednotlivých prvků navigační lišty se definuje pomocí následujících polí:

# '''Předchozí''' – HTML kód určující formátování odkazu pro přechod na předcházející stránku
# '''Následující''' – HTML kód určující formátování odkazu pro přechod na další stránku
# '''Hlavička''' – HTML kód který je umístěn na počátku výsledného kódu navigační lišty
# '''Patička''' – HTML kód který je umístěn na konci výsledného kódu navigační lišty
# '''Číslo stránky''' – formátování jednotlivých čísel stránky, které umožní odkliknutí na zvolenou stránku
# '''Aktivní stránka''' – formátování údaje o čísle aktuální stránky
# '''Separátor''' – oddělovač mezi jednotlivými čísly stránek.
# '''Počet stránek''' určuje maximální počet čísel stránek v navigační liště a tím nepřímo ovlivňuje i její šířku.

Pro správnou funkci navigační lišty je nutné do výše popsaných polí zadávat i klíčová slova<nowiki> a </nowiki>.

Jejich použití je zřejmé z následujícího jednoduchého příkladu:

[[Image:poradnyarozhovory-reference-img020.png|center]]

<div class="note">Definici navigační lišty je třeba po instalaci každého modulu v instalovaném modulu uložit – výchozí hodnoty se po instalaci v databázi nenacházejí a bez uložení se pak navigační lišta na žádné stránce nezobrazí.</div>

Navigační lišta je pak v předloze pro zobrazení seznamu diskuzních příspěvků reprezentována klíčovým slovem <nowiki></nowiki>.

=====Filtr slov=====
Funkce '''Filtr slov''' umožňuje definovat slovník nevhodných výrazů. V horním seznamu se zobrazují slova seřazená podle abecedy, ve spodním rámci se zobrazuje editační formulář.

[[Image:diskuze37-filtr-slov.jpg|center]]

Ve slovech lze používat hvězdičku jako zástupný znak pro více libovolných písmen.

Součástí definice filtrovaného výrazu jsou i příznaky, zda výraz použít při filtraci nežádoucích výrazů a při detekci spamu.

Výrazy označené pro použití při detekci spamu se použijí jen v případě, že v anitspamovém profilu, který používá daná diskuze, je zvolena možnost ''Vyhledávání spamu podle obsahu příspěvků''.

=====Odpověď e-mailem=====
Formulář '''Odpověď - E-mail''' slouží k nastavení parametrů odesílání e-mailů modulem. Může se jednat o dva druhy e-mailů:

* E-mail odesílaný správci poradny ve chvíli vložení nového dotazu z veřejné části www prezentace
* E-mail odesílaný tazateli ve chvíli zodpovězení dotazu.

První tři pole formuláře definují druhý případ, tedy odeslání e-mailu tazateli, druhé tři položky definují e-maily správci (moderátorovi) poradny.

[[Image:poradnyarozhovory-reference-img021.png|center]]

V obou případech se definuje:

* Formát e-mailu (text / HTML)
* Předloha pro e-maily
* Předmět e-mailu

V prvním řádku se navíc definuje e-mailová adresa odesílatele, která je pro obě funkce společná.

Předloha e-mailů pro správce poradny může mít (pro formát ''text'') např. zhruba následující kód:

<code>
<nowiki>V poradně je nový dotaz.</nowiki>
<nowiki>Přidělené ID dotazu: </nowiki>
<nowiki>Název dotazu: </nowiki>
<nowiki>Text dotazu: </nowiki>
<nowiki>Datum vložení dotazu: </nowiki>
</code>

=====Odmítnutí přístupu=====
Formulář '''Odmítnutí přístupu''' se používá k definici stránek, které se zobrazí v případě, že uživatel nemá k dané funkci přístup.

[[Image:poradnyarozhovory-reference-img022.png|center]]

Nastavují se dvě předlohy:

* '''Stránka pro odmítnutí přístupu pro čtení''' - tato předloha se uživateli zobrazí v případě, že vyvolá URL zobrazující seznam dotazů nebo detail dotazu a přitom je v poradně nastaveno, že tato data se nemají uživateli zobrazovat (např. je ve vlastnostech poradny zvoleno ''Data jsou přístupná pro čtení: Nikomu''.
* '''Stránka pro odmítnutí přístupu pro zápis''' - tato předloha se uživateli zobrazí v případě, že se pokusí o vložení dotazu do poradny a přitom nemá přístup k vkládání dat do poradny, tedy např. v případě, že v poradně je nastaveno ''Vkládat data mohou: Nikdo''.

Pokud je v poradně zapnuta jakákoliv ochrana proti spamu, je třeba nadefinovat, jak se má chovat skript pro vkládání dotazů v případě, že je dotaz označen za spam a do databáze se nevloží. Toto chování definuje volba '''Je-li příspěvek detekován jako spam'''. Na výběr jsou následující možnosti:

* '''Ukončit běh skriptu''' - okamžitě se ukončí běh skriptu pro vložení dotazu. Skript vypíše pouze identifikační značku dané metody kontroly spamu.
* '''Zobrazit stránku pro vložení příspěvku''' - znovu se načte formulář pro vložení dotazu do dané poradny.
* '''Přesměrovat na zvolenou stránku''' - přesměruje na stránku, kterou je nutné v případě této volby zvolit, jedná se o libovolnou stránku ze stromu kategorií WebToDate.

====Předpisy====
V druhé sekci části '''Nastavení''' nazvané '''Předpisy''' se nastavují jednotlivé předpisy. Pod každým názvem předpisu se zde zobrazují čtyři položky reprezentující čtyři možné způsoby zobrazení dat dané poradny:

# '''Úvodní stránka''' – nastavení definuje zobrazení úvodní stránky, která typicky obsahuje popis poradny a základní údaje (počet zodpovězených dotazů, čas poslední aktualizace), případně i seznam kategorií poradny.
# '''Seznam dotazů''' – toto nastavení definuje formátování výpisů seznamů dotazů v poradně.
# '''Detail''' – nastavení definuje stránku zobrazující jeden vybraný dotaz v poradně, typicky včetně odpovědi a dalších údajů (informace o tazateli, datum vložení a datum zodpovězení apod.).
# '''Nový dotaz''' – toto nastavení definuje stránku pro vkládání nových dotazů do poradny.

Všechny čtyři typy stránek nemusí být v daném předpisu nastaveny, záleží na konkrétním použití – např. pro předpis sloužící k nastavení nějakého rozhovoru nemá zpravidla smysl definovat stránku pro detail jednoho dotazu (zobrazuje se seznam dotazů včetně odpovědí) apod.

=====Úvodní stránka=====
Formulář '''Úvodní stránka''' slouží k nastavení zobrazení úvodní stránky poradny; jak může taková stránka vypadat, je naznačeno v kapitole [[../Začínáme#Vytvoření výchozí stránky poradny|Vytvoření výchozí stránky poradny]].

[[Image:poradnyarozhovory-reference-img023.png|center]]

Ve formuláři se nastavuje povinně '''Předloha''' (tj. šablona stránky ''/scripts/modules/advice/firstpage.php?id=xxx''), nepovinně pak '''Styl seznamu kategorií'''.

=====Seznam dotazů=====
Formulář '''Seznam dotazů''' definuje zobrazování výpisů seznamů dotazů (tedy stránky ''/scripts/modules/advice/questionlist.php?id=xxx''). Může jít o prostý seznam dotazů, může jít ale i o seznam dotazů včetně odpovědí případně včetně další informací (kdy bylo zodpovězeno, data o tazateli apod.) – co se přesně zobrazuje je dáno formátovacím stylem seznamu dotazů.

[[Image:poradnyarozhovory-reference-img024.png|center]]

Povinně se zde definuje předloha stránky a styl seznamu dotazů, nepovinně pak opět styl pro seznam kategorií. Styl seznamu dotazů může být tříděn podle času (data vložení dotazu) sestupně nebo vzestupně.

V předloze se typicky vyskytují klíčová slova <nowiki> (seznam dotazů) a  (navigační stránkovací lišta). Pokud je žádoucí zobrazovat seznam kategorií, používá se v předloze k tomuto účelu klíčové slovo </nowiki>.

Styl pro seznam dotazů (jeho tělo) pak může vypadat zhruba následovně:

<code>
<nowiki><tr></nowiki>
<nowiki><td></td></nowiki>
<nowiki><td><a href=""></a></td></nowiki>
<nowiki></tr></nowiki>
<nowiki><tr></nowiki>
<nowiki><td colspan="2"></nowiki>
<nowiki><em>Zadáno , zodpovězeno <br /></nowiki>
<nowiki>Tazatel   () <a href="mailto:"></a></em></nowiki>
<nowiki></td></nowiki>
<nowiki></tr></nowiki>
<nowiki><tr><td colspan="2"><strong>Dotaz:</strong><br /></td></tr></nowiki>
</code>

Takto definovaný styl zobrazuje název a text dotazu, údaje o tazateli, datum vložení a zodpovězení dotazu a odkaz na detailní stránku zobrazující celý text včetně odpovědi.

Jednoduchý styl seznamu kategorií vypadá např. takto:

<code>
<nowiki><a href=""></a><br /></nowiki>
</code>

=====Detail=====
Další součástí předpisu je formulář '''Detail''' definující stránku zobrazující detail jednoho dotazu (tedy stránku ''/scripts/modules/advice/detail.php?id=xxx'').

[[Image:poradnyarozhovory-reference-img025.png|center]]

Povinně se zde definuje předloha pro tento typ stránek, nepovinně analogicky jako v předchozích případech styl seznamu kategorií.

Následující blok HTML kódu je příkladem části předlohy pro detail dotazu, který zobrazuje název, otázku a odpověď a další informace jako jsou údaje o tazateli, ze které poradny dotaz je, zda se jedná o častý dotaz apod.

<code>
<nowiki><p></nowiki>
<nowiki></nowiki>
<nowiki></nowiki>
<nowiki></p></nowiki>
<nowiki><p></nowiki>
<nowiki>Kategorie dotazu: </nowiki>
<nowiki></p></nowiki>
<nowiki><table border="0" cellspacing="0" cellpadding="6" style="border:1px solid black;"></nowiki>
<nowiki><tr><td colspan="2" bgcolor="#efefef"><strong></strong></td></tr></nowiki>
<nowiki><tr><td>Dotaz</td><td></td></tr></nowiki>
<nowiki><tr><td>Odpověď</td><td> </td></tr></nowiki>
<nowiki><tr><td>Čas</td><td>Vloženo , zodpovězeno , poslední modifikace </td></tr></nowiki>
<nowiki><tr><td>Tazatel</td><td>  ()</td></tr></nowiki>
<nowiki></table></nowiki>
<nowiki><p>Tento dotaz je z poradny <strong><a href=" "></a></strong></p></nowiki>
</code>

=====Nový dotaz=====
Poslední částí předpisu je nastavení stránky pro '''Nový dotaz''', v tomto formuláři se vybírá pouze předloha stránky ''(/scripts/modules/advice/newquestion.php?id=xxx'', kde xxx je ID poradny).

[[Image:poradnyarozhovory-reference-img026.png|center]]

HTML kód části předlohy použitelný pro formulář pro vkládání nových dotazů se nejjednodušeji získá vygenerováním fragmentu pomocí funkce '''Nástroje''' – '''Nový dotaz'''.

=== Data ===

V sekci '''Data''' nabídky modulu lze spravovat obsah jednotlivých poraden – dotazy lze zodpovídat, dodatečně editovat i mazat.
====Poradny====
V případě, že uživatel je přihlášen jako editoru týmu, který spravuje obsah poraden a v předvolbách je zvoleno ''Zjednodušená práva'', je v této nabídce položka '''Poradny''', ta funguje stejně jako analogická nabídka v sekci '''Administrace''' pro administrátory.

Dále je logika ovládání následující:

# Pomocí nabídky '''Zvolit poradnu''' se zvolí, se kterou poradnou se pracuje
# Pomocí nabídky '''Vybraná poradna''' se pracuje se seznamem dotazů v dané poradně
# Pokud chceme pracovat s dotazy v jiné poradně, použije opět funkci '''Zvolit poradnu''' a vybereme jinou poradnu.
====Zvolení poradny====
Funkce '''Zvolit poradnu''' vypisuje seznam poraden, klepnutím na název poradny se daná poradna zvolí. Po zvolení modul v pravém horním rámci rovnou přechází na zobrazení seznamu dotazů ve zvolené poradně.

====Vybraná poradna====
Seznam dotazů v poradně se vyvolává pomocí funkce '''Vybraná poradna'''. Pokud není ještě žádná poradna vybrána, nabídne se poradna k výběru. Seznam se vypisuje v pravém horním rámci. Jako výchozí kritérium pro zobrazení seznamu se vybírají dotazy, které jsou v dané poradně a mají stav ''Nezodpovězen'' nebo ''Zveřejněn - nezodpovězen''. Důvodem je to, aby byl okamžitě k dispozici přehled dotazů čekajících na zodpovězení. Pokud žádný takový dotaz v dané poradně neexistuje, zobrazí se místo seznamu informační text tak, jak je vidět na následujícím otisku obrazovky. Pomocí odkazu '''všechny''' lze jednoduše vypsat seznam všech dotazů, dále je v informačním textu aktivní odkaz '''vyhledávací formulář'''.

[[Image:poradnyarozhovory-reference-img027.png|center]]

Vyhledávání je možné podle následujících položek:

* ID dotazu
* Vloženo od – do
* Kategorie
* Stav
* Neveřejný dotaz
* Častý dotaz

Je-li ve vyhledávacím formuláři vyplněno více kritérií, spojují se logickou spojkou "a zároveň".

V liště seznamu dotazů jsou navíc odkazy ''Nezodpovězené'' resp. ''Zveřejněn - nezodpovězen'', které slouží k rychlému vyvolání výpisu dotazů v tom kterém stavu.

Vlastní seznam dotazů je vždy setříděn podle data vložení dotazu, v seznamu se zobrazují následující sloupce:

* ID dotazu
* Název dotazu
* Část textu dotazu (cca 150 znaků)
* Datum a čas vložení
* Datum a čas zodpovězení
* Ikona stavu dotazu

[[Image:poradnyarozhovory-reference-img028.png|center]]

Klepnutím na název dotazu se přechází v pravém spodním rámci na formulář pro zodpovězení resp. editaci dotazu. Formulář má tři záložky ('''Dotaz''', '''Odpověď''' a '''Vlastnosti'''), ve kterých se postupně nacházejí následující pole:

* '''Název''' – název dotazu
* '''Dotaz''' – vlastní text dotazu
* '''Odpověď''' – text odpovědi
* '''Kategorie''' – dotaz patří do maximálně jedné kategorie, kategorie jsou pro každou poradnu specifické
* '''Vloženo''' – datum a čas vložení dotazu
* '''Zodpovězeno''' – datum a čas zodpovězení dotazu
* '''Modifikováno''' – datum a čas poslední modifikace záznamu (nelze uživatelsky měnit)
* '''Neveřejný dotaz''' – zaškrtávací okénko; pokud je dotaz označen za neveřejný, neprezentuje se na veřejně přístupných seznamech dotazů, i když je zodpovězen
* '''Častý dotaz''' – dotaz lze pomocí zaškrtávacího okénka označit za častý, seznam častých dotazů lze pak na veřejné části www prezentace zobrazit pomocí URL ''/scripts/modules/advice/questionlist.php?id=xxx&frequent=y'', kde xxx je ID poradny
* '''E-mail''' – e-mail tazatele
* '''Jméno''' – křestní jméno tazatele
* '''Příjmení''' – příjmení tazatele
* '''Přezdívka''' – přezdívka (''nickname'') tazatele
* '''IP adresa''' - IP adresa, ze které byl dotaz vložen

Vždy je přístupná nabídka '''Stav''', která nese vždy právě jednu z následujících hodnot:

* '''Nezodpovězen''' – dotaz čeká na zodpovězení, nezobrazuje se na veřejné části www prezentace
* '''Zodpovězen''' – dotaz je zodpovězen, zobrazuje se na veřejné části www prezentace až na případ, kdy je nastaven příznak ''Neveřejný dotaz''
* '''Nebude zodpovězen''' – správce poradny rozhodl, že dotaz nebude zodpovězen (např. přesahuje rámec dané poradny). Výpis takto označených dotazů lze zobrazit na veřejné části www prezentace na stránce ''/scripts/modules/advice/questionlist.php?id=xxx&noreply=y'', kde xxx je ID poradny.
* '''Zveřejněn - nezodpovězen''' - dotaz (ještě) není zodpovězen, ale zobrazuje se na veřejné části www prezentace v seznamu dotazů (ve výchozím stavu mixovaně se zodpovězenými dotazy)

Ve formuláři se zobrazují tlačítka '''Přidat''', '''Uložit''', '''Nový''' a '''Smazat''', které fungují běžným způsobem, smazat dotaz lze vždy, protože k němu neexistují další návaznosti (tedy i zodpovězené dotazy). Rovněž tak editovat dotaz a následně uložit změny tlačítkem '''Uložit''' lze vždy, formulář pouze zabrání uložení v případě, že některá pole nejsou vyplněna (např. '''Vloženo'''). Uložit dotaz bez vyplněného pole '''Název''' lze, pak se v seznamu zobrazuje jako "bez názvu".

Poradnu lze plnit dotazy i výlučně z administračního rozhraní (např. pro prvotní naplnění daty) – není vyžadováno, aby dotaz byl vložen z veřejné části prezentace, nový dotaz lze založit i v administračním rozhraní.

Speciální funkci má tlačítko '''Zodpovědět''', které slouží k zrychlenému zodpovídání dotazů. Tlačítko provádí najednou několik akcí:

* Nastaví '''Zodpovězeno''' na aktuální datum a čas
* Nastaví stav na ''Zodpovězen''
* Uloží formulář do databáze
* Odešle informační e-mail tazateli (pokud je toto zasílání zvoleno v předvolbách modulu)

<div class="note">Pouze tímto tlačítkem lze vyvolat odeslání e-mailu tazateli, tuto funkci nelze vyvolat jiným způsobem.</div>

Tlačítko není přístupné, pokud je stav dotazu ''Zodpovězeno''.

<div class="note">Poznámka: Pokud ručně změníme stav dotazu a uložíme dotaz do databáze, tlačítko '''Zodpovědět''' bude opět přístupné a jeho použití provede přesně to, co je uvedeno výše, tedy včetně opětovného odeslání e-mailu.</div>

====Protokoly====
V části '''Protokoly''' lze procházet protokol modulu týkající se zápisů nových dotazů.

[[Image:poradny-zobrazit-protokol.png|center]]

Zobrazují se záznamy o vložených i odmítnutých dotazech, pokud je vložení odmítnuto antispamovou kontrolou, je zde uveden typ kontroly, která odmítnutí vyvolala.

====Zakázané IP adresy====
Funkce '''Zakázané IP adresy''' ovládá přidávání IP adres na blacklist (seznam zakázaných adres) a jejich odstraňování z blacklistu.

[[Image:diskuze47-zakazane-ip-adresy.jpg|center]]

Seznam adres je společný pro všechny poradny a ovládá se stejným způsobem jako jiné funkce WebToDate modulů. Ve formuláři se zadává pouze IP adresa, datum vložení a údaj o uživateli se doplňuje automaticky.

== Veřejné skripty ==
=== Prezentační skripty ===

V adresáři ''/scripts/modules/advice/'' se nacházejí veřejně přístupné prezentační skripty modulu. Jedná se o následující skripty:

{| class="prettytable"
| '''Skript'''
| '''Funkce'''

|-
| default.php
| Skript zobrazuje seznam založených poraden

|-
| firstpage.php
| Skript zobrazuje úvodní stránku poradny

|-
| questionlist.php
| Skript zobrazuje seznam dotazů v poradně

|-
| detail.php
| Skript zobrazuje detailní stránku jednoho dotazu v poradně

|-
| newquestion.php
| Skript slouží jako stránka pro vkládání nových dotazů

|-
| fulltxt.php
| Skript je vyhledávací stránkou podporující fulltextové hledání v poradnách

|}

=== Klíčová slova modulu ===

Modul používá následující prefixy klíčových slov používaných ve WebToDate stylech nebo předlohách pro stránky:

* WTD_ADVICE – pro položky specifické pro tento modul (název dotazu, text otázky, seznam dotazů apod.)
* WTD_USER – pro položky vkládané z registrační databáze (registrovaných či anonymních uživatelů), např. pro předvyplnění e-mailové adresy apod., případně pro zobrazení informací o tazateli.

Následující klíčová slova se používají v předlohách pro seznamy položek (poraden, dotazů) a jejich stránkování.

{| class="prettytable"
| colspan="3" | Klíčová slova reprezentující seznamy položek a jejich stránkování

|-
| '''Klíčové slovo'''
| '''Význam'''
| '''Poznámka'''

|-
| <nowiki></nowiki>
| Seznam poraden
| Používá se v předloze pro stránku vypisující seznam poraden ''/scripts/modules/advice/default.php''

|-
| <nowiki></nowiki>
| Seznam dotazů
| Používá se v předloze pro stránku vypisující seznam dotazů ''/scripts/modules/advice/questionlist.php'' nebo ve stránce pro vyhledávání ''/scripts/modules/advice/fulltxt.php''

|-
| <nowiki></nowiki>
| Navigační lišta pro seznam
| Používá se ve stránkách pro seznamy dotazů, vyhledávání a seznamy poraden

|-
| <nowiki></nowiki>
| Uvozující nadpis výpisu seznamu nalezených ("Dotazy až 10 z 30")
| Funkční pouze v předloze vyhledávací stránky ''/scripts/modules/advice/fulltxt.php''

|-
| <nowiki></nowiki>
| Výpis seznamu kategorií poradny
| Lze použít v předloze pro úvodní stránku poradny, seznam dotazů a detail dotazu

|}

Následující klíčová slova se používají pro zobrazení informací o dané poradně. Reprezentují vlastnosti celé poradny, jako je název poradny, počet zodpovězených dotazů v poradně apod. Lze je tedy použít ve stránce pro seznam poraden (stylu seznamu poraden), v úvodní stránce poradny (v předloze), ve stránce se seznamem dotazů (v předloze) či ve stránce pro detail dotazu (opět v předloze)

{| class="prettytable"
| colspan="3" | Klíčová slova reprezentující informace o dané poradně

|-
| '''Klíčové slovo'''
| '''Význam'''
| '''Poznámka'''

|-
| <nowiki></nowiki>
| ID poradny
|

|-
| <nowiki></nowiki>
| Název poradny
|

|-
| <nowiki></nowiki>
| Popis poradny
|

|-
| <nowiki></nowiki>
| URL úvodní stránky poradny
|

|-
| <nowiki></nowiki>
| Datum poslední aktualizace obsahu poradny
| Zahrnuje všechny operace týkající se zodpovězených dotazů, datum aktualizace se tedy nemění při vložení nového dotazu z veřejné části www prezentace

|-
| <nowiki></nowiki>
| Počet dotazů v poradně ve stavu ''Zodpovězen''
|

|-
| <nowiki></nowiki>
| Počet dotazů v poradně ve stavu ''Zveřejněn - nezodpovězen''
|

|-
| <nowiki></nowiki>
| Počet dotazů v poradně ve stavu ''Zodpovězen'' nebo ''Zveřejněn - nezodpovězen''
|

|}

Jednoduchý příklad použití těchto klíčových slov je tělo stylu pro výpis seznamu poraden:

<code>
<nowiki><h3><a href=""></a></h3></nowiki>
<nowiki></nowiki>
<nowiki><div></nowiki>
<nowiki>Poslední aktualizace: <br/></nowiki>
<nowiki>Zodpovězených dotazů: </nowiki>
<nowiki></div></nowiki>
</code>

Následující klíčová slova se používají pro zobrazení jednotlivých polí dotazů jako je název dotazu, datum vložení dotazu apod. Lze je použít ve stylu pro seznam dotazů, v předloze pro detail dotazu či ve stylu pro výpis výsledků hledání.

{| class="prettytable"
| colspan="3" | Klíčová slova reprezentující položky jednotlivých dotazů

|-
| '''Klíčové slovo'''
| '''Význam'''
| '''Poznámka'''

|-
| <nowiki></nowiki>
| ID dotazu
|

|-
| <nowiki></nowiki>
| Název dotazu
|

|-
| <nowiki></nowiki>
| URL pro zobrazení detailní stránky s jedním dotazem
|

|-
| <nowiki></nowiki>
| Datum vložení dotazu
|

|-
| <nowiki></nowiki>
| Čas vložení dotazu
|

|-
| <nowiki></nowiki>
| Datum zodpovězení dotazu
|

|-
| <nowiki></nowiki>
| Čas vložení odpovědi
|

|-
| <nowiki></nowiki>
| Text dotazu
|

|-
| <nowiki></nowiki>
| Text odpovědi
|

|-
| <nowiki></nowiki>
| IP adresa tazatele
|

|-
| <nowiki></nowiki>
| Křestní jméno tazatele
|

|-
| <nowiki></nowiki>
| Příjmení tazatele
|

|-
| <nowiki></nowiki>
| Přezdívka tazatele
|

|-
| <nowiki></nowiki>
| E-mailová adresa tazatele
|

|}

Pro IP adresy lze použít formátovací konstrukci, která nahradí část IP adresy zvoleným řetězcem, aby nebylo nutné zobrazovat ve veřejně přístupných stránkách kompletní IP adresy uživatelů. Používá se výraz

''<nowiki></nowiki>''

tedy např.

<code>
<nowiki>")--></nowiki>
</code>

Formátovací předpis předpokládá, že se maskují části adresy mezi tečkami v IP adrese. Pro zobrazovanou část IP adresy se použije hvězdička, pro nezobrazovanou libovolný řetězec. "*.*.*.xxx" tedy bude zobrazovat "234.160.21.xxx", "cosi.*.yy.*" bude zobrazovat "cosi.160.yy.168" apod.

Modul dále podporuje [[../../Referenční/Klíčová slova WebToDate#Klíčová slova pro formátování|Klíčová slova pro formátování]] typu WTD_FORMAT, tedy např.

''<nowiki></nowiki>''

apod.

Dále uvedená klíčová slova se používají ve formuláři pro vkládání nových dotazů pro hodnoty formulářových polí.

{| class="prettytable"
| colspan="3" | Klíčová slova pro formuláře pro vkládání dotazů

|-
| '''Klíčové slovo'''
| '''Význam'''
| '''Poznámka'''

|-
| <nowiki></nowiki>
| Název dotazu
|

|-
| <nowiki></nowiki>
| Text dotazu
|

|-
| <nowiki></nowiki>
| Křestní jméno tazatele
|

|-
| <nowiki></nowiki>
| Příjmení tazatele
|

|-
| <nowiki></nowiki>
| Přezdívka tazatele
|

|-
| <nowiki></nowiki>
| E-mailová adresa tazatele
|

|-
| <nowiki></nowiki>
| Příznak zaškrtnutí žádosti o nezveřejnění odpovědi
| Používá se jako
<nowiki><input type="checkbox" name="private" id="private"  /></nowiki>

|-
| <nowiki></nowiki>
| Skrytý kontrolní kód
| Používá se pro [[../Ochrana proti spamu|antispamovou ochranu]] typu ''Opisování kontrolních kódů''

|-
| <nowiki></nowiki>
| Zobrazovaný kód k opsání
| Používá se pro [[../Ochrana proti spamu|antispamovou ochranu]] typu ''Opisování kontrolních kódů''

|}

Následující klíčová slova lze použít pro formátování výpisu seznamu kategorií dané poradny – využívají se tedy v těle stylu pro seznam kategorií poradny. Dále je lze použít v předloze pro detailní stránku s jedním dotazem, kde mohou zobrazit informaci o tom, ve které kategorii se dotaz nachází.

{| class="prettytable"
| colspan="3" | Klíčová slova reprezentující položky seznamu kategorií poradny

|-
| '''Klíčové slovo'''
| '''Význam'''
| '''Poznámka'''

|-
| <nowiki></nowiki>
| Název kategorie
|

|-
| <nowiki></nowiki>
| URL kategorie
| Dosazuje URL ve tvaru ''/scripts/modules/advice/questionlist.php?id=xxx&categid=yyy'', kde xxx je ID poradny a yyy ID kategorie

|}

Následující klíčová slova lze použít ve vyhledávácím formuláři pro prohledávání poraden. Formulář lze umístit (to znamená, že následující klíčová slova budou funkční a nahrazena při zobrazování stránky obsahem) na úvodní stránku poradny, vyhledávací stránku, seznam dotazů a detail dotazu.

{| class="prettytable"
| colspan="3" | Klíčová slova pro vyhedávací formulář

|-
| '''Klíčové slovo'''
| '''Význam'''
| '''Poznámka'''

|-
| <nowiki></nowiki>
| Vyhledávaný text
|

|-
| <nowiki></nowiki>
| Část HTML tagu SELECT zobrazující pop-up menu se seznamem poraden
|

|-
| <nowiki></nowiki>
| Část HTML tagu SELECT zobrazující pop-up menu se seznamem jazyků
| Pomocí této možnosti lze prohledávat jen poradny označené daným jazykem

|}

Vyhledávací formulář s možností výběru prohledávání všech poraden nebo jedné konkrétní poradny může vypadat např. takto:

<code>
<nowiki><form action="fulltxt.php" method="get"></nowiki>
<nowiki><table nowrap border="0" cellspacing="2" cellpadding="4"></nowiki>
<nowiki><tr><td colspan="2"></nowiki>
<nowiki><strong>Hledání v poradnách</strong></nowiki>
<nowiki></td></tr></nowiki>
<nowiki><tr><td colspan="2"></nowiki>
<nowiki><input type="text" name="searchtext" value="" size="43" maxlength="80"> </nowiki>
<nowiki><input type="submit" name="Action" value="Hledat" class="formbutton"></nowiki>
<nowiki></td></tr></nowiki>
<nowiki><tr><td valign="top"></nowiki>
<nowiki><span class="formlabel">Poradna:</span><br></nowiki>
<nowiki><select name="id"></nowiki>
<nowiki><option selected="selected" value="0">--všechny--</option></nowiki>
<nowiki></nowiki>
<nowiki></select></nowiki>
<nowiki></td></tr></nowiki>
<nowiki></table></nowiki>
<nowiki></form></nowiki>
</code>

Modul podporuje v určitých případech podmíněné vkládání kódu pomocí syntaxe WTD_IF. Používá se pro vkládání chybových hlášení, výpis informace o příznacích příspěvku apod. Následující tabulka obsahuje přehled těchto klíčových slov a jejich možného užití.

{| class="prettytable"
| colspan="3" | Klíčová slova pro podmíněné vkládání kódu

|-
| '''Klíčové slovo'''
| '''Význam'''
| '''Poznámka'''

|-
| <nowiki></nowiki>
| Kód se vloží v případě, že se vypisují časté dotazy
| Lze použít pouze v předloze (nikoliv v těle stylu) pro seznam dotazů ''questionlist.php'' nebo v předloze pro detail (''detail.php'')

|-
| <nowiki></nowiki>
| Kód se vloží v případě, že se vypisují dotazy, které nebudou zodpovězeny
| Lze použít pouze v předloze (nikoliv v těle stylu) pro seznam dotazů ''questionlist.php'' nebo v předloze pro detail (''detail.php'')

|-
| <nowiki></nowiki>
| Kód se vloží v případě, že se vypisuje seznam všech dotazů v poradně
| Lze použít pouze v předloze pro stránku se seznamem dotazů ''questionlist.php''

|-
| <nowiki></nowiki>
| Kód se vloží v případě, že dotaz není zařazen do žádné kategorie
| Lze použít pouze v předloze pro detail dotazu (''detail.php'')

|-
| <nowiki></nowiki>
| Kód se vloží v případě, že kritériu pro výpis seznamu dotazů nevyhovuje žádný dotaz
| Lze použít pouze v předloze pro stránku se seznamem dotazů ''questionlist.php''

|-
| <nowiki></nowiki>
| Kód se vloží v případě, že nejsou definovány žádné poradny
| Lze použít pouze v předloze pro stránku se seznamem poraden ''default.php''

|-
| <nowiki></nowiki>
| Kód se vloží v případě, že není vyplněné nějaké povinné pole
| Lze použít pouze v předloze pro stránku pro vkládání nových dotazů (''newquestion.php'')

|-
| <nowiki></nowiki>
| Kód se vloží v případě, že není korektně vyplněn e-mail
| Lze použít pouze v předloze pro stránku pro vkládání nových dotazů (''newquestion.php'')

|-
| <nowiki></nowiki>
| Vkládá se, pokud je stav dotazu ''Zodpovězen''
| Lze použít pouze v předloze pro detail dotazu (''detail.php'') nebo ve stylu pro seznam dotazů

|-
| <nowiki></nowiki>
| Vkládá se, pokud je stav dotazu ''Zveřejněn - nezodpovězen''
| Lze použít pouze v předloze pro detail dotazu (''detail.php'') nebo ve stylu pro seznam dotazů

|-
| <nowiki></nowiki>
| Vkládá se pokud je stav dotazu ''Nebude zodpovězen''
| Lze použít pouze v předloze pro detail dotazu (''detail.php'') nebo ve stylu pro seznam dotazů, má ale smysl jen ve výpisu dotazů, které nebudou zodpovězeny (''questionlist.php?id=1&noreply=y'')

|-
| <nowiki></nowiki>
| Kód se vloží v případě, že uživatel špatně opsal kontrolní kód pro antispamovou ochranu
| Lze použít v předloze obsahující formulář pro vložení nového dotazu

|-
| <nowiki></nowiki>
| Kód vloží antispamová ochrana v případě, že adresa uživatele vkládajícího dotaz je na seznamu zakázaných adres
| Lze použít v předloze obsahující formulář pro vložení nového dotazu

|-
| <nowiki></nowiki>
| Vloží se pokud byl příspěvek detekován jako spam a nejde o předchozí dva případy.
| Lze použít v předloze obsahující formulář pro vložení nového dotazu
|}

Možné použití podmíněného výpisu informací o stavu dotazu v těle stylu pro seznam dotazů je tedy např.

<code>
<nowiki>")--></nowiki>
<nowiki></nowiki>
</code>

Příklad podpory výpisu hlášení antispamové ochrany (část kódu předlohy pro vkládání nových dotazů je tento:

<code>
<nowiki></nowiki>
<nowiki></nowiki>
<nowiki></nowiki>
</code>

Jsou k dispozici výrazy pro výpis informací o poradně z hlediska přístupových práv:

''<nowiki></nowiki>'' - kód se vloží v případě, že daná poradna má nastavení ''Data jsou přístupná pro čtení'' jiné než ''Nikomu''.

''<nowiki></nowiki>'' - kód se vloží v případě, že daná poradna má nastavení ''Data jsou přístupná pro čtení'' nastaveno na ''Nikomu''.

''<nowiki></nowiki>'' - kód se vloží v případě, že daná poradna má nastavení ''Vkládat data mohou'' jiné než ''Nikdo''.

''<nowiki></nowiki>'' - kód se vloží v případě, že daná poradna má nastavení ''Vkládat data mohou'' nastaveno na ''Nikdo''.

''<nowiki></nowiki>'' - kód se vloží v případě, že daná poradna má nastavení ''Data jsou přístupná pro čtení'' nastaveno na ''Registrovaným''.

''<nowiki></nowiki>'' - kód se vloží v případě, že daná poradna má nastavení ''Vkládat data mohou'' nastaveno na ''Registrovaní''.

Tyto kódy lze použít:

# Ve stránce ''/scripts/modules/advice/default.php'' ve stylu pro seznam poraden
# Ve stránce ''/scripts/modules/advice/fulltxt.php'' ve stylu seznamu nalezených položek (podle toho, do které poradny položka patří)
# Ve všech ostatních stránkách (tj. na úvodní stránce poradny, v seznamu dotazů v poradně, v detailu dotazu) kdekoli.

Pokud chceme např. ve stylu pro seznam poraden vyznačit, která poradna má jaká práva, může tělo stylu vypadat např. následovně:

<code>
<nowiki><h3><a href=""></a></h3></nowiki>
<nowiki></nowiki>
<nowiki><div></nowiki>
<nowiki>Poslední aktualizace: <br /></nowiki>
<nowiki>Zodpovězených dotazů: <br /></nowiki>
<nowiki><br /></nowiki>
<nowiki>
</nowiki>
<nowiki></div></nowiki>
</code>

Možné použití je také např. v předloze pro seznam dotazů pro daný rozhovor, kdy chceme odkaz na vložení dotazu zobrazit, jen pokud je poradna otevřená pro vkládání nových dotazů:

<code>
<nowiki>">Vložit nový dotaz</a>")--></nowiki>
<nowiki></nowiki>
</code>

=== Formulářová pole a další možné parametry skriptů ===

Názvy formulářových polí je třeba přesně dodržet, jinak může být daný formulář nefunkční.

<div class="note">V názvech polí formulářů se '''rozlišují''' malá a velká písmena, zachovejte proto názvy polí vždy přesně tak, jak je příslušný pomocný nástroj vygeneroval nebo jak jsou uvedeny v dokumentaci.</div>

{| class="prettytable"
| colspan="3" | Parametry skriptu firstpage.php pro zobrazení úvodní stránky poradny

|-
| '''Název pole nebo parametru'''
| '''Význam'''
| '''Poznámka'''

|-
| id
| ID poradny
|

|}

{| class="prettytable"
| colspan="3" | Parametry skriptu questionlist.php pro zobrazení seznamu dotazů v poradně

|-
| '''Název pole nebo parametru'''
| '''Význam'''
| '''Poznámka'''

|-
| id
| ID poradny
|

|-
| categid
| ID kategorie
| Pokud je zadáno, vypisují se jen dotazy z dané kategorie

|-
| frequent
| Časté dotazy
| Pro výpis častých dotazů se zadává ''questionlist.php?id=xxx&frequent=y''

|-
| noreply
| Dotazy, které nebudou zodpovězeny
| Pro výpis těchto dotazů se zadává ''questionlist.php?id=1&noreply=y''

|-
| aw
| Filtrace výpisu dotazů na stavy ''Zodpovězen'' resp. ''Zveřejněn - nezodpovězen''
| Možné hodnoty jsou:
''answered'' - seznam vypisuje pouze dotazy ve stavu ''Zodpovězen
published'' - seznam vypisuje pouze dotazy ve stavu ''Zveřejněn - nezodpovězen
''jakákoli jiná hodnota - seznam vypisuje dotazy v obou stavech

|-
| pg
| Číslo stránky v rámci stránkování seznamu dotazů
|

|}

{| class="prettytable"
| colspan="3" | Parametry skriptu detail.php pro zobrazení jednoho dotazu

|-
| '''Název pole nebo parametru'''
| '''Význam'''
| '''Poznámka'''

|-
| id
| ID dotazu
|

|}

{| class="prettytable"
| colspan="3" | Parametry a formulářová pole skriptu newquestion.php pro vložení nového dotazu

|-
| '''Název pole nebo parametru'''
| '''Význam'''
| '''Poznámka'''

|-
| id
| ID poradny
| Doporučujeme použít jako parametr skriptu, tedy např.
<nowiki><form action="/scripts/modules/advice/newquestion.php?id=" method="post"></nowiki>

Je-li zadán ve formě skrytého pole, nefunguje správně detekce formuláře dle atributu id ve skriptu spouštěném během události onsubmit. Tento problém lze obejít detekcí dle atributu name.

|-
| name
| Název dotazu
| V HTML kódu se používá jako
<nowiki><input type="text" name="name" id="name" value="" /></nowiki>, analogicky další uvedená pole formuláře

|-
| firstname
| Křestní jméno
|

|-
| lastname
| Příjmení
|

|-
| nickname
| Přezdívka
|

|-
| email
| E-mail
|

|-
| question
| Text dotazu
|

|-
| private
| Označení dotazu, který nemá být zveřejněn
| Používá se v kódu <nowiki><input type="checkbox" name="private" id="private"  /></nowiki>

|-
| url
| URL stránky, která se má zobrazit po úspěšném vložení dotazu
| Pokud není specifikován, je po uložení uživatel přesměrován na úvodní stránku poradny, do které zadal dotaz

|-
| ccid
| Hodnota skrytého pole pro kontrolní kódy (ochrana proti spamu)
| Používá se v kódu ''<nowiki><input type="hidden" name="ccid" value="" /></nowiki>''

|-
| ccvalue
| Kontrolní kód zadaný uživatelem (ochrana proti spamu)
|
|}

{| class="prettytable"
| colspan="3" | Parametry vyhledávacího skriptu fulltxt.php pro hledání v poradnách

|-
| '''Název pole nebo parametru'''
| '''Význam'''
| '''Poznámka'''

|-
| id
| ID poradny
| Není-li uvedeno, hledá se ve všech poradnách

|-
| searchtext
| Vyhledávaný text
|

|-
| dlid
| ID jazyka
| Je-li uvedeno, hledá se jen v poradnách označených daným jazykem.

|-
| pg
| Číslo stránky v rámci stránkování seznamu nalezených dotazů
|

|}

Kromě výše uvedených parametrů lze u všech skriptů použít parametr ''tmplid'', kterým se vynucuje použití jiné předlohy (hodnotou je ID této předlohy).

WebToDate/Poradny a rozhovory/Tipy a návody

2010-04-08T08:26:02Z

Vitas: V ramci predlohy pro seznam dotazu presunuto WTD_ADVICE(AID) z pole input/hidden do form/action

[[Category:WebToDate Poradny a rozhovory]]
[[Category:Poradny a rozhovory]]
== Druhy výpisů seznamů dotazů ==
Pomocí skriptu ''questionlist.php'' lze zpřístupnit následující druhy výpisů seznamů dotazů:

# seznam všech dotazů v poradně, které jsou označeny jako zodpovězené nebo ''Zveřejněn - nezodpovězen''
# seznam všech dotazů v poradně, které jsou označeny jako ''Zveřejněn - nezodpovězen''
# seznam všech zodpovězených dotazů v poradně
# seznam těch dotazů v poradně, které jsou označeny jako zodpovězené a zároveň příznakem "Častý dotaz"
# seznam těch dotazů, které jsou označeny jako ''Nebude zodpovězen''
# seznam zodpovězených dotazů z dané kategorie

Nejjednodušší nástroj, jak zpřístupnit první tři druhy výpisů je použít např. v předloze pro úvodní stránku poradny následující kód:

<code>
<nowiki><a href="questionlist.php?id=">Všechny dotazy</a> | </nowiki>
<nowiki><a href="questionlist.php?id=&aw=answered">Zodpovězené dotazy</a> | </nowiki>
<nowiki><a href="questionlist.php?id=&aw=published">Dotazy čekající na zodpovězení</a> | </nowiki>
<nowiki><a href="questionlist.php?id=&frequent=y">Nejčastější dotazy</a> | </nowiki>
<nowiki><a href="questionlist.php?id=&noreply=y">Nebude zodpovězeno</a> | </nowiki>
<nowiki><a href="newquestion.php?id=">Nový dotaz</a></nowiki>
</code>

Pro výpis zobrazení obsahu dané kategorie se používá v URL parametr ''categid'', nejjednodušší je použít v předloze výpis seznamu kategorií se stylem

<code>
<nowiki><li><a href=""></a></li></nowiki>
</code>

Tento způsob generuje URL odkazy na výpisy dle kategorií automaticky.

== Předlohy pro e-maily ==
Jednoduchá předloha pro textové e-maily zasílané správci poradny ve chvíli, kdy je vložen nový dotaz z veřejně přístupné části www prezentace vypadá např. takto:

<code>
<nowiki>V poradně je nový dotaz.</nowiki>
<nowiki>ID dotazu: </nowiki>
<nowiki>Název dotazu: </nowiki>
<nowiki>Text dotazu: </nowiki>
<nowiki>Datum vložení dotazu: </nowiki>
</code>

Jednoduchá předloha pro zaslání odpovědi tazateli (opět v textovém e-mailu) vypadá např. takto:

<code>
<nowiki>Váš dotaz v naší poradně byl zodpovězen.</nowiki>
<nowiki>ID dotazu: </nowiki>
<nowiki>Název dotazu: </nowiki>
<nowiki>Text dotazu: </nowiki>
<nowiki>Text odpovědi: </nowiki>
<nowiki>Zodpovězeno dne: </nowiki>
</code>

== Příprava rozhovorů s osobností ==
=== Jednoduchá implementace ===

Jednoduchá implementace poradny v režimu rozhovoru s osobností vystačí s nastavením dvou typů stránek v předpisu – seznamu dotazů a stránky pro vkládání nového dotazu.

Jednoduchý styl pro seznam dotazů je např.

'''Hlavička'''

<code>
<nowiki><table cellpadding="6" class="rozhovor"></nowiki>
</code>

'''Tělo'''

<code>
<nowiki><tr><td colspan="2" bgcolor="#efefef"><strong></strong>   </td></tr></nowiki>
<nowiki><tr><td>Otázka</td><td></td></tr></nowiki>
<nowiki><tr><td>Odpověď</td><td></td></tr></nowiki>
</code>

'''Patička'''

<code>
<nowiki></table></nowiki>
</code>

Stránka s rozhovorem pak vypadá zhruba tak, jak je vidět na následujícím otisku obrazovky.

[[Image:poradnyarozhovory-tipyanavody-img029.png|center]]

Ve stránce pro vkládání nových dotazů je pak často žádoucí minimalizovat počet vstupních polí, nejlépe na přezdívku a text otázky. HTML kód v předloze pro vkládání dotazů pak může vypadat např. takto:

<code>
<nowiki><h3>Nová otázka do rozhovoru ""</h3></nowiki>
<nowiki><form name="formular" id="formular" action="/scripts/modules/advice/newquestion.php?id=" method="post"></nowiki>
<nowiki></nowiki>
<nowiki><input type="hidden" name="url" id="url" value="firstpage.php?id=" /></nowiki>
<nowiki></nowiki>
<nowiki><input type="hidden" name="name" id="name" value="Dotaz v chatu " size="60" /></nowiki>
<nowiki></nowiki>
<nowiki><table class="descr_large"></nowiki>
<nowiki><tr> </nowiki>
<nowiki> <td align=right></nowiki>
<nowiki> <label for="nickname">Vaše přezdívka</label></nowiki>
<nowiki> </td></nowiki>
<nowiki> <td></nowiki>
<nowiki> <input type="text" name="nickname" id="nickname" value="" size="30" /></nowiki>
<nowiki> </td></nowiki>
<nowiki></tr></nowiki>
<nowiki><tr> </nowiki>
<nowiki> <td align=right></nowiki>
<nowiki> <label for="question">Otázka</label></nowiki>
<nowiki> </td></nowiki>
<nowiki> <td></nowiki>
<nowiki> <textarea cols="40" rows="12" name="question"></textarea></nowiki>
<nowiki> </td></nowiki>
<nowiki></tr></nowiki>
<nowiki><tr></nowiki>
<nowiki> <td align="right" colspan="2"></nowiki>
<nowiki> <input type="submit" name="send" id="send" value="Odeslat" /></nowiki>
<nowiki> </td></nowiki>
<nowiki></tr></nowiki>
<nowiki></table></nowiki>
<nowiki></form></nowiki>
</code>

Pomocí ''hidden'' pole se zde vyplňuje název dotazu, uživatel zadává jen svoji přezdívku a text dotazu. Do ''hidden'' pole ''url'' formuláře je dále vhodné zadat adresu např. staticky vygenerované stránky informující o uložení dotazu, nebo naopak přesměrovat uživatele na stránku se seznamem dotazů.

=== Rozhovor ve více stavech ===

Možný požadavek na nasazení modulu v režimu rozhovorů může být složitější, např.:

# Nejprve je rozhovor v režimu připravovaného rozhovoru - uživatelé již mohou klást dotazy, ale ještě je nikdo nezodpovídá; lze přitom v prezentační části zobrazit seznam již položených (a redakcí schválených) dotazů, aby se nepokládaly duplicitní dotazy.
# Ve chvíli, kdy se do redakce dostaví osoba, se kterou se vede rozhovor, je rozhovor v režimu probíhajícího rozhovoru - uživatelé kladou dotazy a člověk, se kterým je chat vede, je zodpovídá. Zobrazuje se seznam dotazů i formulář pro vkládání.
# Po ukončení rozhovoru je možné prohlížet seznam zodpovězených dotazů, ale není již samozřejmě možné vkládat dotazy - zobrazuje se jen seznam dotazů bez formuláře pro vkládání.

To lze realizovat následovně:

* Vytvoří se tři předpisy modulu - předpis pro připravovaný rozhovor, probíhající rozhovor a uzavřený rozhovor
* V průběhu "životnosti" rozhovoru se vybere v různých etapách různý předpis a mění se nastavení ''Data jsou přístupná pro čtení'' resp. ''Vkládat data mohou''.

[[Image:poradnyarozhovory-tipyanavody-img030.png|center]]

Postup je tedy zhruba následující:

# Založí se poradna pro daný rozhovor, zvolí se předpis pro připravovaný rozhovor a nastaví se volby ''Data jsou přístupná pro čtení:všem'' a ''Vkládat data mohou:všichni''. V této etapě uživatelé vkládají dotazy, které bude předmětná osoba zodpovídat, mohou se podívat na dotazy, které již byly vloženy a redakce je dala do stavu ''Zveřejněn - nezodpovězen''.
# Ve chvíli, kdy se předmětná osoba dostaví do redakce, změní se předpis na předpis pro probíhající rozhovor. Uživatelé mohou vkládat nové dotazy, tyto nové dotazy i dotazy již položené v předchozí etapě jsou průběžně zodpovídány.
# Ve chvíli, kdy již není žádoucí, aby uživatelé vkládali nové dotazy, ale již vložené dotazy se ještě zodpovídají, změní se nastavení ''Vkládat data mohou'' na ''Nikdo''.
# Ve chvíli, kdy již byly zodpovězeny všechny relevantní dotazy, a rozhovor je ukončen, změní se předpis poradny na předpis pro uzavřený rozhovor.

Tento postup lze realizovat pomocí následujících ukázkových kódů, používá se předloha pro seznam dotazů, která zároveň obsahuje i vstupní formulář pro vkládání dotazů. K těmto kódům je ještě navíc třeba vytvořit standardním způsobem jednu předlohu pro nový dotaz, která je ve všech etapách stejná.

Předloha pro seznam dotazů - připravovaný rozhovor může vypadat následovně:

<code>
<nowiki><h1></h1></nowiki>
<nowiki><div></nowiki>
<nowiki></nowiki>
<nowiki>" method="post"></nowiki>
<nowiki><div></nowiki>
<nowiki><input type="hidden" name="url" id="url" value="questionlist.php?id=&vlozeno=1" /></nowiki>
<nowiki><input type="hidden" name="vlozeno" id="vlozeno" value="1" /></nowiki>
<nowiki></div></nowiki>
<nowiki><h2>Váš dotaz</h2></nowiki>
<nowiki><table></nowiki>
<nowiki><tbody><tr></nowiki>
<nowiki><th><label for="formfield01">Jméno:</label></th></nowiki>
<nowiki><td><input type="text" name="nickname" id="formfield01" value="" /></td></nowiki>
<nowiki></tr></nowiki>
<nowiki><tr></nowiki>
<nowiki><th><label for="formfield02">Dotaz:</label></th></nowiki>
<nowiki><td><textarea id="formfield02" cols="40" rows="6" name="question"></textarea></nowiki>
<nowiki><input type="hidden" name="question_required" id="question_required" value="1" /></td></nowiki>
<nowiki></tr></nowiki>
<nowiki></tbody></table></nowiki>
<nowiki><p><input value="Odeslat" name="send" type="submit" /></p></nowiki>
<nowiki></form></nowiki>
<nowiki> </nowiki>
<nowiki></nowiki>
<nowiki>")--></nowiki>
<nowiki></div></nowiki>
<nowiki><div></nowiki>
<nowiki><p>Rozhovor ještě neproběhl.</p></nowiki>
<nowiki></nowiki>
<nowiki></div></nowiki>
</code>

Styl pro seznam dotazů v připravovaném rozhovoru může vypadat následovně:

'''Hlavička'''

<code>
<nowiki><h2>Otázky a odpovědi</h2></nowiki>
<nowiki><dl></nowiki>
</code>

'''Tělo'''

<code>
<nowiki>, , <br /></dt><dd> </dd>")--></nowiki>
</code>

'''Patička'''

<code>
<nowiki></dl></nowiki>
</code>

Předloha pro seznam dotazů - probíhající rozhovor může vypadat následovně:

<code>
<nowiki><h1></h1></nowiki>
<nowiki><div></nowiki>
<nowiki></nowiki>
<nowiki>" method="post"></nowiki>
<nowiki><div><input type="hidden" name="lid" id="lid" value="" /></nowiki>
<nowiki><input type="hidden" name="url" id="url" value="questionlist.php?id=&vlozeno=1" /></nowiki>
<nowiki><input type="hidden" name="vlozeno" id="vlozeno" value="1" /></nowiki>
<nowiki></div></nowiki>
<nowiki><h2>Váš dotaz</h2></nowiki>
<nowiki><table></nowiki>
<nowiki><tbody><tr></nowiki>
<nowiki><th><label for="formfield01">Jméno:</label></th></nowiki>
<nowiki><td><input type="text" name="nickname" id="formfield01" value="" /></td></nowiki>
<nowiki></tr></nowiki>
<nowiki><tr></nowiki>
<nowiki><th><label for="formfield02">Dotaz:</label></th></nowiki>
<nowiki><td><textarea id="formfield02" cols="40" rows="6" name="question"></textarea></nowiki>
<nowiki><input type="hidden" name="question_required" id="question_required" value="1" /></td></nowiki>
<nowiki></tr></nowiki>
<nowiki></tbody></table></nowiki>
<nowiki><p><input value="Odeslat" name="send" type="submit" /></p></nowiki>
<nowiki></form></nowiki>
<nowiki>")--></nowiki>
<nowiki> </nowiki>
<nowiki></nowiki>
<nowiki></div></nowiki>
<nowiki><div></nowiki>
<nowiki><p>Rozhovor právě probíhá.</p></nowiki>
<nowiki></nowiki>
<nowiki></nowiki>
<nowiki></div></nowiki>
</code>

Styl pro seznam dotazů v probíhajícím rozhovoru může vypadat následovně:

'''Hlavička'''

<code>
<nowiki><h2>Otázky a odpovědi</h2></nowiki>
<nowiki><dl></nowiki>
</code>

'''Tělo'''

<code>
<nowiki><dt>, , <br /></nowiki>
<nowiki></dt></nowiki>
<nowiki><dd>, <br />")--></nowiki>
<nowiki></dd></nowiki>
</code>

'''Patička'''

<code>
<nowiki></dl></nowiki>
</code>

Předloha pro seznam dotazů - uzavřený rozhovor může vypadat následovně:

<code>
<nowiki><h1></h1></nowiki>
<nowiki><div></nowiki>
<nowiki></nowiki>
<nowiki> </nowiki>
<nowiki></nowiki>
<nowiki></div></nowiki>
<nowiki><div><p>Rozhovor je ukončen.</p></div></nowiki>
</code>

Styl pro seznam dotazů v uzavřeném rozhovoru lze použít stejný jako pro probíhající rozhovor.

WebToDate/Poradny a rozhovory/Tipy a návody

2010-04-08T08:19:24Z

Vitas: /* Rozhovor ve více stavech */

[[Category:WebToDate Poradny a rozhovory]]
[[Category:Poradny a rozhovory]]
== Druhy výpisů seznamů dotazů ==
Pomocí skriptu ''questionlist.php'' lze zpřístupnit následující druhy výpisů seznamů dotazů:

# seznam všech dotazů v poradně, které jsou označeny jako zodpovězené nebo ''Zveřejněn - nezodpovězen''
# seznam všech dotazů v poradně, které jsou označeny jako ''Zveřejněn - nezodpovězen''
# seznam všech zodpovězených dotazů v poradně
# seznam těch dotazů v poradně, které jsou označeny jako zodpovězené a zároveň příznakem "Častý dotaz"
# seznam těch dotazů, které jsou označeny jako ''Nebude zodpovězen''
# seznam zodpovězených dotazů z dané kategorie

Nejjednodušší nástroj, jak zpřístupnit první tři druhy výpisů je použít např. v předloze pro úvodní stránku poradny následující kód:

<code>
<nowiki><a href="questionlist.php?id=">Všechny dotazy</a> | </nowiki>
<nowiki><a href="questionlist.php?id=&aw=answered">Zodpovězené dotazy</a> | </nowiki>
<nowiki><a href="questionlist.php?id=&aw=published">Dotazy čekající na zodpovězení</a> | </nowiki>
<nowiki><a href="questionlist.php?id=&frequent=y">Nejčastější dotazy</a> | </nowiki>
<nowiki><a href="questionlist.php?id=&noreply=y">Nebude zodpovězeno</a> | </nowiki>
<nowiki><a href="newquestion.php?id=">Nový dotaz</a></nowiki>
</code>

Pro výpis zobrazení obsahu dané kategorie se používá v URL parametr ''categid'', nejjednodušší je použít v předloze výpis seznamu kategorií se stylem

<code>
<nowiki><li><a href=""></a></li></nowiki>
</code>

Tento způsob generuje URL odkazy na výpisy dle kategorií automaticky.

== Předlohy pro e-maily ==
Jednoduchá předloha pro textové e-maily zasílané správci poradny ve chvíli, kdy je vložen nový dotaz z veřejně přístupné části www prezentace vypadá např. takto:

<code>
<nowiki>V poradně je nový dotaz.</nowiki>
<nowiki>ID dotazu: </nowiki>
<nowiki>Název dotazu: </nowiki>
<nowiki>Text dotazu: </nowiki>
<nowiki>Datum vložení dotazu: </nowiki>
</code>

Jednoduchá předloha pro zaslání odpovědi tazateli (opět v textovém e-mailu) vypadá např. takto:

<code>
<nowiki>Váš dotaz v naší poradně byl zodpovězen.</nowiki>
<nowiki>ID dotazu: </nowiki>
<nowiki>Název dotazu: </nowiki>
<nowiki>Text dotazu: </nowiki>
<nowiki>Text odpovědi: </nowiki>
<nowiki>Zodpovězeno dne: </nowiki>
</code>

== Příprava rozhovorů s osobností ==
=== Jednoduchá implementace ===

Jednoduchá implementace poradny v režimu rozhovoru s osobností vystačí s nastavením dvou typů stránek v předpisu – seznamu dotazů a stránky pro vkládání nového dotazu.

Jednoduchý styl pro seznam dotazů je např.

'''Hlavička'''

<code>
<nowiki><table cellpadding="6" class="rozhovor"></nowiki>
</code>

'''Tělo'''

<code>
<nowiki><tr><td colspan="2" bgcolor="#efefef"><strong></strong>   </td></tr></nowiki>
<nowiki><tr><td>Otázka</td><td></td></tr></nowiki>
<nowiki><tr><td>Odpověď</td><td></td></tr></nowiki>
</code>

'''Patička'''

<code>
<nowiki></table></nowiki>
</code>

Stránka s rozhovorem pak vypadá zhruba tak, jak je vidět na následujícím otisku obrazovky.

[[Image:poradnyarozhovory-tipyanavody-img029.png|center]]

Ve stránce pro vkládání nových dotazů je pak často žádoucí minimalizovat počet vstupních polí, nejlépe na přezdívku a text otázky. HTML kód v předloze pro vkládání dotazů pak může vypadat např. takto:

<code>
<nowiki><h3>Nová otázka do rozhovoru ""</h3></nowiki>
<nowiki><form name="formular" id="formular" action="/scripts/modules/advice/newquestion.php?id=" method="post"></nowiki>
<nowiki></nowiki>
<nowiki><input type="hidden" name="url" id="url" value="firstpage.php?id=" /></nowiki>
<nowiki></nowiki>
<nowiki><input type="hidden" name="name" id="name" value="Dotaz v chatu " size="60" /></nowiki>
<nowiki></nowiki>
<nowiki><table class="descr_large"></nowiki>
<nowiki><tr> </nowiki>
<nowiki> <td align=right></nowiki>
<nowiki> <label for="nickname">Vaše přezdívka</label></nowiki>
<nowiki> </td></nowiki>
<nowiki> <td></nowiki>
<nowiki> <input type="text" name="nickname" id="nickname" value="" size="30" /></nowiki>
<nowiki> </td></nowiki>
<nowiki></tr></nowiki>
<nowiki><tr> </nowiki>
<nowiki> <td align=right></nowiki>
<nowiki> <label for="question">Otázka</label></nowiki>
<nowiki> </td></nowiki>
<nowiki> <td></nowiki>
<nowiki> <textarea cols="40" rows="12" name="question"></textarea></nowiki>
<nowiki> </td></nowiki>
<nowiki></tr></nowiki>
<nowiki><tr></nowiki>
<nowiki> <td align="right" colspan="2"></nowiki>
<nowiki> <input type="submit" name="send" id="send" value="Odeslat" /></nowiki>
<nowiki> </td></nowiki>
<nowiki></tr></nowiki>
<nowiki></table></nowiki>
<nowiki></form></nowiki>
</code>

Pomocí ''hidden'' pole se zde vyplňuje název dotazu, uživatel zadává jen svoji přezdívku a text dotazu. Do ''hidden'' pole ''url'' formuláře je dále vhodné zadat adresu např. staticky vygenerované stránky informující o uložení dotazu, nebo naopak přesměrovat uživatele na stránku se seznamem dotazů.

=== Rozhovor ve více stavech ===

Možný požadavek na nasazení modulu v režimu rozhovorů může být složitější, např.:

# Nejprve je rozhovor v režimu připravovaného rozhovoru - uživatelé již mohou klást dotazy, ale ještě je nikdo nezodpovídá; lze přitom v prezentační části zobrazit seznam již položených (a redakcí schválených) dotazů, aby se nepokládaly duplicitní dotazy.
# Ve chvíli, kdy se do redakce dostaví osoba, se kterou se vede rozhovor, je rozhovor v režimu probíhajícího rozhovoru - uživatelé kladou dotazy a člověk, se kterým je chat vede, je zodpovídá. Zobrazuje se seznam dotazů i formulář pro vkládání.
# Po ukončení rozhovoru je možné prohlížet seznam zodpovězených dotazů, ale není již samozřejmě možné vkládat dotazy - zobrazuje se jen seznam dotazů bez formuláře pro vkládání.

To lze realizovat následovně:

* Vytvoří se tři předpisy modulu - předpis pro připravovaný rozhovor, probíhající rozhovor a uzavřený rozhovor
* V průběhu "životnosti" rozhovoru se vybere v různých etapách různý předpis a mění se nastavení ''Data jsou přístupná pro čtení'' resp. ''Vkládat data mohou''.

[[Image:poradnyarozhovory-tipyanavody-img030.png|center]]

Postup je tedy zhruba následující:

# Založí se poradna pro daný rozhovor, zvolí se předpis pro připravovaný rozhovor a nastaví se volby ''Data jsou přístupná pro čtení:všem'' a ''Vkládat data mohou:všichni''. V této etapě uživatelé vkládají dotazy, které bude předmětná osoba zodpovídat, mohou se podívat na dotazy, které již byly vloženy a redakce je dala do stavu ''Zveřejněn - nezodpovězen''.
# Ve chvíli, kdy se předmětná osoba dostaví do redakce, změní se předpis na předpis pro probíhající rozhovor. Uživatelé mohou vkládat nové dotazy, tyto nové dotazy i dotazy již položené v předchozí etapě jsou průběžně zodpovídány.
# Ve chvíli, kdy již není žádoucí, aby uživatelé vkládali nové dotazy, ale již vložené dotazy se ještě zodpovídají, změní se nastavení ''Vkládat data mohou'' na ''Nikdo''.
# Ve chvíli, kdy již byly zodpovězeny všechny relevantní dotazy, a rozhovor je ukončen, změní se předpis poradny na předpis pro uzavřený rozhovor.

Tento postup lze realizovat pomocí následujících ukázkových kódů, používá se předloha pro seznam dotazů, která zároveň obsahuje i vstupní formulář pro vkládání dotazů. K těmto kódům je ještě navíc třeba vytvořit standardním způsobem jednu předlohu pro nový dotaz, která je ve všech etapách stejná.

Předloha pro seznam dotazů - připravovaný rozhovor může vypadat následovně:

<code>
<nowiki><h1></h1></nowiki>
<nowiki><div></nowiki>
<nowiki></nowiki>
<nowiki>" method="post"></nowiki>
<nowiki><div></nowiki>
<nowiki><input type="hidden" name="url" id="url" value="questionlist.php?id=&vlozeno=1" /></nowiki>
<nowiki><input type="hidden" name="vlozeno" id="vlozeno" value="1" /></nowiki>
<nowiki></div></nowiki>
<nowiki><h2>Váš dotaz</h2></nowiki>
<nowiki><table></nowiki>
<nowiki><tbody><tr></nowiki>
<nowiki><th><label for="formfield01">Jméno:</label></th></nowiki>
<nowiki><td><input type="text" name="nickname" id="formfield01" value="" /></td></nowiki>
<nowiki></tr></nowiki>
<nowiki><tr></nowiki>
<nowiki><th><label for="formfield02">Dotaz:</label></th></nowiki>
<nowiki><td><textarea id="formfield02" cols="40" rows="6" name="question"></textarea></nowiki>
<nowiki><input type="hidden" name="question_required" id="question_required" value="1" /></td></nowiki>
<nowiki></tr></nowiki>
<nowiki></tbody></table></nowiki>
<nowiki><p><input value="Odeslat" name="send" type="submit" /></p></nowiki>
<nowiki></form></nowiki>
<nowiki> </nowiki>
<nowiki></nowiki>
<nowiki>")--></nowiki>
<nowiki></div></nowiki>
<nowiki><div></nowiki>
<nowiki><p>Rozhovor ještě neproběhl.</p></nowiki>
<nowiki></nowiki>
<nowiki></div></nowiki>
</code>

Styl pro seznam dotazů v připravovaném rozhovoru může vypadat následovně:

'''Hlavička'''

<code>
<nowiki><h2>Otázky a odpovědi</h2></nowiki>
<nowiki><dl></nowiki>
</code>

'''Tělo'''

<code>
<nowiki>, , <br /></dt><dd> </dd>")--></nowiki>
</code>

'''Patička'''

<code>
<nowiki></dl></nowiki>
</code>

Předloha pro seznam dotazů - probíhající rozhovor může vypadat následovně:

<code>
<nowiki><h1></h1></nowiki>
<nowiki><div></nowiki>
<nowiki></nowiki>
<nowiki>" /></nowiki>
<nowiki><input type="hidden" name="url" id="url" value="questionlist.php?id=&vlozeno=1" /></nowiki>
<nowiki><input type="hidden" name="vlozeno" id="vlozeno" value="1" /></nowiki>
<nowiki><input type="hidden" name="id" id="id" value="" /></div></nowiki>
<nowiki><h2>Váš dotaz</h2></nowiki>
<nowiki><table></nowiki>
<nowiki><tbody><tr></nowiki>
<nowiki><th><label for="formfield01">Jméno:</label></th></nowiki>
<nowiki><td><input type="text" name="nickname" id="formfield01" value="" /></td></nowiki>
<nowiki></tr></nowiki>
<nowiki><tr></nowiki>
<nowiki><th><label for="formfield02">Dotaz:</label></th></nowiki>
<nowiki><td><textarea id="formfield02" cols="40" rows="6" name="question"></textarea></nowiki>
<nowiki><input type="hidden" name="question_required" id="question_required" value="1" /></td></nowiki>
<nowiki></tr></nowiki>
<nowiki></tbody></table></nowiki>
<nowiki><p><input value="Odeslat" name="send" type="submit" /></p></nowiki>
<nowiki></form></nowiki>
<nowiki>")--></nowiki>
<nowiki> </nowiki>
<nowiki></nowiki>
<nowiki></div></nowiki>
<nowiki><div></nowiki>
<nowiki><p>Rozhovor právě probíhá.</p></nowiki>
<nowiki></nowiki>
<nowiki></nowiki>
<nowiki></div></nowiki>
</code>

Styl pro seznam dotazů v probíhajícím rozhovoru může vypadat následovně:

'''Hlavička'''

<code>
<nowiki><h2>Otázky a odpovědi</h2></nowiki>
<nowiki><dl></nowiki>
</code>

'''Tělo'''

<code>
<nowiki><dt>, , <br /></nowiki>
<nowiki></dt></nowiki>
<nowiki><dd>, <br />")--></nowiki>
<nowiki></dd></nowiki>
</code>

'''Patička'''

<code>
<nowiki></dl></nowiki>
</code>

Předloha pro seznam dotazů - uzavřený rozhovor může vypadat následovně:

<code>
<nowiki><h1></h1></nowiki>
<nowiki><div></nowiki>
<nowiki></nowiki>
<nowiki> </nowiki>
<nowiki></nowiki>
<nowiki></div></nowiki>
<nowiki><div><p>Rozhovor je ukončen.</p></div></nowiki>
</code>

Styl pro seznam dotazů v uzavřeném rozhovoru lze použít stejný jako pro probíhající rozhovor.

WebToDate/Poradny a rozhovory/Tipy a návody

2010-04-08T07:56:58Z

Vitas: /* Jednoduchá implementace */

[[Category:WebToDate Poradny a rozhovory]]
[[Category:Poradny a rozhovory]]
== Druhy výpisů seznamů dotazů ==
Pomocí skriptu ''questionlist.php'' lze zpřístupnit následující druhy výpisů seznamů dotazů:

# seznam všech dotazů v poradně, které jsou označeny jako zodpovězené nebo ''Zveřejněn - nezodpovězen''
# seznam všech dotazů v poradně, které jsou označeny jako ''Zveřejněn - nezodpovězen''
# seznam všech zodpovězených dotazů v poradně
# seznam těch dotazů v poradně, které jsou označeny jako zodpovězené a zároveň příznakem "Častý dotaz"
# seznam těch dotazů, které jsou označeny jako ''Nebude zodpovězen''
# seznam zodpovězených dotazů z dané kategorie

Nejjednodušší nástroj, jak zpřístupnit první tři druhy výpisů je použít např. v předloze pro úvodní stránku poradny následující kód:

<code>
<nowiki><a href="questionlist.php?id=">Všechny dotazy</a> | </nowiki>
<nowiki><a href="questionlist.php?id=&aw=answered">Zodpovězené dotazy</a> | </nowiki>
<nowiki><a href="questionlist.php?id=&aw=published">Dotazy čekající na zodpovězení</a> | </nowiki>
<nowiki><a href="questionlist.php?id=&frequent=y">Nejčastější dotazy</a> | </nowiki>
<nowiki><a href="questionlist.php?id=&noreply=y">Nebude zodpovězeno</a> | </nowiki>
<nowiki><a href="newquestion.php?id=">Nový dotaz</a></nowiki>
</code>

Pro výpis zobrazení obsahu dané kategorie se používá v URL parametr ''categid'', nejjednodušší je použít v předloze výpis seznamu kategorií se stylem

<code>
<nowiki><li><a href=""></a></li></nowiki>
</code>

Tento způsob generuje URL odkazy na výpisy dle kategorií automaticky.

== Předlohy pro e-maily ==
Jednoduchá předloha pro textové e-maily zasílané správci poradny ve chvíli, kdy je vložen nový dotaz z veřejně přístupné části www prezentace vypadá např. takto:

<code>
<nowiki>V poradně je nový dotaz.</nowiki>
<nowiki>ID dotazu: </nowiki>
<nowiki>Název dotazu: </nowiki>
<nowiki>Text dotazu: </nowiki>
<nowiki>Datum vložení dotazu: </nowiki>
</code>

Jednoduchá předloha pro zaslání odpovědi tazateli (opět v textovém e-mailu) vypadá např. takto:

<code>
<nowiki>Váš dotaz v naší poradně byl zodpovězen.</nowiki>
<nowiki>ID dotazu: </nowiki>
<nowiki>Název dotazu: </nowiki>
<nowiki>Text dotazu: </nowiki>
<nowiki>Text odpovědi: </nowiki>
<nowiki>Zodpovězeno dne: </nowiki>
</code>

== Příprava rozhovorů s osobností ==
=== Jednoduchá implementace ===

Jednoduchá implementace poradny v režimu rozhovoru s osobností vystačí s nastavením dvou typů stránek v předpisu – seznamu dotazů a stránky pro vkládání nového dotazu.

Jednoduchý styl pro seznam dotazů je např.

'''Hlavička'''

<code>
<nowiki><table cellpadding="6" class="rozhovor"></nowiki>
</code>

'''Tělo'''

<code>
<nowiki><tr><td colspan="2" bgcolor="#efefef"><strong></strong>   </td></tr></nowiki>
<nowiki><tr><td>Otázka</td><td></td></tr></nowiki>
<nowiki><tr><td>Odpověď</td><td></td></tr></nowiki>
</code>

'''Patička'''

<code>
<nowiki></table></nowiki>
</code>

Stránka s rozhovorem pak vypadá zhruba tak, jak je vidět na následujícím otisku obrazovky.

[[Image:poradnyarozhovory-tipyanavody-img029.png|center]]

Ve stránce pro vkládání nových dotazů je pak často žádoucí minimalizovat počet vstupních polí, nejlépe na přezdívku a text otázky. HTML kód v předloze pro vkládání dotazů pak může vypadat např. takto:

<code>
<nowiki><h3>Nová otázka do rozhovoru ""</h3></nowiki>
<nowiki><form name="formular" id="formular" action="/scripts/modules/advice/newquestion.php?id=" method="post"></nowiki>
<nowiki></nowiki>
<nowiki><input type="hidden" name="url" id="url" value="firstpage.php?id=" /></nowiki>
<nowiki></nowiki>
<nowiki><input type="hidden" name="name" id="name" value="Dotaz v chatu " size="60" /></nowiki>
<nowiki></nowiki>
<nowiki><table class="descr_large"></nowiki>
<nowiki><tr> </nowiki>
<nowiki> <td align=right></nowiki>
<nowiki> <label for="nickname">Vaše přezdívka</label></nowiki>
<nowiki> </td></nowiki>
<nowiki> <td></nowiki>
<nowiki> <input type="text" name="nickname" id="nickname" value="" size="30" /></nowiki>
<nowiki> </td></nowiki>
<nowiki></tr></nowiki>
<nowiki><tr> </nowiki>
<nowiki> <td align=right></nowiki>
<nowiki> <label for="question">Otázka</label></nowiki>
<nowiki> </td></nowiki>
<nowiki> <td></nowiki>
<nowiki> <textarea cols="40" rows="12" name="question"></textarea></nowiki>
<nowiki> </td></nowiki>
<nowiki></tr></nowiki>
<nowiki><tr></nowiki>
<nowiki> <td align="right" colspan="2"></nowiki>
<nowiki> <input type="submit" name="send" id="send" value="Odeslat" /></nowiki>
<nowiki> </td></nowiki>
<nowiki></tr></nowiki>
<nowiki></table></nowiki>
<nowiki></form></nowiki>
</code>

Pomocí ''hidden'' pole se zde vyplňuje název dotazu, uživatel zadává jen svoji přezdívku a text dotazu. Do ''hidden'' pole ''url'' formuláře je dále vhodné zadat adresu např. staticky vygenerované stránky informující o uložení dotazu, nebo naopak přesměrovat uživatele na stránku se seznamem dotazů.

=== Rozhovor ve více stavech ===

Možný požadavek na nasazení modulu v režimu rozhovorů může být složitější, např.:

# Nejprve je rozhovor v režimu připravovaného rozhovoru - uživatelé již mohou klást dotazy, ale ještě je nikdo nezodpovídá; lze přitom v prezentační části zobrazit seznam již položených (a redakcí schválených) dotazů, aby se nepokládaly duplicitní dotazy.
# Ve chvíli, kdy se do redakce dostaví osoba, se kterou se vede rozhovor, je rozhovor v režimu probíhajícího rozhovoru - uživatelé kladou dotazy a člověk, se kterým je chat vede, je zodpovídá. Zobrazuje se seznam dotazů i formulář pro vkládání.
# Po ukončení rozhovoru je možné prohlížet seznam zodpovězených dotazů, ale není již samozřejmě možné vkládat dotazy - zobrazuje se jen seznam dotazů bez formuláře pro vkládání.

To lze realizovat následovně:

* Vytvoří se tři předpisy modulu - předpis pro připravovaný rozhovor, probíhající rozhovor a uzavřený rozhovor
* V průběhu "životnosti" rozhovoru se vybere v různých etapách různý předpis a mění se nastavení ''Data jsou přístupná pro čtení'' resp. ''Vkládat data mohou''.

[[Image:poradnyarozhovory-tipyanavody-img030.png|center]]

Postup je tedy zhruba následující:

# Založí se poradna pro daný rozhovor, zvolí se předpis pro připravovaný rozhovor a nastaví se volby ''Data jsou přístupná pro čtení:všem'' a ''Vkládat data mohou:všichni''. V této etapě uživatelé vkládají dotazy, které bude předmětná osoba zodpovídat, mohou se podívat na dotazy, které již byly vloženy a redakce je dala do stavu ''Zveřejněn - nezodpovězen''.
# Ve chvíli, kdy se předmětná osoba dostaví do redakce, změní se předpis na předpis pro probíhající rozhovor. Uživatelé mohou vkládat nové dotazy, tyto nové dotazy i dotazy již položené v předchozí etapě jsou průběžně zodpovídány.
# Ve chvíli, kdy již není žádoucí, aby uživatelé vkládali nové dotazy, ale již vložené dotazy se ještě zodpovídají, změní se nastavení ''Vkládat data mohou'' na ''Nikdo''.
# Ve chvíli, kdy již byly zodpovězeny všechny relevantní dotazy, a rozhovor je ukončen, změní se předpis poradny na předpis pro uzavřený rozhovor.

Tento postup lze realizovat pomocí následujících ukázkových kódů, používá se předloha pro seznam dotazů, která zároveň obsahuje i vstupní formulář pro vkládání dotazů. K těmto kódům je ještě navíc třeba vytvořit standardním způsobem jednu předlohu pro nový dotaz, která je ve všech etapách stejná.

Předloha pro seznam dotazů - připravovaný rozhovor může vypadat následovně:

<code>
<nowiki><h1></h1></nowiki>
<nowiki><div></nowiki>
<nowiki></nowiki>
<nowiki>&vlozeno=1" /></nowiki>
<nowiki><input type="hidden" name="vlozeno" id="vlozeno" value="1" /></nowiki>
<nowiki><input type="hidden" name="id" id="id" value="" /></div></nowiki>
<nowiki><h2>Váš dotaz</h2></nowiki>
<nowiki><table></nowiki>
<nowiki><tbody><tr></nowiki>
<nowiki><th><label for="formfield01">Jméno:</label></th></nowiki>
<nowiki><td><input type="text" name="nickname" id="formfield01" value="" /></td></nowiki>
<nowiki></tr></nowiki>
<nowiki><tr></nowiki>
<nowiki><th><label for="formfield02">Dotaz:</label></th></nowiki>
<nowiki><td><textarea id="formfield02" cols="40" rows="6" name="question"></textarea></nowiki>
<nowiki><input type="hidden" name="question_required" id="question_required" value="1" /></td></nowiki>
<nowiki></tr></nowiki>
<nowiki></tbody></table></nowiki>
<nowiki><p><input value="Odeslat" name="send" type="submit" /></p></nowiki>
<nowiki></form></nowiki>
<nowiki> </nowiki>
<nowiki></nowiki>
<nowiki>")--></nowiki>
<nowiki></div></nowiki>
<nowiki><div></nowiki>
<nowiki><p>Rozhovor ještě neproběhl.</p></nowiki>
<nowiki></nowiki>
<nowiki></div></nowiki>
</code>

Styl pro seznam dotazů v připravovaném rozhovoru může vypadat následovně:

'''Hlavička'''

<code>
<nowiki><h2>Otázky a odpovědi</h2></nowiki>
<nowiki><dl></nowiki>
</code>

'''Tělo'''

<code>
<nowiki>, , <br /></dt><dd> </dd>")--></nowiki>
</code>

'''Patička'''

<code>
<nowiki></dl></nowiki>
</code>

Předloha pro seznam dotazů - probíhající rozhovor může vypadat následovně:

<code>
<nowiki><h1></h1></nowiki>
<nowiki><div></nowiki>
<nowiki></nowiki>
<nowiki>" /></nowiki>
<nowiki><input type="hidden" name="url" id="url" value="questionlist.php?id=&vlozeno=1" /></nowiki>
<nowiki><input type="hidden" name="vlozeno" id="vlozeno" value="1" /></nowiki>
<nowiki><input type="hidden" name="id" id="id" value="" /></div></nowiki>
<nowiki><h2>Váš dotaz</h2></nowiki>
<nowiki><table></nowiki>
<nowiki><tbody><tr></nowiki>
<nowiki><th><label for="formfield01">Jméno:</label></th></nowiki>
<nowiki><td><input type="text" name="nickname" id="formfield01" value="" /></td></nowiki>
<nowiki></tr></nowiki>
<nowiki><tr></nowiki>
<nowiki><th><label for="formfield02">Dotaz:</label></th></nowiki>
<nowiki><td><textarea id="formfield02" cols="40" rows="6" name="question"></textarea></nowiki>
<nowiki><input type="hidden" name="question_required" id="question_required" value="1" /></td></nowiki>
<nowiki></tr></nowiki>
<nowiki></tbody></table></nowiki>
<nowiki><p><input value="Odeslat" name="send" type="submit" /></p></nowiki>
<nowiki></form></nowiki>
<nowiki>")--></nowiki>
<nowiki> </nowiki>
<nowiki></nowiki>
<nowiki></div></nowiki>
<nowiki><div></nowiki>
<nowiki><p>Rozhovor právě probíhá.</p></nowiki>
<nowiki></nowiki>
<nowiki></nowiki>
<nowiki></div></nowiki>
</code>

Styl pro seznam dotazů v probíhajícím rozhovoru může vypadat následovně:

'''Hlavička'''

<code>
<nowiki><h2>Otázky a odpovědi</h2></nowiki>
<nowiki><dl></nowiki>
</code>

'''Tělo'''

<code>
<nowiki><dt>, , <br /></nowiki>
<nowiki></dt></nowiki>
<nowiki><dd>, <br />")--></nowiki>
<nowiki></dd></nowiki>
</code>

'''Patička'''

<code>
<nowiki></dl></nowiki>
</code>

Předloha pro seznam dotazů - uzavřený rozhovor může vypadat následovně:

<code>
<nowiki><h1></h1></nowiki>
<nowiki><div></nowiki>
<nowiki></nowiki>
<nowiki> </nowiki>
<nowiki></nowiki>
<nowiki></div></nowiki>
<nowiki><div><p>Rozhovor je ukončen.</p></div></nowiki>
</code>

Styl pro seznam dotazů v uzavřeném rozhovoru lze použít stejný jako pro probíhající rozhovor.

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

2010-04-08T07:52:57Z

Vitas: /* Vytvoření stránky pro vložení nového dotazu */

[[Category:WebToDate Poradny a rozhovory]]
[[Category:Poradny a rozhovory]]
== 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:

# Základní nastavení celého modulu (např. předvoleb apod.)
# Založení prvního předpisu
# Založení první poradny
# Vlastní definice předpisu, tj. potřebných WebToDate stylů a předloh pro jednotlivé typy stránek a jejich nastavení pro danou poradnu
# 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'''.

[[Image:poradnyarozhovory-zaciname-img002.png|center]]

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''.

<div class="note">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'''.</div>

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í.

[[Image:poradnyarozhovory-zaciname-img003.png|center]]

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.

[[Image:poradnyarozhovory-zaciname-img004.png|center]]

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.

[[Image:poradnyarozhovory-zaciname-img005.png|center]]

<div class="note">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.</div>

== 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.

<code>
<nowiki><h3>Nový dotaz do poradny </h3></nowiki>
<nowiki><i><br></i></nowiki>
<nowiki></nowiki>
<nowiki><form name="formular" id="formular" action="/scripts/modules/advice/newquestion.php?id=" method="post"></nowiki>
<nowiki></nowiki>
<nowiki></nowiki>
<nowiki></nowiki>
<nowiki><table></nowiki>
<nowiki><tr></nowiki>
<nowiki> <td align="right"></nowiki>
<nowiki> <label for="name">Název</label></nowiki>
<nowiki> </td></nowiki>
<nowiki> <td></nowiki>
<nowiki> <input type="text" name="name" id="name" value="" size="60" /></nowiki>
<nowiki> </td></nowiki>
<nowiki></tr></nowiki>
<nowiki><tr></nowiki>
<nowiki> <td align="right"></nowiki>
<nowiki> <label for="firstname">Jméno</label></nowiki>
<nowiki> </td></nowiki>
<nowiki> <td></nowiki>
<nowiki> <input type="text" name="firstname" id="firstname" value="" size="60" /></nowiki>
<nowiki> </td></nowiki>
<nowiki></tr></nowiki>
<nowiki><tr> </nowiki>
<nowiki> <td align="right"></nowiki>
<nowiki> <label for="lastname">Příjmení</label></nowiki>
<nowiki> </td></nowiki>
<nowiki> <td></nowiki>
<nowiki> <input type="text" name="lastname" id="lastname" value="" size="60" /></nowiki>
<nowiki> </td></nowiki>
<nowiki></tr></nowiki>
<nowiki><tr> </nowiki>
<nowiki> <td align="right"></nowiki>
<nowiki> <label for="nickname">Přezdívka</label></nowiki>
<nowiki> </td></nowiki>
<nowiki> <td></nowiki>
<nowiki> <input type="text" name="nickname" id="nickname" value="" size="60" /></nowiki>
<nowiki> </td></nowiki>
<nowiki></tr></nowiki>
<nowiki><tr> </nowiki>
<nowiki> <td align="right"></nowiki>
<nowiki> <label for="email">E-mail</label></nowiki>
<nowiki> </td></nowiki>
<nowiki> <td></nowiki>
<nowiki> <input type="text" name="email" id="email" value="" maxlength="80" size="60" /></nowiki>
<nowiki> </td></nowiki>
<nowiki></tr></nowiki>
<nowiki><tr> </nowiki>
<nowiki> <td align="right"></nowiki>
<nowiki> <label for="question">Dotaz</label></nowiki>
<nowiki> </td></nowiki>
<nowiki> <td></nowiki>
<nowiki> <textarea cols="50" rows="12" name="question"></textarea></nowiki>
<nowiki> </td></nowiki>
<nowiki></tr></nowiki>
<nowiki><tr></nowiki>
<nowiki> <td align="right" colspan="2"></nowiki>
<nowiki> <input type="submit" name="send" id="send" value="Odeslat" /></nowiki>
<nowiki> </td></nowiki>
<nowiki></tr></nowiki>
<nowiki></table></nowiki>
<nowiki></form></nowiki>
</code>

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.

<div class="note">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.</div>

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.

[[Image:poradnyarozhovory-zaciname-img006.png|center]]

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

<code>
<nowiki></nowiki>
</code>

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.

[[Image:poradnyarozhovory-zaciname-img007.png|center]]

Formulář nyní můžete zobrazit na stránce ''/scripts/modules/advice/newquestion.php?id==xxx'', kde xxx je ID poradny založené v kapitole [[../Začínáme#Založení poradny|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.

<code>
<nowiki><h3><a href=" "></a></h3></nowiki>
<nowiki>Seznam dotazů: <strong></nowiki>
<nowiki></nowiki>
<nowiki></nowiki>
<nowiki></nowiki>
<nowiki></strong></nowiki>
<nowiki><div></nowiki>
<nowiki></nowiki>
<nowiki></nowiki>
<nowiki></div></nowiki>
<nowiki><div></div></nowiki>
<nowiki><div></div></nowiki>
</code>

Klíčové slovo <nowiki></nowiki> 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'''

<code>
<nowiki><table border="0" cellspacing="1" cellpadding="4"></nowiki>
</code>

'''Tělo'''

<code>
<nowiki><tr bgcolor="#efefef"></nowiki>
<nowiki><td></td><td></td></nowiki>
<nowiki></tr></nowiki>
<nowiki><tr bgcolor="#f6f6f6"></nowiki>
<nowiki><td colspan="2"></nowiki>
<nowiki><em>Zadáno , zodpovězeno <br /></nowiki>
<nowiki>Tazatel   () <a href="mailto:"></a></em></nowiki>
<nowiki></td></nowiki>
<nowiki></tr></nowiki>
<nowiki><tr><td colspan="2"><strong>Dotaz:</strong><br /></td></tr></nowiki>
<nowiki><tr><td colspan="2"><strong>Odpověď:</strong><br /></td></tr></nowiki>
</code>

'''Patička'''

<code>
<nowiki></table></nowiki>
</code>

'''Separátor'''

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

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á.

[[Image:poradnyarozhovory-zaciname-img008.png|center]]

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 [[../Začínáme#Založení poradny|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.

[[Image:poradnyarozhovory-zaciname-img009.png|center]]

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.

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

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á.

[[Image:poradnyarozhovory-zaciname-img010.png|center]]

=== 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í:

# 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.
# V seznamu dotazů v pravé horní části okna prohlížeče by se měl zobrazit tento dotaz. Klepněte na jeho název.
# V záložce '''Odpověď''' formuláře doplňte nějakou odpověď a použijte tlačítko '''Zodpovědět'''.
# 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.