Comment ajouter un plugin sur le panneau de droite dans ONLYOFFICE Docs

La personnalisation améliore votre productivité en vous permettant d’adapter les outils à vos besoins. Avec la dernière mise à jour, les plugins ONLYOFFICE offrent encore plus de flexibilité. Dans l’article précédent, nous avons montré comment afficher un plugin sous forme d’onglet. Une autre option de personnalisation intéressante vous permet de positionner le panneau des plugins à gauche ou à droite de l’éditeur. Dans cet article de blog, nous allons nous plonger dans cette fonctionnalité et vous guider pas à pas sur la façon de l’implémenter.

Quels sont les changements ?

Précédemment, le fichier config.json utilisait plusieurs paramètres pour gérer les fonctionnalités du plugin et déterminer son affichage dans l’éditeur, tels que : isInsideMode, isModal, isSystem, isVisual et menu.

Désormais, les anciens paramètres utilisés dans le fichier config.json ont été remplacés par un seul paramètre : type. Ce nouveau paramètre simplifie la configuration du plugin en offrant les options suivantes :

• system : Un plugin au niveau du système qui est toujours actif et ne peut pas être désactivé.
• background : Un plugin d’arrière-plan qui fonctionne en continu une fois lancé. Son état (activé/désactivé) persiste entre les sessions.
• window : Un plugin qui fonctionne comme une fenêtre autonome lors de son lancement.
• panel : Un plugin qui s’ouvre dans le panneau de gauche.
• panelRight : Un plugin qui s’ouvre dans le panneau de droite.
• unvisible : Un plugin invisible au démarrage.

Dans cet article de blog, nous allons examiner de plus près l’option panelRight, qui nous permet de positionner le panneau sur le côté droit de l’éditeur.

Comment implémenter

À titre d’exemple, nous utiliserons le plugin Zotero, qui permet de créer des bibliographies à l’aide du service Zotero. Après avoir installé le plugin avec succès, nous naviguons vers le dossier du plugin Zotero dans le répertoire sdkjs-plugins et nous modifions le fichier config.json. Nous prenons les paramètres dépréciés :

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

Et les remplaçons par :

 "type": "panelRight",

Le fichier config.json modifié peut ressembler à ce qui suit :

{
    "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"
                ]
            }
        }
    ]
}

Après avoir effectué toutes les modifications, votre plugin peut ressembler à ceci :

Remarque ! Pour positionner le panneau sur le côté gauche, modifiez l’option panelRight en panel.

Nous espérons que cet article vous a aidé à comprendre comment personnaliser vos plugins dans ONLYOFFICE. Chez ONLYOFFICE, nous nous engageons à rendre nos produits plus conviviaux et personnalisables afin qu’ils répondent à vos besoins précis. Cela inclut la flexibilité de personnaliser les plugins en fonction de votre flux de travail.

Nous vous encourageons à développer vos propres plugins, et nous sommes toujours ouverts à vos questions et suggestions. La collaboration et la discussion sont les bienvenues car nous continuons à améliorer l’expérience ONLYOFFICE ensemble. Nous vous souhaitons bonne chance dans vos projets exploratoires !