Come aggiungere un plugin nel pannello destro di ONLYOFFICE Docs

La personalizzazione aumenta la produttività consentendo di adattare gli strumenti alle proprie esigenze. Con l’ultimo aggiornamento, i plugin di ONLYOFFICE offrono una flessibilità ancora maggiore. Nel nostro articolo precedente abbiamo mostrato come visualizzare un plugin come scheda. Un’altra preziosa opzione di personalizzazione consente di posizionare il pannello dei plugin sul lato destro o sinistro dell’editor: in questo post del blog approfondiremo questa funzione e ti guideremo passo dopo passo per imparare a implementarla.

Cos’è cambiato?

In precedenza, il file config.json utilizzava diversi parametri per gestire la funzionalità del plugin e determinarne la visualizzazione all’interno dell’editor, quali: isInsideMode, isModal, isSystem, isVisual e menù.

Ora, i vecchi parametri utilizzati nel file config.json sono stati sostituiti da un unico parametro type. Questo nuovo parametro semplifica la configurazione del plugin, offrendo le seguenti opzioni:

• system: Un plugin a livello di sistema che è sempre attivo e non può essere disattivato.
• background: Un plugin in background che viene eseguito continuamente una volta avviato. Il suo stato (abilitato/disabilitato) persiste tra le sessioni.
• window: Un plugin che funziona come finestra indipendente all’avvio.
• panel: Un plugin che si apre nel pannello di sinistra.
• panelRight: Un plugin che si apre nel pannello di destra.
• unvisible: Un plugin che è invisibile all’avvio.

In questo post daremo un’occhiata più da vicino all’opzione panelRight che ci permette di posizionare il pannello sul lato destro dell’editor.

Come implementarlo

Come esempio useremo il plugin Zotero, che consente di creare bibliografie utilizzando il servizio Zotero. Dopo aver installato con successo il plugin, si naviga nella cartella del plugin Zotero all’interno della cartella sdkjs-plugins e si modifica il file config.json. Prendiamo i parametri ormai superati:

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

E sostituiamoli con:

 "type": "panelRight",

Il file modificato config.json può apparire come segue:

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

Dopo aver completato tutte le modifiche, il plugin può apparire come questo:

Nota! Per posizionare il pannello sul lato sinistro, aggiornare l’opzione panelRight a panel.

Speriamo che questo post sia stato utile per capire come personalizzare i plugin in ONLYOFFICE. In ONLYOFFICE ci sforziamo di rendere i nostri prodotti più facili da usare e personalizzabili, in modo da soddisfare le tue esigenze. Questo include la possibilità di personalizzare i plugin in base al tuo flusso di lavoro.

Ti incoraggiamo a sviluppare i tuoi plugin, mentre noi siamo sempre aperti a qualsiasi domanda o suggerimento che tu possa avere. La collaborazione e la discussione sono benvenute per continuare a migliorare insieme l’esperienza di ONLYOFFICE. In bocca al lupo e buon lavoro!