WebToDate/Stránkování zpráv/Reference - Historie editací

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

2009-10-13T12:44:56Z

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

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

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

2009-10-13T12:39:05Z

Stránka WebToDate 4.1/Stránkování zpráv/Reference přemístěna na stránku WebToDate/Stránkování zpráv/Reference

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

Bajkvl: /* Integrace s WYSIWYG editorem */

2009-08-14T09:44:12Z

Integrace s WYSIWYG editorem

← Starší verze		Verze z 14. 8. 2009, 11:44
Řádek 199:		Řádek 199:
	Po potvrzení tlačítkem OK se na pozici kurzoru vloží vybraná značka.		Po potvrzení tlačítkem OK se na pozici kurzoru vloží vybraná značka.

	Zobrazení těla zprávy z příkladu v kapitole [[../Začínáme#První zobrazení stránkované zprávy\|První zobrazení stránkované zprávy]]vypadá následovně:		Zobrazení těla zprávy z příkladu v kapitole [[../Začínáme#První zobrazení stránkované zprávy\|První zobrazení stránkované zprávy]] vypadá následovně:

	[[Image:strankovanizprav-reference-img009.png\|center]]		[[Image:strankovanizprav-reference-img009.png\|center]]

Bajkvl: /* Integrace s WYSIWYG editorem */

2009-08-14T09:43:36Z

Integrace s WYSIWYG editorem

← Starší verze		Verze z 14. 8. 2009, 11:43
Řádek 199:		Řádek 199:
	Po potvrzení tlačítkem OK se na pozici kurzoru vloží vybraná značka.		Po potvrzení tlačítkem OK se na pozici kurzoru vloží vybraná značka.

	Zobrazení těla zprávy z příkladu v kapitole [ První zobrazení stránkované zprávy ]vypadá následovně:		Zobrazení těla zprávy z příkladu v kapitole [[../Začínáme#První zobrazení stránkované zprávy\|První zobrazení stránkované zprávy]]vypadá následovně:

	[[Image:strankovanizprav-reference-img009.png\|center]]		[[Image:strankovanizprav-reference-img009.png\|center]]

Bajkvl: /* Stránkování kapitol */

2009-08-14T09:42:24Z

Stránkování kapitol

← Starší verze		Verze z 14. 8. 2009, 11:42
Řádek 31:		Řádek 31:
	# '''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> a případně další slova vypsaná v kapitole [ Klíčová slova modulu].		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> a případně další slova vypsaná v kapitole [[../Reference#Klíčová slova modulu\|Klíčová slova modulu]].

	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: /* Stránkování kapitol */

2009-08-14T08:59:20Z

Stránkování kapitol

← Starší verze		Verze z 14. 8. 2009, 10:59
Řádek 31:		Řádek 31:
	# '''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> a případně další slova vypsaná v kapitole [ Klíčová slova modulu].		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> a případně další slova vypsaná v kapitole [ Klíčová slova modulu].

	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 v 14. 8. 2009, 08:58

2009-08-14T08:58:45Z

← Starší verze		Verze z 14. 8. 2009, 10:58
Řádek 15:		Řádek 15:

	=== Nastavení ===		=== Nastavení ===
			====Stránkování kapitol====
	Ve formuláři '''Stránkování kapitol''' je definován vzhled lišty, která je používána pro stránkování seznamů kapitol.		Ve formuláři '''Stránkování kapitol''' je definován vzhled lišty, která je používána pro stránkování seznamů kapitol.

	[[Image:~~image005~~.~~jpg~~\|center]]		[[Image:strankovanizprav-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 31:		Řádek 31:
	# '''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> a případně další slova vypsaná v kapitole Klíčová slova modulu.		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> a případně další slova vypsaná v kapitole [ Klíčová slova modulu].

	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:strankovanizprav-reference-img006.png\|center]]

	Posledním polem formuláře je '''Nadpis kapitoly'''. Zde se definuje formátování uvozujících nadpisů kapitol, které jsou v předloze stránky reprezentovány klíčovým slovem <nowiki><!--WTD_NEWSPAGING(LABEL)--></nowiki>. Bez stránkovací lišty se ve stránkách zobrazujících zprávy rozdělené na kapitoly neobejdete, použití uvozujících nadpisů kapitol z principu povinné není a záleží na požadovaném designu a funkčnosti.		Posledním polem formuláře je '''Nadpis kapitoly'''. Zde se definuje formátování uvozujících nadpisů kapitol, které jsou v předloze stránky reprezentovány klíčovým slovem <nowiki><!--WTD_NEWSPAGING(LABEL)--></nowiki>. Bez stránkovací lišty se ve stránkách zobrazujících zprávy rozdělené na kapitoly neobejdete, použití uvozujících nadpisů kapitol z principu povinné není a záleží na požadovaném designu a funkčnosti.
Řádek 191:		Řádek 191:
	Dialog pro vložení značky po začátek nebo konec názvu kapitoly se otevírá ikonou (s malou číslicí ''dvě'') z tlačítkové lišty editoru.		Dialog pro vložení značky po začátek nebo konec názvu kapitoly se otevírá ikonou (s malou číslicí ''dvě'') z tlačítkové lišty editoru.

	[[Image:~~image007~~.~~jpg~~\|center]]		[[Image:strankovanizprav-reference-img007.png\|center]]

	Zobrazí se následující dialog.		Zobrazí se následující dialog.

	[[Image:~~image008~~.~~jpg~~\|center]]		[[Image:strankovanizprav-reference-img008.png\|center]]

	Po potvrzení tlačítkem OK se na pozici kurzoru vloží vybraná značka.		Po potvrzení tlačítkem OK se na pozici kurzoru vloží vybraná značka.

	Zobrazení těla zprávy z příkladu v kapitole První zobrazení stránkované zprávy vypadá následovně:		Zobrazení těla zprávy z příkladu v kapitole [ První zobrazení stránkované zprávy ]vypadá následovně:

	[[Image:~~image009~~.~~jpg~~\|center]]		[[Image:strankovanizprav-reference-img009.png\|center]]

	Značky jsou odlišeny barevně a nelze je přímo editovat. V textu máte následující možnosti:		Značky jsou odlišeny barevně a nelze je přímo editovat. V textu máte následující možnosti:

Bajkvl: Založena nová stránka: Category:WebToDate 4.1 Stránkování zpráv Category:Stránkování zpráv == Administrační rozhraní == === Nabídka modulu === Nabídka modulu je jednoduchá,…

2009-07-29T12:11:41Z

Založena nová stránka: Category:WebToDate 4.1 Stránkování zpráv Category:Stránkování zpráv == Administrační rozhraní == === Nabídka modulu === Nabídka modulu je jednoduchá,…

Nová stránka

[[Category:WebToDate 4.1 Stránkování zpráv]]
[[Category:Stránkování zpráv]]
== Administrační rozhraní ==
=== Nabídka modulu ===

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

'''Nastavení'''

:Globální

::Stránkování kapitol

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

=== Nastavení ===

Ve formuláři '''Stránkování kapitol''' je definován vzhled lišty, která je používána pro stránkování seznamů kapitol.

[[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> a případně další slova vypsaná v kapitole Klíčová slova modulu.

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

[[Image:image006.jpg|center]]

Posledním polem formuláře je '''Nadpis kapitoly'''. Zde se definuje formátování uvozujících nadpisů kapitol, které jsou v předloze stránky reprezentovány klíčovým slovem <nowiki></nowiki>. Bez stránkovací lišty se ve stránkách zobrazujících zprávy rozdělené na kapitoly neobejdete, použití uvozujících nadpisů kapitol z principu povinné není a záleží na požadovaném designu a funkčnosti.

<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 nemá žádný samostatný prezentační skript, kódy ovlivňující zobrazení jsou implementovány formou extenze, která se musí použít dle kapitoly pojednávající o instalaci.

Extenze obohacuje možnosti parametrů skriptu pro zobrazování zpráv /scripts/detail.php o následující parametry:

* ''chapterid'' – pořadové číslo kapitoly. Pokud není uvedeno nebo je z jakéhokoliv důvodu nevalidní (neexistující číslo, nejedná se o číslo), zobrazí se první kapitola.
* ''nopaging'' – pokud obsahuje jakoukoliv jinou hodnotu než prázdný řetězec (např. "yes"), celá funkce realizující stránkování se ukončí hned na začátku a zpráva se zobrazí celá jako kdyby žádné stránkování neexistovalo.

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

Následující dvě tabulky obsahují definice klíčových slov, která lze použít v polích formuláře '''Nastavení''' – '''Globální''' – '''Stránkování kapitol'''.

{| 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í kapitol

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

|-
| <nowiki></nowiki>
| Název kapitoly
| Je použitelné v polích ''Číslo stránky'', ''Aktivní stránka'', ''Předchozí'' a ''Následující''

|-
| <nowiki></nowiki>
| Celkový počet kapitol
| Je použitelné v kterémkoliv poli

|}

{| class="prettytable"
| colspan="3" | Klíčová slova použitelná v uvozujícím nadpisu kapitoly

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

|-
| <nowiki></nowiki>
| Název aktuální kapitoly
|

|-
| <nowiki></nowiki>
| Pořadové číslo stránky
| Pořadové číslo stránky (kapitoly) v rámci stránkování

|-
| <nowiki></nowiki>
| Počet stránek
| Celkový počet kapitol v rámci stránkování

|}

Následující tabulka obsahuje klíčová slova použitelná v předloze pro zprávy.

{| class="prettytable"
| colspan="3" | Klíčová slova použitelná předloze pro zprávy

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

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

|-
| <nowiki></nowiki>
| Výpis výsledků
| Reprezentuje uvozující nadpis kapitoly (např. "Kapitola 2 z 10")

|-
| <nowiki></nowiki>
| Začátek textu, ve kterém se hledají kapitoly
|

|-
| <nowiki></nowiki>
| Konec textu, ve kterém se hledají kapitoly
|

|}

Následující dvě klíčová slova se používají v textu zpráv pro vyznačení názvů a začátků kapitol.

{| class="prettytable"
| colspan="3" | Klíčová slova pro vyznačení kapitol

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

|-
| <nowiki></nowiki>
| Začátek názvu kapitoly
|

|-
| <nowiki></nowiki>
| Konec názvu kapitoly
|

|}

== Pravidla způsobu stránkování ==
Při zobrazování kapitol se postupuje takto:

* Pokud není v těle nalezena ani jedna značka pro kapitoly, nahrazují se v šabloně klíčová slova pro název kapitoly i stránkovací lištu prázdným znakem, pro kratší zprávy tudíž nedochází k žádné změně oproti současnému stavu.
* Identifikace první kapitoly je taková, že buď celý text začíná značkou pro kapitolu, pak kapitola rovná se text od této značky až po následující značku nebo konec dokumentu, nebo text nezačíná značkou kapitoly a pak kapitola rovná se text od začátku po další značku pro kapitolu.
* Konec kapitoly je identifikován buď další značkou pro kapitolu nebo koncem textu.

Z toho vyplývají následující skutečnosti pro používání značek pro začátek a konec kapitoly v textu zprávy a pro jejich vztah se značkami pro začátek a konec stránkovaného textu:

* První kapitola nemusí začínat klíčovým slovem <nowiki>. Pokud je mezi  a </nowiki> text (mezery se ignorují), je tento text chápán jako kapitola bez názvu
* Sekvence <nowiki></nowiki> je přípustná, jedná se opět o kapitolu bez názvu
* Poslední kapitola končí klíčovým slovem <nowiki></nowiki>
* Názvy kapitol uvnitř klíčových slov CHAPTERBEGIN - CHAPTEREND se nezobrazují. Využívají se pro naplnění obsahu klíčových slov jako <nowiki></nowiki> apod.

== Integrace s WYSIWYG editorem ==
Od verze WebToDate 4.1 používá systém WebToDate pro úpravy HTML kódů (textů zpráv apod.) WYSIWYG editor '''FCKeditor'''. Pro nasazení ve WebToDate je tento editor vybaven několika moduly, jedním z nich je modul podporující vkládání značek pro kapitoly do textu zprávy. Tuto funkci můžete tedy jednoduše použít na definování stránkování zpráv v režimu vytváření zprávy.

Dialog pro vložení značky po začátek nebo konec názvu kapitoly se otevírá ikonou (s malou číslicí ''dvě'') z tlačítkové lišty editoru.

[[Image:image007.jpg|center]]

Zobrazí se následující dialog.

[[Image:image008.jpg|center]]

Po potvrzení tlačítkem OK se na pozici kurzoru vloží vybraná značka.

Zobrazení těla zprávy z příkladu v kapitole První zobrazení stránkované zprávy vypadá následovně:

[[Image:image009.jpg|center]]

Značky jsou odlišeny barevně a nelze je přímo editovat. V textu máte následující možnosti:

* '''Odstranění značky''' – klepněte na značku a použijte klávesu ''Delete'' na klávesnici
* '''Posun značky na jiné místo v textu''' – klepněte na značku a myší ji přetáhněte na odpovídající místo
* '''Změna značky''' – poklepejte na značku; zobrazí se dialog, který je stejný jako pro vložení značky, zde můžete změnit značku pro začátek názvu kapitoly na značku pro konec názvu kapitoly a naopak.