Wolltet ihr schon immer einmal eine Shoutbox auf eurer Seite haben?
Im Internet gibt es zwar viele Anbieter, aber dabei ist es schwierig, den für sich passendsten auf Anhieb zu finden.
Meistens ist die Shoutbox selbst vom Design her kaum anpassbar.
Ist das passende Design gefunden, fehlen möglicherweise gewünschte Funktionen.

Wer sowieso schon bereits seinen eigenen Webspace besitzt, welcher PHP & MySQL unterstützen sollte, der kann sich nun selbst eine praktische Shoutbox hochladen und ggf. den eigenen Wünschen anpassen.
Die vordefinierte Smiley-Liste ist leicht um weitere Smileys zu ergänzen oder auch neue Funktionen können ihren Platz darin finden.
Die Funktionen selbst können, unabhängig davon, ob sie als Symbol angezeigt werden, in einer anderen Datei definiert werden.
Somit sind z.B. einfache Schriftformatierungen, neue Smileys, Web- & Mailadressen, Zitate oder autom. verkleinert angezeigte Bilder (öffnen bei Klick in Originalgröße in neuem Fenster) kein Problem.
Das Mitteilungs-Feld nimmt sogar mehrzeilige Einträge auf.

Eigene Ergänzungen/Änderungen (bei HTML-Kenntnissen) sind natürlich nicht ausgeschlossen, da der Quellcode ja bereits auf dem eigenen Webspace liegt und jederzeit angepasst werden kann.
Die Design-Änderungen sind zudem leicht per CSS durchzuführen.

Beiträge können wie gewohnt bequem mit der Datenbankverwaltung wie phpMyAdmin geändert und gelöscht werden.
Ein kritischer Beitrag sollte bei aktiv auf "0" gestellt werden, dadurch muss er nicht gelöscht werden (zwecks Rückverfolgung etc.), wird aber auch nicht weiterhin angezeigt.


Installationsanleitung:
Wählt in eurer Datenbankverwaltung (z.B. phpMyAdmin) eine Datenbank aus und führt dann unter SQL das Kommando aus der "shoutbox.sql.txt" aus (Text herauskopieren & einfügen), um das Grundgerüst einer neuen Tabelle für die Shoutbox zu erstellen.
Wenn dies getan ist, könnt ihr gleich in der "config.php" die Login-Daten zur Datenbank eintragen, damit die Shoutbox Zugriff auf die Datenbank erhält.
Falls ihr bisher noch kein Gebrauch von eurer MySQL-Datenbank gemacht habt, aber wisst, dass euer Webhoster dies unterstützt, dann loggt euch dort ein.
Webhoster geben meistens genaue Informationen zur Datenbankverbindung im Userbereich an.

Die Variable $visible_msgs legt einfach nur fest, wieviele der letzten Einträge geladen und angezeigt werden sollen. (Standard: 10)
Weitere Optionen könnt ihr bei Bedarf festlegen, indem ihr die Datei "shoutbox.js" bearbeitet.
Unter anderem werden dort Fehlermeldungen, Aktualisierungsrate der Beiträge und eine beliebig erweiterbare Blacklist für unerwünschte Wörter verwaltet.

Update: Die Dateien config.php und shoutbox.js sollten nicht mit dem Windows-Editor bearbeitet werden.
Ein alternativer Editor wie Notepad++ ist dafür besser geeignet.
Genauere Eläuterungen und evtl. Problem-Behebungen sind unten in meinem nächsten Beitrag zu finden.


Die Einstellungen sind damit soweit abgehakt und ihr könnt den Shoutbox-Ordner auf euren Webspace hochladen.
Geht danach auf eure Website und fügt am Ende der URL den Pfad ein, in welchem der Shoutbox-Ordner hochgeladen wurde, und ihr solltet eine einsatzbereite Shoutbox sehen, z.B. unter:

http://meinewebsite.de/shoutbox/
 

Wollt ihr die Shoutbox direkt in eure Website / euer Forum einbauen, könnt ihr das am einfachsten mit einem iFrame erledigen.

Erfahrene Anwender können die Shoutbox auch direkt in die Seite includen.
Stellt sicher, dass eure Hauptseite die Dateien "shoutbox.js" "shoutbox.css" einbettet und includet dann die "shoutbox.php".
Ggf. muss dann noch der Pfad zur "config.php" in den Dateien "get_messages.php" und "set_message.php" angepasst werden.
Style-Anweisungen können über die extra CSS-Datei "shoutbox.css" bearbeitet werden.

