An open API service indexing awesome lists of open source software.

https://github.com/friendsofredaxo/nextcloud

REDAXO nextcloud Media Import & Backup Cron
https://github.com/friendsofredaxo/nextcloud

backup-utility cloud nextcloud redaxo redaxo-addon synchronization

Last synced: 11 months ago
JSON representation

REDAXO nextcloud Media Import & Backup Cron

Awesome Lists containing this project

README

          

# 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](https://github.com/klxm)

## Support & Bugs

Fehler bitte auf GitHub melden: [https://github.com/klxm/nextcloud](https://github.com/FriendsOfREDAXO/nextcloud/)