Shipments zu Shiptastic Migration

Mit dem Update auf 3.19.0 erhält die Sendungsintegration in Germanized einen neuen Namen: Shiptastic. Wir haben uns dazu entschieden, die mittlerweile sehr umfangreiche Funktionalität für die Versandoptimierung in Germanized in ein separates Plugin auszulagern, damit auch Anwender davon profitieren können, die Germanized nicht verwenden. Technisch hat sich kaum etwas verändert – allerdings werden die neuen Bezeichnungen (Präfixe usw.) auch für Hooks & Filter und natürlich auch im Namespace des Codes verwendet. Shiptastic ist also ein Fork der ursprünglichen Sendungsintegration.

Zudem planen wir in einer zukünftigen Version von Germanized (voraussichtlich 4.0), Shiptastic nicht wie aktuell noch der Fall direkt im Installationspaket mitzuliefern, sondern stattdessen die Installation optional anzubieten (ähnlich wie mit dem One Stop Shop Plugin). Damit verschlankt sich Germanized für Shopbetreiber, die die Sendungsintegration nicht benötigen.

Ablauf der Migration

Bei der Installation des Updates auf 3.19.0 wird deine Installation automatisch migriert:

Die Datenbanktabellen mit dem alten Präfix wp_woocommerce_gzd_ werden automatisch umbenannt in wp_woocommerce_stc_
Bei bestimmten Spalten, u.a. gzd_shipment_item_id in der Tabelle shipment_itemmeta wird der Präfix gzd_ ebenfalls durch stc_ ersetzt.
In der Tabelle woocommerce_gzd_shipments (neu: woocommerce_stc_shipments) wird in der Spalte shipment_status der Präfix gzd- aus der Statusbezeichnung entfernt. Der Präfix war nie wirklich notwendig und wird nicht mehr verwendet.
In der Tabelle woocommerce_gzd_shipping_providermeta (neu: woocommerce_stc_shipping_providermeta) wird im meta_value ebenfalls der Status-Präfix gzd- für relevante Einträge entfernt.
In der wp_options wird der Präfix im option_name woocommerce_gzd_shipments_ durch woocommerce_shiptastic_ und woocommerce_gzd_dhl_ durch woocommerce_shiptastic_dhl_ ersetzt.
Der Ordner wp-content/uploads/wc-gzd-shipments-{suffix} wird umbenannt in wc-shiptastic-{suffix}

Probleme bei der Migration

Wie bei jeder Migration kann es auch in diesem Fall zu Problemen kommen – das automatische Umbenennen der Tabellen kann z.B. mangels Berechtigungen des Datenbank-Benutzers fehlschlagen. Unter WooCommerce > Status > Germanized werden euch, insofern es Probleme bei der Migration gab, unter Migration zu Shiptastic entsprechende Details angezeigt. Dort kannst du über den entsprechenden Button die Migration testweise auch erneut durchführen – möglicherweise behebt das die Probleme bereits und unter WooCommerce > Status > Germanized > Migration zu Shiptastic werden dir anschließend keine Fehlermeldungen mehr angezeigt.

Alle meinen Sendungen sind „weg“

Kein Sorge: Deine Sendungen sind nicht weg. Insofern die alte Datenbanktabelle nicht erfolgreich umbenannt werden konnte, werden dir deine alten Sendungen ggf. aktuell nicht angezeigt. Dann heißt es Ruhe bewahren und die Fehlermeldung bei der Migration auslesen. Möglicherweise muss die Migration erneut angestoßen werden oder es muss eine manuelle Migration erfolgen.

Download der alten Labels funktioniert nicht mehr

Wenn der Download alter Labels nicht mehr funktioniert, kann das daran liegen, dass der Upload-Ordner nicht korrekt migriert werden konnte. Konkret wurde bei der Migration versucht den alten Ordnername unter wp-content/uploads/wc-gzd-shipments-{suffix} in wc-shiptastic-{suffix} umzubennen. Den aktuell verwendeten Upload-Ordner kannst du unter WooCommerce > Status > Germanized > Shiptastic Upload-Ordner auslesen. Das ist der Ordner, in dem Shiptastic nach den Labels sucht.

Du solltest jetzt prüfen, ob unter wp-content/uploads noch andere Ordner entweder mit dem Präfix wc-gzd-shipments-{suffix} oder mit einem anderen Suffix von wc-shiptastic- vorliegen, in dem offenbar alte/viele PDF-Dateien enthalten sind. Das deutet daraufhin, dass das der alte „originale“ Ordner ist. Wenn du den Ordner ausfindig gemacht hast, kannst du entweder den Inhalt in den aktuellen Upload-Ordner verschieben (falls schon neue Uploads im neuen Ordner vorliegen, die du erhalten willst) oder den alten Upload-Ordner einfach umbenennen (vorher den neuen Ordner löschen) in den Ordner-Namen, den du unter WooCommerce > Status > Germanized ausgelesen hast.

Manuelle Migration

Wenn die automatische Migration nicht möglich ist, kannst du natürlich auch eine manuelle Migration vornehmen. Dafür wird dir, falls bei der Migration Fehler aufgetreten sind, unter WooCommerce > Status > Germanized > Migration zu Shiptastic eine Anleitung bereitgestellt. Im Zweifel solltest du dich an einen Systemadministrator oder deinen Hoster wenden um die Änderungen durchzuführen.

Was hat sich geändert?

Für dich als Anwender hat sich nichts geändert. Die Funktionalität ist gleich geblieben. Entwickler bzw. Anwender, die bestimmte Snippets nutzen, sollten ihren Code überprüfen und zeitnah aktualisieren. Im Folgenden stellen wir ein paar Beispiele bereit, was sich technisch geändert hat:

Hooks & Filter, z.B. wird aus woocommerce_gzd_shipment_base_country nun woocommerce_shiptastic_shipment_base_country
Namen der Funktionen, aus wc_gzd_get_shipment_statuses() wird wc_stc_get_shipment_statuses()
Der Namespace hat sich verändert, d.h. aus Vendidero\Germanized\Shipments wird Vendidero\Shiptastic
Die Datenbanktabellen sowie der Upload-Ordner haben ebenfalls neue Präfixe