ALLGEMEIN NÜTZLICHE PLATZHALTER

Platzhaltername

Platzhalterbeschreibung

[mvif:fieldname:relation:value]

mvif = make visible if (Schalte ein Element sichtbar sobald die Bedingung erfüllt ist). Mit diesem Platzhalter haben Sie die Möglichkeit einen Feldwert (aus der Datenbank) mit einem beliebigen Wert zu vergleichen und damit das Visible Attribut zu setzen.

Operatoren:
neq = ungleich
eq = gleich
gt = größer als
lt = kleiner als

Beispiel:
[mvif:previewimage:neq:0]

Das Feld previewimage beinhaltet die RAID des Vorschaubilds. Wenn kein Vorschaubild ausgewählt wurde beinhaltet dieser 0. Auf diese Weise können Sie überprüfen ob das Vorschaubild gesetzt ist oder nicht.

[mvifci:fieldname:relation:value]

mvifci = make visible if context items(Schalte ein Element sichtbar sobald die Bedingung erfüllt ist). Gleiche Funktionalität wie mvif, nur mit dem Unterschied das Sie hier die context.items abfragen können

[mviflang:languageid]

mviflang = make visible if language (Schalte ein Element sichtbar sobald die Bedingung erfüllt ist). Gleiche Funktionalität wie mvif, nur mit dem Unterschied das Sie hier auf eine bestimmte Sprache abprüfen können.

[mvifdatediff:
interval:
fieldname1:
fieldname2:
relation:value]

Vergleicht zwei Datumsfelder

Intervalle:
d = Tag
y = Tag
h = Stunde
n = Minute
m = Monat
q = Quartal
s = Sekunde
w = Woche
ww = Kalenderwoche
yyyy = Jahr

Beispiel:
[mvifdatediff:yyyy:publish_start:publish_end:eq:1]

Die Ausgabe sollte nur angezeigt werden wenn der Datumsunterschied zwischen plublish_start und publish_end nicht größer als ein Jahr ist.

[mvifdatediffnow:
fieldname:
interval:
operation:
value]

Gleiche Funktionalität wie mvifdatediff, nur das anstatt des zweiten Datums mit dem aktuellem Datum.

[mvifnotactualportal:fieldname]

Vergleicht die aktuelle Portal ID mit dem Wert aus der Datenbank. (in diesem Feld wird die originale Portalid des Inhalts erwartet).

[date:fieldname:format]

Wenn es sich be idem Feldnamen um ein Datumsfeld handelt kann dieses Formatiert werden. Die Formatierungsmöglichkeiten finden Sie hier.

[now:format]

Gleiche Funktionalität wie date:: , verwendet allerdings das aktuelle Datum.

[tnl:fieldname]

tnl = transform new line. Wenn ein Text Carriage-Returns beinhaltet werden diese mit html-< BR > ersetzt.

[trimat:fieldname:trimpos]

Kann verwendet werden um lange Texte abzuschneiden und wird am häufigsten für den Vorschautext verwendet.

Beispiel:
[trimat:preview:50]

Die Ausgabe zeigt den Vorschautext an. Ist dieser länger als 50 Zeichen wird der Rest abgeschnitten und drei Punkte eingefügt um dies anzuzeigen.

[httpencode:fieldname]

Konvertiert die Ausgabe htmlcodiert für Anführungszeichen („“) und das Kaufmännische und (&)

Beispiel:

Aus „&“ wird „&amp;“

[template_start]

Sie können diesen Platzhalter verwenden um einen speziellen Startpunkt für Ihr Template zu definieren. Diese Funktion ist nützlich wenn Sie nur ein schließendes Tag benötigen, da der WYSIWYG aber automatisch das öffnende Tag mit erstellt.

Beispiel:

<div class="footertemplate">[template_start]</div>

[template_end]

Gleiche Funktionalität wie template_start, nur das hier das Ende des Templates markiert wird.

Beispiel:

<li class="whatever"> [template_start]</li> <li>[template_end]</li>

