README

Timeline events as a content element in TYPO3. Events with a name, short description, and date range are managed in the TYPO3 backend; the frontend renders a responsive two-column timeline with alternating left/right cards.

Features

• Events with name, perex, description (RTE), date from, and optional date to
• Events sorted by date (newest first)
• Alternating left/right card layout with a central vertical line
• Customizable templates and styling

Requirements

• PHP 8.3+
• TYPO3 13.4 or 14.x

Installation

composer require marekskopal/typo3-timeline

After installation, run the database analyser in the TYPO3 Install Tool to create the required tables.

Setup

Include the TypoScript Set Timeline in your site package or via the site configuration sets.

Backend Setup

Create Timeline Event records on the page where the content element is placed:

• Title — event title (required)
• Subtitle — optional subtitle shown below the title
• Perex — short summary shown on the card
• Description — full RTE description
• Date From — event start date (required, used for sorting)
• Date To — event end date (optional)

Then add the Timeline content element to the same page.

Customization

Templates

Override templates by setting custom paths in TypoScript:

plugin.tx_mstimeline.view.templateRootPaths.10 = EXT:your_extension/Resources/Private/Templates/MsTimeline/
plugin.tx_mstimeline.view.partialRootPaths.10  = EXT:your_extension/Resources/Private/Partials/MsTimeline/
plugin.tx_mstimeline.view.layoutRootPaths.10   = EXT:your_extension/Resources/Private/Layouts/MsTimeline/

Styling

The extension includes minimal CSS. Key classes:

License

GPL-2.0-or-later