Download the PHP package schachbulle/contao-spoiler-bundle without Composer
On this page you can find all versions of the php package schachbulle/contao-spoiler-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download schachbulle/contao-spoiler-bundle
More information about schachbulle/contao-spoiler-bundle
Files in schachbulle/contao-spoiler-bundle
Package contao-spoiler-bundle
Short Description Inhaltselemente für aufklappbare Spoiler auf Basis von details und summary: als Einzelelement mit Text oder als Umschlag um beliebige andere Inhaltselemente.
License LGPL-3.0-or-later
Homepage https://github.com/Samson1964/contao-spoiler-bundle
Informations about the package contao-spoiler-bundle
Spoiler
Inhaltselemente für Contao, die Inhalte hinter einer anklickbaren Überschrift verbergen
und per Klick aufklappen. Die Elemente sind dem Akkordeon des Contao-Kerns nachempfunden,
kommen aber ohne JavaScript aus: Sie geben die HTML-Elemente details und summary aus,
die jeder aktuelle Browser von sich aus auf- und zuklappt.
Es gibt drei Elemente in der Gruppe Spoiler:
| Element | Zweck |
|---|---|
| Einzelelement | Ein Spoiler mit Überschrift und einem Text aus dem Rich-Text-Editor. |
| Umschlag Anfang | Öffnet einen Spoiler, in dem alle folgenden Inhaltselemente liegen. |
| Umschlag Ende | Schließt den Spoiler wieder. |
Mit dem Umschlag lassen sich beliebige Inhaltselemente verbergen, etwa Bilder, Tabellen oder Downloads. Das Backend rückt die eingeschlossenen Elemente in der Liste ein, wie beim Akkordeon.
Voraussetzungen
- Contao 4.13 oder Contao 5
- PHP 7.4 oder neuer (geprüft mit PHP 8.4)
Installation
Über den Contao Manager nach „Spoiler" suchen, oder auf der Konsole:
Danach die Datenbank aktualisieren (Contao Manager oder contao:migrate), damit die
beiden neuen Spalten in tl_content angelegt werden.
Bedienung
Im Artikel ein neues Inhaltselement anlegen und in der Gruppe Spoiler den Typ wählen.
- Überschrift ist der immer sichtbare Text, mit dem sich der Spoiler öffnet und
schließt. Das Feld ist Pflicht und darf einfaches HTML enthalten, etwa
<em>. - Anfangs geöffnet zeigt den Spoiler beim Laden der Seite bereits aufgeklappt.
Beim Einzelelement kommt darunter das Textfeld mit dem Rich-Text-Editor. Beim Umschlag folgen zwischen „Umschlag Anfang" und „Umschlag Ende" die Inhaltselemente, die verborgen werden sollen.
Markup
Einzelelement:
Umschlag (der Inhalt dazwischen stammt aus den eingeschlossenen Elementen):
Das Attribut open erscheint nur, wenn „Anfangs geöffnet" gesetzt ist. Eine unter
„Experteneinstellungen" vergebene ID oder Klasse landet am details-Element.
Gestaltung
Das Bundle liefert bewusst kein Stylesheet mit; Browser stellen details und summary
ohne weiteres Zutun bedienbar dar. Für das Theme genügt meist:
Wer anderes Markup braucht, legt eigene Fassungen der Templates ce_spoilerSingle.html5,
ce_spoilerStart.html5 und ce_spoilerStop.html5 im Template-Verzeichnis der
Installation ab oder wählt sie je Element unter „Template". Die Templates kennen die
Variablen $this->summary (Überschrift), $this->open (Anfangszustand) und beim
Einzelelement $this->text.
Prüfstand
tests/pruefstand.php bootet eine vorhandene Contao-Installation, in der das Bundle
eingebunden ist, prüft Anmeldung, Paletten und Beschriftungen und rendert die drei
Elemente im Frontend- und im Backend-Kontext:
Das Skript ist gegen Contao 4.13.58 und Contao 5.7.7 mit PHP 8.4.24 gelaufen.
Lizenz
LGPL-3.0-or-later — siehe LICENSE.
Autor
Frank Hoppe, schachbulle.de