包简介

Teaser-Boxen zentral verwalten für das Contao CMS

README 文档

README

Contao-Bundle zur zentralen Verwaltung von Teaser-Boxen mit Teaser-Gruppen und Kategorien. Inhalte werden einmalig als Teaser angelegt, in Gruppen zusammengefasst und über Seiten-Whitelist oder Seiten-Blacklist gezielt im Frontend ausgespielt.

Anforderungen

Abhängigkeit	Version
PHP	^8.3
Contao Core Bundle	^5.3

Installation

composer require srhinow/teaser-manager

Nach der Installation die Datenbank-Migration ausführen:

php bin/console contao:migrate

Backend

Das Bundle registriert zwei Backend-Module unter der Gruppe Inhalte:

Teaser (`tm_teaser`)

Verwaltung einzelner Teaser-Datensätze. Jeder Teaser enthält interne Metadaten (Bezeichnung, Kategorie, Status) und wird über untergeordnete Inhaltselemente (tl_content) mit Inhalten befüllt.

Tabellen: tl_teaser, tl_content

Teaser-Gruppen (`tm_teaser_group`)

Zusammenstellung ausgewählter Teaser zu einer Gruppe sowie Zuweisung an Seiten. Von hier aus können auch die Teaser-Kategorien verwaltet werden.

Tabellen: tl_teaser_group, tl_teaser_categories

Datenbankstruktur

`tl_teaser`

Spalte	Typ	Beschreibung
`id`	`int(10) unsigned PK AI`	Primärschlüssel
`tstamp`	`int(10) unsigned`	Zeitstempel letzte Änderung
`dateAdded`	`int(10) unsigned`	Erstellungsdatum
`internTitle`	`varchar(255)`	Interne Bezeichnung (Pflichtfeld)
`cssID`	`varchar(255)`	CSS-ID und CSS-Klassen
`category`	`varchar(25)`	Kategoriezuordnung (Pflichtfeld)
`teaser_template`	`varchar(32)`	Zugewiesenes Template (Standard: `tm_teaser_default`)
`featured`	`char(1)`	Hervorgehoben-Flag
`active`	`char(1)`	Aktiv/Inaktiv-Status

Indizes: id (PRIMARY), active (INDEX)

`tl_teaser_group`

Spalte	Typ	Beschreibung
`id`	`int(10) unsigned PK AI`	Primärschlüssel
`tstamp`	`int(10) unsigned`	Zeitstempel letzte Änderung
`dateAdded`	`int(10) unsigned`	Erstellungsdatum
`internTitle`	`varchar(255)`	Interne Bezeichnung (Pflichtfeld)
`inContainer`	`varchar(64)`	Teaser-Kategorie (→ `tl_teaser_categories.name`, Pflichtfeld)
`teaser`	`blob`	Ausgewählte Teaser-IDs (serialisiert)
`custom_pages`	`char(1)`	Aktiviert Seiten-Whitelist
`pages`	`blob`	Seiten-Whitelist (serialisierte Seiten-IDs)
`exceptions`	`char(1)`	Aktiviert Seiten-Blacklist
`exceptions_pages`	`blob`	Seiten-Blacklist (serialisierte Seiten-IDs)
`featured`	`char(1)`	Hervorgehoben-Flag
`active`	`char(1)`	Aktiv/Inaktiv-Status

Seitenzuweisungs-Logik:

custom_pages = 0: Gruppe wird auf allen Seiten angezeigt.
custom_pages = 1: Gruppe wird nur auf den in pages gelisteten Seiten angezeigt.
exceptions = 1: Die in exceptions_pages gelisteten Seiten werden ausgeschlossen.

`tl_teaser_categories`

Spalte	Typ	Beschreibung
`id`	`int unsigned PK AI`	Primärschlüssel
`sorting`	`int unsigned`	Sortierreihenfolge
`tstamp`	`int unsigned`	Zeitstempel
`modify`	`int unsigned`	Reserviertes Änderungsdatum
`name`	`varchar(255)`	Kategoriename (Pflichtfeld)
`alias`	`varchar(128)`	Alias/Slug

Standard-Kategorien (automatisch bei erster Migration angelegt):

Alias	Name
`sidebar`	Seitenleiste
`msgbar`	Hinweisbereich
`main_teaser`	Teaser im Hauptbereich

Inhaltselemente

`tm_teaser_element` — Teaser-Element

Wird innerhalb eines Teaser-Datensatzes als Inhaltselement verwendet. Ermöglicht das Befüllen mit Überschrift, Text, Bild und Link.

Zusatzfelder in tl_content:

Feld	Typ	Beschreibung
`addTeaserImage`	`boolean`	Bild aktivieren (klappt Subpalette `singleSRC` auf)
`addLink`	`boolean`	Link aktivieren (klappt `url`, `titleText`, `target` auf)
`imgSize`	`varchar(64)`	Bildgröße

Template: tm_teaser_element.html.twig

`tm_teaser` — Einzelner Teaser

Content-Element: Gibt einen per Dropdown ausgewählten Teaser im Frontend aus.

Template: tm_teaser.html.twig

`tm_teaser_group` — Teaser-Gruppe

Content-Element: Gibt alle Teaser einer ausgewählten Teaser-Gruppe aus.

Template: tm_group.html.twig

Frontend-Modul

`teaser_group_module` — Teaser-Gruppe

Liest automatisch alle aktiven Teaser-Gruppen der gewählten Kategorie für die aktuelle Seite und rendert diese. Die Whitelist/Blacklist-Seitenzuweisung wird vollautomatisch ausgewertet.

Zusatzfelder in tl_module:

Feld	Typ	Beschreibung
`tm_inContainer`	`varchar(64)`	Teaser-Kategorie (→ `tl_teaser_categories.name`)
`tm_teaser_groups`	`int(10)`	Alternative: Direkte Auswahl einer Teaser-Gruppe

Template: tm_group.html.twig

Templates

`tm_teaser_element.html.twig`

Rendert ein einzelnes Teaser-Inhaltselement.

Variable	Typ	Beschreibung
`class`	`string`	CSS-Klassen (inkl. `featured` wenn hervorgehoben)
`headline`	`string`	Überschrift
`hl`	`string`	Überschriften-Tag (z. B. `h2`)
`text`	`string`	Teaser-Text (HTML, `\\|raw` ausgeben)
`addLink`	`bool`	Link aktiv?
`url`	`string`	Link-URL
`titleText`	`string`	Link-Titel (title-Attribut)
`target`	`bool`	In neuem Tab öffnen?
`addTeaserImage`	`bool`	Bild aktiv?
`teaserImage`	`string`	Gerendertes Bild-HTML (`\\|raw`)

`tm_teaser.html.twig`

Wrapper für das Content-Element tm_teaser. Gibt {{ teaser | raw }} aus.

`tm_group.html.twig`

Wrapper für Content-Element tm_teaser_group und das Frontend-Modul. Gibt alle Teaser der Gruppe als {{ teaser | raw }} aus.

Migrationen

`PopulateTeaserCategoriesMigration`

Legt beim ersten Start die drei Standard-Kategorien in tl_teaser_categories an, sofern die Tabelle leer ist.

`TeaserToContentElementMigration`

Migriert bestehende Legacy-Teaser-Daten (alte Felder headline, text, image, url, linkTitle direkt in tl_teaser) automatisch in neue tm_teaser_element-Inhaltselemente in tl_content.

Changelog

Alle Änderungen sind in CHANGELOG.md dokumentiert.

Lizenz

LGPL-3.0-or-later

Autor

Sven Rhinow — sr-tag.de
Support: kservice@sr-tag.de
Quellcode: gitlab.com/srhinow/teaser-manager

srhinow/teaser-manager 适用场景与选型建议

srhinow/teaser-manager 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 202 次下载、GitHub Stars 达 0，最近一次更新时间为 2019 年 06 月 12 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「contao」「box」「teaser」「teaser-group」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 srhinow/teaser-manager 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 srhinow/teaser-manager 我们能提供哪些服务？

定制开发 / 二次开发

基于 srhinow/teaser-manager 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

与 srhinow/teaser-manager 相关的其它包

同方向 / 同关键字的高下载量 PHP Composer 包推荐，方便对比选型：

contao/core 0

Contao Open Source CMS

stev/spout-bundle 0

Symfony 4/5 Bundle for box spout excel library v3

marekpetras/yii2-ajax-box-widget 17

Ajax Box widget for Yii 2 Framework.

rsm/rsm-googlerecaptcha-modul 3

Diese Contao 4 Erweiterung stellt Google reCAPTCHA V2 in Form eines neuen Formularfeldes im Formulargenerator bereit. This extension provides Google reCAPTCHA V2 in the form of a new form field in the form generator of Contao Open Source CMS.

spaf/simputils 3

Simple minimal but useful set of utils (properties, strings, datetimes, etc.)

heimrichhannot/contao-teaser-bundle 0

A contao teaser content element, that provides the ability to link the element with pages, articles, files, downloads or external urls.

srhinow/teaser-manager

包简介

关键字：

README 文档

README

Anforderungen

Installation

Backend

Teaser (`tm_teaser`)

Teaser-Gruppen (`tm_teaser_group`)

Datenbankstruktur

`tl_teaser`

`tl_teaser_group`

`tl_teaser_categories`

Inhaltselemente

`tm_teaser_element` — Teaser-Element

`tm_teaser` — Einzelner Teaser

`tm_teaser_group` — Teaser-Gruppe

Frontend-Modul

`teaser_group_module` — Teaser-Gruppe

Templates

`tm_teaser_element.html.twig`

`tm_teaser.html.twig`

`tm_group.html.twig`

Migrationen

`PopulateTeaserCategoriesMigration`

`TeaserToContentElementMigration`

Changelog

Lizenz

Autor

srhinow/teaser-manager 适用场景与选型建议

与 srhinow/teaser-manager 相关的其它包

统计信息

GitHub 信息

其他信息

srhinow/teaser-manager

包简介

关键字：

README 文档

README

Anforderungen

Installation

Backend

Teaser (tm_teaser)

Teaser-Gruppen (tm_teaser_group)

Datenbankstruktur

tl_teaser

tl_teaser_group

tl_teaser_categories

Inhaltselemente

tm_teaser_element — Teaser-Element

tm_teaser — Einzelner Teaser

tm_teaser_group — Teaser-Gruppe

Frontend-Modul

teaser_group_module — Teaser-Gruppe

Templates

tm_teaser_element.html.twig

tm_teaser.html.twig

tm_group.html.twig

Migrationen

PopulateTeaserCategoriesMigration

TeaserToContentElementMigration

Changelog

Lizenz

Autor

srhinow/teaser-manager 适用场景与选型建议

与 srhinow/teaser-manager 相关的其它包

统计信息

GitHub 信息

其他信息

Teaser (`tm_teaser`)

Teaser-Gruppen (`tm_teaser_group`)

`tl_teaser`

`tl_teaser_group`

`tl_teaser_categories`

`tm_teaser_element` — Teaser-Element

`tm_teaser` — Einzelner Teaser

`tm_teaser_group` — Teaser-Gruppe

`teaser_group_module` — Teaser-Gruppe

`tm_teaser_element.html.twig`

`tm_teaser.html.twig`

`tm_group.html.twig`

`PopulateTeaserCategoriesMigration`

`TeaserToContentElementMigration`