Web-Radio-CMS V5

Installations-, Konfigurations- und Benutzerhandbuch

1. Übersicht

Das Web-Radio-CMS V5 ist ein eigenständiges Web-CMS für den Betrieb eines modernen Online-Webradios.

Das System verbindet die wichtigsten Funktionen für den Radiobetrieb mit einem Benutzer-, Community- und Administrationssystem.

Enthaltene Bereiche

Das CMS ist modular aufgebaut und kann später um weitere Funktionen erweitert werden.

2. Systemvoraussetzungen

Für den Betrieb wird ein Webserver mit PHP und MySQL/MariaDB benötigt.

Empfohlen:

Falls ZipArchive auf dem Server nicht verfügbar ist, kann der Installer alternativ PclZip verwenden, sofern die entsprechende Bibliothek im Installationspaket vorhanden ist.

Webserver

Geeignet sind beispielsweise:

3. Installationspaket

Das Installationspaket wird als Datei ausgeliefert:

webradio-security-v5-install.zip

Dieses Paket wird zuerst auf dem eigenen PC oder Laptop entpackt.

Nach dem Entpacken befinden sich darin unter anderem:

webradio-security-v5.zip
install.php

Die eigentliche CMS-Datei

webradio-security-v5.zip

wird nicht manuell auf dem Server entpackt.

Das übernimmt automatisch install.php.

4. Installation auf dem Webserver

Schritt 1 – Installationspaket lokal entpacken

Die Datei

webradio-security-v5-install.zip

auf dem PC/Laptop entpacken.

Danach sollten mindestens folgende Dateien vorhanden sein:

webradio-security-v5.zip
install.php

Schritt 2 – Dateien auf den Webserver hochladen

Die beiden benötigten Dateien auf den gewünschten Webspace/Webserver hochladen:

webradio-security-v5.zip
install.php

Beispiel:

/
├── install.php
└── webradio-security-v5.zip

Die Dateien können im Webroot oder in einem anderen gewünschten Verzeichnis abgelegt werden.

5. Installer starten

Im Browser die hochgeladene install.php aufrufen.

Beispiel:

https://DEINE-DOMAIN/install.php

Der Installer sucht automatisch nach:

webradio-security-v5.zip

Wird die Datei nicht gefunden, erscheint:

ZIP-Datei nicht gefunden.

6. Automatisches Entpacken

install.php übernimmt das Entpacken der CMS-Dateien automatisch.

Als Zielverzeichnis ist festgelegt:

webradio

Der Installer verwendet zunächst die PHP-Funktion:

ZipArchive

Ist diese verfügbar, wird das CMS damit entpackt.

Falls ZipArchive nicht verfügbar ist, versucht der Installer alternativ:

PclZip

zu verwenden.

Der grundsätzliche Ablauf lautet:

webradio-security-v5.zip
        ↓
install.php
        ↓
/webradio/
        ↓
/webradio/install

Nach erfolgreichem Entpacken erfolgt automatisch die Weiterleitung zum eigentlichen CMS-Installer:

/webradio/install

7. Installationsstruktur

Nach dem automatischen Entpacken entsteht das CMS unter:

/webradio/

Der eigentliche Installationsbereich befindet sich unter:

/webradio/install

Die vorherige install.php dient lediglich dazu, das CMS-Paket auf dem Server bereitzustellen und anschließend den eigentlichen Installer zu starten.

8. Server-Check

Sofern die mitgelieferte check.php verwendet wird, kann damit vor bzw. während der Installation geprüft werden, ob die Serverumgebung die benötigten Voraussetzungen erfüllt.

Beispiel:

https://DEINE-DOMAIN/check.php

Der genaue Umfang der Prüfungen richtet sich nach der tatsächlich mitgelieferten Version von check.php.

9. Datenbank

Das Web-Radio-CMS verwendet eine MySQL-/MariaDB-Datenbank.

Für das Projekt ist folgende Datenbank vorgesehen:

webradio_fhmr

Für die Datenbank werden die Zugangsdaten des jeweiligen Webhosters benötigt.

Typischerweise benötigt der Installer:

Die Datenbank sollte vor der Installation angelegt werden, sofern der Webhoster dies nicht automatisch über den Installer ermöglicht.

