Generische Link-Editoren

Ab FirstSpirit Version 4.2 werden die Konfigurationsmöglichkeiten von Verweisvorlagen durch die Einführung so genannter "generischer Link-Editoren" erheblich erweitert. Die Konfiguration wird nun, analog zu Seiten- und Absatzvorlagen, mithilfe von Eingabekomponenten im Formularbereich erstellt. Alle Eingabemöglichkeiten für die Pflege von Verweisen können dabei über die reguläre Formularsyntax von FirstSpirit abgebildet werden.

Die Eingabemasken der herkömmlichen "statischen" Link-Editoren können ebenfalls über die neuen, generischen Editoren erzeugt werden. Dabei können sich leichte Abweichungen in der Darstellung und Benutzerführung der Eingabemasken ergeben, die Funktionalität wird aber erhalten bleiben:

Konfiguration und Verwendung

Für generische Link-Editoren wird die Trennung zwischen Definition (Formular) und Ausgabe aufgehoben. Um eine neue Verweisvorlage zu erstellen, braucht nur noch eine Verweiskonfiguration (unterhalb des Wurzelknotens "Verweisvorlagen" oder unterhalb eines Ordners) angelegt zu werden und als Verweistyp "genericLink" ausgewählt zu werden.

Zum Konvertieren bestehender Verweisvorlagen in generische Link-Editoren muss die Option "Verweisvorlage konvertieren" im Kontextmenü (Extras) einer bestehenden Verweiskonfiguration aufgerufen werden. Die bisherigen statischen Eingabefelder werden dann durch die neuen Eingabekomponenten im Formularbereich ersetzt. Gegebenenfalls ist nach der automatischen Migration noch eine projektspezifische, manuelle Anpassung des Layouts erforderlich.

Die Umstellung auf generische Linkeditoren verändert die innere Datenstruktur von DOM-Elementen. Dies kann potentiell zu Problemen bei bestehenden Skripten führen. Die Skripte müssen bei Bedarf manuell angepasst werden.

Die Migration der Link-Editoren muss in FirstSpirit Version 4.2 vollständig abgeschlossen werden. Andernfalls können die Projekte nicht nach FirstSpirit Version 5.0 migriert werden.

Die generischen Link-Editoren verfügen über die folgenden Register:

• Eigenschaften
• Formular
• Ausgabekanäle

Die Verwendung von generischen Link-Editoren in Eingabekomponenten wird analog zu den statischen Link-Editoren gehandhabt.

Register "Eigenschaften"

Auf diesem Register lassen sich allgemeine Einstellungen vornehmen, die für die entsprechende Verweisvorlage gültig sein sollen:

• Eindeutiger Name: Eindeutiger Name der Verweisvorlage, unter der diese im Dateisystem abgelegt wird.
• Formular: Über den Button „Vorgabewerte“ können Vorgabewerte für die Eingabekomponenten der Verweisvorlage definiert werden, je nach Ansichts-Konfiguration in einem Popup-Dialog oder in der Integrierten Vorschau.
• In Auswahlliste verstecken: Wird diese Option aktiviert, dann erscheint beim Anlegen eines neuen Verweises in der Inhalte- oder Datenquellen-Verwaltung diese Verweisvorlage nicht in der Auswahlliste.
• Verweistext: Über diese Combobox kann die Eingabekomponente gewählt werden, deren Inhalt als Verweistext z. B. im DOM-Editor oder in der DOM-Tabelle verwendet werden soll (Feld "text" in statischen Link-Editoren). Hier werden alle Bezeichner der auf dem Register "Formular" definierten Eingabekomponenten des Typs CMS_INPUT_TEXT und CMS_INPUT_NUMBER angezeigt. Der Text, der in die Eingabekomponente mit dem gewählten Bezeichner eingegeben wird, wird als Verweistext verwendet (siehe Abbildung, öffnet im gleichen Fenster). Ist keine entsprechende Eingabekomponente definiert, bleibt die Auswahl leer ("<nicht zugeordnet>"). Wird "<nicht zugeordnet>" ausgewählt, wird kein Verweistext angezeigt.
• Verweisbild: Über diese Combobox kann die Eingabekomponente gewählt werden, deren Inhalt als Verweisbild (Medienobjekt aus der Medien-Verwaltung) z. B. im DOM-Editor oder in der DOM-Tabelle verwendet werden soll (Feld "mediaref" in statischen Link-Editoren). Hier werden alle Bezeichner der auf dem Register "Formular" definierten Eingabekomponenten des Typs CMS_INPUT_PICTURE und FS_REFERENCE angezeigt. Das Bild, das über die Eingabekomponente mit dem angegebenen Bezeichner ausgewählt wird, wird als Verweisbild verwendet (siehe Abbildung, öffnet im gleichen Fenster). Ist keine entsprechende Eingabekomponente definiert, bleibt die Auswahl leer ("<nicht zugeordnet>"). Wird "<nicht zugeordnet>" ausgewählt, wird kein Verweisbild verwendet.
• Externe URL: Für Generische Links, über die externe Verweise gepflegt werden sollen, kann über diese Combobox die Eingabekomponente gewählt werden, die den externen Verweis (URL) enthält. Hier werden alle Bezeichner der auf dem Register "Formular" definierten Eingabekomponenten des Typs CMS_INPUT_TEXT und CMS_INPUT_NUMBER angezeigt. Im Referenzgraph z. B. von Seiten oder Absätzen, die einen DOM-Editor oder eine DOM-Tabelle mit diesem externen Generischen Link enthalten, wird eine Abhängigkeit zu der in der gewählten Eingabekomponente eingegebenen URL dargestellt (siehe Abbildung, öffnet im gleichen Fenster). Ist keine entsprechende Eingabekomponente definiert, bleibt die Auswahl leer ("<nicht zugeordnet>"). Wird "<nicht zugeordnet>" ausgewählt, wird keine Abhängigkeit zur externen URL im Referenzgraph angezeigt.
• Kategorie: Über diese Combobox kann eine Kategorie für externe Verweise ausgewählt werden. Standardmäßig sind "url" und "email" verfügbar. Bei Bedarf kann aber auch eine individuelle Kategorie angegeben werden. Dazu muss ein entsprechender Bezeichner in das Feld eingegeben werden. Die Kategorisierung wird z.B. für die Suche nach externen Referenzen (Menü "Extras") verwendet. Hier werden externe Verweise mit der jeweiligen Kategorie angezeigt.

