DEPRECATION WARNING
This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.
EXT: Global Graphical Counter¶
Author: | Kasper Skårhøj |
---|---|
Created: | 2002-11-01T00:32:00 |
Changed by: | Sholto Douglas |
Changed: | 2005-01-27T21:43:45 |
Author: | Sholto Douglas |
Email: | sd@sholto.de |
Info 3: | |
Info 4: |
EXT: Global Graphical Counter¶
Extension Key: sd_globgraphcounter
Copyright 2000-2002, Sholto Douglas, <sd@sholto.de>
This document is published under the Open Content License
available from http://www.opencontent.org/opl.shtml
The content of this document is related to TYPO3
a GNU/GPL CMS/Framework available from www.typo3.com
Inhalt¶
Einleitung 2
Aufgabe 2
Screenshots 2
Konfiguration 3
Installation 3
Einrichtung 3
eigene Styles erstellen 3
Die Grafiken 4
Der Counterstand 4
Anhang 5
Parameter 5
Bekannte Probleme 5
ToDo 5
Changelog 5
Einleitung¶
Aufgabe¶
Mir diesem Plugin ist es möglich einen grafischen Counter an jeder beliebigen Stelle der Internetseite einzubinden.
Es wird ein globaler Zähler verwendet. Das heisst, egal, wo und wie oft der Counter eingebunden wird, es wird immer der gleiche Zählerstand angezeigt.
Um Sicherzustellen, dsa der Counter nicht durch laufendes aktualisieren der Seite hochgetrieben wird, wurde eine IP Prüfung eingefügt. Jeder Besucher kann den Counter nur einmal je Stunde um eins erhöhen.
Screenshots¶
Konfiguration¶
Installation¶
Plugin sd_globgrapcounter über den Extension Manager laden und Installieren.
Einrichtung¶
Dieses Plugin lässt sich nur über typo3 Script einbinden.
Hier ein Beispiel:
plugin.tx_globgraphcounter_pi1 {
style = D
extension = gif
path = style
}
page = PAGE
page.typeNum = 0
page.10 = TEXT
page.10.value = Ein kleines Beispiel:
page.20 0 USER
page.20 =< plugin.tx_sdglobgraphcounter_pi1
Ergebnis:
style – gibt das Verzeichnis zu den Grafiken an
Möglichkeiten: D, H1, H2, (eigene styles)
extension – Welche Erweiterung tragen die Dateien (welches Grafikformat)
Möglichkeiten: gif, png, jpg ... (alles was so ein Browser alles unterstützt)
path – der Pfad zu den styles relativ ausgehend vom plugin
Das Plugin wird im Verzeichnis typo3conf/ext/sd_globgraphcounter abgelegt.
Die Styles befinden sich in typo3conf/ext/sd_globgraphcounter /style
eigene Styles erstellen¶
Eigene Styles müssen in einem eigenem Ordner unter style abgelegt werden. Der Ordnernamewird unter style eingetragen.
Beispiel 1 : Die Dateien werden in ein Verzeichnis unter typo3conf/ext/sd_globgraphcounter/style/ neu angelegt.
Dann muss style = neu und path = style in der Konfiguration eingetragen werden
Beispiel 1 : Die Dateien werden in ein Verzeichnis unter typo3conf/ext/sd_globgraphcounter/ counter / neu angelegt.
Dann muss style = neu und path = counter in der Konfiguration eingetragen werden
Die Grafiken¶
Als Beispiel sehen wir uns an, welche Dateien im Verzeichnis typo3conf/ext/sd_globgraphcounter/style/H1 vorhanden sind:
0.gif Die Grafikanzeige “0”
1.gif Die Grafikanzeige “1”
2.gif Die Grafikanzeige “2”
...
9.gif Die Grafikanzeige “9”
bottom.gif Die Grafikanzeige unter den angezeigten Zahlen
left.gif Die Grafikanzeige links der angezeigten Zahlen
right.gif Die Grafikanzeige rechts der angezeigten Zahlen
top.gif Die Grafikanzeige über den angezeigten Zahlen
Um also einen eigenen Countertyle einzubinden sind nur die Zahlen als einzelne Grafiken unter den entsprechenden Dateinamen abzulegen.
Die Dateien bottom, left, right, top sind obligatorisch. Diese können je nach eigenem Geschmack auch weggelassen werden.
Der Counterstand¶
Standardmäßig startet der Counter bei “1”
Momentan lässt er sich über durch ändern des Feldes Count der Tabelle tx_sdglobalgraphcounter_counter anpassen. (siehe ToDo)
Anhang¶
Parameter¶
style¶
Parameter
style
Datentyp
String
Beschreibung
Das Verzeichnis des Counterstyles, in welchem die Grafiken liegen
Default
D
Path¶
Parameter
Path
Datentyp
String
Beschreibung
Relativer Pfad zu den Styles, ausgehend von typo3conf/ext/sd_globgraphcounter
Default
styles
Extension¶
Parameter
Extension
Datentyp
String
Beschreibung
Dateierweiterung der Grafiken
Default
gif
((Unknown Property))¶
Parameter
Datentyp
Beschreibung
Default
Bekannte Probleme¶
Die Beispielgrafiken der Styles H1 und H2 sind auf einen 4-Stelligen Counterstand ausgelegt. Dies muss immer angepasst werden, wenn der Counterstand nicht 4-Stellig ist. (siehe ToDo)
ToDo¶
- einfaches Einstellen des Counterstands
- Automatisches anpassen der Grafiken auf die anzahl der Stellen
- Einstellen der Stellen, die mindestens angezeigt werden
- Einstellen der Wartezeit, bevor ein Benutzer mit der gleichen IP den Counter hochzählen kann.