ONLYOFFICE ഡോക്സിനായി നിങ്ങളുടെ സ്വന്തം പ്ലഗിൻ എങ്ങനെ സൃഷ്ടിക്കാം


ചുരുക്കം: ഈ ലേഖനത്തിൽ, ONLYOFFICE ഡോക്സിനായി നിങ്ങളുടെ സ്വന്തം പ്ലഗിൻ എങ്ങനെ സൃഷ്ടിക്കാമെന്നും പതിപ്പ് 7.2 മുതൽ ലഭ്യമായ ഔദ്യോഗിക പ്ലഗിൻ മാർക്കറ്റിൽ അത് എങ്ങനെ പ്രസിദ്ധീകരിക്കാമെന്നും നിങ്ങൾ പഠിക്കും.

PDF ഫയലുകൾ ബ്രൗസ് ചെയ്യുകയും പരിവർത്തനം ചെയ്യുകയും ചെയ്യുന്നു.

എന്നിരുന്നാലും, ONLYOFFICE കൂടുതൽ ശക്തമാക്കാൻ ഒരു വഴിയുണ്ട്. ഇവിടെ ഉദ്ദേശിക്കുന്നത് മൂന്നാം കക്ഷി പ്ലഗിനുകളാണ്, അതായത് സ്യൂട്ടിന്റെ സ്റ്റാൻഡേർഡ് ഫംഗ്ഷണൽ കഴിവുകൾ വർദ്ധിപ്പിക്കുന്ന അധിക സോഫ്റ്റ്വെയർ ടൂളുകൾ. ഉദാഹരണത്തിന്, പ്ലഗിനുകൾ മൂന്നാം കക്ഷി സേവനങ്ങൾ ബന്ധിപ്പിക്കുന്നതിനോ പുതിയ ഉപയോക്തൃ ഇന്റർഫേസ് ഘടകങ്ങൾ ചേർക്കുന്നതിനോ സാധ്യമാക്കുന്നു.

ONLYOFFICE ഡോക്സിനായി ഒരു പ്ലഗിൻ എങ്ങനെ സൃഷ്ടിക്കാം

ONLYOFFICE ഡോക്സിനായി നിങ്ങളുടേതായ പ്ലഗിൻ സൃഷ്ടിക്കാൻ തുടങ്ങുന്നതിനുമുമ്പ്, നിങ്ങൾക്ക് ഒരു GitHub ഡോക്യുമെന്റേഷൻ ഉണ്ടെന്ന് ഉറപ്പാക്കേണ്ടതുണ്ട്.

പ്ലഗിൻ സൃഷ്ടിക്കൽ പ്രക്രിയയെ ഏഴ് ഘട്ടങ്ങളായി തിരിക്കാം, അത് നിങ്ങൾ ശ്രദ്ധാപൂർവ്വം പിന്തുടരേണ്ടതുണ്ട്:

  • പ്രാഥമിക പ്രവർത്തനങ്ങൾ.
  • കോഡിംഗ്.
  • പ്ലഗിൻ ശൈലിയുടെ ക്രമീകരണം.
  • പ്രാദേശികവൽക്കരണം (ഓപ്ഷണൽ).
  • തയ്യാറെടുപ്പ്.
  • ടെസ്റ്റിംഗ്.
  • പ്ലഗിൻ മാർക്കറ്റിലെ പ്രസിദ്ധീകരണം.

നമുക്ക് പ്ലഗിൻ വികസനത്തിലേക്ക് ആഴത്തിൽ ഇറങ്ങാം.

ഒന്നാമതായി, നിങ്ങൾ നിങ്ങളുടെ GitHub അക്കൗണ്ടിലേക്ക് ലോഗിൻ ചെയ്യേണ്ടതുണ്ട് അല്ലെങ്കിൽ നിങ്ങൾക്ക് ഒന്നുമില്ലെങ്കിൽ ഒന്ന് സൃഷ്ടിക്കുക. അതിനുശേഷം, ഇനിപ്പറയുന്ന URL വിലാസത്തിൽ ലഭ്യമായ ONLYOFFICE പ്ലഗിൻ മാർക്കറ്റ്പ്ലേസ് ശേഖരണത്തിന്റെ ഒരു ഫോർക്ക് നിങ്ങൾ സൃഷ്ടിക്കേണ്ടതുണ്ട്:

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

