Wie installiere ich die Magento Extension?

Letzte Akt.: 07.01.2021 -

Christoph Maßmann

Im Folgenden eine kurze Installationsanleitung für unsere Magento Extensions, am Beispiel der Advanced Invoice Layout-Extension.

Möchten Sie die Extension via composer installieren? Bitte beachten Sie hierzu unseren FAQ-Eintrag zu composer.

Vorbereitungen

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

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:^2.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, ..).

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.