Diňe ONFFICE resminamalary üçin öz plaginiňizi nädip döretmeli

Gysgaça: Bu makalada, ONLYOFFICE Docs üçin öz pluginiňizi nädip döretmelidigini we 7.2 wersiýasyndan başlap resmi plagin bazarynda nädip çap etmelidigini öwrenersiňiz.

PDF faýllaryna göz aýlaýar we öwürýär we ş.m.

Şeýle-de bolsa, ONLYOFFICE-i has güýçli etmegiň usuly bar. Bu ýerde göz öňünde tutulýan zat, üçünji tarap plaginleri, ýagny toplumyň adaty funksional mümkinçiliklerini ýokarlandyrýan goşmaça programma gurallary. Mysal üçin, pluginler üçünji tarap hyzmatlaryny birikdirmäge ýa-da täze ulanyjy interfeýs elementlerini goşmaga mümkinçilik berýär.

ONLYOFFICE resminamalary üçin bir plugin nädip döretmeli

ONLYOFFICE Docs üçin öz pluginiňizi döretmäge başlamazdan ozal, GitHub resminamalaryňyzyň bardygyna göz ýetirmeli.

Plagin döretmek prosesini üns bilen ýerine ýetirmeli ýedi basgançaga bölmek bolar:

  • Deslapky işler.
    • Kodlaşdyrmak.
  • Plagin stilini sazlamak.
  • Lokalizasiýa (islege görä).
  • Taýýarlyk.
    • Synag.
  • Plagin bazarynda neşir.

Geliň, plugin ösüşine has çuňňur gireliň.

Ilki bilen, GitHub hasabyňyza girmeli ýa-da ýok bolsa birini döretmeli. Ondan soň, aşakdaky URL adresinde bar bolan “ONLYOFFICE” plugin bazaryndaky ammar üçin çeňňek döretmeli:

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

Netijede, başga bir ammaryňyz bolar we URL salgysy şuňa meňzeş bir zat bolar:

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

Plagin bazary reposyny üstünlikli gysandan soň, synag maksady bilen bu ammardan GitHub Sahypalar sahypasyny döretmeli. Muny nädip etmelidigini bilmeseňiz, resmi GitHub gollanmasyna serediň.

Indi öz “GitHub” sahypalaryňyz bar bolsa, wilkany kompýuteriňize klonlaşdyrmagyň wagty geldi.

Netijede, geljekki pluginiňiz üçin bukja döretmeli:

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

Bu. Requiredhli zerur deslapky çäreleri tamamladyňyz we indiki ädimi dowam etdirip bilersiňiz.

Kodlaşdyrmaga ökde bolmak hökman däl, ýöne ONLYOFFICE Docs üçin öz pluginiňizi döretmek üçin hökman käbir kodlaşdyrma bilimleri gerek.

Gysgaça aýdylanda, ONLYOFFICE plugin birnäçe faýlly bukjadyr. Plaginiňiziň dogry işlemegi üçin üç faýl döretmeli:

  • config.json - Bu ähli möhüm maglumatlar hakda maglumatlary öz içine alýan plugin konfigurasiýa faýly. Bu faýlda, plagini ONLYOFFICE redaktorlarynda hasaba almak üçin zerur käbir parametrler bar. Her parametriň doly düşündirişini okamak üçin resmi API resminamalarynda bu sahypa serediň.
  • plugin kody (.js faýly) - Bu, pluginiňiziň JavaScript koduny öz içine alýan plugin faýlydyr. Bu faýl, pluginiň ýerine ýetirýän amallaryny we olaryň ýerine ýetirilişini suratlandyrýar. Onuň nähili işleýändigini bilmek üçin bu API gollanmasyny okaň.
  • index.html - Bu, config.json we plugin.js faýllaryny birleşdirýän pluginiňiziň giriş nokady. Onuň nähili bolmalydygyna düşünmek üçin bu mysala göz aýlaň.

Bu hökmany faýllardan başga-da, plugin bukjasynda başga faýllar bolup biler. Mysal üçin, nyşanlaryň, plugin stilleriniň, okamak faýllarynyň, üçünji tarap hyzmatlarynyň we ş.m. Aşakda şeýle faýllar barada has giňişleýin maglumat tapyp bilersiňiz.

Plaginiňiz üçin gowy iş kody ýazmak üçin zerur wakalary bilmeli.

Plaginiňiz üçin kod ýazmak ýeterlik däl. Şeýle hem, stilini ONLYOFFICE redaktorlarynyň aýrylmaz bölegine meňzetmek üçin sazlamaly. Munuň üçin diňe ýokarda görkezilen index.html faýlyna ONLYOFFICE stil sahypasyny goşuň:

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

