Kapitoly v Drupalu a jejich pojmenování

Jeden ze čtenářů se na mě obrátil s prosbou o bližší popis použití kapitol článku v Drupalu, jejich pojmenování a zobrazení. V Drupalu můžete standardně používat modul Book, který vytváří jakousi elektronickou knihu. Taková kniha se skládá z různých článků a stránek, které na sebe různě navazují a tvoří hierarchickou strukturu. Problém je v tom, že všechny kapitoly a knihy se v administraci objevují v jedné jediné rozbalovací nabídce, což znamená, že po nějaké době je takovýto systém nepřehledný a nepoužitelný. Právě zde přichází ke slovu modul Paging.

Modul Paging, který pro tvorbu kapitol používám, naproti tomu nevyžaduje, aby jeden, kapitolami rozdělený článek, byl zadáván na několikrát. Vše je maximálně přehledné, byť o trochu méně uživatelsky přívětivé, ale myslím, že na to jsou uživatelé Drupalu zvyklí.

Paging si stáhněte z webové stránky projektu na adrese drupal.org/project/paging. Jeho zprovoznění vyžaduje jako obvykle nakopírování souborů do příslušné složky s moduly (např. /sites/all/modules), jeho aktivaci ve správě modulů, aktivaci typů obsahu které budou kapitoly využívat (Administrace | Nastavení webu | Paging) a aktivaci podpory kapitol ve správě filtrů (Administrace | Nastavení webu | Formáty textu).

Poté už stačí, pokud do článku, který chcete kapitolami rozdělit, vložíte značku <!--pagebreak-->. Na místě, kde ji Drupal nalezne, vznikne zakončení stránky a zbytek článku bude dostupný pomocí klasického stránkování.

Jak na názvy kapitol?

Potíž samozřejmě nastává v případě, že si chcete kapitoly nějakým způsobem pojmenovat. V tom případě vám běžná verze modulu Paging stačit nebude. Vřele doporučuji si přečíst diskuzi k tomuto tématu na Drupal.org ve vlákně Pages needs names. Je zde upravená verze modulu (která je zřejmě zahrnuta už i do vývojové verze), která umožňuje kapitoly pojmenovávat.

Přináší několik změn v administraci. Přepněte se na Administrace | Nastavení webu | Paging a podívejte se, co je vyplněno v políčku Separator. Mělo by tam být napsáno pagebreak a doporučuji vám to neměnit. Rozdělování kapitol pak proběhne pomocí nových značek:

[firstpagebreak title=Úvodní strana...]

[pagebreak title=Jedna z kapitol...]

Značky opět vkládáte do textu na místa, kde bude článek zalomen na kapitoly. První značku použijete samozřejmě pouze jednou, označuje úvodní stranu. Pro všechna další zalomení použijte druhý typ zápisu. Pojmenování kapitoly uveďte jako text za title=.

Upravený modul Paging dále umožňuje, aby se seznam pojmenovaných kapitol objevil jako součást článku, což samozřejmě zpříjemňuje uživatelům prohlížení webu více, než jen sada čísel sloužících jako odkazy na stránky. Výpis kapitol musíte zapnout v Administrace | Nastavení webu | Paging pomocí volby Enable pages listing.

Umístění seznamu kapitol

Seznam kapitol se v upraveném modulu Paging umisťuje pod článek. Pokud se kouknete na různé weby (tedy nejenom drupalovské), kde kapitoly používají, pak si všimnete, že někdy jsou sice kapitoly umístěny dole, velice často je však najdete i v horní části článku. Změna je jednoduchá, musíte jen upravit jeden řádek v souboru paging.module.

Vyhledejte tuto podmínku:

if (variable_get('paging_pagelist_enabled', 1)) {

            $node->content['body']['#value'] .= theme('item_list', $links);

A změňte ji na:

if (variable_get('paging_pagelist_enabled', 1)) {

            $node->content['body']['#value'] = theme('item_list', $links) . $node->content['body']['#value'];          

Jinými slovy namísto toho, aby se seznam kapitol přilepoval na konec těla článku (resp. kapitoly), bude zobrazen vždy na jeho začátku.

Jak tato úprava vypadá v praxi, se můžete podívat například na webových stránkách ExtraHardware.cz.

Kapitoly a FCKeditor

Nejnovější verze modulu pro podporu FCKeditoru už umí s kapitolami pracovat. Podporuje však jen první typ zápisu, tedy značku <!--pagebreak-->, což neumožňuje pojmenovávání jednotlivých kapitol. Každopádně je to cesta, jak zpříjemnit zadávání článku, pro vložení rozdělovací značky pak stačí stisknout jediné tlačítko.