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!