ഫലമായി, നിങ്ങൾക്ക് മറ്റൊരു ശേഖരം ഉണ്ടാകും, അതിന്റെ URL വിലാസം ഇതുപോലെയായിരിക്കും:

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

പ്ലഗിൻ മാർക്കറ്റ്പ്ലെയ്സ് റിപ്പോ വിജയകരമായി ഫോർക്ക് ചെയ്ത ശേഷം, ടെസ്റ്റിംഗ് ആവശ്യങ്ങൾക്കായി ഈ ശേഖരത്തിൽ നിന്ന് ഒരു GitHub പേജ് സൈറ്റ് സൃഷ്ടിക്കേണ്ടത് ആവശ്യമാണ്. ഇത് എങ്ങനെ ചെയ്യണമെന്ന് നിങ്ങൾക്കറിയില്ലെങ്കിൽ, ഔദ്യോഗിക GitHub ഗൈഡ് പരിശോധിക്കുക.

ഇപ്പോൾ നിങ്ങൾക്ക് സ്വന്തമായി GitHub പേജ് സൈറ്റ് ഉണ്ട്, നിങ്ങളുടെ കമ്പ്യൂട്ടറിലേക്ക് ഫോർക്ക് ക്ലോൺ ചെയ്യാനുള്ള സമയമാണിത്.

അവസാനമായി, നിങ്ങളുടെ ഭാവി പ്ലഗിൻ ഇവിടെ ഒരു ഫോൾഡർ സൃഷ്ടിക്കേണ്ടതുണ്ട്:

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

അത്രയേയുള്ളൂ. ആവശ്യമായ എല്ലാ പ്രാഥമിക പ്രവർത്തനങ്ങളും നിങ്ങൾ പൂർത്തിയാക്കി, അടുത്ത ഘട്ടത്തിലേക്ക് പോകാം.

നിങ്ങൾ കോഡിംഗിൽ വളരെ മികച്ചവരായിരിക്കണമെന്നില്ല, എന്നാൽ ONLYOFFICE ഡോക്സിനായി നിങ്ങളുടെ സ്വന്തം പ്ലഗിൻ സൃഷ്ടിക്കുന്നതിന് നിങ്ങൾക്ക് തീർച്ചയായും ചില അടിസ്ഥാന കോഡിംഗ് പരിജ്ഞാനം ആവശ്യമാണ്.

ചുരുക്കത്തിൽ, നിരവധി ഫയലുകളുള്ള ഒരു ഫോൾഡറാണ് ONLYOFFICE പ്ലഗിൻ. നിങ്ങളുടെ പ്ലഗിൻ ശരിയായി പ്രവർത്തിക്കുന്നതിന് നിങ്ങൾ മൂന്ന് ഫയലുകൾ സൃഷ്ടിക്കേണ്ടതുണ്ട്:

  • config.json – എല്ലാ പ്രധാനപ്പെട്ട ഡാറ്റയെ കുറിച്ചുള്ള വിവരങ്ങളും അടങ്ങുന്ന ഒരു പ്ലഗിൻ കോൺഫിഗറേഷൻ ഫയലാണിത്. ഈ ഫയലിൽ, ONLYOFFICE എഡിറ്ററുകളിൽ പ്ലഗിൻ രജിസ്റ്റർ ചെയ്യുന്നതിന് ആവശ്യമായ ചില പാരാമീറ്ററുകൾ ഉണ്ട്. ഓരോ പാരാമീറ്ററിന്റെയും പൂർണ്ണ വിവരണം വായിക്കാൻ ഔദ്യോഗിക API ഡോക്യുമെന്റേഷനിലെ ഈ പേജ് നോക്കുക.
  • പ്ലഗിൻ കോഡ് (.js ഫയൽ) - നിങ്ങളുടെ പ്ലഗിന്റെ JavaScript കോഡ് അടങ്ങുന്ന പ്ലഗിൻ ഫയൽ തന്നെയാണിത്. പ്ലഗിൻ നിർവ്വഹിക്കുന്ന പ്രവർത്തനങ്ങളും അവ എങ്ങനെ നിർവഹിക്കപ്പെടുന്നുവെന്നും ഈ ഫയൽ വിവരിക്കുന്നു. ഇത് എങ്ങനെ പ്രവർത്തിക്കുന്നുവെന്ന് അറിയാൻ ഈ API ഗൈഡ് വായിക്കുക.
  • index.html – config.json, plugin.js ഫയലുകളെ ബന്ധിപ്പിക്കുന്ന നിങ്ങളുടെ പ്ലഗിനിന്റെ എൻട്രി പോയിന്റാണിത്. ഇത് എങ്ങനെയായിരിക്കണമെന്ന് മനസ്സിലാക്കാൻ ഈ ഉദാഹരണം നോക്കുക.

