WebToDate/Fulltext/Reference

Administrační rozhraní

Nabídka modulu

Kompletní nabídka modulu vypadá následovně:

Nástroje

Formuláře

Nastavení

Seznam předpisů

Předvolby

Předpisy

název předpisu

Hledání ve zprávách

Globální hledání

Navigační lišta

Administrace

Předvolby

Data

Hledané výrazy

Nápověda

Nástroje

Formuláře

Pomocí této funkce lze vytvořit výchozí vzhled formuláře pro vyhledávání a jeho uložení do databáze fragmentů systému WebToDate tak, aby jej bylo možné umisťovat na libovolnou stránku. Z nabídek vyberte, jakou kategorii, publikaci a jazyk by výsledný fragment měl mít. Pokud chcete upravit vzhled tohoto formuláře podle vašich představ, upravte odpovídající fragment (v něm byste měli zachovat klíčová slova tohoto modulu).

Nastavení

Tato část nabídky slouží k definování grafické podoby vyhledávacích stránek na veřejné části webu. Předpisem se rozumí souhrn nastavení pro více prvků najednou (vyhledávací stránky, navigační lišta atd.)

Seznam předpisů

Pomocí funkce Seznam předpisů se zakládají nové předpisy, jedinou volbou při zakládání předpisu je jeho název. Po založení se předpis zobrazí v nabídce v této sekci Nastavení, pod názvem předpisu jsou pak jednotlivé položky pro nastavení předpisu.

Předvolby

Ve formuláři se volí výchozí předpis - pokud není v URL vyhledávací stránky uvedeno ID předpisu, použije se pro zobrazení tento zvolený výchozí předpis.

Nastavení předpisů

Dále se v nabídce Nastavení nacházejí jednotlivé předpisy a jejich nastavovací formuláře (za předpokladu, že je alespoň jeden předpis založen). Každý předpis se skládá z nastavení Hledání ve zprávách (týká se skriptu pro hledání ve zprávách), Globální hledání (týká se skriptu pro globální prohledávání) a Navigační lišta.

Hledání ve zprávách

Ve formuláři Hledání ve zprávách se nastavují parametry, které jsou využívány skriptem fulltxt.php (viz dále) pro vyhledávání pouze ve zprávách:

1. Předloha – šablona stránky s výsledky vyhledávání, která určuje její základní vzhled.
2. WebToDate styl pro zobrazování výsledků – z rozevíracího seznamu vyberte styl, kterým budou zobrazené jednotlivé nalezené položky.
3. Počet záznamů/ str. určuje stránkování výpisu výsledků hledání.
4. Uvozující nadpis výpisu určuje nadpis nad seznamem nalezených výsledků.
5. Do pole Nic nenalezeno uveďte text, který bude vypsán v případě, že žádné položky nalezeny nebudou.
6. WebToDate styl pro seznam nejhledanějších výrazů - pokud je zapnuto ukládání hledaných výrazů, je volitelně možné generovat na vyhledávací stránku seznam nejhledanějších výrazů. Vybírá se styl, počet položek a maximální stáří ve dnech (tj. např. jaké výrazy byly nejhledanější za posledních 30 dnů)
7. WebToDate styl pro seznam výsledků hledání podle klíčových slov - pokud je zapnuto hledání podle klíčových slov, může se ve stránce zobrazit kromě výsledků fulltextového hledání i výsledek hledání v seznamu klíčových slov databáze zpráv. Volí se styl, počet položek a jak se tento seznam zobrazuje (pouze na první stránce v rámci stránkování fulltextového hledání / na všech stránkách / nezobrazuje se)

Pro optimální funkci výpisu výsledků je vhodné použít v Uvozujícím nadpisu výpisu v Úspěšném hledání použít klíčová slova <!--WTD_FULLTXT(FROM)-->, <!--WTD_FULLTXT(TO)--> a WTD_FULLTXT(TOTAL)-->.

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

Globální hledání

Ve formuláři Globální hledání se nastavují parametry, které jsou využívány skriptem globalsearch.php pro vyhledávání ve více datových zdrojích (zprávách, diskuzích, poradnách, akcích). Význam polí je zcela shodný jako v případě Hledání ve zprávách, tomu odpovídá i příslušný příklad:

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í seznamu výsledků vyhledávání.

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

1. Předchozí – HTML kód určující formátování odkazu pro přechod na předcházející stránku
2. Následující – HTML kód určující formátování odkazu pro přechod na další stránku
3. Hlavička – HTML kód, který je umístěn na počátku výsledného kódu navigační lišty
4. Patička – HTML kód, který je umístěn na konci výsledného kódu navigační lišty
5. Číslo stránky – formátování jednotlivých čísel stránky, které umožní odkliknutí na zvolenou stránku
6. Aktivní stránka – formátování údaje o čísle aktuální stránky
7. Separátor – oddělovač mezi jednotlivými čísly stránek.
8. 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 <!--WTD_NAVIG(URL)--> a <!--WTD_NAVIG(NUMBER)-->.

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

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

Administrace

Ve formuláři Předvolby se nastavuje chování modulu týkající vyhledávání zpráv podle klíčových slov a ukládání hledaných výrazů.

Základem modulu je fulltextové hledání, což znamená, že modul vyhledává hledané výrazy v textech zpráv, případně s omezením na vybraná metadata (časový interval, kategorie apod.). Zprávy mohou být volitelně opatřovány klíčovými slovy jako dalším typem metadat. Volitelně modul umožňuje vedle seznamu položek nalezených fulltextovou metodou ještě navíc zobrazit seznam zpráv, které jsou opatřeny hledaným klíčovým slovem. Algoritmus hledání podle klíčových slov je následující:

Vyhledávání dle klíčových slov se spouští jen pokud

1. Je v předvolbách zvoleno Vyhledávat zprávy podle klíčových slov
2. V příslušném předpisu, který se použije pro zobrazení, není zvoleno Zobrazit: nezobrazovat nebo pokud není zvoleno Zobrazit: pouze na první stránce a má se zobrazit jiná než první stránky v rámci stránkování (parametr pg vyhledávacího skriptu je 1 nebo prázdný)
3. Je zadán vyhledávací výraz, který neobsahuje žádné podporované logické operátory (AND, OR, závorka, hvězdička apod.). Zadání více slov je možné, WebToDate podporuje možnost zadávat klíčová slova, která se skládají z více slov.

V takovém případě se vyvolá dotaz na vyhledání dle klíčových slov ve zprávách, které zároveň odpovídají dalším eventuálním vyhledávacím podmínkám z vyhledávacího formuláře (jsou ve zvolené publikaci apod.). V případě, že je zvoleno v předvolbách modulu Převádět při hledání podle klíčových slov na malá písmena, převede se nejprve hledaný výraz na malá písmena.

Výsledek je vždy omezen na Max. počet záznamů z definice předpisu, seznam nalezených zpráv není stránkovaný. Výsledek je vždy tříděn podle data zprávy sestupně.

Výsledek se formátuje stylem z definice předpisu, ve stylu lze použít stejná klíčová slova jako ve stylu pro běžné fulltextové hledání. Ve stylu lze definovat hlavičku, patičku (vkládají se, jen když je nalezena alespoň jedna zpráva), separátor a tělo.

Hledání dle klíčových slov a fulltextové hledání nejsou nijak propojena, pakliže se tedy např. zpráva nalezne pomocí hledání přes klíčová slova, může se zároveň vypsat v seznamu nalezeném fulltextovým hledáním apod.

Další možností modulu je ukládání hledaných výrazů. Tato funkce může sloužit k zobrazování seznamu nejhledanějších výrazů v prezentační části nebo k pouze jednoduchému procházení hledaných výrazů v administrační části modulu.

Pokud je v předvolbách zvoleno Ukládat hledané výrazy, ukládají se výrazy do databáze.

Algoritmus ukládání:

1. Zajišťuje, že se výrazy v jedné uživatelské session neukládají vícekrát (tj. že pokud jeden uživatel vyhledává stejný výraz opakovaně, považuje se to za vícenásobné hledání, které se uloží jen jednou)
2. výrazy z vyhledávacího formuláře se zpracovávají tak, aby se "normalizovaly" a ukládaly jednotným způsobem bez logických operátorů apod.

