Claude
25766959f1
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
132 lines
2.8 KiB
Markdown
132 lines
2.8 KiB
Markdown
# 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.
|