WebToDate/Extenze/Extenze pro zvýrazňování výsledků hledání

Funkcionalita

Standardní funkcionalitou modulu Fulltext je zvýrazňování hledaných výrazů v seznamu nalezených zpráv. Pokud je ovšem požadováno, aby byly zvýrazněny i výrazy ve stránce zobrazující celý text zprávy (tj. po klepnutí na nějakou položku v seznamu nalezených zpráv), je již zobrazována stránka prezentačním skriptem pro zprávy, který nemá žádnou souvislost s modulem Fulltext a nemá tuto funkcionalitu k dispozici. Pro tyto účely lze využít tuto extenzi.

Extenze přebírá hledané výrazy z parametru v URL a jednotlivá slova v textu zvýrazní, přičemž v HTML kódu předlohy pro zprávy lze příslušnými značkami vyznačit předem blok HTML kódu, ve kterém bude k tomuto zvýrazňování docházet (např. jen v těle zprávy apod.).

Instalace

Do souboru config/_modules_inc.php vložte následující kód:

// - extenze Highlight
$arrModules[] = 'highlight/_highlightkeywords_inc.php';

Ujistěte se, že v instalaci WebToDate existuje soubor /scripts/modules/highlight/_highlightkeywords_inc.php.

Reference

Extenze načítá z URL při volání skriptu pro zobrazení WebToDate zprávy parametr keyword, takové URL je tedy např.

/scripts/detail.php?id=16077&keyword=policie+and+%E8esk%E1

Extenze odstraní logické spojky a další pomocné výrazy používané modulem Fulltext a následně provede zvýraznění všech hledaných slov tím způsobem, že každé hledané slovo nahradí za kód

<span class="keyword">hledané_slovo</span>

Třídu keyword je tedy třeba definovat v CSS pro zobrazované stránky, aby se zvýrazňování nějak vizuálně projevovalo.

Extenze provádí tuto náhradu pouze v HTML bloku, který je uvozen značkou <!--WTD_HIGHLIGHTKEYWORD_BEGIN--> a ukončen značkou <!--WTD_HIGHLIGHTKEYWORD_END-->. Část kódu předlohy pro zprávy podporující tuto funkci je tedy např.

<h2>
<!--WTD_HIGHLIGHTKEYWORD_BEGIN-->
<!--WTD_F(TITLE)-->
</h2>
<div class="art_content">
<!--WTD_IF(PICNOTNULL,"<!--WTD_F(PIC)-->")-->
<div id="artdesc"><!--WTD_F(DESCRIPTION)--></div>
<div id="artbody"><!--WTD_F(BODY)--></div>
</div>
<!--WTD_HIGHLIGHTKEYWORD_END-->
<p>Vydáno <!--WTD_F(DATE)--></p>

Postup nasazení

Ve WebToDate stylu pro formátování výsledku hledání modulu Fulltext použijte pro zobrazení nadpisu zprávy s odkazem na celý text přibližně následující kód:

<strong><a href="<!--WTD_F(TITLELINK)-->&keyword=<!--WTD_FULLTXT(SEARCHTEXTENC)-->"><!--WTD_F(TITLE)--></a></strong>

V předloze pro zprávy vložte na vhodná místa značky <!--WTD_HIGHLIGHTKEYWORD_BEGIN--> a <!--WTD_HIGHLIGHTKEYWORD_END--> např. tak, jak je uvedeno v předchozí kapitole.