Startseite
Startseite

Startseite / Vorlagenentwicklung / Formulare / Eingabekomponenten (deprecated) / PICTURE

CMS_INPUT_PICTUREVerfügbar bis FirstSpirit-Version 5.0

Inhaltsverzeichnis
zum Beispiel
zu den Methoden: GraphicalMedium

CMS_INPUT_PICTURE

Über die Eingabekomponente CMS_INPUT_PICTURE können Medien aus der Medien-Verwaltung referenziert werden. Optional können durch den Vorlagenentwickler Möglichkeiten zur Eingabe eines Kommentars und zusätzliche Textfelder zur Eingabe von Breite und Höhe des Bilds, oder zum Ändern der Abstände des Bilds zum umgebenden Text auf der linken und rechten Seite (hSpace) oder zum Text ober- und unterhalb des Bildes (vSpace) eingefügt werden. Über die Variable border (siehe Abbildung Textfeld:Rand) kann der Redakteur das Bild mit einem Rahmen versehen, der umso dicker ist, je größer der Wert ist. Wird der Wert 0 angegeben, wird das Medium ohne Rahmen dargestellt.

Access-API Anwendungsbeispiel
Die Beispiel-Implementierung PictureEditorValueExample veranschaulicht einige einfache Anwendungsfälle für den Lesenden-, Schreibenden-, Erstellenden-Zugriff auf das Daten-Objekt (PictureEditorValue) und dessen innerer Daten-Container (GraphicalMedium) der Eingabekomponente anhand der FirstSpirit Access-API.

name
Designator
Pflichtparameter
allowEmpty
YesNo
Optionaler Parameter
allowLanguageDependentUpload
YesNo
Optionaler Parameter
convertEntities
ConvertEntity
Optionaler Parameter
hFill
YesNo
Optionaler Parameter
hidden
YesNo
Optionaler Parameter
imagePreview
YesNo
Optionaler Parameter
lean
FormDisplayMode
Optionaler Parameter
noBreak
YesNo
Optionaler Parameter
preset
Preset
Optionaler Parameter
upload
YesNo
Optionaler Parameter
useLanguages
YesNo
Optionaler Parameter
lang
LanguageAbbreviation
Pflichtparameter
description
String
Optionaler Parameter
label
String
Optionaler Parameter
name
String
Pflichtparameter
autoReleaseAfterUpload
YesNo
Optionaler Parameter
uploadFolder
String
Optionaler Parameter
name
String
Pflichtparameter
name
String
Pflichtparameter
name
String
Pflichtparameter
store
String
Pflichtparameter
name
String
Optionaler Parameter
uploadFolder
String
Optionaler Parameter
name
String
Pflichtparameter

Parameter

Der nachfolgenden Tabelle können die Parameter der Eingabekomponente PICTURE entnommen werden.

ParameterPflichtparameterSeitTypStandardwert
name*Ja3.1DesignatorKeiner
allowEmptyNein3.0YesNoYES
allowLanguageDependentUploadNein3.1YesNoNO
convertEntitiesNein2.0ConvertEntityNONE
hFillNein2.0YesNoNO
hiddenNein4.0.44YesNoNO
imagePreviewNein3.0YesNoNO
leanNein3.0FormDisplayModeALL
noBreakNein2.0YesNoNO
presetNein4.0PresetDEFAULT
uploadNein3.0YesNoNO
useLanguagesNein2.0YesNoYES

name

Das Attribut "name" ist der Variablenname einer Eingabekomponente, mit dem in den Vorlagen - mit Hilfe von $CMS_VALUE()$ - das Ergebnisobjekt der Eingabekomponente verwendet oder der Inhalt ausgegeben werden kann.

ParameterPflichtparameterSeitTypStandardwert
name*Ja3.1DesignatorKeiner

allowEmpty

Mit dem Parameter "allowEmpty" wird festgelegt, ob für eine Eingabekomponente ein Wert angegeben werden muss oder nicht.

Bei der Angabe von allowEmpty="YES" ist eine Eingabe nicht zwingend, bei allowEmpty="NO" jedoch schon.

Eingabekomponenten mit allowEmpty="NO" werden auch als Pflichteingabekomponenten bezeichnet.

