Drupal.cz

Modul views obvykle potřebujete, když chcete zobrazit obsah „nějak jinak“, než jak nabízí jádro Drupalu či standardní výstup nějakého modulu. Pokud vás poněkud zaskočilo nové administrační rozhraní Views 2, nebo pokud se s tímto modulem teprve navzájem „oťukáváte“, je následující text určen právě vám.

Na dvou příkladech si ukážeme základní principy – které jsou popravdě řečeno podobné jako u Views 1 (kdo už je používal, nepotřebuje o mnoho více, než zvyknout si na nový vzhled a hierarchii formulářů v administraci… a samozřejmě na nové a skvělé funkce Views 2).
Poznámka: Text vychází z verze modulu Views 6.x-2.1.

Typické ukázky zadání řešitelných s pomocí Views vypadají například takto:

• Některé uzly nechcete zobrazovat na titulní stránce, ale „někde jinde“, přičemž chcete mít perfektní kontrolu nad tím, jak je uživateli naservírujete (stránka, boxík, tabulka…).
• Na stránkách máte přehled čehokoliv (produktů, odkazů, kontaktů…) a chcete, aby si uživatelé mohli obsah sami třídit, filtrovat, nebo v něm jinak „inteligentně“ hledat.

… dalo by se jmenovat mnoho odlišných příkladů, avšak další možnosti Views už snadno odvodíte analogicky (a z nabídky, kterou uvidíte v administračním rozhraní).

Příklad 1: nechci to na titulce… ale kam s tím?

Pravděpodobně u každého webu (snad s výjimkou jednoduchého blogu) se objeví nějaký typ obsahu, který se nehodí na titulní stránku. Odškrtnout políčko „zobrazit na titulní stránce“ není problém, ale jak potom zařídit, aby se obsah k uživateli dostal jinou cestou?

Ještě než se pohroužíme do Views, je třeba zdůraznit, že cesta od obsahu k uživateli skrze Views nemusí být za všech okolností nejelegantnější a nejúspornější (třeba z hlediska času načítání vygenerovaného výstupu). Proto nikdy neuškodí podívat se nejdříve, jestli požadovaného výsledku nelze dosáhnout jen za pomoci modulu, který generuje daný typ obsahu (typicky např. Image nebo Event), nebo za pomoci jiných modulů, které možná tak jako tak používáte (Book, Taxonomy + související moduly…). Teprve když vám výsledek nevyhovuje nebo máte pocit, že by to „ještě něco chtělo“, je namístě použít views.

Po nainstalování a zapnutí modulu se Views objeví v administračním rozhraní mezi Prvky webu. Když se tam podíváte, uvidíte přehled již existujících views (zatím pouze těch, která v Drupalu nebo v použitých modulech existují defaultně, jako například titulní stránka – frontpage – nebo chronologický přehled všech příspěvků – tracker).

Nyní už ke konkrétnímu příkladu: dejme tomu, že máte web, kde potřebujete odlišit „články“ a „tiskové zprávy“ (které vám někdo zaslal k uveřejnění), přičemž tiskové zprávy nechcete mít na titulce.

Suroviny:

• Typ obsahu Tisková zpráva, který nemá povoleno zobrazování na titulní stránce.
• Volitelně: pokud už jste si ochočili modul CCK, přidejte k tomuto typu obsahu ještě pole Zdroj (link na web někoho, kdo tiskovou zprávu vydal); pokud ne, nechte tiskové zprávy jen s názvem a textem.
• Několik testovacích uzlů.

Postup:

V administraci views zvolte záložku Přidat (Add); dostanete se na formulář pro základní nastavení nového view. Do prvního políčka (View name) patří strojově čitelný název vašeho view (zadejte tiskove_zpravy); do dalšího - View description – zadejte normální název s diakritikou (Tiskové zprávy). Volitelně můžete novému view přiřadit ještě tagy, které vám pomohou snáze ho najít v přehledu všech existujících views. V další nabídce zvolte Uzly (protože nové view má zobrazovat tiskové zprávy, což jsou uzly).

Po odklepnutí tlačítka Next dostanete další formulář, kde nastavíte, jak bude konkrétní view vypadat. Zatímco ve Views 1 se vše nastavovalo na jednostránkovém formuláři (což bylo spojeno s nutností neustále rolovat nahoru-dolů), formulář pro Views 2 má více kroků a „vrstev“ (vaše myš si tak užije méně drbání, ale pro vás bude práce příjemnější a hlavně přehlednější).

Každý pohled/view má několik možných typů zobrazení (displays). Výstupem view „Tiskové zprávy“ může být nejen stránka, ale například také blok či tabulka (= několik displays, ale stále totéž view).

