Startseite / Weiterführende Themen / Content Highlighting / InplaceEditBegin/End

WEBeditInplaceEditBegin / End

Die Render-Formatvorlagen WEBeditInplaceEditBegin und WEBeditInplaceEditEnd können in Seiten-, Absatz- und Tabellenvorlagen verwendet werden. In Absatz- und Tabellenvorlagen stellen sie die Content Highlighting-Funktionalität auf Absatzebene zur Verfügung (siehe auch Inhalte-Verwaltung: Absätze), in Seitenvorlagen ermöglichen sie die Hervorhebung aller Inhalte, die auf Seitenebene gepflegt werden (siehe auch Inhalte-Verwaltung: Seiten).

Jeder WEBeditInplaceEditBegin-Ausdruck muss durch einen WEBeditInplaceEditEnd-Ausdruck wieder geschlossen werden. Beide Aufrufe umschließen den HTML-Bereich, der in der Integrierten Vorschau bei der Auswahl eines Absatzes in der Baumstruktur hervorgehoben werden soll.

Es sollten keine Schachtelungen vorgenommen werden: jedes WEBeditInplaceEditBegin sollte vor dem nächsten WEBeditInplaceEditBegin erst wieder mit WEBeditInplaceEditEnd geschlossen werden.

Durch die Verwendung von WEBeditInplaceEditBegin und WEBeditInplaceEditEnd werden zusätzlich <div>-Container eingefügt.

<body>
    $CMS_RENDER(template:"WEBeditInplaceEditBegin")$
    ...
    $CMS_RENDER(template:"WEBeditInplaceEditEnd")$
</body>

Zwischen beiden Aufrufen können jedoch Aufrufe der Render-Formatvorlage WEBeditInplaceAttributeBegin/End verwendet werden.

Hervorheben von Datensatz-Absätzen

Datensätze werden üblicherweise in der Datenquellen-Verwaltung zentral gepflegt, können jedoch an mehreren Stellen einer Website mithilfe unterschiedlicher Tabellenvorlagen und damit unterschiedlicher Layouts ausgegeben werden. In diesen Fällen ist die Verknüpfung zwischen dem Arbeitsbereich, in dem Datensätze über Eingabekomponenten bearbeitet werden können, und der Integrierten Vorschau, in der die Inhalte aus diesen Eingabekomponenten hervorgehoben werden, möglicherweise nicht automatisch gegeben (siehe auch Datenquellen-Verwaltung: Eingabekomponenten):

Beispiel: Auf einer Unternehmens-Website werden Pressemitteilungen oder Informationen zu Produkten als einzelne Datensätze in Datenquellen gepflegt. Diese werden einerseits auf Einzelseiten ausgegeben (eine Seite pro Pressemitteilung bzw. Produktbeschreibung), andererseits auf einer Übersichtsseite verwendet, auf der beispielsweise nur bestimmte Inhalte der Datensätze ausgegeben ("Teaser") werden. Einzel- und Übersichtsseite basieren auf unterschiedlichen Tabellenvorlage, allerdings enthält nur die Tabellenvorlage für die Einzelseiten die Definition der Eingabekomponenten zur Pflege der Datensätze. Das Register "Formular" der Tabellenvorlage für die Übersichtsseite ist leer. In der Ausgabe bezieht sie ihre Inhalte aus der Datenquelle mit den Einzel-Datensätzen.

Für die Tabellenvorlage, für die keine Eingabekomponenten definiert sind (Übersichtsseite), müssen für eine korrekte Verknüpfung zwischen der Ansicht im Arbeitsbereich und der Integrierten Vorschau einige fehlende Informationen manuell angegeben werden, und zwar über die Parameter content, id, pageRef und view.

Dabei müssen alle Vorlagen, die denselben Datensatz ausgeben, dieselben Werte für diese Parameter haben.

Diese Parameter werden im Folgenden anhand des gegebenen Beispiels erläutert.

content

Dieser Parameter wird üblicherweise in Vorlagen verwendet, die Datensätze ausgeben, aber keine Formulare zur Eingabe von Daten bieten, oder für Datensätze, die über die Funktion contentSelect ausgegeben werden. Über diesen Parameter wird die UID der Tabellenvorlage angegeben, in der die Pflegemaske (Formulare) hinterlegt ist. Der Parameter content muss mit dem Parameter index verwendet werden.
Im Beispiel wird in der Tabellenvorlage für die Pressemitteilungs-Übersichtsseiten über content die UID derselben Tabellenvorlage angegeben.

index

Über diesen Parameter wird die ID des Datensatzes angegeben, der im Arbeitsbereich angezeigt werden soll, direkt in doppelten Hochkommata oder dynamisch, z.B. über das Systemobjekt #row. Dieser Parameter muss mit dem Parameter content verwendet werden.

Für die Verwendung von content und index werden folgende Fälle unterschieden:

