Skip to content

Linktool

Mit Hilfe des Linktools können Sie Inhalte bestimmter Meta-Variablen aus einem anderen Dokument bzw. MAM an definierte Zielpositionen des aktuellen Dokuments einfügen.
Die Zielpositionen werden im Template festgelegt.

ABER: Ändert sich der Inhalt im verlinkten Dokument später, so wird das aktuelle Dokument nicht automatisch aktualisiert.

Das Linktool lehnt sich funktional an seinen Vorgänger, dem Metatool (2) an, wird jedoch in einem, dem MAM ähnlichen Pop-up-Fenster dargestellt:

Pop-up-Fenster "Linktool"

Die Oberfläche im Linktool wird über verschiedene Parameter gestaltet. Die Bedienung und der Aufbau des Linktools werden im Kapitel Linktool im Benutzerhandbuch beschrieben.

Da das Linktool technisch auf den gleichen Grundlagen wie das MAM basiert, ist auch die Verwendung ähnlich. Ein Link aus dem MAM kann wie folgt implementiert werden:

<a href="IMPERIA:MAM:ref_mam_url" >
 <?imperia mam copy
   NAME:ref_mam_text
 ?>» Select Asset</a>

<div>Link-URL</div>
  <input name="IMPERIA:ref_mam_url" type="text" size="20" readonly="readonly" />

<div >Linktext</div>
  <input name="IMPERIA:ref_mam_text" type="text" size="20" />

Darstellung anpassen#

Nachfolgend wird erläutert, wie Sie die Anzeige des Linktool-Aufrufs sowie die Darstellung des Pop-up-Fensters (Darstellung im Linktool-Aufruf) anpassen können.

Linktool-Aufruf (Button)#

Das Linktool lässt sich folgendermaßen einbinden:

<a class="editHref" href="IMPERIA:DOC:ref_doc_url">
 <?imperia mam copy title:ref_doc_text ?>

» Linktool öffnen</a>

<div>Link-URL</div>
<input name="IMPERIA:ref_doc_url" type="text" size="20" readonly="readonly" />

<div >Linktext</div>
<input name="IMPERIA:ref_doc_text" type="text" size="20" />

  • Ähnlich wie beim Einbinden eines Assets über das MAM, erscheint dann ein Button "Linktool", der im Linktool eine zusätzlichen Spalte "Einfügen" öffnet.
    Eine ausführliche Beschreibung zur Nutzung des Linktools erhalten Sie im Benutzerhandbuch
  • Durch einen Klick auf "Einfügen" wird der URI des Dokument in der angegebenen Variable gespeichert; in dem Beispiel ist das ref_doc_url. Durch den Befehl <?imperia mam copy title:ref_doc_text ?> wird zusätzlich noch der Titel des Dokumentes in die Variable ref_doc_text gespeichert.
  • Anschließend können beide Variablen benutzt werden, um wie gewohnt mit imperia einen Link zu erstellen, dessen Linktext im Editmode noch abgeändert werden kann.

Möchten Sie den Linktool-Aufruf verstecken, nutzen Sie folgende Anweisung:

<?imperia mam href_hide_icon 1 ?>

Bitte beachten

Diese Processing-Instruction funktioniert nur mit Anker ("ID").

Größe des Pop-up-Fensters#

Die Parameter, die für die Darstellung des Pop-up-Fensters bearbeitet werden können, sind Breite und Länge und werden wie folgt verändert:

<?imperia mam window_width Number?>
<?imperia mam window_height Number?>

Ersetzen Sie “Number” mit der gewünschten Breite bzw. Länge in Pixel.

Darstellung im Pop-up-Fenster#

Die Anordnung auf der Oberfläche des Pop-up-Fensters erfolgt über die Anweisung "sortby" gefolgt von einer der im Linktool verwendeten Spalten. Beispiel:

<?imperia mam sortby filesize?>