Sollten auch noch Funktionen erweitert und Symbole, um diese einzufügen, ergänzt werden, stehen die Dateien "bbcodes.inc" und "symbols.inc" zur Verfügung.
Erstere kümmert sich um Ersetzungen von BBCodes in Beiträgen zu Smileys, URLs, Bildern etc., letztere sind dann Grafiken/Links, um diese Forencodes per Klick in das Beitragsfeld einfügen zu können.
Im Prinzip analog zur bisherigen Symbol-Bar von Xobor, bei der noch der HTML-Code bearbeitet wurde.



Die Installation nochmal in einfacher Form im Kurzüberblick:

Hallo toggo,
eigentlich ja keine schlechte Idee, für den Foren-Betrieb den Usernamen automatisch einzutragen.
Das wird ja schließlich schon sehr lange von Xoborianern für die Shoutbox von Xobor gefordert.
Das mit den Cookies werde ich wohl in absehbarer Zeit nicht einbauen. Tut mir leid!

Aber nur, weil es wirklich eine alternative benutzerfreundliche Version gibt!
Da womöglich die meisten Administratoren die Shoutbox ja für ihr Forum einsetzen möchten, gibt es jetzt doch eine Möglichkeit, den Benutzernamen direkt einzutragen.
Wenn der Benutzer nicht registriert ist, bleibt das Usernamen-Feld leer.
Zudem gibt es eine neue Option in der config.php, welche das nachträgliche Bearbeiten des automatisch eingetragenen Usernamens erlaubt oder verbietet.
Somit kannst du sicherstellen, dass Foren-User keinen anderen Namen eintragen, oder eben dass sie die Vorauswahl doch noch verändern können.

Das erneuerte Komplett-Paket ist im Anhang des ersten Beitrages zu finden.

$autouser_edit	=	false;				# true/false: automatischer Benutzername bearbeitbar
 

Ein Username für die Shoutbox kann vorgegeben werden, indem der URL-Parameter "user_name" an die URL angehängt wird.
Dadurch würde sich für den Einbau ins Template folgender iFrame eignen:

<iframe frameborder="0" height="480" width="250" src="http://meinewebsite.de/shoutbox/index.php?user_name={{user_name|urlencode}}"></iframe>
 

Damit z.B. nur registrierte User Zugriff auf die Shoutbox haben, müssen eben noch die entsprechenden Template-Variablen drumherumgesetzt werden.

Durch die Möglichkeit, eigene Seiten im Forum zu erstellen, kann die Shoutbox auch auf eine Extra-Seite verlegt werden (s. Screenshot, hier nicht für User erreichbar).
Dadurch wird sie nicht auf jeder Foren-Seite mitgeladen, ist aber dennoch im Forum verfügbar.
Mit Center-Tags kann die Shoubox dann schön mittig auf der Seite positioniert werden (vorher "HTML-Quellcode bearbeiten"-Button klicken):

<center>
	<iframe frameborder="0" height="480" width="250" src="http://meinewebsite.de/shoutbox/index.php?user_name={{user_name|urlencode}}"></iframe>
</center>
 

Aber Achtung: In den weiteren Einstellungen muss "Diese Seite als Template inkl. Template Variabeln ausführen" aktiviert sein.
Weiterhin können die Zugriffrechte hier einfach per Mausklick vergeben werden und man kann auf weitere Template-Variablen wie für registrierte User/Admin etc. verzichten.



Wichtiger Hinweis:
Die Einstellungen in der config.php und shoutbox.php sollten nicht mehr mit dem Windows-Editor durchgeführt werden, sondern einem alternativen Editor wie z.B. Notepad++.
Wichtig ist, dass beim Abspeichern das Format UTF-8 verwendet und dabei nicht automatisch das BOM gesetzt wird. (Weitere Informationen)
Der Windows-Editor kann zwar auch in UTF-8 speichern, setzt aber automatisch das BOM.
Dadurch erscheint vor dem obersten Beitrag fälschlicherweise die Zeichenfolge "".

