Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen der Seite angezeigt.

--- plugins:tcb-aktuell:start [27.09.2026 11:55] – [Bedienung] admin
+++ plugins:tcb-aktuell:start [27.09.2026 12:26] (aktuell) – [Zugehörige Dateien] admin
@@ Zeile 61: / Zeile 61: @@
   * einstellbares Autoplay
   * einstellbare Wiederholung (Loop)
-  * farbliche Anpassung an Dark- und Light-Darstellung
+  * vorbereitete Farbanpassung für eine zukünftige Dark-/Light-Darstellung
   * responsive Ausgabe
   * Verwaltung über das WordPress-Backend
@@ Zeile 83: / Zeile 83: @@
 | Meldung | Inhalt der Meldung |
 | Link | Optionales Ziel für eine weiterführende Verlinkung |
+| 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 |
@@ Zeile 92: / Zeile 93: @@
 ===== Einbindung =====
-Die Ausgabe erfolgt über den Shortcode:
+Die Ausgabe von TCB Aktuell erfolgt über den Shortcode:
 <code>
@@ Zeile 98: / 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 130: / 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 Eingaben werden vor der Speicherung bereinigt und bei der Ausgabe entsprechend escaped.
+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 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>