Inhaltsfragmente Konfigurieren von Komponenten für die Wiedergabe

Es gibt mehrere erweiterte Dienste zum Rendern von Inhaltsfragmenten. Um diese Dienste zu verwenden, müssen sich die Ressourcentypen dieser Komponenten dem Inhaltsfragmente-Framework bekannt machen.

Dies erfolgt durch Konfiguration der OSGi-Dienst - Inhaltsfragment-Komponentenkonfiguration.

ACHTUNG

Wenn Sie die unten beschriebenen erweiterten Dienste nicht benötigen, können Sie diese Konfiguration ignorieren.

ACHTUNG

Wenn Sie die vordefinierte(n) Komponente(n) erweitern oder verwenden, wird eine Änderung der Konfiguration nicht empfohlen.

ACHTUNG

Sie können eine Komponente von Grund auf neu schreiben, die nur die Content Fragments API verwendet, ohne erweiterte Dienste. In einem solchen Fall müssen Sie Ihre Komponente jedoch so entwickeln, dass sie die entsprechende Verarbeitung übernimmt.

Daher wird die Verwendung der Kernkomponenten empfohlen.

Definition erweiterter Dienste, die konfiguriert werden müssen

Die Dienste, für die die Registrierung einer Komponente erforderlich ist, sind:

  • Abhängigkeiten während der Veröffentlichung korrekt ermitteln (d. h. sicherstellen, dass Fragmente und Modelle automatisch mit einer Seite veröffentlicht werden können, wenn sie sich seit der letzten Veröffentlichung geändert haben).
  • Unterstützung von Inhaltsfragmenten bei der Volltextsuche.
  • Verwaltung/Bearbeitung von Inhalten zwischen
  • Verwaltung/Bearbeitung von gemischten Medienelementen.
  • Dispatcher-Flush für referenzierte Fragmente (wenn eine Seite, die ein Fragment enthält, erneut veröffentlicht wird).
  • Absatzbasiertes Rendering.

Wenn Sie eine oder mehrere dieser Funktionen benötigen, ist es in der Regel einfacher, die vordefinierte Funktion zu verwenden, anstatt sie von Grund auf zu entwickeln.

OSGi-Dienst - Konfiguration der Inhaltsfragment-Komponente

Die Konfiguration muss an die OSGi-Dienst- Inhaltsfragment-Komponentenkonfiguration gebunden sein:

com.adobe.cq.dam.cfm.impl.component.ComponentConfigImpl

Hinweis

See Configuring OSGi for further details.

Beispiel:

cfm-01

Die OSGi-Konfiguration lautet:

Etikett OSGi-Konfiguration
Beschreibung
Ressourcentyp dam.cfm.component.resourceType Der zu registrierende Ressourcentyp;z. B.

core/wcm/components/contentfragment/v1/contentfragment

Referenz-Eigenschaft dam.cfm.component.fileReferenceProp Der Name der Eigenschaft, die den Verweis auf das Fragment enthält; z. B. fragmentPath oder fileReference
Element(e)-Eigenschaft dam.cfm.component.elementsProp Der Name der Eigenschaft, die die Namen der zu rendernden Elemente enthält;z. B.elementName
Varianteneigenschaft
dam.cfm.component.variationProp Der Name der Eigenschaft, die den Namen der zu rendernden Variante enthält;z. B.variationName

Für einige Funktionen (z. B. zum Rendern eines Absatzbereichs) müssen Sie einige Konventionen einhalten:

Eigenschaftsname Beschreibung
paragraphRange

Eine Zeichenfolgeneigenschaft, die den Bereich der Absätze definiert, die ausgegeben werden sollen, wenn sie sich im Rendermodus für einzelne Elemente befinden.

Format:

  • 1 oder 1-3 oder 1-3;6;7-8 *-3;5-*
  • nur ausgewertet, wenn paragraphScope auf range
paragraphScope

Eine Zeichenfolgeneigenschaft, die definiert, wie Absätze ausgegeben werden sollen, wenn sie sich im Rendermodus für einzelne Elemente befinden.

Werte:

  • all : zum Rendern aller Absätze
  • range : zur Darstellung des durch paragraphRange
paragraphHeadings Eine boolesche Eigenschaft, die definiert, ob Überschriften (z. B. h1, h2oder h3) als Absätze (true) oder nicht gezählt werden (false)
ACHTUNG

Dies kann sich in späteren 6,5 Meilensteinen ändern.

Beispiel

Ein Beispiel: Sehen Sie sich Folgendes an (bei einer vordefinierten AEM-Instanz):

/apps/core/wcm/config/com.adobe.cq.dam.cfm.impl.component.ComponentConfigImpl-core-comp-v1.config

Dies umfasst:

dam.cfm.component.resourceType="core/wcm/components/contentfragment/v1/contentfragment"
dam.cfm.component.fileReferenceProp="fragmentPath"
dam.cfm.component.elementsProp="elementName"
dam.cfm.component.variationProp="variationName"

Auf dieser Seite