PepperShop PDF Druck Modul Anleitung

Transkript

1 PepperShop PDF Druck Modul Anleitung Datum 29. Dezember 2016 Version 2.0

2 Inhaltsverzeichnis 1. Einleitung Modulkonfiguration Standardwerte zurücksetzen Konfiguration für die Darstellung der Artikel Konfigurationseinstellungen Adressblock (Anschrift) Konfigurationseinstellungen Dokumenttitel (z.b Rechnung, Lieferschein) Konfigurationseinstellungen Infoblock (Rechnungs-Nr,Bestelldatum,..) Konfigurationseinstellungen Artikeltabelle Konfigurationseinstellungen Artikelzusatzinformationen (Varianten, Optionen, Textfelder) Konfigurationseinstellungen (Artikel)Bilder Konfigurationseinstellungen Total-Positionen Konfigurationseinstellungen Seitenanzahl/Seitentotal Konfigurationseinstellungen Rechnung Zahlungsfrist Allgemeine Konfiguration Bedienung Eigene Schriften importieren (für fortgeschrittene Benutzer) Eigene Schrift via PepperShop Batchimport konvertieren UTF-8 Support Installation Systemanforderungen Dateien kopieren und hochladen Modulinstallation Weitere Installationsschritte Hilfe Anhang 1: Beispiel Rechnung...12 Anhang 2: Beispiel Lieferschein...13 PepperShop wird von Glarotech entwickelt und vertrieben. Seit 1998 ist das innovative Unternehmen im Internet tätig und auf E-Commerce spezialisiert. Sie als Kunde profitieren vom direkten Draht zu den Herstellern der Produkte. Glarotech GmbH Toggenburgerstrasse 156 CH-9500 Wil Tel. +41 (0)

3 1. Einleitung Wenn man per Knopfdruck einen verwendbaren Lieferschein und eine verwendbare Rechnung drucken kann, erspart man sich viel Aufwand und damit Kosten. Mit diesem Modul für PDF Lieferschein- und Rechnungsdruck lassen sich elegante PDF-Dokumente zu jeder eingegangenen Bestellung erzeugen. Es kann auch eine eigene PDF-Vorlage importiert werden, die dann als Briefvorlage verwendet wird. Das Modul ist optional für den PepperShop erhältlich und muss separat erworben werden. 2. Modulkonfiguration Zuerst geht man in die PDF Modulverwaltung: Hauptmenü der Shop-Administration 'Module' > 'PDF' (siehe Screenshot Ausschnitt auf der rechten Seite). In der Verwaltungsmaske des dieses PepperShop Moduls kann man nun die eigenen PDF-Vorlagen hochladen, das Modul aktivieren und die Platzierung der einzelnen Elemente (Anschrift, Titel, Artikelpositionen, ) ganz genau konfigurieren. Info: Die PDF-Vorlagen sollten bis auf Logo und Footer möglichst leer sein. In der PDF Modulverwaltung gibt es folgende Einstellungsmöglichkeiten: Abbildung 1: Button Seite 3/13

4 Abbildung 2: Ausschnitt aus dem PDF Modul Konfigurationsdialog Abbildung 3: Fortsetzung von Abbildung Standardwerte zurücksetzen Standardwerte wiederherstellen: Das Modul wird auf seine Standardwerte zurück gesetzt, jegliche Konfigurationen gehen verloren und die Standardwerte werden gesetzt. 2.2 Konfiguration für die Darstellung der Artikel Aktivierung: Soll das Modul aktiv sein? PDF-Vorlage für die erste Seite: Hier wird eine PDF-Vorlage für die erste Seite hochgeladen. Das Hochladen geschieht ohne den Speichern-Button. PDF-Vorlage für die Folgeseite: Hier wird eine PDF-Vorlage für die Folgeseite hochgeladen. Das Hochladen geschieht ohne den Speichern-Button. Testansicht: Es wird ein Test-PDF erzeugt. Seite 4/13