Dieses Beispiel ist nützlich für Navigationsmodule, welche list items im spacer-template öffnen und schließen müssen.

[val:DataItem]

Mit dem val-Platzhalter können Sie jedes Datenfeld ihrer Datenquelle abrufen.

Zum Beispiel wenn ein Platzhalter wie [itemid] in der Dropdownlist nicht vorhanden ist, aber Sie wissen das er in Ihrer Datenquelle, dann können Sie einfach [val:itemid] verwenden.

[pagebreak]

Dieser Platzhalter kann im WYSIWYG Editor verwendet werden um einen Text über mehrere Seiten anzuzeigen. In Kombination mit dem Pagermodul wird der Text bis zu diesem Platzhalter angezeigt und das Pagermodul zeigt die Links zu den nächsten Seiten an.

[module:moduleid]

Mit diesem Platzhalter können Sie zum Beispiel related Module in das Detailansichtstemplate einbinden. Der moduleid-Parameter steht für die Modulid des Moduls welches Sie einbinden möchten.

[module:moduleid:globalid]

Analog zum vorherigen Platzhalter, mit dem Unterschied des zweiten Parameters. Es gibt die globalid an welche zur Verknüpfung verwendet werden soll.

Er wurde dafür entwickelt um verknüpfte Kategorien auch in der Listenansicht zu nutzen.

Wenn Sie diesen Platzhalter in der Listenansicht verwenden, wird die globalid verwendet um die verknüpften Kategorien für das Entsprechende Objekt anzuzeigen.

[ci:id]

Mit diesem Platzhalter können Sie auf die context.items in Ihrem Template zugreifen. Schauen Sie bei [mvifci:::] nach um zu sehen wie Sie die vorhanden context.items ermitteln können (id muss mindestens aus 3 Zeichen bestehen).

Beispiel:

Um verschiedene Farbschemen in Ihrem Template zu verwenden können Sie hiermit die Namen Ihrer css-Klassen dynamisch erstellen:

< div class="background[ci:theme]" >< /div > .

[cs:id]

Mit diesem Platzhalter können Sie die benutzerdefinierten Einstellungen der Moduleinstellungen auslesen.

 

Anmerkung:
Bitte beachten Sie, dass diese Platzhalter nicht in jeder Template-Art vorhanden sind. Dies ist Fall bei Template-Arten, die nicht datalist´s oder repeater für die Darstellung Ihrer Inhalte verwenden (z. B. Multilevelnavigation, categorynavigation, modultemplates).

 

 
 

ALLE CONTEXT.ITEMS

Es gibt eine Menge von Context.Items die Sie in Ihren Templates verwenden können.

[ci:company]

"actdate"

"additem"

"adminlanguageid"

"applicationpath"

"basedir"

"baseurl"

"baskettabid"

"blogmonth"

"blogyear"

"calledfrom"

"callingmodule"

"captchaok"

"categorynavigationmoduleid"

"changeitem"

"company"

"createcomment"

"cuid"

"culture"

"currentModuleID"

"currentPageIndex"

"currentPageSet"

"date"

"defaultlanguage"

"deletearticle"

"deleteitem"

"department"

"detail"

"editcomment"

"enableeditmode"

"exprsearch"

"flash"

"gallery"

"htmlversion"

"icc"

"infotext"

"infotitle"

"isdetailview"

"isindetailview"

"isinlineeditmode"

"islistview"

"IsWYSIWYG"

"lang"

"langid"

"lid"

"loginalias"

"mailcontact"

"mailcontacttabid"

"mailto"

"mayconnect"

"mdefid"

"mid"

"moduletitle"

"newsletterid"

"nid"

"noblendout"

"norobotindex"

"object"

"page"

"pagetitle"

"pathinfo"

"popupmenu"

"popupmenucontrol"

"portalid"

"portalSettings"

"portaltitle"

"post"

"pr"

"preview"

"print"

"query"

"recipient"

"recipientfirstname"

