Como publicar seu próprio plugin no marketplace ONLYOFFICE

7 outubro 2022By Klaibson

Na versão 7.2 do ONLYOFFICE Docs, adicionamos o novo gerenciador de plug-ins que permite explorar todos os plug-ins disponíveis e instalar ou remover qualquer plug-in com apenas um clique nos editores. Se você deseja criar e adicionar seu próprio plug-in ao nosso mercado, siga as etapas abaixo.

Bifurcar o repositório

Observação: você precisará de uma conta do GitHub e conhecimento básico de como trabalhar no GitHub.

Fork o repositório do marketplace de plugins: https://github.com/ONLYOFFICE/onlyoffice.github.io. Você receberá um repo com o seguinte endereço – https://github.com/SEU-NOMEDEUSUARIO/ONLYOFFICE/onlyoffice.github.io.
Construa o seu próprio GitHub site deste repositório para testar seu plugin na versão web mais tarde.
Clone o fork para o seu computador local.
Adicione uma pasta para o seu plugin para onlyoffice.github.io/sdkjs-plugins/content/.

Construa seu plug-in

Crie seu plugin conforme descrito em nossa documentação da API.

Portanto, sua pasta de plugins deve conter três arquivos principais: config.json, index.html, e pluginCode.js. Você também precisa ajustar seu estilo, localizar, adicionar descrições e ícones.

Teste seu plug-in no aplicativo para desktop

Baixe ONLYOFFICE Desktop Editors e instale seu plugin conforme descrito aqui.

Falando brevemente, você precisa empacotar todos os arquivos de plug-in dentro da pasta do plug-in em um arquivo zip, alterar sua extensão para .plugin e adicionar seu plug-in por meio do gerenciador de plug-ins.

Uma vez testado, você pode construir seu plugin ainda mais ou corrigir os problemas identificados. Você pode executar o aplicativo de desktop no modo de depuração com o --ascdesktop-support-debug-info bandeira. Para fazer isso, siga as instruções aqui dependendo do sistema operacional que você usa.

Teste seu plugin na web

Para criar uma extensão, abra o onlyoffice.github.io/store/plugin-dev/extension/inject.js arquivo e atribua o caminho para o seu plugin no site do GitHub Pages para o URL_TO_PLUGIN variável:

var URL_TO_PLUGIN = "https://YOUR-USERNAME.github.io/onlyoffice.github.io/sdkjs-plugins/content/helloworld/"

O onlyoffice.github.io/store/plugin-dev/extension pasta é uma nova extensão. Carregue-o para o navagador, execute seu ONLYOFFICE Docs (Servidor de Documentos) e encontre o plug-in no Gerenciador de plug-ins.

Observação: quando você estiver trabalhando em seu plugin, é importante abrir o Gerenciador de plugins para verificar e, se necessário, melhorar a aparência do seu plugin. Você também precisa levar em consideração a aparência do plug-in ao alternar para o tema escuro.