Benutzerhandbuch

pdfPRINT

für Magento2

Für aktuelle Information besuchen Sie bitte unsere website.

pdfPRINT 2.0.6

INSTALLATION

Installation über Magento Marketplace

Für mehr Informationen besuchen Sie bitte die Webseite

http://docs.magento.com/marketplace/user_guide/quick-

tour/install-extension.html

Manuelle Installation (Installation über Zip-File)

Entpacken Sie die Extension und kopieren Sie diese in den

Ordner /app/code. Ein Beispiel können Sie dem Bild rechts

entnehmen.

Öffnen Sie ein SSH Verbindung, navigieren zu Ihren “Root

Verzeichnis” und starten folgendes Kommando.

sudo –uwww-data bin/magento setup:upgrade

sudo –uwww-data bin/magento cache:clean

Weitere Informationen zur Installation von Extension finden Sie

auf der Webseite.

http://devdocs.magento.com/guides/v2.0

pdfPRINT 2.0.6

Allgemeine Einstellungen

pdfPRINT 2.0.6

Enabled: Aktivieren Sie die Extension

License: Fügen Sie Ihren Key ein

Für Jeden Typ können Sie folgende Option festlegen:

Enabled: Aktivierung für diesen Verkaufsdokument

USE PDF in frontend: Hier können Sie die Standard

HTML-Ausgabe im Benutzerbereich durch das PDF

ersetzen.

ATTACH PDF to email: Ermöglicht das automatische

hinzufügen des PDF beim versenden der E-Mail.

.

Template Übersicht

pdfPRINT 2.0.6

Hier sehen Sie den Überblick alle Ihrer Templates

Button Add New Template: Über diesen Button können

Sie ein neues Template anlegen.

Is Active: Nur aktivierte Templates werden beachtet

Is Default: Wenn Sie mehrere Template für einen Typ

definieren, können Sie hier das Template definieren,

welches bei der automatischen Generierung benutzt

werden soll. Im Allgemeinen benutzt man ein Template pro

Typ.

.

Neues Template

pdfPRINT 2.0.6

Hier können Sie ein neues Template von Grund auf

anlegen, oder Sie benutzen eine Beispiel-Template und

passen es Ihren Wünschen an.

