Add FamilyAlbums family photo portal with Nextcloud integration

A PHP-based family photo album portal featuring: - Public gallery with year/month filtering and search - Mobile-responsive design with Tailwind CSS - Comment system for family members - Admin interface for album management - Flat-file JSON database (no MySQL needed) - CSRF protection and XSS prevention - Rate limiting and honeypot spam protection
2025-12-25 09:57:51 +00:00
parent 5f949121bf
commit 25766959f1
9 changed files with 1752 additions and 0 deletions
@@ -0,0 +1,131 @@
+# FamilyAlbums - Familien-Fotoalbum-Portal
+
+Ein einfaches, PHP-basiertes Portal zur Verwaltung und Anzeige von Familien-Fotoalben mit Links zu Nextcloud.
+
+## Features
+
+- Öffentliche Galerie-Ansicht mit Jahr/Monat-Filter
+- Stichwortsuche über Titel, Tags und Beschreibung
+- Kommentarfunktion für Familienmitglieder
+- Admin-Interface zur Albumverwaltung
+- Responsive Design (Tailwind CSS)
+- Flat-File Datenbank (JSON) - kein MySQL erforderlich
+- Spam-Schutz (Honeypot + Rate-Limiting)
+- CSRF-Schutz für Admin-Aktionen
+
+## Installation
+
+### 1. Dateien kopieren
+
+```bash
+# Auf den Webserver kopieren
+sudo cp -r familyalbums /var/www/
+
+# Berechtigungen setzen
+sudo chown -R www-data:www-data /var/www/familyalbums
+sudo chmod -R 755 /var/www/familyalbums
+sudo chmod 770 /var/www/familyalbums/data
+sudo chmod 770 /var/www/familyalbums/thumbnails
+```
+
+### 2. Admin-Passwort ändern
+
+**WICHTIG:** Das Standard-Passwort muss vor dem produktiven Einsatz geändert werden!
+
+```bash
+# Neuen Passwort-Hash generieren
+php -r "echo password_hash('DeinSicheresPasswort', PASSWORD_DEFAULT);"
+```
+
+Den generierten Hash in `config.php` eintragen:
+
+```php
+define('ADMIN_PASSWORD_HASH', '$2y$10$DEIN_GENERIERTER_HASH_HIER');
+```
+
+### 3. Apache Virtual Host (optional)
+
+```apache
+<VirtualHost *:80>
+    ServerName familyalbums.example.com
+    DocumentRoot /var/www/familyalbums
+
+    <Directory /var/www/familyalbums>
+        AllowOverride All
+        Require all granted
+    </Directory>
+</VirtualHost>
+```
+
+## Verwendung
+
+### Öffentliche Galerie
+
+- URL: `https://deine-domain.ch/`
+- Filter nach Jahr und Monat
+- Stichwortsuche
+- Kommentare zu Alben hinterlassen
+
+### Admin-Bereich
+
+- URL: `https://deine-domain.ch/admin.php`
+- Login mit dem konfigurierten Passwort
+- Alben hinzufügen, bearbeiten, löschen
+- Optional: Vorschaubilder hochladen
+- Kommentare moderieren
+
+## Datenstruktur
+
+### albums.json
+
+```json
+{
+  "albums": [
+    {
+      "id": "uuid",
+      "title": "Albumtitel",
+      "url": "https://nextcloud.../apps/photos/public/...",
+      "date": "2024-12-25",
+      "tags": ["tag1", "tag2"],
+      "description": "Beschreibung",
+      "thumbnail": "thumbnails/bild.jpg",
+      "created_at": "2024-12-26T10:00:00+01:00"
+    }
+  ]
+}
+```
+
+### comments.json
+
+```json
+{
+  "comments": [
+    {
+      "id": "uuid",
+      "album_id": "album-uuid",
+      "author": "Name",
+      "text": "Kommentar",
+      "created_at": "2024-12-27T14:30:00+01:00"
+    }
+  ]
+}
+```
+
+## Sicherheit
+
+- Admin-Passwort mit bcrypt gehasht
+- CSRF-Token für alle Admin-Aktionen
+- XSS-Schutz durch `htmlspecialchars()`
+- Rate-Limiting für Kommentare (5/Minute pro IP)
+- Honeypot-Feld gegen Spam-Bots
+- `.htaccess` schützt config.php und data/
+
+## Anforderungen
+
+- PHP 8.0+
+- Apache mit mod_rewrite (optional)
+- Schreibrechte für data/ und thumbnails/
+
+## Lizenz
+
+Privates Projekt für Familien-Nutzung.