5 2.3 Konfigurationseinstellungen Adressblock (Anschrift) maximale Zeilenlänge (längere Zeilen werden umgebrochen): Hier wird die die Anzahl Zeichen erwartet, welche maximal auf einer Zeilen stehen dürfen. Adressblock Abstand vom linken Dokumentrand (in mm): Wie gross soll der gesamte Abstand vom linken Dokumentrand bis zum Adressblock sein? Die Angabe muss in Adressblock Abstand vom oberen Dokumentrand (in mm): Wie gross soll der gesamte Abstand vom oberen Dokumentrand bis zum Adressblock sein? Die Angabe muss in Breite des Adressblocks (in mm): Die Breite des gesamten Adressblocks. Die Angabe muss in Adressblock-Schriftstil: leer, B, I, U: Legen sie fest, ob der Text Bold ( Fett ), Italic ( Kursiv ), Underlined ( Unterstrichen) sein soll, oder einfach unformatiert(leer). Adressblock-Schriftgrösse in Punkten: Welche Grösse soll die normale Schrift im Adressblock vorweisen? 2.4 Konfigurationseinstellungen Dokumenttitel (z.b Rechnung, Lieferschein) Titelblock Abstand vom linken Dokumentrand (in mm): Wie gross soll der gesamte Abstand vom linken Dokumentrand bis zum Titelblock sein? Die Angabe muss in Titelblock Abstand vom oberen Dokumentrand (in mm): Wie gross soll der gesamte Abstand vom oberen Dokumentrand bis zum Titelblock sein? Die Angabe muss in Breite der linken Spalte (Bezeichnungen): Wie gross soll die linke Spalte sein? Die Angabe soll in Textausrichtung linke Spalte: Die Breite des gesamten Adressblocks. Die Angabe muss in Titelblock-Schriftstil: leer, B, I, U: Legen sie fest, ob der Text Bold ( Fett ), Italic ( Kursiv ), Underlined ( Unterstrichen) sein soll, oder einfach unformatiert(leer). Titelblock-Schriftgrösse in Punkten: Welche Grösse soll die normale Schrift im Titelblock vorweisen? 2.5 Konfigurationseinstellungen Infoblock (Rechnungs-Nr,Bestelldatum,..) Infoblock Abstand vom linken Dokumentrand (in mm): Wie gross soll der gesamte Abstand vom linken Dokumentrand bis zum Infoblock sein? Die Angabe muss in Infoblock Abstand vom oberen Dokumentrand (in mm): Wie gross soll der gesamte Abstand vom oberen Dokumentrand bis zum Infoblock sein? Die Angabe muss in Breite der linken Spalte (Bezeichnungen): Wie gross soll die linke Spalte sein? Die Angabe soll in Breite der rechten Spalte (Inhalte): Wie gross soll die rechte Spalte sein? Die Angabe soll in Breite der zweiten linken Spalte (bei zweispaltig eingeschaltet): Wie gross soll die zweite linke Spalte sein? Die Angabe soll in Breite der zweiten rechten Spalte (bei zweispaltig eingeschaltet): Wie gross soll die zweite rechte Spalte sein? Die Angabe soll in Textausrichtung linke Spalte: Die Ausrichtung des Textes innerhalb der linken Spalte. L für Links oder R für Rechts eintragen. Textausrichtung rechte Spalte: Die Ausrichtung des Textes innerhalb der rechten Spalte. L für Links oder R für Rechts eintragen. Seite 5/13

