Türchen 18: Von GermanSetup zu MageSetup

Warum die Umbenennung?

GermanSetup war ausschließlich für den deutschsprachigen Raum bestimmt und hat Deutschland, Österreich und die Schweiz unterstützt. Dabei wurden ausschließlich deutsche Inhalte eingesetzt, beispielsweise für CMS-Seiten wir Impressum oder AGB, sowie für Email-Vorlagen. Innerhalb der deutschen Magento-Community kam mehrfach die Frage auf, ob GermanSetup auch ausländische Shops unterstütze. Auslöser für die Internationalisierung war dann schließlich der Wunsch, die lokalisierten Magento-Editionen für weitere Länder umzusetzen - GermanSetup bildet einen integralen Bestandteil der Lokalisierungen. Da der Name "GermanSetup" für russische, britische oder französische Magento-Shops etwas unpassend gewesen wäre, haben wir uns entschlossen, das Projekt in MageSetup umzubenennen.

Wie international ist MageSetup?

Aktuell werden folgende Länder vollständig unterstützt:

Deutschland
Österreich
Schweiz (in deutscher und/oder französischer Sprache)
Großbritannien
Frankreich
Italien
Russland

Geplant sind außerdem:

Niederlande
Polen
Spanien (hier sind die Steuereinstellungen bereits vorbereitet, es fehlen nur noch die Übersetzungen).

Prinzipiell können mit wenig Aufwand weitere Länder unterstützt werden. Für andere EU-Länder stehen alle Mechanismen bereit, ebenso für Länder mit einfacher Steuerkonfiguration (wie z.B. Russland). Den meisten Aufwand macht die Übersetzung der Texte, CMS-Seiten und Emails. Eine Anleitung zur Konfiguration für weitere Länder haben wir auf GitHub (in Englisch) bereit gestellt.

Was unterscheidet MageSetup außerdem von GermanSetup?

Wir haben die Internationalisierung weiter geführt und unterstützen jetzt auch verschiedensprachige StoreViews, für die die CMS-Inhalte und die Email-Templates jeweils separat automatisiert angelegt werden. Es gibt die Seiten "Impressum", "AGB" und "Datenschutz" also beispielsweise einmal in Deutsch und einmal in Englisch. Das zugehörige erweiterte Formular sieht wie folgt aus:

Wegen der Vielzahl der Funktionen ist es schwierig, weitere einzelne Features herauszupicken. So wurde beispielsweise die Steuerkonfiguration deutlich vereinfacht, was es ermöglicht, einfacher neue Länder zu konfigurieren.

Gibt es eine Übersicht, was MageSetup alles kann?

Eine der Schwächen von GermanSetup war die mangelhafte Dokumentation. Dies haben wir mit MageSetup jetzt geändert: auf GitHub gibt es jetzt eine vollständige und laufend aktualisierte Liste aller Funktionen von MageSetup mit vielen Screenshots. So werden z.B. die einzelnen Elemente des Setup-Formulars ausführlich erläutert und alle weiteren Funktionen mit deren Konfigurationsmöglichkeiten im Detail vorgestellt.

Sollte ich für bestehende oder neue Projekte MageSetup oder GermanSetup einsetzen?

Da die Entwicklung von GermanSetup eingestellt wurde, empfehlen wir, ab sofort nur noch MageSetup für neue Shops einzusetzen. Es beinhaltet alle Funktionen von GermanSetup und wird laufend gepflegt und weiterentwickelt. Bestehende Shops müssen nicht zwingend auf MageSetup aktualisiert werden, wenn sie stabil laufen. Sollten jedoch Fehler mit GermanSetup auftreten, empfehlen wir als erstes immer ein Update auf MageSetup.

Wie funktioniert ein Update von GermanSetup auf MageSetup?

Ganz einfach: MageSetup installieren. GermanSetup wird automatisch deaktiviert und alle Einstellungen werden automatisch übernommen. Die GermanSetup-Dateien können, müssen aber nicht, anschließend entfernt werden. Sollten Anpassungen an den von GermanSetup genutzten Templates gemacht worden sein, müssen die Pfade der angepassten Dateien bearbeitet werden. Aus src/app/design/frontend/base/default/template/germansetup/ wird src/app/design/frontend/base/default/template/magesetup/, aus src/skin/frontend/base/default/css/germansetup/ wird src/skin/frontend/base/default/css/magesetup/. Sollten Rewrites von GermanSetup-Klassen gemacht worden sein, müssen diese natürlich ebenfalls angepasst werden.

Wo kann ich MageSetup herunterladen?

Die bevorzugte und immer aktuelle Quelle ist grundsätzlich GitHub. Das Repository findet sich unter https://github.com/firegento/firegento-magesetup. Im Branch "master" befindet sich dabei immer die stabile, gründlich getestete Version. Wer die neuesten Features und Korrekturen ebenfalls nutzen will, nutzt den meistens ebenfalls recht stabilen Branch "development". Per Composer kann das Modul über den Namen "firegento/magesetup" integriert werden, sofern das Repository packages.firegento.com eingebunden ist. Seit Kurzem ist MageSetup ebenfalls auf MagentoConnect verfügbar.

Was mache ich, wenn ich Probleme mit MageSetup habe?

Bitte: keine Emails an mich oder andere Entwickler des Moduls schreiben. Ein schlechter Ort für sepzifische Anfragen ist auch der Kommentarbereich zu diesem Beitrag. Support leisten wir ausschließlich auf GitHub - bitte hierfür einen neuen Eintrag unter https://github.com/firegento/firegento-magesetup/issues einstellen. Bitte beachten: wir entwickeln das Modul in unserer unbezahlten Freizeit und geben auch Support ausschließlich auf freiwilliger Basis. Es besteht also kein Anspruch auf Antworten, Fehlerbehebungen oder ähnliches. Bei freundlichen Anfragen kümmern wir uns häufig allerdings dennoch darum.

Wer steckt hinter MageSetup?

Wie schon bei GermanSetup sind wir eine Gruppe von Magento-Entwicklern (Freelancer, Angestellte, Selbstständige), die das Projekt in ihrer Freizeit laufend weiterentwickeln. Wir haben uns unter dem Namen FireGento zusammen geschlossen, um nicht-kommerzielle Software für die Community zu entwickeln - seit letztem Jahr sind wie auch ein eingetragener Verein. Die aktivsten Entwickler seit der Umstellung auf MageSetup sind Rouven Rieker (ITABS GmbH), Sylvain Rayé (Diglin GmbH), Francesco Marangi (mzentrale GmbH) und Andreas von Studnitz (integer_net GmbH).

Wie kann ich MageSetup unterstützen?

Falls ein gefundener Fehler selbst korrigiert werden konnte oder ein neues Feature hinzugefügt wurde, freuen wir uns über einen Pull Request über GitHub. Eine einzige Bedingung haben wir dafür: der Pull Request sollte immer auf dem Branch "development" basieren. Auch über neue Ideen können wir uns gern im Rahmen der GitHub-Issues austauschen. Viele FireGento-Mitglieder trifft man auch auf den Magento-Hackathons, die ca. dreimal im Jahr im deutschsprachigen Raum stattfinden. Der nächste ist für Anfang 2014 in Oldenburg geplant, ein genauer Termin steht derzeit noch nicht fest.