Parametersystem
Was ist das ?
Das Parameter-System ermöglicht es, Texte dynamisch zu generieren. Dies wird z.b. in dem 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 duch Werte und Funkions-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 wird 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 ein {, ein } oder ein \ eingeben wollen, müssen sie diese "escapen". Das bedeutet im Klartext:
Wert | Ergebniss |
---|---|
\\ | \ |
\\\\ | \\ |
\{ | { |
\} | } |