DEFAULTS

Na počátku konfigurace nového view se celkem logicky ocitnete v záložce Defaults, kde nastavíte vše, co bude společné pro všechny typy zobrazení (displays). Nastavení není definitivní – když vám nebude vyhovovat, dá se později změnit.

V záložce Defaluts se nejprve podívejte do boxu Basic Settings, a to na volbu Row style, kde je nyní zadáno Fields. Kliknutím na Fields můžete nastavení změnit – dole se objeví formulář se dvěma možnostmi: Fields (nyní zaškrtnuto) nebo Uzly. Pokud ponecháte Fields, bude view pracovat jednotlivě s různými „částmi“ uzlů a s informacemi o nich (například nadpis, text, případně další pole, která generují různé moduly nebo která jste si nastavili pomocí modulu CCK, ale třeba také počet komentářů, datum poslední změny apod.). Ve vašem view pak budete muset také nastavit, jaká pole chcete zobrazovat (samostatný box Fields). Pokud není třeba pracovat s poli, ale jen s celými uzly, je možné zvolit Row style: Uzly (Boxem Fields pak není třeba se zabývat).

V našem konkrétním příkladu (zobrazování tiskových zpráv) budeme pracovat s Fields, takže ponecháme Row style ve výchozím nastavení.

V dalším kroku se tedy zaměřte na box Fields. Kliknutím na tlačítko + obdržíte formulář nazvaný Defaults: Add fields (tj. přidání polí do defaultního zobrazení). Uvidíte zde (nejspíš celkem dlouhý) přehled polí, která máte k dispozici. Aby se vám líp hledalo, zvolte z nabídky Groups volbu Uzly. (Proč najednou zase uzly? Řekli jsme přece, že budeme pracovat s poli/Fields… Ano, nyní pouze říkáme, že nás zajímají pole, která se týkají uzlů a ne třeba komentářů).

Má-li být přehled tiskových zpráv pokud možno stručný a věcný, budeme chtít u každé zprávy zobrazit pouze nadpis (s proklikem na daný uzel), datum uveřejnění a zdroj (poslední vynechte, pokud nemáte definováno). V nabídce polí tedy nejprve vyberte Uzly: Nadpis a Uzly: Post date. (Aby to nebylo tak jednoduché, pole Zdroj budeme hledat až za chvíli a v jiné skupině). Klikněte na tlačítko Add. V boxu Fields se nyní objevil seznam vámi zadaných polí a navíc jste automaticky obdrželi formulář, kde můžete konfigurovat první z nich (Defaults: Configure field Uzly: Nadpis). Políčko Popis obsahuje název pole, které se zobrazí ve výstupu pro uživatele. Protože zřejmě nepotřebujete mít u každého názvu tiskové zprávy ještě uvedeno, že se jedná o Nadpis, obsah políčka vymažte. Další volbu nyní nebudete potřebovat, ale zaškrtněte Link this field to its node (protože každý nadpis má fungovat jako proklik na uzel). Dejte Aktualizovat. Je před vámi další formulář, kterým upravíte druhé pole (Defaults: Configure field Uzly: Post date). V políčku Popis můžete text opět smazat (nebo, pokud popis chcete mít, nahraďte ho českým ekvivalentem), níže vyberte formát data, který vám vyhovuje, a klikněte na tlačítko Aktualizovat.

Jakmile jste definovali aspoň jedno pole, můžete nové view, byť zatím v pracovní verzi, Uložit (lze vřele doporučit, abyste nedopatřením nepřišli o rozdělanou práci).

Zbývá zadat poslední pole – Zdroj. V boxu Fields klikněte opět na + a v boxu Defaults: Add fields zvolte Obsah (jedná se o nově přidané obsahové pole). Pokud jste pomocí CCK zadali pole typu Link (modul Link) s názvem Zdroj, objeví se zde volba: Obsah: Link: Zdroj (field_zdroj) – zaškrtněte ji a klikněte na tlačítko Add. Dostanete formulář, kde budete nově přidané pole konfigurovat. V nabídce Format zvolte Title, as link (default). To znamená, že zdroj tiskové zprávy se zobrazí jako název s odkazem na URL (například takto: Drupal Association). Další dvě volby nebudete potřebovat, ale popis pole tentokrát ano – nechte Widget label (Zdroj). Nezapomeňte opět Aktualizovat.

Nastavení jednotlivých polí můžete kdykoliv změnit, když v boxu Fields kliknete na jejich název. Pokud byste chtěli změnit pořadí, ve kterém se zobrazují, kliknete na tlačítko se dvěma šipkami, načež dole uvidíte box nazvaný Rearrange fields (pořadí se mění obyčejným přetažením křížku myší, nesmíte však zapomenout Aktualizovat).

