Zum Ende der Metadaten springen
Zum Anfang der Metadaten

Sie zeigen eine alte Version dieser Seite an. Zeigen Sie die aktuelle Version an.

Unterschiede anzeigen Seitenhistorie anzeigen

« Vorherige Version anzeigen Version 15 Nächste Version anzeigen »

Ansichten sind Darstellungselemente, die sich auf Seiten platzieren lassen.

Aufbau

Eine Ansicht sollte sich innerhalb der Ordnerstruktur einer App immer im Namespace "View" befinden, bspw. für die Ansicht "Text / Bild" lautet der Ordner:

plugin/remote/brandbox/cms-layout-standard/src/View/Tile

Im weiteren Verlauf "Paketordner" genannt.
Unterhalb des Paketordners muss sich eine PHP-Datei "Engine.php" und außerdem ein Ordner "views" befinden. Eine platzierbare Ansicht benötigt dort immer mindestens 2 Dateien:

config.json

view.hbs

Engine.php

Diese Datei liegt direkt im Paketordner und stellt die öffentlichen Endpunkte für die Ansichten bereit. Ein Endpunkt entspricht einer öffentlichen Methode in dieser Datei.

Am Beispiel "Text / Bild":

public function tile($viewID)
{
    $paragraph = new FrameworkStyleguide\Entity\FrameworkParagraph();
    $paragraph->content = new FrameworkStyleguide\StringSafe('Hello World');
	return [
       'paragraph' => $paragraph
    ];
}

config.json

Diese Konfigurationsdatei im JSON-Format vergibt wichtige Parameter für platzierbare Views:

ParameterBeschreibung
coreTypeMuss für CMS-Ansichten immer "cms-core" lautet (es gibt auch andere Arten von Ansichten).
friendlyNameDer Name der Ansicht ein allen gewünschten Sprachen, wird beim Platzieren im CMS-Designer dargestellt.
dependsDie Paketnamen von CMS-Themes, für die die View platzierbar ist.

Hier beispielhaft der Inhalt der config.json für "Text / Bild":

{
  "coreType": "cms-core",
  "friendlyName": {
    "de": "Text / Bild",
    "en": "Text / Image"
  },
  "depends":
    ["Theme/DefaultCms"]
  }

view.hbs

Diese Datei regelt den HTML-Inhalt der Ansicht. In ihr können Partial-Calls aus dem verwendeten Styleguide platziert werden.
Außerdem können Styleguide-Elemente, die in einem zugehörigen öffentlichen Endpunkt in der Engine.php (siehe oben) aufgebaut wurden, platziert werden. Dieser Endpunkt wird beim Aufbau der Seite, auf der die Ansicht platziert wurde, automatisch aufgerufen.
Der Endpunkt ist eine öffentliche PHP-Methode mit dem Namen des Ordners unterhalb des Ordners "views" und muss einen Array mit benamten Array-Keys zurückgeben, denen Styleguide-Elemente zugeordnet werden:

Am Beispiel "Text / Bild" (vgl. oben Engine.php):

"paragraph" steht in der view.hbs über die serve-Variable zur Verfügung:

{{{ compile serve.paragraph }}}

Ermittlung des Endpunkt-Namens

config.json-Dateien für Ansichten werden in bis zu 3 Ordnerebenen unter dem Ordner "views" gefunden. Der Feature-Name ergibt sich aus dem Namen der Ordner im CamelCase-Style.
Beispiele:

Pfad zur hbs-DateiName der Feature-Methode in der Engine.php
views/my/new/feature/view.hbsmyNewFeature
views/single/slider/view.hbssingleSlider
views/tile/view.hbstile
  • Keine Stichwörter