Shopify-Theme aktualisieren, ohne Anpassungen zu verlieren

Ein Shopify-Theme zu aktualisieren ersetzt seine Dateien durch eine neue Version. Ob deine Arbeit diesen Tausch übersteht, hängt ganz davon ab, wo die Arbeit lebt. Manche Anpassungen werden unangetastet übernommen; andere sind genau das, was ersetzt wird. Sobald du weißt, was was ist, hört das Aktualisieren auf, ein Glücksspiel zu sein.

Das ist der Hub für das gesamte Thema. Er erklärt, was ein Update tatsächlich mit deinen Dateien macht, die eine Regel, die vorhersagt, was übersteht, und wo es für deine konkrete Aufgabe weitergeht — vorher sichern, verschwundenen Code diagnostizieren oder zu einem komplett anderen Theme wechseln.

Was ein Theme-Update tatsächlich macht

Im Shopify-Admin ist ein Theme ein Bündel aus Dateien: .liquid-Templates und -Sektionen, CSS, JavaScript und eine Reihe von Einstellungen, die die Entscheidungen festhalten, die ein Händler im Theme-Editor getroffen hat. Wenn du ein Theme „aktualisierst" — eine neuere Version von Dawn installierst oder eines Bezahl-Themes aus dem Theme Store —, patcht Shopify deine bestehenden Dateien nicht Zeile für Zeile. Es veröffentlicht eine frische Kopie des Theme-Codes aus dem neuen Release.

Genau diese Unterscheidung ist die ganze Geschichte. Ein versionsverwalteter Merge würde versuchen, deine handgemachten Änderungen zu behalten und den neuen Code darüberzulegen. Eine frische Kopie tut das nicht: Die Dateien des neuen Releases sind, was du bekommst, und alles, was du der alten Kopie von Hand hinzugefügt hast, ist schlicht kein Teil des neuen Bündels.

Shopify verbessert das. Themes, die den neueren Update-Ablauf unterstützen, können deine Theme-Editor-Einstellungen automatisch in die aktualisierte Version übertragen. Aber dieser Ablauf überträgt Einstellungen und Inhalte — nicht Code, den du in .liquid- oder CSS-Dateien getippt hast. Die Lücke zwischen „Einstellungen" und „Code" ist genau dort, wo Anpassungen verloren gehen.

Die eine Regel, die vorhersagt, was übersteht

Fast jedes Theme-Update lässt sich mit einer einzigen Regel durchdenken:

Änderungen, die du im Theme-Editor gemacht hast, überstehen. Änderungen, die du durch Bearbeiten von Theme-Dateien gemacht hast, nicht. Alles, was von einer App gerendert wird, übersteht, weil sein Code nie im Theme war.

Zerlege das in die drei Kategorien, die es impliziert:

• Theme-Editor-Einstellungen und -Inhalte — überstehen. Sektions-Anordnungen, Text, den du in Einstellungen getippt hast, Bilder, die du gewählt hast, Farben, Schriften und die Blöcke, die du hinzugefügt und umsortiert hast, werden als Daten gespeichert, nicht als Code. Ein unterstütztes Update überträgt sie. Dazu zählen Inhalte in flexiblen, eingebauten Sektionen wie Rich Text, Bild mit Text und Einstellungen von Custom Liquid.
• Direkte Bearbeitungen an Theme-Dateien — überstehen nicht. Eine neue Sektionsdatei, die du zu sections/ hinzugefügt hast, ein Snippet, das du in snippets/ erstellt hast, CSS, das du in assets/theme.css eingefügt hast, oder ein Kniff an theme.liquid sind alle Teil des Codes, den das Update ersetzt. Sie sind aus der neuen Kopie verschwunden, es sei denn, du wendest sie erneut an.
• App-gerenderte Sektionen — überstehen. Eine Sektion, die von einer App über eine Theme App Extension geliefert wird, lebt außerhalb der Dateien deines Themes. Ein Theme-Update tauscht Theme-Dateien; es berührt nie die App, sodass die Sektion und ihre Einstellungen intakt durchkommen.

Wenn du dir sonst nichts merkst, merke dir die Grenze: Editor = Daten, die übernommen werden; Datei-Bearbeitungen = Code, der ersetzt wird.

Warum der Verlust die Leute überrascht

Der Grund, warum das Händler kalt erwischt, ist, dass beide Arten von Änderung auf der Live-Seite identisch aussehen. Eine eigene Ankündigungsleiste, die du durch Bearbeiten von theme.liquid gebaut hast, und eine, die du im Editor konfiguriert hast, rendern für einen Besucher gleich. Der Unterschied zeigt sich erst Monate später, zum Update-Zeitpunkt, wenn die eine übersteht und die andere verschwindet.

Es ist auch üblich, zu vergessen, welche Änderungen Code waren. „Ich habe eine Größentabelle hinzugefügt" kann heißen, dass ein Händler eine eingebaute Sektion konfiguriert hat (sicher) oder dass ein Entwickler eine neue .liquid-Datei geschrieben hat (gefährdet) — und die Person, die auf Aktualisieren klickt, ist oft nicht die, die den Code geschrieben hat. Deshalb zählt ein schriftliches Verzeichnis deiner eigenen Dateien mehr als jede einzelne Technik.

Wie es weitergeht

Die Cluster-Guides unten nehmen sich jeden Teil davon der Reihe nach vor. Beginne mit dem, der zu deiner Situation passt:

• Löscht ein Shopify-Theme-Update deine Anpassungen? — die direkte Antwort, mit der genauen Liste dessen, was übernommen und was ersetzt wird.
• Theme-Anpassungen vor dem Update sichern — die Duplizieren-und-Exportieren-Routine, die du vor dem Klick auf Aktualisieren ausführst.
• Ein Theme-Update hat meinen eigenen Code entfernt — so bekommst du ihn zurück — bereits verschwundene Arbeit wiederherstellen, aus Backups, älteren Theme-Versionen oder Git.
• Shopify-Themes wechseln, ohne deine Arbeit zu verlieren — der Umzug zu einem anderen Theme, bei dem selbst Editor-Einstellungen nicht automatisch mitkommen.

Der Workflow, der das Problem ganz vermeidet

Die disziplinierte Antwort ist Prozess: vor dem Aktualisieren duplizieren, eine dokumentierte Liste jeder eigenen Datei führen und diese Liste auf das neue Theme erneut anwenden. Das funktioniert, und die Cluster-Guides oben geben dir die genauen Schritte.

Es gibt auch eine strukturelle Antwort. Wenn eine Sektion etwas ist, auf das du über Theme-Updates und -Wechsel hinweg angewiesen bist, nimmt es sie komplett aus dem Gefahrenbereich, sie aus einer App statt aus einer Theme-Datei zu rendern — weil ein Theme-Update nur Theme-Dateien ersetzt. Diesen Kompromiss (übersteht ein Update vs. übersteht eine Deinstallation) legt datei-basierte vs. app-basierte Sektionen ehrlich dar, und es ist der Ansatz, den SectionGuard nutzt, damit deine Sektionen jedes Theme-Update und jeden -Wechsel ohne Wiederanwenden-Schritt durchstehen.

Keine der beiden Routen ist im Abstrakten „die richtige". Ein einmaliger Kniff an einem Theme, das du selten anfasst, kann ruhig von Hand geschrieben und erneut angewendet werden. Eine Sektion, von der dein Shop abhängt, ist sicherer außerhalb des Themes gerendert. Die Guides hier helfen dir, beides mit offenen Augen zu tun.