Es stehen einige interne Funktionen zur Verfügung, um z.B. Zeichenketten korrekt für Hyperlinks zu codieren. Zur Erstellung von WENN...DANN..-Abfragen verwenden Sie die Funktionen.
Standard-Funktionen und Standard-Werte, für die keine Funktionen verwendet werden müssen
| [Year], [Month], [Day], [WeekNumber], [Hour], [Minute], [Second], [LastEMailSent], [DayName], [MonthName] | Ausgabe von Jahr, Monat, Tag, Kalenderwoche, Stunde, Minute, Sekunde, Datum letzter E-Mail-Versand, Wochentag und Monatsname in deutscher Sprache. |
| [Date_short] | Datum im kurzen Datumsformat Tag.Monat.Jahr. |
|
[Date_long] |
Datum im langen Datumsformat Tag.Monat.Jahr Stunde:Minute:Sekunde. |
|
[Time] |
Uhrzeit im Format Stunde:Minute:Sekunde |
|
[RecipientId] |
ID des Empfängers in der Empfängerliste |
|
[MailingListId] |
ID der Empfängerliste |
|
[SubscriptionStatus] |
Anmeldestatus des Empfängers |
| [IPOnSubscription] | IP-Adresse bei Anmeldung |
| [DateOfSubscription] | Datum/Uhrzeit bei Anmeldung |
| [DateOfOptInConfirmation] | Datum/Uhrzeit bei Klick auf Bestätigungslink |
|
[EMail_LocalPart] |
Lokaler Teil der E-Mail-Adresse |
|
[EMail_DomainPart] |
Domain Teil der E-Mail-Adresse |
Hinweise
Syntax
sf_<funktionsname>( <argument> )
Alle Angaben in < > sind Pflichtangaben.
Beispiel: sf_base64_encode(EIN TEXT) Ergebnis: RUlOIFRFWFQ=
Schachteln von Funktionen
Das Schachteln von Funktionen ist problemlos möglich, aus Performance-Gründen sollte dies jedoch sparsam eingesetzt werden, es muss auf das korrekte Schließen der runden Klammern geachtet werden.
sf_<funktionsname>( sf_<funktionsname>(<argument>) )
Alle Angaben in < > sind Pflichtangaben.
Beispiel: sf_base64_decode( sf_base64_encode(EIN TEXT) ) Ergebnis EIN TEXT
Liste der Funktionen
Alle im Dialog zur Konfiguration mit Sternchen gekennzeichneten Felder müssen ausgefüllt werden.
<string> => Pflichtangabe einer Zeichenkette
<integer> => Pflichtangabe Ganzzahl
<float> => Pflichtangabe Gleitkommazahl
<length> => Pflichtangabe Länge einer Zeichenkette
| sf_base64_encode(<string>) | Codiert die Zeichenkette in base64.
Beispiel: sf_base64_encode(text)
|
| sf_base64_decode(<string>) | Dekodiert eine base64-codierte Zeichenkette.
Beispiel: sf_base64_decode(RUlOIFRFWFQ=)
|
| sf_url_encode(<string>) | Codiert die Zeichenkette in url-codiert, um den Wert in
Hyperlinks als Parameter verwenden zu können.
Beispiel: sf_url_encode(ein Text mit Leerzeichen)
|
| sf_url_decode(<string>) | Dekodiert die url-codierte Zeichenkette.
Beispiel: sf_url_decode(ein+Text+mit+Leerzeichen)
|
| sf_htmlentities(<string>) | Wandelt Zeichen in HTML-Codes um.
Beispiel: sf_htmlentities(<ein text>)
|
| sf_unhtmlentities(<string>) | Wandelt alle HTML-Entities in Zeichen um.
Beispiel: sf_unhtmlentities(<ein text>)
|
| sf_sha1(<string>) | Berechnet den sha1-Hash.
Beispiel: sf_sha1(abc)
|
| sf_md5(<string>) | Berechnet den md5-Hash.
Beispiel: sf_md5(abc)
|
| sf_sha2_256(<string>), sf_sha2_384(<string>), sf_sha2_512(<string>) | Berechnet den sha2-Hash.
Beispiel: sf_sha2_256(abc)
|
| sf_domain_part(<email-adresse>) | Gibt den Domainteil einer E-Mail-Adresse zurück. Enthält
die Zeichenkette kein @-Zeichen, wird eine leere Zeichenkette
zurückgegeben.
Beispiel: sf_domain_part(max@mustermann.de)
|
| sf_local_part(<email-adresse>) | Gibt den lokalen Teil einer E-Mail-Adresse zurück.
Enthält die Zeichenkette kein @-Zeichen, wird eine leere Zeichenkette
zurückgegeben.
Beispiel: sf_local_part(max@mustermann.de)
|
| sf_lowercase(<string>) | Wandelt die Zeichenkette in Kleinbuchstaben um.
|
| sf_uppercase(<string>) | Wandelt die Zeichenkette in Großbuchstaben um.
|
| sf_lcfirst(<string>) | Wandelt das erste Zeichen der Zeichenkette in einen
Kleinbuchstaben um.
|
| sf_ucfirst(<string>) | Wandelt das erste Zeichen der Zeichenkette in einen
Großbuchstaben um.
|
| sf_trim(<string>) | Entfernt führende/nachfolgende Leerzeichen.
|
| sf_ltrim(<string>) | Entfernt führende Leerzeichen.
|
| sf_rtrim(<string>) | Entfernt nachfolgende Leerzeichen.
|
| sf_nl2br(<string>) | Wandelt alle Zeilenumbrüche in <br> um.
|
| sf_hex(<integer>) | Wandelt die angegebene Zeichenkette in Dezimalzahl und
danach in eine Hexadezimal-Zahl.
Beispiel: sf_hex(12345)
|
| sf_rand(<max_integer>) | Erstellt eine Zufallszahl im angegebenen Bereich.
Beispiel: sf_rand(10)
|
| sf_add(<integer>,<integer>[,<integer>...]) | Addiert die mit Komma getrennten Zahlen.
Beispiel: sf_add(1, 2, 3)
|
| sf_sub(<integer>,<integer>[,<integer>...]) | Subtrahiert die mit Komma getrennten Zahlen.
Beispiel: sf_sub(3, 2, 1)
|
| sf_mul(<integer>,<integer>[,<integer>...]) | Multipliziert die mit Komma getrennten Zahlen.
Beispiel: sf_mul(3, 2, 1)
|
| sf_div(<integer>,<integer>[,<integer>...]) | Dividiert die mit Komma getrennten Zahlen.
Beispiel: sf_div(3, 2)
|
| sf_muldiv(<zahl>, <zaehler>, <nenner>) | Multipliziert <zahl> mit <zaehler> und
dividiert durch <nenner>
Beispiel: sf_muldiv(3, 2, 3) => 2
|
| sf_divmul(<zahl>, <nenner>, <zahl1>) | Dividert <zahl> durch <nenner> und
multipliziert mit <zahl1>
Beispiel: sf_divmul(3, 2, 1) => 1.5
|
| sf_abs(<integer>) | Gibt den Absolutwert/Betrag einer Zahl zurück.
Beispiel: sf_abs(-123) oder z.B. sf_abs(sf_sub(3, 10))
|
| sf_toint(<float>) | Wandelt eine Gleitkommazahl in eine Ganzzahl, dabei werden
die Stellen nach dem Punkt abgeschnitten. Alternativ wird eine Zahl in
Hexadezimalschreibweise in eine Ganzzahl umgewandelt. Die
Hexadezimalzahl muss mit 0x beginnen, ansonsten wird diese als
Zeichenkette angesehen.
Beispiel: sf_toint(123.456) oder sf_toint(0xFFAAFF)
|
| sf_tofloat(<zahl>) | Wandelt eine Zahl in eine Gleitkommazahl. Diese Funktion
muss mit PHP normalerweise nicht verwendet werden, da PHP selbst in den
pasenden Zahlentyp umwandelt. In der Newsletter
Software SuperMailer muss diese Funktion verwendet werden, um den
korrekten Zahlentyp für die Funktion sf_format() zu übergeben.
|
| sf_rand_string_mixed(<length>) |
Erstellt eine Zufallszeichenkette bestehend aus
Groß-/Kleinbuchstaben und Zahlen.
Mit <laenge> kann die Länge der Zufallszeichenkette angegeben werden, Standard ist 8 Zeichen.
|
| sf_rand_string_uppercase(<length>) | Erstellt eine Zufallszeichenkette bestehend aus
Großbuchstaben und Zahlen.
Mit <laenge> kann die Länge der Zufallszeichenkette angegeben werden, Standard ist 8 Zeichen.
|
| sf_rand_string_lowercase(<length>) | Erstellt eine Zufallszeichenkette bestehend aus
Kleinbuchstaben und Zahlen.
Mit <laenge> kann die Länge der Zufallszeichenkette angegeben werden, Standard ist 8 Zeichen.
|
| sf_substring(<string>, <start>[,length]) | Ermittelt eine Teilzeichenkette. <start> muss ein
Wert >= 1 sein (ersten Zeichen wird mit 1, nicht mit 0 angesehen!),
length optional die Anzahl Zeichen die aus <string> extrahiert
werden sollen.
Beispiel: sf_substring(ABC, 1) => A; sf_substring(ABC, 2, 2) => BC
|
| sf_pos(<string>, <findstring>, [wert]) | Ermittelt die Position von <findstring> in
<string>, kommt die Zeichenkette nicht vor wird 0
zurückgeliefert. Wie bei sf_substring() beginnt die Zählung der
Zeichen ab Zeichen 1, nicht 0. Optional kann [wert] angegeben werden,
dieser wird von der gefundenen Position abgezogen.
Beispiel: E-Mail-Adresse: max@mustermann.de sf_substring(mustermann.de, 1, sf_pos(mustermann.de, . , 1)) Resultat: mustermann
|
| sf_today([format]) | Gibt das aktuelle Datum aus.
Ist die Spracheinstellung der SuperWebMailer-Oberfläche auf deutsch
eingestellt, erfolgt die Ausgabe des Datums immer in der Form
tag.monat.jahr, ansonsten Jahr-Monat-Tag. Ohne Angabe einer Formatierung
entspricht sf_today() dem Standard-Platzhalter [Date_short]. Für [format] kann eine Formatierung des Datums angegeben werden, die
Formatierungszeichen finden Sie in der PHP-Hilfe https://www.php.net/manual/de/datetime.format.php.
Die Formatierungszeichen sind nicht kompatibel zur Newsletter
Software SuperMailer, die ebenfalls diese Funktion anbietet.
|
| sf_tomorrow([format]) | Gibt das morgige Datum aus.
Ist die Spracheinstellung der SuperWebMailer-Oberfläche auf deutsch
eingestellt, erfolgt die Ausgabe des Datums immer in der Form
tag.monat.jahr, ansonsten Jahr-Monat-Tag. Für [format] kann eine Formatierung des Datums angegeben werden, die Formatierungszeichen finden Sie in der PHP-Hilfe https://www.php.net/manual/de/datetime.format.php. Die Formatierungszeichen sind nicht kompatibel zur Newsletter Software SuperMailer, die ebenfalls diese Funktion anbietet.
|
| sf_yesterday([format]) | Gibt das gestrige Datum aus.
Ist die Spracheinstellung der SuperWebMailer-Oberfläche auf deutsch
eingestellt, erfolgt die Ausgabe des Datums immer in der Form
tag.monat.jahr, ansonsten Jahr-Monat-Tag. Für [format] kann eine Formatierung des Datums angegeben werden, die Formatierungszeichen finden Sie in der PHP-Hilfe https://www.php.net/manual/de/datetime.format.php. Die Formatierungszeichen sind nicht kompatibel zur Newsletter Software SuperMailer, die ebenfalls diese Funktion anbietet.
|
| sf_incdays(<date>, <days>[, destformat][, srcformat]) | Addiert auf das angegebene Datum die Anzahl Tage und gibt
das neue Datum aus. Sind die Anzahl Tage negativ, dann werden die Tage
subtrahiert. Das Datum und Anzahl Tage sind Pflichtangaben, destformat
und srcformat optional. Die Angabe von quellformat muss erfolgen, wenn
das Datum von der internen SuperWebMailer-Einstellung (tag.monat.jahr
für deutsche Nutzer bzw. jahr-monat-tag für englischsprachige Nutzer)
abweicht. Für [destformat] und [zielformat] kann eine Formatierung des Datums angegeben werden, die Formatierungszeichen finden Sie in der PHP-Hilfe https://www.php.net/manual/de/datetime.format.php. Die Formatierungszeichen sind nicht kompatibel zur Newsletter Software SuperMailer, die ebenfalls diese Funktion anbietet.
|
| sf_incweeks(<date>, <weeks>[, destformat][, srcformat]) | Addiert auf das angegebene Datum die Anzahl Wochen und
gibt das neue Datum aus. Sind die Anzahl Wochen negativ, dann werden die
Wochen subtrahiert. Das Datum und Anzahl Wochen sind Pflichtangaben,
destformat und srcformat optional. Die Angabe von quellformat muss
erfolgen, wenn das Datum von der internen SuperWebMailer-Einstellung
(tag.monat.jahr für deutsche Nutzer bzw. jahr-monat-tag für
englischsprachige Nutzer) abweicht. Für [destformat] und [zielformat] kann eine Formatierung des Datums angegeben werden, die Formatierungszeichen finden Sie in der PHP-Hilfe https://www.php.net/manual/de/datetime.format.php. Die Formatierungszeichen sind nicht kompatibel zur Newsletter Software SuperMailer, die ebenfalls diese Funktion anbietet.
|
| sf_incyears(<date>, <years>[, destformat][, srcformat]) | Addiert auf das angegebene Datum die Anzahl Jahre und gibt
das neue Datum aus. Sind die Anzahl Jahre negativ, dann werden die Jahre
subtrahiert. Das Datum und Anzahl Jahre sind Pflichtangaben, destformat
und srcformat optional. Die Angabe von quellformat muss erfolgen, wenn
das Datum von der internen SuperWebMailer-Einstellung (tag.monat.jahr
für deutsche Nutzer bzw. jahr-monat-tag für englischsprachige Nutzer)
abweicht. Für [destformat] und [zielformat] kann eine Formatierung des Datums angegeben werden, die Formatierungszeichen finden Sie in der PHP-Hilfe https://www.php.net/manual/de/datetime.format.php. Die Formatierungszeichen sind nicht kompatibel zur Newsletter Software SuperMailer, die ebenfalls diese Funktion anbietet.
|
| sf_format(<format>, [argument1], [argument2]...) | Formatiert eine Zahl oder Zeichenkette mit Hilfe eines
Format-Strings. Mögliche Bezeichner finden Sie in der PHP Hilfe: https://www.php.net/manual/de/function.sprintf.php
Die Formatierungszeichen sind nicht vollständig kompatibel zur Newsletter Software SuperMailer, die ebenfalls diese Funktion anbietet. Beispiele sf_format(%2.2f EUR, 1.20) => 1.20 EUR
|
| sf_rand_image(src="bild-url", src="bild-url1") | Wählt zufällig eine Bild-URL aus den angegebenen
Bild-URLs.
Die Angabe "bild-url" kann eine Angabe mit http(s) oder ein lokales Bild im userfiles/id-des-nutzers/-Verzeichnis sein. Bei Angabe der URLs direkt im WYSIYWG-Editor dürfen die Angaben nicht verlinkt werden, entfernen Sie die automatische Verlinkung nach Eingabe der URL. Beispiel: sf_rand_image(src="https://www.superwebmailer.de/images/screen/php-newsletter-software-superwebmailer_k.png", src="https://www.superwebmailer.de/images/screen/php-newsletter-software-fuer-html-newsletter-im-wysiwyg-editor-erstellen_k.png", src="https://www.supermailinglist.de/images/sml_screen.png")
|