Beispiele finden Sie auf unserer Webseite.(https://snm-portal.com/magento2-invoice-pdf-print.html)

Template - Allgemein

pdfPRINT 2.0.6

Default Template

Soll dies Ihr Template für die automatische Generierung

sein, dann wählen Sie bitte „YES“.

Download Name

Hier sind auch die Magento Markup Tags möglich

Template – PDF Template

pdfPRINT 2.0.6

Background: Hier können Sie Ihr Hintergrund PDF-

Template definieren. Dies Template definiert auch die

Größe des resultierenden Dokuments.

PDF Appendix: Hier können Sie ein statisches PDF

anhängen. Dies könnte z.B. Ihre AGB oder auch eine

Werbeinfo sein.

Email Options: Beim automatischen Versand per E-Mail

können Sie hier weitere statische PDF als Attachments

anhängen.

Das Beispiel-Hintergrund-PDF, sowie das dazugehörige

Word-Dokument finden Sie auf der Webseite.

Ihr Hintergrund-PDF mit Ihrem Geschäftspapier

Template – Freie Einträge

pdfPRINT 2.0.6

Hier können Sie beliebig viele absolut positionierte

Ausgaben definieren.

In den einzelnen Bereiche können Sie den erweiterten

Sprachumfang der Magento Markup-Tags verwenden.

Beispiel finden Sie in den jeweiligen Bespiel-Templates und

auf der Extension-Webseite.

Template – Tabelle und Text I

pdfPRINT 2.0.6

Vor der Haupttabelle mit den Rechnungsdaten können Sie

vor und nachher einen Text platzieren.

So zum Beispiel Angaben zu steuerlichen Fragen,

Versandinformationen oder auch Zahlungshinweise.

Template – Tabelle und Text II

pdfPRINT 2.0.6

Die Spaltendarstellung der Verkaufsdokumente unterliegen

in Magento einem festen Aufbau.

Dies kann durch die Option „Use Custom Columns“ mit

„NO“ erzeugt werden.

Möchten Sie eine andere Reihenfolge, dann verwenden Sie

die Option mit „Yes“

Template – Tabelle und Text III

pdfPRINT 2.0.6

Auch für die Zusammenfassung kann zwischen Standard

und „Custom“ gewählt werden.

Use Default Tax Renderer

Bei „Yes“ werden die Standard Definitionen aus der

Magento Konfiguration benutzt.

Display Full Tax Summary

Möchten Sie bei verschieden Steuer-Werte eine

Zusammenfassung der Gesamtsteuern, dann wählen Sie

„YES“.

Display Tax Total

Möchten Sie die Ausgabe der Gesamtsteuern nur bei

mehreren Steuersätzen dann wählen Sie die Option „Only

at different“

Template – Block Templates

pdfPRINT 2.0.6

Um direkten Zugriff auf PHP zu haben, wurden in

pdfPRINT M2 die Block-Templates eingeführt. Dies sind

den Magento Templates (.phtml) Files gleichzusetzen.

Sie können pro Eintrag definiert und angepasst werden.

Somit können spezielle und komplexere Aufgaben einfach

umgesetzt werden.

Hier sollte jedoch Kenntnisse in der Magento

Programmierung vorhanden sein.

Aufruf erfolgt über die Magento Block Directive mit

dem Attribute „snm“

{{block snm= “comments“}}

Template – CSS Styles

pdfPRINT 2.0.6

In dem Style-Bereich können Sie zu einem die Seitenränder

für Seite 1 und für alle weiteren Seiten definieren.

Weiterhin kann hier die CSS-Definition der HTML-Ausgabe

angepasst werden.

Um sich einen Überblick der erzeugten HTML-Ausgabe zu

verschaffen, kann unter „General“, die Ausgabe in ein Log-

File ausgegeben werden.

Template – Übersetzung

pdfPRINT 2.0.6

Oft ist man mit der Standard-Übersetzung in den

generierten Dokumenten nicht zufrieden. Dann kann man

hier ein Template spezifische Übersetzung hinterlegen.

Is RegEx: Soll der Text als „regular expression“ betrachtet

werden

Stop: Erfolgte ein Treffer wird mit der weiteren

Abarbeitung der Übersetzung ( von oben nach unten)

aufgehört.

Use in Label: Nur anwenden in einem

Label/Spaltenüberschrift

Use in Value: Nur anwenden in einem Wert

Comment: Für Ihre Information

Template – Export

pdfPRINT 2.0.6

Sie können das Template als Text-File speichern, um es z.B.

in einem anderen Projekt wieder zu verwenden.

PDF erzeugen

pdfPRINT 2.0.6

In den jeweiligen Dokumenten sehen Sie unter

„Print“ Ihre hinterlegten Templates für den jeweiligen Typ

und können die Ausgabe in verschiedenen Layouts

erstellen.

So ist es denkbar in einer Bestellung die Ausgabe als

„Angebot“ zu erstellen.

Extended Magento Markup Tags

Neben den Standard Directiven zur Ablaufsteuerung haben wir weitere Markup-Tags hinzugefügt.

{{snm_when <ausdruck>}} {{snm_otherwise}} {{/snm_when}}

{{snm_when helper.isShippingNeqBillingAddress() }}

{{if helper.neq(shippingaddress.country_id,'DE') }}

{{var shippingaddress.country}}

{{/if}}

{{snm_otherwise}}

Siehe Rechnungsadresse

{{/snm_when}}

{{snm_set <name>}} Text {{/snm_set}}

{{snm_set X32 }}

Name is: {{var first_name}} {{var last_name}}

{{/snm_set}}

{{var X32}} und {{var X32}}

pdfPRINT 2.0.6

Magento Helper/Variablen/Code Snippets

Die aktuell zur Verfügung stehenden Variablen, die Beschreibung der

pdfPRINT-Helper-Methoden, Template-Beispiel und viele Code Snippets

finden Sie auf der Extension Webseite von pdfprintM2

pdfPRINT 2.0.6

CSS/ Font / RTL Support

Für die Benutzung einer eigene Schriftart können Sie

einen TTF-Font hinterlegen.

Dazu kopieren Sie die Schrift-Art nach

/app/code/Snmportal/Pdfprint/media/fonts.

Über die CSS-Angabe „font-face“ können Sie Ihren

Font einbinden.

Für Sprachen mit rechts nach links verwenden Sie die

Klasse „rtl“ bzw. eine eigene.

Sie können auch größere Schriften hinterlegen, welche

alle benötigen Sprachen enthalten. Durch Font-

Substitution werden nur die benötigten Schriftzeichen

übernommen und das erzeugte PDF beleibt relativ

klein.

pdfPRINT 2.0.6

Vielen Dank!

Für Fragen und Anregungen können Sie gern uns

eine Nachricht zu kommen lassen.

Kontakt Seite: contact

E-Mail: support@snm-portal.com

Webseite: snm-portal.com

Extension: pdfprintM2

SNM-Portal Team

pdfPRINT 2.0.6