Fatchip GmbH Wiki

Diese Seite ist nicht editierbar. Sie können den Quelltext sehen, jedoch nicht verändern. Kontaktieren Sie den Administrator, wenn Sie glauben, dass hier ein Fehler vorliegt.
====== OXID Plugin - PdfBill 2 Mail ======

Das Plugin bei FATCHIP: https://www.fatchip.de/Plugins/OXID-eShop/OXID-Plugin-PdfBill-2-Mail.html \\
Das Plugin auf Github: https://github.com/FATCHIP-GmbH/plugin-oxid5-pdfbill2mail (private)

===== Voraussetzungen =====

  * OXID CE/PE ab Version 4.7.x bis 6.2.x 
  * OXID Invoice PDF Plugin 
  * (s)FTP-Zugang zur Shopinstallation
  * Ab der OXID-Version 6.2 wird ein SSH-Zugang zur Shopinstallation benötigt.

----

===== Installation =====

=== Invoice PDF Plugin installieren und aktivieren ===
Installieren und aktivieren Sie das Invoice PDF Plugin im OXID Administrationsbereich unter //Erweiterungen -> Module//. \\ Das Invoice PDF Plugin und weitere Informationen erhalten Sie unter [[https://github.com/OXIDprojects/pdf-invoice-module|Invoice PDF Plugin]]. 

{{:public:pdfbill_1.1.png?nolink&800|}}

=== Inhalt aus dem Ordner „copy_this“ kopieren (OXID eShop ab 4.7) ===
In dem Pluginpaket fcPdfBill2Mail_source befindet sich der Ordner //copy_this//, kopieren Sie den Inhalt aus diesem Ordner in das Hauptverzeichnis Ihres OXID eShops (bei FTP - binärer Übertragungsmodus nutzen).

{{:public:pdfbill_1.2.png?nolink&800|}}

=== Temp Verzeichnis leeren ===
Leeren Sie das Temp (tmp) Verzeichnis in Ihrem OXID eShop Hauptverzeichnis. Die enthaltene **.htaccess-Datei darf** dabei aber **NICHT** gelöscht werden!

{{:public:pdfbill_1.3.png?nolink&800|}}