"recipientlastname"

"recipientname"

"recipienttitle"

"redirected"

"relatedbaseobject"

"relatedimagegallery"

"robotscommand"

"searchcall"

"searchcategory"

"searchid"

"searchtagid"

"SelectedView"

"selfredirection"

"sendafriend"

"sp"

"subculture"

"subject"

"tabid"

"targetid"

"tbid"

"tbid"

"tellafriend"

"tellafriendbackurl"

"tellafrienderrorcode"

"tellafriendsentto"

"tellafriendtitle"

"theme"

"tid"

"topic"

"ttid"

"UploadErrorResourceToLarge"

"useremail"

"username" '

"usertrackerdisabled"

"utdate"

"utsessionid"

"utuid"

 

Anmerkung:
Wenn Sie diese Elemente im Seitentemplate oder im Script-Code verwenden wollen benötigen Sie folgenden Code context.items(„id“)

Welche context.items verfügbar sind hängt vom aktuellen Kontext aber zum Beispiel sindB. [ci:Username] und [ci:loginalias] nur befüllt wenn ein Benutzer angemeldet ist. Sie können mit ein paar Zielen Code herausfinden welche context.items im Template / Seiten-Template verfügbar sind.

 

Beispiel:

For Each item As DictionaryEntry In Context.Items
If Not item.Value Is Nothing Then
Response.Write(item.Key.ToString()  & " " & item.Value.ToString()  & "<br>")
End If
Next
 
 

MEISTBENUTZTEN CONTEXT.ITEMS

Es gibt viele context.items die Sie in ihrem Template verwenden können deswegen haben wir hier noch einmal die wichtigsten mit deren Bedeutung aufgeführt.

Platzhaltername

Type

Platzhalterbeschreibung

[ci:theme]

Integer

