Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen der Seite angezeigt.

--- plugins:tcb-aktuell:start [27.09.2026 11:51] – admin
+++ plugins:tcb-aktuell:start [27.09.2026 12:26] (aktuell) – [Zugehörige Dateien] admin
@@ Zeile 28: / Zeile 28: @@
 ===== Zweck =====
-TCB Aktuell stellt auf TheCruiserBlog eine kompakte Hinweisbox für wichtige oder aktuelle Informationen bereit.
+TCB Aktuell stellt auf TheCruiserBlog aktuelle Hinweise und Informationen bereit.
+Mehrere Meldungen können unabhängig voneinander verwaltet, aktiviert und zeitlich gesteuert werden. Für die Ausgabe berücksichtigt das Plugin nur Meldungen, die zum jeweiligen Zeitpunkt aktiv und gültig sind.
 Typische Einsatzmöglichkeiten sind:
@@ Zeile 34: / Zeile 36: @@
   * Hinweise auf neue Inhalte
   * aktuelle Meldungen
-  * Hinweise auf besondere Projekte
+  * Hinweise auf besondere Projekte oder Ereignisse
+  * zeitlich begrenzte Informationen
   * Verweise auf externe Seiten oder Aktionen
-Die Ausgabe ist bewusst unabhängig vom verwendeten WordPress-Theme umgesetzt.
+Die Ausgabe erfolgt über einen Shortcode und ist unabhängig vom verwendeten WordPress-Theme.
 ===== Funktionsumfang =====
-Version 1.0.0 unterstützt:
+Version 2.0.0 unterstützt:
-  * Aktivieren und Deaktivieren der Meldung
+  * Verwaltung mehrerer Meldungen
-  * optionalen Titel
+  * individuelles Aktivieren und Deaktivieren von Meldungen
-  * Meldungstext
+  * Titel und Meldungstext
-  * optionalen Link
+  * optionale Verlinkung
-  * optionalen Linktext
+  * Startdatum und Startzeit
-  * automatischen Standard-Linktext ''Mehr erfahren →''
+  * optionales Enddatum und optionale Endzeit
-  * responsive Darstellung
+  * automatische Berücksichtigung des Gültigkeitszeitraums
-  * eigenes Backend-Menü ''TCB Aktuell''
+  * Prioritäten **Normal**, **Wichtig** und **Dringend**
+  * Kennzeichnung der Priorität durch Symbole
+  * zufällige Auswahl einer aktiven Meldung
+  * Ausgabe mehrerer aktiver Meldungen
+  * Slider-/Wechselfunktion
+  * Überblendung zwischen Meldungen
+  * Pfeilnavigation
+  * einstellbares Autoplay
+  * einstellbare Wiederholung (Loop)
+  * vorbereitete Farbanpassung für eine zukünftige Dark-/Light-Darstellung
+  * responsive Ausgabe
+  * Verwaltung über das WordPress-Backend
-Ist keine Meldung eingetragen oder die Ausgabe deaktiviert, wird keine Hinweisbox angezeigt.
+Für die Ausgabe werden nur Meldungen berücksichtigt, die aktiviert sind und deren festgelegter Gültigkeitszeitraum zum jeweiligen Zeitpunkt erfüllt ist.
+Ist keine gültige Meldung vorhanden, erfolgt keine Ausgabe.
 ===== Bedienung =====
-Die Meldung wird im WordPress-Backend unter:
+Die Verwaltung erfolgt im WordPress-Backend über den Menüpunkt:
 **TCB Aktuell**
-verwaltet.
+Version 2.0.0 ermöglicht die Verwaltung mehrerer voneinander unabhängiger Meldungen.
-Zur Verfügung stehen folgende Felder:
+Für eine Meldung stehen unter anderem folgende Angaben zur Verfügung:
 ^ Feld ^ Funktion ^
-| Meldung anzeigen | Aktiviert oder deaktiviert die Ausgabe |
+| Aktiv | Legt fest, ob die Meldung grundsätzlich für die Ausgabe berücksichtigt wird |
-| Titel | Optionaler Titel der Meldung |
+| Titel | Titel der Meldung |
-| Meldung | Eigentlicher Informationstext |
+| Meldung | Inhalt der Meldung |
-| Link | Optionales Ziel für einen weiterführenden Link |
+| Link | Optionales Ziel für eine weiterführende Verlinkung |
-| Linktext | Optionaler Text des Links |
+| Linktext | Optionaler Text für die Verlinkung |
+| Startdatum / Startzeit | Legt fest, ab wann die Meldung ausgegeben werden darf |
+| Enddatum / Endzeit | Legt optional fest, bis wann die Meldung ausgegeben werden darf |
+| Priorität | Einstufung als **Normal**, **Wichtig** oder **Dringend** |
+Das Ende einer Meldung ist optional. Dadurch können Meldungen ohne festgelegtes Ablaufdatum verwendet werden.
+Ob eine Meldung tatsächlich ausgegeben wird, ergibt sich aus ihrem Aktiv-Status und dem festgelegten Gültigkeitszeitraum.
 ===== Einbindung =====
-Die Ausgabe erfolgt über den Shortcode:
+Die Ausgabe von TCB Aktuell erfolgt über den Shortcode:
 <code>
@@ Zeile 79: / Zeile 99: @@
 </code>
-Der Shortcode kann innerhalb des Seiteninhalts an der gewünschten Position eingefügt werden.
+Der Shortcode kann innerhalb des Seiteninhalts an der gewünschten Position eingebunden werden.
-Auf der Startseite von TheCruiserBlog befindet sich die Hinweisbox zwischen dem Einleitungsbereich und den vier zentralen Themenbereichen.
+Auf der Startseite von TheCruiserBlog befindet sich TCB Aktuell zwischen dem Einleitungsbereich und den vier zentralen Themenbereichen.
+Welche Meldungen ausgegeben werden, ermittelt das Plugin anhand der aktiven und zum jeweiligen Zeitpunkt gültigen Meldungen sowie der festgelegten Ausgabeoptionen.
 ===== Darstellung =====
-Die Gestaltung orientiert sich am Erscheinungsbild von TheCruiserBlog.
+Die Darstellung von TCB Aktuell orientiert sich am Erscheinungsbild von TheCruiserBlog und passt sich in die bestehende Seitengestaltung ein.
 Kennzeichnend sind:
-  * dunkler Hintergrund
+  * klare Trennung der einzelnen Meldungsinhalte
-  * orangefarbener Akzent
+  * visuelle Kennzeichnung der Prioritäten **Normal**, **Wichtig** und **Dringend**
-  * Kennzeichnung ''TCB AKTUELL''
+  * Prioritätssymbole zur schnellen Erkennbarkeit
-  * klar getrennte Darstellung von Titel, Meldung und Link
+  * Unterstützung mehrerer Meldungen
-  * responsive Anpassung für kleinere Bildschirmgrößen
+  * optionaler Wechsel zwischen Meldungen
+  * Überblendung als Darstellungseffekt
+  * optionale Pfeilnavigation
+  * automatische Wiedergabe und Wiederholung entsprechend der gewählten Einstellungen
+  * Anpassung der Farben an helle und dunkle Darstellungen
+  * responsive Anpassung an unterschiedliche Bildschirmgrößen
 ===== Produktiver Einsatz =====
-TCB Aktuell wird seit dem **24.08.2026** produktiv auf der Startseite von TheCruiserBlog eingesetzt.
+TCB Aktuell wird seit dem **24.08.2026** produktiv auf TheCruiserBlog eingesetzt.
-Die Hinweisbox befindet sich zwischen dem Einleitungsbereich und den vier zentralen Themenbereichen der Startseite.
+Aktuell wird **Version 2.0.0** verwendet.
-{{:plugins:tcb-aktuell:tcb-aktuell_v1-0-0_live_startseite.png?1000|TCB Aktuell v1.0.0 im produktiven Einsatz auf der Startseite von TheCruiserBlog}}
+Die Ausgabe ist auf der Startseite zwischen dem Einleitungsbereich und den vier zentralen Themenbereichen eingebunden.
-**TCB Aktuell v1.0.0 im produktiven Einsatz auf der Startseite von TheCruiserBlog.**
+Durch die Verwaltung mehrerer Meldungen, die zeitliche Steuerung und die unterschiedlichen Darstellungsoptionen kann TCB Aktuell flexibel für aktuelle und zeitlich begrenzte Informationen eingesetzt werden.
 ===== Plugin-Struktur =====
+TCB Aktuell 2.0.0 ist modular aufgebaut.
 <code>
@@ Zeile 111: / Zeile 137: @@
 ├── tcb-aktuell.php
 ├── TCB_Aktuell_v1.0_Dokumentation.md
-└── assets/
+├── TCB_Aktuell_v2.0_Dokumentation.md
-    └── css/
+│
-        └── tcb-aktuell.css
+├── assets/
+│   ├── css/
+│   │   └── tcb-aktuell.css
+│   │
+│   ├── icons/
+│   │   ├── priority-dringend.svg
+│   │   ├── priority-normal.svg
+│   │   └── priority-wichtig.svg
+│   │
+│   └── js/
+│       └── tcb-aktuell.js
+│
+└── includes/
+    ├── class-tcb-aktuell-meldung.php
+    └── class-tcb-aktuell-repository.php
 </code>
+Die Hauptdatei ''tcb-aktuell.php'' bildet den Einstiegspunkt des Plugins.
+Die fachliche und technische Logik ist teilweise in eigene Klassen unter ''includes/'' ausgelagert. Stylesheets, JavaScript und die Symbole für die Prioritätskennzeichnung befinden sich getrennt unter ''assets/''.
+Die Entwicklungsdokumentationen der Versionen 1.0 und 2.0 werden im Plugin-Verzeichnis mitgeführt.
 ===== Technische Umsetzung =====
-Die Einstellungen werden über die WordPress Options API gespeichert.
+TCB Aktuell 2.0.0 verwendet für die persistente Speicherung weiterhin die WordPress Options API.
-Verwendete Optionen:
+Alle Meldungen werden gemeinsam als Array in einer WordPress-Option gespeichert:
 <code>
