Ansichtsmodi #

Diese Seite richtet sich an Entwickler, bei denen derselbe Artikel wie eine Seite, ein Listeneintrag, eine Karte und ein eingebetteter Kasten aussehen muss. Exponential trennt, was gezeigt wird (das Objekt), von wie (dem Ansichtsmodus): Jeder Zusammenhang fragt nach einem Ansichtsmodus, und jede Klasse kann je Modus ein eigenes Template haben. Templates, die Inhalte auflisten, müssen nie wissen, welche Klassen sie auflisten.

Inhalt #

1. Die Idee
2. Die mitgelieferten Ansichtsmodi
3. Wie ein Modus gewählt wird
4. Ein Template je Klasse und Modus
5. Eigene Ansichtsmodi
6. Ansichtsmodi in Einbettungen und Layouts
7. Caching
8. Die Modi einer Website planen

Die Idee #

article "Opening of the new hall"
  full   -> the article page                 (node/view/full.tpl -> full/article.tpl)
  line   -> one row in the news list          (node/view/line.tpl -> line/article.tpl)
  card   -> a card on the front page          (node/view/card.tpl -> card/article.tpl)
  embed  -> a box inside another article       (content/view/embed.tpl -> embed/article.tpl)

Ein Listen-Template zeichnet jedes Unterelement mit node_view_gui und einem Modusnamen; das richtige Template je Klasse finden die Override-Regeln. Kommt später eine Klasse hinzu, braucht sie Templates für diese Klasse, keine Änderungen an jeder Liste.

Die mitgelieferten Ansichtsmodi #

Templates: Ansichtsmodi, Full View, Line View, Embed View.

Wie ein Modus gewählt wird #

Ein Template je Klasse und Modus #

node/view/<mode>.tpl ist der Standard für jede Klasse. Eine Regel gibt einer Klasse ihr eigenes Template für einen Modus:

[exp_mysite_line_event]
Source=node/view/line.tpl
MatchFile=line/exp_event.tpl
Subdir=templates
Match[class_identifier]=exp_event

{* extension/exp_mysite/design/exp_mysite/override/templates/line/exp_event.tpl *}
<article class="exp-line exp-line--event">
    <h3><a href={$node.url_alias|ezurl}>{$node.name|wash()}</a></h3>
    <p>{$node.data_map.start_date.content.timestamp|l10n( 'shortdate' )}</p>
</article>

Regeln und ihre Reihenfolge: Templates und Overrides für CMS-Entwickler.

Eigene Ansichtsmodi #

Ein Modus ist nur ein Name, für den es Templates gibt. So fügen Sie card hinzu:

1. Legen Sie den Standard design/exp_mysite/templates/node/view/card.tpl für jede Klasse an; ein Modus ohne Standard-Template irgendwo in der Design-Kette schlägt fehl.
2. Fügen Sie Regeln und Templates für die Klassen hinzu, die eine eigene Karte brauchen.
3. Verwenden Sie ihn: {node_view_gui content_node=$child view='card'}.
4. Leeren Sie den Template-Override-Cache (php bin/php/ezcache.php --clear-id=template-override --allow-root-user).

Vermeiden Sie die Namen, die der Kernel bereits verwendet. Versehen Sie Ihre eigenen mit einem Präfix, wenn sie mit einem Theme kollidieren könnten, auf dem Sie aufbauen (exp_card). Das Rezept der Designer: Eigene Ansichtsmodi.

Ansichtsmodi in Einbettungen und Layouts #

Redakteure wählen unter den Embed-Ansichtsmodi, die content.ini [embed] AvailableViewModes[] listet; fügen Sie Ihre eigenen dort hinzu, in content.ini.append.php Ihrer Erweiterung, mit einem Template je Klasse (Für die Einbettungen der Redakteure). Exponential Layouts zeichnet die Elemente eines Blocks in einem View-Typ der Blockdefinition; Block-Templates können Elemente ebenfalls mit Ihren Ansichtsmodi zeichnen (Einen View-Typ hinzufügen, View-Templates für Blöcke).

Caching #

site.ini [ContentSettings] CachedViewModes=full;sitemap;pdf: Diese Modi werden, als Seiten geöffnet, im View-Cache gespeichert. Modi, die innerhalb eines anderen Templates gezeichnet werden (line, card, embed), werden als Teil der Seite zwischengespeichert, die sie zeichnet; eine Änderung an einem Artikel erreicht also eine Karte auf der Startseite, wenn der Cache dieser Seite geleert wird (Caching für CMS-Entwickler).

Die Modi einer Website planen #

Schreiben Sie je Klasse eine Tabelle: welche Modi sie braucht, mit einer Skizze von jedem. Eine typische Website braucht full, line, einen Karten- oder Teaser-Modus und embed für die Klassen, die Redakteure einbetten. Wenige Modi, die überall verwendet werden, lassen sich leichter einheitlich halten als ein Modus je Seite (Die Ansichtsmodi eines Designs planen).

Verwandte Seiten #

• Inhalte in Templates abrufen
• Ansichtsmodi für Website-Bauer
• Knoten-Templates nach Klasse
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.