Benutzer-Werkzeuge

Webseiten-Werkzeuge


plugins:tcb-aktuell:start

TCB Aktuell

TCB Aktuell ist eine Eigenentwicklung für TheCruiserBlog.

Das Plugin ermöglicht die Verwaltung und zeitgesteuerte Ausgabe aktueller Meldungen auf TheCruiserBlog. Meldungen werden im WordPress-Backend gepflegt und über einen Shortcode an der gewünschten Stelle ausgegeben.

Aktueller Stand

Version Status Einsatz
2.0.0 produktiv TheCruiserBlog

Erstmals produktiv seit: 24.08.2026

Zweck

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:

  • Hinweise auf neue Inhalte
  • aktuelle Meldungen
  • Hinweise auf besondere Projekte oder Ereignisse
  • zeitlich begrenzte Informationen
  • Verweise auf externe Seiten oder Aktionen

Die Ausgabe erfolgt über einen Shortcode und ist unabhängig vom verwendeten WordPress-Theme.

Funktionsumfang

Version 2.0.0 unterstützt:

  • Verwaltung mehrerer Meldungen
  • individuelles Aktivieren und Deaktivieren von Meldungen
  • Titel und Meldungstext
  • optionale Verlinkung
  • Startdatum und Startzeit
  • optionales Enddatum und optionale Endzeit
  • automatische Berücksichtigung des Gültigkeitszeitraums
  • 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

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 Verwaltung erfolgt im WordPress-Backend über den Menüpunkt:

TCB Aktuell

Version 2.0.0 ermöglicht die Verwaltung mehrerer voneinander unabhängiger Meldungen.

Für eine Meldung stehen unter anderem folgende Angaben zur Verfügung:

Feld Funktion
Aktiv Legt fest, ob die Meldung grundsätzlich für die Ausgabe berücksichtigt wird
Titel Titel der Meldung
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
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 von TCB Aktuell erfolgt über den Shortcode:

[tcb_aktuell]

Der Shortcode kann innerhalb des Seiteninhalts an der gewünschten Position eingebunden werden.

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 Darstellung von TCB Aktuell orientiert sich am Erscheinungsbild von TheCruiserBlog und passt sich in die bestehende Seitengestaltung ein.

Kennzeichnend sind:

  • klare Trennung der einzelnen Meldungsinhalte
  • visuelle Kennzeichnung der Prioritäten Normal, Wichtig und Dringend
  • Prioritätssymbole zur schnellen Erkennbarkeit
  • Unterstützung mehrerer Meldungen
  • 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 TheCruiserBlog eingesetzt.

Aktuell wird Version 2.0.0 verwendet.

Die Ausgabe ist auf der Startseite zwischen dem Einleitungsbereich und den vier zentralen Themenbereichen eingebunden.

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.

tcb-aktuell/
├── tcb-aktuell.php
├── TCB_Aktuell_v1.0_Dokumentation.md
├── TCB_Aktuell_v2.0_Dokumentation.md
│
├── 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

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

TCB Aktuell 2.0.0 verwendet für die persistente Speicherung weiterhin die WordPress Options API.

Alle Meldungen werden gemeinsam als Array in einer WordPress-Option gespeichert:

tcb_aktuell_meldungen

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:

  1. Dringend
  2. Wichtig
  3. 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

TCB Aktuell steht als eigenständiges WordPress-Installationspaket zur Verfügung:

tcb-aktuell-2.0.0.zip

Die Installation erfolgt über:

WordPress → Plugins → Plugin hinzufügen → Plugin hochladen

Nach der Installation wird das Plugin aktiviert.

Die Ausgabe wird anschließend über den Shortcode

[tcb_aktuell]

an der gewünschten Position eingebunden.

Versionshistorie

Version Datum Änderungen
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

Für eine zukünftige Version ist vorgesehen:

  • Umschaltung zwischen Dark Mode und Light Mode
  • Nutzung der bereits vorbereiteten Darstellung für den jeweils gewählten Darstellungsmodus

Weitere Erweiterungen werden bei konkretem Bedarf ergänzt.

Zugehörige Dateien

Zum Plugin gehören folgende Dokumentations- und Installationsdateien:

↑

plugins/tcb-aktuell/start.txt · Zuletzt geändert: von admin

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki