Yadda ake Ƙirƙirar Plugin naku don Dokokin KAWAI

Taƙaitaccen: A cikin wannan labarin, za ku koyi yadda ake ƙirƙirar plugin ɗin ku don Docs KAWAI da yadda ake buga shi a cikin kasuwar plugin ɗin hukuma wacce ke farawa daga sigar 7.2.

bincike da canza fayilolin PDF, da sauransu.

Koyaya, akwai hanyar yin KAWAI mafi ƙarfi. Abin da ake nufi anan shine plugins na ɓangare na uku, watau ƙarin kayan aikin software waɗanda ke haɓaka daidaitattun damar aiki na ɗakin. Misali, plugins suna ba da damar haɗa sabis na ɓangare na uku ko ƙara sabbin abubuwan haɗin mai amfani.

Yadda ake Ƙirƙirar Plugin don Dokokin KAWAI

Kafin ka fara ƙirƙirar kayan aikin ku don Docs KAWAI, kuna buƙatar tabbatar da cewa kuna da takaddun GitHub.

Ana iya raba tsarin ƙirƙirar plugin ɗin zuwa matakai bakwai waɗanda kuke buƙatar bi a hankali:

  • Ayyukan farko.
  • Coding.
  • Gyara da salon plugin.
  • Localization (na zaɓi).
  • Shiri.
  • Gwaji.
  • Bugawa a cikin kasuwar plugin.

Bari mu zurfafa zurfi cikin ci gaban plugin ɗin.

Da farko, kuna buƙatar shiga cikin asusun GitHub ɗinku ko ƙirƙirar ɗaya idan ba ku da ɗaya. Bayan haka, kuna buƙatar ƙirƙirar cokali mai yatsa na ONLYOFFICE plugin wurin ajiyar kasuwa wanda yake samuwa a adireshin URL mai zuwa:

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

Sakamakon haka, zaku sami wani wurin ajiya, kuma adireshin URL ɗin sa zai zama wani abu kamar haka:

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

Bayan an yi nasarar ƙaddamar da repo kasuwar plugin ɗin, ya zama dole a ƙirƙiri rukunin Shafukan GitHub daga wannan ma'ajiyar don dalilai na gwaji. Idan baku san yadda ake yi ba, da fatan za a koma zuwa jagorar GitHub na hukuma.

Yanzu da kuna da rukunin yanar gizonku na GitHub, lokaci yayi da za ku haɗa cokali mai yatsa zuwa kwamfutarka.

A ƙarshe, kuna buƙatar ƙirƙirar babban fayil don plugin ɗinku na gaba a:

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

Shi ke nan. Yanzu kun kammala duk ayyukan farko da ake buƙata kuma kuna iya ci gaba da mataki na gaba.

Ba lallai ne ku kasance da ƙware sosai a yin coding ba amma tabbas kuna buƙatar wasu mahimman ilimin coding don ƙirƙirar kayan aikin ku don Docs KAWAI.

A taƙaice, ONLYOFFICE plugin babban fayil ne mai fayiloli da yawa. Dole ne ku ƙirƙiri fayiloli guda uku don plugin ɗin ku ya yi aiki daidai:

  • config.json - Wannan fayil ɗin sanyi ne na plugin wanda ya ƙunshi bayanai game da duk mahimman bayanai. A cikin wannan fayil ɗin, akwai wasu sigogi waɗanda ake buƙata don yin rijistar plugin ɗin a cikin masu gyara KAWAI. Dubi wannan shafi a cikin takaddun API na hukuma don karanta cikakken bayanin kowane siga.
  • plugin code (.js file) - Wannan shi ne plugin ɗin kanta wanda ya ƙunshi lambar JavaScript na plugin ɗin ku. Wannan fayil ɗin yana bayyana ayyukan da plugin ɗin ke yi da yadda ake yin su. Karanta wannan jagorar API don sanin yadda yake aiki.
  • index.html - Wannan shine wurin shigarwa na plugin ɗin ku wanda ke haɗa fayilolin config.json da plugin.js. Dubi wannan misalin don fahimtar yadda ya kamata ya kasance.

Baya ga waɗannan fayilolin wajibai, babban fayil ɗin plugin ɗin zai iya ƙunsar wasu fayiloli. Misali, gumaka, salon plugin, fayilolin readme, sabis na ɓangare na uku, da sauransu. Za ku sami ƙarin bayani game da waɗannan fayiloli a ƙasa.

Don rubuta kyakkyawan lambar aiki don plugin ɗin ku, kuna buƙatar sanin abubuwan da ake buƙata.

Rubutun code don plugin ɗinku bai isa ba. Hakanan kuna buƙatar daidaita salon sa don ya yi kama da wani muhimmin sashi na masu gyara KAWAI. Don yin haka, kawai ƙara takardar salon kawai KAWAI zuwa fayil ɗin index.html da aka kwatanta a sama:

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

