Skip to content

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 ​

text
MAJOR.MINOR.PATCH

MAJOR: 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.

PluginRepositoryChangelog
DmfGuppyThemetheme-guppyReleases
DmfAutoStyleguideplugin-auto-styleguidenoch ohne Einträge
DmfSplideSliderplugin-splide-sliderReleases
CmsBlockLibraryplugin-cms-block-libraryReleases
CmsCustomElementsplugin-cms-custom-elementsReleases
CmsCustomGridsplugin-cms-custom-gridsnoch ohne Einträge
CmsDynamicGridplugin-cms-dynamic-gridReleases
CmsImportExportplugin-cms-import-exportnoch ohne Einträge
EmotionworldElementsplugin-guppy-emotionworld-elementsReleases
CustomCheckoutplugin-custom-checkoutfehlt im Repository
CheckoutEnhancementsplugin-guppy-checkout-enhancementsfehlt im Repository
DropdownNavigationplugin-dropdown-navigationReleases
ImageFocalPointplugin-image-focal-pointnoch ohne Einträge
MarkdownEditorplugin-markdown-editornoch ohne Einträge

Shopware-Update-Workflow ​

1. Shopware UPGRADE.md analysieren ​

Shopware liefert pro Release eine UPGRADE.md mit Breaking Changes:

bash
curl -s https://raw.githubusercontent.com/shopware/platform/trunk/UPGRADE.md

2. 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 ​

bash
composer update dmf/sw6-guppy-theme
bin/console plugin:refresh
bin/console plugin:update DmfGuppyTheme
bin/console theme:compile
bin/console cache:clear

theme: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):

ÄnderungWas du jetzt tun solltest
Die Skip-Link-Felder guppy-header-skip-to-main-content, -main-nav, -search stehen standardmäßig auf trueNichts, 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 WertEntferne 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 / TagWann verwenden
getaggte Version (z. B. v2.6.0)Produktion
RC-Tag (z. B. v2.8.0-rc1)Testen kommender Shopware-Major-Versionen
mainbewusst „neueste stabile Version” ohne Tag, selten in Produktion
stagenur Test-Umgebungen

Details: Mitwirken.

Hotfixes ​

Außerhalb der regulären Releases werden kritische Bugfixes als PATCH veröffentlicht. Details zum Workflow: Mitwirken → Hotfixes.

Verwandt ​