Kompatible Shopsysteme (Middleware)

Wenn Sie Shopware 4.3, 5.0 oder 5.1 einsetzen und eine Migration auf Shopware 5.2 oder höher planen, beachten Sie bitte unbedingt die folgenden Informationen:

Die wesentlichste Neuerung in Shopware 5.2 ist eine komplett überarbeitete Adressverwaltung. Zuvor konnte in Shopware kein vollständiges Adressbuch geführt werden, wie dies Anwender von büro+ kennen. Mit Shopware 5.2 wurde diese Funktion eingeführt. Für ein Update von einer vorherigen Shopware-Version (4.3, 5.0, 5.1) ergeben sich grundlegende Änderungen der Datenstrukturen, die zusätzliche Migrationsschritte erforderlich machen. Nur so kann die korrekte Zuordnung zwischen Shopware-Adressen und den jeweiligen Anschriften in büro+ sichergestellt werden.

Alle relevanten Informationen zur Vorbereitung und Durchführung der Migration auf Shopware 5.2 finden Sie in unserem Migrationsleitfaden für das Update auf Shopware 5.2. (PDF).

Beim Verbindungstest kann es zu einer Meldung hinsichtlich: "Cannot redeclare Shopware() (previously declared in /engine/Shopware/Shopware.php) in /engine/Shopware/Application.php" kommen. Das liegt daran, dass Shopware nun eine "neue" PHP Datei hat und die "alte" nicht löscht.

Bitte benennen Sie daher die "Application.php" auf dem FTP um in z.B. "xApplication.x". Anschließend nochmal den Verbindungstest durchführen und testen die Funktionen durch. Hinsichtlich eingesetzter PlugIns (oder andere Programme außerhalb der Middleware) muss deren Funktionalität ebenfalls getestet werden. Es könnte sein, dass diese Software-Teile noch abhängig von der PHP Datei sind.

Das Shopware Plugin „Paypal Plus“ legt bei der Installation die Tabelle „s_payment_paypal_plus_payment_instruction“ an. Im Script für die Anlage der Tabelle befindet sich ein Fehler, so dass diese mit der falschen Kollation (Collation) und Zeichensatz (Charset) angelegt wird. Es muss dafür gesorgt werden, dass die Kollation und der Zeichensatz dieser Tabellen mit denen der restlichen Tabellen übereinstimmt. Normalerweise ist der Zeichensatz „utf8“ und die Kollation „utf8_unicode_ci“, dieser muss aber individuell in jeder Shopware-Datenbank geprüft werden!

Als Fehlermeldung erscheint im Middleware-Protokoll:

"Illegal mix of collations"

ALTER TABLE s_payment_paypal_plus_payment_instruction
CONVERT TO CHARACTER SET utf8
COLLATE utf8_unicode_ci


ALTER TABLE s_payment_paypal_plus_payment_instruction
MODIFY SET ordernumber VARCHAR(255) CHARACTER SET utf8
COLLATE     utf8_unicode_ci;


ALTER TABLE s_payment_paypal_plus_payment_instruction
MODIFY SET reference_number VARCHAR(255) CHARACTER SET utf8
COLLATE     utf8_unicode_ci;

Speziell für Magento gelten zusätzlich zu den allgemein gültigen noch folgende weitere Systemvoraussetzungen: 

1. Das Attributset in Magento muss default heißen.
2. mod_rewrite muss aktiviert werden.
3. memory_limit kann zu Problemen führen, falls dieser Wert zu niedrig ist, und sollte daher am besten auf 256MB eingestellt sein.
4. Im Shop-Adminbereich muss unter Konfiguration > Web unter Suchmaschinenoptimierung die Option Verwende Webserver Rewrites auf ja gesetzt sein.
5. Wenn der Shop nicht direkt über die Hauptdomain, sondern über ein Unterverzeichnis erreicht wird (z.B. "meine-domain.de/demo/shop"), dann muss in der .htaccess-Datei dieser Pfad auch hinterlegt sein. In Magento befindet sich diese Datei im Hauptverzeichnis. Für die Beispiel-URL "meine-domain.de/demo/shop" würden Sie die Zeile #RewriteBase /magento/ in RewriteBase /demo/shop/ ändern.
6. Der FTP-Nutzer benötigt Schreibrechte für folgende Verzeichnisse und deren Unterverzeichnisse:
   • ./app/code/community/Cateno
   • ./app/etc/modules (Hier wird von der Middleware nur die Datei Cateno_ShopSync.xml aktualisiert)
   • ./var/shopsync