Theme-Code-Paket
Jeder Shop erhält pro integriertem Theme ein Theme-Code-Paket. Sie öffnen es im Code-Editor wie jede Theme-Kopie. Ein Paket enthält nur:
Theme-JavaScript wird auf Checkout-, Anmelde- oder Kontoseiten nie geladen.
Code-Sections im visuellen Editor
Jedesections/<name>.liquid mit einem {% schema %}-Block erscheint in der Liste Section hinzufügen des visuellen Editors unter Theme-Code. Ihr Einstellungsformular stammt aus dem Schema, sodass eine Code-Section vollständig ohne Code bearbeitbar bleibt. Neu anordnen, ausblenden, duplizieren und löschen funktionieren wie bei integrierten Sections.
Wenn Sie das Schema im Code ändern, wird das Formular sofort aktualisiert. Neue Einstellungen erhalten ihre Standardwerte; entfernte Einstellungen werden ignoriert und ihre Werte beibehalten.
Section-IDs in CSS
In einer Code-Section istsection.id gleich code:<name>. Der : bricht CSS-Selektoren (#{{ section.id }}-yearly:checked wird stillschweigend verworfen) und #id-Abfragen. Verwenden Sie section.css_id (code-<name>) in {% style %} und in id=- / for=-Attributen oder {{ value | css_id }}. Der Code-Editor sowie MCP validate / save_draft warnen dort vor einer unveränderten section.id; die Schnellkorrektur des Editors lautet section.css_id verwenden.
Labels, Radio-/Checkbox-Umschalter, <details> und Auswahlfelder funktionieren auf der Arbeitsfläche des visuellen Editors. Um Links und Buttons anzuklicken, aktivieren Sie Interagieren in der oberen Leiste (oder drücken Sie I oder halten Sie Alt gedrückt).
Code einer integrierten Section bearbeiten
Wählen Sie bei einer integrierten Section Code bearbeiten, um sie herauszulösen. Ihr Liquid-Zwilling wird mit demselben Markup und denselben Klassennamen in Ihr Paket kopiert, sodass sie identisch aussieht und ihre Einstellungen behält. Auf integrierte Version zurücksetzen stellt die ursprüngliche Section wieder her.Commerce und Checkout
Code-Sections verkaufen mit App-Blöcken. Sie benötigen kein Skript:buy_nowundcheckout_buttonführen standardmäßig zur Checkout-Seite.mode: 'embed'öffnet das Checkout-Popup über Ihrer Seite.add_to_cartundcart_countöffnen die Warenkorb-Schublade der Plattform. Das Warenkorb-Badge des Themes bleibt synchron.reviews_widgetundpowered_byfunktionieren in Code-Sections nicht.currency_selectorbenötigtcurrencies: 'USD,EUR'.- Code-Sections verfügen über
shop,collections,all_products,requestundlocalization. Sie haben keinproduct,collectionoderroutes. window.PapelShipwird nach dem Laden der Seite geladen, auf Seiten, deren Code-Sections einen App-Block oder eindata-ps-Binding enthalten. Warten Sie inassets/theme.jsaufpapelship:sdk-ready.
Veröffentlichen
Live-Seiten zeigen die veröffentlichte Version des Pakets. Gespeicherte Dateien erscheinen nur in den Vorschauen des visuellen Editors und des Code-Editors.- Bearbeiten und speichern Sie Dateien im Code-Editor oder lassen Sie einen KI-Agenten Entwürfe speichern.
- Prüfen Sie die Vorschau.
- Klicken Sie im Code-Editor oder im visuellen Editor auf Veröffentlichen. Es ist derselbe Button, und er zeigt an, wie viele Änderungen noch nicht veröffentlicht sind.
Über MCP verbundene KI-Agenten können Paketdateien speichern, aber niemals veröffentlichen. Siehe KI-Agenten (MCP).