Content-Projektion (Absatz, der auf einer Tabellenvorlage basiert): content und index sind vorbelegt, können aber manuell überschrieben werden.
Datensätze, die über die Funktion contentSelect in einer Content-Projektion ausgegeben werden: content und index sind (potentiell fehlerhaft) vorbelegt und können bzw. müssen entsprechend manuell geändert werden.
Datensätze, die über die Funktion contentSelect außerhalb einer Content-Projektion ausgegeben werden: content und index sind nicht vorbelegt und müssen manuell angegeben werden.

view

Über diesen Parameter wird die UID der Datenquelle in der Datenquellen-Verwaltung angegeben, in der die Pflegemaske (Formulare) für den Datensatz hinterlegt sind. Der Parameter muss in jeder Vorlage angegeben werden, über die Datensätze ausgegeben werden.
Im Beispiel wird für beide Vorlagen (für die Tabellenvorlage für Pressemitteilungs-Einzelseiten und für die Vorlage für Pressemitteilungs-Übersichtsseiten) für den Parameter view die Datenquelle angegeben, in der die Pressemeldungen gepflegt werden.

pageRef

Dieser Parameter muss in Tabellenvorlagen oder in einem ContentSelect angegeben werden, die über keine Pflegemaske (Formulare) verfügen. Er gibt die Seitenreferenz an, die die entsprechende Tabellenvorlage mit Pflegemaske ausgibt. Dabei ist die Tabellenvorlage zu wählen, über die der gleiche Datensatz gepflegt wird, wie der, der über die Tabellenvorlage ausgegeben wird, die keine Pflegemaske hat.

Dem Parameter kann ein Seitenreferenz-Objekt übergeben werden. Alternativ kann die ref(...)-Funktion zur Angabe des Seitenreferenz-Objekts genutzt werden.

Im Beispiel wird für die Vorlage für die Pressemitteilungs-Übersichtsseiten für den Parameter pageRef die Seitenreferenz zu einer Seite angegeben, auf der die Einzel-Pressemitteilungen eingebunden sind.

Die Parameter content, index, view und pageRef müssen bei jedem Aufruf von WEBeditInplaceAttributeBegin angegeben werden, z.B.

$CMS_RENDER(template:"WEBeditInplaceEditBegin", content:"Products.contacts", index:contactEntity.getId(), view:"kontakte")$

Um die Parameter für die gesamte Seiten-, Absatz- oder Tabellenvorlage zu verwenden, kann über $CMS_SET(...)$ vor dem Aufruf von WEBeditInplaceEditBegin ein Wert für jeden Parameter definiert werden, z.B.

$CMS_SET(content, "Products.press_releases_overview")$  
$CMS_SET(index, #row.getId())$
$CMS_SET(pageRef, ref(pageref:"pressreleasesdetails"))$
$CMS_SET(view, "pressreleases")$

Die hier definierten Werte stehen im Kontext der jeweiligen Vorlage zur Verfügung sowie im gesamten tieferen Kontext. Daher muss darauf geachtet werden, dass es nicht zu Überschneidungen kommt, indem z.B. für Verwendungen von WEBeditInplaceEditBegin/End in einem tieferen Kontext andere Werte für die Parameter content, index, pageRef und view definiert werden!

Parameter zur Hervorhebung von Datensätzen

Die Parameter content, id und pageRef sind nur für Tabellenvorlagen erforderlich, die Datensätze ausgeben, aber keine Pflegemaske (Formulare) enthalten, sowie für Datensätze, die über die Funktion contentSelect ausgegeben werden.

Parameter	Erläuterung / Beispiel
content	Angabe der UID der Tabellenvorlage in doppelten Hochkommata, in der die zugehörige Pflegemaske hinterlegt ist, z.B. content:"Products.product_overview" Dieser Parameter muss zusammen mit dem Parameter index verwendet werden.
index	Angabe der ID des Datensatzes, der in der Integrierten Vorschau angezeigt werden soll. Die ID wird direkt in doppelten Hochkommata oder z.B. über das Systemobjekt #row dynamisch angegeben, z.B. index:#row.getId() Dieser Parameter muss zusammen mit dem Parameter content verwendet werden.
view	Angabe der UID der Datenquelle in der Datenquellen-Verwaltung, die im Arbeitsbereich angezeigt werden soll, wenn in der Integrierten Vorschau ein Datensatz angeklickt wird, der von der jeweiligen Vorlage gerendert wird, z.B. view:"produkte"
pageRef	Angabe der Seitenreferenz, die in der Vorlage mit der Pflegemaske (Formulare) definiert ist, z.B.: pageRef:ref(pageref:"pressreleasesdetails") oder pageRef:ref(ss_product_details)

Parallele Verwendung mit Easy-Edit

Die Parameter content und index werden sowohl für das Content Highlighting als auch die Easy-Edit-Funktionalität verwendet und können parallel eingesetzt werden. Hinweise zur Verwendung und Einschränkungen in Easy-Edit siehe dort.

Druckversion | Seitenanfang