II99-Forum Dokumentation

[ Download hier: ii99-forum.zip ]

Das II99-Forum entstand aus dem Wunsch heraus, eine unkomplizierte Kommunikationsplattform für meine Seminargruppe II99 an der Hochschule in Görlitz zu schaffen. Außerdem war dies eine willkommene praxisrelevante Anwendung für die mir damals noch neue Sprache Perl. Änderungen und Anpassungen wurden nach und nach eingearbeitet, sobald die Praxis eine entsprechende Idee sinnvoll erschienen ließ. Aus diesem Grund gibt es auch keine Versionsnummern. Die Skripte sind lediglich mit dem Datum ihrer letzten relevanten Änderung gekennzeichnet.

Die Bedienung des Forums erklärt sich größtenteils von selbst. Auf einige Besonderheiten soll jedoch hingewiesen werden. So wird beispielsweise die Möglichkeit, zwischen drei verschiedenen Ansichten umzuschalten, oft übersehen, da sich die entsprechenden Formularfelder erst am Ende der Threadansicht finden. Beim Schreiben eines Eintrages oder einer Antwort sind sämtliche Felder optional. Es sind sogar Einträge denkbar, die nur aus einer Betreffzeile bestehen. Die voreingestellte eMail-Adresse kann ignoriert werden. Da sie mit einem @ beginnt, wird sie automatisch übergangen. Innerhalb der Texte können Zeilenumbrüche und sämtliche übliche Sonderzeichen verwendet werden. E-Mail und Internet-Adressen werden automatisch als anklickbare Links formatiert, ohne dass sich der Anwender darum kümmern muss.

HTML- und BBCodes

http://www.example.com und ähnliche Adressangaben werden automatisch formatiert, die Adresse muss mit http oder www beginnen, eventuelle Parameter inklusive ?, =, &, # usw. werden erkannt
mail@example.com und ähnliche Mailadressen werden automatisch formatiert
[b]Fettschrift[/b]
[i]Kursiv[/i]
[tt]Schreibmaschinenschrift[/tt], normaler Fließtext, verändert nur die Schriftart
[pre]Präformatiert[/pre], erzeugt einen neuen Absatz, Leerräume bleibt erhalten
[img]http://www.domain.de/bild.jpg[/img], die Adresse muss mit http beginnen und auf jpg, jpeg, gif oder png enden

Technische Informationen

Programmiert wurde das Forum von mir, Thiemo Kreuz, wobei ich natürlich Anleihen und Hilfen diverser anderer Quellen nutzte. Besonders danken möchte ich Matthias Hänel, Matthias Mirle, Frank Seidel und Michael Möller.

Das Forum basiert auf einem CGI-Skript, das mit Hilfe verschiedener Parameter alle Funktionen ausführt, die zur Anzeige und Verwaltung der Textbeiträge notwendig sind. Die Organisation in Unterprogrammen und die Verwendung globaler Variablen sowie Style-Sheets machen die Konfiguration und Anpassung an andere Gegebenheiten relativ einfach. Als Sprache kommt Perl in der Version 5 zum Einsatz. Die Ablage der Daten wird durch eine Textdatei realisiert, in der jeder Eintrag eine Zeile belegt. Ein gesondertes Administrationsskript vereinfacht die Verwaltung und bietet Sonderfunktionen wie zum Beispiel eine Statistik.

Versionsgeschichte

4. April 2000

Das erste primitive, auf einem Gästebuch basierende Forum

20. Juni 2000

Sperrung des alten Forums, nachdem es mit 50 identischen Einträgen gefüllt wurde

23. Juni 2000

Erste öffentlich zugängliche Version des neuen Forums auf der Homepage der II99
Sortierung der Einträge in "Threads", Textanzeige nur noch in der Detailansicht
Sämtliche Sonderzeichen (HTML-Codes, Zeilenumbrüche) werden richtig dargestellt
Beim Antworten wird der vorherige Text als Zitat angezeigt

30. Juni 2000

Layout komplett auf Style Sheets umgestellt
Wahlweise Sortierung nach Datum, teilweises Mitführen der Option
Neue Links, um auch in der Detailansicht schnell zwischen den Einträgen zu blättern
Monat wird in der Detailansicht ausgeschrieben angezeigt
Reguläre Ausdrücke zur Erkennung von Internet- und eMail-Adressen weiter verbessert
Wortloses Verwerfen von Einträgen nur noch, wenn sowohl Betreff als auch Text leer sind
Doppelte Einträge (identischer Betreff und identischer Text) werden wortlos verworfen
Fehlende Angaben werden als leere Variablen gespeichert und dynamisch korrigiert
JavaScript zur automatischen Fokusierung der Eingabefelder in Formularen