Kuna iya ƙara maɓalli, sarrafawar shigarwa, sarrafa lakabi, lodi, da sauran abubuwa.

Misali, don ƙara akwatin haɗawa zuwa plugin ɗin ku, zaku iya amfani da aikin zaɓi2:

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

Akwatin haduwar da aka saka zai yi kama da haka:

Ana iya samun ƙarin bayani game da abubuwan salon KAWAI anan.

Kuna iya tsallake wannan matakin idan zaku ƙirƙiri plugin don masu amfani da Ingilishi kawai. Koyaya, idan kuna son plugin ɗin ku ya kasance a cikin wasu yarukan, zaku iya ƙirƙirar babban fayil ɗin fassarorin a cikin kundin adireshi sannan ku sanya fayilolin su .json ga duk yarukan da kuke son amfani da su.

Karanta takaddun API na hukuma don koyon yadda a nan za a iya sarrafa kayan aikin ku daidai.

Don goge bayyanar plugin ɗin ku kafin ya zama samuwa a cikin kasuwar KAWAI, kuna buƙatar ƙara Game da taga tare da taƙaitaccen bayanin plugin ɗin ku, sigar sa, sunan mai haɓakawa, da sauransu.

Misali, wannan shine Game da taga na plugin Editan Hoto:

Don samun damar ƙirƙirar irin wannan taga don plugin ɗin ku, bi waɗannan umarnin.

Hakanan, kuna buƙatar ƙirƙirar gumaka don plugin ɗin ku kuma sanya su cikin babban fayil ɗin albarkatu. Gabaɗaya, kuna buƙatar gumaka 8 don plugin ɗin ku ya nuna daidai a cikin kasuwar kayan aikin ONLYOFFICE: Gumaka 4 (125%, 150%, 175%, da 200% scaling) don jigogi masu haske da duhu.

Bugu da ƙari, zaku iya ƙirƙirar fayil ɗin readme kuma saka shi cikin babban fayil ɗin plugin ɗin. Wannan fayil ɗin zai iya haɗawa da duk wani bayani da kuke son wasu masu amfani su sani - bayanin manyan abubuwan plugin ɗin ku, umarnin shigarwa, sanannun batutuwa, da kwari, da sauransu.

Yanzu plugin ɗin ku yana shirye, kuma kuna iya gwada shi da kyau kafin buga shi a kasuwa.

Yanzu lokaci ya yi da za a saka duk fayilolin da kuka riga kuka ƙirƙira bisa ga umarnin da ke sama a cikin babban fayil ɗin plugin. Sannan tura babban fayil ɗin plugin ɗin zuwa wurin ajiya mai nisa kuma gwada plugin ɗin a cikin Editocin Desktop KAWAI. Don wannan dalili, zaku iya gudanar da aikace-aikacen tebur a cikin yanayin lalata.

A Linux, zaku iya buɗe tashar tare da CTRL + ALT + T. Bayan haka, shigar da hanyar zuwa Editocin Desktop KAWAI, ƙara sarari sannan a saka --ascdesktop-support-debug-info:

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

Gwada plugin ɗin ku da fasalinsa.

Idan komai yayi daidai, zaku iya gwada kayan aikin ku a cikin sigar gidan yanar gizo na ONLYOFFICE suite, KAWAI Docs. A wasu kalmomi, ana iya ƙara plugin ɗin ku azaman sabon kari.

Don ƙirƙirar tsawo mai dacewa, kuna buƙatar buɗe kawaioffice.github.io/store/plugin-dev/extension/inject.js fayil kuma saka hanyar zuwa plugin ɗin ku akan rukunin Shafukan GitHub a cikin URL_TO_PLUGIN m:

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

Onlyoffice.github.io/store/plugin-dev/extension babban fayil shine tsawo da kuke buƙata. Kawai loda shi zuwa burauzar gidan yanar gizon ku, yadda ake ƙara plugin ɗin zuwa burauzar gidan yanar gizo.

Idan plugin ɗin ku yana aiki kamar yadda aka yi niyya, zaku iya ci gaba da mataki na ƙarshe.

Taya murna! Kun shiga cikin tsarin ƙirƙirar plugin kuma yanzu kuna iya samar da plugin ɗin ku don sauran masu amfani. Don wannan dalili, zaku iya ƙirƙirar buƙatun ja daga cokali mai yatsu zuwa wannan ma'ajiyar OFFICE KAWAI a:

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

Idan plugin ɗin ku yana aiki da kyau, kawai masu haɓakawa za su amince da buƙatar ku, kuma plugin ɗin ku zai bayyana a cikin kasuwar kayan aikin ONLYOFFICE. A wannan yanayin, wasu za su iya shigar da shi daga kasuwa tare da dannawa kaɗan.

Muna fatan kun sami amfani wannan labarin. Kar ku manta da raba abin da kuke tunani a cikin sharhin da ke ƙasa.