Zobrazení zdroje stránky WebToDate/Publikace a vydání/Reference

[[Category:WebToDate 4.1 Publikace a vydání]]
[[Category:Publikace a vydání]]
== Veřejné skripty ==
Veřejná část se nachází v&nbsp;adresáři /scripts/modules/issues/. Obsahuje dva skripty:

* issues.php – zobrazuje seznam vydání dané publikace
* artlist.php – zobrazuje seznam článků ve vydání dané publikace

Skripty veřejné části fungují obvyklým způsobem (např. jako při zobrazování zpráv). Co se týká parametrů z&nbsp;URL, i zde je možné zadat parametr ''tmplid'' pro vynucení šablony stránky a jazykové parametry pro nastavení jazyka, které se předávají do odkazů v&nbsp;zobrazovaném seznamu i v&nbsp;navigační liště.

=== Zobrazení seznamu vydání ===

Skript ''issues.php'' zobrazuje stránkovaný seznam všech vydání dané periodické publikace. Povinným parametrem z&nbsp;URL je ID publikace ''publid''.

V&nbsp;případě, že publikace není periodická (viz stejnojmenné zaškrtávací pole ve formuláři ''Publikace'') je tento skript automaticky přesměrován na /''scripts/modules/issues/artlist.php?''publid =ID, který zobrazí seznam zpráv dané publikace (viz dále).

<div class="note">Následující skript zobrazí seznam vydání publikace číslo 2. ''/scripts/modules/issues/issues.php?publid=2''</div>

Možné chyby parametrů jsou:

* Nezadané číslo publikace
* Publikace se zadaným číslem neexistuje

Pokud dojde k&nbsp;jedné z&nbsp;těchto chyb, přesměruje se na stránku danou konstantou PUBLICATION_NOT_FOUND_PAGE v&nbsp;konfiguračním souboru ''global.php''.

V&nbsp;předloze se může nacházet:

* Klíčové slovo pro seznam vydání
* Klíčové slovo pro název publikace
* Klíčové slovo pro stránkovací lištu.

V&nbsp;seznamu vydání lze zobrazit:

* Název vydání
* ID vydání
* Datum vydání
* URL stránky pro obsah vydání (tedy artlist.php)

=== Zobrazení obsahu vydání ===

Skript ''artlist.php'' zobrazuje stránkovaný seznam všech článků v&nbsp;daném vydání. Povinným parametrem z&nbsp;URL je buď ID publikace ''publid'' nebo ID vydání ''issueid'', možné je i datum vydání ''issuedate'', které se zadává ve formátu, který používá XML, tedy např. 2003-08-13.

<div class="note">Následující skript zobrazí seznam zpráv vydání číslo 5

''scripts/modules/issues/artlist.php?issueid=5''

Následující skript zobrazí seznam zpráv posledního vydání publikace číslo 3

''scripts/modules/issues/artlist.php?publid=3''</div>

Při vyhodnocování parametrů se postupuje takto:

* Pokud je zadané pouze číslo publikace, zobrazuje se obsah posledního vydání dané publikace, tj. vydání s&nbsp;nejvyšším datem, které je ve stavu ''Publikováno''.
* Pokud je zadané pouze číslo vydání, zobrazuje se obsah vydání daného tímto číslem.
* Pokud je zadáno více parametrů, postupuje se&nbsp;v&nbsp;pořadí číslo vydání – datum vydání – číslo publikace. Jakmile je zjištěno, že daný parametr v&nbsp;pořadí je přípustný, tj. může zobrazit obsah nějakého vydání, vybírá se toto vydání a ostatní parametry se ignorují.
* Pokud je zjištěna nějaká chyba v&nbsp;zadaných parametrech, přesměruje se na stránku danou konstantou ISSUE_NOT_FOUND_PAGE v&nbsp;globálních předvolbách.

V&nbsp;předloze se mohou nacházet klíčová slova pro:

* Název publikace
* Název vydání
* Seznam zpráv v&nbsp;daném vydání
* Stránkovací lištu

Obsah seznamu zpráv v&nbsp;daném vydání je závislý na nastavení příznaku '''Periodická''' u dané publikace. Pokud je tento příznak nastaven na ''Ano'', vybírají se pouze zprávy, která mají zadané číslo vydání a které jsou ve stavu ''Publikováno''. V&nbsp;opačném případě se ovšem vybírají zprávy celé publikace nezávisle na vydání, smysl pak má v&nbsp;URL pouze parametr ''publid''.

Seznam může být dělený. Dělení funguje stejně jako u seznamu zpráv – pokud je nastaven dělený seznam, může být ve stylu v&nbsp;poli '''Začátek sekce''' HTML kód (včetně klíčových slov WTD), který se aplikuje na začátku každé sekce seznamu a v&nbsp;poli '''Konec sekce''' kód, který se aplikuje na jejím konci. Analogicky jako u WTD seznamů funguje i třídění.

