Julians Blog

TiTFLfPHP

Tiny TextFormatLibrary for PHP

Die Arbeiten an der TiTFL wurden eingestellt, da die Proliga mittlerweile andere Systeme verwendet.

Die TiTFL war eine Idee von mir während den Arbeiten an der Proliga, einem Fußball-Browsergame. Das Problem war, dass nicht alle im Team ausreichende HTML-Kenntnisse besaßen, um gut formatierte Texte zu schreiben. Also schrieben wir die Texte, um sie leichter wieder ändern zu können, in einer Mischung aus bekanntem BB-Code und eigenen Tags. Da aber irgendeine Funktion oder ähnliches diese Tags wieder interpretieren musste und in HTML umsetzen musste, schrieb ich die TiTFL for PHP.

Die Anwendung ist ganz einfach. Die Datei TiTFL.php einfach in ein beliebiges Verzeichnis auf dem Webserver hochladen, per PHP includen oder requiren, je nachdem. Dann stehen folgende Funktionen zur Verfügung:

string titfl_parse_string( string content [,bool allow_html] )
Parst den String content und gibt ihn formatiert zurück. Ist der optionale Parameter allow_html gleich 1, werden HTML-Tags in content nicht gelöscht. Ob der letzte Parameter Wirkung zeigt, hängt von der Einstellung $TITFL['conf']['html'] ab. Ist der Wert dieser Variablen -1, zeigt der Parameter Wirkung, ist er 0 ist HTML generell abgeschaltet, ist er 1 ist HTML generell eingeschaltet.

string titfl_parse_file( string file [,bool allow_html] )
Funktioniert genauso wie titfl_parse_string, nur dass statt einem String der zu parsen ist, eine Datei angegeben wird.

string titfl_translate_string( string content )
Übersetzt einen String in BB-Code und gibt ihn zurück. Kann keine Regulären Ausdrücke verarbeiten.

string titfl_translate_file( string file )
Funktioniert genauso wie titfl_translate_string, nur dass statt einem String eine Datei übersetzt und ausgegeben wird.

In der Datei TiTFL.php können zudem noch eigene BB-Codes sowie reguläre Ausdrücke definiert werden.

Aktuelles Release: 0.1.5 BETA (download) vom 23.2.2008