PDF-Anhang Optionen
Hinweis: Diese Feature sind Teil der Visforms Subscription und in der freien Visforms Version nicht enthalten.
FĂŒr ein besseres VerstĂ€ndnis empfehlen wir die Dokumentation vollstĂ€ndig durchzulesen und mit dem
Abschnitt Einleitung
zu beginnen.
ZusammenhĂ€nge, die in frĂŒheren Abschnitten der Dokumentation erklĂ€rt wurden, werden hier nicht wiederholt.
Sie haben folgende PDF-Anhangs-Optionen:
- PDF der Ergebnismail erzeugen und an die Ergebnismail anhÀngen.
- PDF der Benutzermail erzeugen und an die Ergebnismail anhÀngen.
- PDF der Benutzermail erzeugen und an die Benutzermail anhÀngen.
- Individuelles PDF der ĂŒbermittelten Daten erzeugen und an die Ergebnismail anhĂ€ngen.
- Individuelles PDF der ĂŒbermittelten Daten erzeugen und an die Benutzermail anhĂ€ngen.
Hinweis: Es werden nur E-Mails erzeugt und verschickt, wenn in der Formularkonfiguration im Reiter "E-Mail Optionen" die Option "Mail schicken" fĂŒr den entsprechenden E-Mail-Typ aktiviert ist. Die entsprechenden E-Mail-Typen sind Ergebnismail und Benutzermail.
Optionen fĂŒr die Ergebnismail
Der Ergebnismail, die in der Regel an den Webseitenbetreiber verschickt wird, können Sie folgendes anhÀngen:
- das PDF der Benutzermail,
- das PDF der Ergebnismail und
- ein individuelles PDF-Dokument.
Setzen Sie hierfĂŒr einfach die entsprechende Option auf âjaâ. Oder, fĂŒr ein individuelles PDF-Dokument, wĂ€hlen Sie das entsprechende PDF-Template. Das PDF-Template mĂŒssen Sie zuvor angelegt haben. Mehr dazu in: PDF-Dokumente erstellen.
Optionen fĂŒr die Benutzermail
Der Benutzermail können Sie folgendes anhÀngen:
- das PDF der Benutzermail und
- ein individuelles PDF-Dokument.
Setzen Sie hierfĂŒr einfach die entsprechende Option auf âjaâ. Oder, fĂŒr ein individuelles PDF-Dokument, wĂ€hlen Sie das entsprechende PDF-Template. Das PDF-Template mĂŒssen Sie zuvor angelegt haben. Mehr dazu in: PDF-Dokumente erstellen.
Alle PDF-Dateien werden temporÀr erzeugt. Nach erfolgreichem Versand der Mails werden die temporÀren PDF-Dateien automatisch wieder gelöscht.
Möglichkeiten und Grenzen des PDF-Exports
Visforms erzeugt HTML-Mails, d.h. der Inhalt der Ergebnismail und der Mail an den Benutzer werden von Visforms als HTML erzeugt. Um aus dem Mail-Inhalt ein PDF zu generieren, muss dieses HTML in PDF umgewandelt werden. Das ist notwendig, denn PDF und HTML sind komplett unterschiedliche Formate. Hierzu verwendet Visforms, die weit verbreitete Open Source PHP Library âTCPDFâ. Viele andere Komponenten, die eine PDF Erstellung anbieten, verwenden ebenfalls diese PHP Library âTCPDFâ.
Diese Library enthĂ€lt einen einfachen Parser, der HTML in PDF Format ĂŒbersetzt. In einem modernen Browser oder E-Mail-Client werden das HTML und die CSS Spezifikationen weitgehend vollumfĂ€nglich unterstĂŒtzt.
Im Gegensatz dazu wird bei âTCPDFâ ein begrenztes Subset an HTML-Tags und eine sehr begrenzte Auswahl der CSS-Spezifikation unterstĂŒtzt. Insbesondere werden von diesem Parser folgende CSS-Eigenschaften nicht unterstĂŒtzt, wie
- margin,
- padding oder
- float.
Sie sollten daher bei der Erstellung der Mail, wenn diese auch als PDF-Anhang dienen soll, von solchen âfortgeschrittenenâ Formatierungen Abstand nehmen. Weil diese durchaus gebrĂ€uchlichen HTML-Formatierungen spĂ€ter im PDF leider nicht zu dem gewĂŒnschten Ergebnis fĂŒhren.
Im Hinblick auf den Text-Inhalt sollten Mails und PDFs dagegen völlig identisch sein.
Dateiname der PDF-Datei anpassen
Visforms verwendet einen Standardnamen, unter dem die PDFs an die Mails angehĂ€ngt werden. Dieser Dateiname wird mit Hilfe eines SprachschlĂŒssels erzeugt. Mithilfe des Joomla Feature âSprachen Overrideâ kann der Dateiname daher auch angepasst werden. Der geĂ€nderte Name wird dann fĂŒr alle MailanhĂ€nge verwendet.
Name des Ergebnismail-PDFs
Der Dateiname des Ergebnismail-PDFs wird festgelegt durch die folgende Ăbersetzungsregel:
PLG_VISFORMS_VFMAILATTACHMENTS_RESULT=â%s-ergebnismail".
Hierbei ist %s ein Platzhalter, der durch den Formularnamen ersetzt wird. Wenn Sie den Dateinamen des Ergebnismails-PDFs anpassen wollen, mĂŒssen Sie fĂŒr den SprachschlĂŒssel PLG_VISFORMS_VFMAILATTACHMENTS_RESULT eine andere Ăbersetzung hinterlegen.
Name des Benutzermail-PDFs
Der Dateiname des Benutzermail-PDFs wird festgelegt durch die folgende Ăbersetzungsregel:
PLG_VISFORMS_VFMAILATTACHMENTS_RECEIPT=â%s-benutzermail".
Hierbei ist %s ein Platzhalter, der durch den Formularnamen ersetzt wird. Wenn Sie den Dateinamen des Ergebnismails-PDFs anpassen wollen, mĂŒssen Sie fĂŒr den SprachschlĂŒssel PLG_VISFORMS_VFMAILATTACHMENTS_RECEIPT eine andere Ăbersetzung hinterlegen.
Override anlegen
FĂŒhren Sie das Folgende aus:
- Gehen Sie in der Administration Ihrer Webseite auf Erweiterungen » Sprachen » Overrides
- WĂ€hlen Sie unter âFilterâ auf der linken Seite Ihre Sprache und Site (nicht Administrator) aus.
WĂ€hlen Sie nicht âAdministratorâ aus, siehe roter Pfeil. - Klicken Sie auf den âNeu-Buttonâ.
FĂŒhren Sie das Folgende aus:
- Geben Sie bei âSprachschlĂŒsselâ PLG_VISFORMS_VFMAILATTACHMENTS_RESULT oder PLG_VISFORMS_VFMAILATTACHMENTS_RECEIPT ein, je nachdem welchen Dateinamen Sie Ă€ndern wollen.
- Geben Sie bei âTextâ den gewĂŒnschten Dateinamen ein.
Wenn Sie den Formularnamen im Dateinamen beibehalten wollen, dann können Sie hierzu den Platzhalter %s verwenden.
Wenn Sie einen festen Namen hinterlegen wollen, dann schreiben Sie einfach diesen Namen in das Feld âTextâ. - Klicken Sie auf âSpeichern & SchlieĂenâ.
- Wiederholen Sie den Vorgang gegebenenfalls fĂŒr den Namen des anderen Mail-Types.
Beispiele
| Formularname | Text | Dateiname |
|---|---|---|
| form1 | %s-benutzermail | form1-benutzermail.pdf |
| form1 | meinname | meinname.pdf |
| form2 | anderer-name%s | anderer-nameform2.pdf |