driver/email

Die driver/email-Masken können benutzt werden, um nach dem Speichern eines Objektes im Editor eine Email zu verschicken. Die Email wird ausgehend von einem Objekt in der easydb ganz normal gerendert. In den Mask-Properties lassen sich Variablen festlegen, die der Administrator setzen kann. Variablen die pro Email unterschiedlich sind, wie beispielsweise eine Empfänger-Email-Adresse müssen in geeigneter Form im Objekt gespeichert sein oder zumindest mit dem Objekt verknüpft sein und über normale driver/result-Masken erreichbar sein.

Der easyshop definiert im Code Email-Masken mit fixem Namen!

Zum Versenden der Email benutzt easydb die PHP-Funktion mail.

Um easydb Assets als Attachments zu verschicken, nutzen Sie cell/EASFILE_FILEDATA.

Mask-Properties

Bei dem Email-Driver hat das GRID ein extra Pulldown, welches für ein HTML und alternativem TEXT-rendern je nach email_type verwendet wird.

table_id Die Haupt-Tabelle zum Rendern des Objektes für die Email.
admin_description Ein Freitext der dem Admin bei der Übersicht der Variablen sagt, wann diese Email verschickt wird. Je Maske wird ein Eintrag in der Variablen-Liste angelegt, die dann verschiedene Eingabe-Felder definieren kann.
admin_variables PHP-Array welches eine Liste von assoziativen Arrays enthält, die die einzelnen Variablen beschreiben. Je Variable werden folgende Keys benutzt:
  • parm Name der Variable
  • doc Beschreibung der Variable für den Administrator
  • type Typ der Variable. Es gibt input für einzeiligen Text; textarea für mehrzeiligen Text; pulldown für ein Pulldown, Optionen sind im Key pulldown in einer Doppelpunkt-separierten Liste; tags kann einen beliebigen String für die <option>-Deklaration enthalten.

Beispiel:
array(
  array("parm" => "header",
        "doc" => "email header text"),
  array("parm" => "footer",
        "type" => "email footer text",
        "tags" => "style="width:380px;"",
        "doc" => ""),
  )
Die Variablen werden innerhalb des GRID mit cell/FUNCTION-email/admin_variable ausgegeben. Für cc, subject und from werden standardmäßig Variablen eingerichtet.
email_type Auswahl des Mime-Types der Email.
  • html setzt den Mime-Type auf text/html. In dem mit default das HTML-Rendering festgelegt wird und in text das alternative TEXT-Rendering.
  • text setzt den Mime-Type auf text/plain. Das default-GRID wird zum Rendern benutzt und das text-GRID wird ignoriert.

grid/FUNCTION

set_header

Setzt einen Email-Header auf die innerhalb gerenderte Ausgabe.

header Name des Email-Headers, in Großbuchstaben. Z.B. kann mit TO ein Empfänger bestimmt werden.

add_to_attachment

Seit Version 4.0.199

Erzeugt für die aktuelle Email ein Attachment. Der Inhalt des Grids wird als Attachment verpackt.

name Name des Attachment, wie er vom Email-Programm angezeigt wird.
content-type Content-Type des Attachments. Z.B. plain/text für Text oder plain/html für HTML.

cell/FUNCTION

admin_variable

Gibt eine in Mask-Properties definierte und vom Administrator festgelegte Variable aus.

variable Auswahl für den Namen der Variablen. Hier erscheinen die immer standardmäßig vorhandenen Variablen cc, subject und from, sowie die in admin_variables in Mask-Properties definierten Variablen.

render_search_result

Seit Version 4.0.199

Rendert das aktuelle Suchergebnis mit der angegebenen Result-Mask.

result Auswahl der Result-Mask, welche zum Rendern benutzt wird. Die Result-Mask muss dieselbe Tabelle benutzen, wie die Email-Mask.