iContent Anwenderdokumentation

iContent im Detail:
 
  Beschreibung iContent
  Allgemeines zu iContent
  Standardmodule
  Content Ausgabe
  Anmeldung - geschützter Bereich
  Menü
  Mailformular, konfigurierbar
  Templates
  iFrame - Webseiten einbetten
  leeres Feld / Platzhalter / Farbfläche
  Firmen-/Userverwaltung
  Hilfesystem
  Bildergalerie
  Forum
  Ausgabe Userliste
  Kalender
  Suchfeld
  JavaScript
  Bildergalerie - Fade In
  Tag Cloud
  Module über Industriedatenpool.com
  Zusatzmodule iContent Commerce
  Verwaltungsmodule
  Klassifikationsmodule FreeClass
  iContent.document
  2013_Bereiche_uebersicht
  2013_Bereiche_uebersicht_LI
  inndata Sitemap
  Links Revit Videos
  Links Inventor Videos
 

Mailformular, konfigurierbar

Das Modul ermöglicht die Bereitstellung von Mail-Formularen und die Auswertung der übergebenen Felder.
Die Formulare können mittels Content-Artikeln frei gestaltet werden. Die eingegebenen Daten werden per Mail versandt (bei Bedarf auch an die Mailadresse des eingebenden Anwenders) und zusätzlich lokal in der Datenbank gespeichert.
 
Für einen vollständigen Formularsatz sind 3 Content-Artikel notwendig:
 
1) e-Mail-Formular:
dieses Formular enthält die auszufüllenden Felder und kann beliebig gestaltet sein.
 
2) Bestätigungsformular:
dieses Formular enthält eine Bestätigungsmeldung, sowie eventuell den Ausdruck
{%felder%}
der durch das Bestätigungsmail ersetzt dargestellt wird (Also eine Ausgabe aller vorhandenen bzw. übermittelten Felder)
 
3) HTML-Mail - Vorlage:
Wenn diese Vorlage existiert, kann das zu versendende Mail optisch gestaltet werden, wenn nicht, werden die Felder einfach untereinander geschrieben (plain text)
 
Parameter:
  • Quell-Id: Mailformular (als vorher angelegter Content-Artikel)
  • Ziel-ID: Bestätigungsseite (als vorher angelegter Content-Artikel)
  • Mail-Empfänger (als Mailadresse, also üblicherweise die Mailadresse des Web-Betreibers)
  • CC: für Bestätigung intern
  • Mailvorlage (ID) falls HTML (als vorher angelegter Content-Artikel)
  • Absenderadresse (Mailadresse)
  • Betreff (kann entfallen, dann wird der Titel des Bestätigungsformulares als Betreff des Mails verwendet)
Folgende drei Parameter können gegebenenfalls entfallen:
  • Mailserver (z.B. mail.eurobau.com)
  • User
    (z.B. info%eurobau.com ... Achtung auf die Schreibweise von Kennwörtern bei bestimmten SMTP-Servern!)
  • Passwort (...)
Syntax-Regeln für die Vorgabe-Formulare:
 
1) e-Mail-Formular:
es sind die Felder nach folgender Syntax zu bezeichnen:
size="30" name="x_feldname" maxlength="30" />

<
select multiple="multiple" size="1" name="f_listeeins">
<option value="erster Wert">einsoption>
<option value="zweiter Wert">zweioption>
select>
 
<input type="checkbox" checked="checked" value="erster Wert" name="f_auswahlfeld" />
 
Anmerkungen:
Die Felder können im grafischen Editor mit dem dritten unteren linken Button ausgewählt werden
Bei Checkbox und Radiobutton setzen Sie bitte eine Auswahlmöglichkeit auf "checked", damit das Formularfeld übergeben wird. Bitte setzen Sie keinesfalls den Formulartag ein, dies wird bereits von iContent erledigt.
 
geprüfte Feldnamen beginnen mit x_ während ungeprüfte Feldnamen mit f_ beginnen. Der Rest des Feldnamens wird als Ausgabename verwendet. Feldnamen sind klein zu schreiben.
 
Die Prüfung erfolgt auf Existenz eines eingegebenen Inhaltes, falls kein Inhalt vorhanden ist wird eine Fehlermeldung ausgegeben und das Mail nicht abgesandt.
 
e-Mail Adressen:
Mailadressen die als Feldname "x_mail" besitzen werden jedenfalls auf Verfügbarkeit und Plausibilität geprüft und ebenfalls als Empfängeradresse eingesetzt (CC - als Bestätigung für den Absender).
Lautet der Feldname aber "f_mail", so wird die Mailadresse ebenfalls als CC-Empfängeradresse verwendet, aber nicht auf Plausibilität geprüft.
 