Pod formulářem, se kterým pracujete, byste měli vidět Live Preview – tedy náhled, jak vaše view zatím vypadá. Patrně vidíte, že se zatím zobrazují nejen tiskové zprávy, ale všechny typy obsahu, které na webu máte. Pochopitelně – protože jsme ještě nedefinovali žádná omezení (Filtry). Jdeme na to.

V boxu Filtry klikněte na + a dostanete formulář nazvaný Defaults: Add filters. Budete vybírat typ uzlu (Tisková zpráva), takže v nabídce Groups zaškrtněte Uzly: Typ a klikněte na tlačítko Add. V následujícím formuláři zvolte operátor Is one of (doslova: „je jeden z“) a zaškrtněte Node type: Tisková zpráva. Nezapomeňte Aktualizovat. Podobným způsobem přidejte filtr Uzly: Vydáno a zvolte Ano. V tuto chvíli by měl náhled (Live preview) obsahovat už jen výběr vydaných tiskových zpráv.

Výsledek má ještě jednu chybu – zprávy se zobrazují od nejstarších (nahoře) po nejnovější (dole). To změníme v boxu Sort Criteria (klikněte na +, dole vyberte Uzly: Post date, Add, následně zvolte Sort order: Descending, Granularity: Second, opět Aktualizovat). V Live Preview nyní vidíte, že view funguje tak, jak má – můžete ho Uložit.

STRÁNKA

…Ovšem uživatel by zatím neviděl nic, protože pro něj nemáme žádné zobrazení (zatím máme jen Defalut display). V následujícím kroku tedy vytvoříme výstup pro uživatele, v tomto případě Stránku – jako jeden z typů zobrazení (displays) nového view. V levé části formuláře vyberte Stránka a klikněte na Add display. Dostanete další formulář (jak jinak :-)), kde můžete nastavit vlastnosti specifické pouze pro dané zobrazení (display). Měli byste si všimnout, že v rámci „hyperformuláře“ celého view se nyní nacházíte v záložce Stránka. Zatím je zde pouze konfigurace „zděděná“ z Default display.

Dole v Live Display nyní uvidíte upozornění, které říká něco o tom, že nemáte definovanou cestu ke stránce (Display Stránka uses path but path is undefined). Napravíte to v boxu Page settings. U položky Cesta klikněte na dosavadní text None a do políčka, které se objeví níže, zadejte cestu (například tiskove_zpravy), opět musíte Aktualizovat. Zbývá nastavit ještě způsob, jak se uživatel k nové stránce dostane (Page settings, položka Menu). Klikněte na No menu a vyberte Normal menu entry. Do políček, která se objeví vedle, zadáte nadpis položky menu, umístění v menu vašeho webu a váhu (stejně jako v běžné administraci menu). Zadejte Nadpis: Tiskové zprávy, Menu: Primární odkazy (například) a libovolnou váhu, jako vždy musíte Aktualizovat.

V boxu Basic settings nyní (nepovinně) nastavíte Nadpis stránky, který se objeví ve výstupu pro uživatele. Klikněte na dosavadní text None a v boxu Stránka: The title of this view, který se objeví dole, zadejte Přehled tiskových zpráv. Nyní si všimněte velmi důležitého tlačítka Override (brzy o něm ještě bude řeč) a klikněte na něj. Tím jste specifikovali, že nastavení, které právě provádíte, bude platit jen pro konkrétní display, tj. Stránku. (Kdybyste naopak chtěli přepsat defaultní nastavení, kliknete na Update default display; to však v tomto případě není cílem). Asi jste si všimli, že po kliknutí na Override se tlačítko změnilo (to proto, abyste se mohli kdykoliv později vrátit k defaultnímu nastavení, kdyby bylo třeba). Dejte Aktualizovat, můžete případně i Uložit.

(Ale pozor: pokud jakékoliv zobrazení/display uložíte, vrátíte se tím automaticky do záložky Defaults. Takže pokud občas pouze ukládáte rozdělanou práci, nezapomeňte se pak vrátit do správného zobrazení/display, které chcete editovat.)

Dále nastavte stránkování výstupu (Use pager: klikněte na Ne, dole zaškrtněte Full pager, dejte Override a Aktualizovat). Podobným způsobem můžete například změnit počet zobrazených položek na stránku (Items Per Page), omezit přístup k danému zobrazení (Access), zadat hlavičku a patičku stránky nebo text, který se objeví, když dané zobrazení neobsahuje žádné položky (Empty text). Nezapomeňte všechny změny nakonec Uložit.