Der Standardwert für allowEmpty ist YES.

ParameterPflichtparameterSeitTypStandardwert
allowEmptyNein3.0YesNoYES

allowLanguageDependentUpload

Über den Parameter allowLanguageDependentUpload kann das Hochladen (engl. Upload) sprachabhängiger Medien in das Remote- oder das Zielprojekt zugelassen oder unterbunden werden.

Wichtig Der Parameter wird nur angewendet, wenn der Parameter upload mit dem Wert YES angegeben wurde.

  • allowLanguageDependentUpload="NO" und upload="YES": es können nur sprachunabhängige Medien im Remote- bzw. Zielprojekt angelegt werden
  • allowLanguageDependentUpload="YES" und upload="YES": es können sowohl sprachunabhängige als auch sprachabhängige Medien im Remote- bzw. Zielprojekt angelegt werden

ParameterPflichtparameterSeitTypStandardwert
allowLanguageDependentUploadNein3.1YesNoNO

convertEntities

Mit dem Attribut "convertEntities" werden Sonderzeichen, die in die Eingabekomponenten eingeben wurden, bei der Ausgabe in HTML-Zeichen umgewandelt.

Es gibt hier drei Ausprägungen:

  • convertEntities="NONE" (Standard)
  • convertEntities="STANDARD"
  • convertEntities="QUOTE"

Bei NONE werden keinerlei Konvertierungsregeln angewendet.

Wird STANDARD angegeben, so werden die Konvertierungsregeln angewendet, die im Bereich "convert" der ausgewählten Konvertierungsregel des Präsentationskanales stehen.

Die Angabe QUOTE schließt STANDARD explizit mit ein. Es wird jedoch zusätzlich der Bereich "quote" der Konvertierungsregel angewendet.

ParameterPflichtparameterSeitTypStandardwert
convertEntitiesNein2.0ConvertEntityNONE

hFill

Die Anzeige einer Eingabekomponente erfolgt immer mit einer vordefinierten Breite.

Ist es aber gewünscht, dass die Eingabekomponente die volle zur Verfügung stehende Anzeigebreite nutzt, ist der Parameter hFill mit dem Wert YES anzugeben.

ParameterPflichtparameterSeitTypStandardwert
hFillNein2.0YesNoNO

hidden

Mit dem Parameter "hidden" kann eine Eingabekomponente für den Redakteur ausgeblendet werden.

Bei der Angabe von hidden="YES" wird die Eingabekomponente ausgeblendet, bei hidden="NO" nicht.

Der Standardwert für hidden ist NO, so dass Eingabekomponenten standardmäßig für den Redakteur sichtbar sind.

ParameterPflichtparameterSeitTypStandardwert
hiddenNein4.0.44YesNoNO

imagePreview

Mit dem Parameter imagePreview kann eine Bildvorschau eines ausgewählten Bildes in der Eingabekomponente angezeigt werden.

Standardmäßig wird keine Bildvorschau angezeigt.

Um die Bildvorschau zuzulassen ist der Wert YES (...imagePreview="YES"...) anzugeben.

ParameterPflichtparameterSeitTypStandardwert
imagePreviewNein3.0YesNoNO

lean

Mit dem Parameter lean kann festgelegt werden, welche Eingabefelder der Eingabekomponente angezeigt und somit das Anzeigeverhalten verändert werden.

Standardmäßig werden alle Eingabefelder angezeigt.

Bei der Angabe des Wertes COMMON werden nur allgemeine Felder (Medienauswahl und Kommentar) angezeigt, bei MANDATORY nur die Pflichtfelder (Medienauswahl).

ParameterPflichtparameterSeitTypStandardwert
leanNein3.0FormDisplayModeALL

noBreak

Mit dem Parameter noBreak kann der automatische Zeilenumbruch nach einer Eingabekomponente unterdrückt werden.

Um den automatischen Zeilenumbruch zu unterdrücken, ist der Parameter noBreak mit dem Wert "YES" anzugeben (noBreak="YES").

ParameterPflichtparameterSeitTypStandardwert
noBreakNein2.0YesNoNO

preset

