Unsaon Paghimo sa Imong Kaugalingong Plugin para sa ONLYOFFICE Docs

Mubo: Niining artikuloha, makakat-on ka unsaon paghimo sa imong kaugalingong plugin para sa ONLYOFFICE Docs ug unsaon kini pagmantala sa opisyal nga merkado sa plugin nga anaa sugod sa bersyon 7.2.

nag-browse ug nag-convert sa mga PDF file, ug uban pa.

Bisan pa, adunay usa ka paagi aron mahimo ang ONLYOFFICE nga labi ka kusgan. Ang gipasabot dinhi mao ang mga third-party nga plugins, i.e. dugang nga software tools nga makapauswag sa standard functional nga kapabilidad sa suite. Pananglitan, ang mga plugin nagpaposible sa pagkonektar sa mga serbisyo sa ikatulo nga partido o pagdugang sa bag-ong mga elemento sa user interface.

Unsaon Paghimo ug Plugin para sa ONLYOFFICE Docs

Sa dili ka pa magsugod sa paghimo sa imong kaugalingon nga plugin para sa ONLYOFFICE Docs, kinahanglan nimo nga sigurohon nga ikaw adunay GitHub nga dokumentasyon.

Ang proseso sa paghimo sa plugin mahimong bahinon sa pito ka mga lakang nga kinahanglan nimong sundon pag-ayo:

  • Paunang mga kalihokan.
  • Pag-coding.
  • Pag-adjust sa estilo sa plugin.
  • Localization (opsyonal).
  • Pagpangandam.
  • Pagsulay.
  • Publikasyon sa merkado sa plugin.

Atong susihon pag-ayo ang pag-uswag sa plugin.

Una sa tanan, kinahanglan ka nga mag-log in sa imong GitHub account o maghimo usa kung wala ka. Pagkahuman niana, kinahanglan nimo nga maghimo usa ka tinidor sa ONLYOFFICE plugin marketplace repository nga magamit sa mosunod nga URL address:

https://github.com/ONLYOFFICE/onlyoffice.github.io.

Ingon usa ka sangputanan, ikaw adunay lain nga tipiganan, ug ang adres sa URL niini mahimong sama niini:

https://github.com/YOUR-USERNAME/ONLYOFFICE/onlyoffice.github.io

Pagkahuman sa malampuson nga pag-forking sa repo sa merkado sa plugin, kinahanglan nga maghimo usa ka site sa GitHub Pages gikan sa kini nga repository alang sa mga katuyoan sa pagsulay. Kung wala ka mahibal-an kung giunsa kini buhaton, palihug tan-awa ang opisyal nga giya sa GitHub.

Karon nga naa kay kaugalingon nga site sa GitHub Pages, panahon na nga i-clone ang fork sa imong computer.

Sa katapusan, kinahanglan ka maghimo usa ka folder alang sa imong umaabot nga plugin sa:

onlyoffice.github.io/sdkjs-plugins/content/.

Mao na. Nakompleto na nimo ang tanan nga gikinahanglan nga pasiuna nga mga kalihokan ug makapadayon sa sunod nga lakang.

Dili nimo kinahanglan nga labi ka maayo sa coding apan siguradong kinahanglan nimo ang pipila ka sukaranan nga kahibalo sa coding aron mahimo ang imong kaugalingon nga plugin para sa ONLYOFFICE Docs.

Sa laktod nga pagkasulti, ang usa ka ONLYOFFICE nga plugin usa ka folder nga adunay daghang mga file. Kinahanglan ka nga maghimo og tulo ka mga file aron ang imong plugin molihok sa husto:

  • config.json – Kini usa ka plugin configuration file nga adunay impormasyon bahin sa tanang importanteng datos. Sa kini nga file, adunay pipila ka mga parameter nga gikinahanglan aron marehistro ang plugin sa mga editor sa ONLYOFFICE. Tan-awa ang kini nga panid sa opisyal nga dokumentasyon sa API aron mabasa ang tibuuk nga paghulagway sa matag parameter.
  • plugin code (.js file) – Kini ang plugin file mismo nga adunay sulod sa JavaScript code sa imong plugin. Gihubit sa kini nga file ang mga operasyon nga gihimo sa plugin ug kung giunsa kini gihimo. Basaha kini nga giya sa API aron mahibal-an kung giunsa kini paglihok.
  • index.html – Kini ang entry point sa imong plugin nga nagkonektar sa config.json ug plugin.js files. Tan-awa kini nga pananglitan aron masabtan kung unsa ang hitsura niini.

Gawas niining mga obligado nga mga file, ang plugin nga folder mahimong maglangkob sa ubang mga file. Pananglitan, mga icon, estilo sa plugin, readme files, third-party services, ug uban pa. Makita nimo ang dugang impormasyon bahin sa maong mga file sa ubos.

Aron magsulat usa ka maayo nga code sa pagtrabaho alang sa imong plugin, kinahanglan nimo mahibal-an ang kinahanglan nga mga panghitabo.

Ang pagsulat sa code alang sa imong plugin dili igo. Kinahanglan usab nimo nga ayohon ang istilo niini aron kini ingon usa ka hinungdanon nga bahin sa mga editor sa ONLYOFFICE. Aron mahimo kini, idugang lang ang ONLYOFFICE style sheet sa index.html file nga gihulagway sa ibabaw:

<link rel="stylesheet" href="https://onlyoffice.github.io/sdkjs-plugins/v1/plugins.css">

Mahimo nimong idugang ang mga buton, mga kontrol sa input, mga kontrol sa label, mga loader, ug uban pang mga elemento.

Pananglitan, aron makadugang ug combo box sa imong plugin, mahimo nimong gamiton ang select2 function:

<select id="select_example" class="" ></select> 
$('#select_example').select2({     
data : [{id:0, text:'Item 1'}, {id:1, text:'Item 2'}, {id:2, text:'Item 3'}],     
minimumResultsForSearch: Infinity,     
width : '120px' 
});

Ang gisulod nga combo box mahimong sama niini:

Dugang nga impormasyon bahin sa ONLYOFFICE style nga mga elemento makita dinhi.

Mahimo nimong laktawan kini nga lakang kung maghimo ka usa ka plugin para sa mga tiggamit nga nagsultig English lamang. Bisan pa, kung gusto nimo nga magamit ang imong plugin sa ubang mga lengguwahe, mahimo nimong buhaton ang folder sa mga hubad sa direktoryo sa plugin ug ibutang ang ilang mga .json file para sa tanan nga mga pinulongan nga gusto nimong gamiton.

Basaha ang opisyal nga dokumentasyon sa API aron mahibal-an kung giunsa dinhi aron ma-localize ang imong plugin sa husto.

Aron mapasinaw ang hitsura sa imong plugin sa dili pa kini magamit sa ONLYOFFICE nga merkado, kinahanglan nimo nga idugang ang usa ka About window nga adunay mubo nga paghulagway sa imong plugin, ang bersyon niini, ang ngalan sa developer, ug uban pa.

Pananglitan, kini ang About window sa Photo Editor plugin:

Aron makahimo sa ingon nga bintana alang sa imong plugin, sunda kini nga mga panudlo.

Usab, kinahanglan nimo nga maghimo mga icon alang sa imong plugin ug ibutang kini sa folder sa mga kapanguhaan. Sa kinatibuk-an, kinahanglan nimo ang 8 nga mga icon aron ang imong plugin magpakita sa husto sa ONLYOFFICE plugin marketplace: 4 icons (125%, 150%, 175%, ug 200% scaling) para sa Light and Dark interface nga mga tema.

Dugang pa, makahimo ka og readme file ug ibutang kini sa main folder nga plugin. Kini nga file mahimong maglakip sa bisan unsang impormasyon nga gusto nimo nga mahibal-an sa ubang mga tiggamit - usa ka paghulagway sa mga nag-unang bahin sa imong plugin, mga instruksyon sa pag-instalar, nahibal-an nga mga isyu, ug mga bug, ug uban pa.

Karon ang imong plugin andam na, ug mahimo nimo kini sulayan sa husto sa dili pa kini imantala sa merkado.

Karon na ang panahon nga ibutang ang tanan nga mga file nga imong nahimo sumala sa mga panudlo sa ibabaw sa folder sa plugin. Dayon iduso ang plugin folder sa hilit nga repository ug sulayi ang plugin sa ONLYOFFICE Desktop Editors. Alang niini nga katuyoan, mahimo nimong ipadagan ang desktop app sa debugging mode.

Sa Linux, mahimo nimong ablihan ang terminal gamit ang CTRL+ALT+T. Pagkahuman niana, pagsulod sa agianan sa ONLYOFFICE Desktop Editors, pagdugang usa ka wanang ug dayon ipiho ang --ascdesktop-support-debug-info:

"/opt/onlyoffice/desktopeditors/DesktopEditors" --ascdesktop-support-debug-info

Sulayi ang imong plugin ug ang mga bahin niini.

Kung OK ra ang tanan, mahimo usab nimo sulayan ang imong plugin sa web nga bersyon sa ONLYOFFICE suite, ONLYOFFICE Docs. Sa laing pagkasulti, ang imong plugin mahimong idugang isip bag-ong extension.

Aron mahimo ang katugbang nga extension, kinahanglan nimong ablihan ang onlyoffice.github.io/store/plugin-dev/extension/inject.js file ug ipiho ang agianan sa imong plugin sa GitHub Pages site sa URL_TO_PLUGIN variable:

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

Ang onlyoffice.github.io/store/plugin-dev/extension folder mao ang extension nga imong gikinahanglan. I-upload lang kini sa imong web browser, unsaon pagdugang og plugin sa usa ka web browser.

Kung ang imong plugin molihok sama sa gituyo, mahimo nimong ipadayon ang katapusang lakang.

Mga pahalipay! Nakaagi ka na sa proseso sa paghimo sa plugin ug karon mahimo nimong magamit ang imong plugin alang sa ubang mga tiggamit. Alang niini nga katuyoan, mahimo kang maghimo ug pull request gikan sa imong fork ngadto niining ONLYOFFICE repository sa:

https://github.com/ONLYOFFICE/onlyoffice.github.io

Kung maayo ang imong plugin, aprubahan sa ONLYOFFICE developers ang imong pull request, ug ang imong plugin makita sa ONLYOFFICE plugin marketplace. Sa kini nga kaso, ang uban makahimo sa pag-install niini gikan sa merkado sa pipila ka mga pag-klik.

Kami nanghinaut nga mapuslan nimo kini nga artikulo. Ayaw kalimti nga ipaambit ang imong gihunahuna sa mga komento sa ubos.