V&nbsp;seznamu lze zobrazit stejná pole jako ve WTD&nbsp;seznamu zpráv, nejčastěji tedy, nadpis, popis, odkaz nadpisu, datum, číslo stránky apod.

=== Klíčová slova pro styly a předlohy ===

V&nbsp;předlohách lze použít klíčová slova:

{| class="prettytable"
| <nowiki><!--WTD_ISSUES(LIST)--></nowiki>
| zastupuje seznam (buď vydání dané publikace nebo obsahu daného vydání)

|-
| <nowiki><!--WTD_ISSUES(NAVIG)--></nowiki> 
| zastupuje navigační lištu

|-
| <nowiki><!--WTD_ISSUES(PUBLICATION)--></nowiki> 
| název publikace

|-
| <nowiki><!--WTD_ISSUES(PUBLICATIONID)--></nowiki>
| ID publikace

|-
| <nowiki><!--WTD_ISSUES(NAME)--></nowiki> 
| název vydání

|-
| <nowiki><!--WTD_ISSUES(ID)--></nowiki>
| ID právě zobrazovaného vydání  (má smysl jen pro výpis zpráv v&nbsp;daném vydání, tedy pro skript ''artlist.php'')

|}

Lze tedy pro oba skripty vytvořit stejnou předlohu.

Ve stylu pro seznam vydání dané publikace lze použít klíčová slova:

{| class="prettytable"
| <nowiki><!--WTD_ISSUES(NAME)--></nowiki> 
| název vydání

|-
| <nowiki><!--WTD_ISSUES(DATE)--></nowiki> 
| datum vydání

|-
| <nowiki><!--WTD_ISSUES(ID)--></nowiki> 
| ID vydání

|-
| <nowiki><!--WTD_ISSUES(URL)--></nowiki> 
| URL stránky pro seznam zpráv daného vydání

|}

Ve stylu seznamu zpráv v&nbsp;daném vydání se používají klíčová slova typu WTD_F pro pole databáze zpráv, lze použít stejná klíčová slova, jako když se formátuje nějakým stylem seznam zpráv WebToDate. V&nbsp;seznamu zpráv se nahrazují obsahem i klíčová slova instancí položek z&nbsp;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 vydání použít klíčové slovo <nowiki><!--WTD_F(PIC)--></nowiki> a obrázek se zobrazí stejně jako v&nbsp;seznamech zpráv WebToDate. Seznamy příslušných klíčový slov pro styl seznamu zpráv ve vydání jsou k&nbsp;dispozici v&nbsp;referenční příručce WebToDate.

== Administrační rozhraní ==
=== Nabídka modulu ===

Administrační část modulu je zobrazena pomocí volby '''Moduly – Publikace a Vydání''' v&nbsp;levém menu a slouží pouze k&nbsp;nastavení grafické prezentace dat, žádná data není třeba editovat. K&nbsp;administračnímu rozhraní modulu mají přístup pouze členové týmu ''Administrátoři''.

Nabídka modulu vypadá následovně:

[[Image:publikaceavydani-reference-img004.png|center]]

Ve formuláři Navigační lišta je definován vzhled lišty, která je používána pro stránkování seznamu vydání.

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
* '''Maximální počet záznamů v seznamu kategorií''' – v případě většího počtu kategorií je možné omezit výpis pouze na některé kategorie.
* '''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><!--WTD_NAVIG(URL)--> a <!--WTD_NAVIG(NUMBER)--></nowiki>.

[[Image:publikaceavydani-reference-img005.png|center]]

=== Nastavení – seznam vydání ===

[[Image:publikaceavydani-reference-img006.png|center]]

Ve formuláři se nastavuje způsob výpisu seznamu vydání dané publikace. Položky formuláře jsou:

* Předloha
* WTD styl pro seznam vydání dané publikace včetně počtu položek na stránku
* Způsob třídění vydání

Možná třídění jsou:

* Podle datumu vydání sestupně (výchozí hodnota)
* Podle datumu vzestupně
* Podle abecedy

=== Nastavení – obsah vydání ===

[[Image:publikaceavydani-reference-img007.png|center]]

Ve formuláři se nastavuje způsob výpisu seznamu zpráv v&nbsp;daném vydání. Položky formuláře jsou:

* Předloha
* WTD styl pro seznam včetně počtu položek na stránku
* Způsob třídění seznamu zpráv
* Způsob dělení seznamu

Možná třídění jsou:

* Podle datumu a času zprávy
* Podle nadpisu
* Podle čísla stránky (výchozí hodnota)
* Podle rubriky

Možné způsoby dělení seznamu jsou:

* Nedělit (výchozí hodnota)
* Podle datumu
* Podle čísla stránky
* Podle rubriky