ANLEITUNG: E-Mail Anhänge in Bestellmails (AGB, WRB, etc.)

[Tomcraft]

Hier mal eine leicht erweiterte Anleitung von Hetfield, zugeschnitten auf modified eCommerce Shopsoftware.

Hallo!

Um die AGB und die Widerrufsbelehrung als E-Mail-Anhang mitsenden zu können, muss die Datei /send_order.php im Hauptverzeichnis geändert werden.

Nach Zeile 18 gehört folgende Ergänzung:

PHP-Code:

Code: PHP  [Auswählen]

$path_to_attachement = DIR_FS_DOCUMENT_ROOT . 'AGB.pdf';
$path_to_more_attachements = DIR_FS_DOCUMENT_ROOT . 'widerrufsbelehrung.pdf';

Danach diesen Code (ca. Zeile 88) suchen:

PHP-Code:

Code: PHP  [Auswählen]

// send mail to customer
xtc_php_mail(EMAIL_BILLING_ADDRESS, EMAIL_BILLING_NAME, $order->customer['email_address'], $order->customer['firstname'].' '.$order->customer['lastname'], '', EMAIL_BILLING_REPLY_ADDRESS, EMAIL_BILLING_REPLY_ADDRESS_NAME, '', '', $order_subject, $html_mail, $txt_mail);

und gegen diesen Code ersetzen:

PHP-Code:

Code: PHP  [Auswählen]

// send mail to customer
xtc_php_mail(EMAIL_BILLING_ADDRESS, EMAIL_BILLING_NAME, $order->customer['email_address'], $order->customer['firstname'].' '.$order->customer['lastname'], '', EMAIL_BILLING_REPLY_ADDRESS, EMAIL_BILLING_REPLY_ADDRESS_NAME, $path_to_attachement, $path_to_more_attachements, $order_subject, $html_mail, $txt_mail);

/inc/xtc_php_mail.inc.php

Etwa in Zeile 100 suchen:

PHP-Code:

Code: PHP  [Auswählen]

//$mail->AddAttachment($path_to_attachement);
//$mail->AddAttachment($path_to_more_attachements);

und ersetzen gegen:

PHP-Code:

Code: PHP  [Auswählen]

$mail->AddAttachment($path_to_attachement);
$mail->AddAttachment($path_to_more_attachements);

Bei der Bestellung erhält jetzt der Kunde die Dateien AGB.pdf und widerrufsbelehrung.pdf (welche in diesem Beispiel im Hauptverzeichnis liegen) als E-Mail-Anhang in der Bestellbestätigung.

Keine Gewährleistung, vorher Backup der Datei send_order.php anlegen!

MfG Hetfield

Mehrsprachigkeit für Shopversionen 1.00 - 1.05 SP1d:

Um die Anhänge sprachabhängig zu machen was in mehrsprachigen Shops Sinn macht

Folgendes suchen:

Code: PHP  [Auswählen]

// Array-Anhänge
    $path_to_attachement = array();
    $path_to_attachement[] = DIR_FS_DOCUMENT_ROOT . 'media/content/AGB.pdf';
    $path_to_attachement[] = DIR_FS_DOCUMENT_ROOT . 'media/content/widerrufsbelehrung.pdf';

ändern in:

Code: PHP  [Auswählen]

// Array-Anhänge
    $path_to_attachement = array();
    $path_to_attachement[] = DIR_FS_DOCUMENT_ROOT . 'media/content/'.$_SESSION['language'].'/AGB.pdf';
    $path_to_attachement[] = DIR_FS_DOCUMENT_ROOT . 'media/content/'.$_SESSION['language'].'/widerrufsbelehrung.pdf';

(nicht vergessen die Ordner anzulegen und die Dateien hinein zu kopieren.)

auch die Zeile:

Code: PHP  [Auswählen]

$path_to_more_attachements[] = DIR_FS_DOCUMENT_ROOT . 'fax.pdf'; //fax.html ist Original

ändern in:

Code: PHP  [Auswählen]

$path_to_more_attachements[] = DIR_FS_DOCUMENT_ROOT . 'fax_'.$_SESSION['language'].'.pdf'; //fax.html ist Original

und sicherstellen, dass beide Dateien vorhanden sind.

Gruss
mantis