Při zpracování výrazů se postupuje tak, že se vyhledávají jednotlivé jednoslovné či víceslovné výrazy, které se skutečně hledají. To znamená:

• Ignorují se závorky a operátory AND a OR
• Výraz následující za operátorem NOT se nepovažuje za hledaný výraz
• Slovo zadané s hvězdičkovou konvencí se nepovažuje za hledaný výraz

Příklady uvádí následující tabulka:

Vyhledávací podmínka	Hledané výrazy
Klaus AND Havel	Klaus, Havel
Klaus ANT NOT Havel	Klaus
Václav Klaus AND hrad*	Václav Klaus
(jablko AND hruška) OR (švestka AND třeš*)	jablko, hruška, švestka

Po extrakci jednotlivých výrazů se ještě dle nastavení Převádět výrazy na malá písmena a Odstraňovat diakritiku tyto výrazy konvertují na malá písmena resp. se konvertují na výrazy bez diakritiky.

Ve formuláři pro předvolby se tedy volí:

• Vyhledávat zprávy podle klíčových slov - je-li zvoleno, aktivuje se algoritmus hledání dle klíčových slov (někdy také nazývaný prioritní výsledky); aby se seznam nalezených položek dle klíčových slov zobrazil, musí být navíc ve formuláři pro nastavení hledání ve zprávách zvolena pro tento prvek jiná volba než nezobrazovat
• Převádět při hledání podle klíčových slov na malá písmena - pokud je zvoleno, hledaná výrazy se nejprve před vyhledáním převedou na malá písmena (užitečné v případě, že se klíčová slova ve zprávách zadávají vždy malými písmeny)
• Ukládat hledané výrazy - je-li zvoleno, ukládají se vyhledávané výrazy do databáze dle výše uvedeného algoritmu
• Minimální délka uloženého výrazu - omezuje minimální délku ukládaného výrazu; výrazy mající méně znaků než je zde uvedeno ukládány do databáze nebudou
• Převádět výrazy na malá písmena - je-li zvoleno, převádějí se před uložením hledané výrazy na malá písmena, aby se duplicitně neukládaly stejné výrazy lišící se jen velkými a malými písmeny
• Odstraňovat diakritiku - je-li zvoleno, převádějí se výrazy před uložením tak, aby znaky s diakritikou byly nahrazeny znaky bez diakritiky

Data

Hledané výrazy

Tato funkce slouží k zobrazení statistik hledaných výrazů. V horní části okna se volí kritéria pro výpis, ve spodní části se zobrazuje vlastní statistika.

V případě volby Podrobný výpis se zobrazují v podstatě jednotlivé záznamy funkce pro sledování výrazů, tedy výraz, datum a čas vyhledání a IP adresa, ze které se hledalo.

Veřejné skripty

Veřejný skript pro hledání ve zprávách

Hledání ve zprávách se provádí pomocí jediného skriptu:

fulltxt.php – zobrazuje seznam výsledků vyhledávání

Při volání skriptu je nutné zadat kompletní cestu, která je pro modul Fulltext:

/scripts/modules/fulltext/

Veřejný skript pro zobrazení výsledků pak bude mít toto URL:

/scripts/modules/fulltext/fulltxt.php

Skript prohledává pouze databázi zpráv, možná kritéria jsou:

• Fulltextová vyhledávací podmínka
• Kategorie
• Publikace
• Jazyk
• Rozsah dat od – do

Veřejný skript pro globální hledání

Globální hledání ve více datových zdrojích je umožněno skriptem:

globalsearch.php – zobrazuje seznam výsledků vyhledávání

Při volání skriptu je nutné zadat kompletní cestu, která je pro modul Fulltext:

/scripts/modules/fulltext/

Veřejný skript pro zobrazení výsledků pak bude mít toto URL:

/scripts/modules/fulltext/globalsearch.php

Tento skript prohledává nejen zprávy, ale v případě, že je v rámci systému WebToDate nainstalován modul Diskuze, Poradny a rozhovory nebo Kalendář akcí, také objekty těchto modulů. Najednou tedy mohou být prohledávány tyto datové zdroje:

• Zprávy
• Diskuze
• Poradny a rozhovory
• Kalendář akcí

Poté jsou atributy vyhledaných objektů ze všech datových zdrojů seřazeny do jediného seznamu, který je vrácen. Možnost formátování výsledku hledání je omezena na položky společné pro všechny datové zdroje jako nadpis, datum apod.

Jaké výrazy lze při hledání používat

Jednoduché hledání

Pokud hledáme jediné slovo, stačí je jednoduše zapsat do vyhledávacího formuláře. Musíme však dát pozor na to, že dolní hranice délky slova je v závislosti na typu vyhledávacího serveru a jeho nastavení omezena (např. na 3 písmena). Kratší slovo pak nemůže být nikdy nalezeno.

Vyhledávání sousloví

Vyhledáváme-li několik slov najednou (např. řetězec "milá paní"), lhostejno jestli uzavřených v uvozovkách či nikoliv, vyhledají se záznamy s touto přesnou frází.

Logické operátory

Lze používat logické operátory AND (a zároveň), OR (nebo), NOT (negace). Operátor NOT má vyšší prioritu než zbylé dva operátory. Např. výraz červená AND NOT bílá vybere všechny záznamy, v nichž se vyskytuje slovo červená a zároveň jsou prosty slova bílá.

Závorky

Současně s logickými operátory můžeme jejich prioritu určovat explicitně závorkami, např. výraz červená OR (bílá AND černá) vybere všechny záznamy, ve kterých je přítomno slovo červená nebo záznamy, ve kterých se vyskytují slova bílá a černá současně.

Hvězdičková konvence

Jestliže uvedeme na konci hledaného slova hvězdičku, vyhledají se všechna slova, která začínají specifikovaným řetězcem znaků. Např. na základě výrazu hla* se vyhledají slova hladina, hlas, hlava, hlavní atp.

Klíčová slova modulu

Klíčová slova pro všechny vyhledávací skripty

Klíčová slova použitelná v předloze vyhledávací stránky

Klíčová slova použitelná v předloze – chybové stavy a další podmínky
Klíčové slovo	Význam	Poznámka
<!--WTD_FULLTXT(LIST)-->	Seznam nalezených	Reprezentuje seznam záznamů nalezených fulltextovým hledáním
<!--WTD_FULLTXT(TERMS)-->	Seznam nalezených	Reprezentuje seznam záznamů nalezených hledáním podle klíčových slov
<!--WTD_FULLTXT(NAVIG)-->	Navigační lišta	Reprezentuje místo, kam se vloží navigační lišta
<!--WTD_FULLTXT(LABEL)-->	Výpis výsledků	Reprezentuje uvozující nadpis výpisu výsledků (např. "Dokument 1 až 10 z 50")

Klíčová slova použitelná v předloze – chybové stavy a další podmínky
Klíčové slovo	Význam	Poznámka
<!--WTD_IF(WRONGDATEFROM,"")-->	Špatný formát data od
<!--WTD_IF(WRONGDATETO,"")-->	Špatný formát data do

Tato klíčová slova se používají ve formátu

<!--WTD_IF(příznak,hláška)-->

například:

<!--WTD_IF(WRONGDATETO,"Chybný formát data v poli Datum do.")-->

Klíčová slova použitelná v uvozujícím nadpisu výpisu výsledků při úspěšném hledání
Klíčové slovo	Význam	Poznámka
<!--WTD_FULLTXT(FROM)-->	Počet od	Počáteční pořadové číslo záznamu na stránce v seznamu nalezených
<!--WTD_FULLTXT(TO)-->	Počet do	Koncové pořadové číslo záznamu na stránce v seznamu nalezených
<!--WTD_FULLTXT(TOTAL)-->	Počet celkem	Počet nalezených záznamů celkem

Klíčová slova použitelná ve stylu pro seznam nejhledanějších výrazů
Klíčové slovo	Význam	Poznámka
<!--WTD_FULLTXT(TERM)-->	Hledaný výraz	Zobrazuje hledaný výraz uložený v databázi hledaných výrazů
<!--WTD_FULLTXT(TERMCOUNT)-->	Počet hledání	Reprezentuje počet hledání daného výrazu za období nastavené ve formuláři pro nastavení vyhledávací stránky

Jednoduchou tabulku se seznamem nejhledanějších výrazů definuje následující styl (klikem na dané slovo se spouští hledání daného výrazu):

