Installation der Magento Extension

Sie möchten die Installation nicht selbst durchführen? Buchen Sie einfach meinen Support.

Hier zeige ich alle Schritte, wie man meine Magento 1 und 2 Extensions installiert - entweder ganz einfach per composer oder manuell via ZIP-Datei., am Beispiel der Advanced Invoice Layout Extension.

Vorbereitungen

Aus Sicherheitsgründen empfehlen wir ein Backup Ihrer Magento-Installation (Datenbank und Dateien) zu erstellen.
Nur Magento 1: deaktivieren Sie das Magento Compiler Feature unter System › Tools › Compiler (falls aktiviert)
Deinstallieren Sie etwaige vorherige Versionen des Moduls
Für eine Installation mit composer stellen Sie bitte sicher, dass composer in einer aktuellen Version 2.x auf Ihrem System installiert ist. Details finden Sie in der composer Installationsanleitung.

Installation mit composer (Magento 1 & 2)

Selbstverständlich können meine proprietären Magento 1 und Magento 2 Extensions auch über das tolle composer Tool installiert werden.
Dazu führen Sie bitte folgende Schritte aus:

In Ihrem Benutzerkonto können Sie die Zugangsdaten anfragen. Sie erhalten die composer Repository URL, einen Benutzernamen und ein Passwort.

Fügen Sie folgenden Eintrag in Ihre composer.json Datei ein:

composer config repositories.vianetz composer https://packages.vianetz.com/..

In Ihrem Magento-Installationsverzeichnis führen Sie bitte den Befehl
```
composer require --update-no-dev vianetz/module-advancedinvoicelayout
```
aus und geben Sie anschließend die Zugangsdaten ein, die Ihnen zur Verfügung gestellt wurden.

Anschließend werden alle Abhängigkeiten automatisch installiert und Sie können mit Schritt 4. der Installationsanleitung unten fortfahren.

Hinweis: die Zugangsdaten können in einer Datei auth.json gespeichert werden, so dass diese nicht jedes Mal eingegeben werden müssen.

Anleitung für Magento 2

Die Anleitung für Magento 1 befindet sich unten.

Erstellen Sie ein neues Verzeichnis für die Extension in app/code/, z.B. app/code/Vianetz/AdvancedInvoiceLayout.
Entpacken Sie das Setup-Paket und kopieren Sie den Inhalt in den neu erstellten Ordner. Die Ordner-Struktur sollte jetzt so aussehen: app/code/Vianetz/AdvancedInvoiceLayout/Block, app/code/Vianetz/AdvancedInvoiceLayout/etc, etc.

Bitte stellen Sie sicher, dass die Dateien mit denselben Berechtigungen erstellt werden wie der Benutzer der Magento-Installation.
Installieren Sie die Extension-Requirements via composer auf der Kommandozeile z.B. per SSH mit folgendem Befehl in Ihrem Magento Installationsverzeichnis:
```
composer require --update-no-dev vianetz/pdf-generator:^4.0 vianetz/module-core:^1.0
```
Hinweis: Wenn Sie eine ältere PHP-Version auf der Kommandozeile als für Ihren Webserver nutzen, können Sie das den Parameter --ignore-platform-reqs hinzufügen, um die PHP-Versionschecks zu ignorieren.
Aktivieren Sie die Extension und lassen Sie den Setupprozess laufen, indem Sie folgende Befehle ausführen:
```
bin/magento module:enable Vianetz_Core Vianetz_AdvancedInvoiceLayout && 
bin/magento setup:upgrade
```
Führen Sie die Compilation aus (nur im Magento Production Mode benötigt):
```
bin/magento setup:di:compile
```
Leeren Sie den Magento Cache (e.g. System › Cache Management) und alle dazugehörigen Caches sofern im Einsatz (z.B. APC, Varnish, ..).

Gratulation, die Installation ist erfolgreich abgeschlossen!

Anleitung für Magento 1

Entpacken Sie das (Zip-)Setup-Paket und kopieren Sie den Inhalt des Verzeichnisses src/ in das Hauptverzeichnis der Magento-Installation. (Die Verzeichnisstruktur ist dieselbe wie in Ihrer Magento-Installation (app/, skin/, ..); es werden keinerlei Dateien überschrieben).

Bitte stellen Sie sicher, das die Dateien dieselben Rechte wie die restlichen Dateien der Magento-Installation besitzen.
Leeren Sie den Magento-Cache (z.B. System › Cache Management) und ggfs. etwaige weitere Caches (z.B. APC, Varnish, ..).
Aus dem Magento Administrationsbereich ab- und wieder anmelden.

Gratulation, die Installation ist erfolgreich abgeschlossen!

Häufige Fragen zur Magento Installation

Magento zeigt nach der Extension-Installation eine weiße Seite ("Blank Page")

Symptom: Beim Ausführen einer bestimmten Aktion zeigt Magento nur eine weiße Seite ohne Inhalt.

Dies ist i.d.R. der Fall, wenn ein sog. "Fatal PHP-Error" aufgetreten ist.
Bitte sehen Sie zur Fehleranalyse in den PHP-/Webserver-Log-Dateien nach (z.B. unter /var/log/apache/.., ggfs. bei Ihrem Hoster erkundigen) und/oder im Magento Fehler-Log im Verzeichnis var/log.

Sofern es sich um eine lokale (Test-)Installation handelt, hilft auch ein Setzen der folgenden PHP-Settings in der Konfigurationsdatei php.ini:

error_reporting = E_ALL;
display_errors = On;

Alternativ im PHP-Code analog:

error_reporting(E_ALL);
ini_set('display_errors', 1);

Sollten Sie Hilfe bei der Auswertung des Fehlers benötigen, kontaktieren Sie mich bitte mit der Fehlermeldung und den exakten Schritten zur Reproduktion des Fehlers.

Kompatibilität mit der Extension AITOC Checkout Fields Manager

Unter System › Manage AITOC Modules auf den Link "Manage Class Rewrites" klicken und am Ende in das Textfeld "Indicate names of all base Magento classes, that you wouldn't like to overwrite" den Wert Mage_Sales_Model_Order_Pdf_Invoice ergänzen.

Auf dieser Seite habe ich außerdem einige häufige Probleme in Magento zusammengefasst.