Sinn und Zweck dieses Moduls
Im Adminbereich kann in der Bestellübersicht auf Knopfdruck eine Rechnung im pdf-Format erzeugt werden.
Diese Rechnung kann optional auch gleich bei der Bestellung oder bei Bestellstausänderungen mitgemailt werden und steht dem Kunden auch später in seiner Bestellhistorie zum Download zur Verfügung.
Einige Features:
- flexible Anpassung des Layouts durch Verwendung eigener pdf-Vorlagen möglich
- komplett multilanguage, unterschiedliche Rechnungen für unterschiedliche Sprachen möglich
- Breite Palette an mitgelieferten Schriftarten – beliebig erweiterbar
- Bei der Bestellung kann die pdf Rechnung automatisch an das Bestellbestätigungsmail angehängt werden.
- Bei Bestellstatusänderungen kann die Rechnung automatisch mitgemailt werden.
- Möglichkeit, Dokumente zu AGB und Widerrufsrecht automatisiert mitzusenden
- pdf-Rechnung für den Kunden in der Bestellhistorie unter „Mein Konto“ zum Download verfügbar
- Nahtlose Integration mit der IT Recht Kanzlei Schnittstelle
Konfiguration
Unter Konfiguration > pdf Rechnung ist das Modul standardmäßig deaktiviert. Bevor Sie es aktivieren gestalten Sie zunächst einmal eine eigene Rechnungsvorlage.
1) Eigene Rechnungsvorlage erstellen
Erstellen Sie ein pdf so wie Sie es haben wollen. Als Orientierung schauen Sie die Datei an, die mitgeliefert wurde:
includes/pdf/rechnung_de.pdf
Speichern Sie dieses pdf als rechnung_de.pdf ab und laden es in includes/pdf hoch und ersetzen das bestehende Beispiel-pdf damit.
Hinweis:
Falls Sie Ihrer Vorlage einen eigenen Namen geben (z.B. meinefirma_rechnungsvorlage.pdf), muss der Dateiname in der Administration und in der includes/pdf/rl_invoice3_def.php entsprechend geändert werden:
Im Admin unter Konfiguration > pdfRechnung den Dateinamen ändern bei:
pdf Hintergrunddatei
Also z.B. auf:
/var/www/html/xxxx/html/shop/includes/pdf/meinefirma_rechnungsvorlage.pdf
Dann in der includes/pdf/rl_invoice3_def.php alle rechnung_de.pdf auf meinefirma_rechnungsvorlage.pdf umbenennen.
Erstellen Sie danach probeweise eine pdf Rechnung, um zu sehen, wie die Rechnung nun mit Ihrem neuen Hintergrund aussieht.
Wichtig:
Wenn Sie Ihr pdf mit Adobe Acrobat erstellen, dann stellen Sie unbedingt eine Kompatibilität für Acrobat Version 4 und höher ein. Sie bekommen sonst beim Erstellen der pdf Rechnung die Meldung FPDF error: Unable to find xref table – Maybe a Problem with ‚auto_detect_line_endings‘
2) Eigene pdfs für AGB und Widerrufsrecht erstellen
Falls Sie das Mitsenden von AGB und Widerrufsrecht nutzen wollen, erstellen Sie auch dafür 2 eigene pdf Dateien:
Um zusätzlich die AGB mitzusenden, ein pdf mit den AGB erstellen und z.B. als agb_de.pdf abspeichern.
Die agb_de.pdf in folgendes Verzeichnis in Zen-Cart hochladen:
includes/pdf
Dadurch wird das mitgelieferte AGB-Beispiel überschrieben
Dann unter Konfiguration > pdf Rechnung > Anhänge folgendes eintragen:
agb_de.pdf
Um zusätzlich auch noch eine Info zum Widerrufsrecht mitzusenden, ein pdf mit der Widerrufsinfo erstellen und z.B. als widerruf_de.pdf abspeichern.
widerruf_de.pdf in folgendes Verzeichnis in Zen-Cart hochladen:
includes/pdf
Dadurch wird das mitgelieferte Widerrufsbeispiel überschrieben
Dann unter Konfiguration > pdf Rechnung > Anhänge folgendes eintragen:
agb_de.pdf | widerruf_de.pdf
3) Mit den mitgelieferten Schriftarten experimentieren
Voreingestellt in der Konfiguration ist die Schriftart Myriad für die Rechnungstexte und für die Artikeltexte und die Summen.
Alle verfügbaren Schriften findest Sie im Ordner includes/pdf/font
Um nun andere der mitgelieferten Schriftarten zu verwenden, stellen Sie unter Schriftarten für Rechnung und Artikel zwei andere ein, z.B.
dejavuserif | freeserif
Erstellen Sie dann wieder eine pdf Rechnung und prüfen das Ergebnis.
Falls Ihnen keine der Schriften zusagt, ist es möglich eigene Schriftarten zu verwenden. Das ist allerdings nur für versierte User empfohlen, da die Schriften zuerst in mehreren Verfahren konvertiert werden müssen. Ein Anleitung dazu ist in den FAQ zur pdf Rechnung zu finden.
4) Restliche Einstellungen vornehmen unter Konfiguration > pdf Rechnung
Die übrigen Konfigurationsmöglichkeiten unter Konfiguration > pdf Rechnung sind immer erklärt, wenn Sie auf Bearbeiten clicken:
pdf Rechnung Konfiguration
Hier ein paar Erläuterungen zu den wichtigsten Möglichkeiten:
Status
Hauptschalter für das Mitsenden der pdf Anhänge in den Emails
Steht defaultmäßig auf false. Stellen Sie erst auf true, wenn Sie Ihre eigene Rechnungsvorlage integriert und alles so angepasst haben, wie Sie es haben wollen.
PDF Hintergrunddatei
Falls Sie den Dateinamen Ihrer Vorlage geändert haben, müssen Sie hier von rechnung_de.pdf auf Ihren Dateinamen für die Rechnungsvorlage ändern. Es ist der absolute Pfad zur Vorlage anzugeben.
Rechnungsneuversand
Hier können Sie einen Bestellstatus oder mehrere Bestellstati einstellen, bei denen die pdf Rechnung nach Aktualisieren der Bestellung erneut versendet werden soll. Voreingestellt ist 3 (das ist normalerweise der Status „versendet“) und 100 (ein eigener Bestellstatus, der vom Modul mitgeliefert wird). Überprüfen Sie unter „Lokalisation“ > „Bestellstatus“ welche Werte die Bestellstati in Ihrem Shop haben und stellen dann hier die gewünschten Werte ein.
Rechnungsversand bei Bestellstatus
Hier wird definiert, bei welchem Bestellstatus die pdf Rechnung automatisch gemailt wird. Wenn die Rechnung gleich bei der Bestellung mitgemailt werden soll, muss hier auf 1 umgestellt werden (1 ist normalerweise der Status „Wartet“). Status 3 (versendet) ist für Shops interessant, die Downloadartikel anbieten und die gleich nach der Bezahlung freigeben. Auch hier vorher unter „Lokalisation“ > „Bestelllstatus“ unbedingt überprüfen, welche Werte in Ihrem Shop wirklich aktiv sind. Und auch überprüfen welche Bestellstati bei den angebotenen Zahlungsarten zugeordnet sind.
Rechnung bei Bestellung
Das ist die globale Einstellung. Wird sie auf 0 gestellt, wird nie automatisch eine Rechnung mitgemailt, egal was bei Rechnungsversand bei Bestellstatus eingestellt ist.
Speicherort und -name der PDF-Datei
Hier wird eingestellt, ob die pdf Rechnung überhaupt am Server gespeichert werden soll. Und wenn ja in welchem Ordner. Voreingestellt ist der Ordner pdf im Shophauptverzeichnis. Der Ordner für die Rechnungen muss beschreibbar sein (chmod 777)
Aus Sicherheitsgründen werden die erstellten pdf Rechnungen nicht einfach nur mit der Rechnungsnummer als Dateiname sondern mit einem langen zufällig generierten Dateinamen abgespeichert (z.B. 8_070599b1ec86ca75deac4696ca5f37eb.pdf)
Tip:
Eine noch bessere Absicherung der Rechnungen ist – falls das serverseitig möglich ist – als Speicherort einen Ordner unterhalb des Root Verzeichnis zu verwenden. Ein solcher Ordner kann zwar vom Webserver gelesen werden, ist aber per www nicht erreichbar.
Wenn ein solcher Ordner verwendet werden soll, den Pfad entsprechend anpassen.
Wenn z.B. der normale Pfad zum pdf Ordner innerhalb des Shopverzeichnisses (Voreinstellung) so lautet:
/home/user/www.meinshop.de/shop/pdf
umstellen auf:
/home/user/pdf
Auch ein solcher Ordner muss natürlich vom Webserver beschreibbar sein (chmod 777)
Die Rechnung kann dann trotzdem vom Kunden in seiner Bestellhistory heruntergeladen werden. Wichtig ist, dass unter Konfiguration > GZip Komprimierung die gZip Komprimierung NICHT eingeschaltet ist!
Generell erfolgt der Rechnungsdownload aus der Bestellhistory nach denselben Regeln wie bei Downloadartikeln im Shop. Es kommt also die Einstellung zum Tragen, die unter Konfiguration > Attributeinstellungen > Downloads über Weiterleitung eingestellt ist. Bei lokalen XAMPP Testinstallationen und auch bei sehr vielen Providern sind Downloads über Redirect nicht möglich. Schlägt der Download der Rechnung aus der Bestellhistory fehl, also unbedingt dieses Setting auf false stellen.
PDF Template auf erster Seite
Wenn zahlreiche Artikel bestellt werden und die auf der Rechnung nicht auf einer Seite Platz haben, erfolgt ein Seitenumbruch. Hier können Sie einstellen, ob der Rechnungsfooter auch auf der zweiten Seite erscheinen soll.
Abstand 2.Seite
Hier können Sie für die zweite Seite einen zusätzlichen Abstand einstellen.
Template für Artikel- und Summentabelle
Definiert sind die Templates in folgender Datei:
includes/pdf/rl_invoice3_def.php
Voreingestellt ist: amazon|amazon_templ|total_col_1|total_opt_1
In der Datei sind also folgende Werte für das Aussehen verantwortlich:
// amazon|amazon_templ|total_col_1|total_opt_1
$colsP['amazon'] = array(
'subtotalI' => '...',
'qty' => TABLE_HEADING_QTY,
'model' => TABLE_HEADING_PRODUCTS_MODEL,
'name' => TABLE_HEADING_PRODUCTS,
'singleI' => TABLE_HEADING_PRICE_EXCLUDING_TAX_AMAZON,
'tax' => TABLE_HEADING_TAX3,
'sumI' => TABLE_HEADING_TOTAL_EXCLUDING_TAX_AMAZON,
);
$optionsP['amazon_templ'] = array(
"subtotal"=>'subtotalE',
//"paperOriantation"=>"P",
"fontSize" => 10,
'showHeadings' => 1,
'shaded' => 0,
'lineHeightInvoiceNumber' => 4,
'fontSizeInvoiceNumber' => 10,
'xPos' => 'left',
'xOrientation' => 'right',
'width' => $realPW-35,
'bgPDFLang' => array('43' => 'rechnung_de.pdf',
'1' => 'rechnung_en.pdf',
),
'attachLang' =>
array('43' => array('AGB.pdf',
'Widerrufsrecht.pdf',
),
),
array('1' => array('AGB_en.pdf',
'Widerrufsrecht_en.pdf',
),
),
'cols' => array(
'subtotalI' => array('justification' => 'R', "width" => 0),
'qty' => array("justification" => "L", "width" => 16),
'model' => array("justification" => "L", "width" => 28),
'name' => array('justification' => 'L', "width" => 70),
'singleI' => array('justification' => 'R', "width" => 22),
'tax' => array("justification" => "R", "width" => 16),
'sumI' => array('justification' => 'R', "width" => 24),
)
);
Um z.B. die Schriftgröße zu verkleinern den fontSize auf 8 oder 9 stellen.
Um die Breite der einzelnen Spalten zu ändern die Werte bei width entsprechend anpassen.
Das amazon Template unterstützt unterschiedliche Sprachen für die Anhänge und Rechnungsvorlagen. Wenn im Shop nur die deutsche Sprache verwendet wird, dann muss hier nichts geändert werden.
Wollen Sie aber z.B. bei Bestellungen, die mit der englischen Version gemacht werden, eine englische Rechnungsvorlage verwenden und die AGB und Widerrufsinfo auf englisch mitsenden, dann geben Sie hier die vollständigen Pfade zu Ihren entsprechenden pdf Dateien an. Im Amazon Template überschreiben die in der includes/pdf/rl_invoice3_def.php gemachten Angaben die Angaben in der Konfiguration. Wenn Sie hier also Änderungen vornehmen, dann wird das gemacht, was in dieser Datei steht und nicht das, was unter Konfiguration > pdf Rechnung eingetragen ist.
Dazu ein Beispiel:
Im Shop verwenden Sie deutsch und englisch. Sie wollen bei einer englischen Bestellung die englische Rechnungsvorlage verwenden und AGB und Widerruf auf englisch mitsenden.
Die nötigen Dateien rechnung_en.pdf, AGB_en.pdf und Widerrufsrecht_en.pdf haben Sie in includes/pdf hochgeladen.
Also tragen Sie in der includes/pdf/rl_invoice3_def.php beim Amazon Template folgendes ein:
'bgPDFLang' => array('43' => '/home/xxx/xxx/includes/pdf/rechnung_de.pdf',
'1' => '/home/xxx/xxx/includes/pdf/rechnung_en.pdf',
),
'attachLang' =>
array('43' => array('/home/xxx/xxx/includes/pdf/AGB.pdf',
'/home/xxx/xxx/includes/pdf/Widerrufsrecht.pdf',
),
),
array('1' => array('/home/xxx/xxx/includes/pdf/AGB_en.pdf',
'/home/xxx/xxx/includes/pdf/Widerrufsrecht_en.pdf',
),
),
/home/xxx/xxx/ ist ein Beispiel für den vollständigen Pfad, ändern Sie das entsprechend ab.
Sollten andere Inhalte in den Spalten gewünscht sein, ein anderes Template auswählen oder sich ein eigenes Template nach dem vorgegebenen Muster zusammenstellen.
5) Rechnungsvorlage gestalten unter Tools > PDF Rechnung – Rechnungsvorlage
Unter „Rechnungsvorlage“ hat man einen visuellen Editor zur Gestaltung seiner Rechnung zur Verfügung. Die aktuellen unter Konfiguration > pdf Rechnung eingestellten Werte werden ausgelesen und können durch Ziehen der Felder mit der Maus verändert und visualisiert werden. Änderungen werden dann mit dem Button „Senden“ übernommen.
FAQ zur pdf Rechnung
Wie kann ich eigene Schriftarten verwenden?
Die pdf-Rechnung liefert etliche Schriftarten mit im Verzeichnis (includes/pdf/font).
Will man andere Schriftarten verwenden, müssen Schriften erst nach folgender Anleitung konvertiert werden (auf einem Windows Rechner)
1)
Das Tool ufpdf unter folgendem Link herunterladen:
www.zen-cart-pro.at/tools/ufpdf.zip
2)
Entpacken in irgendeinen Ordner auf der Festplatte, am besten in:
C:\ufpdf
3)
Die Schriftart, die konvertiert werden soll MUSS als True Type Font vorliegen (.ttf)
In diesem Beispiel konvertieren wir Myriad, es wird also die Datei myriad.ttf benötigt (z.B. aus dem Verzeichnis C:\Windows\Fonts
4)
Die myriad.ttf in C:\ufpdf\font kopieren
5)
Command Prompt (Eingabeaufforderung) öffnen und in C:\ufpdf\tools wechseln
6)
Folgenden Befehl eingeben:
ttf2ufm -a -F ..\font\myriad.ttf
Nach Bestätigung mit Enter sollte eine Meldung in dieser Art erscheinen:
7)
Im Ordner C:\ufpdf\font sind danach 3 zusätzliche Dateien vorhanden:
myriad.afm
myriad.t1a
myriad.ufm
Diese drei Dateien benötigen wir nun für den nächsten Schritt.
8)
In einem Texteditor eine Datei mit folgendem Inhalt erstellen:<?php
error_reporting(E_ALL);
require_once("makefontuni.php");
MakeFont("myriad.ttf","myriad.ufm");
?>
Datei abspeichern als make.php
9)
Am Server irgendein Verzeichnis anlegen, z.B. font. Das kann irgendein Verzeichnis sein, hat nichts mit Zen-Cart zu tun
Hinweis:
Das verwendete PHP Script ist recht alt, es wird mit PHP 8 nicht funktionieren und eine weiße Seite liefern.
Verwenden Sie daher einen Ordner, den Sie mit einer älteren PHP Version wie 7.1 oder 5.6 ansprechen können.
In dieses Verzeichnis nun die erstellte make.php hochladen.
Im Ordner C:\ufpdf\tools liegt eine makefontuni.php
Diese makefontuni.php ebenfalls in das Verzeichnis font hochladen.
Nun noch alle Myriad Fontdateien aus C:\ufpdf\font ebenfalls in dieses Verzeichnis hochladen, also:
myriad.ttf
myriad.afm
myriad.t1a
myriad.ufm
10)
Im Browser http://meinedomain.de/font/make.php aufrufen
Danach sind im Verzeichnis font die 3 Dateien vorhanden, die nun für die pdf Rechnung benötigt werden:
myriad.php
myriad.z
myriad.ctg.z
Wenn Sie beim Aufruf eine weiße Seite bekommen, dann prüfen Sie nochmal, ob Sie wirklich auf PHP 7.1 oder 5.6 gestellt haben.
11)
Diese drei Dateien nun in Zen-Cart in folgendes Verzeichnis hochladen:
includes/pdf/font
12)
Um die Schriftart Myriad nun in der pdf Rechnung zu aktivieren, im Zen-Cart Admin unter Konfiguration > pdf Rechnung > Schriftarten für Rechnungen und Artikel dejavusanscondensed auf myriad ändern.
Nach demselben Muster kann eine weitere Schriftart konvertiert und in der pdf Rechnung aktiviert werden. Dazu nur in der make.php den Namen der Schrift ändern. Soll z.B. verdana.ttf konvertiert werden, müsste die make.php so aussehen:<?php
error_reporting(E_ALL);
require_once("makefontuni.php");
MakeFont("verdana.ttf","verdana.ufm");
?>
Wie kann ich das Aussehen der Downloadlinks in der Kundenhistory verändern?
Verantwortlich ist folgendes Stylesheet:
includes/templates/DEINTEMPLATE/stylesheet_rl_invoice3.css
Darin Farbe/Hintergrundfarbe/Linkdefinitionen entsprechend anpassen oder neu eintragen.
Beim Download der Rechnung aus der Bestellhistorie im Frontend kommt eine Fehlermeldung?
Der Rechnungsdownload funktioniert nach demselben Prinzip wie das Herunterladen von Downloadartikeln in Zen-Cart. Daher greifen hier die Einstellungen unter Konfiguration > Attributeinstellungen. Sollte der Download nicht möglich oder das pdf beschädigt sein, den Download über Redirect auf false stellen. Download via Redirect ist bei lokalen XAMPP Installationen und auch bei sehr vielen Providern nicht möglich. Möglicherweise müssen Sie auch je nach Provider unter Konfiguration > GZip Komprimierung auf aus stellen.
FPDF error: Unable to find xref table – Maybe a Problem with ‚auto_detect_line_endings‘ kommt beim Erstellen der pdf Rechnung?
Die Kompatibilität der pdf Vorlage wurde zu hart eingestellt. Erforderlich ist:
