WebToDate/Fulltext Google/Reference - Historie editací

Jardac: /* Metatagy stránek a extenze modulu */

2011-06-07T16:12:06Z

Metatagy stránek a extenze modulu

← Starší verze		Verze z 7. 6. 2011, 18:12
Řádek 530:		Řádek 530:
	Je třeba poznamenat, že názvy metatagů nejsou pevné a korespondují s nastavením v předvolbách modulu:		Je třeba poznamenat, že názvy metatagů nejsou pevné a korespondují s nastavením v předvolbách modulu:

	[[Image:fg-predvolby2.~~pnh~~\|center]]		[[Image:fg-predvolby2.png\|center]]

	V předloze pro zprávy lze tento blok vložit následujícím kódem:		V předloze pro zprávy lze tento blok vložit následujícím kódem:

Jardac: /* Nastavení */

2011-06-07T16:09:15Z

Nastavení

← Starší verze		Verze z 7. 6. 2011, 18:09
Řádek 47:		Řádek 47:
	V předloze se výpis nalezených položek dosazuje za klíčové slovo <nowiki><!--WTD_FULLTXT(LIST)--></nowiki>, uvozující nadpis za klíčové slovo <nowiki><!--WTD_FULLTXT(LABEL)--></nowiki>. V definici uvozujícího nadpisu lze použít klíčová slova <nowiki><!--WTD_FULLTXT(FROM)--></nowiki>, <nowiki><!--WTD_FULLTXT(TO)--></nowiki> a <nowiki><!--WTD_FULLTXT(TOTAL)--></nowiki>.		V předloze se výpis nalezených položek dosazuje za klíčové slovo <nowiki><!--WTD_FULLTXT(LIST)--></nowiki>, uvozující nadpis za klíčové slovo <nowiki><!--WTD_FULLTXT(LABEL)--></nowiki>. V definici uvozujícího nadpisu lze použít klíčová slova <nowiki><!--WTD_FULLTXT(FROM)--></nowiki>, <nowiki><!--WTD_FULLTXT(TO)--></nowiki> a <nowiki><!--WTD_FULLTXT(TOTAL)--></nowiki>.

	Více o volbě formátování výsledků hledání pomocí stylu či transformace se dozvíte v kapitole [[../Tipy a ~~Návody~~#Volba způsobu formátování výsledků hledání\|Volba způsobu formátování výsledků hledání]].		Více o volbě formátování výsledků hledání pomocí stylu či transformace se dozvíte v kapitole [[../Tipy a návody#Volba způsobu formátování výsledků hledání\|Volba způsobu formátování výsledků hledání]].

Jardac v 7. 6. 2011, 15:50

2011-06-07T15:50:02Z

← Starší verze		Verze z 7. 6. 2011, 17:50
Řádek 412:		Řádek 412:
	</div></nowiki>		</div></nowiki>
	</code>		</code>

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

			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 vyhledávacího skriptu

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

			\|-
			\| searchtext
			\| Textová vyhledávací podmínka
			\|

			\|-
			\| sort
			\| Způsob třídění
			\| Ve formuláři se používají hodnoty ''rank'' a ''date'', nicméně pokud je hodnotou parametru cokoliv jiného než ''date'' (včetně prázdné hodnoty), třídí se podle relevance

			\|-
			\| scope
			\| Kde se prohledává
			\| Ve formuláři jsou používané hodnoty ''full'' a ''news'', nicméně pokud je hodnotou něco jiného než ''news'', prohledává se celý web.

			\|-
			\| langid
			\| ID jazyka
			\|

			\|-
			\| publid
			\| ID publikace
			\|

			\|-
			\| categid
			\| ID kategorie
			\|

			\|-
			\| datefrom
			\| Datum od
			\|

			\|-
			\| dateto
			\| Datum do
			\|

			\|-
			\| gp
			\| Dodatečné parametry Google
			\|

			\|-
			\| pg
			\| Číslo stránky v rámci stránkování
			\|

			\|-
			\| tmplid
			\| Vynucené ID předlohy
			\|


			\|-
			\| lid
			\| ID jazyka pro nastavení
			\|

			\|-
			\| locale
			\| Zkratka jazyka pro nastavení
			\|


			\|-
			\| showxml
			\| Ladící parametr
			\| Pokud se uvede hodnota ''on'', vloží se na začátek stránky XML kód vrácený Google bez jakékoli modifikace

			\|}

			Parametr ''gp'' lze nepovinně použít pro předání dalších parametrů do Google z vyhledávacího formuláře. Zde zadané parametry se nijak neinterpretují a posílají se do Google jsou součást URL, pouze je třeba zajistit správný URL encoding. Význam je podobný jako u předvolby modulu '''Povinné parametry v URL''', zde jde ale o nastavení parametrů na úrovni formuláře a nikoli celého modulu (uživatel WebToDate může vytvořit několik různých formulářů a použít je v různých stránkách webu). Možné použití je např.:

			<code>
			<nowiki><input type="hidden" name="gp" value="partialfields=mujmeta:hodnota"></nowiki>
			</code>

			což zajistí, že se bude z daného formuláře hledat pouze ve stránkách, které obsahují zadanou část hodnoty zvoleného metatagu (se kterým tento modul předem nijak nepočítá).

			<div class="note">Poznámka: Vzhledem ke způsobu předávání parametrů službě Site Search není možno ve vyhledávacím formuláři v režimu modulu Site Search použít zároveň možnost zvolit třídění a zároveň volit hledání přes celý web / pouze ve zprávách; je třeba zvolit jen jednu z těchto možností.</div>

			=== Metatagy stránek a extenze modulu ===

			Při indexaci si vyhledávací stroj Google sám detekuje určitá metadata, jako je např. jazyk stránky nebo datum poslední modifikace. Pomocí metatagů ve stránkách lze některé tyto údaje upřesnit, jiné přidat jako nové – konkrétně zde jde speciálně o prohledávání zpráv a možnost hledat podle publikace či kategorie.

			Kompletní sada metatagů v HTML hlavičce stránky se zprávou může vypadat následovně:

			<code>
			<nowiki><meta name="author" content="Jan Michlík" />
			<meta name="wtd-publid" content="2" />
			<meta name="wtd-categid" content="4" />
			<meta name="wtd-categid" content="11" />
			<meta name="last-modified" content="2007-06-14" />
			<meta http-equiv="Content-language" content="CS" />
			<title>MP3.com se vrací na internet s tvorbou nezávislých umělců</title></nowiki>
			</code>

			Je třeba poznamenat, že názvy metatagů nejsou pevné a korespondují s nastavením v předvolbách modulu:

			[[Image:fg-predvolby2.pnh\|center]]

			V předloze pro zprávy lze tento blok vložit následujícím kódem:

			<code>
			<nowiki><meta name="author" content="<!--WTD_F(SOURCE)-->" />
			<meta name="wtd-publid" content="<!--WTD_F(PUBLID)-->" />
			<!--WTD_F(META_CATEGID)-->
			<meta name="last-modified" content="<!--WTD_FORMAT(DATE,"Y-m-d","<!--WTD_F(DATEACT)-->")-->" />
			<meta http-equiv="Content-language" content="<!--WTD_F(LANGUAGEABBREV)-->" />
			<title><!--WTD_F(TITLE)--></title></nowiki>
			</code>

			Všechny uvedené konstrukce jsou standardními funkcemi WebToDate kromě seznamu ID kategorií, ve kterých se zpráva nachází. Vložení seznamu ID kategorií realizuje extenze modulu ''<nowiki>/scripts/modules/fg/_fgdetail_inc.php</nowiki>''. Extenze pracuje s klíčovým slovem <nowiki><!--WTD_F(META_CATEGID)--></nowiki>, za který ve stránce s celým textem zprávy dosadí seznam ID kategorií ve tvaru

			<code>
			<nowiki><meta name="wtd-categid" content="4" />
			<meta name="wtd-categid" content="11" /></nowiki>
			</code>

			kde název metatagu se načítá z předvoleb modulu.

Jardac v 7. 6. 2011, 15:40

2011-06-07T15:40:34Z

Ukázat změny

Jardac: Založena nová stránka: Category:WebToDate Fulltext Google Category:Fulltext == Administrační rozhraní == === Nabídka modulu === Nabídka modulu vypadá následovně: '''Nástroje'…

2011-06-07T15:13:57Z

Založena nová stránka: Category:WebToDate Fulltext Google Category:Fulltext == Administrační rozhraní == === Nabídka modulu === Nabídka modulu vypadá následovně: '''Nástroje'…

Nová stránka

[[Category:WebToDate Fulltext Google]]
[[Category:Fulltext]]

== Administrační rozhraní ==

=== Nabídka modulu ===

Nabídka modulu vypadá následovně:

'''Nástroje'''

:Vyhledávací formulář

'''Nastavení'''

:Globální

::Vyhledávací stránka

::Navigační lišta

'''Administrace'''

:Předvolby

K administrační části modulu mají přístup pouze administrátoři WebToDate.

=== Nástroje ===

Funkce '''Nástroje''' obsahuje funkci pro vygenerování výchozího HTML kódu vyhledávacího formuláře a jeho uložení do těla nově založeného fragmentu. Volí se kategorie, publikace a jazyk fragmentu.

=== Nastavení ===

Funkce '''Vyhledávací stránka''' slouží k nastavení vyhledávací stránky, tj. její předlohy, způsobu formátování výsledků hledání apod. Samotná vyhledávací stránka se pak v prezentační části zobrazuje na adrese ''<nowiki>/scripts/modules/fg/fulltxt.php</nowiki>''.

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

* '''Předloha''' – vybírá se předloha vyhledávací stránky
* '''Formátování '''– volí se možnost formátovat výsledky hledání pomocí WebToDate stylu nebo XSLT transformace
* '''WebToDate styl''' – pokud je nastaveno ''použít WebToDate styl'', aplikuje se na výsledky hledání styl zvolený v této rozevírací nabídce
* '''Transformace''' – pokud je nastaveno použít transformaci, aplikuje se na výsledky hledání XSLT transformace zvolená v této rozevírací nabídce (ukládá se do databáze transformací WebToDate)
* '''Počet záznamů / str'''. – definuje stránkování, tj. kolik položek se na každé stránce výpisu nalezených zobrazuje
* '''Uvozující nadpis výpisu''' odlišuje případy, kdy byla nalezena alespoň jedna položka a kdy nebyla nalezena žádná položka.

[[Image:fg-nastaveni-stranky.png|center]]

V předloze se výpis nalezených položek dosazuje za klíčové slovo <nowiki></nowiki>, uvozující nadpis za klíčové slovo <nowiki></nowiki>. V definici uvozujícího nadpisu lze použít klíčová slova <nowiki></nowiki>, <nowiki></nowiki> a <nowiki></nowiki>.

Více o volbě formátování výsledků hledání pomocí stylu či transformace se dozvíte v kapitole [[../Tipy a Návody#Volba způsobu formátování výsledků hledání|Volba způsobu formátování výsledků hledání]].

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:diskuze35-navigacni-lista.gif|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></nowiki> a <nowiki></nowiki>.

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

[[Image:fg-navigacni-lista.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 reprezentována klíčovým slovem <nowiki></nowiki>.

=== Administrace ===

Pomocí formuláře '''Předvolby''' se nastavují základní parametry napojení na vyhledávací stroj a další možnosti.

[[Image:fg-predvolby.png|center]]

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

* '''Vyhledávací stroj''' – volí se Google Mini či Google Site Search podle použitého vyhledávacího stroje
* '''URL serveru Google''' – zadává se vyhledávací adresa Google Mini (tedy např. ''<nowiki>http://gm.mujserver.cz</nowiki>'') nebo ''<nowiki>http://www.google.com</nowiki>'' pro vyhledávání přes službu Site Search
* '''Povinné parametry v URL''' – interně propojení modulu s vyhledávacím strojem pracuje tak, že při zpracování vyhledávacího formuláře odesílá pomocí http GET požadavek na výsledky hledání, kde celé volání obsahuje všechny zřetězené parametry (např. textovou vyhledávací podmínku, omezení na čas apod.). V tomto poli předvoleb lze uvést parametry, které se odesílají tímto způsobem vždy nezávisle na vyplnění vyhledávacího formuláře uživatelem. Přitom některé parametry jsou z hlediska vyhledávacího stroje povinné. Pro Google Mini se jedná o parametry ''site'' a ''client'' (zde musí být hodnota ''default_frontend''), pro Site Search to jsou parametry ''cx'' (ID vyhledávače) a ''client'' (musí být hodnota ''google-csbe''). Lze zde ale uvést i další parametry dle příslušné dokumentace, např. uvedením ''filter=0'' se specifikuje, že se nemá provádět automatická filtrace (tj. zamezení prezentace duplicitního obsahu na různých URL).
* '''Timeout ve vteřinách pro spojení se serverem''' – definuje počet sekund, po které prezentační skript čeká na odezvu vyhledávacího stroje a navrácení výsledků hledání

Druhá část formuláře předvoleb definuje názvy metatagů stránek, které se mohou a nemusí používat pro vyznačení dalších informací o indexované stránce z hlediska metadat WebToDate. Jedná se např. o zařazení do stromu kategorií, ID publikace, čas poslední modifikace apod. Více viz [[#Metatagy stránek a extenze modulu|Metatagy stránek]].