BLOK

K dokonalosti by se možná by se hodil ještě boxík (blok), kde bude vždy několik aktuálních tiskových zpráv. K tomu účelu vyberte v levé části formuláře Blok a přidejte nové zobrazení (Add display). Ocitnete se v záložce Blok, kterou jste právě vytvořili, a vidíte, že základní nastavení opět odpovídá Default display (volby, které jste zadali specificky pro Stránku, by se zde neměly projevit, pokud jste ovšem během úprav nepřepsali defaultní nastavení). Zadejte Nadpis (Nové tiskové zprávy) a změňte Items to display na 3. Užitečná je volba More link, která umožní uživateli dostat se z bloku na přehled všech tiskových zpráv, tedy na display typu Stránka (klikněte a zaškrtněte Create more link)… samozřejmě pokaždé Override a Aktualizovat. V boxu Block settings > Admin zadejte název, pod kterým chcete nový blok najít ve standardní administraci bloků (například Nové TZ).

V bloku je méně místa než na stránce. Pro přehlednost bude lepší, když zde nebude „zaclánět“ datum vydání zprávy ani zdroj. Proto je třeba upravit box Fields. Klikněte na položku Uzly: Post date a uvidíte již známý formulář, kde máte možnost toto pole upravit, ale také odstranit.

DŮLEŽITÁ VSUVKA: Jako první musíte kliknout na tlačítko Override, což znamená: „změny budou platit pouze pro toto zobrazení“. Pokud byste to neudělali (a dali rovnou Remove), odstraníte pole ze všech ostatních zobrazení (a to i v případě, že nekliknete na Update default display!). To platí i pro případné další úpravy. Dále je nutné vědět, že u funkcí Filters, Arguments, Sort criteria a Relationships můžete zvolit Override buďto pro všechna nastavení, nebo pro žádná. Například: všechny změny polí se budou týkat jen daného zobrazení (Fields mají vlastnost Override), ale všechny filtry budou zděděné (Filtry mají vlastnost Use default).

Nyní to vyzkoušejte – odstraňte pole Uzly: Post date pouze ze zobrazení Blok: Dejte Override a pak Remove. Dále je třeba odstranit pole Obsah: Text: Úvodník (field_uvodnik). Klikněte na něj a měli byste vidět opět formulář pro editaci, ale už ne tlačítko Override (pochopitelně, protože vlastnost Override už jste jednou nastavili – nyní platí pro všechna Fields). V tomto případě tedy stačí zvolit Remove.

Další změny nejsou třeba, výsledek musíte opět Uložit. Nakonec je nutné nový blok zpřístupnit obvyklým způsobem v administraci bloků.

Výstupem je blok nazvaný Nové tiskové zprávy, který ukazuje vždy 3 nejnovější položky, a dále stránka Přehled tiskových zpráv, na kterou se uživatel dostane buď linkem „more“ z bloku (link je samozřejmě vhodné přeložit do češtiny), nebo přes odkaz Tiskové zprávy v Primary links.

Příklad 2: vyhledávání v katalogu odkazů

Představte si, že máte (pro naše účely jednoduchý) katalog odkazů na internetové stránky sportovních areálů. Potřebujete, aby si uživatel mohl položky katalogu sám filtrovat podle různých kritérií, v tomto případě podle regionu a nabízených služeb.

Suroviny:

• Typ obsahu Odkaz, který se nezobrazuje na titulní stránce. V praxi byste tento typ obsahu pravděpodobně ještě upravili pomocí CCK a přidali např. pole pro URL a další kontaktní údaje. Pro testovací účely (zde půjde hlavně o práci s filtry ve views) to nyní nebude nutné.
• Zapnutý modul Taxonomy.
• Slovníky Region a Nabídka, které přiřadíte k typu obsahu Odkaz. Zaškrtněte volby Vícenásobný výběr a Povinné.
• V každém slovníku několik pokusných kategorií. Do Regionu zadejte například názvy krajů a do Nabídky názvy sportů nebo služeb.
• Testovací obsah.

Postup:

Vytvořte view s názvem Katalog, jako View type zadejte opět Uzly.

DEFAULTS

Row style: Uzly (nyní pro zjednodušení postačí; kdybyste chtěli pracovat s poli, budete postupovat podobně jako v předchozím příkladu).
Defaults: Row style options: zaškrtněte Display only teaser a Display links (zobrazení náhledu vždy s linkem na uzel).
Use pager: Ano.
Empty text: Zadejte V této kategorii zatím nejsou žádné položky.
Filtry: Zaškrtněte Uzly: Typ a Uzly: Vydáno
Defaults: Configure filtr Uzly: Typ: zaškrtněte volby Is one of; Odkaz.
Defaults: Configure filtr Uzly: Vydáno: zaškrtněte Ano.
Sort criteria: Uzly: Post date
Defaults: Configure sort criterion Uzly: Post date:
Sort order: Descending
Granularity: Day
Uložit (!)