Hlavička

<table>
<tr><th>Nejčastější hledání</th></tr>

Tělo

<tr><td><a href="fulltxt.php?searchtext=<!--WTD_FORMAT(URLENCODE,"","<!--WTD_FULLTXT(TERM)-->")-->"><!--WTD_FULLTXT(TERM)--></a>
&nbsp;(<!--WTD_FULLTXT(TERMCOUNT)-->)</td></tr>

Patička

</table>

Klíčová slova použitelná v definici navigační lišty
Klíčové slovo	Význam	Poznámka
<!--WTD_NAVIG(URL)-->	Odkaz	Klíčové slovo je nahrazováno za odkaz na určitou stránku v rámci stránkování seznamu
<!--WTD_NAVIG(NUMBER)-->	Číslo stránky	Klíčové slovo je nahrazováno za pořadové číslo určité stránky v rámci stránkování seznamu

Klíčová slova pro vyhledávání ve zprávách

Klíčová slova použitelná v předloze vyhledávací stránky Tato klíčová slova se typicky používají v HTML kódu vyhledávacího formuláře
Klíčové slovo	Význam	Poznámka
<!--WTD_FULLTXT(SEARCHTEXT)-->	Hledaný text	Hledaný text ve formuláři
<!--WTD_FULLTXT(SEARCHTEXTENC)-->	Zakódovaný hledaný text	Hledaný text zakódovaný pro bezproblémové použití v URL parametru (vyhovující RFC standardu)
<!--WTD_FULLTXT(DATEFROM)-->	Datum od	Datum od ve vyhledávacím formuláři
<!--WTD_FULLTXT(DATETO)-->	Datum do	Datum do ve vyhledávacím formuláři
<!--WTD_FULLTXT(LANGUAGES)-->	Jazyky	Seznam jazyků ve vyhledávacím formuláři, vracený uvnitř HTML elementů <option/>.
<!--WTD_FULLTXT(PUBLICATIONS)-->	Publikace	Seznam publikací ve vyhledávacím formuláři, vracený uvnitř HTML elementů <option/>.
<!--WTD_FULLTXT(INCLUDE_SUBCATEGORIES)-->	Hledat včetně podkategorií	Pokud je specifikována kategorie pomocí parametru categid (např. v hidden poli formuláře), lze použít tuto možnost s vyhledáváním včetně podkategorií.
<!--WTD_FULLTXT(SORT_RANK)-->	Zvoleno třídění podle relevance	Používá se v definici radiopřepínače pro volbu třídění, viz níže
<!--WTD_FULLTXT(SORT_DATE)-->	Zvoleno třídění podle času	Používá se v definici radiopřepínače pro volbu třídění, viz níže
<!--WTD_FULLTXT(KWLIST)-->	Seznam zpráv nalezených dle klíčových slov	Používá se na vhodném místě v předloze, kde se má zobrazit seznam výsledků hledání dle klíčových slov

Klíčová slova použitelná ve stylu nalezených výsledků
Klíčové slovo	Význam	Poznámka
<!--WTD_F(NUMBER)-->	Číslování řádků
<!--WTD_F(ID)-->	ID zprávy
<!--WTD_F(TITLE)-->	Nadpis
<!--WTD_F(TITLELINK)-->	Odkaz nadpisu
<!--WTD_F(EXCERPT)-->	Fragment textu	Fragment textu s vyhledaným výrazem.
<!--WTD_F(DESCRIPTION)-->	Popis
<!--WTD_F(DATE)-->	Datum zprávy
<!--WTD_F(CATEGORYID)-->	Číslo kategorie
<!--WTD_F(CATEGORY)-->	Název kategorie
<!--WTD_F(PIC)-->	Obrázek
<!--WTD_F(ALTPIC)-->	Alt. obrázek
<!--WTD_F(LANGUAGEID)-->	ID jazyka
<!--WTD_F(LANGUAGE)-->	Název jazyka
<!--WTD_F(SOURCE)-->	Autor

K výše uvedeným klíčovým slovům existuje alternativa typu WTD_IF(…NULL) a WTD_IF(…NOTNULL) stejně jako u stylů pro zprávy (viz také kapitola 4.5).

