Counter (SPT-Tag)

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.

Um spt:counter Nutzern zu können müssen zwei Bedingungen erfüllt sein:

1. Der Counter-Manager muß aktiviert sein. Dieser kann über die Administrations-Oberläche des IES im Bereich 'Dienste' gestartet werden.
2. Die generierte Counter-Url im JavaScript muss 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>