Artikel zum Thema:
Schließen
Changelog
Schließen
In der cloud testen
In der cloud testen
Hilfe-Center
Integration

Über die ONLYOFFICE- und Moodle-Integration

ONLYOFFICE bietet einen offiziellen Konnektor, um ONLYOFFICE Docs mit Moodle zu integrieren und Office-Dokumente zu bearbeiten, die an die Kursseiten angehängt sind. Sie können den ONLYOFFICE-Konnektor von der Moodle Plugin-Bibliothek oder von der GitHub-Seite herunterladen.

Haupteigenschaften

  • Bearbeiten und Anzeigen von Textdokumenten, Tabellenkalkulationen, Präsentationen und Formularen.
    Um mehr über Formulare zu erfahren, lesen Sie bitte die entsprechenden Artikel zum Erstellen und Ausfüllen von Formularen.
  • Gemeinsame Bearbeitung von Dokumenten in Echtzeit: zwei Bearbeitungs-Modi (Schnell und Formal). Verfolgen Sie Änderungen und verwenden Sie Kommentare und den integrierten Chat.
  • JWT-Unterstützung, um Ihren Datenverkehr zu sichern, damit niemand mit Ausnahme der Benutzer mit den entsprechenden Rechten auf Ihre Dokumente zugreifen können.

Unterstützte Formate

  • Anzeigen und Bearbeiten: DOCX, XLSX, PPTX, DOCXF
  • Nur Anzeigen: PDF, TXT, CSV
  • Ausfüllen von Formularen: OFORM

Was gibt es Neues in Versionen 2.2.0 und 3.0.0

Hinzugefügt

  • Schutzoption für Editor
  • Fähigkeit hinzufügen, Editor im Vollbildmodus zu öffnen
  • Erwähnungen in Kommentaren im Editor hinzufügen
  • "Speichern als" im Editor
  • Fähigkeit hinzufügen, Aktivität mit leerer Datei zu erstellen
  • Favicon auf Editorseite hinzufügen
  • Anpassung der Editor-Oberfläche
  • de, es, fr, it, ja, ru, zh_cn Übersetzungen
  • Unterstützung für ONLYOFFICE-Formulare hinzufügen

Geändert

  • Sprache der Editoroberfläche einstellen
  • Korrekturen beim Erstellen von Backups und Wiederherstellungen
  • Neugestaltung auf Moodle 4

Das vollständige Änderungsprotokoll ist hier verfügbar.

Verbinden von ONLYOFFICE Docs mit Moodle

Anforderungen

  • ONLYOFFICE Docs (Document Server) 4.2.7 oder höher

    Sie benötigen eine Instanz von ONLYOFFICE Docs, die sowohl von Moodle als auch von beliebigen End-Clients auflösbar und verbindbar ist. Die Instanz muss direkt an Moodle POSTen können.

    Weitere Informationen finden Sie auf der offiziellen Dokumentationsseite über die Installation von ONLYOFFICE Docs.
  • Moodle v3.9.10 oder höher
  • ONLYOFFICE-Konnektor v3.0.0 für Moodle

Installieren des ONLYOFFICE-Konnektors für Moodle

Moodle Plugin-Bibliothek verwenden
  1. Melden Sie sich als Administrator bei Ihrer Moodle-Instanz an und öffnen Sie Site administration > Plugins > Install plugins.
    Wenn Sie diesen Speicherort nicht finden können, ist die Plugin-Installation auf Ihrer Webseite deaktiviert.
  2. Klicken Sie auf die Schaltfläche Install plugins from Moodle plugins directory.
  3. Wählen Sie Ihre aktuelle Moodle-Version aus.
  4. Suchen Sie nach dem Plugin ONLYOFFICE document.
  5. Klicken Sie auf die Schaltfläche Install, dann klicken Sie auf Continue.
  6. Bestätigen Sie die Installationsanfrage.
  7. Überprüfen Sie den Plugin-Validierungsbericht.
    Es ist äußerst wichtig, dass Sie Ihre Moodle-Version richtig auswählen. Wenn Sie versehentlich die falsche Version des Plugins für Ihren Moodle-Server herunterladen und installieren, kann dies zu ernsthaften Problemen führen, bis hin zum Einfrieren der Moodle-Seite.