Mailadressen mit dem Feldnamen "x_mailadresse" werden zwar auf Verfügbarkeit und Plausibilität geprüft, aber nicht als Empfängeradresse eingesetzt.
 
Die Darstellungsform der Fehlermeldung kann mit dem Feldbezeichner positioniert und von Schriftart und Farbe formatiert werden. Der Feldbezeichner muß hierzu im e-Mail Formular (nicht im Bestätigungsformular!) positioniert werden.
 
Fehlt der Feldbezeichner , so wird die Fehlerliste automatisch unten an das Formular angehängt. Textfelder stehen vorausgefüllt zur Überarbeitung zur Verfügung.
 
Prüffeld gegen SPAM-Attacken:
 
 
Bitte im Mailformular neben dem Absende-Button das Tag {%captcha%} einbauen um ein Prüffeld darzustellen ohne dessen korrekte Befüllung das Formular nicht abgesandt werden kann
 
 
2) Bestätigungsformular:
 
Das Bestätigungformular kann nach den üblichen Vorgangsweisen erstellt werden, es enthält nur einen möglichen Feldbezeichner: {%felder%}
 
Existiert dieser Feldbezeichner, so wird das übersandte Mail in derselben Form im Bestätigungsformular nochmals wiedergegeben (inklusive etwaiger Formatierungen falls eine HTML-Mail-Vorlage existiert)
 
Existiert er nicht, wird das Mail nicht wiedergegeben.
 
3) HTML-Mail - Vorlage:
 
Diese Vorlage dient zur Gestaltung des Mails in Form eines HTML-Mails. Sie ist nicht notwendig. Bei rein internen Benachrichtigungsmails empfehlen wir, diese Vorlage nicht zu verwenden, da dann das Mail als reines Textmail ohne Formatierung - und somit ressourcenschonender - übersandt wird.
 
Wenn Sie - insbesondere zum gleichzeitigen Versand an Ihren Web-Site-Besucher, das Mail optisch gestalten möchten, können Sie hierfür die HTML-Mail-Vorlage verwenden.
 
Vorsicht ist jedoch bei der Verwendung von CSS-Tags geboten (z.B. bei Verwendung der Schriftformatierungsliste die Sie mit dem Doppel AA - Button aufrufen können) sowie von Bildern geboten, da möglicherweise das Mailprogramm Ihres Kunden die CSS-Stile und/oder Bilder nicht anzeigen kann. Besser ist die Verwendung der Standard-HTML-Formatierung (Schriftart, Grösse, Tabellen und Hintergrundfarben) mit den im Editor oben verfügbaren Schaltflächen.
 
Zur Wiedergabe der Feldinhalte müssen Sie für jedes im Mailformular vorhandene Feld einen äquivalenten Feldbezeichner in Ihre HTML-Mail-Vorlage einfügen.
 
Existiert z.B. ein Textfeld

size="30" name="x_feldname" maxlength="30" />

in Ihrem Formular, so muß die HTML-Mail-Vorlage ebenfalls über einen Feldbezeichner {%x_feldname%} verfügen.

Sollten einzelne Felder vom Anwender nicht ausgefüllt werden, so verschwindet der Feldbezeichner im Antwortformular. Eine Ausnahme bilden Checkboxen. Sind diese nicht angeklickt, so bleibt der Feldbezeichner bestehen, da der Browser dieses Feld dann überhaupt nicht zurücksendet. Checkboxen sollten also ein vorangekreuztes Checkbox-Feld besitzen (siehe oben)
 
Seit dem 21.11.2012 gibt es die Möglichkeit, das aktuelle Datum und die aktuelle Zeit im Mail mit zu senden.
Datum und Zeit können Sie mit den Bezeichner {%datetime%} zum eigentlichen Mailtext / Inhalt hinzufügen.
 
4) Aufruf aus Fremdapplikationen
 
neu ist mit 20.6.2008 die Möglichkeit ein Mailformular per Querystring mit Parametern zu versorgen.
Übergibt der aufrufende Link einen Querystringparameter mit demselben Namen wie im Mailformular vorhanden, so wird im Mailformular dieser Aufruf-Wert als Vorgabewert verwendet.
 
Siehe hierzu die Einbindung in www.eurobau.com bei den Produkten.
 
Wesentlich ist:
- der Parameter muß exakt so heissen wie im Mailformular (z.B. x_produktname)
- bei der Übergabe werden @ durch \-\- ersetzt, dadurch kein Ausspähen von Mailadressen möglich
- der Parameter x_mail_hersteller ersetzt mailto, d.h. hier kann die Zieladresse dynamisch übergeben werden.
- die Einbindung der Felder muß exakt erfolgen; z.b.: