Das Textmakro Bundled Abbreviation Generator kümmert sich um das Setzen der korrespondierenden abbr HTML-Tags und Links zu Glossarseiten. Es ist integrativer Bestandteil von Welcompose und kann daher auch nicht über das Backend gelöscht oder deaktiviert werden.

Es orientiert sich an der Syntax von Smarty-Funktionen, wie sie in Vorlagen verwendet werden:

{get_abbreviation arg1=value1 arg2=value2}

Während get_abbreviation den Namen des Textmakros repräsentiert, sind arg1 respektive arg2 Platzhalter für Argumente, die an den Abkürzung-Generator zur Erzeugung der richtigen Syntax übergeben werden. Die zwei einzig gültigen Argumente sind id und value. Die ID beschreibt die eindeutige Kennung der Abkürzung, mit dem Argument value wird bestimmt, welcher zur Verfügung stehende Feldinhalt der Abkürzung ausgelesen werden soll.

Zur Verfügung stehen: name, lang und long_form. Eine gültige Anweisung kann beispielsweise so aussehen:

{get_abbreviation id="3" value="name"}

oder auch:

{get_abbreviation id="3" value="long_form"}

Anstelle von {get_abbreviation ...} setzt das Textmakro die korrespondierenden Inhalt für die Abkürzung, beispielsweise:

<abbr title="MeineLangform">Meine Abkürzung</abbr>

oder auch:

<abbr title="MeineLangform" lang="de" xml:lang="de">
  <a href="#MeineAbkürzung" title="MeineLangform">Meine Abkürzung</a>
</abbr>

Das Textmakro Bundled Embed Video Generator ermöglicht es mit wenigen Zeilen ein Video eines Video Sharing Service in eine Seite einzubinden. Die Art der Einbindung richtet sich nach den bereitgestellten Möglichkeiten der Anbieter.

Es orientiert sich an der Syntax von Smarty-Funktionen, wie sie in Vorlagen verwendet werden:

{embed_video arg1=value1 arg2=value2 arg3=value3 arg4=value4}

Das Textmarkro hat folgende Argument, deren Angabe zwingend erforderlich ist: service, vid, width und height. Der Parameter service ist gleich dem Namen des Anbieters.

Es sind aktuell folgende Anbieter implementiert:

Der Parameter vid ist die Identifikationsnummer des eingebundenen Films, der vom jeweiligen Anbieter vergeben wird. Die Parameter width und height bestimmen die Anzeigefläche in ihrer Seite.

Somit würde ein gültige Eingabe wie beispielsweise wie folgt ausschauen:

{embed_video service="youtube" vid="4wr3AD8mZy0" width="500" height="408"}

Das Textmakro Bundled Media URL Generator kümmert sich um das Setzen von Pfaden respektive URLs zu Media-Elementen wie Bildern. Es wird vom in Welcompose integrierten Media Manager verwendet und kann daher auch nicht über das Backend gelöscht oder deaktiviert werden.

Es orientiert sich an der Syntax von Smarty-Funktionen, wie sie in Vorlagen verwendet werden:

{get_media arg1=value1}

Es kennt nur ein einzelnes Argument: id. Diesem wird jeweils die ID des Bildes oder Films übergeben, das respektive der eingebunden werden soll:

{get_media id="3"}

Anstelle von {get_media ...} setzt das Textmakro den Pfad respektive URL zum Media-Element, beispielsweise:

/files/global_files/grafik.jpg

Allerdings ist es in der Regel nicht nötig, selber die Tags für die Integration der Bilder zu schreiben, da dies in Welcompose integrierte Funktionen für den Anwender tun.

Das Textmakro Bundled URL Generator dient zur einfachen Erzeugung von Links zwischen den einzelnen Welcompose-Seiten und wird beispielsweise von den Hilfsfunktionen zum Einfügen interner Hinweise verwendet. Es kann daher auch nicht über das Backend gelöscht oder deaktiviert werden.

Es bietet ein Interface zum URL-Generator, der auch schon innerhalb der Vorlagen zum Einsatz kommt und folgt daher dessen Syntax:

{get_url arg1=value1 arg2=value2}

Während get_url quasi der Name des Textmakros ist, sind arg1 respektive arg2 Platzhalter für Argumente, die an den URL-Generator zur Erzeugung der richtigen URLs übergeben werden. Eine gültige Anweisung kann beispielsweise so aussehen:

{get_url page_id="15" action=ArchiveMonth posting_year_added="2007" posting_month_added="6"}