GitHub .ZIP-Archiv verwenden
  1. Laden Sie den Konnektor von der GitHub-Seite herunter.
  2. Melden Sie sich als Administrator bei Ihrer Moodle-Instanz an, gehen Sie zum Abschnitt Site administration, wechseln Sie zur Registerkarte Plugins und klicken Sie auf den Link Install plugins.
  3. Laden Sie die Datei moodle-mod_onlyofficeeditor-x.x.x.zip über die Dateiauswahl hoch oder ziehen Sie sie per Drag-and-Drop in das entsprechende Feld und klicken Sie auf die Schaltfläche Install plugin from the ZIP file.
    ONLYOFFICE_connector ONLYOFFICE_connector
  4. Überprüfen Sie den Plugin-Validierungsbericht und klicken Sie auf Continue.
    Wenn Ihr Zielverzeichnis nicht beschreibbar ist, erhalten Sie eine Warnmeldung, z.B. [Error] Write access check [/var/www/html/moodle/mod]. In diesem Fall können Sie es mit dem folgenden Befehl vorübergehend beschreibbar machen:
    sudo chmod -R 777 /var/www/html/moodle

    Wiederholen Sie danach Schritt 3.

    Nach der Installation des Plugins müssen Sie die Berechtigungen zurücksetzen, damit das Verzeichnis nicht mehr beschreibbar ist. Verwenden Sie den folgenden Befehl:

    sudo chmod -R 0755 /var/www/html/moodle
  5. Klicken Sie auf der Seite Current release information -> Server checks auf Continue.
  6. Klicken Sie auf der Seite Plugins check auf Upgrade Moodle database now.
    ONLYOFFICE_connector ONLYOFFICE_connector
  7. Klicken Sie auf der Seite Upgrading to new version auf Continue.

Konfigurieren des ONLYOFFICE-Konnektors für Moodle

Sobald das Plugin installiert ist, wird die Seite mit den Plugin-Einstellungen geöffnet. Alternativ finden Sie das ONLYOFFICE document auf der Seite Plugins overview und klicken auf Settings. Auf der Seite Settings können Sie die folgenden Parameter konfigurieren:

  • Geben Sie in das Feld Document Editing Service address die Adresse ein, die für den Zugriff auf das Document Editing Service von Moodle verwendet wird. Dieses Feld ist obligatorisch.
  • Geben Sie optional das zum Signieren der Daten verwendete Geheimnis im Feld Document Server Secret an. Der geheime Schlüssel wird verwendet, um das JSON-Web-Token bei der Anforderung an Document Server zu validieren. Weitere Informationen finden Sie in der API-Dokumentation zur Konfiguration von JWT auf dem ONLYOFFICE Docs-Seite.
    Ab ONLYOFFICE Docs v7.2 ist JWT standardmäßig aktiviert und der geheime Schlüssel wird automatisch generiert. Sie müssen es auch auf der Moodle-Seite aktivieren: Suchen Sie Ihren geheimen Schlüssel in der ONLYOFFICE Docs-Konfigurationsdatei und geben Sie dann denselben geheimen Schlüssel in den Konnektor-Einstellungen an. Weitere Einzelheiten finden Sie im Abschnitt Aktivieren von JWT für die ONLYOFFICE- und Moodle-Integration in diesem Artikel.
  • Enable Force Save - wenn diese Option deaktiviert ist, werden Ihre Änderungen automatisch im Editor-Cache gespeichert. Wenn diese Option aktiviert ist, werden alle Änderungen an einem Dokument direkt an den Speicher gesendet, wenn Sie auf die Schaltfläche Save klicken.
  • Geben Sie optional die Anpassungseinstellungen des Editors an, indem Sie die erforderlichen Kontrollkästchen aktivieren:
    • Display Chat menu button - diese Option wird verwendet, um die Chat-Menüschaltfläche anzuzeigen oder auszublenden.
    • Display Help menu button - diese Option wird verwendet, um die Hilfemenü-Schaltfläche anzuzeigen oder auszublenden.
    • Display the header more compact - diese Option wird verwendet, um die zusätzlichen Aktionsschaltflächen entweder im oberen Teil der Kopfzeile des Editorfensters neben dem Logo oder in der Symbolleiste anzuzeigen.
    • Display Feedback & Support menu button - diese Option wird verwendet, um die Menüschaltfläche „Feedback & Support“ anzuzeigen oder auszublenden.
    • Display monochrome toolbar header - diese Option wird verwendet, um die Editor-Symbolleiste in Monochrom anzuzeigen.

