NextCloud AddOn für REDAXO

Ein praktisches AddOn zur Integration einer NextCloud-Instanz in REDAXO. Es ermöglicht den direkten Import von Dateien aus der NextCloud in den REDAXO-Medienpool.

Features

• Durchsuchen der NextCloud-Dateien direkt in REDAXO
• Konfigurierbare Root-Ordner: Beschränkung auf bestimmte Verzeichnisse in der NextCloud
• Vorschau von Bildern vor dem Import (Modal-Fenster)
• PDF-Vorschau: PDFs können vor dem Import in einem neuen Fenster betrachtet werden
• Einfacher Import per Klick in den Medienpool
• Kategorisierung der importierten Dateien
• Unterstützung verschiedener Dateitypen
• Backup-Cron zu NextCloud

Installation

1. Das AddOn über den REDAXO Installer herunterladen
2. Installation durchführen
3. In den Einstellungen die NextCloud-Verbindung konfigurieren:
   • NextCloud-URL eingeben (z.B. https://cloud.example.com)
   • Benutzername festlegen
   • App-Passwort aus den NextCloud-Einstellungen eintragen
   • Optional: Root-Ordner festlegen (z.B. /medien für einen spezifischen Startordner)

Einrichtung in NextCloud

1. In NextCloud einloggen
2. Zu "Einstellungen" > "Sicherheit" navigieren
3. Im Bereich "App-Passwörter" ein neues Passwort generieren
4. Dieses Passwort im REDAXO AddOn eintragen

Nutzung

Nach erfolgreicher Konfiguration:

1. Im REDAXO Backend zum Menüpunkt "NextCloud" navigieren
2. Dateien und Ordner durchsuchen:
   • Ordner durch Klick öffnen
   • Navigationspfad oben nutzen
   • "Home"-Button führt zum Hauptverzeichnis
3. Bilder können vor dem Import vorgeschaut werden (Modal-Fenster)
4. PDFs können vor dem Import in einem neuen Fenster/Tab geöffnet werden
5. Zielkategorie im Medienpool auswählen
6. Dateien per Klick importieren

Unterstützte Dateitypen

• Bilder: jpg, jpeg, png, gif, svg, webp (mit Modal-Vorschau)
• PDFs: pdf (mit Vorschau in neuem Fenster)
• Dokumente: doc, docx, xls, xlsx, ppt, pptx, txt, md, rtf
• Archive: zip, rar, 7z, tar, gz, bz2
• Audio: mp3, wav, ogg, m4a, flac, aac
• Video: mp4, avi, mkv, mov, webm, flv, wmv

NextCloud Backup-Cronjob

Mit diesem Addon ist ein spezieller Cronjob für automatische Backups verfügbar, der Datenbank- und Dateisystem-Backups automatisch in eine NextCloud-Instanz hochlädt.

Voraussetzungen

• Eine NextCloud-Instanz mit WebDAV-Zugang
• App-Passwort für den NextCloud-Benutzer (aus Sicherheitsgründen empfohlen)
• cURL-Unterstützung auf dem Server
• mysqldump und tar müssen auf dem Server verfügbar sein

Einrichtung

1. Navigiere im REDAXO-Backend zu "Cronjobs" → "Cronjobs"
2. Klicke auf "Cronjob hinzufügen"
3. Wähle als Typ "REDAXO Backup (NextCloud)" aus
4. Konfiguriere die folgenden Einstellungen:

Konfiguration

| Einstellung | Beschreibung | |-------------|--------------| | NextCloud URL | Die URL deiner NextCloud-Instanz (z.B. https://nextcloud.example.com/) | | Benutzername | Dein NextCloud-Benutzername | | App-Passwort | Ein in den NextCloud-Einstellungen generiertes App-Passwort | | NextCloud Pfad | Das Zielverzeichnis in der NextCloud (z.B. backups/redaxo) | | Maximale Anzahl Backups | Ältere Backups werden automatisch gelöscht, wenn diese Anzahl überschritten wird | | Datenbank sichern | Legt fest, ob die Datenbank gesichert werden soll | | Dateisystem sichern | Legt fest, ob die Dateien gesichert werden sollen |

5. Konfiguriere die Ausführungshäufigkeit des Cronjobs (täglich, wöchentlich, etc.)
6. Speichere den Cronjob

Backup-Struktur

Die Backups werden in der NextCloud in folgender Struktur gespeichert:

[Zielverzeichnis]/
  ├── db/
  │   ├── redaxo_db_2025-03-13_10-00-00.sql.gz
  │   └── ...
  └── files/
      ├── redaxo_files_2025-03-13_10-00-00.tar.gz
      └── ...

Hinweise

• Die temporären Backup-Dateien werden im Verzeichnis /backup im REDAXO-Hauptverzeichnis erstellt und nach dem Upload wieder gelöscht
• Folgende Verzeichnisse werden beim Dateisystem-Backup ausgeschlossen:
  • backup/
  • cache/
  • redaxo/cache/
  • redaxo/data/cache/
  • media/cache/
• Der Cronjob kann manuell über die REDAXO-Backend-Oberfläche ausgeführt werden, um die Funktionalität zu testen

Systemvoraussetzungen

• REDAXO 5.18.0 oder höher
• PHP 8.1 oder höher
• exec
• HTTPS-fähige NextCloud-Installation

Lizenz des AddOns

MIT-Lizenz, siehe LICENSE

Lizenz Nextcloud

https://github.com/nextcloud/server/tree/master/LICENSES

Author

Thomas Skerbis, KLXM Crossmedia GmbH

Support & Bugs

Fehler bitte auf GitHub melden: https://github.com/klxm/nextcloud