README

Ein modernes Contao 5.3+ Bundle, das Timeline-Container Content-Elemente für strukturierte Timeline-Layouts bereitstellt.

Beschreibung

Das Xippo Timeline Bundle erweitert Contao um 4 spezielle Inhaltselemente im modernen Fragment Controller-Format, die es ermöglichen, normale Contao-Inhaltselemente in Container zu bündeln und diese in einer Timeline-Struktur darzustellen.

Features

• ✅ Contao 5.3+ kompatibel - Verwendet moderne Fragment Controllers mit PHP 8+ Attributes
• ✅ Twig Templates - Moderne Twig-basierte Template-Engine
• ✅ Wrapper Elements - Korrekte Backend-Visualisierung mit Start/Stop-Elementen
• ✅ CSS-ID/Klassen-Support - Vollständige Anpassbarkeit über Standard Contao-Felder
• ✅ Mehrsprachig - Deutsche und englische Backend-Labels

Inhaltselemente

Das Bundle stellt folgende 4 Inhaltselemente zur Verfügung:

1. Timeline Item Start (time_item_start)
   Öffnet einen Timeline-Item Container mit CSS-Klasse ce_timeItemStart

2. Timeline Item End (time_item_end)
   Schließt einen Timeline-Item Container

3. Timeline Inner Start (time_item_inner_start)
   Öffnet einen inneren Timeline Container mit den CSS-Klassen ce_columns ce_timeItemInnerStart

4. Timeline Inner End (time_item_inner_end)
   Schließt einen inneren Timeline Container

HTML-Struktur

Die Elemente erzeugen folgende HTML-Struktur:

<div class="ce_timeItemStart">
    <div class="ce_columns ce_timeItemInnerStart">
        <!-- Hier können normale Contao-Inhaltselemente eingefügt werden -->
    </div>
    <div class="ce_columns ce_timeItemInnerStart">
        <!-- Weitere Contao-Inhaltselemente -->
    </div>
</div>

Systemanforderungen

• PHP ^8.1
• Contao ^5.3 (verwendet moderne Fragment Controllers)
• Symfony ^6.0

Installation

Via Composer

composer require xippo/timeline-bundle

Das Bundle registriert sich automatisch über den Contao Manager Plugin.

Aktuelle Version prüfen

# Installierte Version anzeigen
composer show xippo/timeline-bundle

# Verfügbare Updates prüfen
composer outdated xippo/timeline-bundle

# Update auf neueste Version
composer update xippo/timeline-bundle

Hinweis: Das Bundle verwendet derzeit "minimum-stability": "dev" für die neuesten Entwicklungsversionen. Stable Releases werden über Packagist verteilt.

Verwendung

1. Nach der Installation sind die Timeline-Inhaltselemente in der Kategorie "Timeline" im Backend verfügbar
2. Erstellen Sie zunächst ein "Timeline Item Start"-Element
3. Fügen Sie beliebige Contao-Inhaltselemente hinzu
4. Verwenden Sie "Timeline Inner Start" und "Timeline Inner End" um innere Container zu erstellen
5. Schließen Sie mit einem "Timeline Item End"-Element ab

Beispiel-Layout:

1. Timeline Item Start
2. Timeline Inner Start
3. Galerie-Element
4. Timeline Inner End
5. Timeline Inner Start
6. Text-Element
7. Timeline Inner End
8. Timeline Item End

Templates

Das Bundle verwendet moderne Twig-Templates:

• templates/content_element/time_item_start.html.twig
• templates/content_element/time_item_end.html.twig
• templates/content_element/time_item_inner_start.html.twig
• templates/content_element/time_item_inner_end.html.twig

Diese können durch eigene Templates im Theme überschrieben werden.

Backend-Funktionalität

• Wrapper-Visualisierung: Die Elemente werden im Backend als Start/Stop-Container angezeigt
• DCA-Paletten: Jedes Element hat eine eigene Palette mit Standard-Contao-Feldern
• Mehrsprachige Labels: Deutsche und englische Beschreibungen verfügbar

Migration von älteren Versionen

Dieses Bundle verwendet die moderne Contao 5.3+ Architektur:

• Fragment Controllers statt ContentElement-Klassen
• PHP Attributes für Service-Registrierung
• Twig statt Legacy HTML5-Templates
• Moderne DCA- und Translation-Struktur

Lizenz

MIT License

Autor

Xippo - https://xippo.ch

Support

Bei Fragen oder Problemen erstellen Sie bitte ein Issue im entsprechenden Repository.