Wenn Sie bereits sind, klicken Sie auf Save changes.

ONLYOFFICE_configure ONLYOFFICE_configure

Aktivieren von JWT für die ONLYOFFICE- und Moodle-Integration

Um Dokumente vor unbefugtem Zugriff zu schützen, verwenden ONLYOFFICE-Editoren das JSON Web Token (JWT). Das Token wird in der Konfiguration hinzugefügt, wenn der Dokumenteneditor initialisiert wird und während des Austauschs von Befehlen zwischen internen ONLYOFFICE Docs-Diensten. Der geheime Schlüssel wird verwendet, um das JSON-Web-Token zu signieren und das Token auf Anfrage an ONLYOFFICE Docs zu validieren.

Ab ONLYOFFICE Docs v7.2 ist JWT standardmäßig aktiviert und der geheime Schlüssel wird automatisch generiert. Sie müssen Ihren geheimen Schlüssel in der ONLYOFFICE Docs-Konfigurationsdatei finden und dann denselben geheimen Schlüssel in den Konnektor-Einstellungen angeben.

Schritt 1: Ihren geheimen Schlüssel in der Konfigurationsdatei von ONLYOFFICE Docs finden

  1. Öffnen Sie die Datei local.json mit einem beliebigen verfügbaren Texteditor.
    • Für Linux - /etc/onlyoffice/documentserver/local.json
    • Für Windows - %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json
    • Für Docker – öffnen Sie den ONLYOFFICE Docs-Kontainer mit dem Befehl docker exec -it <containerID> bash und öffnen Sie /etc/onlyoffice/documentserver/local.json

    Die local.json-Datei sollte wie folgt aussehen:

    {
      "services": {
        "CoAuthoring": {
          "token": {
            "enable": {
              "request": {
                "inbox": true,
                "outbox": true
              },
              "browser": true
            }
          },
          "secret": {
            "inbox": {
              "string": "yoursecret"
            },
            "outbox": {
              "string": "yoursecret"
            },
            "session": {
              "string": "yoursecret"
            }
          }
        }
      }
    }
    
  2. Der Wert true wird in drei Abschnitten angegeben. Dies bedeutet, dass die Token-Validierung aktiviert ist.
    • services.CoAuthoring.token.enable.browser
    • services.CoAuthoring.token.enable.request.inbox
    • services.CoAuthoring.token.enable.request.outbox
  3. Der automatisch generierte geheime Schlüssel wird in drei Abschnitten angegeben. Sie können den standardmäßigen geheimen Wert durch Ihren eigenen geheimen Schlüssel ersetzen. Der geheime Schlüssel muss in drei Abschnitten gleich sein.
    • services.CoAuthoring.secret.inbox.string
    • services.CoAuthoring.secret.outbox.string
    • services.CoAuthoring.secret.session.string
  4. Wenn Sie Änderungen vornehmen, speichern Sie diese Änderungen und starten Sie die Dienste neu, damit die Konfigurationsänderungen aktualisiert werden.
    supervisorctl restart all

Schritt 2: Denselben geheimen Schlüssel in den Konnektor-Einstellungen angeben

Geben Sie in den Konnektor-Einstellungen dasselbe Geheimnis im Feld Secret Key an und speichern Sie die Einstellungen.

Verwendung von ONLYOFFICE Docs in Moodle

Hinzufügen von ONLYOFFICE-Aktivitäten

