Counter (SPT-Tag)

Aus SiteparkWiki
Zur Navigation springen Zur Suche springen

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>