10. Administrator

Während der Installation wird der erste Administrator eingerichtet.

Der Administrator besitzt die höchsten Rechte im System.

Der Administrator kann unter anderem:

Das Administratorpasswort sollte sicher gewählt werden.

11. Benutzerrollen

Das CMS arbeitet mit verschiedenen Benutzerrollen.

Administrator

admin

Vollständiger Zugriff auf die administrativen Funktionen.

Moderator

moderator

Moderatoren übernehmen Aufgaben innerhalb der Community und Moderation.

Je nach Modul können Moderatoren beispielsweise:

DJ

dj

DJs erhalten Zugriff auf die für den Radiobetrieb vorgesehenen DJ-Funktionen.

Dazu gehören insbesondere:

Normale Benutzer sollen keine Sendungen anlegen können.

Benutzer

user

Normale Benutzer können die Community-Funktionen nutzen.

Dazu gehören beispielsweise:

12. Live-Player

Der Live-Player ist der zentrale Bestandteil des Radios.

Der Player kann unter anderem anzeigen:

Der Player kann in die Startseite bzw. andere Bereiche des CMS integriert werden.

13. Now Playing

Der Bereich Now Playing zeigt den aktuell laufenden Titel beziehungsweise die aktuellen Streaminformationen.

Je nach verwendeter Streamtechnik können Informationen wie:

angezeigt werden.

Die konkrete Darstellung hängt von der verwendeten Streamquelle und deren verfügbaren Daten ab.

14. Sendeplan

Der Sendeplan zeigt die geplanten Sendungen des Radios.

Mögliche Informationen:

Der Sendeplan kann sowohl als vollständige Seite als auch als Widget verwendet werden.

15. Sendeplan-Widget

Zusätzlich zur normalen Sendeplan-Seite gibt es eine Widget-Variante.

Das Widget kann beispielsweise auf der Startseite oder in einer Sidebar eingebunden werden.

Beispielhafte Darstellung:

Sendeplan

Montag
18:00 – 20:00  DJ Max

Dienstag
20:00 – 22:00  DJ Anna

Die genaue Ausgabe hängt von den vorhandenen Sendungen ab.

16. Wunschbox

Mit der Wunschbox können Hörer Musikwünsche an das Radio senden.

Typischer Ablauf:

Benutzer
   ↓
Wunschbox
   ↓
Musikwunsch
   ↓
Moderation/DJ
   ↓
Bearbeitung

Die Wunschbox ist für normale Benutzer zugänglich.

Administratoren und Moderatoren können die eingehenden Wünsche verwalten.

17. Wunschbox-Widget

Neben der normalen Wunschbox-Seite kann die Wunschbox auch als Widget eingebunden werden.

Damit kann beispielsweise auf der Startseite ein kompakter Wunschbox-Bereich angezeigt werden.

18. News

Über den News-Bereich können aktuelle Informationen veröffentlicht werden.

Mögliche Inhalte:

Die Verwaltung erfolgt über den dafür vorgesehenen administrativen Bereich.

19. Blog

Das CMS enthält einen Blogbereich.

Benutzer können – abhängig von den gesetzten Rechten – eigene Beiträge erstellen.

Vorgesehene Funktionen:

Administratoren und Moderatoren können Inhalte anderer Benutzer entsprechend ihrer Rechte verwalten.

20. Forum

Das Forum stellt den Community-Bereich des Web-Radios dar.

Benutzer können:

Moderatoren können zusätzlich Inhalte anderer Benutzer moderieren.

Administratoren besitzen die vollständigen Verwaltungsrechte.

Forum-Rechte

Funktion Benutzer Moderator Admin
Kategorien ansehen ✓ ✓ ✓
Thema erstellen ✓ ✓ ✓
Antworten schreiben ✓ ✓ ✓
Eigene Beiträge bearbeiten ✓ ✓ ✓
Eigene Beiträge löschen ✓ ✓ ✓
Beiträge anderer bearbeiten – ✓ ✓
Beiträge anderer löschen – ✓ ✓
Kategorien verwalten – – ✓
Thema sperren – ✓ ✓

21. Private Nachrichten