Folgende Spalten können genutzt werden, um die Dokumente zu sortieren:

  • title
  • filesize
  • createdby
  • editedby
  • created_date
  • published_at
  • publish_date

Für die Definition der Sortierung innerhalb der Spalten, fügen Sie entsprechend entweder ein "+" (aufsteigend) oder ein "-" (absteigend) vor dem Spaltennamen. Beispiel:

<?imperia mam sortby -title?>

Bitte beachten

Für die Anordnung der Dokumente kann nicht mehr als eine Spalte definiert werden.

Prefilter#

Über die Prefilter-Anweisungen können Sie steuern, aus welchem Bereich der Redakteur Dokumente auswählen kann. Diese Einstellung kann vom Redakteur nicht umgangen werden.

Im Linktool-Aufruf sieht dies folgendermaßen aus:
Beispiel Prefilter auf Kategorie

Beispiel:
Im obigen Beispiel wurde ein Prefilter auf die Kategorie <?imperia mam prefilter category /10/19 ?> gesetzt. Es wird aber trotz Klick auf die eine Ebene höher gelegene Rubrik "Media" nur die Abbildungen der Kategorie 10/19 gezeigt.

  • Welcher Prefilter gesetzt ist, wird rechts in der Kopfzeile des MAM bzw. Linktool-Pop-up-Fensters angezeigt.
  • Das Setzen von Prefiltern beeinflusst nur die Listenanordnung auf der rechten Seite des Linktool-Fensters. Dabei werden die Inhalte ausgeblendet, die nicht mit dem Filter übereinstimmen.
  • Die Baumstruktur auf der linken Seite wird nicht angepasst. D.h. es werden dort weiterhin alle Rubriken und Verzeichnisse angezeigt, siehe obige Abbildung: Obwohl der übergordnete Ordner "Media" gewählt/abgebildet ist, wird rechts nur das Asset aus der Kategorie "images" abgebildet, da es mit dem gesetzten Prefilter übereinstimmt.

Wichtig

  • Wenn Linktool innerhalb eines Flexmoduls genutzt wird, müssen die Processing-Instructions ein FlexINDEX sowie eine FlexID enthalten:
    <?imperia mam copy title:ref_doc_text_<!--FLEX_INDEX-->_<!--FLEX_ID--> ?>
  • Kommentare sind in den Processing-Instructions nicht erlaubt.

Rubriken und Verzeichnisse#

Die Darstellung der Dokumente kann auf bestimmte Rubriken und Verzeichnisse eingeschränkt werden:

  • category: Rubriken

    Wichtig

    Beim Festlegen von Rubriken, müssen Sie deren NodeID (nicht den Namen) verwenden.

  • category_recursive: findet alle Dokumente, in der angegebenen Rubrik oder in einer darunterliegenden Rubrik (Subrubrik) enthalten sind.

  • directory: Verzeichnisse

Beispiele:

<?imperia mam prefilter category *ID* ?>
<?imperia mam prefilter category /1/8 ?>
<?imperia mam prefilter category_recursive /1/8 ?>
<?imperia mam prefilter directory /docs/xy ?>

Metafeld#

Das Setzen von Prefiltern kann über die Metafelder erfolgen, die im globalen Metainfo-Objekt liegen. Beispiel eines Prefilters auf das Metafeld "title": 

<?imperia mam prefilter title=~New?>

Filter#

Über die Filter-Anweisungen kann der Template-Entwickler steuern, aus welchem Bereich der Redakteur Dokumente angezeigt bekommt. Der Redakteur kann diese Einstellung ändern und andere Dokumente auswählen.

Bildfilter#

Dieser Filter wird zur Anzeige von Bildern festgelegt. Beispiel: 

<?imperia mam filter jpeg?>

Verzeichnisfilter#

Dieser Filter wird zur Anzeige von Verzeichnissen festgelegt. Beispiel: 

<?imperia mam directory /news?>