schachbulle / contao-dsblayout-bundle
Layout-Helfer für das Theme des Deutschen Schachbundes: Bootstrap-Spalten um Inhaltselemente, zentrierte H1-Überschriften und Hintergrundbilder für Artikel.
Package info
github.com/Samson1964/contao-dsblayout-bundle
Type:contao-bundle
pkg:composer/schachbulle/contao-dsblayout-bundle
Requires
- php: ^7.4 || ^8.0
- contao/core-bundle: ^4.13
- symfony/config: ^5.4
- symfony/dependency-injection: ^5.4
- symfony/http-kernel: ^5.4
Requires (Dev)
- contao/manager-plugin: ^2.3.1
- phpunit/phpunit: ^9.5
Suggests
None
Provides
None
Conflicts
- contao/core: *
- contao/manager-plugin: <2.0 || >=3.0
Replaces
None
This package is auto-updated.
Last update: 2026-11-19 14:22:23 UTC
README
Kleine Eingriffe in die Frontend-Ausgabe, auf die das Theme der Website des Deutschen Schachbundes angewiesen ist. Ohne dieses Bundle fällt dort das Spaltenraster auseinander und die Artikel-Hintergrundbilder fehlen.
Ursprünglich von der redmind GmbH für den DSB entwickelt („Helper“), seit 2020 mehrfach gepflegt und hier als eigenständiges Contao-Bundle verpackt.
Was das Bundle tut
Bootstrap-Spalten. Jedes Inhaltselement direkt in einem Artikel wird in
<div class="col-12"> eingepackt. Ausgenommen sind Elemente,
- deren CSS-Klasse schon
col-…odernocolsenthält, - die im Feld
simple_columnseine Spalteneinstellung haben, - vom Typ
tabcontrol,tributeslistodertimelineSliderElement, - vom Typ
html, wenn der HTML-Code selbstnocolsodercol-…enthält.
H1-Formatierung. Enthält eine H1-Überschrift //, bekommt sie die Klasse
centered, und der Teil ab // wird in ein <span> gesetzt.
Artikel-Hintergrund. Im Artikel gibt es die Legende „DSB Einstellungen“ mit
Hintergrundbild, Bildgröße und Hintergrundfarbe (hell/grau). Das
Bild wird als CSS mit Media-Queries für alle Bildgrößen in das Artikel-Template
geschrieben ($this->cssstuff, $this->style2).
Inhaltselemente. HTML in Überschriften ist erlaubt; tl_content bekommt
zusätzliche Indizes auf cteAlias und module.
Helper::generateCssString(). Für Templates, die ein Bild als
::before-Hintergrund ausgeben, z. B. im News-Teaser:
<style><?= \Schachbulle\ContaoDsblayoutBundle\Helper\Helper::generateCssString($this->picture, 'newsteaser_'.$this->id) ?></style>
Der alte Aufruf \Redmind\Helper\Helper\Helper::generateCssString(…) bleibt
über einen Klassen-Alias lauffähig.
Voraussetzungen
- PHP 7.4 oder 8.x
- Contao 4.13
Installation
Solange das Paket nicht auf Packagist steht, das GitHub-Repository als Quelle in
die composer.json des Projekts eintragen:
"repositories": [ { "type": "vcs", "url": "https://github.com/Samson1964/contao-dsblayout-bundle" } ]
Danach:
composer require schachbulle/contao-dsblayout-bundle:^1.0 vendor/bin/contao-console cache:clear --env=prod
Umstieg von src/redmind/Helper
- In der
composer.jsondes Servers den psr-4-Eintrag"Redmind\\Helper\\": "src/redmind/Helper/"entfernen undRedmindHelperausapp/ContaoManagerPlugin.php(bzw.config/bundles.php) austragen. - Den Ordner
src/redmind/Helper/erst löschen, wenn auch das Kalenderkarten-Bundle installiert ist – die Karte hat bisher die Modelle aus diesem Ordner benutzt. - Datenbank-Aktualisierung im Backend prüfen: Für
tl_articleundtl_contentdarf nichts vorgeschlagen werden.
Die Hooks wurden bisher über $GLOBALS['TL_HOOKS'] registriert und laufen jetzt
über Service-Tags. Bleibt der alte Helper versehentlich parallel eingebunden,
laufen sie doppelt – dann landet jedes Inhaltselement in zwei col-12-Hüllen.
Tests
composer install vendor/bin/phpunit
Lizenz
Proprietär. Der ursprüngliche Code stammt von der redmind GmbH und wurde für den Deutschen Schachbund e.V. entwickelt; die Urheberrechtsvermerke sind erhalten.