STRÁNKA

Přidejte display typu Stránka a nastavte:
Cesta: katalog
Menu: Typ: Normal menu entry, Nadpis: Katalog, Menu: Primary links
Nadpis: Přehled sportovních areálů
Items to display: 20
V dalším kroku nakonfigurujete tzv. Exposed filters – tj. filtry, které uvidí (a bude moci používat) uživatel přímo ve výstupu. Bude se jednat o výběr na základě taxonomických kategorií, proto budete pracovat s filtry ze skupiny Kategorie.
Nejprve klikněte na Filtry. Objeví se nová část formuláře, kde uvidíte, že Filtry dosud dědí defaultní nastavení (Status: using default values). To je třeba změnit – klikněte na Override.
Teprve nyní můžete přidat filtry specifické jen pro zobrazení Stránka:
Stránka: Add filters: Kategorie: Term
Stránka: Configure extra settings for filtr Kategorie: Term:
Vocabulary: Region
Selection type: Dropdown
Stránka: Configure filtr Kategorie: Term
Operator: Is one of
Klikněte na Expose
Filter identifier: můžete ponechat výchozí hodnotu nebo zadat vlastní (např. region)
Label: Zvolit region
Protože je povolen vícenásobný výběr, má smysl zašrktnout Reduce duplicates.
Z dalších voleb ponechte zaškrtnuté pouze políčko Nepovinné
… a nezapomeňte Aktualizovat

Podobným způsobem přidejte Exposed filter pro termíny ze slovníku Nabídka.

Nakonec všechny změny Uložte.

Výsledkem je stránka s názvem Přehled sportovních areálů, dostupná přes odkaz Katalog (Primary links), kde si uživatel může vybírat nezávisle podle 2 kritérií: Region a Nabídka. (V příkladu na obrázku existují pro každý slovník jen 3 pokusné kategorie, v praxi jich samozřejmě bude víc.)

TIPY NA DALŠÍ MOŽNOSTI:

• Pokud změníte volbu Style: Unformatted (zatím jsme s ní nepracovali) a zadáte Tabulka, můžete vytvořit tabulkový výstup. Budete zde povinně pracovat s poli (volba Row style zmizí). Na tomto příkladu si ukážeme ještě nastavení stylu: v řádku, kde je nyní napsáno Style: Tabulka klikněte na ikonku vpravo a obdržíte patřičný formulář, se kterým si můžete dle libosti vyhrát. Velice užitečná je možnost Sortable, která umožní, aby si uživatel sám řadil výstupy podle zadaných kritérií (ve výsledku je to cosi jako funkce „Exposed“ u filtrů, jen způsob nastavení je jiný).
• Můžete vytvořit display typu Blok, kde budete pro změnu pracovat s poli (Row style: zadat Override a volbu Fields), a kde zobrazíte nejnovější odkazy (postup je podobný jako u příkladu s tiskovými zprávami).
• Nastavením filtru například pro Uzly: Text, Uzly: Nadpis či Obsah: „Název nově přidaného pole“ (máte-li nějaké; viz modul CCK) můžete uživateli zpřístupnit (Expose) vyhledávání podle klíčových slov či jejich částí, kombinace začátečních písmen apod.
• Dosud jsem se nezmínila o funkcích Arguments a Relationships. Arguments jsou cosi jako „pokročilé filtry“ (nápovědu k nim najdete zde: http://views-help.doc.logrus.com/…ews/argument) a Relationships (http://views-help.doc.logrus.com/…relationship) umožňují při výstavbě views využít vztahy mezi objekty, se kterými pracujete (příklad: uzel-uživatel, uzel-komentář, komentář-uživatel). EDIT: připojuji ještě odkaz na svou prezentaci k argumentům z českého Drupal setkání (leden 2010): http://www.drupal.cz/…amkami_3.pdf

Nehledě na popsané příklady existuje samozřejmě mnoho dalších možností využití (dosud jsme se zabývali jen pohledy pro uzly, ale podobně můžete pracovat s taxonomickými kategoriemi, uživateli, komentáři…). Kromě základní nabídky views nezapomeňte na rozšiřující moduly: http://drupal.org/…/category/89.

Další informace:

Views online help (http://views-help.doc.logrus.com/…d_help/views)

Eva Rázgová