Veröffentlichung Ihres eigenen Plugins auf dem ONLYOFFICE-Marketplace

5 Oktober 2022By Vlad

In Version 7.2 von ONLYOFFICE Docs haben wir den neuen Plugin-Manager hinzugefügt, um alle verfügbaren Plugins zu entdecken und jedes Plugin mit nur einem Klick direkt in den Editoren zu installieren oder zu entfernen. Wenn Sie Ihr eigenes Plugin erstellen und zu unserem Marktplatz hinzufügen möchten, folgen Sie bitte den unten stehenden Schritten.

How to publish your own plugin in ONLYOFFICE marketplace

Forken Sie das Repository

Hinweis: Sie benötigen ein GitHub-Konto und Grundkenntnisse der Arbeit auf GitHub.

  • Forken Sie das Repository vom Plugin-Marketplace: https://github.com/ONLYOFFICE/onlyoffice.github.io. Sie erhalten ein Repository mit der folgenden Adresse – https://github.com/IHR-USERNAME/ONLYOFFICE/onlyoffice.github.io.
  • Erstellen Sie Ihre eigene GitHub Pages-Seite aus diesem Repository, um Ihr Plugin später in der Webversion zu testen.
  • Klonen Sie den Fork auf Ihren lokalen Computer.
  • Fügen Sie einen Ordner für Ihr Plugin zu onlyoffice.github.io/sdkjs-plugins/content/ hinzu.

Erstellen Ihres Plugins

Erstellen Sie Ihr Plugin, wie beschrieben in unserer API-Dokumentation.

Der Ordner Ihres Plugins muss also drei wichtigste Dateien enthalten: config.json, index.html und pluginCode.js. Sie müssen auch den Stil anpassen, lokalisieren, Beschreibungen und Symbole hinzufügen.

Testen des Plugins in der Desktop-App

Laden Sie ONLYOFFICE Desktop Editoren herunter und installieren Sie Ihr Plugin, wie hier beschrieben.

Kurz gesagt, Sie müssen alle Plugin-Dateien im Plugin-Ordner in ein ZIP-Archiv packen, seine Erweiterung in .plugin ändern und Ihr Plugin über den Plugin-Manager hinzufügen.

Nach dem Testen können Sie Ihr Plugin weiterentwickeln oder die festgestellten Probleme beheben. Sie können die Desktop-Anwendung im Debug-Modus mit dem Flag --ascdesktop-support-debug-info ausführen. Folgen Sie dazu diesen Anweisungen, je nach dem verwendeten Betriebssystem.

Testen des Plugins im Web

Um ein Plugin zu erstellen, öffnen Sie die Datei onlyoffice.github.io/store/plugin-dev/extension/inject.js und weisen der Variablen URL_TO_PLUGIN den Pfad zu Ihrem Plugin auf GitHub Pages zu:

var URL_TO_PLUGIN = "https://YOUR-USERNAME.github.io/onlyoffice.github.io/sdkjs-plugins/content/helloworld/"

Der Ordner onlyoffice.github.io/store/plugin-dev/extension ist ein neues Plugin. Laden Sie es in den Browser hoch, starten Sie Ihren ONLYOFFICE Docs (Document Server) und suchen Sie das Plugin im Plugin Manager.

Hinweis: Wenn Sie an Ihrem Plugin arbeiten, ist es wichtig, den Plugin-Manager zu öffnen, um zu prüfen und ggf. zu verbessern, wie Ihr Plugin dabei aussieht. Sie müssen auch berücksichtigen, wie das Plugin aussieht, wenn Sie zum Dark-Theme wechseln.

Einreichen Ihres Plugins

Wenn Sie mit dem Plugin fertig sind, stellen Sie einen Pull-Request von Ihrem Fork auf das Repository github.com/ONLYOFFICE/onlyoffice.github.io.

Wenn alles in Ordnung ist und das Plugin fehlerfrei funktioniert, werden wir den PR genehmigen und das Plugin wird auf dem Marketplace erscheinen.

How to publish your own plugin in ONLYOFFICE marketplace