Counter (SPT-Tag): Unterschied zwischen den Versionen
Zur Navigation springen
Zur Suche springen
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. | 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. | ||
− | + | Um spt:counter Nutzern zu können müssen zwei Bedingungen erfüllt sein: | |
+ | # Der Counter-Manager muß aktiviert sein. Dieser kann über die Administrations-Oberläche des IES im Bereich 'Dienste' gestartet werden. | ||
+ | # Die generierte Counter-Url im JavaScript muss per HTTP-Request erreichbar ist. Dazu muß der Publikationsbereich in dem die Seite generiert wurde als [[Webapplication|Webapplikation]] im IES aktiviert sein. Zusätzlich muss der Webserver einen [[JkMount]] von <code>/ies/counter</code> auf den IES gesetzt haben. | ||
==Attribute== | ==Attribute== |
Version vom 30. Oktober 2008, 15:58 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.
Um spt:counter Nutzern zu können müssen zwei Bedingungen erfüllt sein:
- Der Counter-Manager muß aktiviert sein. Dieser kann über die Administrations-Oberläche des IES im Bereich 'Dienste' gestartet werden.
- 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>