Atomz — jak si upravit vzhled výsledných stránek

V minulém čísle jsem vám v článku Atomz — fulltextový vyhledávač pro vaše stránky představil fulltextový vyhledávač Atomz. Ukázal jsem vám, jak si založit účet, jak ho nakonfigurovat a jak vložit základní verzi vyhledávače na vaše stránky. Dnes vás naučím, jak ovlivnit vzhled výsledků vyhledávání tak, aby co nejlépe s vašimi stránkami ladily.

Pro co nejtěsnější integraci vyhledávání do vašich stránek nabízí Atomz mechanismus šablon. Celá práce vlastně spočívá v tom, že si šablonu a tu pak uložíte v databázi Atomz. Od toho okamžiku bude Atomz tuto šablonu používat pro zobrazování výsledků hledání pro vaše stránky.

Zde je postup vytvoření šablony:

1. Ve vašem oblíbeném editoru vytvořte stránku, která bude vypadat tak, jak chcete, aby vypadala vaše stránka s výsledky vyhledávání. Připravte její záhlaví, zápatí, okrajové sloupce, atd. Jenom část určenou pro vlastní výsledky vyhledávání a s nimi spojenou navigaci ponechejte prázdnou.

2. Pokud v html kódu stránky máte obrázky či odkazy na jiné externí soubory (styly, skripty, odkazy na jiné stránky, atd.), ujistěte se, že jsou identifikovány absolutní adresou, včetně http://. Pokud ne, změňte to, nebo použijte v hlavičce (head) dokumentu značku base (např. <base href="http://www.sovavsiti.cz/">).

3. Nyní si kursorem najeďte do místa, kde chcete zobrazovat výsledky vyhledávání. Asi to bude buňka tabulky, nebo prvek div. Sem budete vkládat zvláštní značky vyhledávače dle následujících bodů.

4. Začněte nadpisem stránky, např. takto:

   <div style="float:right;">
  <SEARCH-LOGO>
</div>
<h1>Výsledky hledání</h1>
<SEARCH-IF-RESULTS>
<p>Na dotaz <em><SEARCH-QUERY></em> nalezeno <SEARCH-TOTAL> stránek. Zobrazena stránka <SEARCH-LOWER> až <SEARCH-UPPER>.</p>
</SEARCH-IF-RESULTS>
<SEARCH-IF-NOT-RESULTS>
<p>Nenalezena žádná stránka obsahující <em><SEARCH-QUERY></em>.</p>
</SEARCH-IF-NOT-RESULTS>

   Část uzavřená ve značce <SEARCH-IF-RESULTS> se zobrazí pouze tehdy, bylo-li něco nalezeno, naopak část ve značce <SEARCH-IF-NOT-RESULTS> jen tehdy, nenalezne-li Atomz nic. Značka <SEARCH-QUERY> obsahuje text dotazu (hledané slovo, či frázi), značka <SEARCH-TOTAL> celkový počet nalezených stránek a značky <SEARCH-LOWER> a <SEARCH-UPPER> první a poslední zobrazenou stránku na dané stránce výsledků.

   Ostatní je váš libovolný text a běžné formátování. Nezapomeňte též někde umístit logo Atomz (značka <SEARCH-LOGO>), neboť to je v bezplatné verzi vaše povinnost.

5. Nyní pokračujte vlastními výsledky vyhledávání. Např. takto zobrazíte pro každou nalezenou stránku její titulek (prvek title) jako odkaz, popis stránky (obsah metatagu description), kontext (část textu, ve kterém byl hledaný text nalezen) a URL nalezené stránky:

   <SEARCH-RESULTS LENGTH=160>
<strong><SEARCH-LINK> <SEARCH-TITLE LENGTH=160></SEARCH-LINK> </strong><br>
<SEARCH-IF-SHOW-SUMMARIES>
<div style="font-size:smaller;">
  <SEARCH-IF-CONTEXT LENGTH=240><SEARCH-CONTEXT>
  <br>
  </SEARCH-IF-CONTEXT>
  <SEARCH-URL LENGTH=60>
