Counter (SPT-Tag): Unterschied zwischen den Versionen

Version vom 19. Juni 2008, 12:09 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="/ies/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. Dazu muß der Publikationsbereich in dem die Seite generiert wurde als Webapplikation im IES aktiviert sein. Zusätzlich muss der Webserver einen JkMount von /ies/counter auf den IES gesetzt haben.

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 21: / Zeile 21: @@
 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. Dazu muß der Publikationsbereich in dem die Seite generiert wurde als Modul aktiviert sein. Zusätzlich muss der Webserver einen JkMount von <code>/ies/counter</code> auf den IES gesetzt haben.
+Voraussetzung für die Nutzung der Counter-Funktion ist, dass die generierte Counter-Url im JavaScript per HTTP-Request erreichbar ist. Dazu muß der Publikationsbereich in dem die Seite generiert wurde als [[Webapplikation]] im IES aktiviert sein. Zusätzlich muss der Webserver einen [[JkMount]] von <code>/ies/counter</code> auf den IES gesetzt haben.
 ==Attribute==