5. Juli 2000

Alternative Anzeige nach dem Vorbild von Zombies Board
Einträge ab einer gewissen Größe werden nicht akzeptiert
Diverse optische Verfeinerungen

14. Juli 2000

Erste ansatzweise Implementierung einer seitenweisen Anzeige
Antworten können zusätzlich auch als E-Mail verschickt werden

3. September 2000

Kleine Bugs entfernt, Sonderzeichen werden fast überall korrekt angezeigt

10. November 2000

Anzahl der Einträge pro Seite ist frei wählbar
Wahlweise Sortierung auch nach Absender und Betreff
Neues Optionsmenü zur komfortablen Wahl der Anzeige- und Sortiermodi
Die Sortieroptionen bleiben bei nahezu allen Links erhalten
Neuer Anzeigemodus "Topics" zeigt nur die Haupteinträge der untersten Ebene
Administrator-Funktionen in ein getrenntes Skript ausgelagert
Stark erweiterte Statistiken

30. November 2000

Auslagerung aller Optionen in eine externe Konfigurationsdatei
Seitenbreite (normalerweise 100%) ist per Parameter einstellbar
Breite der Formularfelder ist per Parameter einstellbar
Alternative Anzeigemodi können generell abgeschaltet werden
Sicherung der Datendatei mittels File-Lock

15. Dezember 2000

Grafische Markierung der besonders aktuellen Einträge
Einträge werden ab einem wählbaren Alter automatisch gelöscht
Neueinträge werden wahlweise per E-Mail an den Administrator gesandt
Den verwirrenden Anzeigemodus "Zombie" umbenannt in "Komplett"
Viele optische und technische Detailverbesserungen

22. Dezember 2000

Erster profesioneller Einsatz des Forums auf Jan Harenburgs CDrompage

10. Januar 2001

Schutz des Admin-Skriptes mittels .htaccess und .htpasswd
Zeitabhängige Anzeige des Datums als "heute" und "gestern"
Automatischer Zeilenumbruch in E-Mails nach 70 Zeichen
Erklärender Vorspann in E-Mails mit direkter Antwortmöglichkeit

24. Januar 2001

Topic-Modus ist jetzt vollständig implementiert
Seitenweises Blättern funktioniert jetzt auch im Topic-Modus korrekt
Die im Topic-Modus verbotene Sortieroption wird automatisch ausgeblendet

31. Januar 2001

Fehlerhafte Datumsanzeige im Topic-Modus korrigiert
Formatierungscodes werden nicht mehr angezeigt, wenn man auf einen Beitrag antwortet

14. März 2001

Texte wie z.B. "Sl@jaR" werden nicht mehr als Email-Adresse markiert
Links mit einfachen Get-Variablen am Ende ('%' und '+' sind nicht erlaubt) werden jetzt erkannt

3. April 2001

Erkennung von URLs wesentlich verbessert
Admin-Skript benutzt jetzt ein eigenes unabhängiges Anzeigeformat

11. Mai 2001

Keine Anzeige der Seitenzahl, wenn es nur eine Seite gibt
Links zu Datendateien (z.B. .zip) werden nicht mehr in einem neuen Fenster geöffnet
Neue Administrator-Funktion zur Prüfung der Datenkonsistenz

19. Juni 2001