6 2.6 Konfigurationseinstellungen Artikeltabelle Rechnung, maximale Zeilenlänge des Artikelnamens(längere Zeilen werden umgebrochen): Nach wie vielen Buchstaben soll der Inhalt umgebrochen werden? Lieferung, maximale Zeilenlänge des Artikelnamens(längere Zeilen werden umgebrochen): Nach wie vielen Buchstaben soll der Inhalt umgebrochen werden? Artikeltabellen-Abstand vom linken Dokumentrand (in mm: Wie gross soll der gesamte Abstand vom linken Dokumentrand bis zum Titelblock sein? Die Angabe muss in Artikeltabellen-Abstand vom oberen Dokumentrand (in mm): Wie gross soll der gesamte Abstand vom oberen Dokumentrand bis zum Titelblock sein? Die Angabe muss in Breite Positionsspalten: Wie breit soll die Spalte sein, welche die einzelnen Positionen anzeigt? Die Angabe muss in Breite Bezeichnungsspalte: Wie breit soll die Spalte sein, welche die Bezeichnungen enthält? Die Angabe soll in Breite Spalte Anzahl: Wie breit soll die Spalte sein, welche die Anzahl Artikel enthält? Die Angabe soll in Breite Spalte Einheit: Wie breit soll die Spalte sein, welche die Einheit (Stück., kg etc.) enthält? Die Angabe soll in Breite Preisspalte: Wie breit soll die Spalte sein, welche die Preise enthält? Die Angabe soll in Breite Mehrwertsteuerspalte: Wie breit soll die Spalte sein, welche die Mehrwertsteuer enthält? Die Angabe soll in Breite Totalspalte: Wie breit soll die Spalte sein, welche die Totale enthält? Die Angabe soll in Textausrichtung Positionsspalten: Die Ausrichtung des Textes innerhalb der Positionsspalten. L für Links oder R für Rechts eintragen. Textausrichtung Bezeichnungsspalte: Die Ausrichtung des Textes innerhalb der Bezeichnungsspalte. L für Links oder R für Rechts eintragen. Textausrichtung Spalte Anzahl: Die Ausrichtung des Textes innerhalb der Spalte Anzahl. L für Links oder R für Rechts eintragen. Textausrichtung Spalte Einheit: Die Ausrichtung des Textes innerhalb der Spalte Einheit. L für Links oder R für Rechts eintragen. Textausrichtung Preisspalte: Die Ausrichtung des Textes innerhalb der Preisspalte. L für Links oder R für Rechts eintragen. Textausrichtung Mehrwertsteuerspalte: Die Ausrichtung des Textes innerhalb der Mehrwertsteuerspalte. L für Links oder R für Rechts eintragen. Textausrichtung Totalspalte: Die Ausrichtung des Textes innerhalb der Totalspalte. L für Links oder R für Rechts eintragen. 2.7 Konfigurationseinstellungen Artikelzusatzinformationen (Varianten, Optionen, Textfelder) Artikelzusatzinformationen-Schriftgrösse in Punkten: Welche Grösse soll die normale Schrift im Adressblock vorweisen? Artikelzusatzinformationen-Schriftstil: leer, B, I, U: Legen sie fest, ob der Text Bold ( Fett ), Italic ( Kursiv ), Underlined ( Unterstrichen) sein soll, oder einfach unformatiert(leer). Seite 6/13

7 2.8 Konfigurationseinstellungen (Artikel)Bilder Artikelbilder* in Rechnung anzeigen Artikelbilder* in Lieferschein anzeigen Artikelbilder: Maximale Höhe Artikelbilder: Maximale Breite Allgemein Bilder: Auflösung in dpi (dpi = Dots per Inch = Punkte pro Inch) * Artikelbilder werden immer vom aktuellen Sortiment genommen (identifiziert durch die interne ArtikelID). Falls ein Artikel aus dem Sortiment entfernt wird oder dessen Bild in der Zwischenzeit geändert hat, so wird sich dies auch auf den Rechnungs-/Lieferscheindruck auswirken. Weiter muss berücksichtigt werden, dass nur Bilder in den Formaten JPG und PNG (nur 8-Bit) angezeigt werden können. 2.9 Konfigurationseinstellungen Total-Positionen Breite Währungs-Spalte: Wie breit soll die Spalte sein, welche die Währungs-Spalte enthält? Die Angabe soll in Breite Totalspalte: Wie breit soll die Spalte sein, welche die Totalspalte enthält? Die Angabe soll in Textausrichtung Bezeichnungsspalte: Die Ausrichtung des Textes innerhalb der Bezeichnungsspalte. L für Links oder R für Rechts eintragen. Textausrichtung Spalte Währung: Die Ausrichtung des Textes innerhalb der Spalte Währung. L für Links oder R für Rechts eintragen. Textausrichtung Total-Spalte: Die Ausrichtung des Textes innerhalb der Total-Spalte. L für Links oder R für Rechts eintragen Konfigurationseinstellungen Seitenanzahl/Seitentotal Seitenangabe Abstand vom linken Dokumentrand (in mm): Wie gross soll der gesamte Abstand vom linken Dokumentrand bis zum Titelblock sein? Die Angabe muss in Seitenangabe Abstand vom oberen Dokumentrand (in mm): Wie gross soll der gesamte Abstand vom oberen Dokumentrand bis zum Titelblock sein? Die Angabe muss in Schriftstil: leer, B, I, U: Legen sie fest, ob der Text Bold ( Fett ), Italic ( Kursiv ), Underlined ( Unterstrichen) sein soll, oder einfach unformatiert(leer). Schriftgrösse in Punkten: Welche Grösse soll die normale Schrift im Adressblock vorweisen? Ausrichtung: Die Ausrichtung des Textes der Seitenzahl/des Seitentotals. L für Links oder R für Rechts eintragen Konfigurationseinstellungen Rechnung Zahlungsfrist Anzeige der Zahlungsfrist (nur bei Rechnungs PDF-Dokument)*: in Rechnung anzeigen Zahlungsfrist: Anzahl Tage: Angabe in Tagen 2.12 Allgemeine Konfiguration Textfarbe Rotanteil des RGB: Der Rotanteil der Textfarbe für das PDF. Textfarbe Grünanteil des RGB: Der Grünanteil der Textfarbe für das PDF. Textfarbe Blauanteil des RGB: Der Blauanteil der Textfarbe für das PDF. Name der Schriftart: Wählen sie hier die Schriftart für das PDF. Schriftstil: leer, B, I, U: Legen sie fest, ob der Text Bold (Fett), Italic (Kursiv), Underlined (Unterstrichen) sein soll, oder einfach unformatiert(leer). Schriftgrösse in Punkten: Welche Grösse soll die normale Schrift vorweisen? Seite 7/13

8 Seitenrand Oben: Den Seitenrand in Millimetern vom oberen Rand angeben. Seitenrand Rechts: Den Seitenrand in Millimetern vom rechten Rand angeben. Seitenrand Unten: Den Seitenrand in Millimetern vom unteren Rand angeben. Seitenrand Links: Den Seitenrand in Millimetern vom linken Rand angeben. Orientierungsraster über das ganze Dokument ausgeben: Legt ein Hilfsgrid über das ganze PDF, so dass die Ausrichtung überprüft werden kann. Anzeige von Preisen inkl. MWST*. 3. Bedienung Um nun einen Lieferschein oder eine Rechnung zu erzeugen, kann man einfach auf den neuen 'PDF'Button unter 'Kunden/Bestellungen' > 'Kundenmanagement' klicken und dort den entsprechenden Link anwählen. Abbildung 4: Kundenmanagement und Bestellungen Ansicht Die generierten PDF-Dateien werden in folgendem Verzeichnis abgelegt: {shopdir}/shop/admin/pdf/ generiert/ 4. Eigene Schriften importieren (für fortgeschrittene Benutzer) Im PepperShop werden PDFs mittels der FPDF Library erzeugt. Diese kann nur spezifisch aufbereitete Schriften verwenden. Dazu muss eine TrueType Schriftart zuerst konvertiert werden. Es gibt hierfür ein einfach zu bedienender Online Generator: Hier gibt man eine TrueType Schriftart an (.TTF Datei) und speichert nach der Konvertierung die beiden Dateien.php und.z ab. Diese beiden Dateien müssen für jeden Schriftschnitt (normal, fett, kursiv und fett+kursiv) ins folgende Verzeichnis kopiert werden: {shop_verzeichnis}shop/admin/pdf/fpdf/font/ Damit die Schfrift von FPDF verwendet werden kann, muss diese aber einem speziellen Namensschema entsprechen: Nur Kleinbuchstaben und keine Sonderzeichen (Bsp. Schriftart: Lars Sans): Normal:{Schriftart Name}.ttf Beispiel: larssans.ttf Seite 8/13

9 Fett:{Schriftart Name}b.ttf Beispiel: larssansb.ttf Kursiv:{Schriftart Name}i.ttf Beispiel: larssansi.ttf Fett+Kursiv:{Schriftart Name}bi.ttf Beispiel: larssansbi.ttf WICHTIG: ES MÜSSEN IMMER DIESE VIER DATEIEN PRO SCHRIFT VORHANDEN SEIN (sollte mal eine fehlen, einfach die normale kopieren und b oder bi oder i dahinter anhängen und so speichern. 5. Eigene Schrift via PepperShop Batchimport konvertieren Mit diesem Tool, das ab PepperShop v.3.2 verfügbar ist, kann man viele Schriften schnell für FPDF konvertieren. Per FTP oder via Konsole auf den Webserver verbinden. Im Shop folgende zwei Verzeichnisse neu anlegen, falls diese noch nicht vorhanden sind: {shop_verzeichnis}/shop/admin/pdf/fpdf/src (ggf. Verzeichnisrecht auf 777 anpassen) {shop_verzeichnis}/shop/admin/pdf/fpdf/dest (ggf. Verzeichnisrecht auf 777 anpassen) Im src Verzeichnis die zu konvertierenden TTF-Dateien ablegen Die TTF Dateien müssen die im vorigen Kapitel genannte Namenskonvention erfüllen und es müssen immer alle vier Schriftschnitte vorhanden sein! a) Im Browser oder via Kommandozeile folgenden Aufruf tätigen (Safe-Mode muss aus sein!): b)...oder via Command-Line: cd {shopverzeichnis}/shop/admin && php pdf/makefont_batch.php commandline Die nun erzeugten Fonts (.php +.z Dateien) vom Ordner./shop/Admin/pdf/fpdf/makefont/ dest in den Ordner shop/admin/pdf/fpdf/font verschieben. Die Fonts können nun verwendet werden. 6. UTF-8 Support Standardmässig unterstützt das zugrunde liegende FPDF System nur den Latin1 Zeichensatz. Soll der umfangreiche UTF-8 Zeichensatz verwendet werden, mit welchem auch viele Zeichen von anderen Sprachen angezeigt werden können, so muss wie folgt vorgegangen werden: Voraussetzungen: Systemvoraussetzung ist ein PepperShop ab der Version Es muss direkter Filezugriff vorhanden sein (FTP oder SCP) PHP-Kenntnisse und ein Editor, der mit UNIX Zeilenumbrüchen arbeiten kann UTF-8 Umschaltung / Aktivierung: Admin/pdf/tfpdf.tar.gz entpacken Wenn man eine TrueType-Schriftart (.ttf) hat, welche UTF-8 unterstützt (!), kann man das Modul entsprechend konfigurieren, so dass es mit UTF-8 funktioniert. In der Datei {shop_verzeichnis}/shop/admin/pdf/pdf_config.php muss man die Steuerungskonstante PDF_USE_UTF8 auf true umstellen. In die Konstante PDF_USE_UTF8_FONT_NAME trägt man den Namen der UTF-8 fähigen TTFSchriftart ein. Seite 9/13

