Startseite / Vorlagenentwicklung / WebEdit / Quick-Edit

Quick-Edit

Quick-Edit-Leiste auf Seitenebene

Die Funktionalität „Quick-Edit“ stellt eine schnelle und einfache Möglichkeit zur Verfügung, um auf Seiten- und Absatzebene redaktionelle Änderungen und Prozesse durchzuführen.

Auf Seitenebene stehen den Redakteur z. Zt. folgende Operationen zur Verfügung:

Anlegen einer neuen Menüebene
Anlegen einer neuen Seite
Anlegen eines neuen Absatzes
Bearbeitung der Seite in der Inhalte-Verwaltung
Arbeitsablauf auf der Seitenreferenz starten oder weiterschalten
Bearbeitung der Metadaten der Seitenreferenz
Seite löschen
Hilfe

Einige dieser Funktionen werden durch die Easy-Edit-Funktionalitäten abgedeckt. Ab FirstSpirit-Version 5.0 wird die Quick-Edit-Leiste nicht mehr unterstützt und durch Easy-Edit ersetzt.

Quick-Edit-Leiste auf Absatzebene

Die Operationen auf Absatzebene sind:

Anlegen eines neuen Absatzes
Bearbeitung des Absatzes in der Inhalte-Verwaltung
Absatz eine Position nach oben verschieben
Absatz eine Position nach unten verschieben
Metadaten des Absatzes bearbeiten
Absatz löschen
Hilfe

Ab FirstSpirit-Version 5.0 wird die Quick-Edit-Leiste nicht mehr unterstützt und durch Easy-Edit ersetzt.

Um Quick-Edit nutzen zu können, sind zwei Schritte nötig:

es müssen generelle Funktionen auf Seitenebene zur Verfügung gestellt werden,
die Quick-Edit-Buttons müssen auf Seiten- bzw. Absatzebene eingebunden werden.

Weitere Informationen zu den im Folgenden aufgeführten Parametern siehe Kapitel WebEdit-Formatvorlagen.

Generelle Funktionen von Quick-Edit auf Seitenebene

Alle Seiten eines WebEdit-Projekts, die die Quick-Edit-Funktion verwenden sollen, müssen modifiziert werden. Empfohlen wird, die Einstellungen direkt in den Seitenvorlagen vorzunehmen. Dazu müssen zunächst im WebEdit-Präsentationskanal die generellen Quick-Edit-Funktionen zur Verfügung gestellt werden. Zusätzlich zur Render-Formatvorlage WEBeditIncludeJS muss in den Seitenvorlagen noch die Render-Formatvorlage WEBeditBarIncludeJS zwischen dem öffnenden und schließenden HTML-Head-Tag eingefügt werden:

...
<html>
  <head>
    <title>Seitenvorlage</title>
    $CMS_RENDER(template:"WEBeditIncludeJS")$
    $CMS_RENDER(template:"WEBeditBarIncludeJS")$
  </head>
  <body>
...

Die Render-Formatvorlage WEBeditBarIncludeJS benötigt genau wie WEBeditIncludeJS keine zusätzlichen Parameter.

Quick-Edit-Buttons

Quick-Edit-Buttons können sowohl auf Seiten- als auch auf Absatzebene eingebunden werden. Für einen Quick-Edit-Button ist in der Seiten- oder Absatzvorlage ein Render-Aufruf einzufügen:

$CMS_RENDER(template:"WEBeditQuickBar")$

Ob die Seiten- oder die Absatzoperation in Quick-Edit angezeigt werden, richtet sich danach, ob der Render-Aufruf in der Seiten- oder Absatzvorlage eingefügt wird.

Es darf NUR EIN Render-Aufruf für WEBeditQuickBar in einer Seiten- oder Absatzvorlage erfolgen.

Ausblenden von Buttons

Über das Attribut disableButtons können die Buttons „Seite anlegen“ und „Extras“ der Quick-Edit-Leiste (auf Seitenebene) ausgeblendet werden.

Dafür muss der Render-Aufruf in der Seitenvorlage angepasst werden.

Beispiel für das Ausblenden des Buttons „Extras“:

$CMS_RENDER(template:"WEBeditQuickBar",disableButtons:"extras")$

Beispiel für das Ausblenden der Buttons „Seite anlegen“ und „Extras“:

$CMS_RENDER(template:"WEBeditQuickBar",disableButtons:"newpage,extras")$

Quick-Edit-Leiste

Da die Quick-Edit-Leiste beim Ausklappen einen Teil des Inhaltes überlappt und der Platz für das Ausklappen in einer Richtung kleiner als die Quick-Edit-Leiste sein kann, sollte die Ausklapprichtung für die Quick-Edit-Leiste angeben werden. Der Parameter für die Ausklapprichtung heißt barOrientation. Die beiden möglichen Werte lauten „right“ (Quick-Edit-Leiste klappt nach rechts auf) und „left“ (Quick-Edit-Leiste klappt nach links auf). Ist der Parameter nicht angegeben, so klappt die Quick-Edit-Leiste immer nach rechts auf.

$CMS_RENDER(template:"WEBeditQuickBar",barOrientation:"left")$