Mit dem Attribut preset kann festgelegt werden, wie Vorgabewerte in einer Eingabekomponente behandelt werden (vgl. dazu auch Kapitel Vorgabewerte). Wird preset="default" gesetzt, wird der im Formular definierte Rückgriffwert verwendet. Nachträgliche Änderungen im Formular an diesem Wert wirken sich auf alle Verwendungen in den vom Redakteur gepflegten Eingabekomponenten aus, solange bis ein manueller Wert in die Eingabekomponente gesetzt wird. Dies ist die Standardeinstellung. Wird preset="copy" gesetzt, wird der durch den Redakteur gewählte Wert "hart" in der Eingabekomponente gespeichert. Nachträgliche Änderungen am Vorgabewert im Formular wirken sich nicht aus.

ParameterPflichtparameterSeitTypStandardwert
presetNein4.0PresetDEFAULT

upload

Mit Hilfe des Parameters upload kann der Vorlagenentwickler dem Redakteur die Möglichkeit geben ein Medium über die Eingabekomponente hochzuladen.

Der Redakteur kann entweder über den entsprechenden Button dialoggesteuert das Bild in die Medien-Verwaltung einpflegen oder aber direkt mit Drag & Drop auf die Eingabekomponente.

Standardmäßig ist die Funktionalität deaktiviert, um sie zu aktivieren ist der Parameter mit dem Wert YES (...upload="YES"...) anzugeben.

ParameterPflichtparameterSeitTypStandardwert
uploadNein3.0YesNoNO

useLanguages

Mit dem Parameter useLanguages kann festgelegt werden, ob eine Eingabekomponente für verschiedene Sprachen unterschiedliche bzw. abweichende Werte speichern soll oder nicht (mehrsprachige Pflege).

Wird der Parameter nicht angegeben so werden standardmäßig abweichende Werte für die verschiedenen Sprachen gespeichert.

Bei der Angabe von NO (...useLanguages="NO") wird ein Wert für alle Sprachen gespeichert.

ParameterPflichtparameterSeitTypStandardwert
useLanguagesNein2.0YesNoYES

LANGINFOSVerfügbar ab FirstSpirit-Version 4.0

Über das Tag LANGINFOS können für jede Eingabekomponente sprachabhängige Angaben definiert werden, z. B. wie die Eingabekomponente in den unterschiedlichen Projektsprachen betitelt sein soll (Parameter label), welcher Tooltip angezeigt werden soll (Parameter description) usw. Aus Gründen der Übersichtlichkeit werden dabei Definitionen, die in mehreren Sprachen identisch sind, zusammengefasst. So wird z. B. aus

 <LANGINFOS> 
<LANGINFO lang="*" label="Date" format="dd.MM.yy"/>
<LANGINFO lang="DE" label="Date" format="dd.MM.yy"/>
<LANGINFO lang="EN" label="Date" format="MM/dd/yy"/>
</LANGINFOS>

beim Speichern

 <LANGINFOS> 
<LANGINFO lang="*" label="Date" format="dd.MM.yy"/>
<LANGINFO lang="EN" label="Date" format="MM/dd/yy"/>
</LANGINFOS>

Die Definition für den Rückfallwert (*) bleibt dabei immer erhalten, von Definitionen für Sprachen mit gleichen Werten bleibt immer die oberste erhalten.

Ab FirstSpirit-Version 4.2R4 kann der Rückfallwert weggelassen werden. Dann wird beim Speichern automatisch die zuerst definierte Sprache als Rückfallwert verwendet, z. B. wird aus

<LANGINFOS>
<LANGINFO lang="EN" label="Date"/>
<LANGINFO lang="DE" label="Datum"/>
</LANGINFOS>

beim Speichern

 <LANGINFOS> 
<LANGINFO lang="*" label="Date"/>
<LANGINFO lang="DE" label="Datum"/>
</LANGINFOS>

LANGINFOVerfügbar ab FirstSpirit-Version 3.1

Mit dem Tag LANGINFO werden Werte oder Attribute für eine Sprache oder aber für die Verwendung als Rückfallwerte angegeben.

Um Werte bzw. Attribute für eine Sprache anzugeben ist im Parameter lang die Abkürzung der Projektsprache anzugeben:

