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
• Vorschau von Bildern vor dem Import
• 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

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
4. Zielkategorie im Medienpool auswählen
5. Dateien per Klick importieren

Unterstützte Dateitypen

• Bilder: jpg, jpeg, png, gif, svg, webp
• Dokumente: pdf, 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

KLXM Crossmedia GmbH, Thomas Skerbis

Support & Bugs

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