10 In die Konstante PDF_USE_UTF8_FONT wird der Dateiname der Schriftart eingetragen. Die Schriftart muss im Verzeichnis {shop_verzeichnis}/admin/pdf/tfpdf/font/unifon/ liegen. Die Konstante PDF_USE_UTF8_FONTB ist das gleiche wie PDF_USE_UTF8_FONT für 'fett'. Die Konstante PDF_USE_UTF8_FONTI ist das gleiche wie PDF_USE_UTF8_FONT für 'kursiv'. 7. Installation 7.1 Systemanforderungen Um das PDF Druck Modul einsetzen zu können, ist ein PepperShop v.3.0 Professional oder Enterprise erforderlich. 7.2 Dateien kopieren und hochladen Das Modul besteht aus einigen Dateien und Unterverzeichnissen, die man in seinen installierten PepperShop kopieren muss. Dazu entpackt man zuerst das mitgelieferte ZIP-Archiv. Darin sind die Unterordner mit den Dateien enthalten: {shopdir}/shop/admin/pdf {shopdir}/shop/admin/module/pdf {shopdir}/shop/module/pdf (Verzeichnis) (Verzeichnis) (Verzeichnis) Die Dateien lassen sich einfach via FTP oder SCP zum Webserver hochladen. Der Platzhalter {shopdir} steht dabei für das Shopverzeichnis auf dem Webserver, wo die Datei index.php zusammen mit der Datei README.txt zu finden ist. Nun wird das Modul vom Shop erkannt und eingebunden. Es wird im Menü 'Shop-Einstellungen' > 'Shop Konfiguration' unten bei den internen Modulinfos aufgelistet. 7.3 Modulinstallation Nach dem Kopieren der Dateien kann man in die Shop-Administration gehen und dort ins Menü 'Module' wechseln. Auf der linken Seite, bei den noch nicht installierten Modulen, sieht man nun das PDF Modul aufgelistet. Nun muss das PDF Modul angewählt werden und auf den 'Installieren' Button geklickt werden. Wenn die Installationsroutine ohne Probleme durchläuft, wird dies auf der darauf folgenden Seite kommuniziert. Das Modul ist nun installiert. Wir klicken nun auf den Button ' Zurück zur Modulverwaltung' und dort 'Zurück zur Moduladministration'. Wir sehen jetzt einen Button für das PDF Modul. Wenn man auf diesen Button klickt, erscheint die Verwaltung dieses Moduls. Seite 10/13