Völlig neue Funktion die Threads nur noch löscht, wenn sie vollständig veraltet sind (keine verwilderten Re's mehr)
Auf veraltete Einträge kann nicht mehr geantwortet werden
Interne Beschleunigung des Topic-Modus

8. November 2001

Ein lokales Cookie merkt sich Name und E-Mail, um Tipparbeit zu sparen
Übertriebene Wiederholungen identischer Zeichen werden auf maximal 10 Zeichen gekürzt
Verbesserung der BBCodes [i], [b], und [tt], jetzt auch mehrzeilig und verschachtelt möglich
Beim Antworten werden nur noch maximal 1000 Zeichen als Zitat angezeigt
Die Option "als Mail verschicken" wurde ersetzt durch "sende mir alle zu meinem Eintrag gehörenden Antworten"
BBCodes werden jetzt entfernt, bevor ein Text als E-Mail verschickt wird

7. Dezember 2001

Vereinigung zweier existierender Versionen des Forums zu einer endgültigen Version
Das Cookie speichert jetzt auch die E-Mail Option
Die Ansichtseinstellungen können auf Wunsch permanent im Cookie gesichert werden
Anzahl "10" zu den Ansichtseinstellungen hinzugefügt
HTML-Code [pre] hinzugefügt
URLs mit den Sonderzeichen "Komma" und "Und" werden erkannt
Komplettmodus wesentlich verfeinert, Zeilenumbrüche, Links und HTML-Codes werden eingeschränkt (!) angezeigt
Im Komplettmodus wird das Datum kleiner angezeigt
Betreffzeilen mit "Re:" sind im Topicmodus generell ausgeblendet
Im Topic-Modus ist auch die Zahl der Antworten anklickbar
Fehlender Betreff bzw. fehlender Inhalt wird einheitlicher behandelt und bei Bedarf generiert
Reset-Buttons bei den Formularen entfernt
Der Administrator erhält nicht mehr alle Einträge per E-Mail sondern nur noch neu gestartete Topics
Der Link in den E-Mails führt nicht mehr direkt zum Antwortformular sondern erst einmal zur Anzeige
Der Link "Anzeige aktualisieren" springt immer zurück zur ersten Seite
Benutzerfreundlichkeit verbessert, eindeutigere Beschriftungen von Links etc.
Das Adminskript zeigt die Anzahl der Antworten zu jedem Eintrag an
Konsistenzcheck sucht und entfernt doppelte Einträge automatisch
Darstellung getestet und optimiert für Netscape 4.0x, 4.7x, 6.1, Opera 5.0x (<p><table> ... </table></p> scheint optimal zu sein)
Bei schreibgeschütztem Datenverzeichnis wird die Backupdatei automatisch abgeschaltet
Viele interne Optimierungen, verfeinerte reguläre Ausdrücke, wesentlich besser lesbarer Quellcode

22. Januar 2002

Bugfix: < und > wurden im Komplettmodus als < und > angezeigt
Bugfix: \r\r\n wurde nicht erkannt und in \r\n anstatt \n umgewandelt

7. März 2003

Zusammenstellung einer etwas endgültigeren Installationsversion
Lesbarerer Quelltext

Geplante Verbesserungen

Formatierung des gesamten Forums über StyleSheets möglich machen (CSS)
Möglichkeit hinzufügen, um im Thread die Antworten andersfarbig anzuzeigen (CSS)
Listendarstellung wahlweise auch einfarbig, aber mit Trennern zwischen den Zeilen (CSS)
Gemischter Topic/Normal-Modus mit auf- und zuklappbaren Threads
Sortieren auch im Topic-Modus (derzeit technisch nicht machbar)
Ausgabeform des Datums einstellbar machen (dank einer zentralen Funktion schon möglich), allgemeine Unterstuetzung verschiedener Sprachen, Deutsch/Englisch und selbstdefinierbar
Bereits gelesene/neue Einträge anhand eines lokalen Cookies erkennen, sinnvoll scheint nur eine Liste von IDs der zuletzt gelesenen Eintraege zu sein, wobei die aeltesten hinten rausfallen
Anzeige eines kleinen Threads in der Detailansicht jedes Eintrages, in Form eines Mini-Baumes mit nur einer höheren/tieferen Ebene, also nur der Elterneintrag sowie eine Liste aller direkten Antworten (plus ein Vorgänger/Nachfolger innerhalb der selben Ebene)
```
+--- Parent
     +--- Nachfolger (juenger)
     +--- Self (nicht anklickbar)
          +--- Antwort 3
	  +--- Antwort 2
	  +--- Antwort 1
     +--- Vorgaenger (aelter)
```
Alles mit Datumsanzeige, angelehnt an die Normalansicht, Self ist immer sichtbar, alle anderen sind optional (aber eins ist zwangsweise immer da). TEILWEISE SCHON IMPLEMENTIERT; SIEHE #BETATEST.
Prüfung und Ablehnung unsinniger E-Mailadressen (zur Zeit bringt sendmail das Skript zum Absturz, wenn jemand E-Mails ohne '@' eingibt).
Umsetzung aller Skripte von Perl zu PHP (als eigenständige Version).