PHPackages                             blueroger/cms-extensions - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. blueroger/cms-extensions

ActiveShopware-platform-plugin

blueroger/cms-extensions
========================

Extended CMS blocks with flexible column widths and configurable CSS classes for shopping experiences.

2.0.0(1mo ago)00MITJavaScriptPHP ^8.2CI passing

Since Mar 12Pushed 1mo agoCompare

[ Source](https://github.com/blueroger/BluerogerCmsExtensions)[ Packagist](https://packagist.org/packages/blueroger/cms-extensions)[ RSS](/packages/blueroger-cms-extensions/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)Dependencies (4)Versions (4)Used By (0)

> **Shopware 6.7?** See branch [`2.x`](https://github.com/blueroger/BluerogerCmsExtensions/tree/2.x) for the Shopware 6.7 version (Meteor App).

BluerogerCmsExtensions
======================

[](#bluerogercmsextensions)

Shopware 6 Plugin mit erweiterten CMS-Blöcken für flexible Spaltenlayouts.

---

Funktionen
----------

[](#funktionen)

- **blr-two-col-flex** — Zwei-Spalten-Block mit wählbarer Spaltenbreite (50/50, 33/66, 66/33, 25/75, 75/25) und CSS-Klassen pro Spalte
- **blr-three-col-flex** — Drei-Spalten-Block mit wählbarer Spaltenbreite (33/33/33, 25/50/25, 50/25/25, 25/25/50) und CSS-Klassen pro Spalte

Alle Blöcke sind:

- Konfigurierbar über das Shopware CMS-Backend
- Mit einstellbaren Bootstrap-Breakpoints — ab welcher Bildschirmbreite Spalten nebeneinander erscheinen
- Mit Deinstallations-Schutz — Inhalte bleiben auch nach Plugin-Entfernung erhalten (siehe unten)

[![Block-Picker](screenshots/block-picker.png)](screenshots/block-picker.png)

---

Voraussetzungen
---------------

[](#voraussetzungen)

AnforderungVersionShopware6.6.xPHP^8.2---

Installation
------------

[](#installation)

**Über das Backend (empfohlen):**ZIP-Datei aus dem [GitHub-Release](https://github.com/blueroger/BluerogerCmsExtensions/releases) herunterladen, dann im Shopware-Backend unter *Einstellungen → System → Plugins → Plugin hochladen* installieren und aktivieren.

**Über die Konsole:**

```
bin/console plugin:refresh
bin/console plugin:install --activate BluerogerCmsExtensions
bin/console cache:clear
```

**Hinweis für Entwicklungsumgebungen:**Nach Änderungen am JavaScript-Code der Administration muss neu gebaut werden:

```
shopware-cli extension build custom/plugins/BluerogerCmsExtensions
# Anschließend js/ und css/ aus Resources/public/administration/assets/ nach
# Resources/public/administration/js/ und css/ kopieren (klassisches Format)
bin/console cache:clear
```

---

Blöcke
------

[](#blöcke)

### blr-two-col-flex — Zwei Spalten (flexibel)

[](#blr-two-col-flex--zwei-spalten-flexibel)

[![blr-two-col-flex Konfiguration](screenshots/two-col-flex.png)](screenshots/two-col-flex.png)

Zwei-Spalten-Block mit konfigurierbarer Spaltenbreite.

**Konfiguration:**

- Spaltenbreite: 50/50, 33/66, 66/33, 25/75, 75/25
- Responsive Breakpoint: ab welcher Bildschirmbreite Spalten nebeneinander erscheinen (MD ab 768px / LG ab 992px / XL ab 1200px) — Standard: MD
- CSS-Klasse links — beliebige Bootstrap- oder eigene CSS-Klassen direkt am Spalten-Div
- CSS-Klasse rechts — beliebige Bootstrap- oder eigene CSS-Klassen direkt am Spalten-Div

**Slot-Kompatibilität:** `image-text` (Shopware Core) — siehe Abschnitt "Deinstallations-Schutz"

---

### blr-three-col-flex — Drei Spalten (flexibel)

[](#blr-three-col-flex--drei-spalten-flexibel)

[![blr-three-col-flex Konfiguration](screenshots/three-col-flex.png)](screenshots/three-col-flex.png)

Drei-Spalten-Block mit konfigurierbarer Spaltenbreite.

**Konfiguration:**

- Spaltenbreite: 33/33/33, 25/50/25, 50/25/25, 25/25/50
- Responsive Breakpoint: ab welcher Bildschirmbreite Spalten nebeneinander erscheinen (MD ab 768px / LG ab 992px / XL ab 1200px) — Standard: MD
- CSS-Klasse links, mitte, rechts — beliebige Bootstrap- oder eigene CSS-Klassen direkt am Spalten-Div

**Slot-Kompatibilität:** `text-three-column` (Shopware Core) — siehe Abschnitt "Deinstallations-Schutz"

---

Deinstallations-Schutz
----------------------

[](#deinstallations-schutz)

Shopware-Plugins, die eigene CMS-Block-Typen einführen, haben ein grundsätzliches Problem: Wenn das Plugin deinstalliert wird, kennt Shopware die Block-Typen nicht mehr. CMS-Seiten die diese Blöcke enthalten werden unbrauchbar — Layouts brechen, Inhalte sind nicht mehr erreichbar.

Dieses Plugin löst das Problem mit einer automatischen Migration:

**Bei der Deinstallation** sucht das Plugin alle CMS-Blöcke im System die es selbst erstellt hat und schreibt den Block-Typ auf einen kompatiblen Standard-Shopware-Block um:

Plugin-BlockFallback-Block (Shopware Core)`blr-two-col-flex``image-text``blr-three-col-flex``text-three-column`Die Slot-Namen der Plugin-Blöcke wurden bewusst identisch zu den Core-Blöcken gewählt (`left`, `right` bzw. `left`, `center`, `right`). Das bedeutet: alle Inhalte der Slots bleiben erhalten und werden nach der Deinstallation weiterhin korrekt gerendert.

**Bei einer Neuinstallation** erkennt das Plugin die migrierten Blöcke anhand eines internen Markers und stellt die Original-Block-Typen wieder her — inklusive der gespeicherten Konfiguration (Spaltenbreite, CSS-Klassen). Inhalte bleiben vollständig erhalten.

**Wichtig:** Diese Migration läuft nur bei einer echten Deinstallation, nicht bei Plugin-Updates. Beim Deaktivieren des Plugins ohne Deinstallation bleibt alles unverändert.

---

Entwicklung
-----------

[](#entwicklung)

### Lokales Setup

[](#lokales-setup)

```
composer install
```

### Qualitätssicherung

[](#qualitätssicherung)

```
# Automatische Formatierung (PSR-12)
composer cs-fix

# Statische Analyse (PHPStan Level 8) + CS-Check
composer qa
```

### Nach Änderungen im Plugin

[](#nach-änderungen-im-plugin)

```
# Nach JavaScript/Admin-Änderungen
shopware-cli extension build custom/plugins/BluerogerCmsExtensions
# Anschließend gebaute Dateien ins klassische Format kopieren (js/ und css/)
bin/console cache:clear

# Nach PHP/Twig-Änderungen
bin/console cache:clear
```

### CI/CD

[](#cicd)

GitHub Actions prüft bei jedem Push:

- `composer validate`
- PHPStan Level 8 (via Extension Verifier)
- PHP CS Fixer (via Extension Verifier)
- ESLint für Administration-JavaScript (via Extension Verifier)

---

Shopware 6.7
------------

[](#shopware-67)

Dieses Plugin ist für Shopware 6.6 entwickelt und getestet.

Shopware 6.7 stellt das Admin-Erweiterungsmodell grundlegend um — Plugins verwenden dort eine Meteor-App (iframe + Meteor Admin SDK) statt des bisherigen Script-Injection-Modells. Eine 6.7-kompatible Version erfordert eine komplette Neuimplementierung der Admin-Seite und ist als separates Projekt geplant.

---

Entwickelt mit KI
-----------------

[](#entwickelt-mit-ki)

Dieses Plugin wurde vollständig mit KI-Unterstützung entwickelt — von der Architektur bis zur fertigen Codebasis.

**Blueroger:** Konzept, Anforderungen, Scope-Entscheidungen, manuelle Tests, Build-Workflow und finale Freigaben
**Claude AI:** Architektur, technische Entscheidungen, Dokumentation und Qualitätssicherung
**Cursor:** Implementierung — Code-Generierung auf Basis der Architektur-Vorgaben

---

Lizenz
------

[](#lizenz)

[MIT](LICENSE)

###  Health Score

37

—

LowBetter than 83% of packages

Maintenance89

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~3 days

Total

3

Last Release

53d ago

Major Versions

1.0.0 → 2.0.02026-03-17

### Community

Maintainers

![](https://www.gravatar.com/avatar/076f78a813b67d3b444c429acdce3e4b86542aeccd7f52936ccc8b11bf023e8f?d=identicon)[blueroger](/maintainers/blueroger)

###  Code Quality

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/blueroger-cms-extensions/health.svg)

```
[![Health](https://phpackages.com/badges/blueroger-cms-extensions/health.svg)](https://phpackages.com/packages/blueroger-cms-extensions)
```

###  Alternatives

[shopware/storefront

Storefront for Shopware

684.2M148](/packages/shopware-storefront)[shopware/administration

Administration frontend for the Shopware Core

413.9M75](/packages/shopware-administration)[shopware/production

178190.0k](/packages/shopware-production)[frosh/tools

Provides some basic things for managing the Shopware Installation

79709.7k2](/packages/frosh-tools)[shopware/elasticsearch

Elasticsearch for Shopware

153.6M8](/packages/shopware-elasticsearch)[kiener/mollie-payments-plugin

Mollie Payments

6257.6k](/packages/kiener-mollie-payments-plugin)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
