Search by

schachbulle / contao-dsblayout-bundle

Samson1964

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

Statistics

Installs: 1

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

1.0.0 2026-11-19 12:31 UTC

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-… oder nocols enthält,
  • die im Feld simple_columns eine Spalteneinstellung haben,
  • vom Typ tabcontrol, tributeslist oder timelineSliderElement,
  • vom Typ html, wenn der HTML-Code selbst nocols oder col-… 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

  1. In der composer.json des Servers den psr-4-Eintrag "Redmind\\Helper\\": "src/redmind/Helper/" entfernen und RedmindHelper aus app/ContaoManagerPlugin.php (bzw. config/bundles.php) austragen.
  2. 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.
  3. Datenbank-Aktualisierung im Backend prüfen: Für tl_article und tl_content darf 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.