Counter (SPT-Tag): Unterschied zwischen den Versionen

Version vom 10. Juni 2008, 20:17 Uhr

Name

<spt:counter> - Zählt Zugriffe auf publizierte Informationen

Syntax

<spt:counter name="variable" mode="read" varname="variable"/>

Beschreibung

Mit dem sp:counter-Tag kann ermittelt werden wie oft eine Seite aufgerufen wurde.

<spt:counter name="hit"/> erzeugt in der Ausgabeseite JavaScipt-Code in Form von

<script 
  type="text/javascript" 
  src="/infosite/counter?SYS_CNTR_id=101020100000001157-1015%3Ahits;SYS_CNTR_mode=;SYS_CNTR_varName=sp_counter">
</script>

Bei jedem Aufruf der Seite wird die angegebene Counter-Variable um eins hochgezählt. Der counter-Tag wird ausschließlich im Ausgabebereich eines Templates genutzt. Der Counter-Wert kann im Eingabebereich eines Templates mit sp:print oder sp:text ausgegeben werden. Zu beachten ist hierbei, dass der Counter als Content-Typ "counter" gespeichert wird. Counter werden intern im CounterInformation-Objekt verwaltet.

Voraussetzung für die Nutzung der Counter-Funktion ist, dass die generierte Counter-Url im JavaScript per HTTP-Request erreichbar ist.

Attribute

Name	Type	Required	Default	ab IES Version
`name`	Variable	Ja	None	1
`mode`	Text	Nein	None	1
`varName`	Text	Nein	sp_counter	1

name: Name der Variablen in der der Zugriffswert gespeichert wird.

mode

Der Zähler kann in verschiedenen Modi betrieben werden. Gültige Modi sind:

read: Counter wird nicht hoch gezählt, sondern es wird nur der aktuelle Zählerstand als JavaScript-Variable ausgegeben.
write: Counter wird hochgezählt, aber es wird keine JavaScript-Variable gesetzt.
keine Angabe: Counter wird hochgezählt und der aktuelle Zählerstand wird als JavaSript-Variable ausgegeben.

varName: der Name der JavaScript-Variablen, in die der aktuelle Counterwert ausgegeben wird [default=sp_counter].

Beispiele

Mit spt:counter eine Variable setzen

Template Quelltext

<sp:io type="in">
  <sp:text name="meincounter" type="counter"/>
</sp:io>

<sp:io type="out">
  <spt:counter name="meincounter" mode="read"/>
</sp:io>

@@ Zeile 19: / Zeile 19: @@
 </source>
-Bei jedem Aufruf der Seite wird die angegebene Counter-Variable um eins hochgezählt. Der counter-Tag wird ausschließlich im Ausgabebereich eines Templates genutzt. Der Counter-Wert kann im Eingabebereich eines Templates mit [[sp:print]] oder [[sp:text]] ausgegeben werden. Zu beachten ist hierbei, dass der Counter als [[Content-Type|Content-Typ]] "counter" gespeichert wird.
+Bei jedem Aufruf der Seite wird die angegebene Counter-Variable um eins hochgezählt. Der counter-Tag wird ausschließlich im Ausgabebereich eines Templates genutzt. Der Counter-Wert kann im Eingabebereich eines Templates mit [[sp:print]] oder [[sp:text]] ausgegeben werden. Zu beachten ist hierbei, dass der Counter als [[Content-Type|Content-Typ]] "counter" gespeichert wird. Counter werden intern im [[CounterInformation]]-Objekt verwaltet.
 Voraussetzung für die Nutzung der Counter-Funktion ist, dass die generierte Counter-Url im JavaScript per HTTP-Request erreichbar ist.
@@ Zeile 60: / Zeile 60: @@
 ;<code>varName</code>
-:der Name der JavaScript-Variablen, in die der aktuelle Counterwertb ausgegeben wird [default=sp_counter].
+:der Name der JavaScript-Variablen, in die der aktuelle Counterwert ausgegeben wird [default=sp_counter].
 ==Beispiele==