</div>
</SEARCH-IF-SHOW-SUMMARIES>
</SEARCH-RESULTS>

6. Dále můžete pod výsledky vyhledávání vložit menu odkazů, kterými lze měnit třídění výpisu a zkrýt, respekteve znovu zobrazit detaily (popis stránky, kontext, resp cokoli ve značce <SEARCH-IF-SHOW-SUMMARIES> uvedené výše).

   <SEARCH-IF-RESULTS>
<SEARCH-IF-SORT-BY-DATE>
<SEARCH-SORT-BY-SCORE COUNT=10>
  Seřaď dle relevance
</SEARCH-SORT-BY-SCORE>
</SEARCH-IF-SORT-BY-DATE>
<SEARCH-IF-SORT-BY-SCORE>
<SEARCH-SORT-BY-DATE COUNT=10>
  Seřaď dle data
</SEARCH-SORT-BY-DATE>
</SEARCH-IF-SORT-BY-SCORE>
  |
<SEARCH-IF-SHOW-SUMMARIES>
<SEARCH-HIDE-SUMMARIES COUNT=20>
  Skryj detaily
</SEARCH-HIDE-SUMMARIES>
</SEARCH-IF-SHOW-SUMMARIES>
<SEARCH-IF-HIDE-SUMMARIES>
<SEARCH-SHOW-SUMMARIES COUNT=10>
  Zobraz detaily
</SEARCH-SHOW-SUMMARIES>
</SEARCH-IF-HIDE-SUMMARIES>
<br>
</SEARCH-IF-RESULTS>

7. Nutné jsou odkazy pro navigaci mezi stránkami, pokud je výsledků více. Ty vložíte do šablony takto:

   <SEARCH-IF-RESULTS>
<SEARCH-IF-PREV-COUNT>
<SEARCH-PREV>
  Předchozích <SEARCH-PREV-COUNT>
</SEARCH-PREV>
<SEARCH-IF-NEXT-COUNT>
  |
</SEARCH-IF-NEXT-COUNT>
</SEARCH-IF-PREV-COUNT>
<SEARCH-IF-NEXT-COUNT>
<SEARCH-NEXT>
  Následujících <SEARCH-NEXT-COUNT>
</SEARCH-NEXT>
</SEARCH-IF-NEXT-COUNT>
</SEARCH-IF-RESULTS>

8. Nakonec zbývá formulář pro případné opakování hledání:

   <form method="get" action="http://search.atomz.com/search/">
  <SEARCH-IF-NOT-ADVANCED>
  <SEARCH-INPUT-ACCOUNT>
  <SEARCH-INPUT-GALLERY>
  <SEARCH-INPUT-QUERY SIZE=25>
  <input type=submit value="Hledej znovu">
  <SEARCH-IF-INPUT-COLLECTIONS>
  <SEARCH-INPUT-COLLECTIONS>
  </SEARCH-IF-INPUT-COLLECTIONS>
  </SEARCH-IF-NOT-ADVANCED>
</form>

Jakmile máte šablonu hotovou, otevřete stránku Atomz na www.atomz.com a přihlaste se emailovou adresu a heslem, které jste zadali při registraci. Po přihlášení klikněte na Templates (šablony) v menu vlevo a posléze na Template Editor (editor šablon).

Svou připravenou šablonu zkopírujte a vlepte do připraveného editačního pole (nebojte se přepsat to, co je v něm připraveno a otestujte. To provedete kliknutím na záložku Test nahoře. Nebojte se, výsledek nyní vidíte jen vy sami. Vaši návštěvníci mají zatím k dispozici původní podobu výsledné stránky.

Jste-li s výsledkem testu spokojeni, klikněte na tlačítko Publish Changes a váš nový vyhledávač je hotov.

Na závěr ještě doplním, že Atomz umí indexovat i soubory ve formátu PDF. Připomněl mi to čtenář Stanislav Holeček, kterému tímto děkuji.