🥧 PrivateCMS

PrivateCMS ist ein modernes, leichtgewichtiges und Docker-basiertes Content-Management-System (CMS), das speziell für Blogger und Entwickler entwickelt wurde. Es bietet eine elegante Benutzeroberfläche, leistungsstarke Verwaltungsfunktionen und ist dank Docker in wenigen Minuten einsatzbereit.

✨ Features

PrivateCMS kommt vollgepackt mit Funktionen für Content-Ersteller und Administratoren:

🗣️ Forum-System (Neu)

  • Umfangreiche Boards: Erstelle Diskussionsbereiche (Kategorien) mit Beschreibungen.
  • Themen & Beiträge: Nutzer können neue Themen erstellen und auf bestehende antworten.
  • Mächtiger Editor: Der Editor steht auch Nutzern im Forum zur Verfügung – inklusive Bilder-Upload, Farbwähler, Emojis und Icons.
  • Moderations-Tools: Administratoren können Themen sperren (Read-Only) oder wichtige Beiträge anpinnen (Sticky).
  • Navigation: Integrierte Breadcrumbs (Krümelpfad) für eine einfache Orientierung im Forum.

📄 CMS & Seiten

  • Statische Seiten: Erstelle zeitlose Inhalte wie "Über Uns", "Impressum" oder "Portfolio", getrennt vom Blog-Feed.
  • Dynamische Navigation: Steuere direkt im Editor, ob Seiten im Header oder Footer Menü erscheinen sollen.
  • SEO-URLs: Automatische, saubere URL-Slugs für Artikel und Seiten (z.B. /p/ueber-uns).

📝 Content Management

  • Hybrid Pro Editor: Fortschrittlicher Split-View Editor mit Unterstützung für Markdown UND HTML. Beinhaltet einen nativen Farbwähler, Textmarkierung und umfangreiche Formatierungstools.
  • Beitragsstatus: Verwalte Beiträge als Entwurf, Veröffentlicht oder Archiviert.
  • Sticky Posts: Pinne wichtige Beiträge oben an die Startseite (📌 Feature).
  • Kategorien & Tags: Organisiere deine Inhalte in flexiblen Kategorien und nutze Schlagwörter für bessere Auffindbarkeit.
  • Syntax Highlighting: Automatische Hervorhebung von Code-Blöcken für technische Blogs.
  • Extras: Integrierter Icon Picker (FontAwesome), Emoji-Support und direkter Medien-Upload im Schreibfluss.

🖼️ Medien & Dateien

  • Dateimanager: Eigenständiger Dateimanager (files.php) zum zentralen Hochladen, Ansehen und Verwalten aller Medien-Dateien.
  • Medien-Integration: Bilder direkt aus dem Editor über eine Mediathek einfügen.
  • Lightbox Galerie: Integrierte Lightbox-Funktion zeigt Bilder in Artikeln und Seiten beim Anklicken automatisch in einer eleganten Vollbild-Ansicht.
  • Hero Images: Setze beeindruckende Titelbilder für deine Artikel.
  • Datei-Anhänge: Biete Dateien direkt im Artikel zum Download an.

💬 Interaktion & Community

  • Kommentarsystem: Besucher können Artikel kommentieren.
  • Posteingang: Integriertes Kontaktformular mit eigenem Posteingang (messages.php) im Admin-Panel zum Lesen und Verwalten von Nachrichten (kein Mailserver nötig).
  • Spamschutz: Eingebauter mathematischer Spamschutz (Captcha).
  • Moderation: Admin-Tools zum Genehmigen, als Spam markieren oder Löschen von Kommentaren.

⚙️ Administration & System

  • Umfangreiches Dashboard: Ein prall gefülltes Dashboard (dashboard.php) mit Besucherstatistiken (tägliche Aufrufe), Inhalts-Metriken und Systemstatus auf einen Blick.
  • Multi-User-System: Rollenbasiertes Rechtesystem (Admin, Editor, Viewer und Mitglied) zur sicheren Verwaltung von Team-Zugriffen und Foren-Nutzern.
  • Einstellungen: Konfiguriere Blog-Titel, Beschreibung, SMTP-Mail-Server und mehr direkt im Admin-Panel.
  • Backup-System: Erstelle und lade Backups deiner Daten (JSON, CSV oder Full ZIP) herunter.
  • Logbuch: Protokolliert Benutzeraktionen für Sicherheit und Transparenz.
  • Wartungsmodus: Schalte die Seite temporär offline für Updates.

🎨 Design & UX

  • Suchfunktion: Integrierte Suchleiste, um Inhalte sofort zu finden.
  • Paginierung: Intelligente Seitennummerierung für einfaches Durchstöbern des Archivs.
  • Dark Mode: Besucher können zwischen Hell- und Dunkelmodus wechseln 🌓.
  • Responsives Design: Optimiert für Desktop, Tablet und Mobile.
  • Sidebar: Dynamische Sidebar mit Kategorien, Tag-Cloud und neuesten Kommentaren.
  • Back-to-Top: Bequeme Navigation für lange Artikel.

🌍 Internationalisierung (i18n)

  • Mehrsprachig: Vollständige Unterstützung für Deutsch 🇩🇪, Englisch 🇬🇧, Französisch 🇫🇷 und Spanisch 🇪🇸 sowohl im Frontend als auch im Backend.

📚 Wissensdatenbank (Wiki)

  • Integriertes Wiki: Eine leichtgewichtige Wissensdatenbank. Erstellen, Bearbeiten und Verwalten von Seiten direkt im Frontend mit automatischer Sidebar-Navigation und HTML-Support.



🚀 Installation

PrivateCMS ist für den Betrieb mit Docker optimiert, was die Installation extrem einfach macht.

Voraussetzungen

  • Docker & Docker Compose installiert.
  • Git (optional, zum Klonen des Repos).

Schritt-für-Schritt Anleitung

  1. Repository klonen

    git clone https://github.com/el-choco/piperblog.git
cd piperblog

  2. Installer ausführen Nutze das beiliegende Installations-Skript, um die Umgebung einzurichten und die Container zu starten:

    chmod +x docker-install.sh
./docker-install.sh

    Das Skript erstellt automatisch die .env Datei, baut die Docker-Container und startet sie.

  3. Blog aufrufen Sobald die Container laufen, ist dein Blog erreichbar unter:

    • Frontend: http://localhost:3333 (oder Port gemäß Konfiguration)
    • Admin-Login: http://localhost:3333/admin

  4. Erste Anmeldung Nutze die Standard-Zugangsdaten für den Admin-Bereich:

    • Benutzer: admin
    • Passwort: admin123
    • (Bitte ändere das Passwort sofort nach dem ersten Login!)

🛠️ Technologie-Stack

  • Backend: PHP 8.2+
  • Datenbank: MySQL 8.0
  • Webserver: Apache
  • Frontend: HTML5, CSS3, Vanilla JS
  • Containerisierung: Docker

📂 Struktur

  • admin/ - Verwaltungsoberfläche (Backend).
  • public/ - Das für Besucher sichtbare Frontend (Themes, Assets).
  • src/ - PHP-Klassen und Kernlogik.
  • config/ - Konfigurationsdateien und Sprachdateien (.ini).
  • docker/ - Docker-spezifische Konfigurationen.

📄 Lizenz

Dieses Projekt ist unter der MIT Lizenz veröffentlicht. Siehe LICENSE für Details.