Introducing CXT
Introducing CXT

Introducing CXT / Vorlagen / Fragmente verwenden

Fragmente verwenden

Inhaltsverzeichnis

Mit dem Fragment DAP können Fragmente aus einem Fragment-Projekt:

  • in einem anderen Fragment-Projekt referenziert werden.
    Dort können die Fragmente auch bearbeitet und neue erstellt werden.
  • in einem klassischen FirstSpirit-Projekt referenziert werden.
    Dort können sie gruppiert, strukturiert und miteinander in Relation gesetzt werden. Bei entsprechender Konfiguration können die referenzierten Fragmente auch im FirstSpirit ContentCreator bearbeitet werden.

 

Typ

Was?

Wo?

weitergehende Information

Lizenz

REMOTEPROJECT

ServerMonitoring / Dateisystem

siehe Technische Voraussetzungen und Empfehlungen (CXT)

Modul

FragmentCreator

Servereigenschaften – Module

siehe FirstSpirit CXT FragmentCreator

Modul

DAP Bridge

Servereigenschaften – Module

siehe FirstSpirit CXT DAP Bridge

Modul

Fragment DAP

Servereigenschaften – Module

siehe Download und Installation

Remote-Projekt

Fragment-Projekt, das Fragmente zur Verfügung stellt

Projekteigenschaften – Remote-Projekte

siehe Konfiguration Remote-Projekte

Eingabekomponente

FS_INDEX

Projekt – Vorlagenverwaltung

siehe Konfiguration FS_INDEX

 

Web-Komponente
(optional)

Fragment DAP for ContentCreator

Projekteigenschaften – Web-Komponenten

siehe Verwenden von Fragmenten im ContentCreator

     

Komponente "FS_INDEX"

Zur Referenzierung von Fragmenten wird die Komponente „FS_INDEX“ verwendet.
Register „Formular“, Minimalkonfiguration:

<FS_INDEX name="fragments">
<LANGINFOS>
<LANGINFO lang="*" label="Fragment selection"/>
<LANGINFO lang="DE" label="Fragment auswählen"/>
</LANGINFOS>
<SOURCE name="FirstSpiritFragmentAccess/FSFAConnector">
<PROJECT remote="fragmentproject"/>
</SOURCE>
</FS_INDEX>

Aktivierung der DAP-Funktionalität
Über das Tag SOURCE werden das FirstSpirit-Modul sowie die DataAccessPlugin-Komponente angegeben, und zwar über den Pflichtparameter name. In diesem Fall: „FirstSpiritFragmentAccess/FSFAConnector“.

Definition des Remote-Projekts
Das Projekt, aus dem die Fragmente ausgewählt werden sollen, muss über das Tag PROJECT angegeben werden. Über den Pflichtparameter remote muss dabei der symbolische Projektname des Remote-Projekts angegeben werden.

Darstellung der ausgewählten Fragmente
Über den Parameter viewMode kann der Anzeigemodus der Fragmente in der Eingabekomponente gesteuert werden. Die Anzeige greift dabei auf die Konfiguration des Registers „Schnipsel“ der Vorlage zurück, auf der das ausgewählte Fragment basiert.

  • DETAILS (Standard): Anzeige der Informationen aus den Feldern „Miniaturansicht“, „Kennsatz“ und „Ausriss“.
  • HEADERS: Anzeige der Informationen aus dem Feld „Kennsatz“.
  • SYMBOLS: Anzeige der Informationen aus dem Feld „Miniaturansicht“.

Syntax-Beispiel:

<FS_INDEX name="fragments" useLanguages="no" viewMode="headers">...

Einschränkung auf Kategorien

Mit der oben dargestellten Minimalkonfiguration können alle Fragmente aus dem Projekt, das über das Attribut remote im Tag PROJECT spezifiziert ist, ausgewählt werden.
Um die Auswahl auf bestimmte Kategorien einzuschränken, kann die Konfiguration um das Tag CATEGORY erweitert werden. Der Name des betreffenden Inhalte-Ordners bzw. der betreffenden Seitenvorlage (im Remote-Projekt) wird über den Parameter uid spezifiziert (Referenzname):

<FS_INDEX name="fragments">
<LANGINFOS>
<LANGINFO lang="*" label="Fragment selection"/>
<LANGINFO lang="DE" label="Fragment auswählen"/>
</LANGINFOS>
<SOURCE name="FirstSpiritFragmentAccess/FSFAConnector">
<PROJECT remote="fragmentproject">
<CATEGORY uid="teaser"/>
</PROJECT>
</SOURCE>
</FS_INDEX>

Es können auch mehrere Kategorien angegeben werden, z. B.

...
<PROJECT remote="fragmentproject">
<CATEGORY uid="teaser"/>
<CATEGORY uid="news"/>
</PROJECT>
...
Wichtig Durch die Angabe des Tags CATEGORY wird gleichzeitig das Bearbeiten von referenzierten Fragmenten und Anlegen von neuen Fragmenten im Remote-Projekt aktiviert. Siehe dazu Abschnitt Bearbeiten und Erstellen von Fragmenten.

Verwendung im FragmentCreator

Auswahl von Fragmenten

Wurde die Minimalkonfiguration korrekt vorgenommen, erhält der Redakteur in einer Variante eine Möglichkeit, Fragmente auszuwählen:

Bearbeiten und Erstellen von Fragmenten

Mit dem Tag CATEGORY und der Angabe eines gültigen Werts für den Parameter uid (siehe Abschnitt Einschränkung auf Kategorien) können nicht nur Fragmente aus dem Remote-Projekt ausgewählt, sondern auch referenzierte bearbeitet und neue angelegt werden.

Wurde die Konfiguration korrekt vorgenommen, erhält der Redakteur in einer Variante eine Möglichkeit, referenzierte Fragmente zu bearbeiten und neue Fragmente zu erstellen.
Wurde nur eine Kategorie spezifiziert (Tag CATEGORY), wird über die Schaltfläche ein Fragment dieser Kategorie angelegt:

Wurden mehrere Kategorien spezifiziert, erhält der Redakteur einen Dialog zur Auswahl der gewünschten Kategorie.

Neue Fragmente werden in dem Remote-Projekt, das über das Attribut remote im Tag PROJECT spezifiziert ist, angelegt, und zwar mit der durch den Redakteur gewählten Vorlage. Im Beispiel wäre dies die Vorlage mit dem Referenznamen „teaser“. Die Fragmente werden im Bereich „Inhalte“ im Ordner mit dem Referenznamen „teaser“ angelegt.

Verwendung im SiteArchitect

Auswahl von Fragmenten

Im FirstSpirit ContentCreator können Fragmente mit der oben angegebenen Minimalkonfiguration ebenfalls ausgewählt werden.
Innerhalb der FS-INDEX-Komponente:

Passende Fragmente können auch aus dem entsprechenden Report ausgewählt werden:

Ausgabe von Fragmenten / Varianten (in FirstSpirit-Projekten)

Wie sich über eine wie oben beschrieben konfigurierte FS_INDEX-Komponente durch den Redakteur ausgewählte Fragmente / Varianten aus dem Fragment-Projekt in einem FirstSpirit-Projekt ausgeben lassen, siehe Seite Fragmente ausgeben.

Verwendung im ContentCreator

Auswahl von Fragmenten

Im FirstSpirit ContentCreator können Fragmente mit der oben angegebenen Minimalkonfiguration ebenfalls ausgewählt werden.
Innerhalb der FS-INDEX-Komponente:

Passende Fragmente können auch aus dem entsprechenden Report ausgewählt werden:

Bearbeiten von Fragmenten

Sollen Fragmente im ContentCreator bearbeitet werden können, muss die Web-Komponente „Fragment DAP for ContentCreator“ dem betreffenden Projekt in den Projekteigenschaften im Bereich „ContentCreator“ hinzugefügt werden („FirstSpirit ServerManager / Projekt-Eigenschaften / Web-Komponenten“, siehe dazu Seite Fragment Data Access Plugin (Fragment DAP).)

Im Bearbeitungsdialog mit der FS_INDEX-Komponente im ContentCreator wird ein entsprechendes Icon angezeigt:

Mit einem Klick wird das Formular aus dem FragmentCreator als MicroApp direkt im ContentCreator geöffnet und kann dort bearbeitet werden:

Anschließend kann der Redakteur das Formular (FragmentCreator) schließen (Icon X), die Änderungen werden automatisch gespeichert.

EasyEdit / Inline-Darstellung

Das „Bearbeiten“-Icon kann auch direkt in der Vorschau eingeblendet werden.
Dazu wird die betreffende FS_INDEX-Komponente mit einem editorId()-Aufruf in Verbindung mit dem Parameter externalReference ausgestattet. Dieser Parameter erwartet den Bezeichner von Referenzen, die in der FS_INDEX-Komponente gespeichert sind.

Beispiel:

<div$CMS_VALUE(editorId(editorName:"fragments"))$>
$CMS_FOR(i, [0..fragments.identifiers.size-1])$
$CMS_SET(fragment, fragments.values[i])$
$CMS_SET(objectId, fragments.identifiers[i])$
<div$CMS_VALUE(editorId(editorName:"fragments", externalReference: objectId))$>
$CMS_FOR(variant, fragment.variants({"language": #global.language.abbreviation}))$
<b>$CMS_VALUE(variant.title)$</b><br>
$CMS_VALUE(variant.formData.text)$

$CMS_END_FOR$
</div>
$CMS_END_FOR$
</div>

  • fragments: Bezeichner der betreffenden FS_INDEX-Komponente
  • text: Bezeichner einer Eingabekomponente im gewählten Fragment
  • objectId: repräsentiert einen Fragment-Eintrag der FS_INDEX-Komponente

Zu weiteren Informationen zur Methode editorId siehe auch Einsatz im Projekt (→Online Dokumentation FirstSpirit).

Ist die Vorlage korrekt konfiguriert und hat der Benutzer ausreichende Rechte, werden in der Vorschau direkt Bearbeiten-Icons an den ausgewählten Fragmenten angezeigt.

In Verwendung

Wird das Fragment von einem anderen Fragment referenziert, wird dies im FragmentCreator visualisiert, und zwar durch den Text „In Verwendung“.
Beim Löschen einer Variante wird ebenfalls in einer Dialog-Box darauf hingewiesen, dass Referenzen zu anderen Fragmenten bestehen.

© 2005 - 2020 e-Spirit AG | Alle Rechte vorbehalten. | FirstSpirit 2020-11 | Datenschutz | Impressum | Kontakt