ഈ നിർബന്ധിത ഫയലുകൾ കൂടാതെ, പ്ലഗിൻ ഫോൾഡറിൽ മറ്റ് ഫയലുകൾ അടങ്ങിയിരിക്കാം. ഉദാഹരണത്തിന്, ഐക്കണുകൾ, പ്ലഗിൻ ശൈലികൾ, റീഡ്മീ ഫയലുകൾ, മൂന്നാം കക്ഷി സേവനങ്ങൾ മുതലായവ. അത്തരം ഫയലുകളെക്കുറിച്ചുള്ള കൂടുതൽ വിവരങ്ങൾ നിങ്ങൾ ചുവടെ കണ്ടെത്തും.

നിങ്ങളുടെ പ്ലഗിനിനായി ഒരു നല്ല വർക്കിംഗ് കോഡ് എഴുതുന്നതിന്, ആവശ്യമായ ഇവന്റുകൾ നിങ്ങൾ അറിഞ്ഞിരിക്കണം.

നിങ്ങളുടെ പ്ലഗിൻ കോഡ് എഴുതുന്നത് പര്യാപ്തമല്ല. നിങ്ങൾ അതിന്റെ ശൈലിയും ക്രമീകരിക്കേണ്ടതുണ്ട്, അതിനാൽ ഇത് ONLYOFFICE എഡിറ്റർമാരുടെ അവിഭാജ്യ ഘടകമായി തോന്നുന്നു. അങ്ങനെ ചെയ്യുന്നതിന്, മുകളിൽ വിവരിച്ച index.html ഫയലിലേക്ക് ONLYOFFICE സ്റ്റൈൽ ഷീറ്റ് ചേർക്കുക:

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

നിങ്ങൾക്ക് ബട്ടണുകൾ, ഇൻപുട്ട് നിയന്ത്രണങ്ങൾ, ലേബൽ നിയന്ത്രണങ്ങൾ, ലോഡറുകൾ, മറ്റ് ഘടകങ്ങൾ എന്നിവ ചേർക്കാൻ കഴിയും.

ഉദാഹരണത്തിന്, നിങ്ങളുടെ പ്ലഗിനിലേക്ക് ഒരു കോംബോ ബോക്സ് ചേർക്കുന്നതിന്, നിങ്ങൾക്ക് select2 ഫംഗ്ഷൻ ഉപയോഗിക്കാം:

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

ചേർത്ത കോംബോ ബോക്സ് ഇതുപോലെ കാണപ്പെടും:

ONLYOFFICE ശൈലിയിലുള്ള ഘടകങ്ങളെക്കുറിച്ചുള്ള കൂടുതൽ വിവരങ്ങൾ ഇവിടെ കാണാം.

ഇംഗ്ലീഷ് സംസാരിക്കുന്ന ഉപയോക്താക്കൾക്കായി മാത്രം നിങ്ങൾ ഒരു പ്ലഗിൻ സൃഷ്ടിക്കാൻ പോകുകയാണെങ്കിൽ ഈ ഘട്ടം നിങ്ങൾക്ക് ഒഴിവാക്കാം. എന്നിരുന്നാലും, നിങ്ങളുടെ പ്ലഗിൻ മറ്റ് ഭാഷകളിൽ ലഭ്യമാകണമെന്ന് നിങ്ങൾ ആഗ്രഹിക്കുന്നുവെങ്കിൽ, നിങ്ങൾക്ക് പ്ലഗിൻ ഡയറക്ടറിയിൽ വിവർത്തന ഫോൾഡർ സൃഷ്ടിക്കുകയും നിങ്ങൾ ഉപയോഗിക്കാൻ ആഗ്രഹിക്കുന്ന എല്ലാ ഭാഷകൾക്കും അവരുടെ .json ഫയലുകൾ ഇടുകയും ചെയ്യാം.

നിങ്ങളുടെ പ്ലഗിൻ ശരിയായി പ്രാദേശികവൽക്കരിക്കുന്നത് എങ്ങനെയെന്ന് അറിയാൻ ഔദ്യോഗിക API ഡോക്യുമെന്റേഷൻ വായിക്കുക.

നിങ്ങളുടെ പ്ലഗിൻ ONLYOFFICE മാർക്കറ്റിൽ ലഭ്യമാകുന്നതിന് മുമ്പ് അതിന്റെ രൂപഭാവം മിനുക്കുന്നതിന്, നിങ്ങളുടെ പ്ലഗിൻ, അതിന്റെ പതിപ്പ്, ഡവലപ്പർ പേര് മുതലായവയുടെ ഒരു ഹ്രസ്വ വിവരണത്തോടുകൂടിയ ഒരു ആമുഖ വിൻഡോ നിങ്ങൾ ചേർക്കേണ്ടതുണ്ട്.

ഉദാഹരണത്തിന്, ഫോട്ടോ എഡിറ്റർ പ്ലഗിന്റെ വിവര വിൻഡോ ഇതാണ്:

നിങ്ങളുടെ പ്ലഗിനിനായി അത്തരമൊരു വിൻഡോ സൃഷ്ടിക്കാൻ, ഈ നിർദ്ദേശങ്ങൾ പാലിക്കുക.

കൂടാതെ, നിങ്ങളുടെ പ്ലഗിന്നിനായി ഐക്കണുകൾ സൃഷ്ടിക്കുകയും അവ ഉറവിട ഫോൾഡറിൽ ഇടുകയും വേണം. പൊതുവേ, നിങ്ങൾക്ക് 8 ഐക്കണുകൾ ആവശ്യമാണ്, അതുവഴി നിങ്ങളുടെ പ്ലഗിൻ ONLYOFFICE പ്ലഗിൻ മാർക്കറ്റിൽ ശരിയായി പ്രദർശിപ്പിക്കും: ലൈറ്റ് ആൻഡ് ഡാർക്ക് ഇന്റർഫേസ് തീമുകൾക്കായി 4 ഐക്കണുകൾ (125%, 150%, 175%, 200% സ്കെയിലിംഗ്).

കൂടാതെ, നിങ്ങൾക്ക് ഒരു റീഡ്മെ ഫയൽ സൃഷ്ടിച്ച് പ്രധാന പ്ലഗിൻ ഫോൾഡറിലേക്ക് ഇടാം. ഈ ഫയലിൽ മറ്റ് ഉപയോക്താക്കൾ അറിയാൻ ആഗ്രഹിക്കുന്ന ഏത് വിവരവും ഉൾപ്പെടുത്താം - നിങ്ങളുടെ പ്ലഗിന്റെ പ്രധാന സവിശേഷതകൾ, ഇൻസ്റ്റാളേഷൻ നിർദ്ദേശങ്ങൾ, അറിയപ്പെടുന്ന പ്രശ്നങ്ങൾ, ബഗുകൾ മുതലായവ.

ഇപ്പോൾ നിങ്ങളുടെ പ്ലഗിൻ തയ്യാറാണ്, മാർക്കറ്റിൽ പ്രസിദ്ധീകരിക്കുന്നതിന് മുമ്പ് നിങ്ങൾക്കത് ശരിയായി പരിശോധിക്കാവുന്നതാണ്.

മുകളിലുള്ള നിർദ്ദേശങ്ങൾ അനുസരിച്ച് നിങ്ങൾ ഇതിനകം സൃഷ്ടിച്ച എല്ലാ ഫയലുകളും പ്ലഗിൻ ഫോൾഡറിൽ ഇടാനുള്ള സമയമാണിത്. തുടർന്ന് പ്ലഗിൻ ഫോൾഡർ റിമോട്ട് റിപ്പോസിറ്ററിയിലേക്ക് പുഷ് ചെയ്ത് ONLYOFFICE ഡെസ്ക്ടോപ്പ് എഡിറ്ററുകളിൽ പ്ലഗിൻ പരീക്ഷിക്കുക. ഈ ആവശ്യത്തിനായി, നിങ്ങൾക്ക് ഡീബഗ്ഗിംഗ് മോഡിൽ ഡെസ്ക്ടോപ്പ് ആപ്പ് പ്രവർത്തിപ്പിക്കാൻ കഴിയും.

Linux-ൽ, CTRL+ALT+T ഉപയോഗിച്ച് നിങ്ങൾക്ക് ടെർമിനൽ തുറക്കാം. അതിനുശേഷം, ONLYOFFICE ഡെസ്ക്ടോപ്പ് എഡിറ്ററുകളിലേക്കുള്ള പാത നൽകുക, ഒരു സ്പെയ്സ് ചേർക്കുക തുടർന്ന് --ascdesktop-support-debug-info വ്യക്തമാക്കുക:

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

നിങ്ങളുടെ പ്ലഗിനും അതിന്റെ സവിശേഷതകളും പരിശോധിക്കുക.

എല്ലാം ശരിയാണെങ്കിൽ, ONLYOFFICE സ്യൂട്ടിന്റെ വെബ് പതിപ്പായ ONLYOFFICE ഡോക്സിലും നിങ്ങളുടെ പ്ലഗിൻ പരീക്ഷിക്കാവുന്നതാണ്. മറ്റൊരു വിധത്തിൽ പറഞ്ഞാൽ, നിങ്ങളുടെ പ്ലഗിൻ ഒരു പുതിയ വിപുലീകരണമായി ചേർക്കാവുന്നതാണ്.

അനുബന്ധ വിപുലീകരണം സൃഷ്ടിക്കാൻ, നിങ്ങൾ onlyoffice.github.io/store/plugin-dev/extension/inject.js ഫയൽ തുറന്ന് URL_TO_PLUGIN വേരിയബിളിലെ GitHub പേജ് സൈറ്റിൽ നിങ്ങളുടെ പ്ലഗിനിലേക്കുള്ള പാത വ്യക്തമാക്കേണ്ടതുണ്ട്:

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

നിങ്ങൾക്ക് ആവശ്യമുള്ള വിപുലീകരണമാണ് onlyoffice.github.io/store/plugin-dev/extension ഫോൾഡർ. ഒരു വെബ് ബ്രൗസറിലേക്ക് ഒരു പ്ലഗിൻ എങ്ങനെ ചേർക്കാം എന്നതിനെ നിങ്ങളുടെ വെബ് ബ്രൗസറിലേക്ക് അപ്ലോഡ് ചെയ്യുക.

നിങ്ങളുടെ പ്ലഗിൻ ഉദ്ദേശിച്ച രീതിയിൽ പ്രവർത്തിക്കുകയാണെങ്കിൽ, നിങ്ങൾക്ക് അവസാന ഘട്ടത്തിലേക്ക് പോകാം.

അഭിനന്ദനങ്ങൾ! നിങ്ങൾ പ്ലഗിൻ സൃഷ്ടിക്കൽ പ്രക്രിയയിലൂടെ കടന്നുപോയി, ഇപ്പോൾ നിങ്ങളുടെ പ്ലഗിൻ മറ്റ് ഉപയോക്താക്കൾക്ക് ലഭ്യമാക്കാം. ഈ ആവശ്യത്തിനായി, നിങ്ങളുടെ ഫോർക്കിൽ നിന്ന് ഈ ONLYOFFICE റിപ്പോസിറ്ററിയിലേക്ക് ഒരു പുൾ അഭ്യർത്ഥന ഇവിടെ സൃഷ്ടിക്കാൻ കഴിയും:

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

നിങ്ങളുടെ പ്ലഗിൻ നന്നായി പ്രവർത്തിക്കുന്നുണ്ടെങ്കിൽ, ONLYOFFICE ഡവലപ്പർമാർ നിങ്ങളുടെ പുൾ അഭ്യർത്ഥന അംഗീകരിക്കും, നിങ്ങളുടെ പ്ലഗിൻ ONLYOFFICE പ്ലഗിൻ മാർക്കറ്റിൽ ദൃശ്യമാകും. ഈ സാഹചര്യത്തിൽ, മറ്റുള്ളവർക്ക് കുറച്ച് ക്ലിക്കുകളിലൂടെ മാർക്കറ്റിൽ നിന്ന് ഇത് ഇൻസ്റ്റാൾ ചെയ്യാൻ കഴിയും.

ഈ ലേഖനം നിങ്ങൾക്ക് ഉപയോഗപ്രദമാണെന്ന് ഞങ്ങൾ പ്രതീക്ഷിക്കുന്നു. ചുവടെയുള്ള അഭിപ്രായങ്ങളിൽ നിങ്ങൾ എന്താണ് ചിന്തിക്കുന്നതെന്ന് പങ്കിടാൻ മറക്കരുത്.