Der Menüpunkt zur Auwahl des Formates bzw. ggf. zur Konvertierung befindet sich in Notepad++ unter dem Menüpunkt Kodierung.
Sollte aus Versehen das BOM gesetzt worden sein, sollte das Dokument zu "UTF-8 ohne BOM" zurückkonvertiert und wieder gespeichert werden.
Nach erneutem Hochladen sollte die kryptische Zeichenfolge verschwunden sein.


Viel Spaß noch mit der überarbeiteten Shoutbox!

Hi toggo,
die Idee ist eigentlich gar nicht schlecht.
Sie war nur nicht implementiert, weil ich ja bereits mehrere Testbeiträge darin hatte.
Da macht man sich dann keine Gedanken mehr um eine leere Shoutbox.

Und selbst wenn, hätte man ja immer noch die Möglichkeit, als Administrator einen ersten Willkommen-Beitrag zu verfassen.
Aber auf deinen Wunsch habe ich nun kurzfristig noch die Möglichkeit eingebaut, auch ohne verfasste Nachricht einen Text anzuzeigen. (Anhang im 1. Beitrag)

Die Datei get_messages.php wird nun einfach komplett ersetzt.
Die config.php wird hingegen durch folgende neue Option ergänzt:

# (Willkommens)-Nachricht bei leerer Shoutbox (HTML erlaubt):
	$msg_empty		=	'<br />Diese Shoutbox enthält noch keine Einträge.<br /><br />'."\r\n".
						'Nutze doch einfach die Gelegenheit, dich als Erster einzutragen...';
 

Das "r n" am Ende des Textes sorgt nur für einen Zeilenumbruch im Quellcode (nur zur Quellcode-Lesbarkeit), die BRs sind wichtiger, denn sie sind für die sichtbaren Umbrüche im Text zuständig.
Strings werden in PHP mit "." aneinandergereiht (verkettet), im Gegensatz zu "+" bei z.B. JavaScript.
Nur zur einfacheren Lesbarkeit habe ich nicht alles in eine Zeile geschrieben sondern miteinander verkettet.

Aber man sieht, dass in der Anfangsnachricht HTML erlaubt ist.
Der Administrator kann hier einen Text festlegen und ggf. formatieren (oder auch Bilder etc.), der bei einer leeren Beitragsliste angezeigt wird.


P.S.:
Schaue gerne einmal in die BBCodes.inc.
Auch wenn dort alles zuerst ein bisschen Wirr aussieht, so kannst du zumindest erkennen, welche Foren-Codes standardmäßig auch in der Shoutbox verfügbar sind.
Und dadurch eben auch mal Bilder, Links und Mail-Adressen ausprobieren.
Zweiteilige Tags wie B, U, I sollten auch relativ leicht nach dem gleichen Schema erweiterbar sein, genauso wie einteilige, z.B. Smileys etc.
Nur die erweiterten wie für Links, Bilder etc. sind evtl. etwas schwieriger anzulegen, je nach Anforderung.

Wenn dir noch Smileys fehlen, fühle dich frei, in der Symbols.inc deine eigenen Smileys zu ergänzen, welche du natürlich als Forencode vorher in der BBCodes.inc angelegt haben solltest.
Die Schemen sind eigentlich leicht durchschau- und erweiterbar.

(am Besten mit Notepad++ bearbeiten, um das BOM zu vermeiden. )

Danke danke,
nicht nur für das überschwängliche Lob, auch für deine Rückmeldung.

Ich würde dich hier gerne kurz zitieren, um anderen Usern Probleme mit der Blacklist zu ersparen:

Zitat von toggodamian

---

Mir fällt gerade auf das das mit den Schimpfwörtern nicht funktioniert...

---

Da hast du leider recht! Das war's wohl mit der Perfektion.

Naja, im Grunde funktioniert die Liste eigentlich.
Der kleine Bug ist es, Großschreibung in den Wörtern zu verwenden.
Wenn alle Wörtern kleingeschrieben wurden, dann funktioniert es sogar tatsächlich.
War natürlich doof von mir, dann Beispiele reinzuschreiben, welche groß anfangen.

Dabei ist es später dann egal, ob ein böser Nutzer dann GrOß- UnD KlEiNsChReIbUnG verwendet oder nicht.
Nur die Filter-Wörter müsste man klein schreiben.