Zusätzlich zur Ausrichtung der Quick-Edit-Leiste kann das initiale Ausklappverhalten geändert werden. Das Ausklappverhalten ist für genau eine Quick-Edit-Leiste auf einer Seite, d.h. für die Seitenvorlage und alle verwendeten Absatzvorlagen konfigurierbar. Der Name des Attributes lautet extended. Mögliche Werte sind „true“ (initial ausgeklappt) und „false“ (initial eingeklappt). Ist der Parameter nicht angegeben, so ist die Quick-Edit-Leiste initial eingeklappt.

$CMS_RENDER(template:"WEBeditQuickBar",extended:"true")$

Hervorhebung von Seitenbereichen

Wird Quick-Edit in einem Projekt genutzt, ist die Zugehörigkeit eines Quick-Edit-Buttons zum Absatz einer Seite nicht immer offensichtlich. Ein Button kann beispielsweise zum vorherigen oder zum nachfolgenden Absatz gehören. Um die Zugehörigkeit für den Redakteur zu visualisieren, können Seitenbereiche bzw. Abschnitte besonders hervorgehoben werden. Für die Hervorhebung gibt es die Attribute highlightContainer und hightlightClass.

Mit highlightContainer wird eine eindeutige ID angegeben, die einem HTML-Tag zugewiesen ist, dessen Inhalt hervorgehoben werden soll. Zur Ausgabe von seitenbezogenen Informationen kann das Systemobjekt #global verwendet werden. Um eine eindeutige ID zu erzeugen, können die CMS-Variablen

#global.id (ID des Knotens),
#global.page.id (ID der Seite) und
#global.section.id (ID des Absatzes)

zur Hilfe genommen werden.

Für das HTML-Tag, dessen Inhalt hervorgehoben werden soll, darf kein „class“-Attribut definiert sein.

1. Beispiel: HTML-Tag, dessen Inhalt hervorgehoben werden soll:

<div>
  $CMS_VALUE(fr_st_text)$
</div>

könnte beispielsweise nach Hinzufügen des “id”-Attributes so aussehen:

<div id="hc$CMS_VALUE(#global.section.id)$">
  $CMS_VALUE(fr_st_text)$
</div>

2. Beispiel: Angabe der ID im Render-Aufruf von “WEBeditQuickBar”:

$CMS_RENDER(template:"WEBeditQuickBar")$

Der Aufruf könnte beispielsweise nach dem Hinzufügen des highlightContainer-Attributes folgendermaßen aussehen:

$CMS_RENDER(template:"WEBeditQuickBar",highlightContainer:"hc" + #global.section.id)$

Im Beispiel würde der Inhalt des Elementes mit der ID "hc" + #global.section.id besonders hervorgehoben, wenn die Quick-Edit-Leiste geöffnet wird.

Das zweite Attribut highlightClass kann genutzt werden, um eine benutzerdefinierte CSS-Klasse für Hervorhebungen anzugeben. Wird der Parameter highlightClass nicht angegeben, wird die CSS-Klasse weHighlight verwendet, die folgenden Inhalt hat:

.weHighlight{
  background-color:ffffd3 !important;
  border:1px solid #464600 !important;
}

Eine benutzerdefinierte CSS-Klasse wird folgendermaßen angegeben:

$CMS_RENDER(template:"WEBeditQuickBar",highlightContainer:"hc" + #global.section.id,highlightClass:"webEditHervorhebung")$

Die benutzerdefinierte CSS-Klasse könnte z.B. dann folgendermaßen aussehen:

<style type="text/css">
  .webEditHervorhebung {
    background-color:#008000 !important;
  }
</style>

Bei tabellenlosen Webseiten kann es im Internet Explorer zu Problemen kommen, wenn mit dem CSS-Attribut „float“ gearbeitet wird. Wenn der umfließende Bereich eine Breite von 100% hat und bei der Hervorhebung umrandet werden soll, fällt das Layout zusammen. In den meisten Fällen hilft es dann, ein anderes HTML-Tag zu verwenden oder die Breite zu reduzieren.

Arbeitsablaufempfehlungen

In der Quick-Edit-Leiste wird bei den Arbeitsabläufen ermittelt, in welchem Status sich das Objekt befindet. Folgende Statuswerte werden unterschieden:

„neu“,
„geändert“ und
„löschen“

Für jeden Status kann jeweils ein Arbeitsablauf empfohlen werden. Die Attribute hierfür lauten: wfNew (Status „neu“), wfChange (Status „geändert“) und wfDelete (Status „löschen“). Bei den Attributen ist der Name des Arbeitsablaufes anzugeben, z.B. „Freigabe Anfordern“.

Zusätzlich kann man die sofortige Ausführung des empfohlenen Arbeitsablaufes mit dem Attribut wfForce erzwingen. Die möglichen Werte sind „true“ und „false“ (Standardvorbelegung).

$CMS_RENDER(template:"WEBeditQuickBar",wfNew:"Freigabe Anfordern",wfForce:"true")$

Für Elemente, die über die Quick-Edit-Funktionen „Menüebene anlegen“ und „Seite anlegen“ neu angelegt wurden, wird ein spezieller Arbeitsablauf zur abhängigen Freigabe von Elementen benötigt. Ein solcher Arbeitsablauf ist nicht im Lieferumfang von WebEdit enthalten, da sich die Konfiguration eines solchen Arbeitsablaufs projektspezifisch stark unterscheiden kann.

Druckversion | Seitenanfang