Counter (SPT-Tag): Unterschied zwischen den Versionen
Zeile 15: | Zeile 15: | ||
<script | <script | ||
type="text/javascript" | type="text/javascript" | ||
− | src="/ | + | src="/ies/counter?SYS_CNTR_id=101020100000001157-1015%3Ahits;SYS_CNTR_mode=;SYS_CNTR_varName=sp_counter"> |
</script> | </script> | ||
</source> | </source> | ||
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. | ||
− | Voraussetzung für die Nutzung der Counter-Funktion ist, dass die generierte Counter-Url im JavaScript per HTTP-Request erreichbar ist. | + | 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. |
==Attribute== | ==Attribute== | ||
Zeile 80: | Zeile 80: | ||
<noinclude> | <noinclude> | ||
[[Category:SPT-Tags]] | [[Category:SPT-Tags]] | ||
− | |||
[[Category:Qualität_der_Sprache_prüfen]] | [[Category:Qualität_der_Sprache_prüfen]] | ||
[[Category:Qualität_des_Codes_prüfen]] | [[Category:Qualität_des_Codes_prüfen]] | ||
</noinclude> | </noinclude> |
Version vom 18. Juni 2008, 09:34 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 Modul 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>