Modul für den Magento Onlineshop. Advanced Invoice Layout. Installationshinweise. Version 1.1

Transkript

1 Modul für den Magento Onlineshop Advanced Invoice Layout Installationshinweise Version 1.1

2 Das Advanced Invoice Layout Modul für den Magento Online-Shop ermöglicht ein standardisiertes Layout für Rechnungen, Gutschriften und Lieferscheine. Weitere Details zur Funktionalität des Moduls sind auf der Produktseite unter /advancedinvoicelayout zu finden. In Aktion finden Sie das Modul in unserem Online-Demo-Shop unter /magento. Nachstehend sind einige Hinweise zur Installation des Moduls aufgeführt. Diese beziehen sich auf eine Standard-Installation per File Transfer Protocol (FTP) unter Microsoft Windows. Es kann kein Anspruch auf Vollständigkeit gegeben werden. Die Screenshots sind der Magento Version entnommen. Weitere Informationen, unter anderem Dokumentationen zum Magento-Onlineshop sind auf unserer Download-Seite (/downloads.php) verfügbar. Bei Fragen, Problemen und Anregungen zur Software stehen wir Ihnen jederzeit unter zur Verfügung. Es sei außerdem darauf hingewiesen, dass keine Garantie dafür übernommen werden kann, dass die in diesem Paket und den damit verbundenen Dokumenten bereitgestellten Informationen vollständig, richtig und in jedem Fall aktuell sind. Eine Beratung durch einen Rechtsexperten ist in jedem Fall erforderlich. Gerne nehmen wir auch Ihr Feedback zu diesem Modul unter /kontakt.php entgegen. Nur so ist eine kontinuierliche Verbesserung möglich. Mit freundlichen Grüßen, Christoph Maßmann

3 1. Technische Voraussetzungen Folgende Voraussetzungen sind für die Installation des AdvancedInvoiceLayout Moduls auf dem Webserver zu erfüllen: Es wird empfohlen, vor der Installation des Moduls eine Sicherung der Magento-Installation durchzuführen. Handelt es sich um ein Update des Moduls, beachten Sie bitte die Hinweise unter 7. Deinstallation. Um Ihnen die Installation unserer Module so einfach wie möglich zu gestalten, bieten wir Ihnen auch bezahlten professionellen Installationssupport an. Wir empfehlen Ihnen, diesen in Anspruch zu nehmen, bevor eventuelle Probleme auftauchen. Bitte nehmen Sie hierzu Kontakt mit uns unter auf. 2. Entpacken des Modul-Paketes & Upload auf den Webserver Das AdvancedInvoiceLayout-Modul wird als ZIP-Datei geliefert. Je nach Magento-Version sind verschiedene Setup-Pakete notwendig: - Magento Online-Shop Version >= PHP Version >= Sprachpaket (für deutsch bspw. Magento-Connect-Paket magentocommunity/locale_mage_community_de_de) Magento-Version Dateiname bis einschließlich Vianetz_AdvancedInvoiceLayout-1.1_Mage zip Vianetz_AdvancedInvoiceLayout-1.1_Mage zip ab Vianetz_AdvancedInvoiceLayout-1.1.zip Im Folgenden wird immer davon ausgegangen, dass Sie die aktuelle Version installieren. Entpacken Sie die Datei Vianetz_AdvancedInvoiceLayout-1.1.zip, z.b. mit dem kostenfreien Programm WinRAR, in ein Verzeichnis Ihrer Wahl. Anschließend müssen die entpackten Dateien auf den Webserver hochgeladen werden, z.b. mit dem Programm FileZilla. Hierbei ist die Dateistruktur des ZIP-Pakets entsprechend beizubehalten. Hinweis: Es werden keine Dateien der original Magento-Installation überschrieben.

4 3. Änderungen im Design In den Design-Dateien müssen folgende Änderungen durchgeführt werden: - Anlegen des Ordners pdf/ im Verzeichnis app/design/frontend/default/default/template/payment/info - Kopieren des Ordnerinhaltes aus app/design/frontend/default/default/template/payment/info in den neu erstellten Ordner pdf/ - Die obigen Schritte sind für jedes Zahlungsmodul durchzuführen, d.h. z.b. für das Modul Sofortüberweisung.de, BankPayment, CashOnDelivery, etc. Der Pfad ist entsprechend an das eigene Theme- und Interface-Verzeichnis anzupassen. Hinweis: Ab Magento-Version hat sich das Verzeichnis wie folgt geändert: app/design/frontend/base/default/template/payment/info

5 4. Konfiguration im Magento-Administrationsbereich Die Konfiguration des Magento-Moduls AdvancedInvoiceLayout ist im Administrationsbereich an zwei Stellen möglich. Die Basis-Einstellungen werden in System/Konfiguration/Verkäufe vorgenommen. Im Reiter Rechnungs- und Lieferscheingestaltung werden das Logo und die Onlineshop-Adresse hinterlegt: In System/Konfiguration/PDF Ausdrucke stehen nun u.a. folgende Optionen zur Auswahl:

6 5. Leeren des Magento-Caches Um die Änderungen in der Oberfläche letztendlich zu sehen, kann es notwendig sein, den Magento Cache zu leeren/deaktivieren.

7 6. Sonstige Hinweise a. Digitale Signatur Firewall-Einstellungen Zum Aufbau der Server-Verbindung zu signaturportal.de muss der Port 8095 in der Firewall geöffnet werden. b. Darstellungsweise der Adresse Die Standard-Darstellung der Adressdaten in Magento kann optional über die Datei app/code/community/vianetz/advancedinvoicelayout/etc/config.xml angepasst werden. Dies berücksichtigt auch die Darstellung in Rechnungen, Lieferscheinen und Gutschriften. Hierzu ist in der Datei der XML-Pfad config/global/customer/address/formats zu suchen und folgender Code entsprechend den Bedürfnissen abzuändern: <pdf translate="title" module="customer"> <title>pdf</title> <defaultformat><![cdata[ {{depend prefix}}{{var prefix}} {{/depend}}{{var firstname}} {{depend middlename}}{{var middlename}} {{/depend}}{{var lastname}}{{depend suffix}} {{var suffix}}{{/depend}} {{depend company}}{{var company}} {{/depend}} {{var street1}} {{depend street2}}{{var street2}} {{/depend}} {{depend street3}}{{var street3}} {{/depend}} {{depend street4}}{{var street4}} {{/depend}} {{depend city}}{{var city}}, {{/depend}}{{depend region}}{{var region}}, {{/depend}}{{var postcode}} {{var country}} {{depend telephone}}t: {{var telephone}}{{/depend}} {{depend fax}}<br/>f: {{var fax}}{{/depend}} ]]></defaultformat> c. Übersetzungen Anpassungen in den Übersetzungen können an folgenden Dateien vorgenommen werden: - app/locales/xx_xx/mage_sales.csv - app/locales/xx_xx/vianetz_advancedinvoicelayout.csv Gerne beraten wir Sie bezüglich weiterer Anpassungen. d. Market Ready Germany Bei Problemen mit dem Market Ready Germany-Modul sollte das Symmetrics_InvoicePdf deaktiviert werden. Hierzu in der Datei app/etc/modules/symmetrics_invoicepdf.xml den entsprechenden Wert auf false setzen.

8 7. Deinstallation Zur Deinstallation des Moduls sind folgende Schritte manuell auszuführen: - Löschung des Verzeichnisses app/code/community/vianetz/advancedinvoicelayout - Löschung der Datei app/locale/xx_xx/vianetz_advancedinvoicelayout.csv - Löschung der Datei app/etc/modules/vianetz_advancedinvoicelayout.xml