Gibt das verwendete Seitenthema zurück( Seitenthemen können in den Seiteneinstellungen im Sitemanager verwaltet werden.

[ci:cuid]

Integer

Gibt die Id des aktuellen Benutzers zurück, wenn der Benutzer unbekannt ist wird 0 zurückgegeben.

[ci:portalid]

Integer

Gibt die aktuelle Portalid zurück.

[ci:tabid]

Integer

Gibt die aktuelle Tabid zurück (Seitennummer).

[ci:baseurl]

String

Gibt die aktuelle baseurl zurück z. B. http://www.contentxxl.de/.

[ci:pathinfo]

String

Gibt den Teil der url, an der hinter desktopdefault.aspx steht.

[ci:relatedbaseobject]

String

Beinhaltet die Globalid der Seite oder des Objekts falls es sich in der Detailansicht befindet. Wird verwendet, um verknüpfte Objekte zu erkennen.

[ci:lang]

Integer

Gibt die aktuelle languageId zurück.

[ci:xxx]

Multiple

Wenn Sie eigene Parameter über die Url übergeben können Sie diese auch über die context.items auslesen. Zum Beispiel:

Wenn Sie an die Url folgendes anhängen /meinparamter-27/ wird automatisch ein context.items „meinparameter“ erzeugt, welches Sie dann über [ci:meinparamter] ansprechen können.

 
 

VALIDIERENDE PLATZHALTER

Platzhaltername

Platzhalterbeschreibung

[rfval: id: controltovalidateid: parameter]
[/rfval]

Required field validator. Eine Fehlermeldung erscheind wenn das Feld leer ist.

Beispiel: [rfval:firstnameval:firstname:display=dynamic] Bitte geben Sie ihren Vornamen an.[/rfval]

[cpval: id: controltovalidateid: comparecontrolid: operator: parameter][/cpval]

Vergleicht zwei Felder. Operatoren können sein "Equal", "GreaterThan" , "LessThan". Dieser Platzhalter wird mit dem CompareValidator control ersetzt.
Siehe http://msdn2.microsoft.com/de-de/library/system.web.ui.webcontrols.comparevalidator(VS.80).aspx für mehr Informationen über Validatoren.

[rngval: id: controltovalidateid: type: minval: maxval: parameter][/rngval]

Range Validator.

 

Der RegularExpression - Validator hat keinen contentXXL Platzhalter. Wenn Sie diesen verwenden möchten verwenden Sie bitte das originale .NET control wie in folgendem Beispiel.

Beispiel:

<asp:RegularExpressionValidator ID="RegularExpressionValidator1" runat="server" ControlToValidate="Email" ValidationExpression="\w+([-+.']\w+)*@\w+([-.]\w+)*\.\w+([-.]\w+)*">My Error message</asp:RegularExpressionValidator>

Für weitere Informationen:

http://msdn2.microsoft.com/en-us/library/system.web.ui.webcontrols.regularexpressionvalidator_members.aspx

[cusval: id: controltovalidateid: parameter]
[/cusval]

Benutzerdefinierter Validator.

[valsum: id: parameter]

Validation summary.

Beispiel für den  Compare Validator:

 

[tb:password:]<br/>[tb:password2:]<br/>[cpval:passwordval:password:password2:Equal:]Passwords not equal. Please check it again.[/cpval]
 

 

 
 

GRUPPIERUNG UND SORTIERUNG

Platzhaltername

Platzhalterbeschreibung

[set:group:create:fieldname]

Gibt das Kriterium nach welchem gruppiert werden soll.

[set:group:strict:fieldname]

Gibt nur das erste Element aus, falls die Liste verschiedene Einträge des selben Elements beinhaltet.

Beispiel:

[set:group:create:globalid] [set:group:strict:globalid]

[group:start:parameter] [group]

Gibt an nach welchem Feld (Paramter) die Liste Groupiert werden soll. Der Inhalt innerhalb der beiden Platzhalter wird nur angezeigt sobald sich der Wert des Felds ändert. Der Inhalt zwischen dem [group] wird als Liste dargestellt.

[group:finish:parameter] [group]

Gleiche Funktionalität wie group:start. Die Daten zwischen den Platzhaltern werden nur angezeigt wenn sich der Wert des Felds ändert.

[set:filter:expression]

Durch setzten des Filterkriteriums ist es möglich jeden Inhalt zu filter. Die Filterregeln müssen ADO.NET Regeln sein. Für genauere Informationen:

http://msdn.microsoft.com/library/default.asp?url=/library/en-us/cpref/html/frlrfsystemdatadatacolumnclassexpressiontopic.asp
Beispiel:
[set:filter:title like 'a%']

Ausgegeben wir eine List in der nur Objekte angezeigt werden deren Titel mit A beginnt.

[set:order:fieldname]

Bestimmt die Sortierreihenfolge
Beispiel:
[set:order:publish_start DESC]

Die Ausgegebeneliste wird nach den zuletzt veröffentlichten sortiert. Es kann nach mehr als einem Wert sortiert werden diese müssen allerdings durch ein Komma getrennt werden.

Beispiel:

 

[set:group:create:type][group:start:type] <h1>[objecttypename]:</h1>[group]
<span [mvif:previewimage:eq:0]><img src="ResourceImage.aspx?raid=[previewimage]" border="0" alt="[previewimage_alt]" title="[previewimage_alt]"> </span><a href="[morelink]">[title]</a> [EditButton]
 

 

Anmerkung:
Gruppierungen funktionieren auch mit related Inhaltslisten.

 

 

 

 
 

INLINE EDITIERUNG

Template NEWS-Module:

 

[l_title]
[tb:title:width="100%"]
[l_headline]
[tb:headline:width="100%"]
[l_preview]
[tb:preview:textmode="multiline" style="width:100%;height:80px"]
[l_previewimage]
[Imageselect:previewimage:]
[l_description]
[WYSIWYG:description:]
[lbn:save:CommandName="save" text="Save"] [lbn:cancel:CommandName="cancel" text="cancel"]
 

Platzhaltername

Type

Platzhalterbeschreibung

[ImageSelect:id:]

 

Mit diesem Platzhalter ist es möglich eine Bildauswahl wie in den Basisdaten zur Verfügung zu stellen.

[NamedUrlTitle:]

string

Eine Textbox um den Titel der Namedurl anzugeben und einer Schaltfläche um diesen automatisch zu generieren.

[ResourceSelect:id:]

 

Ressourcenauswahl wie in den Basisdaten des Dokumenten Objekts ist es hier möglich eine Ressource über den Ressourcenmanger auszuwählen.

[TB:id:parameters]

string

Das Eingabefeld wird als Textbox oder Textarea ausgegeben. Möchten sie eine Textarea verwenden müssen Sie als parameter textmode=“multiline“ angeben.

[WYSIWYG:id:parameters]

string

WYSIWYG zeigt den WYSIWYG-Editor an um den Text des angegebenen Felds zu bearbeiten.

[tb:Keywords]

String

Mit diesem Platzhalter ist es möglich die SEO-Keywords zu editieren.

[categoryselect]

 

Mit diesem Platzhalter wird eine Kategorienauswahl erzeugt mit der die verknüpften Kategorien geändert werden können.

[objecttypeselect]

 

Mit diesem Platzhalter wird eine Auswahl für Objekttypen generiert, die der im Advancedmodus gleicht.

[EditEventDates]

 

Spezieller Platzhalter für das Veranstaltungs-Modul

 

 

Anmerkung:
Sie können zusätzlich den Parameter GroupVisibility setzen, der es Ihnen ermöglicht, Elemente ein- und auszublenden. Dieser steht für alle Controls und HTML-Elemente zur Verfügung

 

Beispiel:

1. Sie besitzen eine Textbox „Titel“ und möchten diese ein- und ausblenden, fügen sie den Paramter GroupVisibility=“Wert“(Wert steht für einen beliebigen Text oder eine Variable, welche nur Text enthält) hinzu. Danach könnte Ihr Platzhalter wie folgt aussehen:

[tb:Titel:GroupVisibility=“a“]

2. Um nun die Sichtbarkeit zu ändern, benötigen Sie einen Imagebutton, Button oder ein Linklabel mit dem Parameter SwitchVisibility=“Wert“ (hier müssen Sie den selben Text verwenden, wie bei GroupVisibility). Wenn Sie zum Beispiel einen Button verwenden wollen, könnte der Platzhalter dafür wie folgt aussehen:

[bn:Button:SwitchVisibility=“a“]

Auflistung der Module in denen jetzt schon Inline Editing möglich ist:

  • Artikel
  • Blogs
  • Dokumente
  • HTML-Dokumente
  • Kontakte
  • Links
  • Shop

Mit Build 2954 besteht nun die Möglichkeit Veranstaltungen mit unserem Inline-Editor zu bearbeiten

Im Vergleich zu anderen Objekten gibt es nur einen neuen Platzhalter [EditEventDates]. Dieser Platzhalter wird mit den folgenden Controls ersetzt, mit denen auch einzelne Termine der Veranstaltungen bearbeitet werden können.
 
Die Termin Dropdown-Liste zeigt alle Termine und einen zusätzlichen Eintrag für neue Termine an. Sie zeigt immer das Beginn- und End-Datum der Termine an.

Danach besteht die Möglichkeit Beginn-Datum, End-Datum, Beginn-Uhrzeit, End-Uhrzeit und Memo auszufüllen; wobei End-Datum, Beginn-Uhrzeit und End-Uhrzeit nur angezeigt werden, wenn die entsprechenden Felder ausgewählt sind.

Ein Inline-Template könnte wie folgt aussehen:

 

[l_title]
[tb:title:width="100%"]
[l_preview]
[tb:preview:textmode="multiline" style="width:100%;height:80px"]
[l_description]
[WYSIWYG:description]
[EditEventDates]
[lbn:save:CommandName="save" text="Save"] [lbn:cancel:CommandName="cancel" text="cancel"]