Cómo publicar tu propio plugin en el marketplace de ONLYOFFICE

7 octubre 2022By Sergey

En la versión 7.2 de ONLYOFFICE Docs hemos añadido el nuevo gestor de plugins que te permite navegar por todos los plugins disponibles e instalar o eliminar cualquier plugin con un solo clic en los editores. Si quieres crear y añadir tu propio plugin a nuestro marketplace, sigue los pasos siguientes.

Crea un fork del repositorio

Ojo: necesitarás una cuenta de GitHub y conocimientos básicos para trabajar en GitHub.

Crea un fork del repositorio del marketplace de plugins: https://github.com/ONLYOFFICE/onlyoffice.github.io. Obtendrás un repo con la siguiente dirección – https://github.com/YOUR-USERNAME/ONLYOFFICE/onlyoffice.github.io.
Crea tu propio sitio GitHub Pages desde este repositorio para probar tu plugin en la versión web más adelante.
Clona el fork en tu ordenador local.
Añade una carpeta para tu plugin a onlyoffice.github.io/sdkjs-plugins/content/.

Construye tu plugin

Crea tu plugin como se describe en nuestra documentación de la API.

Por lo tanto, la carpeta de tu plugin debe contener tres archivos principales: config.json, index.html y pluginCode.js. También debes ajustar su estilo, localizarlo, añadir descripciones e iconos.

Prueba tu plugin en la app de escritorio

Descárgate ONLYOFFICE Desktop Editors e instala tu plugin como se describe aquí.

En pocas palabras, necesitas empaquetar todos los archivos del plugin dentro de la carpeta del plugin en un archivo zip, cambiar su extensión a .plugin y añadir tu plugin a través del gestor de plugins.

Después de probarlo, puedes seguir construyendo tu plugin o arreglar los problemas identificados. Puedes ejecutar la aplicación de escritorio en el modo de depuración con la bandera --ascdesktop-support-debug-info. Para hacer esto, sigue las instrucciones aquí dependiendo del sistema operativo que utilices.

Prueba tu plugin en la web

Para crear una extensión, abre el archivo onlyoffice.github.io/store/plugin-dev/extension/inject.js y asigna la ruta de tu plugin en el sitio GitHub Pages a la variable URL_TO_PLUGIN:

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

La carpeta onlyoffice.github.io/store/plugin-dev/extension es una nueva extensión. Súbela al navegador, ejecuta tu ONLYOFFICE Docs (Servidor de Documentos) y encuentra el plugin en el gestor de plugins.

Por favor, ten en cuenta: cuando estás trabajando en tu plugin, es importante abrir el gestor de plugins para comprobar y, si es necesario, mejorar el aspecto de tu plugin allí. También debes tener en cuenta cómo se ve el plugin cuando se cambia al tema oscuro.