=== In OXID-Versionen ab 6.2 (ältere Versionen können den Schritt überspringen)===
muss die Modulkonfiguration importieren/eingelesen werden.\\ Melden Sie sich dazu per SSH an dem Server an, auf dem sich die Shop-Installation befindet, und navigieren Sie zu dem Verzeichnis, in dem sich der Source- und Vendorornder befinden. Führen Sie den folgenden Befehl aus:\\ **/vendor/bin/oe-console oe:module:install-configuration source/modules/fc/fcPdfbill2mail/**\\ Bei erfolgreichem Einlesen/Import erscheint die Nachricht\\ **Module configuration has been installed**

=== PdfBill 2 Mail Plugin aktivieren ===
Aktivieren Sie das PdfBill 2 Mail Plugin im OXID Administrationsbereich unter //Erweiterungen -> Module//.

{{:public:pdfbill_1.4.png?nolink&800|}}

=== Weitere Informationen ===
Sollte das OXID Plugin PdfBill 2 Mail nach der Installation nicht wie erwartet funktionieren, prüfen Sie ob alle Installationsschritte richtig durchgeführt worden sind. Weitere Informationen zu dem OXID Plugin PdfBill 2 Mail finden Sie in unserem Online Shop unter https://www.fatchip.de/Plugins/OXID-eShop/OXID-Plugin-PdfBill-2-Mail.html.

Außerdem bietet FATCHIP einen Plugin-Installationsservice an. Weitere Informationen hierzu finden Sie unter\\ https://www.fatchip.de/Servicepakete/Plugin-Installationsservice-OXID-eShop-PE.html.


----

===== Update =====
für OXID Versionen ab 4.7.0

=== Alte Plugindateien entfernen ===
Entfernen Sie alle alten Plugindateien aus dem //application// und //modules// Ordner.\\ Unter //Erweiterungen -> Module -> Installierte Shopmodule// können Sie die alte Pluginversion restlosen entfernen.

=== Neuinstallation ausführen === 
Führen Sie die oben aufgeführten Schritte der Installation aus.

----

===== Konfiguration =====
=== PdfBill 2 Mail Plugin Grundeinstellungen ===
In den PdfBill 2 Mail Grundeinstellungen unter //Erweiterungen -> Module -> FATCHIP Module OXID pdfbill2mail -> Reiter „Einstellungen“// können Sie bestimmen, ob die PDF-Rechnung an die Kunden- und/oder Shopbetreiber-Bestellbestätigungsmail angehängt werden soll.

{{:public:pdfbill_2.1.png?nolink&800|}}

=== PDF-Rechnung bei den Zahlungsarten aktivieren ===
Sie können den PDF-Rechnungsversand pro Zahlungsart aktivieren, dazu setzen Sie z.B. unter //Zahlungsarten -> Vorauskasse -> Stamm// das Häkchen bei „Bei dieser Zahlart PDF-Rechnung an Bestellbestätigungs-E-Mail anhängen“.

{{:public:pdfbill_2.2.png?nolink&800|}}

----

===== FAQs =====

  - [[#Welche OXID eShop Versionen sind mit dem PdfBill 2 Mail Plugin von FATCHIP kompatibel?]]
  - [[#Warum ist das Plugin nicht für die Enterprise Edition von OXID eShop kompatibel?]]
  - [[#Es wird keine PDF-Rechnung an die Mail angehangen, woran kann das liegen?]]
  - [[#Bei der Zahlungsart PayPal wird keine PDF-Rechnung angehangen?]]
  - [[#Warum enthält die PDF-Rechnung Übersetzungsfehler?]]
  - [[#Ist das Plugin für mehrsprachige Shops ausgelegt?]]
  - [[#Warum wird das Plugin nach der Installation in OXID 6.2 nicht in der Pluginliste angezeigt?]]

=== 1. Welche OXID eShop Versionen sind mit dem PdfBill 2 Mail Plugin von FATCHIP kompatibel? ===
Die aktuellsten Informationen hierzu erhalten Sie in der [[https://www.fatchip.de/Plugins/OXID-eShop/OXID-Plugin-PdfBill-2-Mail.html#matrix|Kompatibilitätsmatrix]] in unserem Shop.

=== 2. Warum ist das Plugin nicht für die Enterprise Edition von OXID eShop kompatibel? ===
Leider gibt es in der Enterprise Edition das Invoice Plugin zur Erzeugung eines Rechnungs-PDF nicht. Da unser PDF2Mail Plugin auf diesem Feature aufbaut und die damit erzeugte PDF an die Bestellbestätigungs-E-Mail anhängt, funktioniert es in der EE leider nicht - es gibt dort einfach kein PDF, welches angehängt werden könnte.

=== 3. Es wird keine PDF-Rechnung an die Mail angehangen, woran kann das liegen? ===
Prüfen Sie, ob der Exportordner in Ihrem Shop-Hauptverzeichnis unter /export die benötigten Lese- und Schreibrechte (777) hat. In diesem Ordner werden die PDF-Rechnungen generiert.

=== 4. Bei der Zahlungsart PayPal wird keine PDF-Rechnung angehangen? ===
Prüfen Sie, ob der PDF-Rechnungsversand bei der Zahlungsart PayPal aktiv ist. Wenn Sie noch andere OXID Plugins verwenden, prüfen Sie die Plugin Reihenfolge unter Erweiterungen -> Module -> Installierte Shop Module. Hier sollte der Plugineintrag pdfbill2mail/azpdfbill2mail_oxemail unter „oxemail“ an erster Stelle stehen.

{{:public:fc_pdfbill_2_mail_11.png?nolink&800|}}

=== 5. Warum enthält die PDF-Rechnung Übersetzungsfehler? ===
Sollte die generierte PDF-Rechnung keine Übersetzungen enthalten, liegt es daran, dass die Sprachdatei **pdfbill2mail_lang.php** nicht gefunden werden kann. Diese Sprachdatei liefert die benötigten Übersetzungen für die PDF-Rechnung und sollte in folgenden Sprachordnern vorhanden sein:

  * /application/views/azure/de
  * /out/azure/de (Wenn Sie das Azure Theme DE verwenden)
  * /out/azure/en (Wenn Sie das Azure Theme EN verwenden)
  * /out/basic/de (Wenn Sie das Basic Theme verwenden)

Sollten Sie in Ihrem OXID eShop ein eigenes Theme verwenden, muss die PdfBill 2 Mail Sprachdatei pdfbill2mail_lang.php auch in dem Custom Theme Ordner hinterlegt werden. Der absolute Pfad zu dem Custom Theme Sprachordner würde wie folgt aussehen: /pfad-zu-ihrem-shop/out/ihr-custom-theme-ordner/de

  * /out/ihr-custom-theme/de (Wenn Sie ein custom Theme verwenden)

{{:public:fc_pdfbill_2_mail_12.png?nolink&800|}}

=== 6. Ist das Plugin für mehrsprachige Shops ausgelegt? ===
Dem Plugin liegt eine Sprachdatei bei. Diese Sprachdatei können Sie als Übersetzungspunkt für alle gewünschten und im Shop angebotenen Sprachen verwenden. Sobald die entsprechenden Sprachdateien vorliegen, werden die Rechnungen auch in den entsprechenden Sprachen verschickt.

=== 7. Warum wird das Plugin nach der Installation in OXID 6.2 nicht in der Pluginliste angezeigt? ===
Ab OXID 6.2 wird die Pluginkonfiguration //(metadata.php)// nicht mehr automatisch eingelesen. 
Dafür müssen Sie den folgenden Befehl über die SSH Kommandozeile in dem Shopverzeichnis (wo der //"vendor"// Ordner liegt) ausführen:

<code>./vendor/bin/oe-console oe:module:install-configuration source/modules/fc/fcPdfbill2mail/</code>

Nach der Ausgabe von //"Module configuration has been installed."// wird das Plugin unter //Erweiterungen -> Module// aufgelistet und kann aktiviert werden.

----

===== Support =====

Sollten Sie Hilfe von FATCHIP benötigen, schicken Sie bitte eine detaillierte Fehlerbeschreibung inkl. Plugin- und Shopversion an //support@fatchip.de//.
Fatchip GmbH Wiki

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Seiten-Werkzeuge