...
<LANGINFO lang="DE".../>
...

Rückfallwerte werden mit dem speziellen Sprachkürzel * ("für alle Sprachen") angegeben:

...
<LANGINFO lang="*".../>
...

Bei dem Parameter lang handelt es sich um einen Pflichtparameter.

ParameterPflichtparameterSeitTypStandardwert
lang*Ja3.1LanguageAbbreviationKeiner
descriptionNein3.1StringKeiner
labelNein3.1StringKeiner

lang

Mit dem Parameter lang wird das Sprachkürzel, das in den Servereigenschaften im Feld Abkürzung eingetragen ist (siehe Dokument ansehen FirstSpirit Handbuch für Administratoren, Kapitel "Sprach-Vorlagen"), angegeben, um festzulegen für welche Projektsprachen die Definitionen gelten sollen, z.B. DE für Deutsch, EN für Englisch, FR für Französisch usw. Folgende Zeichen können dabei beliebig oft angegeben werden: -, _, 0-9 und A-Z. Kleinbuchstaben werden nach dem Speichern der Vorlage automatisch in Großbuchstaben umgewandelt. Alternativ kann * für Rückfallwerte verwendet werden.

ParameterPflichtparameterSeitTypStandardwert
lang*Ja3.1LanguageAbbreviationKeiner

description

Mit dem Parameter description kann eine Beschreibung angegeben werden, die zur Anzeige eines Tooltipps (Mouse-Over) genutzt wird.

ParameterPflichtparameterSeitTypStandardwert
descriptionNein3.1StringKeiner

label

Mit dem Parameter label wird die Oberflächenbeschriftung für Eingabe- und Visualisierungkomponenten angegeben.

ParameterPflichtparameterSeitTypStandardwert
labelNein3.1StringKeiner

PROJECTSVerfügbar ab FirstSpirit-Version 4.2

Über das Tag PROJECTS kann definiert werden, aus welchen Projekten (lokal und/oder remote) Referenzen ausgewählt werden dürfen.

Remote-Projekte werden über das Tag REMOTE angegeben, über CATEGORY kann eine oder mehrere Remote-Kategorie/n definiert werden. Das aktuelle Projekt wird über das Tag LOCAL angegeben. Es können beliebig viele Projekte definiert werden.

Zu jedem Projekt können darüber hinaus über die Tags SOURCES und FOLDER Ordner festgelegt werden, aus denen eine Referenz ausgewählt werden darf.

Die Reihenfolge der Projekt-Definitionen wirkt sich auch auf die Reihenfolge im Auswahl- und im Upload-Dialog aus (ausgenommen von dieser Sortierung ist das lokale Projekt).

Wichtig Zu Einschränkungen bei der Verwendung der Remote-Media-Funktion in WebEdit siehe Seite Einschränkungen.

REMOTEVerfügbar ab FirstSpirit-Version 4.2

Mit diesem Tag kann ein oder mehrere Remote-Projekt/e definiert werden, das/die berücksichtigt werden soll/en. Für jedes Remote-Projekt ist ein REMOTE-Tag anzugeben.

Wichtig Für die Verwendung des REMOTE-Tags ist eine gültige Lizenz für den Remote-Media-Zugriff erforderlich.

ParameterPflichtparameterSeitTypStandardwert
name*Ja4.2StringKeiner
autoReleaseAfterUploadNein4.2YesNoKeiner
uploadFolderNein4.2StringKeiner

name

Über den Parameter name wird der symbolische Projektname des Remote-Projekts angegeben.

ParameterPflichtparameterSeitTypStandardwert
name*Ja4.2StringKeiner

autoReleaseAfterUpload

Über autoReleaseAfterUpload kann eingestellt werden, ob über die Eingabekomponente hochgeladene Medien direkt freigegeben werden (Auto-Freigabe).

Nutzt das Projekt, in das ein Medium hochgeladen wird, keine automatische Freigabe (d.h. Objekte müssen prinzipiell freigegeben werden), muss dieses Medium standardmäßig freigegeben werden. Über die Angabe von autoReleaseAfterUpload="YES" kann dagegen eingestellt werden, dass Medien, die über die Eingabekomponente hochgeladen werden, direkt freigegeben werden. Mit der Angabe von autoReleaseAfterUpload="NO" wird die Auto-Freigabe unterdrückt.

