Changelog
Guppy und alle Guppy-Plugins folgen strikt Semantic Versioning. Diese Seite beschreibt die Versionierungs-Regeln, den Update-Workflow und wo du die offiziellen Release-Notes findest.
SemVer-Schema
MAJOR.MINOR.PATCHMAJOR: Breaking Changes
Inkompatible Änderungen, die manuelle Anpassungen erfordern:
- Template-Blöcke entfernt oder umbenannt
- Konfigurationsoptionen entfernt
- CSS-Klassen fundamental geändert
- JavaScript-Plugin-APIs geändert
Beispiel: 2.6.1 → 3.0.0 (MINOR und PATCH werden auf 0 zurückgesetzt).
MINOR: Neue Features
Rückwärts-kompatible Funktionalitäten:
- Neue Template-Blöcke oder Properties
- Neue Konfigurationsoptionen
- Zusätzliche CSS-Klassen
- Neue JavaScript-Plugin-Features
Beispiel: 2.1.3 → 2.2.0 (PATCH wird auf 0 zurückgesetzt).
PATCH: Bugfixes
Rückwärts-kompatible Fehlerbehebungen:
- Styling-Korrekturen
- Performance-Optimierungen
- Nicht-funktionale Verbesserungen
Beispiel: 2.1.1 → 2.1.2.
Release-Notes pro Plugin
Da Guppy aus mehreren Plugins besteht, lebt der Changelog je Plugin als CHANGELOG.md im jeweiligen GitLab-Repository. Die Doku-Seite Changelog (EN) aggregiert diese Dateien nächtlich, eine Seite pro Plugin. Format und Regeln: CHANGELOG-CONVENTION.md im Doku-Repository.
Ein Plugin ohne CHANGELOG.md, oder mit einer Datei ohne Einträge, erscheint nicht in der Aggregation. Der Sync-Lauf meldet das als Warnung, damit es im Repository nachgezogen wird.
| Plugin | Repository | Changelog |
|---|---|---|
| DmfGuppyTheme | theme-guppy | Releases |
| DmfAutoStyleguide | plugin-auto-styleguide | noch ohne Einträge |
| DmfSplideSlider | plugin-splide-slider | Releases |
| CmsBlockLibrary | plugin-cms-block-library | Releases |
| CmsCustomElements | plugin-cms-custom-elements | Releases |
| CmsCustomGrids | plugin-cms-custom-grids | noch ohne Einträge |
| CmsDynamicGrid | plugin-cms-dynamic-grid | Releases |
| CmsImportExport | plugin-cms-import-export | noch ohne Einträge |
| EmotionworldElements | plugin-guppy-emotionworld-elements | Releases |
| CustomCheckout | plugin-custom-checkout | fehlt im Repository |
| CheckoutEnhancements | plugin-guppy-checkout-enhancements | fehlt im Repository |
| DropdownNavigation | plugin-dropdown-navigation | Releases |
| ImageFocalPoint | plugin-image-focal-point | noch ohne Einträge |
| MarkdownEditor | plugin-markdown-editor | noch ohne Einträge |
Shopware-Update-Workflow
1. Shopware UPGRADE.md analysieren
Shopware liefert pro Release eine UPGRADE.md mit Breaking Changes:
curl -s https://raw.githubusercontent.com/shopware/platform/trunk/UPGRADE.md2. Guppys Release-Notes lesen
Lies den Guppy-Changelog für jede Version zwischen deiner und der Zielversion. Einträge mit der Markierung Visual change with default config ändern das Aussehen eines Shops, der die Standard-Theme-Konfiguration nutzt, und beschreiben jeweils, wie du das bisherige Aussehen behältst. UPGRADE-3.0.md im Theme-Repository listet alles, was sich in 3.0.0 ändert oder entfällt (siehe Vorbereitung auf Guppy 3.0).
Der frühere Scanner guppy:upgrade:scan wurde in 2.7.0 entfernt.
3. Update durchführen
composer update dmf/sw6-guppy-theme
bin/console plugin:refresh
bin/console plugin:update DmfGuppyTheme
bin/console theme:compile
bin/console cache:cleartheme:compile pflicht
Nach Plugin-Update muss theme:compile laufen, sonst werden weder neue SCSS-Werte noch Twig-Änderungen wirksam.
Vorbereitung auf Guppy 3.0
Guppy 3.0.0 wechselt auf Shopware 6.8, entfernt, was 2.x als deprecated markiert hat, und ändert Standardwerte, die das Aussehen ändern. Jede 2.x-Minor, die eine solche Änderung ankündigt, trägt sie in UPGRADE-3.0.md im Theme-Repository ein: was sich ändert, warum, wen es betrifft und wie du dich anpasst. Bisher angekündigt (2.9.0):
| Änderung | Was du jetzt tun solltest |
|---|---|
Die Skip-Link-Felder guppy-header-skip-to-main-content, -main-nav, -search stehen standardmäßig auf true | Nichts, wenn du Skip-Links willst. Um sie ausgeschaltet zu lassen, speichere für die drei Felder false: Die Theme-Verwaltung speichert nur geänderte Werte, schalte also jedes Feld ein, speichere, schalte es aus und speichere noch einmal. |
Das Theme-Feld guppy-login-register und der Tab Login & Registrierung entfallen, eine Migration entfernt den gespeicherten Wert | Entferne theme_config('guppy-login-register') aus Child-Theme-Templates und das Feld aus der theme.json eines Child-Themes. Das Feld hat seit 2.7.0 keine Wirkung. |
21 ungenutzte Storefront-Snippet-Keys entfallen: breadcrumb.backLabel, listing.showDetails, footer.languages.ariaLabel und 18 Keys unter component.checkout.{cart,progress,register,quantity,products}.* | Ein Child-Theme oder Plugin, das einen davon mit |trans ausgibt, definiert den Text unter einem eigenen Key. Die vollständige Liste steht in UPGRADE-3.0.md, Abschnitt "Removals". checkout.summaryNetPrice und component.checkout.cart.discountApply bleiben. |
Deprecated Code trägt @deprecated tag:v3.0.0; deprecated theme.json-Felder weisen in ihrem Label oder Hilfetext darauf hin.
Branching-Strategie als Update-Quelle
| Branch / Tag | Wann verwenden |
|---|---|
getaggte Version (z. B. v2.6.0) | Produktion |
RC-Tag (z. B. v2.8.0-rc1) | Testen kommender Shopware-Major-Versionen |
main | bewusst „neueste stabile Version” ohne Tag, selten in Produktion |
stage | nur Test-Umgebungen |
Details: Mitwirken.
Hotfixes
Außerhalb der regulären Releases werden kritische Bugfixes als PATCH veröffentlicht. Details zum Workflow: Mitwirken → Hotfixes.
Verwandt
- Mitwirken: Branch-Strategie und Workflow.
- Architektur: Console-Commands.