Das Nachrichtensystem ermöglicht die Kommunikation zwischen Benutzern.

Unterstützt werden unter anderem:

Im Hauptmenü kann ein Hinweis auf neue bzw. ungelesene Nachrichten angezeigt werden.

22. Benutzerverwaltung

Administratoren können Benutzer verwalten.

Je nach Bereich können unter anderem folgende Informationen verwaltet werden:

Die Rollensteuerung verhindert, dass normale Benutzer auf geschützte Verwaltungsbereiche zugreifen.

23. DJ- und Moderatorenbereich

Der Radiobetrieb verfügt über einen separaten Bereich für DJs und Moderatoren.

Der Bereich ist nicht für normale Benutzer vorgesehen.

DJs können dort radiobezogene Aufgaben erledigen.

Moderatoren erhalten die für die Moderation vorgesehenen Funktionen.

Administratoren haben Zugriff auf alle Bereiche.

24. Rollen- und Zugriffsschutz

Geschützte Bereiche verwenden Rollenprüfungen.

Beispielsweise können Bereiche ausschließlich für Administratoren und Moderatoren freigegeben werden:

requireRole('admin', 'moderator');

Dadurch können bestimmte Funktionen gezielt mehreren Rollen zugänglich gemacht werden.

25. Sicherheit

Das CMS enthält verschiedene grundlegende Sicherheitsmechanismen.

Dazu gehören unter anderem:

Beispiel für die Ausgabe-Escaping-Funktion:

e()

Beispiel für einen geschützten Bereich:

requireLogin();

Beispiel für Rollen:

requireRole('admin', 'moderator');

Die vorhandenen Sicherheitsmaßnahmen stellen eine solide Basis für das CMS dar, ersetzen jedoch keinen professionellen Sicherheitstest bzw. Penetrationstest.

26. CSRF-Schutz

Formulare mit schreibenden Aktionen verwenden CSRF-Schutz.

Beispiel:

<form method="post"
      action="<?= e(url('modules/messages/message_action.php')) ?>">
    <?php echo csrfField(); ?>
</form>

Der CSRF-Token gehört in das Formular und nicht in die URL.

Dies schützt POST-Aktionen gegen bestimmte Cross-Site-Request-Forgery-Angriffe.

27. Widgets

Das Web-Radio-CMS unterstützt Widget-Varianten für ausgewählte Funktionen.

Beispielsweise:

Sendeplan
Wunschbox

Widgets können auf der Startseite oder in einer Sidebar eingebunden werden.

Dadurch müssen nicht alle Funktionen als vollständige Seite dargestellt werden.

28. Uploads

Das CMS besitzt Upload-Bereiche für die jeweils vorgesehenen Inhalte.

Dabei sollten die Upload-Verzeichnisse vor unberechtigtem Zugriff geschützt werden.

Besonders bei öffentlichen Uploads sollte darauf geachtet werden:

29. Erste Einrichtung nach der Installation

Nach erfolgreicher Installation empfiehlt sich folgende Reihenfolge.

1. Administrator anmelden

Mit dem während der Installation angelegten Administratorkonto anmelden.

2. Grundeinstellungen prüfen

Kontrollieren:

3. Rollen kontrollieren

Prüfen:

admin
moderator
dj
user

4. DJ-/Moderator-Konten anlegen

Die entsprechenden Benutzerkonten anlegen bzw. Rollen zuweisen.

5. Sendungen anlegen

Sendungen erstellen und DJs zuweisen.

6. Sendeplan einrichten

Start- und Endzeiten eintragen.

7. Wunschbox testen

Mit einem normalen Benutzer einen Testwunsch senden.

Danach mit Moderator/Admin prüfen, ob der Wunsch verwaltet werden kann.

8. Forum testen

Testen:

9. Blog testen

Testen:

10. Nachrichten testen

Mit zwei Testkonten:

Benutzer A → Benutzer B

Danach prüfen:

30. Empfohlener Funktionstest

Vor dem produktiven Start sollte das CMS einmal komplett durchgetestet werden.

Besucher

Benutzer

DJ

Moderator

Administrator

31. Datenbank-Backup

Vor Änderungen am System sollte regelmäßig ein Backup durchgeführt werden.

Empfohlen:

Datenbank
+
Uploads
+
CMS-Dateien

sichern.

Besonders vor Updates oder größeren Änderungen sollte ein vollständiges Backup vorhanden sein.

32. Updates

Bei zukünftigen Updates sollte folgende Reihenfolge eingehalten werden:

1. Backup erstellen
2. Datenbank sichern
3. Uploads sichern
4. CMS-Dateien sichern
5. Update installieren
6. Datenbankänderungen durchführen
7. Funktionstest

Nach einem Update sollten insbesondere Login, Player, Sendeplan, Wunschbox, Forum, Blog und Nachrichten getestet werden.

33. Troubleshooting

Problem: ZIP-Datei nicht gefunden

Fehlermeldung:

ZIP-Datei nicht gefunden.

Prüfen:

install.php
webradio-security-v5.zip

müssen sich im gleichen Verzeichnis befinden.

Problem: ZipArchive funktioniert nicht

Wenn der Server ZipArchive nicht unterstützt, verwendet install.php alternativ PclZip, sofern die Bibliothek vorhanden ist.

Gegebenenfalls sollte beim Webhoster geprüft werden, ob die PHP-ZIP-Erweiterung aktiviert werden kann.

Problem: Fehler beim Entpacken

Mögliche Ursachen:

In diesem Fall die ZIP-Datei erneut hochladen und die Serverrechte bzw. den verfügbaren Speicher prüfen.

Problem: Weiterleitung funktioniert nicht

Nach erfolgreichem Entpacken sollte automatisch auf:

/webradio/install

weitergeleitet werden.

Falls dies nicht funktioniert, prüfen:

Problem: Datenbankverbindung

Wenn die Datenbankverbindung fehlschlägt, prüfen:

Für das Projekt ist als Datenbankname vorgesehen:

webradio_fhmr

34. Produktiver Start

Vor dem öffentlichen Start sollten mindestens folgende Punkte geprüft werden:

35. Sicherheit vor dem Livegang

Vor dem produktiven Einsatz sollte zusätzlich geprüft werden:

36. Geplante Erweiterungen

Das CMS kann später um weitere Funktionen ergänzt werden.

Mögliche Erweiterungen:

Die geplante ET-Chat-Integration ist als zukünftige Erweiterung vorgesehen und gehört nicht zwingend zur V5-Grundinstallation.

37. Kurzinstallation

Die komplette Installation lässt sich kurz so zusammenfassen:

1. webradio-security-v5-install.zip herunterladen
        ↓
2. ZIP auf PC/Laptop entpacken
        ↓
3. webradio-security-v5.zip + install.php erhalten
        ↓
4. beide Dateien auf den Webserver hochladen
        ↓
5. https://DEINE-DOMAIN/install.php aufrufen
        ↓
6. install.php findet webradio-security-v5.zip
        ↓
7. CMS wird automatisch nach /webradio/ entpackt
        ↓
8. automatische Weiterleitung nach /webradio/install
        ↓
9. eigentliche CMS-Installation durchführen
        ↓
10. Datenbank einrichten
        ↓
11. Administrator anlegen
        ↓
12. Web-Radio-CMS konfigurieren
        ↓
13. Funktionstest
        ↓
14. Web-Radio online stellen

38. Abschluss

Das Web-Radio-CMS V5 bietet eine vollständige Grundlage für den Betrieb eines eigenen Webradios mit Radio-, Community- und Verwaltungsfunktionen.

Der modulare Aufbau ermöglicht es, das System später um zusätzliche Funktionen zu erweitern, ohne die Grundstruktur des CMS vollständig neu aufzubauen.

Für den produktiven Betrieb sollten regelmäßige Backups, Updates und Sicherheitsprüfungen durchgeführt werden.

Web-Radio-CMS V5

Eigenständiges Web-Radio-CMS

Bereiche:

Player
Now Playing
Sendeplan
DJ-Bereich
Moderator-Bereich
Wunschbox
News
Blog
Forum
Private Nachrichten
Benutzerverwaltung
Rollen & Rechte
Widgets
Administration

Version: V5
Produktname: Web-Radio-CMS