11 Abbildung 5: Moduladministration (die angezeigten Module können abweichen) 7.4 Weitere Installationsschritte Das PDF-Druck Modul enthält zwei Pakete, die zur reibungslosen Verwendung des Moduls entpackt werden müssen: {shopdir}/shop/admin/pdf /fpdf.tar.gz {shopdir}/shop/admin/pdf /fpdi.tar.gz Wenn PHP auf einem UNIX-Server als Webservermodul läuft (und nur dann): dem Verzeichnis {shopdir}/shop/admin/pdf die Zugriffsrechte 777 zuteilen dem Verzeichnis {shopdir}/shop/admin/pdf/generiert die Zugriffsrechte 777 zuteilen dem Verzeichnis {shopdir}/shop/admin/pdf/template die Zugriffsrechte 777 zuteilen Die Dateizugriffsrechte lassen sich auch automatisch setzen (FTP basiert): 'Shop-Einstellungen' > 'ShopKonfiguration' > 'Operationen' sollte man nun noch die Dateirechte anpassen lassen. Die Installation des PDF Moduls ist nun abgeschlossen. Damit das Modul eingesetzt werden kann, muss das Modul nun noch an die spezifische Konfiguration des Shopbetreibers angepasst werden, siehe dazu das nächste Kapitel Modulkonfiguration, weiter unten. 8. Hilfe Bei offenen Fragen oder Unklarheiten helfen die Foren auf weiter. Seite 11/13

12 8.1 Anhang 1: Beispiel Rechnung Seite 12/13

13 Anhang 2: Beispiel Lieferschein Seite 13/13