WebToDate/Stránkování zpráv/Začínáme: Porovnání verzí

Z WebToDate
Skočit na navigaciSkočit na vyhledávání
Bajkvl (diskuse | příspěvky)
Založena nová stránka: Category:WebToDate 4.1 Stránkování zpráv Category:Stránkování zpráv === Soubory === Soubory modulu se nacházejí v adresářích * scripts/modules/n…
 
m Nahrazení textu „[[Category:WebToDate 4.1“ textem „[[Category:WebToDate“
 
(Nejsou zobrazeny 3 mezilehlé verze od 2 dalších uživatelů.)
Řá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]]
=== Soubory ===
== Základní funkce a principy ==
=== Postup při implementaci ===


Soubory modulu se nacházejí v adresářích
Nejprve se v administračním rozhraní modulu definuje způsob formátování stránkovací lišty pro kapitoly a případně tvar uvozujícího nadpisu pro kapitoly (např. "Kapitola 2 z 10").


* scripts/modules/newspaging/
Dále je třeba odpovídajícím způsobem upravit předlohy pro zprávy. Zde platí:
* application/modules/newspaging/
* rdata/resources/modules/newspaging/


=== Vlastní instalace ===
* Po instalaci modulu se neprojeví žádná změna, zprávy se zobrazují v původní podobě, je třeba změnit jejich předlohy.
* Zpráva, která není označená jako stránkovaná (tj. neobsahuje uvnitř textu značky pro kapitoly) se zobrazuje identickým způsobem jako kdyby modul nebyl vůbec instalován.


Po zkopírování odpovídajících souborů do adresářů spusťte z prohlížeče instalační skript ''/admin/modules/newspaging/install.php'' (název adresáře "admin" se může ve vaší implementaci lišit).
=== Změny v předloze pro zprávy ===


Dále je potřeba na odpovídající místo vložit příslušnou extenzi. Do souboru _modules_inc.php vložte následující kód:
V předlohách pro zprávy je třeba provést při implementaci modulu následující změny:
 
V&nbsp;předloze je nutno vyznačit tu část stránky, která se stránkuje. V&nbsp;nejjednodušším případě se jedná o výměnu klíčového slova ''<nowiki><!--WTD_F(BODY)-->'' za kód ''<!--WTD_NEWSPAGING(CONTENTBEGIN)--><!--WTD_F(BODY)--><!--WTD_NEWSPAGING(CONTENTEND)--></nowiki>''
 
V&nbsp;předloze je třeba pomocí klíčového slova <nowiki><!--WTD_NEWSPAGING(NAVIG)--> vyznačit místo, kde se zobrazuje stránkovací lišta pro přechod mezi kapitolami a dále (volitelně) pomocí klíčového slova <!--WTD_NEWSPAGING(LABEL)--></nowiki> vyznačit místo, kde se vypisuje uvozující nadpis (typicky název kapitoly).
 
=== Formátování zpráv ===
 
Zpráva, která se má zobrazit jako stránkovaná musí obsahovat klíčová slova <nowiki><!--WTD_NEWSPAGING(CHAPTERBEGIN)--> a <!--WTD_NEWSPAGING(CHAPTEREND)--></nowiki> vyznačující začátky a konce názvů kapitol. Počet kapitol ve zprávě není omezen.
 
== První zobrazení stránkované zprávy ==
Tento postup slouží k&nbsp;prvotnímu oživení modulu a prvnímu zobrazení stránkované zprávy.
 
V&nbsp;prvním kroku definujeme formát stránkování. Přejděte do nabídky '''Nastavení''' – '''Globální''' – '''Stránkování kapitol''' modulu. Zobrazí se formulář pro definici formátování stránkovací lišty. Tento formulář beze změn uložte.
 
V&nbsp;druhém kroku vytvoříme předlohu pro zprávy podporující stránkování. Přejděte ve WebToDate do nabídky '''Vzhled''' – '''Předlohy'''. Klepněte na ikonu složky vedle názvu kategorie předloh ''Zprávy''. Přidejte novou předlohu tlačítkem '''Přidat''' vpravo nahoře. Formulář vyplňte dle následujícího otisku obrazovky.
 
[[Image:strankovanizprav-zaciname-img002.png|center]]
 
Přejděte do záložky '''Obsah''' formuláře a do pole ''Obsah souboru'' vložte následující kód.


<code>
<code>
  <nowiki>// - extenze Newspaging</nowiki>
  <nowiki><html></nowiki>
  <nowiki> $np_file = './modules/newspaging/_newspaging_inc.php';</nowiki>
<nowiki><head></nowiki>
  <nowiki> if( is_file( $np_file ) ) {include_once( $np_file );};</nowiki>
<nowiki><title><!--WTD_F(TITLE)--></title></nowiki>
  <nowiki></head></nowiki>
<nowiki><body></nowiki>
<nowiki><h2><!--WTD_F(TITLE)--></h2></nowiki>
  <nowiki><p><em><!--WTD_F(DESCRIPTION)--></em></p></nowiki>
<nowiki><p><!--WTD_NEWSPAGING(LABEL)--></p></nowiki>
<nowiki><p><!--WTD_NEWSPAGING(NAVIG)--></p></nowiki>
<nowiki><p></nowiki>
<nowiki><!--WTD_NEWSPAGING(CONTENTBEGIN)--></nowiki>
<nowiki><!--WTD_F(BODY)--></nowiki>
<nowiki><!--WTD_NEWSPAGING(CONTENTEND)--></nowiki>
<nowiki></p></nowiki>
<nowiki></body></nowiki>
<nowiki></html></nowiki>
</code>
</code>
Formulář uložte a přejděte na nabídku '''Obsah''' – '''Zprávy'''. Založte novou zprávu, pole zprávy vyplňte následujícím způsobem.
'''Nadpis'''
<code>
<nowiki>Stránkovaná zpráva</nowiki>
</code>
'''Popis'''
<code>
<nowiki>Zde je popis zprávy</nowiki>
</code>
'''Tělo'''
<code>
<nowiki><!--WTD_NEWSPAGING(CHAPTERBEGIN)-->První kapitola<!--WTD_NEWSPAGING(CHAPTEREND)--></nowiki>
<nowiki>Zde je text první kapitoly ...</nowiki>
<nowiki><!--WTD_NEWSPAGING(CHAPTERBEGIN)-->Druhá kapitola<!--WTD_NEWSPAGING(CHAPTEREND)--></nowiki>
<nowiki>Zde je text druhé kapitoly ... </nowiki>
<nowiki><!--WTD_NEWSPAGING(CHAPTERBEGIN)-->Třetí kapitola<!--WTD_NEWSPAGING(CHAPTEREND)--></nowiki>
<nowiki>Zde je text třetí kapitoly ...</nowiki>
</code>
'''Kategorie'''
Zvolte libovolnou kategorii.
'''Předloha'''
Zvolte předlohu založenou v&nbsp;předchozím kroku ("Jednoduchá předloha pro zprávy").
Zprávu uložte a zobrazte její náhled. Zobrazí se stránka dle následujícího otisku obrazovky.
[[Image:strankovanizprav-zaciname-img003.png|center]]
Nahoře se zobrazuje nadpis a popis. Následuje název aktuálně zobrazované kapitoly, pod ním je stránkovací lišta pro přechod mezi kapitolami. Na konci následuje část těla zprávy – text první kapitoly. Klepněte na číslo 2 ve stránkovací liště, zobrazí se druhá kapitola.
[[Image:strankovanizprav-zaciname-img004.png|center]]
Ve stránce se změnil název kapitoly, tvar stránkovací lišty a text kapitoly, zbytek stránky zůstává nezměněn.

Aktuální verze z 13. 10. 2009, 13:44

Základní funkce a principy

Postup při implementaci

Nejprve se v administračním rozhraní modulu definuje způsob formátování stránkovací lišty pro kapitoly a případně tvar uvozujícího nadpisu pro kapitoly (např. "Kapitola 2 z 10").

Dále je třeba odpovídajícím způsobem upravit předlohy pro zprávy. Zde platí:

  • Po instalaci modulu se neprojeví žádná změna, zprávy se zobrazují v původní podobě, je třeba změnit jejich předlohy.
  • Zpráva, která není označená jako stránkovaná (tj. neobsahuje uvnitř textu značky pro kapitoly) se zobrazuje identickým způsobem jako kdyby modul nebyl vůbec instalován.

Změny v předloze pro zprávy

V předlohách pro zprávy je třeba provést při implementaci modulu následující změny:

V předloze je nutno vyznačit tu část stránky, která se stránkuje. V nejjednodušším případě se jedná o výměnu klíčového slova <!--WTD_F(BODY)-->'' za kód ''<!--WTD_NEWSPAGING(CONTENTBEGIN)--><!--WTD_F(BODY)--><!--WTD_NEWSPAGING(CONTENTEND)-->

V předloze je třeba pomocí klíčového slova <!--WTD_NEWSPAGING(NAVIG)--> vyznačit místo, kde se zobrazuje stránkovací lišta pro přechod mezi kapitolami a dále (volitelně) pomocí klíčového slova <!--WTD_NEWSPAGING(LABEL)--> vyznačit místo, kde se vypisuje uvozující nadpis (typicky název kapitoly).

Formátování zpráv

Zpráva, která se má zobrazit jako stránkovaná musí obsahovat klíčová slova <!--WTD_NEWSPAGING(CHAPTERBEGIN)--> a <!--WTD_NEWSPAGING(CHAPTEREND)--> vyznačující začátky a konce názvů kapitol. Počet kapitol ve zprávě není omezen.

První zobrazení stránkované zprávy

Tento postup slouží k prvotnímu oživení modulu a prvnímu zobrazení stránkované zprávy.

V prvním kroku definujeme formát stránkování. Přejděte do nabídky NastaveníGlobálníStránkování kapitol modulu. Zobrazí se formulář pro definici formátování stránkovací lišty. Tento formulář beze změn uložte.

V druhém kroku vytvoříme předlohu pro zprávy podporující stránkování. Přejděte ve WebToDate do nabídky VzhledPředlohy. Klepněte na ikonu složky vedle názvu kategorie předloh Zprávy. Přidejte novou předlohu tlačítkem Přidat vpravo nahoře. Formulář vyplňte dle následujícího otisku obrazovky.

Přejděte do záložky Obsah formuláře a do pole Obsah souboru vložte následující kód.

<html>
<head>
<title><!--WTD_F(TITLE)--></title>
</head>
<body>
<h2><!--WTD_F(TITLE)--></h2>
<p><em><!--WTD_F(DESCRIPTION)--></em></p>
<p><!--WTD_NEWSPAGING(LABEL)--></p>
<p><!--WTD_NEWSPAGING(NAVIG)--></p>
<p>
<!--WTD_NEWSPAGING(CONTENTBEGIN)-->
<!--WTD_F(BODY)-->
<!--WTD_NEWSPAGING(CONTENTEND)-->
</p>
</body>
</html>

Formulář uložte a přejděte na nabídku ObsahZprávy. Založte novou zprávu, pole zprávy vyplňte následujícím způsobem.

Nadpis

Stránkovaná zpráva

Popis

Zde je popis zprávy

Tělo

<!--WTD_NEWSPAGING(CHAPTERBEGIN)-->První kapitola<!--WTD_NEWSPAGING(CHAPTEREND)-->
Zde je text první kapitoly ...
<!--WTD_NEWSPAGING(CHAPTERBEGIN)-->Druhá kapitola<!--WTD_NEWSPAGING(CHAPTEREND)-->
Zde je text druhé kapitoly ... 
<!--WTD_NEWSPAGING(CHAPTERBEGIN)-->Třetí kapitola<!--WTD_NEWSPAGING(CHAPTEREND)-->
Zde je text třetí kapitoly ...

Kategorie

Zvolte libovolnou kategorii.

Předloha

Zvolte předlohu založenou v předchozím kroku ("Jednoduchá předloha pro zprávy").


Zprávu uložte a zobrazte její náhled. Zobrazí se stránka dle následujícího otisku obrazovky.

Nahoře se zobrazuje nadpis a popis. Následuje název aktuálně zobrazované kapitoly, pod ním je stránkovací lišta pro přechod mezi kapitolami. Na konci následuje část těla zprávy – text první kapitoly. Klepněte na číslo 2 ve stránkovací liště, zobrazí se druhá kapitola.

Ve stránce se změnil název kapitoly, tvar stránkovací lišty a text kapitoly, zbytek stránky zůstává nezměněn.