Der Textkonverter XHTML ist kein eigentlicher Textkonverter, da er eigentlich nichts tut. Er speichert den eingegebenen Text unverändert ab. Sein Einsatz empfiehlt sich dann, wenn man HTML-Code eingeben möchte.

Er ist der Standard-Textkonverter und darf nicht aus dem System entfernt werden, da es sonst passieren kann, dass beispielsweise der Mediamanager oder die Hilfsfunktionen zum Integrieren von Links oder Boxen nicht funktionieren. Dies, da er die Standardfunktionalität dazu bereitstellt, auf die andere Textkonverter zurückgreifen können, wenn sie selber über keine Methoden zum Einfügen eines Elements verfügen.

Der Textkonverter Markdown^[13] ist eine Entwicklung von John Gruber und in Form von PHP Markdown Extra^[14] von Michel Fortin integriert.

Markdown bietet eine einfache und klare Syntax, die sich zur einfachen Strukturierung von Texten eignet.

Textile^[15] ist eine Entwicklung von Dean Allen und ursprünglich für die Weblog-Software Textpattern entwickelt worden.

Textile eignet sich vor allem für kompliziertere Formatierungen, bei denen Elementen beispielsweise IDs oder CSS-Klassen zugewiesen werden sollen.

Um ein Textkonverter-Plug-in zu erstellen, werden zwei Dinge benötigt:

Wie der Textkonverter aussieht oder was er für Aufgaben erledigt, spielt bei der Integration keine Rolle. Er muss einzig eine Zeichenkette übernehmen, die der Eingabe des Anwenders entspricht, und diese (transformiert) wieder retournieren. Ein funktionsloser Prototyp könnte beispielsweise so aussehen:

class Mein_TextKonverter
{

	public function process ($input)
	{
		return $input;
	}

}

Selbstverständlich ist auch eine prozedurale Variante möglich:

function mein_textkonverter ($input)
{
	return $input;
}

Wo der Textkonverter abgespeichert wird, spielt ebenfalls keine Rolle. Praktisch ist vielleicht ein separates Verzeichnis unterhalb von core/, damit man nicht unabsichtlich – beispielsweise bei einem Update – den eigenen Textkonverter überschreibt.

Mehr Konventionen gilt es dagegen bei den Plug-ins einzuhalten:

Die Plug-ins selber werden als abgeleitete Klassen des XHTML-Textkonverters TextConverter_XHTML realisiert. Dabei gilt es, die Methoden neu zu implementieren, deren Funktionalität man mit dem neuen Textkonverter nutzen möchte.

Bietet der neue Textkonverter keine passende Funktionalität für eine Methode, lässt man diese einfach weg. Dann wird automatisch die Implementierung des XHTML-Textkonverters genutzt.

Die Methode, die man wohl bei jedem Textkonverter neu implementiert, dürfte apply() sein. Sie dient dazu, einen Textkonverter auf die vom Benutzer eingegeben Text anzuwenden. Wenn man den leeren Textkonverter-Prototypen von oben benutzen möchte, könnte das Plug-in beispielsweise so aussehen:

require_once('wcom_plugin_textconverter_xhtml.php');
require_once('/pfad/zu/meinem/textkonverter.php');

class TextConverter_MeinTextKonverter extends TextConverter_XHTML
{

	public function apply ($input)
	{
		$tk = new Mein_TextKonverter();
		return $tk->process($input);
	}

}

Nun wird der Textkonverter Mein_TextKonverter zur Transformation des Texts verwendet.

Die weiteren Methoden dienen unter anderem dazu, die richtige Sytnax für Hilfsfunktionen wie das Einfügen eines Links oder eines Bildes aus dem Mediamanager bereitzustellen, damit Bilder oder eben Links vorformatiert für die Anwender in die Inhalte eingefügt werden können.

Als protected oder private deklarierte Methoden können ignoriert werden.

Während die Funktionssignaturen in den abgeleiteten Klassen beibehalten werden müssen, ist es nicht nötig, auch wirklich alle übergebenen Variablen zu benutzen. Sie können verworfen werden, wenn die Syntax des Textkonverters ihre Anwendung nicht vorsieht.

Wie ein fertiges Textkonverter-Plug-in aussieht, zeigen die mitgelieferten Plug-ins für Markdown und Textile.

Bevor man das Textkonverter-Plug-in nutzen kann, muss es noch in Welcompose registriert werden (siehe Abschnitt 8.1.4.2, „Plug-in registrieren“).

Um einen neu hinzugefügten Textkonverter im Administrationsbereich nutzen zu können, muss er vorab registriert werden. Dies geschieht im Bereich Einstellungen im Unterpunkt Textkonverter. Wenn Sie dort auf den Link Neu anlegen klicken, gelangen Sie zum Formular zum Anlegen eines neuen Textkonverters.

Sobald das Formular ausgefüllt und abgesendet wurde, kann der Textkonverter innerhalb des Administrationsbereichs genutzt werden.