Um eine neue ONLYOFFICE-Aktivität zu erstellen:

  1. Öffnen Sie den Bereich My Courses und wechseln Sie zum gewünschten Kurs.
  2. Aktivieren Sie Edit Mode mit dem Umschalter oben rechts.
  3. Klicken Sie auf Add an activity or resource.
  4. Wählen Sie im Pop-Up-Fenster die Aktivität ONLYOFFICE document aus.
    ONLYOFFICE_editfile ONLYOFFICE_editfile
  5. Geben Sie den Aktivitätsnamen ein, laden Sie das erforderliche Dokument hoch oder ziehen Sie es per Drag-and-Drop von Ihrem PC ab und klicken Sie auf die Schaltfläche Save and display.
    ONLYOFFICE_editfile ONLYOFFICE_editfile

    Die Aktivität kann eine leere .docx-, .xlsx-, .pptx- oder .docxf-Datei sein.

Das Dokument wird im ONLYOFFICE Docs-Editor geöffnet.

ONLYOFFICE_editfile ONLYOFFICE_editfile

Dateien anzeigen und bearbeiten

ONLYOFFICE-Aktivitäten werden mit dem Symbol ONLYOFFICE_editfile gekennzeichnet auf Ihren Kursseiten. Um ein Dokument im ONLYOFFICE Docs-Editor zu öffnen, klicken Sie einfach auf seinen Titel.

ONLYOFFICE_readfile ONLYOFFICE_readfile

Um den Editor im Vollbildmodus zu öffnen, klicken Sie oben rechts über dem Editorfenster auf die Schaltfläche Open full screen.

Dateien mit einem Passwort schützen

ONLYOFFICE-Dateien können mit einem Passwort geschützt werden, um unbefugten Zugriff zu verhindern:

  1. Gehen Sie zur Registerkarte Datei in der oberen Symbolleiste.
  2. Wählen Sie die Option Schützen.
  3. Klicken Sie auf die Schaltfläche Kennwort hinzufügen.
  4. Legen Sie im Feld Kennwort ein Passwort fest und wiederholen Sie es unten im Feld Kennwort wiederholen. Klicken Sie dann auf OK.

    Das Passwort kann nicht wiederhergestellt werden, wenn Sie es verlieren oder vergessen. Bitte bewahren Sie es an einem sicheren Ort auf.

Um das Kennwort zu ändern,

  1. Gehen Sie zur Registerkarte Datei in der oberen Symbolleiste.
  2. Wählen Sie die Option Schützen.
  3. Klicken Sie auf die Schaltfläche Kennwort ändern.
  4. Legen Sie im Feld Kennwort ein Passwort fest und wiederholen Sie es unten im Feld Kennwort wiederholen. Klicken Sie dann auf OK.

Um das Kennwort zu löschen,

  1. Gehen Sie zur Registerkarte Datei in der oberen Symbolleiste.
  2. Wählen Sie die Option Schützen.
  3. Klicken Sie auf die Schaltfläche Kennwort löschen.

Um die Schutzoption zu deaktivieren,

  1. Öffnen Sie die Aktivitätsbearbeitungsseite.
  2. Öffnen Sie den Abschnitt Document permissions.
  3. Aktivieren Sie das Kontrollkästchen Hide Protection tab box.

Berechtigungen verwalten

Administratoren/Lehrer können wählen, ob Dokumente aus dem ONLYOFFICE-Editor heruntergeladen oder gedruckt werden können. Dies kann im Abschnitt Document permissions erfolgen.

ONLYOFFICE_editfile ONLYOFFICE_editfile

Um die Dokumentberechtigung in schreibgeschützt zu ändern:

  1. Öffnen Sie das benötigte ONLYOFFICE-Dokument.
  2. Öffnen Sie More -> Permissions.
  3. Suchen Sie den Eintrag Edit ONLYOFFICE document activity/View ONLYOFFICE document activity.
  4. Fügen Sie die erforderlichen Rollen im Abschnitt Prohibited hinzu oder entfernen Sie die Rollen aus dem Abschnitt Roles with permission.
ONLYOFFICE_editfile ONLYOFFICE_editfile

Um zu erfahren, wie Sie das Dokument direkt im Editor als Favorit markieren, befolgen Sie bitte die Anweisungen in diesem Artikel.

Herunterladen Beste Editoren auf Ihrer Webseite Lassen Sie Ihre Seite-Benutzer alle Arten von Text-, Tabellenkalkulations- und Präsentationsdateien
öffnen und gemeinsam bearbeiten
Wer sich dafür interessiert hat,
hat auch das Folgende gelesen:
Schließen