Einen Ansichtstyp hinzufügen #

Ein Ansichtstyp ist ein Aussehen eines Blocktyps. Der List-Block bietet list, grid, list_numbered, list_zigzag, list_accordion und grid_featured. Diese Seite fügt einen siebten hinzu, list_compact: eine schlichte Liste von Links mit Datum.

Inhalt #

1. Deklarieren
2. Sein Template schreiben
3. Die Caches leeren
4. Im Editor auswählen
5. Das Ergebnis

1. Deklarieren #

extension/mysite/settings/explayouts.ini.append.php:

<?php /* #?ini charset="utf-8"?

# A new view type for the List block: a compact list of links
[BlockDefinition_list]
ViewTypes[]=list_compact

*/ ?>

Ohne Zurücksetz-Zeile (ViewTypes[] allein) wird der Wert zu den sechs Ansichtstypen aus extension/explayouts/settings/explayouts.ini.append.php hinzugefügt. Prüfen Sie es:

$ ./console exp:ini where explayouts.ini/BlockDefinition_list/ViewTypes site
...
In effect:
      ViewTypes[]=list_compact
      ViewTypes[]=list
      ViewTypes[]=grid
      ViewTypes[]=list_numbered
      ViewTypes[]=list_zigzag
      ViewTypes[]=list_accordion
      ViewTypes[]=grid_featured

2. Sein Template schreiben #

Das Media-Design stellt einen List-Block mit explayouts/block/list.tpl dar, das explayouts/block/list/<view type>.tpl einbindet. Das neue Template ist also extension/mysite/design/media/templates/explayouts/block/list/list_compact.tpl:

{if $block.values.items|count|gt( 0 )}
<ul class="list-compact">
{foreach $block.values.items as $lc_item}
    <li class="list-compact-item">
        <a href={$lc_item.url_alias|ezurl}>{$lc_item.name|wash}</a>
        <time datetime="{$lc_item.object.published|datetime( 'custom', '%Y-%m-%d' )}">{$lc_item.object.published|l10n( 'shortdate' )}</time>
    </li>
{/foreach}
</ul>
{/if}

$block.values.items enthält die Inhaltsknoten der Sammlung des Blocks, manuell oder dynamisch.

3. Die Caches leeren #

./console exp:cache clear --tag=template,content,ini

4. Im Editor auswählen #

Wählen Sie einen List-Block aus, Reiter Design, Ansichtstyp: list_compact wird angeboten. Wenn Sie ihn wählen, werden die Optionen ausgeblendet, die zu den anderen Ansichtstypen gehören (Spalten, Ansichtstyp der Elemente).

Hinweis: Vor explayouts_ui_api 1.3.29 wurde der Block nicht gespeichert, wenn nur der Ansichtstyp auf einen wie diesen geändert wurde, bei dem kein Ansichtstyp der Elemente zur Wahl bleibt; die Änderung wurde zusammen mit der nächsten Änderung eines anderen Felds gespeichert (auf der Testkopie eine in CSS class getippte und wieder gelöschte Taste). Ab 1.3.29 wird die Änderung sofort gespeichert. Prüfen Sie den Blockkopf: Er zeigt den gespeicherten Ansichtstyp in Großbuchstaben, hier LIST_COMPACT.

5. Das Ergebnis #

Nach Layout veröffentlichen zeigt der Prefooter der Artikelseiten die kompakte Liste:

Gestalten Sie .list-compact im Stylesheet Ihres Designs (Ihre Blöcke gestalten).

Verwandte Seiten #

• Wie ein Block seinen Templates zugeordnet wird
• Einen Blocktyp hinzufügen
• Ihre eigene Design-Erweiterung
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.