Register "Formular"

Auf dem Register "Formular" können alle Eingabekomponenten verwendet werden, die auch für Seiten-, Absatz- und Tabellenvorlagen verwendet werden können.

Beispiel für einen internen Verweis:

<CMS_MODULE>

  <FS_REFERENCE name="sitestoreref" hFill="yes" useLanguages="no">
    <FILTER>
      <ALLOW type="pageref"/>
      <ALLOW type="documentgroup"/>
    </FILTER>
    <LANGINFOS>
      <LANGINFO lang="*" label="Target"/>
      <LANGINFO lang="DE" label="Ziel"/>
    </LANGINFOS>
    <PROJECTS>
      <LOCAL name=".">
        <SOURCES>
          <FOLDER name="root" store="sitestore"/>
        </SOURCES>
      </LOCAL>
    </PROJECTS>
  </FS_REFERENCE>

  <CMS_INPUT_TEXT name="text" hFill="yes" useLanguages="no">
    <LANGINFOS>
      <LANGINFO lang="*" label="Link text"/>
      <LANGINFO lang="DE" label="Verweis-Text"/>    
    </LANGINFOS>
  </CMS_INPUT_TEXT>

  <CMS_INPUT_TEXT name="comment" hFill="yes" hidden="yes" useLanguages="no">
    <LANGINFOS>
      <LANGINFO lang="*" label="Comment"/>
      <LANGINFO lang="DE" label="Kommentar"/>
    </LANGINFOS>
  </CMS_INPUT_TEXT>

  <FS_REFERENCE name="mediaref" hFill="yes" hidden="no" imagePreview="yes" useLanguages="no">
    <FILTER>
      <ALLOW type="picture"/>
      <ALLOW type="file"/>
    </FILTER>
    <LANGINFOS>
      <LANGINFO lang="*" label="Image"/>
      <LANGINFO lang="DE" label="Bild"/>
    </LANGINFOS>
    <PROJECTS>
      <LOCAL name=".">
        <SOURCES>
          <FOLDER name="root" store="mediastore"/>
        </SOURCES>
      </LOCAL>
    </PROJECTS>
  </FS_REFERENCE>

  <CMS_INPUT_TEXT name="target" hFill="yes" hidden="yes" useLanguages="no">
    <LANGINFOS>
      <LANGINFO lang="*" label="Frame"/>
      <LANGINFO lang="DE" label="Frame"/>
    </LANGINFOS>
  </CMS_INPUT_TEXT>

 </CMS_MODULE>

Register Ausgabekanäle

Informationen zur Ausgabe von Verweisen im jeweiligen Ausgabekanal können bei den jeweiligen Eingabekomponenten nachgeschlagen werden. Darüber hinaus können sie auch wie statischen Link-Editoren ausgegeben werden.