Como adicionar um plug-in no painel direito do ONLYOFFICE Docs

A personalização aumenta sua produtividade, permitindo que você adapte as ferramentas às suas necessidades. Com a última atualização, os plug-ins do ONLYOFFICE oferecem ainda mais flexibilidade. Na versão do artigo anterior, demonstramos como exibir um plug-in como uma guia. Outra opção de personalização valiosa permite que você posicione o painel do plug-in no lado esquerdo ou direito do editor. Nesta postagem do blog, vamos nos aprofundar nesse recurso e orientá-lo passo a passo sobre como implementá-lo.

O que mudou?

Anteriormente, o arquivo config.json usou vários parâmetros para gerenciar a funcionalidade do plug-in e determinar sua exibição no editor, como: isInsideMode, isModal, isSystem, isVisual e menu.

Agora, os parâmetros antigos usados no arquivo config.json foram substituídos por um único parâmetro: type. Esse novo parâmetro simplifica a configuração do plug-in, oferecendo as seguintes opções:

• system: Um plug-in em nível de sistema que está sempre ativo e não pode ser desativado.
• background: Um plug-in em segundo plano que é executado continuamente depois de iniciado. Seu estado (ativado/desativado) persiste entre as sessões.
• window: Um plug-in que funciona como uma janela autônoma ao ser iniciado.
• panel: Um plug-in que é aberto no painel do lado esquerdo.
• panelRight: Um plug-in que é aberto no painel do lado direito.
• unvisible: Um plug-in que fica invisível na inicialização.

Nesta postagem do blog, daremos uma olhada mais de perto na opção panelRight, que nos permite posicionar o painel no lado direito do editor.

Como implementar

Como exemplo, usaremos o Plugin do Zotero, que permite a criação de bibliografias usando o serviço Zotero. Depois de instalar o plug-in com êxito, navegamos até a pasta do plug-in do Zotero no diretório sdkjs-plugins e modificamos o arquivo config.json. Usamos os parâmetros obsoletos:

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

E substituí-los por:

 "type": "panelRight",

O arquivo config.json editado pode ter a seguinte aparência:

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

Depois de concluir todas as modificações, seu plug-in poderá ter a seguinte aparência:

Observação! Para posicionar o painel no lado esquerdo, atualize a opção panelRight para panel.

Esperamos que esta postagem do blog tenha sido útil para entender como personalizar seus plug-ins no ONLYOFFICE. No ONLYOFFICE, nós nos esforçamos para tornar nossos produtos mais fáceis de usar e personalizáveis para que atendam às suas necessidades específicas. Isso inclui dar a você a flexibilidade de adaptar os plugins de acordo com seu fluxo de trabalho.

Incentivamos você a explorar o desenvolvimento de seus próprios plug-ins, e estamos sempre abertos a quaisquer dúvidas ou sugestões que você possa ter. Colaboração e discussão são bem-vindos à medida que continuamos a aprimorar a experiência do ONLYOFFICE juntos. Boa sorte em seus esforços exploratórios!