WebToDate/Fulltext/Začínáme

Veškerá nastavení modulu se provádějí z uživatelského rozhraní systému WebToDate.

Po přihlášení v levém pruhu okna WebToDate (záložka Nabídka) zvolte Moduly – Fulltext.

Ovládací prvky jsou v navigačním stromu seřazeny do 2 podskupin (podobně jako v ostatních modulech WebToDate).

Nástroje

Podskupina Nástroje obsahuje funkce, které umožňují snadnou přípravu některých prvků modulu.

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 – viz dále).

Nastavení

Pomocí této funkce máte možnost pro každou jazykovou verzi ovlivňovat chování a vzhled stránek modulu.

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

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 (viz dále) pro vyhledávání ve více datových zdrojích (zprávách, diskuzích, poradnách, akcích – viz kapitola 4.2. 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í.

Rychlý start

Tato kapitola popisuje sled základních kroků, které vedou k rychlému zprovoznění modulu po instalaci. Popis se týká hledání ve zprávách, pro globální hledání je postup analogický.

Připravte si předlohu pro zobrazování výsledků

V levé nabídce administračního rozhraní WebToDate zvolte záložku Stránky a v ní Předlohy – Fulltext. Zde by již měla být po instalaci připravena jedna předloha s názvem Předloha Fulltextu (pokud předloha pro Fulltext po instalaci neexistuje, vytvořte novou s libovolným názvem). Pomocí tlačítka vlastnosti zobrazte formulář vlastností předlohy a v něm zobrazte soubor definující předlohu (tlačítkem Upravit soubor). Do pole definujícího obsah souboru vložte pomocí schránky následující kód.

<?xml version="1.0" encoding="windows-1250"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="cs" lang="cs">

<head>
  <meta http-equiv="content-Type" content="text/html; charset=windows-1250" />
  <title>Vyhledávání</title>
</head>

<body>
<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>

<!--WTD_FULLTXT(NAVIG)-->
<!--WTD_FULLTXT(LABEL)-->
<!--WTD_FULLTXT(LIST)-->

</body>
</html>

Předlohu uložte tlačítkem Uložit.

Připravte si styl zobrazeného výsledku

V levé nabídce zvolte Vzhled – Styly by již po instalaci měl být připraven styl Výsledky hledání. V těle stylu najdete kód podobný tomuto:

<table>
  <tr>
    <td rowspan="3"><!--WTD_F(NUMBER)-->.</td>
    <td><strong><a href="<!--WTD_F(TITLELINK)-->"><!--WTD_F(TITLE)--></a></strong></td>
  </tr>
  <tr>
    <td ><!--WTD_F(DATE)--></td>
  </tr>
  <tr>
    <td><!--WTD_F(DESCRIPTION)--></td>
  </tr>
</table>

Modifikovaný styl případně uložíte tlačítkem Uložit.

Proveďte nastavení modulu

V levé nabídce zvolte Moduly – Fulltext. Zobrazte formulář Nastavení – čeština – globální – Hledání ve zprávách..

Čeština: Pokud v systému WebToDate používáte pouze jediný jazyk, strom nabídky není podle jazyků diferencován a cesta k položce by tedy byla pouze Nastavení – globální – hledání ve zprávách.

Ve formuláři nastavte:

1. Předlohu, kterou jste si připravili v jednom z předcházejících kroků
2. WebToDate styl Výsledky hledání – ten již máte také připraven.
3. Počet záznamů nastavte na 10, třídění do polohy data sestupně.
4. Zkopírujte a vložte text uvozující výsledky úspěšného hledání:

   Dokumenty <!--WTD_FULLTXT(FROM)--> až <!--WTD_FULLTXT(TO)--> z <!--WTD_FULLTXT(TOTAL)-->:

5. A jiný text pro případ neúspěšného hledání:

Při hledání nebyl nalezen žádný výsledek.

Formulář uložte tlačítkem Uložit.

Zkontrolujte nastavení navigační lišty

Zobrazte formulář Nastavení – čeština – globální – Navigační lišta a zkontrolujte, zda v jednotlivých polích jsou podobné hodnoty jako na následujícím obrázku:

Formulář musíte alespoň jednou uložit bez ohledu na to, zda jste v něm provedli nějaké změny či nikoliv.

Vyzkoušejte funkčnost modulu.

Vyvolejte skript na adrese /scripts/modules/fulltext/fulltxt.php a zkontrolujte jeho funkčnost tak, že do vyhledávacího formuláře, který by měl být právě zobrazen, zadáte libovolný výraz.