Quelle: send_order mit 3 Anhängen (Anhang für fax.html)

Mehrsprachigkeit für Shopversionen 1.06 und neuer:

So, melde erfolgreichen Test mit einer DE- & EN-Bestellung! 

Wie von noRiddle und web0null beschrieben habe ich folgende Änderungen gemacht:

Achtung - gilt für die modified 1.06 rev 4642 SP2 !

Suche in der /send_order.php:

Code: PHP  [Auswählen]

$email_attachments = defined('EMAIL_BILLING_ATTACHMENTS') ? EMAIL_BILLING_ATTACHMENTS : '';

Und füge danach ein:

Code: PHP  [Auswählen]

if ($email_attachments) {
  $t = explode(',', $email_attachments);
  array_walk($t, function(&$v, $k, $p) {$v = $p . basename($v);}, 'pdf/' . $order->info['language'] . '/');
  $email_attachments = implode(',', $t);
}

Im Backend dann unter Konfiguration -> E-Mail Optionen -> Verrechnung - E-Mail Anhänge für Bestellungen nur die Dateien ohne Verzeichnis-Angabe aufführen - z.B.:

AGB.pdf,Widerrufsbelehrung.pdf,Muster-Widerrufsformular.pdf

Dann auf dem Webserver via FTP folgende Verzeichnis-Struktur anlegen:
/pdf/
/pdf/german/
/pdf/english/

Und zuallerletzt dann in den angelegten Sprach-Verzeichnissen, die (im Backend angegeben) Dateien hochladen (z.B.: AGB.pdf,Widerrufsbelehrung.pdf,Muster-Widerrufsformular.pdf).

Eigentlich selbsterklärend aber ich sag's dennoch: die Dateinamen für EN und DE müssen natürlich absolut identisch sein... 

Nochmals gilt der Dank & Credits hierfür an noRiddle und web0null

Viele Grüße,
Barcelo

Grüße

Torsten

[EDIT Tomcraft 09.06.2010: Zum Einfügen der Widerrufsbelehrung (WRB) empfehlen wir dieses Modul hier: MODUL: Widerruf in Bestell-Email]
[EDIT Tomcraft: 13.07.2010: Eine Anleitung für beliebig viele Anhänge gibt es hier: send_order mit 3 Anhängen (Anhang für fax.html)]
[EDIT Tomcraft: 13.08.2010: Tipp von mantis bezüglich Mehrsprachigkeit von Shopversionen 1.00 - 1.05 SP1d ergänzt.]
[EDIT Tomcraft: 30.11.2014: Tipp von Barcelo bezüglich Mehrsprachigkeit von Shopversionen 1.06 und neuer ergänzt.]

Linkback: https://www.modified-shop.org/forum/index.php?topic=5364.0

[bewusst]

Hi Torsten,

super

Teste es heute Abend und gib danach Bescheid.

LG
bewusst

[claudia]

Hallo Torsten,

funktioniert prima.

Danke

Gruß
Claudia

[Tomcraft]

Das freut mich, danke für die Rückmeldung!

Grüße

Torsten

[seyth]

muss man die pdf dateien noch erstellen ? oder werden die automatisch erstellt ?

gruß
marcel

[Tomcraft]

Die E-Mail Anhänge (AGB.pdf und widerrufsbelehrung.pdf) müssen selber erstellt werden.

Es gibt kostenlose PDF-Drucker, beispielsweise PDFCreator oder Bullzip PDF Printer mit denen Du die PDFs kinderleicht als PDF "drucken" kannst.

Grüße

Torsten

[seyth]

dankeschön  

[becky]

Bei mir funktioniert alles soweit.
Wäre es jedoch möglich, die PDF's in einen eigenen Ordner attachment zu packen?
Wenn ja, was müsste man dafür ändern?

Code: PHP  [Auswählen]

$path_to_attachement = DIR_FS_ATTACHMENT . 'AGB.pdf';
$path_to_more_attachements = DIR_FS_ATTACHMENT. 'widerrufsbelehrung.pdf';
 

hat nicht funktioniert.
Danke

[Tomcraft]

Du bist ja goldig,

wo soll der der Pfad "DIR_FS_ATTACHMENT" definiert sein?

Wenn du es so haben willst, dann erweitere deine config.php Dateien um den Pfad:

Code: PHP  [Auswählen]

  define('DIR_WS_ATTACHMENT', DIR_FS_CATALOG . 'attachments/');
 

Alternativ kannst auch auch nur den Pfad in der send_order.php anpassen:

Code: PHP  [Auswählen]

$path_to_attachement = DIR_FS_DOCUMENT_ROOT . 'attachments/AGB.pdf';
$path_to_more_attachements = DIR_FS_DOCUMENT_ROOT . 'attachments/widerrufsbelehrung.pdf';
 

Grüße

Torsten

[star4000]

Super danke (Tomcraft) klappt wunderbar genau danach habe ich gesucht

[kwiekids]

Hallo,

ich gebe Eines zu bedanken, m.E. ist es lt. Rechtsprechung nicht ausreichend ein PDF
mit AGB an eine Mail anzuhängen, da nicht davon auszugehen ist, das der Empfänger
über ein geeignetes Programm verfügt, um die anghängte AGB öffnen und somit lesen
zu können  

Vielmehr muss die AGB als reiner Text empfangen werden können, so sollte es eine
zentrale AGB-Variable geben, die somit auch am Ende einer Mail angehängt werden
kann und dadurch kein weiteres Hilfsprogramm notig ist um die AGB lesen zu  können.

cheers  
kwiekids

[Spritzpistole]

Höchstrichterlich ist es noch nicht entschieden - somit kann man keine konkrete Aussage zu dieser Thematik treffen.

Aus juristischer Sicht gebe ich jedoch folgendes zu bedenken: Der Text IN einer E-Mail wird als ausreichend angesehen, weil er nach der Rechtsprechung als zur dauerhaften Speicherung geeignet ist. Denn hierfür braucht der Verbraucher nur die E-Mail empfangen und der Text steht ihm ohne weiteres zur Verfügung. Verfrachtet man nun die Texte wie AGB und Widerrufsbelehrung in den Anhang einer E-Mail sieht es schon komplizierter aus. Denn mit dem bloßen Emfang der E-Mail kann der Verbraucher noch keine Kenntnis vom Inhalt der angehangenen Dateien nehmen. Hierfür bedarf es auf Seiten des Verbrauchers neuerlichen Aufwand oder gar weiterer Programme. Aufgrund der sehr verbraucherfreundlichen Rechtsprechung halte ich diese Art der Kenntnisnahme für nicht ausreichend, da es umständlicher für den Verbraucher ist. Darüber hinaus stellt sich die Problematik geblockter Anhänge bzw. der technischen Untersagung der Öffnung von Anhängen. Eine Kenntnisnahme ist daher auf sichere Weise nicht gewährleistet, so dass es für den Händler erfolgversprechender ist, seine Belehrungstexte in die E-Mail zu integrieren, womit den Anforderungen an eine ordnungsgemäße Belehrung genüge getan ist.

[Tomcraft]

Ich könnte...

So eine E-Mail wird ja auch viel leserlicher dadurch, dass man unten noch das komplette Widerrufsrecht und am besten noch 10 Seiten AGB als Klar-Text mit ran hängt!

Grüße

Torsten

[Spritzpistole]

Also ich handhabe das mit der Widerrufsbelehrung schon seit Ewigkeiten in der Bestellbestätigungs-Mail und finde diese Situation jetzt nicht die schlechteste. Von Anhängen halte ich wegen der o.g. Erwägungen sowieso nichts.

Ordnungsgemäß einbezogen werden AGB, wenn der Verwender den Verbraucher bei Vertragsschluss die Möglichkeit der Kenntnisnahme der AGB gibt und der Verbraucher diesen zustimmt, § 305 Abs. 2 BGB. Es besteht daher gar keine Notwendigkeit der Mitsendung der AGB, lediglich für die Frage des Beweises wäre es eine Erleichterung. Somit brauch man sich daher mit den AGB in E-Mails nicht extra herumschlagen.

Beste Grüße
Thomas

[kwiekids]

... ich versende die Texte ebenfalls als Textanhang.
Von daher wäre es sicherlich von Vorteil, eine Zentrale AGB, etc.
als Textvariable zu haben, die in verschiedenen Medien verwendet werden kann.

cheers
kwiekids