Anstelle von {get_url ...} wird vom Textmakro der URL zu dem Archiv für den Monat Juni 2007 der Blog-Seite mit der ID 15 gesetzt, beispielsweise:

http://www.example.com/mein-blog/archiv/2007/06/

In der Regel ist es nicht nötig, selber die Tags für den Bundled Media URL Generator zu schreiben, da dies in Welcompose integrierte Funktionen für den Anwender tun.

Textmakros werden in Form von einfachen PHP-Funktionen realisiert, in deren Rahmen man prinzipiell machen kann, was man will. Als Beispiel soll die bereits erwähnte automatische Umwandlung von Links zur Wikipedia realisiert werden.

Die Textmakros werden im Verzeichnis core/plugins/textmacros/ hinterlegt, wobei pro Textmakro eine separate Datei benötigt wird. Die Benennung der Dateien muss einem bestimmten Schema erfolgen, damit die Textmakros von Welcompose gefunden werden. Und zwar müssen die Dateinamen mit wcom_plugin_textmacro_ beginnen, gefolgt vom eigentlichen Textmakro-Namen und der Dateiendung .php. Der Textmakro-Name darf nur kleine Buchstaben, Ziffern und Unterstriche beinhalten. Der Dateiname des Wikipedia-Macros könnte beispielsweise so aussehen: wcom_plugin_textmacro_wikipedia.php.

Der Dateiname dient gleichzeitig (abzüglich des Suffix .php) als Funktionsname, der für den Aufruf des Textmakros verwendet wird.

Die Textmakros erhalten als einziges Argument die Zeichenkette mit den Benutzereingaben, die sie nach der Ausführung retournieren müssen. Der funktionslose Prototyp einer Textmakro-Funktion sieht damit folgendermassen aus:

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

Welche Aktionen innerhalb des Textmakros ausgeführt werden, bleibt einem selbst überlassen. Meistens wird man wohl mit Hilfe von Regulären Ausdrücken die Eingaben manipulieren. In jedem Fall gilt es, darauf zu achten, dass die Textmakros nicht mit den Textkonvertern in Konflikt geraten, insbesondere wenn sie nach den Textkonvertern ausgeführt werden (mehr dazu in Abschnitt 8.3.4.2, „Textmakros registrieren“).

In dem Wikipedia-Beispiel-Textmakro wird eine ebensolche Text-Transformation mit Hilfe eines Regulären Ausdrucks realisiert. Und zwar sucht die Textmakro-Funtkion wcom_plugin_textmacro_wikipedia() nach allen nach dem Muster w:de{Begriff} (für die deutsche Wikipedia) respektive w:en{Begriff} (für die englische Wikipedia) ausgezeichneten Begriffen. Diese werden dann mit Hilfe der Callback-Funktion wcom_plugin_textmacro_wikipedia_callback() in die Links verwandelt und durch diese ersetzt.

function wcom_plugin_textmacro_wikipedia ($input)
{
	// input check
	if (!is_scalar($input)) {
		trigger_error("Input for parameter input is expected to be scalar", E_USER_ERROR);
	}

	// parse wikipedia tags and replace them with links to the online encyclopedia.
	return preg_replace_callback("=w:(en|de)\{(.*?)\}=",
		'wcom_plugin_textmacro_wikipedia_callback', $input);
}

function wcom_plugin_textmacro_wikipedia_callback ($args)
{
	// input check
	if (!is_array($args)) {
		trigger_error("Input for parameter args is expected to be an array", E_USER_ERROR);
	}

	// encode the article title into wikipedia's special format used in urls
	$article_url_title = urlencode(str_replace(' ', '_', $args[2]));

	// create wikipedia link
	// argument 1 holds the name of the localized wikipedia to use (either en or de)
	// argument 2 is the urlencoded version of the article title
	// argument 3 is the article title as supplied by the user
	return sprintf('<a href="http://%1$s.wikipedia.org/wiki/%2$s">%3$s</a>', $args[1],
		$article_url_title, $args[2]);
}

Sobald das Textmakro unter dem Namen wcom_plugin_textmacro_wikipedia.php im Verzeichnis core/plugins/textmacros/ abgelegt wurde, ist es einsatzbereit und muss nur noch in Welcompose aktiviert werden.

Um ein neu hinzugefügtes Textmakro nutzen zu können, muss es vorab registriert werden. Dies geschieht im Administrationsbereich unter Settings beim Unterpunkt Text Macros. Wenn Sie dort auf den Link Add new klicken, gelangen Sie zum Formular zum Anlegen eines neuen Textmakros.

Sobald das Formular ausgefüllt und abgesendet wurde, ist das Textmakro aktiv und wird angewendet.