Dieser Parameter wird nur ausgewertet, wenn der Upload für die Eingabekomponente mit upload="YES" erlaubt ist und über uploadFolder ein gültiger Zielordner definiert ist.

Wichtig Zur Nutzung der Auto-Freigabe eines Objekts muss der Benutzer die erforderlichen Rechte besitzen. Verfügt der Benutzer nicht über das Freigabe-Recht in dem Projekt, in das das Objekt hochgeladen werden soll, wird das Objekt trotzdem hochgeladen, aber nicht freigegeben.

ParameterPflichtparameterSeitTypStandardwert
autoReleaseAfterUploadNein4.2YesNoKeiner

uploadFolder

Wird der Parameter uploadFolder mit einem gültigen Ordnernamen aus der Medien-Verwaltung angegeben, so wird das Bild, welches der Redakteur über die Eingabekomponente einpflegt, direkt in dem angegebenen Ordner angelegt bzw. hochgeladen.

Bei nicht angegebenem Parameter muss der Redakteur vor der Auswahl des Mediums den Zielordner aus der Medien-Verwaltung manuell auswählen.

Wichtig Der Parameter wird nur angewendet, wenn der Parameter upload mit dem Wert YES zusätzlich angegeben wurde.

ParameterPflichtparameterSeitTypStandardwert
uploadFolderNein4.2StringKeiner

SOURCESVerfügbar ab FirstSpirit-Version 4.2

Mit dem Tag SOURCES ist es möglich die Auswahl oder Anzeige auf festgelegte Ordner (inkl. Unterordner) einzuschränken.

Bei SOURCES handelt es sich um eine Positivlist, d.h. es werden nur die angegebenen Ordner zugelassen.

Um einen Ordner zuzulassen ist jeweils ein FOLDER-Tag anzugeben.

FOLDERVerfügbar ab FirstSpirit-Version 4.2

Mit dem FOLDER-Tag wird ein Ordner angegeben, der berücksichtigt werden soll.

Bei der Angabe von FOLDER ist der Parameter name mit einem gültigen Ordnernamen der Medien-Verwaltung anzugeben.

ParameterPflichtparameterSeitTypStandardwert
name*Ja4.2StringKeiner

name

Für den Parameter name ist ein gültiger Ordnername anzugeben. Um den gesamten Verwaltungsbereich zuzulassen, wird der Wert root verwendet:

... name="root"...

ParameterPflichtparameterSeitTypStandardwert
name*Ja4.2StringKeiner

CATEGORY

Über CATEGORY kann eine oder mehrere Remote-Kategorie/n definiert werden. Für jede Kategorie muss ein CATEGORY-Tag angegeben werden.

Enthält eine Remote-Kategorie bereits definierte Remote-Projekte, werden diese Projekte aus der Kategorie ignoriert.

Zu jedem Projekt können darüber hinaus über die Tags SOURCES und FOLDER Ordner festgelegt werden, aus denen eine Referenz ausgewählt werden darf. Dabei werden alle Ordner aus den Projekten der über CATEGORY definierten Remote-Kategorie, die im Tag FOLDER den über name angegebenen Namen haben, berücksichtigt. Kommt der über name angegebene Ordner-Name in nur einem Projekt der Remote-Kategorie vor, wird nur der Ordner dieses Projekts im Auswahldialog angezeigt, kommt der Ordner-Name in mehreren Projekten vor, werden die Ordner aller betroffenen Projekte angezeigt.

Wichtig Für die Verwendung des CATEGORY-Tags ist eine gültige Lizenz für den Remote-Media-Zugriff erforderlich.

ParameterPflichtparameterSeitTypStandardwert
name*Ja4.2StringKeiner

name

Für den Parameter name ist ein gültiger Name einer Remote-Kategorie anzugeben.

Wichtig Werden zwei oder mehr REMOTE- oder CATEGORY-Tags mit gleichem Namen definiert, so wird immer nur die erste Definition beachtet.

ParameterPflichtparameterSeitTypStandardwert
name*Ja4.2StringKeiner

