Dokumentation
Das Kommentar Plugin für moziloCMS
Das quickComment Plugin stellt eine Kommentarfunktion zur Verfügung, mit der die Seite einer Website von Besuchern kommentiert werden kann.
Folgende Vorraussetzungen sind für das quickComment Plugin notwendig:
- moziloCMS ab Version 2.0
- Aktiviertes Javascript im Browser für den Zeichenzähler
quickComment-master.zip [~33 KB]
Das Plugin kann im moziloCMS Backend unter Plugins installiert werden. Dazu die gepackte Plugindatei auswählen (.zip-Datei mit exakt dem gleichen Namen wie das Plugin selbst) und mit Install bestätigen. Das jetzt aufgeführte quickComment Plugin kann nun aktiviert und konfiguriert werden.
Zur manuellen Installation des Plugins, wird ein Serverzugang wie FTP oder SSH benötigt.
- Die .zip-Datei entpacken und den Ordner quickComment in das Pluginverzeichnis:
<moziloroot>/plugins/von Mozilo hochladen. - Ordner- und Dateirechte (chmod) auf 777 für Ordner und 666 für Dateien setzen.
- Im Backend unter Plugins das jetzt aufgeführte quickComment Plugin aktivieren und die gewünschte Konfiguration setzen.
{quickComment|<name>}
Gibt das komplette Kommentarmodul zurück, d.h. sowohl das Kommentarformular, als auch die Kommentarauflistung selbst.
- Parameter
<file>: Der Dateinamen der Datei, in welcher die Kommentare gespeichert werden. Diese Datei ist vom Typ .txt und dient als Datenbank für die spezifische Seite. Für jeden unterschiedlichen Namen wird eine neue Datei angelegt (der Name dient also als ID). Die Datei liegt im Pluginverzeichnis:<moziloroot>/plugins/quickComment/qc_name.txt
Wird auf verschiedenen Seiten das Kommentartag mit dem gleichen Namen vergeben, so zeigen auf diesen Seiten die gleichen Kommentare an, bzw. wird auf einer der beiden Seiten ein Kommentar hinzugefügt, so ist er gleichzeitig auch auf der anderen Seite hinzugefügt. Ist dieser Effekt unerwünscht, so muss einfach nur ein eindeutiger Name gewählt werden.
Folgende Administratoreinstellungen sind für dieses Plugin möglich (Defaultwerte sind im Backend grau in eckigen Klammern dargestellt):
-
Datumsformat: Hier eine Zeichenkette zur Datumsformatierung eingeben, entsprechend der PHP date() Funktion.
-
Spamschutz aktivieren: Diese Option aktiviert den Spamschutz - dh. am Ende des Kommentarformulars erscheint eine Rechenaufgae als Sicherheitsabfrage, die korrekt gelöst werden muss, damit der Kommentar abgeschickt wird. Diese Option wird ausdrücklich empfohlen, um Missbrauch der Kommentarfunktion zu minimieren.
-
Zeichenbegrenzung aktivieren: Diese Option aktiviert eine Zeichenbegrenzung für das Kommentarfeld. Diese Option wird ausdrücklich empfohlen, um Missbrauch der Kommentarfunktion zu minimieren.
-
Zeichanzahl der Zeichenbegrenzung: Ist die Zeichenbegrenzung aktiviert, kann hier die maximale Zeichenanzahl eingegeben werden (z.B. 300).
-
Zeilenumbrüche in Kommentaren zulassen: Diese Option bildet Zeilenumbrüche im Kommentar so ab, wie sie im Eingabefeld eingegeben wurden. Achtung: Kommentare können bei Aktivierung dieser Option u.U. sehr lang werden.
-
Datumsformat: Hier kann das Datumsformat für die Anzeige des Datums in Kommentaren festgelegt werden. Ein zur PHP date() Funktion kompatibles Format eingeben, z.B. d.m.y
-
_Zeitformat:: Hier kann das Zeitformat für die Anzeige der Zeit in Kommentaren festgelegt werden. Ein zur PHP date() Funktion kompatibles Format eingeben, z.B. H:i
-
Mindestzeit zwischen 2 Kommentaren: Mindestzeit zwischen 2 Kommentare der gleichen IP in Sekunden, um zu schnelles Hintereinanderposten zu verhindern.
-
Trennzeichen zwischen Datum und Uhrzeit: Das Zeichen, das zwischen Datum und Uhrzeit im Header der einzelnen Kommentare steht.
-
Wie sollen die Kommentare sortiert werden?: Kommentare nach Datum aufsteigend oder absteigend sortieren.
-
Template für das Kommentarformular: Hier kann das Template für die Anzeige des Kommentarformulars selbst konfiguriert werden. Dabei gibt es folgende Tags:
-
{MESSAGE}Platzhalter für Systemnachrichten -
{NAME}Platzhalter für das Eingabefeld "Name" -
{COMMENT}Platzhalter für das Eingabefeld "Kommentar" -
{CHARLIMIT}Platzhalter für die aktuelle Zeichenanzahl im Kommentarfeld -
{SPAM}Platzhalter für die Anti-Spam Abfrage -
{SUBMIT}Platzhalter für den Absende-Button
-
-
Kommentarformular: Legt die Reihenfolge von Kommentarformular und Kommentaren fest. Mailadresse für Bestätigungsmail: Wird dieses Feld ausgefüllt, wird bei jedem neuen Eintrag eine Bestätigungsmail versendet.
-
Bestätigungsmail: An diese Mailadresse wird eine Bestätigungsmail verschickt, sobald ein neuer Kommentar geschrieben wurde.
-
Username: Hier den Benutzernamen des Benutzers angeben, der im Frontend Kommentare löschen darf. Sobald dieser sich im Frontend anmeldet, findet dieser an jedem Kommentar im Frontend einen Entfernen-Button [X]. Nach der Bestätigung ist der entsprechende Kommentar gelöscht.
Achtung: Das Löschen von Kommentaren benötigt das AccessControl Plugin und kann nicht rückgängig gemacht werden!
{quickComment|kontakt}
Ausgabe:
Das Plugin steht unter der GNU General Public License (GPL) v3, oder frei nach Wahl jede folgende Version. Jegliche Hinweise auf Autor und Urheber müssen erhalten bleiben.
- Frontend: Deutsch, Englisch
- Backend: Deutsch, Englisch
Falls dir dieses Plugin gefällt — ich freue mich immer über eine kleine Unterstützung:
