Parametersystem
Aus TV-Browser Wiki
[bearbeiten] 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.
[bearbeiten] 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.
[bearbeiten] 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 |
|---|---|
| \\ | \ |
| \\\\ | \\ |
| \{ | { |
| \} | } |

