WebToDate/Výpisy zpráv/Reference - Historie editací

Jardac: /* Klíčová slova modulu */

2011-03-24T07:32:23Z

Klíčová slova modulu

← Starší verze		Verze z 24. 3. 2011, 09:32
Řádek 358:		Řádek 358:


	V hlavičce a patičce stylu lze použít následující klíčová slova.		V hlavičce a patičce stylu a předloze lze použít následující klíčová slova.

	{\| class="prettytable"		{\| class="prettytable"
Řádek 371:		Řádek 371:
	\| <nowiki><!--WTD_F(CATEGORY)--></nowiki>		\| <nowiki><!--WTD_F(CATEGORY)--></nowiki>
	\| Lokalizovaný název kategorie		\| Lokalizovaný název kategorie
			\|

			\|-
			\| <nowiki><!--WTD_F(CATEGORYID)--></nowiki>
			\| ID kategorie
	\|		\|

Jardac: /* Klíčová slova pro formátování */

2009-10-21T11:14:53Z

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

← Starší verze		Verze z 21. 10. 2009, 13:14
Řádek 401:		Řádek 401:
	<nowiki><!--WTD_IF(CATEGORYNULL,"Články ze všech kategorií")--></nowiki>		<nowiki><!--WTD_IF(CATEGORYNULL,"Články ze všech kategorií")--></nowiki>
	</code>		</code>

			Modul dále podporuje [[../../Referenční/Klíčová slova WebToDate#Klíčová slova pro formátování\|Klíčová slova pro formátování]] typu WTD_FORMAT, tedy např.

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

			apod.

Jardac: Nahrazení textu „[[Category:WebToDate 4.1“ textem „[[Category:WebToDate“

2009-10-13T12:45:01Z

Nahrazení textu „[[Category:WebToDate 4.1“ textem „[[Category:WebToDate“

← Starší verze		Verze z 13. 10. 2009, 14:45
Řádek 1:		Řádek 1:
	[[Category:WebToDate ~~4.1~~ Výpisy zpráv]]		[[Category:WebToDate Výpisy zpráv]]
	[[Category:Výpisy zpráv]]		[[Category:Výpisy zpráv]]
	== Administrační rozhraní ==		== Administrační rozhraní ==

Jardac: Stránka WebToDate 4.1/Výpisy zpráv/Reference přemístěna na stránku WebToDate/Výpisy zpráv/Reference

2009-10-13T12:39:06Z

Stránka WebToDate 4.1/Výpisy zpráv/Reference přemístěna na stránku WebToDate/Výpisy zpráv/Reference

← Starší verze	Verze z 13. 10. 2009, 14:39
(Žádný rozdíl)

Bajkvl: /* Navigační lišta */

2009-08-14T12:22:22Z

Navigační lišta

← Starší verze		Verze z 14. 8. 2009, 14:22
Řádek 43:		Řádek 43:
	# '''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.		# '''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><!--WTD_NAVIG(URL)--> a <!--WTD_NAVIG(NUMBER)--></nowiki>.		Pro správnou funkci navigační lišty je nutné do výše popsaných polí zadávat i klíčová slova
			<nowiki><!--WTD_NAVIG(URL)--> a <!--WTD_NAVIG(NUMBER)--></nowiki>.

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

Bajkvl: /* Nastavení */

2009-08-14T12:21:06Z

Nastavení

← Starší verze		Verze z 14. 8. 2009, 14:21
Řádek 17:		Řádek 17:

	=== Nastavení ===		=== Nastavení ===
			====Výpis====
	Formulář '''Výpis''' definuje základní grafickou podobu zobrazování stránky s výpisy zpráv. Definují se zde následující položky:		Formulář '''Výpis''' definuje základní grafickou podobu zobrazování stránky s výpisy zpráv. Definují se zde následující položky:

Řádek 27:		Řádek 27:


			====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í seznamů položek.		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.

Bajkvl v 14. 8. 2009, 12:20

2009-08-14T12:20:25Z

← Starší verze		Verze z 14. 8. 2009, 14:20
Řádek 30:		Řádek 30:
	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.		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:~~image005~~.~~jpg~~\|center]]		[[Image:vypisyzprav-reference-img005.png\|center]]

	Grafický vzhled jednotlivých prvků navigační lišty se definuje pomocí následujících polí:		Grafický vzhled jednotlivých prvků navigační lišty se definuje pomocí následujících polí:
Řádek 47:		Řádek 47:
	Jejich použití je zřejmé z následujícího jednoduchého příkladu:		Jejich použití je zřejmé z následujícího jednoduchého příkladu:

	[[Image:~~image006~~.~~jpg~~\|center]]		[[Image:vypisyzprav-reference-img006.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>		<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>

Bajkvl: Založena nová stránka: Category:WebToDate 4.1 Výpisy zpráv Category:Výpisy zpráv == Administrační rozhraní == === Nabídka modulu === Nabídka modulu je jednoduchá, vypadá násl…

2009-07-29T12:42:19Z

Založena nová stránka: Category:WebToDate 4.1 Výpisy zpráv Category:Výpisy zpráv == Administrační rozhraní == === Nabídka modulu === Nabídka modulu je jednoduchá, vypadá násl…

Nová stránka

[[Category:WebToDate 4.1 Výpisy zpráv]]
[[Category:Výpisy zpráv]]
== Administrační rozhraní ==
=== Nabídka modulu ===

Nabídka modulu je jednoduchá, vypadá následovně:

'''Nastavení'''

:Globální

::Výpis

::Navigační lišta

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

=== Nastavení ===

Formulář '''Výpis''' definuje základní grafickou podobu zobrazování stránky s výpisy zpráv. Definují se zde následující položky:

* '''Předloha''' – vyberte výchozí předlohu pro stránku s výpisy
* '''Styl seznamu pro zobrazování výsledků''' – vyberte výchozí styl pro seznam zpráv ve výpisech včetně počtu záznamů na stránku
* '''Uvozující nadpis výpisu''' – obsahuje dvě pole, obsah prvního pole se použije, pokud zadaná kritéria při zobrazení výpisu znamenají výběr alespoň jedné zprávy, obsah druhého pole se použije v případě, že kritériu neodpovídá žádná publikovaná zpráva.

Všechny položky formuláře je třeba vyplnit a formulář uložit, jinak nebude skript pro zobrazování výpisů funkč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:image005.jpg|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> a </nowiki>.

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

[[Image:image006.jpg|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>

== Veřejné skripty ==
=== Prezentační skript a jeho možné parametry ===

Modul má jediný prezentační skript na adrese ''/scripts/modules/column/default.php''. Z URL tohoto skriptu se zadávají podmínky pro zobrazení zpráv. Pokud je skript volán bez dalších parametrů, zobrazuje všechny publikované zprávy setříděné od nejnovějších k nejstarším. Přehled možných parametrů je v následující tabulce.

{| class="prettytable"
| '''Parametr'''
| '''Význam'''

|-
| publid
| ID publikace

|-
| categid
| ID kategorie

|-
| groupid
| ID tématu

|-
| keyword
| Klíčové slovo (textový řetězec)

|-
| tmplid
| ID předlohy

|-
| lid, locale, dlid, dlocale
| Jazykové parametry (lid = ID jazyka, locale = zkratka jazyka apod.)

|-
| section
| Název rubriky (jako textový řetězec)

|-
| order
| Způsob třídění, možné hodnoty jsou ''date'' (podle datumu a času sestupně) a ''impress'' (podle počtu shlédnutí sestupně); pokud není parametr uveden nebo neodpovídá žádné z hodnot, použije se výchozí třídění podle datumu a času sestupně

|-
| dayfrom, monthfrom, yearfrom
| Zadání počátku omezujícího časového intervalu (vždy celé číslo)

|-
| dayto, monthto,yearto
| Zadání konce omezujícího časového intervalu (vždy celé číslo)

|-
| from, to
| Omezení zadaná datumem, datum se zadává v českém formátu, tedy např. 15.12.2004.

|-
| styleid
| ID WebToDate stylu formátujícího seznam

|}

Zadané podmínky se spojují logickou spojkou "a zároveň". Pokud tedy např. sestavíme URL

''/scripts/modules/column/default.php?categid=34&keyword=internet''

vypíší se zprávy z kategorie s ID=34 obsahující zároveň klíčové slovo "internet".

Pro časová kritéria platí následující:

* Hodnota nula vyjadřuje dnešní den, dále mají smysl záporná čísla udávající kolik dnů (měsíců, roků) nazpět zprávy hledat
* Hodnoty "from" a "to" se mohou vzájemně logicky vylučovat, proto v případě, že se v URL vyskytuje víc parametrů stejného typu, přednost má jemnější kritérium, tedy měsíc před rokem, den před měsícem apod.
* Pokud je uveden parametr ''from'' nebo ''to'' a zadaný formát data v tomto parametru je validní, má přednost před všemi ostatními parametry daného typu omezení; tedy ''from'' má přednost před ''dayfrom'' a ''dayfrom'' se ignoruje.
* Pokud hodnota některého z těchto parametrů není celé nekladné číslo, parametr se ignoruje.
* Lze uvést jednu nebo dvě omezující podmínky, např. jen spodní hranici, druhé omezení intervalu se automaticky chápe jako bez omezení.

Příklady použití časových omezujících kritérií jsou uvedeny v následující tabulce.

{| class="prettytable"
| '''Podmínka'''
| '''Omezení zespoda'''
| '''Omezení seshora'''

|-
| Poslední rok
| dayfrom=-365
|

|-
| Poslední tři dny (= předvčerejšek, včerejšek a dnešek)
| dayfrom=-2
|

|-
| Poslední týden
| dayfrom=-6
|

|-
| Poslední měsíc
| monthfrom=-1
|

|-
| Dnešní
| dayfrom=0
|

|-
| Včerejší
| dayfrom=-1
| dayto=-1

|-
| Předvčerejší
| dayfrom=-2
| dayto=-2

|-
| Před týdnem
| dayfrom=-7
| dayto=-7

|-
| Před měsícem
| monthfrom=-1
| monthto=-1

|-
| Před rokem
| yearfrom=-1
| yearto=-1

|}

I když krabicové moduly WebToDate podobného charakteru zpravidla nepodporují možnost vynutit z URL styl, je to v tomto případě potřebné, protože jeden skript je možné použít jak na výpisy zpráv určité charakteristiky podle času, tak na výpisy čtenosti, což jsou poměrně rozdílné věci – v prvním případě se čtenost nezahrnuje do interně vytvářených SQL dotazů ani nezobrazuje, v druhém případě se zahrnuje a zobrazuje. Proto je v URL podporován parametr ''styleid'', kterým lze vynutit vybraný styl seznamu zpráv. Pokud styl se zadaným ID není nalezen, není to považováno za chybu a použije se výchozí styl zvolený v nastaveních modulu.

=== Klíčová slova modulu ===

Následující klíčová slova se používají v předloze pro umístění objektů vkládaných do stránky modulem.

{| class="prettytable"
| colspan="3" | Klíčová slova použitelná v předloze – dynamické objekty ve stránce

|-
| '''Klíčové slovo'''
| '''Význam'''
| '''Poznámka'''

|-
| <nowiki></nowiki>
| Seznam zpráv
| Reprezentuje seznam nalezených zpráv

|-
| <nowiki></nowiki>
| Navigační lišta
| Reprezentuje místo, kam se vloží navigační lišta

|-
| <nowiki></nowiki>
| Výpis výsledků
| Reprezentuje uvozující nadpis výpisu výsledků (např. "Dokument 1 až 10 z 50")

|}

Následující klíčová slova použijte ve formuláři '''Nastavení''' – '''Globální''' – '''Výpis''' v poli '''Úspěšné hledání'''.

{| class="prettytable"
| colspan="3" | 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'''

|-
| <nowiki></nowiki>
| Počet od
| Počáteční pořadové číslo záznamu na stránce v seznamu nalezených

|-
| <nowiki></nowiki>
| Počet do
| Koncové pořadové číslo záznamu na stránce v seznamu nalezených

|-
| <nowiki></nowiki>
| Počet celkem
| Počet nalezených záznamů celkem

|}

Následující klíčová slova použijte ve formuláři '''Nastavení''' – '''Globální''' – '''Navigační lišta'''.

{| class="prettytable"
| colspan="3" | Klíčová slova použitelná v definici navigační lišty

|-
| '''Klíčové slovo'''
| '''Význam'''
| '''Poznámka'''

|-
| <nowiki></nowiki>
| Odkaz
| Klíčové slovo je nahrazováno za odkaz na určitou stránku v rámci stránkování seznamu

|-
| <nowiki></nowiki>
| Číslo stránky
| Klíčové slovo je nahrazováno za pořadové číslo určité stránky v rámci stránkování seznamu

|}

Následující klíčová slova můžete použít v těle stylu pro seznam zpráv. Kromě klíčových slov <nowiki> a </nowiki> se tato klíčová slova shodují s klíčovými slovy použitelnými ve WebToDate pro zprávy či seznamy zpráv.

{| class="prettytable"
| colspan="3" | Klíčová slova použitelná v těle stylu nalezených výsledků

|-
| '''Klíčové slovo'''
| '''Význam'''
| '''Poznámka'''

|-
| <nowiki></nowiki>
| Číslování řádků
|

|-
| <nowiki></nowiki>
| Počet shlédnutí
|

|-
| <nowiki></nowiki>
| ID zprávy
|

|-
| <nowiki></nowiki>
| Nadpis
|

|-
| <nowiki></nowiki>
| Odkaz nadpisu
|

|-
| <nowiki></nowiki>
| Popis
|

|-
| <nowiki></nowiki>
| Datum zprávy
|

|-
| <nowiki></nowiki>
| Číslo kategorie
|

|-
| <nowiki></nowiki>
| Název kategorie
|

|-
| <nowiki></nowiki>
| Obrázek
|

|-
| <nowiki></nowiki>
| Alt. obrázek
|

|-
| <nowiki></nowiki>
| ID jazyka
|

|-
| <nowiki></nowiki>
| Název jazyka
|

|-
| <nowiki></nowiki>
| 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.

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 zpráv ve výpisu použít klíčové slovo <nowiki></nowiki> a obrázek se zobrazí stejně jako v seznamech zpráv WebToDate.

V hlavičce a patičce stylu lze použít následující klíčová slova.

{| class="prettytable"
| colspan="3" | Klíčová slova použitelná v hlavičce či patičce stylu nalezených výsledků

|-
| '''Klíčové slovo'''
| '''Význam'''
| '''Poznámka'''

|-
| <nowiki></nowiki>
| Lokalizovaný název kategorie
|

|-
| <nowiki></nowiki>
| Název publikace
|

|-
| <nowiki></nowiki>
| Název tématu
|

|-
| <nowiki></nowiki>
| Klíčové slovo
|

|-
| <nowiki></nowiki>
| Název rubriky
|

|}

Dané klíčové slovo se nahrazuje obsahem pouze v případě, že je daná položka součástí kritéria zadaného z URL. Podporováno je i zde podmíněné vkládání ve všech těchto případech pomocí syntaxe NULL a NOTNULL, např.:

<code>
<nowiki>")--></nowiki>
<nowiki></nowiki>
</code>