Come pubblicare il tuo plugin nel marketplace di ONLYOFFICE

5 ottobre 2022By Elena

Nella versione 7.2 di ONLYOFFICE Docs abbiamo aggiunto il nuovissimo strumento Plugin manager che ti consente di esplorare tutti i plugin disponibili e installare o rimuovere qualsiasi plugin con un solo clic direttamente negli editor. Se desideri creare e aggiungere il tuo plugin al nostro marketplace, segui la guida.

How to publish your own plugin in ONLYOFFICE marketplace

Eseguire il fork del repository

Ti preghiamo di notare: avrai bisogno di un account GitHub e delle conoscenze di base per lavorare su GitHub.

  • Esegui il fork del repository del marketplace dei plugin: https://github.com/ONLYOFFICE/onlyoffice.github.io. Riceverai un repo con il seguente indirizzo – https://github.com/YOUR-USERNAME/ONLYOFFICE/onlyoffice.github.io.
  • Crea il tuo sito GitHub Pages da questo repository per testare il tuo plugin nella versione web successivamente.
  • Clona il fork sul tuo computer locale.
  • Aggiungi una cartella in cui inserire il tuo plugin onlyoffice.github.io/sdkjs-plugins/content/.

Costruisci il tuo plugin

Crea il tuo plugin come descritto nella nostra documentazione API.

Pertanto, la cartella del plugin deve contenere tre file principali: config.json, index.html e pluginCode.js. Devi anche regolarne lo stile, localizzare, aggiungere descrizioni e icone.

Testa il tuo plugin nell’app desktop

Scarica ONLYOFFICE Desktop Editors e installa il tuo plugin come descritto qui.

Parlando brevemente, devi comprimere tutti i file dei plug-in all’interno della cartella dei plugin in un archivio zip, cambiarne l’estensione in .plugin e aggiungere il plugin tramite il Plugin manager.

Una volta testato, puoi sviluppare ulteriormente il tuo plug-in o risolvere i problemi identificati. Puoi eseguire l’app desktop in modalità di debug con il flag --ascdesktop-support-debug-info. Per fare ciò, segui le istruzioni qui a seconda del sistema operativo in uso.

Testa il tuo plugin nel web

Per creare un’estensione, apri il file onlyoffice.github.io/store/plugin-dev/extension/inject.js e assegna il percorso del tuo plugin sul sito GitHub Pages alla variabile URL_TO_PLUGIN:

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

La cartella onlyoffice.github.io/store/plugin-dev/extension è una nuova estensione. Caricala sul browser, esegui ONLYOFFICE Docs (Document Server) e trova il plugin nel Plugin Manager.

Ti preghiamo di notare: quando lavori sul tuo plugin, è importante aprire il Plugin Manager per controllare e, se necessario, migliorare l’aspetto del tuo plugin lì. Devi anche prendere in considerazione l’aspetto del plugin quando si passa al tema scuro.

Invia il tuo plugin

Quando sei pronto con il plugin, fai una richiesta pull dal tuo fork al repository github.com/ONLYOFFICE/onlyoffice.github.io. Nel caso in cui tutto sia a posto e funzioni correttamente, approveremo la PR e il plugin apparirà sul mercato.

How to publish your own plugin in ONLYOFFICE marketplace