Hinzufügen eines Plugins auf der rechten Seite von ONLYOFFICE Docs

Anpassungen steigern Ihre Produktivität, da Sie die Tools an Ihre Bedürfnisse anpassen können. Mit dem neuesten Update bieten die ONLYOFFICE-Plugins noch mehr Flexibilität. Im vorigen Beitrag haben wir beschrieben, wie Sie ein Plugin als Registerkarte anzeigen können. Eine weitere wertvolle Anpassungsoption ermöglicht es Ihnen, das Plugin-Panel entweder auf der linken oder rechten Seite des Editors zu positionieren. In diesem Beitrag gehen wir auf diese Funktion ein und zeigen Ihnen Schritt für Schritt, wie Sie sie implementieren können.

Was wurde geändert?

Bisher wurden in der Datei config.json mehrere Parameter verwendet, um die Funktionalität des Plugins zu verwalten und seine Anzeige im Editor zu bestimmen, z. B.: isInsideMode, isModal, isSystem, isVisual und menu.

Jetzt wurden die älteren Parameter in der Datei config.json durch einen einzigen Parameter ersetzt: type. Dieser neue Parameter vereinfacht die Plugin-Konfiguration, indem er die folgenden Optionen bietet:

• system: Ein Plugin auf Systemebene, das immer aktiv ist und nicht deaktiviert werden kann.
• background: Ein Hintergrund-Plugin, das nach dem Start kontinuierlich läuft. Sein Status (aktiviert/deaktiviert) bleibt zwischen den Sitzungen bestehen.
• window: Ein Plugin, das beim Start als eigenständiges Fenster arbeitet.
• panel: Ein Plugin, das auf der linken Seite des Fensters geöffnet wird.
• panelRight: Ein Plugin, das im rechten Fenster geöffnet wird.
• unvisible: Ein Plugin, das beim Starten unsichtbar ist.

In diesem Blogbeitrag werden wir uns die Option panelRight genauer ansehen, mit der wir das Panel auf der rechten Seite des Editors positionieren können.

Implementierung

Als Beispiel verwenden wir das Zotero-Plugin, das die Erstellung von Bibliographien über den Zotero-Dienst ermöglicht. Nach erfolgreicher Installation des Plugins navigieren wir zum Zotero-Plugin-Ordner im Verzeichnis sdkjs-plugins und ändern die Datei config.json. Wir nehmen die veralteten Parameter:

 "isVisual": true,
 "isModal": false,
 "isInsideMode": true,

Und ersetzen wir sie durch:

 "type": "panelRight",

Die bearbeitete config.json-Datei könnte wie folgt aussehen:

{
    "name": "Zotero",
    "nameLocale": {
        "ru": "Zotero",
        "fr": "Zotero",
        "es": "Zotero",
        "pt-BR": "Zotero",
        "de": "Zotero"
    },
    "guid": "asc.{BFC5D5C6-89DE-4168-9565-ABD8D1E48711}",
    "version": "1.0.3",
    "minVersion": "7.3.3",
    "variations": [
        {
            "description": "Create bibliographies in the required style using Zotero service.",
            "descriptionLocale": {
                "ru": "Оформляйте библиографические списки в нужном стиле с помощью Zotero.",
                "fr": "Créez des bibliographies dans le style nécessaire avec Zotero.",
                "es": "Cree bibliografías en el estilo requerido utilizando el servicio Zotero.",
                "pt-BR": "Crie bibliografias no estilo desejado usando o serviço Zotero.",
                "de": "Erstellen Sie Literaturverzeichnisse im gewünschten Stil mittels Zotero."
            },
            "url": "index.html",
            "icons": [
                "resources/light/icon.png",
                "resources/light/icon@2x.png"
            ],
            "icons2": [
                {
                    "style": "light",
                    "100%": {
                        "normal": "resources/light/icon.png"
                    },
                    "125%": {
                        "normal": "resources/light/icon@1.25x.png"
                    },
                    "150%": {
                        "normal": "resources/light/icon@1.5x.png"
                    },
                    "175%": {
                        "normal": "resources/light/icon@1.75x.png"
                    },
                    "200%": {
                        "normal": "resources/light/icon@2x.png"
                    }
                },
                {
                    "style": "dark",
                    "100%": {
                        "normal": "resources/dark/icon.png"
                    },
                    "125%": {
                        "normal": "resources/dark/icon@1.25x.png"
                    },
                    "150%": {
                        "normal": "resources/dark/icon@1.5x.png"
                    },
                    "175%": {
                        "normal": "resources/dark/icon@1.75x.png"
                    },
                    "200%": {
                        "normal": "resources/dark/icon@2x.png"
                    }
                }
            ],
            "isViewer": false,
            "EditorsSupport": [
                "word"
            ],
            "initDataType": "text",
            "initData": "",
            "type": "panelRight",
            "isUpdateOleOnResize": false,
            "initOnSelectionChanged": false,
            "store": {
                "background": {
                    "light": "#2D3037",
                    "dark": "#2D3037"
                },
                "screenshots": [
                    "resources/store/screenshots/screen_1.png",
                    "resources/store/screenshots/screen_2.png"
                ],
                "icons": {
                    "light": "resources/store/icons",
                    "dark": "resources/store/icons"
                },
                "categories": [
                    "specAbilities"
                ]
            }
        }
    ]
}

Nachdem Sie alle Änderungen vorgenommen haben, könnte Ihr Plugin so aussehen:

Hinweis! Um das Panel auf der linken Seite zu positionieren, aktualisieren Sie die Option panelRight auf panel.

Wir hoffen, dass dieser Blogbeitrag hilfreich war, um zu verstehen, wie Sie Ihre Plugins in ONLYOFFICE anpassen können. Wir bei ONLYOFFICE sind bestrebt, unsere Produkte benutzerfreundlicher und anpassungsfähiger zu gestalten, damit sie genau Ihren Bedürfnissen entsprechen. Dazu gehört auch, dass wir Ihnen die Flexibilität geben, Plugins an Ihren Arbeitsablauf anzupassen.

Wir möchten Sie einladen, Ihre eigenen Plugins zu entwickeln, und wir sind immer offen für Ihre Fragen und Vorschläge. Wir freuen uns auf die Zusammenarbeit und Diskussion, um das ONLYOFFICE-Erlebnis gemeinsam weiter zu verbessern. Viel Erfolg!