Parametersystem

Was ist das ?

Das Parameter-System ermöglicht es, Texte dynamisch zu generieren. Dies wird z.B. im Email-Plugin benutzt um den Text der EMail zu erzeugen. Im CapturePlugin wird es benutzt, um Parameter an andere Programme zu übergeben.

Aufbau

Der Aufbau ist relativ einfach. Alle Texte, die mit { und } umschlossen sind, werden vom System durch Werte und Funktions-Ergebnisse ersetzt.

Zum Beispiel ergibt folgender Text:

Der Titel ist {title} 

bei der Sendung "Hallo, Spencer!"

Der Titel ist Hallo, Spencer!

Sie können auch Funktionen benutzen um Texte zu verbinden, zu splitten usw.

Ein Beispiel:

Der Titel ist {isset(original_title, title)}

Hier wird nun entweder der Original-Titel benutzt, oder, wenn dieser nicht vorhanden ist, der Titel der Sendung.

Sie können Funktionen auch schachteln:

Der Titel ist {clean(isset(original_title, title))}

Nun werden zusätzlich noch alle Sonderzeichen durch "_" ersetzt.

Sie können auch eigene Parameter-Texte angeben:

Der Original-Titel ist {isset(original_title, "leider nicht vorhanden")}

Wenn nun der Original Titel nicht gefüllt ist, wird nun der Text "leider nicht vorhanden" ausgeben:

Der Original-Titel ist leider nicht vorhanden

Eine komplette Liste von Funktionen und Parametern ist in jedem Plugin hinterlegt. Warum? Weil jedes Plugin weitere Parameter/Funktionen hinzufügen kann.

Sonderzeichen

Falls sie geschweifte Klammern oder einen Backslash ("{", "}", "\") eingeben wollen, müssen sie vor diese einen zusätzlichen Backslash "\" setzen.

Das bedeutet im Klartext:

Eingabe	Ergebnis
\\	\
\\\\	\\
\{	{
\}	}