SOURCESVerfügbar ab FirstSpirit-Version 4.2

Mit dem Tag SOURCES ist es möglich die Auswahl oder Anzeige auf festgelegte Ordner (inkl. Unterordner) einzuschränken.

Bei SOURCES handelt es sich um eine Positivlist, d.h. es werden nur die angegebenen Ordner zugelassen.

Um einen Ordner zuzulassen ist jeweils ein FOLDER-Tag anzugeben.

FOLDERVerfügbar ab FirstSpirit-Version 4.2

Mit dem FOLDER-Tag wird ein Ordner angegeben der berücksichtigt werden soll.

Bei der Angabe von FOLDER ist der Parameter name mit einem gültigen Ordnernamen sowie der Parameter store mit dem gültigen Namen des zugehörigen Verwaltungsbereichs anzugeben.

ParameterPflichtparameterSeitTypStandardwert
name*Ja4.2StringKeiner
store*Ja4.2StringKeiner

name

Für den Parameter name ist ein gültiger Ordnername anzugeben. Um den gesamten Verwaltungsbereich zuzulassen, wird der Wert root verwendet:

... name="root"...

ParameterPflichtparameterSeitTypStandardwert
name*Ja4.2StringKeiner

store

Für den Parameter store ist der Name des Verwaltungsbereichs anzugeben. In diesem Fall ist nur die Medien-Verwaltung möglich:

...store="mediastore"...

ParameterPflichtparameterSeitTypStandardwert
store*Ja4.2StringKeiner

LOCALVerfügbar ab FirstSpirit-Version 4.2

Mit diesem Tag muss bei Angabe des Tags PROJECTS das lokale Projekt definiert werden.

ParameterPflichtparameterSeitTypStandardwert
nameNein4.2StringKeiner
uploadFolderNein4.2StringKeiner

name

Über den Parameter name ist der Name des lokalen Projekts anzugeben. Dies geschieht standardmäßig mit einem . (Punkt):

<LOCAL name=".">

ParameterPflichtparameterSeitTypStandardwert
nameNein4.2StringKeiner

uploadFolder

Wird der Parameter uploadFolder mit einem gültigen Ordnernamen aus der Medien-Verwaltung angegeben, so wird das Bild, welches der Redakteur über die Eingabekomponente einpflegt, direkt in dem angegebenen Ordner angelegt bzw. hochgeladen.

Bei nicht angegebenem Parameter muss der Redakteur vor der Auswahl des Mediums den Zielordner aus der Medien-Verwaltung manuell auswählen.

Wichtig Der Parameter wird nur angewendet, wenn der Parameter upload mit dem Wert YES zusätzlich angegeben wurde.

ParameterPflichtparameterSeitTypStandardwert
uploadFolderNein4.2StringKeiner

SOURCESVerfügbar ab FirstSpirit-Version 4.2

Mit dem Tag SOURCES ist es möglich die Auswahl oder Anzeige auf festgelegte Ordner (inkl. Unterordner) einzuschränken.

Bei SOURCES handelt es sich um eine Positivlist, d.h. es werden nur die angegebenen Ordner zugelassen.

Um einen Ordner zuzulassen ist jeweils ein FOLDER-Tag anzugeben.

FOLDERVerfügbar ab FirstSpirit-Version 4.2

Mit dem FOLDER-Tag wird ein Ordner angegeben, der berücksichtigt werden soll.

Bei der Angabe von FOLDER ist der Parameter name mit einem gültigen Ordnernamen der Medien-Verwaltung anzugeben.

ParameterPflichtparameterSeitTypStandardwert
name*Ja4.2StringKeiner

name

Für den Parameter name ist ein gültiger Ordnername anzugeben. Um den gesamten Verwaltungsbereich zuzulassen, wird der Wert root verwendet:

... name="root"...

ParameterPflichtparameterSeitTypStandardwert
name*Ja4.2StringKeiner
Legende

LanguageAbbreviation

Sprachkürzel, z.B. DE, EN, FR oder * für Rückfallwerte

YesNo

Schalter, um ein Attribut anzuwenden oder nicht

NOVerfügbar ab FirstSpirit-Version 2.0

Attribut nicht anwenden

