Anpassen von Ansichten von Seiteneigenschaften

Jede Seite hat eine Reihe von Eigenschaften, die von Nutzern angezeigt und bearbeitet werden können. Einige sind erforderlich, wenn die Seite erstellt wird (Erstellungsansicht), andere können später angezeigt und bearbeitet werden (Bearbeitungsansicht). Diese Seiteneigenschaften werden über das Dialogfeld (cq:dialog) der entsprechenden Seitenkomponente definiert und bereitgestellt.

Der Standardstatus für jede Seiteneigenschaft ist wie folgt:

• In der Erstellungsansicht ausgeblendet (z. B. im Seitenerstellungsassistenten)

• In der Bearbeitungsansicht verfügbar (z. B. unter Eigenschaften anzeigen)

Felder müssen einzeln konfiguriert werden, wenn eine Änderung erforderlich ist. Dies erfolgt mithilfe der entsprechenden Knoteneigenschaften:

• Seiteneigenschaft, die in der Erstellungsansicht verfügbar sein soll (z. B. im Seitenerstellungsassistenten):

  • Name: cq:showOnCreate
  • Typ: Boolean

• Seiteneigenschaft, die in der Bearbeitungsansicht verfügbar sein soll (z. B. View/Edit) Properties option):

  • Name: cq:hideOnEdit
  • Typ: Boolean

Sehen Sie als Beispiel die Einstellungen für Felder, die unter Weitere Titel und Beschreibungen auf der Registerkarte Allgemein der Foundation-Seitenkomponente gruppiert sind. Sie sind im Seitenerstellungsassistenten verfügbar, da cq:showOnCreate auf true gesetzt ist:

/libs/foundation/components/page/cq:dialog/content/items/tabs/items/basic/items/column/items/moretitles

Konfiguration von Seiteneigenschaften

Sie können diese Felder auch konfigurieren, indem Sie das Dialogfeld Ihrer Seitenkomponente konfigurieren und die entsprechenden Knoteneigenschaften anwenden.

Beispiel: Der Seitenerstellungsassistent zeigt standardmäßig die Felder an, die unter Weitere Titel und Beschreibungen gruppiert sind. Um diese auszublenden, nehmen Sie folgende Konfiguration vor:

1. Erstellen Sie Ihre Seitenkomponente unter /apps.

2. Erstellen Sie eine Überschreibung (mithilfe von dialog diff, bereitgestellt vom Sling Resource Merger) für den Abschnitt basic Ihrer Seitenkomponente. Beispiel:

   <your-page-component>/cq:dialog/content/items/tabs/items/basic
   

   HINWEIS

   Siehe als Referenz:

   /libs/wcm/foundation/components/basicpage/v1/basicpage/cq:dialog
   

   Sie dürfen jedoch keine Änderungen am Pfad /libs vornehmen.

   da der Inhalt von /libs überschrieben wird, wenn Sie die Instanz das nächste Mal aktualisieren. (Außerdem kann der Inhalt auch durch Anwenden von Hotfixes oder Feature Packs überschrieben werden.)

   Die empfohlene Methode zur Konfiguration und für andere Änderungen sieht wie folgt aus:

   1. Erstellen Sie das erforderliche Element (d. h. wie es in /libs vorhanden ist) unter /apps neu.
   2. Nehmen Sie die gewünschten Änderungen in /apps vor.

3. Legen Sie die Eigenschaft path auf basic fest, um auf die Außerkraftsetzung der grundlegenden Registerkarte zu verweisen (siehe auch den nächsten Schritt). Beispiel:

   /apps/demos/components/page/tabs/basic
   

4. Erstellen Sie eine Überschreibung des Abschnitts basic - moretitles im entsprechenden Pfad. Beispiel:

   /apps/demos/components/page/tabs/basic/items/column/items/moretitles
   

5. Wenden Sie die entsprechende Knoteneigenschaft an:

   • Name: cq:showOnCreate
   • Typ: Boolean
   • Wert: false

   Der Abschnitt Weitere Titel und Beschreibungen wird nicht mehr im Seitenerstellungsassistenten angezeigt.

Beispielkonfiguration von Seiteneigenschaften

Dieses Beispiel zeigt die „dialog diff“-Technik von Sling Resource Merger, einschließlich der Verwendung von sling:orderBefore. Außerdem wird die Verwendung von cq:showOnCreate und cq:hideOnEdit veranschaulicht.

CODE AUF GITHUB

Den Code dieser Seite finden Sie auf GitHub.

• Öffnen Sie das Projekt aem-authoring-extension-page-dialog auf GitHub