if (msg_name.toLowerCase().indexOf(vulgarly_words[i])!=-1 || msg_message.toLowerCase().indexOf(vulgarly_words[i])!=-1)
 
if (msg_name.toLowerCase().indexOf(vulgarly_words[i].toLowerCase())!=-1 || msg_message.toLowerCase().indexOf(vulgarly_words[i].toLowerCase())!=-1)
 

Also hast du die config.php und shoutbox.php bereits entsprechend angepasst?

Dann lege dir unter Admin -> Layout -> Eigene Seiten eine neue Seite an, bei welcher in den erweiterten Einstellungen der Haken "Diese Seite als Template inkl. Template Variabeln ausführen" aktiviert ist.

Analog zu Beitrag #3 fügst du als Inhalt der Seite einen IFrame ein:

<iframe frameborder="0" height="480" width="250" src="http://www.meinserver.de/shoutbox/index.php?user_name={{user_name|urlencode}}"></iframe>
 

Die Adresse des iFrames muss auf die index.php in dem Shoutbox-Ordner deiner Website eingestellt sein.


Wenn du dann die neu erstellte Seite in deinem Forum über die Navigation aufrufst und alles korrekt eingerichtet hast, solltest du nun eine Shoutbox auf der Seite sehen. Wenn das nicht klappt, brauchst du erstmal nicht versuchen, weitere Anpassungen vorzunehmen. Das muss zuerst einmal alles so laufen. Probiere dann ggf. die Adresse im src-Attribut des IFrames mal direkt in deinem Browser aufzurufen. Wenn du dann keine Shoutbox siehst oder sie Fehler enthält, dann stimmt entweder die Adresse nicht oder die Einrichtung ist noch nicht korrekt.


P.S.: Die Shoutbox lässt sich zwar in das Forum einbinden, wurde ursprünglich aber so erstellt, dass man sie auch in der eigenen Website einbauen kann. Sie hängt also nicht vom Forum ab und ist daher auch unabhängig außerhalb aufrufbar.

Dann hast du ja deine URL für den IFrame:

<iframe width="250" height="480" src="http://dj-frechdax.bplaced.net/shoutbox/index.php?user_name={{user_name|urlencode}}"></iframe>
 

In dem Ordner liegt auch eine Datei shoutbox.css bei, in der kannst du das vorgegebene Design abändern und erweitern.


Wenn du die Shoutbox nicht auf einer eigenen Seite einbindest (welche bereits über Rechte-Einstellungen verfügt), dann kannst du den IFrame auch mit Template-Variablen einrahmen:

{{user_registered==true.start}}
	<iframe width="250" height="480" src="http://dj-frechdax.bplaced.net/shoutbox/index.php?user_name={{user_name|urlencode}}"></iframe>
{{user_registered==true.end}}
 

Wo genau die Shoutbox erscheint, kommt darauf an, in welches Template-Element du den Quellcode in deinem Plugin einsetzst.

Nein, der Xobor-Chat läuft nicht unabhängig. Den kannst du also nicht extra aufrufen.

Die eigentliche Ersetzung von Foren-in HTML-Codes (und damit auch img-Tags mit Smilies) geschieht über reguläre Ausdrücke und diese findest du in der Datei bbcodes.inc.

Um die Anordnung von Namens und Nachrichten-Feld zu ändern, kannst du den Aufbau der Tabelle darum in der shoutbox.php ändern. Dort findest du auch ein include('symbols.inc'), in dieser Datei sind die angezeigten Smiley-Icons enthalten, welche die Foren-Codes bei Klick in das Textfeld einfügen. Dort kannst du bei Bedarf auch die Smileys in einen eigenen Container packen oder weitere Symbole für Kursiv etc. nachrüsten.

Die regulären Ausdrücke zu erlernen lohnt sich auf jeden Fall wirklich, da man diese immer mal wieder gut gebrauchen kann.

Hast du die geänderte CSS auch mal auf dem Server überprüft, ob sie wirklich richtig hochgeladen wurde, manchmal verraut man dem Upload-Programm einfach etwas zu sehr.
Oder du hast CSS-Selektoren ergänzt, welche so nicht auf ein Element zutreffen und daher keine Anwendung finden. Vielleicht liegt die CSS aber einfach noch im Cache deines Browsers und wurde nicht erneut abgerufen.