Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen der Seite angezeigt.

--- plugins:indian-timeline:start [27.09.2026 13:19] – [Bedienung im Frontend] admin
+++ plugins:indian-timeline:start [27.09.2026 13:31] (aktuell) – [Technische Umsetzung] admin
@@ Zeile 117: / Zeile 117: @@
 Werden die Attribute nicht angegeben, verwendet das Plugin die globalen Einstellungen.
+===== Einstellungen =====
+Die globalen Einstellungen der Indian Timeline werden im WordPress-Backend unter
+**Einstellungen → Indian Timeline**
+verwaltet.
+Folgende Einstellungen stehen zur Verfügung:
+^ Einstellung ^ Funktion ^
+| Titel | Standardtitel der Timeline |
+| Einleitung | Standardtext unterhalb des Titels |
+| Hintergrund | Hintergrundfarbe der Timeline |
+| Alternativer Hintergrund | Hintergrundfarbe hervorgehobener Bereiche |
+| Text | allgemeine Textfarbe |
+| Akzent | Akzentfarbe für zentrale Gestaltungselemente |
+| Hover | Farbe für Hover-Zustände |
+Die Einstellungen gelten global für die Timeline.
+Titel und Einleitung können bei Bedarf für eine einzelne Einbindung über die Shortcode-Attribute ''title'' und ''intro'' überschrieben werden.
+===== Standardwerte =====
+Indian Timeline 1.0.0 besitzt folgende vorkonfigurierte Standardwerte:
+^ Einstellung ^ Standardwert ^
+| Titel | Indian Motorcycle – Route durch die Geschichte |
+| Einleitung | 125 Jahre Innovation, Leidenschaft und amerikanische Motorradgeschichte. |
+| Hintergrund | ''#F8F9FA'' |
+| Alternativer Hintergrund | ''#EEF1F4'' |
+| Text | ''#4A5568'' |
+| Akzent | ''#D96B43'' |
+| Hover | ''#B84E2E'' |
+Die Standardwerte werden verwendet, solange für die jeweilige Einstellung kein abweichender Wert gespeichert wurde.
+===== Datenhaltung =====
+Indian Timeline 1.0.0 verwendet zwei unterschiedliche Formen der Datenhaltung.
+Die globalen Einstellungen der Timeline werden über die WordPress Options API gespeichert. Hierzu gehören:
+  * Titel
+  * Einleitung
+  * Hintergrundfarbe
+  * alternativer Hintergrund
+  * Textfarbe
+  * Akzentfarbe
+  * Hover-Farbe
+Die Einstellungen werden gemeinsam in der WordPress-Option
+<code>
+tcb_indian_timeline_settings
+</code>
+gespeichert.
+Die historischen Meilensteine selbst werden in Version 1.0.0 nicht in der WordPress-Datenbank verwaltet.
+Sie sind direkt in der PHP-Hauptdatei des Plugins hinterlegt.
+Jeder Meilenstein enthält folgende Informationen:
+  * Jahr beziehungsweise Zeitraum
+  * Epoche
+  * Bezeichnung der Epoche
+  * Titel
+  * Kurzbeschreibung
+  * ausführliche Beschreibung
+  * ergänzende Notiz
+Änderungen, Ergänzungen oder Korrekturen an den historischen Ereignissen erfordern daher in Version 1.0.0 eine Änderung des Plugin-Codes.
+===== Technische Umsetzung =====
+TheCruiserBlog – Indian Timeline 1.0.0 ist als eigenständiges WordPress-Plugin umgesetzt.
+Die zentrale Plugin-Logik befindet sich in der Klasse ''TCB_Indian_Timeline''.
+Zu ihren Aufgaben gehören:
+  * Registrierung des Shortcodes ''[indian_timeline]''
+  * Registrierung und bedarfsgerechtes Laden von CSS und JavaScript
+  * Bereitstellung der historischen Ereignisdaten
+  * Laden und Verarbeiten der globalen Einstellungen
+  * Registrierung der Einstellungsseite im WordPress-Backend
+  * Validierung der gespeicherten Einstellungen
+  * Erzeugung der HTML-Grundstruktur der Timeline
+CSS und JavaScript werden zunächst bei WordPress registriert und erst bei der Ausgabe des Shortcodes eingebunden.
+Die historischen Ereignisdaten werden von PHP als JSON-Daten an die jeweilige Timeline-Instanz übergeben. JavaScript übernimmt anschließend die interaktive Darstellung, Filterung, Suche und Navigation im Browser.
+Für jede ausgegebene Timeline erzeugt das Plugin mithilfe der WordPress-Funktion ''wp_unique_id()'' eine eindeutige ID. Dadurch können mehrere Timeline-Instanzen unabhängig voneinander auf derselben Seite verwendet werden.
+Das Frontend verwendet Vanilla JavaScript und benötigt keine externe JavaScript-Bibliothek.
+===== Plugin-Struktur =====
+TheCruiserBlog – Indian Timeline 1.0.0 besitzt eine kompakte Plugin-Struktur.
+<code>
+thecruiserblog-indian-timeline/
+├── thecruiserblog-indian-timeline.php
+├── readme.txt
+│
+└── assets/
+    ├── css/
+    │   └── timeline.css
+    │
+    └── js/
+        └── timeline.js
+</code>
+Die einzelnen Dateien übernehmen folgende Aufgaben:
+  * ''thecruiserblog-indian-timeline.php'' – zentrale Plugin-Datei mit Plugin-Initialisierung, Shortcode, historischen Ereignisdaten, Einstellungen und HTML-Ausgabe
+  * ''readme.txt'' – Plugin-Dokumentation mit Installation, Shortcode-Verwendung und Versionsinformationen
+  * ''timeline.css'' – Gestaltung und responsive Darstellung der Timeline
+  * ''timeline.js'' – interaktive Darstellung, Suche, Epochenfilter, Auswahl und Navigation zwischen den Meilensteinen
+Version 1.0.0 verwendet keine zusätzlichen PHP-Klassen- oder Include-Dateien. Die PHP-Funktionalität ist vollständig in der zentralen Plugin-Datei zusammengefasst.
+===== Darstellung =====
+Die Indian Timeline verwendet eine eigenständige Darstellung im **Modern-Heritage-Stil**.
+Kennzeichnend sind:
+  * vertikale Timeline mit zentraler Verbindungslinie
+  * abwechselnde Anordnung der Meilensteine links und rechts der Zeitachse
+  * farblich hervorgehobene Jahresmarker
+  * Karten für die einzelnen historischen Meilensteine
+  * Hervorhebung des aktuell ausgewählten Meilensteins
+  * Hover-Effekte für interaktive Elemente
+  * eigener Detailbereich für den ausgewählten Meilenstein
+  * konfigurierbare Hintergrund-, Text-, Akzent- und Hover-Farben
+  * responsive Anpassung an kleinere Bildschirmbreiten
+Bei einer Bildschirmbreite unter **700 Pixeln** wechselt die Timeline von der wechselnden Links-/Rechts-Darstellung zu einer einheitlichen Anordnung mit links positionierter Zeitachse.
+Bei einer Bildschirmbreite unter **480 Pixeln** werden zusätzlich die Bedienelemente und historischen Eckdaten einspaltig dargestellt. Die Navigationsschaltflächen werden untereinander angeordnet.
+Die Darstellung ist vollständig im Plugin-eigenen Stylesheet ''timeline.css'' definiert.
+===== Sicherheit und Validierung =====
+TheCruiserBlog – Indian Timeline verwendet die Sicherheits- und Validierungsfunktionen von WordPress.
+Der direkte Aufruf der zentralen Plugin-Datei außerhalb von WordPress wird durch die Prüfung auf ''ABSPATH'' verhindert.
+Der Zugriff auf die Einstellungsseite ist auf Benutzer mit der WordPress-Berechtigung ''manage_options'' beschränkt.
+Bei der Verarbeitung der Einstellungen werden die eingegebenen Werte serverseitig bereinigt:
+  * Titel über ''sanitize_text_field()''
+  * Einleitung über ''sanitize_textarea_field()''
+  * Farbwerte über ''sanitize_hex_color()''
+Ungültige Farbwerte werden durch die jeweiligen Standardwerte ersetzt.
+Bei der Frontend-Ausgabe werden Inhalte und Attribute mit den entsprechenden WordPress-Escaping-Funktionen abgesichert.
+Die Einstellungen werden über die WordPress Settings API verwaltet.
+===== Installation =====
+TheCruiserBlog – Indian Timeline kann als eigenständiges WordPress-Plugin installiert werden.
+Systemvoraussetzungen:
+  * WordPress ab Version 6.2
+  * PHP ab Version 7.4
+Die Installation erfolgt über:
+**WordPress → Plugins → Plugin hinzufügen → Plugin hochladen**
+Nach der Installation wird das Plugin aktiviert.
+Anschließend kann die Timeline über den Shortcode
+<code>
+[indian_timeline]
+</code>
+in eine Seite oder einen Beitrag eingebunden werden.
+Die globalen Einstellungen stehen unter
+**Einstellungen → Indian Timeline**
+zur Verfügung.
+Das aktuelle Installationspaket kann direkt heruntergeladen werden:
+  * {{:plugins:indian-timeline:thecruiserblog-indian-timeline_v1.0.0_installation.zip|TheCruiserBlog – Indian Timeline 1.0.0 – Installationspaket herunterladen}}
+===== Versionshistorie =====
+^ Version ^ Änderungen ^
+| 1.0.0 | Erste Version mit responsiver Timeline, Suche, Epochenfilter, Navigation zwischen den Meilensteinen und konfigurierbaren Modern-Heritage-Farben |
+===== Zugehörige Dateien =====
+Zum Plugin gehören folgende Dokumentations- und Installationsdateien:
+  * ''thecruiserblog-indian-timeline_v1.0.0_installation.zip'' – Installationspaket der Version 1.0.0
+  * ''readme.txt'' – Plugin-Dokumentation mit Installation, Shortcode-Verwendung und Versionsinformationen
+<WRAP tcw-to-top>
+[[#thecruiserblog_indian_timeline|↑]]
+</WRAP>