V seznamu zpráv se nahrazují obsahem i klíčová slova instancí položek z databáze zdrojů ve zprávách. Pokud se např. ve zprávách používají ilustrační obrázky uložené jako instance zdrojů do pole Obrázek databáze zpráv, lze ve stylu pro seznam nalezených zpráv ve výpisu použít klíčové slovo <!--WTD_F(PIC)--> a obrázek se zobrazí stejně jako v seznamech zpráv WebToDate.

Stejně tak se nahrazují klíčová slova pro zdroje typu WTD_ASSET, která v tomto případě reprezentují výchozí přílohu ke zprávě.

Klíčové slovo EXCERPT zobrazuje v rámci možností fragment textu s vyhledaným výrazem, a to podle následujících pravidel:

• Pokud je hledaný výraz přítomen v těle zprávy, zobrazí fragment těla zprávy s vyhledaným výrazem uprostřed a s +-40 znaků okolo. Oblast je rozšířená na celá slova. Pokud se v těle vyskytuje vyhledávaný výraz opakovaně, bere se v úvahu jeho prvý výskyt.
• Jestliže je výraz přítomen pouze v popisu zprávy, nahradí se klíčové slovo EXCERPT za celý popis zprávy, přičemž se v něm zvýrazní všechny výskyty hledaného výrazu.
• Jestliže výraz není přítomen v těle ani v popisu (zpráva jej tedy obsahuje ve svém názvu nebo ve jménu autora), nahradí se klíčové slovo EXCERPT za popis zprávy bez jakéhokoliv zvýrazňování.

Slova hledaného výrazu se označují HTML tagem <span class="keyword">…</span>.

Výchozí třídění seznamu zpráv ve výsledku hledání je vždy dle data a času zprávy sestupně. Ve vyhledávacím formuláři ale lze zvolit třídění podle relevance, a to buď pevně nebo na základě volby uživatele.

Pokud je požadováno vždy třídění podle relevance, vložte do vyhledávacího formuláře kód

<input type="hidden" name="sort" value="rank" />

Pokud může uživatel třídění volit, použijte kód

Třídění podle:<br />
<input type="radio" name="sort" value="rank" <!--WTD_FULLTXT(SORT_RANK)-->/> Relevance
<input type="radio" name="sort" value="date" <!--WTD_FULLTXT(SORT_DATE)-->/> Času

Klíčová slova pro globální hledání

Klíčová slova použitelná v předloze vyhledávací stránky Tato klíčová slova lze použít ve vyhledávacím formuláři.
Klíčové slovo	Význam	Poznámka
<!--WTD_FULLTXT(SEARCHTEXT)-->	Hledaný text	Hledaný text ve formuláři
<!--WTD_FULLTXT(SEARCHTEXTENC)-->	Zakódovaný hledaný text	Hledaný text zakódovaný pro bezproblémové použití v URL parametru (vyhovující RFC standardu)
<!--WTD_FULLTXT(DATEFROM)-->	Datum od	Datum od ve vyhledávacím formuláři
<!--WTD_FULLTXT(DATETO)-->	Datum do	Datum do ve vyhledávacím formuláři
<!--WTD_FULLTXT(LANGUAGES)-->	Jazyky	Seznam jazyků ve vyhledávacím formuláři, vracený uvnitř HTML elementů <option/>.

Klíčová slova použitelná v předloze – chybové stavy a další podmínky
Klíčové slovo	Význam	Poznámka
<!--WTD_IF(SEARCHPROCEEDED,"")-->	Vyhledávání bylo provedeno	Kód se vloží v případě, že skript již vrací výsledky vyhledávání (nikoliv výchozí stránku s prázdným formulářem)

Díky klíčovému slovu SEARCHPROCEEDED podporuje modul Fulltext funkci "vyhledat jinde", která umožňuje v případě, že uživatel zadá nějaký vyhledávací výraz a zobrazí seznam nalezených zpráv, do stránky vložit odkaz typu:

Vyhledat "hledane_slovo" v diskusích.

Vyhledat "hledane_slovo" v poradnách.

Tyto odkazy lze vložit pomocí klíčového slova:

<!--WTD_IF(SEARCHPROCEEDED," <a href='/scripts/modules/disc/search.php?searchtext=<!--WTD_FULLTXT(SEARCHTEXT)-->'> Vyhledat "<!--WTD_FULLTXT(SEARCHTEXT)--> " v diskuzích.</a>")-->
<!--WTD_IF(SEARCHPROCEEDED," <a href='/scripts/modules/advice/fulltxt.php?searchtext=<!--WTD_FULLTXT(SEARCHTEXT)-->'> Vyhledat "<!--WTD_FULLTXT(SEARCHTEXT)--> " v poradnách.</a>")-->

Klíčová slova použitelná ve stylu nalezených výsledků
Klíčové slovo	Význam	Poznámka
<!--WTD_F(NUMBER)-->	Číslování řádků
<!--WTD_F(ID)-->	ID položky	ID zprávy či jiného objektu podle datového zdroje
<!--WTD_F(TITLE)-->	Nadpis
<!--WTD_F(TITLELINK)-->	Odkaz nadpisu
<!--WTD_F(DATE)-->	Datum
<!--WTD_F(LANGUAGEID)-->	ID jazyka
<!--WTD_F(LANGUAGE)-->	Název jazyka

Na všechna tato klíčová slova existují alternativa typu WTD_IF(…NULL) a WTD_IF(…NOTNULL) stejně jako u stylů pro zprávy (viz také kapitola 4.5).

Klíčová slova použitelná ve stylu nalezených výsledků – informace o zdroji nalezených dat
Klíčové slovo	Význam	Poznámka
<!--WTD_IF(ORIGINNEWS,"")-->	Nalezena zpráva	Kód se vkládá v případě, že daná nalezená položka pochází z databáze zpráv
<!--WTD_IF(ORIGINDISC,"")-->	Nalezen diskusní příspěvek	Kód se vkládá v případě, že daná nalezená položka pochází z databáze diskuzních příspěvků (modul Diskuze)
<!--WTD_IF(ORIGINADVICE,"")-->	Nalezen dotaz v poradně	Kód se vkládá v případě, že daná nalezená položka pochází z databáze dotazů v poradnách (modul Poradny a rozhovory)
<!--WTD_IF(ORIGINDIARY,"")-->	Nalezena akce	Kód se vkládá v případě, že daná nalezená položka pochází z databáze kalendáře akcí (modul Kalendář akcí)

Podmíněné vkládání polí

U některých z výše uvedených polí lze využít podmíněného vkládání do výsledného HTML kódu. K tomu se používají klíčová slova

<!--WTD_IF(jméno_poleNULL,"html kód")-->

<!--WTD_IF(jméno_poleNOTNULL,"html kód")-->

kde za se za jméno_pole dosadí název zvoleného pole.

• Pokud je toto pole prázdné
• zobrazí se na místě podmínky jméno_poleNULL HTML kód, který je obsažen v uvozovkách
• podmínka jméno_poleNOTNULL se nahradí prázdným řetězcem.
• Naopak pokud pole není prázdné
• zobrazí se na místě podmínky jméno_poleNOTNULL HTML kód, který je obsažen v uvozovkách
• podmínka jméno_poleNULL se nahradí prázdným řetězcem.

<!--WTD_IF(PICNULL, "obrázek není k dispozici")-->

<!--WTD_IF(PICNOTNULL, "<img src="<!-WTD_F(PIC)-->"/>")-->

Klíčová slova pro formátování

Modul dále podporuje Klíčová slova pro formátování typu WTD_FORMAT, tedy např.

<!--WTD_FORMAT(SMAXLEN,"formátovací předpis","ořezávaný text")-->

apod.

Formulářová pole

Formulářová pole pro vyhledávání ve zprávách

Názvy elementů formuláře jsou následující:

• searchtext – vyhledávací textová podmínka
• categid – id kategorie
• subcateg – vyznačení, že se má hledat včetně podkategorií. Hodnota 1 znamená ano, jiná hodnota ne.
• langid – id jazyka
• publid – id publikace
• datefrom – datum od
• dateto – datum do
• sort – způsob třídění, možné hodnoty rank nebo date, pokud není specifikováno, třídí se podle času zpráv sestupně

Použití je zřejmé z následujícího příkladu. Jednoduše formátovaný vyhledávací formulář v HTML vypadá následovně:

<form action="/scripts/modules/fulltext/fulltxt.php" method="get">
<!--WTD_IF(WRONGDATEFROM,"<p>Chybně vložený formát v políčku s počátečním datem.</p>")--> 
<!--WTD_IF(WRONGDATETO,"<p>Chybně vložený formát v políčku s koncovým datem.</p>")-->
<table>
  <tr>
    <td colspan="2">
    Hledání ve zprávách
    </td>
  </tr>
  <tr>
    <td colspan="2">
      <input type="text" name="searchtext" value="<!--WTD_FULLTXT(SEARCHTEXT)-->" size="43" maxlength="80" /> 
      <input type="submit" name="Action" value="Hledat" />
    </td>
  </tr>
  <tr>
    <td>
      Jazyk:
    </td>
    <td>
      <select name="langid">
  	    <option value ="0">--všechny--</option>
  	    <!--WTD_FULLTXT(LANGUAGES)-->
      </select>
    </td>
  </tr>
  <tr>
    <td>
      Datum od:
    </td>
    <td>
      <input type="text" name="datefrom" maxlength="10" value="<!--WTD_FULLTXT(DATEFROM)-->" />
    </td>
  </tr>
  <tr>
    <td>
      Datum do:
    </td>
    <td>
      <input type="text" name="dateto" maxlength="10" value="<!--WTD_FULLTXT(DATETO)-->" />
    </td>
  </tr>
</table>
</form>

Formulářová pole pro globální hledání

Názvy elementů formuláře jsou následující:

• searchtext – vyhledávací textová podmínka
• langid - jazyk
• datefrom – datum od
• dateto – datum do

Jejich použití je stejné jako u prohledávání zpráv.

Parametry z URL či formuláře

Následující parametry se používají ve veřejných skriptech - lhostejno zda z URL nebo formuláře.

Skript fulltxt.php

V URL skriptu fulltxt.php můžeme definovat tyto parametry:

• lid (integer) - ID jazyka v případě používání jiné jazykové mutace než výchozí. Toto nastavení souvisí s rozdělením na jednotlivé jazyky uvnitř admin. rozhraní modulu.
• locale (string) ... locale string jazyka (CS, EN, DE). Výsledek stejný jako výše.
• tmplid (integer) ... vynucení jiné předlohy vyhledávací stránky, než jaká je nastavena na stránce Výsledky hledání.
• patternid - ID předpisu, který se má pro zobrazení vyhledávací stránky použít (není-li uvedeno, použije se výchozí předpis)

Další parametry přebírá skript fulltxt.php z elementů vyhledávacího formuláře:

• Musí v něm být přítomno textové pole s názvem searchtext (vyhledávaný text)
• Mohou v něm být přítomna textová pole datefrom, dateto (časové rozmezí vyhledávaných zpráv)
• Mohou v něm být přítomna pole categid (kategorie zpráv), subcateg (včetně podkategorií), langid (jazyk zpráv) a publid (publikace zpráv).

Skript globalsearch.php

V URL skriptu globalsearch.php můžeme definovat tyto parametry:

• lid - ID jazyka v případě používání jiné jazykové mutace než výchozí. Toto nastavení souvisí s rozdělením na jednotlivé jazyky uvnitř admin. rozhraní modulu.
• locale ... locale string jazyka (cs, en, de). Výsledek stejný jako výše.
• tmplid ... vynucení jiné předlohy vyhledávací stránky, než jaká je nastavena na stránce Výsledky hledání.
• patternid - ID předpisu, který se má pro zobrazení vyhledávací stránky použít (není-li uvedeno, použije se výchozí předpis)

Parametr pro vynucení ID předpisu se běžně používá i jako hidden parametr formuláře, tedy např.

<input type="hidden" name="patternid" value="8" />

Další parametry přebírá skript globalsearch.php z vyhledávacího formuláře:

• Musí v něm být přítomno textové pole s názvem searchtext (vyhledávaný text)
• Mohou v něm být přítomna textová pole datefrom, dateto (časové rozmezí vyhledávaných zpráv, diskuzí, poraden a rozhovorů a akcí modulu Kalendář akcí)
• Může být použito pole langid (jazyk zpráv).