Düwmeleri, giriş dolandyryşlaryny, bellik dolandyryşlaryny, ýükleýjileri we beýleki elementleri goşup bilersiňiz.

Mysal üçin, pluginiňize goşma guty goşmak üçin, Select2 funksiýasyny ulanyp bilersiňiz:

<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' 
});

Goýlan goşma guty şeýle bolar:

ONLYOFFICE stil elementleri barada has giňişleýin maglumaty şu ýerden tapyp bilersiňiz.

Diňe iňlis dilinde gürleýän ulanyjylar üçin bir plugin döretjek bolsaňyz, bu ädimden geçip bilersiňiz. Şeýle-de bolsa, pluginiňiziň başga dillerde elýeterli bolmagyny isleseňiz, plugin katalogynda terjime bukjasyny döredip we ulanmak isleýän ähli dilleriňiz üçin .json faýllaryny goýup bilersiňiz.

Plaginiňizi nädip dogry lokallaşdyrmalydygyny öwrenmek üçin resmi API resminamalaryny okaň.

“ONLYOFFICE” bazarynda elýeterli bolmazdan ozal, plaginiňiziň daşky görnüşini ýuwmak üçin, pluginiňiziň gysgaça beýany, wersiýasy, işläp düzüjiniň ady we ş.m. hakda “About About” penjiresini goşmaly.

Mysal üçin, “Surat redaktory” plugininiň “About” penjiresi:

Plaginiňiz üçin şeýle penjire döredip bilmek üçin şu görkezmelere eýeriň.

Şeýle hem, pluginiňiz üçin nyşanlary döredip, olary çeşmeler bukjasyna salmaly. Umuman aýdanyňda, plugin ONLYOFFICE plugin bazarynda dogry görkezilmegi üçin 8 nyşan gerek: “Light” we “Dark” interfeýs mowzuklary üçin 4 nyşan (125%, 150%, 175% we 200% masştab).

Mundan başga-da, okamak faýlyny döredip, esasy plugin bukjasyna goýup bilersiňiz. Bu faýl, beýleki ulanyjylaryň bilmek isleýän islendik maglumatyny - pluginiňiziň esasy aýratynlyklarynyň beýany, gurnama görkezmeleri, belli meseleler we näsazlyklar we ş.m. öz içine alyp biler.

Indi pluginiňiz taýýar, ony bazarda çap etmezden ozal dogry synap bilersiňiz.

Indi döreden ähli faýllaryňyzy ýokardaky görkezmelere laýyklykda plugin bukjasyna salmagyň wagty geldi. Soňra plugin bukjasyny uzakdaky ammara basyň we ONLYOFFICE Desktop Redaktorlarynda plagini barlaň. Bu maksat bilen, iş stoly programmasyny düzediş tertibinde işledip bilersiňiz.

Linux-da terminaly CTRL + ALT + T bilen açyp bilersiňiz. Ondan soň, ONLYOFFICE Stol redaktorlaryna ýol giriziň, boş ýer goşuň we --ascdesktop-support-debug-info kesgitläň:

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

Plaginiňizi we aýratynlyklaryny barlaň.

Everythinghli zat gowy bolsa, pluginiňizi ONLYOFFICE toplumynyň, ONLYOFFICE resminamalarynyň web wersiýasynda synap bilersiňiz. Başgaça aýdylanda, pluginiňizi täze giňeltme hökmünde goşup bilersiňiz.

Degişli giňeltmäni döretmek üçin ýeke-täk ofice.github.io/store/plugin-dev/extension/inject.js faýlyny açmaly we URL_TO_PLUGIN üýtgeýjisindäki GitHub sahypalaryndaky pluginiňize ýol görkezmeli:

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

Onlyeke-täkoff.github.io/store/plugin-dev/extension bukjasy size gerek giňeltme. Web brauzeriňize nädip plugin goşmalydygyny web brauzeriňize ýükläň.

Plaginiňiz niýetlenen ýaly işlese, iň soňky ädim bilen dowam edip bilersiňiz.

Gutlaýarys! Plagin döretmek prosesini başdan geçirdiňiz we indi pluginiňizi beýleki ulanyjylar üçin elýeterli edip bilersiňiz. Bu maksat bilen, çeňňegiňizden “ONLYOFFICE” ammaryna çekmek haýyşyny döredip bilersiňiz:

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

Plaginiňiz gowy işleýän bolsa, ONLYOFFICE döredijileri çekmek islegiňizi tassyklar we plugin ONLYOFFICE plugin bazarynda peýda bolar. Bu ýagdaýda beýlekiler ony birnäçe gezek basmak bilen bazardan gurnap bilerler.

Bu makalany peýdaly görersiňiz diýip umyt edýäris. Aşakdaky teswirlerde pikirleriňizi paýlaşmagy ýatdan çykarmaň.