YESVerfügbar ab FirstSpirit-Version 2.0

Attribut anwenden

FormDisplayMode

Schalter, um das Anzeigeverhalten der Eingabekomponente zu beeinflussen

ALLVerfügbar ab FirstSpirit-Version 3.1

Alle Felder anzeigen

COMMONVerfügbar ab FirstSpirit-Version 3.1

Nur allgemeine Felder anzeigen

MANDATORYVerfügbar ab FirstSpirit-Version 3.1

Nur Pflichtfelder anzeigen

String

Eine beliebige Zeichenkette

Preset

Define the general preset modes.

DefaultVerfügbar ab FirstSpirit-Version 4.0

Retrieve default from definition, if no value is set.

CopyVerfügbar ab FirstSpirit-Version 4.0

Copy default from definition and save automatically.

ConvertEntity

Schalter, um die Konvertierungsregel festzulegen

NONEVerfügbar ab FirstSpirit-Version 2.0

Keine Konvertierungsregeln anwenden

STANDARDVerfügbar ab FirstSpirit-Version 2.0

Konvertierungsregeln des "convert"-Bereichs anwenden

QUOTEVerfügbar ab FirstSpirit-Version 2.1

Konvertierungsregeln des "convert"- und "quote"-Bereichs anwenden

Designator

Eindeutiger Bezeichner variabler Länge; muss mit einem Buchstaben oder Unterstrich beginnen und darf nur die Zeichen "A-Z", "a-z", "0-9" und "_" enthalten, z.B. "fr_st_varName"

Beispiel

Ein Beispiel für die Eingabekomponente PICTURE:

<CMS_INPUT_PICTURE useLanguages="YES" name="BEZEICHNER" lean="MANDATORY">
<LANGINFOS>
<LANGINFO lang="*" label="TEXT" description="TEXT"/>
<LANGINFO lang="DE" label="TEXT" description="TEXT"/>
<LANGINFO lang="EN" label="TEXT" description="TEXT"/>
</LANGINFOS>
</CMS_INPUT_PICTURE>

Verwendungsbeispiel in der Vorlagensyntax

Ein Beispiel für die Ausgabe eines Bildes st_picture, das per Eingabekomponente PICTURE gefüllt wurde.

<img src="$CMS_VALUE(ref(st_picture))$" 
alt="$CMS_VALUE(st_picture.comment)$"
width="$CMS_VALUE(st_picture.medium.width)$"
height="$CMS_VALUE(st_picture.medium.height)$"
border="$CMS_VALUE(st_picture.border)$"
vspace="$CMS_VALUE(st_picture.vspace)$"
hspace="$CMS_VALUE(st_picture.hspace)$"/>

Die Ausgabe im HTML-Code sieht wie folgt aus.

<img src="/fs4preview_7904/preview/7904/media/DE/current/8126/ORIGINAL"
alt="Comment"
width="192"
height="42"
vspace="10"
hspace="10"/>

Soll statt der Breite und Höhe des Mediums die vom Redakteur gewählte Breite und Höhe aus der Eingabekomponente ausgelesen werden, könnte dieses so aussehen.

Width set by Formular: $CMS_VALUE(st_picture.width)$
Height set by Formular: $CMS_VALUE(st_picture.height)$

Soll statt der Original-Auflösung die Auflösung "thumbnail50x50" ausgegeben werden, wird die gewählte Auflösung der Funktion ref() per Parameter "res:" übergeben. Für das Auslesen der Breite und Höhe wird den Funktionen "width()" und "height()" die Auflösung als String übergeben.

<img src="$CMS_VALUE(ref(st_picture,res:"thumbnail50x50"))$"         
alt="$CMS_VALUE(st_picture.comment)$"
width="$CMS_VALUE(st_picture.medium.width("thumbnail50x50"))$"
height="$CMS_VALUE(st_picture.medium.height("thumbnail50x50"))$"
border="$CMS_VALUE(st_picture.border)$"
vspace="$CMS_VALUE(st_picture.vspace)$"
hspace="$CMS_VALUE(st_picture.hspace)$"/>

© 2005 - 2014 e-Spirit AG | Alle Rechte vorbehalten. | Letzte Änderung: 2013-05-24