-tcb_aktuell_enabled
+tcb_aktuell_meldungen
-tcb_aktuell_title
-tcb_aktuell_message
-tcb_aktuell_url
-tcb_aktuell_linktext
 </code>
-Eine eigene Datenbanktabelle wird nicht benötigt.
+Eine eigene Datenbanktabelle wird nicht verwendet.
+Die Klasse ''TCB_Aktuell_Repository'' kapselt den Zugriff auf die gespeicherten Meldungsdaten und bildet die Schnittstelle zwischen der WordPress-Speicherung und den fachlichen Meldungsobjekten.
+Zu ihren Aufgaben gehören unter anderem:
+  * Laden und Speichern der Meldungsdaten
+  * Erzeugen von ''TCB_Aktuell_Meldung''-Objekten aus den gespeicherten Rohdaten
+  * Hinzufügen neuer Meldungen
+  * Suchen und Aktualisieren vorhandener Meldungen
+  * Löschen von Meldungen
+  * automatische Vergabe eindeutiger numerischer Meldungs-IDs
+  * Ermittlung der zum jeweiligen Zeitpunkt aktiven Meldungen
+  * Sortierung aktiver Meldungen nach Priorität und Startzeitpunkt
+Aktive Meldungen werden zunächst nach ihrer Priorität sortiert:
+  - **Dringend**
+  - **Wichtig**
+  - **Normal**
+Besitzen mehrere Meldungen dieselbe Priorität, wird die Meldung mit dem neueren Startzeitpunkt zuerst berücksichtigt.
-Die Eingaben werden vor der Speicherung bereinigt und bei der Ausgabe entsprechend escaped.
+Die numerischen Meldungs-IDs werden automatisch vergeben. Gelöschte IDs werden nicht erneut verwendet.
+Für Datums- und Zeitangaben wird die in WordPress konfigurierte Zeitzone verwendet.
 ===== Installation =====
-Das Plugin steht als eigenständiges WordPress-Installationspaket zur Verfügung:
+TCB Aktuell steht als eigenständiges WordPress-Installationspaket zur Verfügung:
 <code>
-tcb-aktuell-1.0.0.zip
+tcb-aktuell-2.0.0.zip
 </code>
-Installation über:
+Die Installation erfolgt über:
-**WordPress → Plugins → Installieren → Plugin hochladen**
+**WordPress → Plugins → Plugin hinzufügen → Plugin hochladen**
-Anschließend wird das Plugin aktiviert und der Shortcode an der gewünschten Position eingebunden.
+Nach der Installation wird das Plugin aktiviert.
+Die Ausgabe wird anschließend über den Shortcode
+<code>
+[tcb_aktuell]
+</code>
+an der gewünschten Position eingebunden.
 ===== Versionshistorie =====
 ^ Version ^ Datum ^ Änderungen ^
-| 1.0.0 | 24.08.2026 | Erste produktive Version: Backend-Verwaltung, Shortcode-Ausgabe, optionale Verlinkung und responsive Hinweisbox |
+| 1.0.0 | 24.08.2026 | Erste produktive Version mit einer Meldung, Backend-Verwaltung, Shortcode-Ausgabe, optionaler Verlinkung und responsiver Hinweisbox |
+| 2.0.0 | 26.09.2026 | Erweiterung auf mehrere Meldungen, zeitgesteuerte Ausgabe, Prioritäten, flexible Ausgabeoptionen, Slider-/Wechselfunktion, Überblendung, Navigation, Autoplay und Loop sowie überarbeitete modulare Plugin-Struktur |
 ===== Geplante Weiterentwicklung =====
-Mögliche Erweiterungen werden erst für spätere Versionen betrachtet.
+Für eine zukünftige Version ist vorgesehen:
-Dazu könnten beispielsweise gehören:
+  * Umschaltung zwischen **Dark Mode** und **Light Mode**
+  * Nutzung der bereits vorbereiteten Darstellung für den jeweils gewählten Darstellungsmodus
-  * mehrere Meldungen
+Weitere Erweiterungen werden bei konkretem Bedarf ergänzt.
-  * zeitgesteuerte Veröffentlichung
+===== Zugehörige Dateien =====
-  * wechselnde Meldungen
-  * Prioritäten
-  * weitere Darstellungsoptionen
-Diese Funktionen sind **nicht Bestandteil von Version 1.0.0**.
+Zum Plugin gehören folgende Dokumentations- und Installationsdateien:
-===== Zugehörige Dateien =====
-  * ''tcb-aktuell-1.0.0.zip'' – WordPress-Installationspaket
+  * ''tcb-aktuell-v2.0.0.zip'' – aktuelles Installationspaket
-  * ''TCB_Aktuell_v1.0_Dokumentation.md'' – technische Entwicklungsdokumentation
+  * ''TCB_Aktuell_v1.0_Dokumentation.md'' – Entwicklungsdokumentation der Version 1.0
+  * {{:plugins:tcb-aktuell:tcb-aktuell-v2.0.0.zip|TCB Aktuell 2.0.0 – Installationspaket herunterladen}}
 <WRAP tcw-to-top>
 [[#tcb_aktuell|↑]]
 </WRAP>