ONLYOFFICE Desktop Editors documenteert geen enkele optie om "Pluginontwikkeling inschakelen". De ondersteunde workflow is om uw eigen plugin te installeren via Plugin Manager, deze in de lokale pluginmap te plaatsen en eventueel de geïnstalleerde kopie te vervangen door een symbolische link naar uw bronmap. Om fouten te inspecteren en breakpoints te gebruiken, start u de desktop-app met de gedocumenteerde debug-vlag. Dit zijn aparte stappen: de debugmodus toont de ontwikkelaarstools, terwijl het installeren of linken van de plugin deze beschikbaar maakt voor de editor.
De huidige API-documentatie van ONLYOFFICE beschrijft dezelfde workflow voor desktops en documenteert ook een vlag om de debugmodus ingeschakeld te houden bij het opstarten van het programma. Ik heb geen officiële melding gevonden van een nieuwe schakelaar voor de ontwikkelmodus die deze stappen wijzigt. Deze handleiding volgt de officiële instructies die beschikbaar zijn op 6 oktober 2026. Padnamen kunnen variëren afhankelijk van het installatietype, dus controleer het pad voor uw platform voordat u bestanden wijzigt.
| Benadering | Het beste voor | Afweging |
|---|---|---|
Een archief installeren .pluginin Plugin Manager | Eerste installatie, snelle tests of incidentele wijzigingen | Eenvoudig en ondersteund, maar u moet het archief na elke wijziging in de broncode opnieuw opbouwen en installeren. |
| Koppel de map van de geïnstalleerde plugin aan uw bronmap. | Regelmatige aanpassingen tijdens de ontwikkeling | Verwijdert dubbele verpakking, maar vereist het juiste pad per gebruiker en een herlaad- of heropeningsactie om de wijzigingen door te voeren. |
| Start met de debug-vlag | Het inspecteren van console-uitvoer, plugin-frames of breakpoints. | Hiermee worden ontwikkelaarstools ingeschakeld; er wordt geen plug-in geïnstalleerd en er wordt niet automatisch onbetrouwbare code geladen. |
Voor de meeste ontwikkelaars volstaat het om het archief eenmalig te gebruiken om de plugin te registreren, en vervolgens een symbolische link te gebruiken voor verdere verwerking. Voeg de debug-vlag alleen toe bij het diagnosticeren van code. Laat de permanente variant uitgeschakeld, tenzij je de ontwikkelaarstools bij elke opstart nodig hebt.
Begin met een lokale pluginmap die ten minste de bestanden bevat die uw plugin nodig heeft, waaronder config.jsonen index.html. Het configuratiebestand moet een geldige plugin-GUID bevatten en verwijzen naar de startpagina en de assets van de plugin met behulp van het ONLYOFFICE-pluginschema. Raadpleeg de officiële voorbeeldplugins of de API-documentatie voor het volledige schema; een onjuiste GUID, een foutief pad of een ongeldige configuratie kan ervoor zorgen dat de plugin niet verschijnt.
De GUID config.jsonheeft meestal de vorm asc.{YOUR-GUID}. Desktop Editors gebruikt de GUID als naam voor de pluginmap, maar laat het asc.voorvoegsel weg. Gebruik dezelfde GUID in de bronmap, het archief en het installatiepad. Hergebruik niet de GUID van een ingebouwde of een andere geïnstalleerde plugin.
.zipnaar .plugin..pluginbestand en bevestig.De plugin zou dan in het tabblad Plugins in de geopende editor en in later geopende editors moeten verschijnen. De handmatige archiveringsmethode werkt zonder internetverbinding. Installatie via de Marketplace is bedoeld voor kant-en-klare plugins; het is geen vervanging voor het laden van uw eigen ontwikkelingsversie.
Na de eerste installatie slaat Desktop Editors een kopie op in een sdkjs-pluginsmap. Vervang die kopie door een symbolische link naar uw bronmap, zodat u de werkbestanden direct kunt bewerken. Sluit Desktop Editors af voordat u de geïnstalleerde testplugin-map wijzigt. Maak een back-up of zorg ervoor dat uw bronmap intact is en verwijder alleen de map die overeenkomt met de GUID van uw testplugin.
| Besturingssysteem | Gebruikerspluginmap |
|---|---|
| Windows | %LOCALAPPDATA%\ONLYOFFICE\DesktopEditors\data\sdkjs-plugins\ |
| macOS | ~/Library/Application Support/asc.onlyoffice.ONLYOFFICE/data/sdkjs-plugins/ |
| Linux | ~/.local/share/onlyoffice/desktopeditors/sdkjs-plugins/ |
Binnen de map is de linknaam de GUID tussen accolades, zonder asc.voorvoegsel. Als de configuratie-GUID bijvoorbeeld is asc.{91EAC419-EF8B-440C-A960-B451C7DF3A37}, is de map- of linknaam {91EAC419-EF8B-440C-A960-B451C7DF3A37}.
Open de opdrachtprompt als beheerder als uw Windows-account of -beleid dit vereist. Nadat u de editors hebt gesloten en de geïnstalleerde test-plugin-map hebt verplaatst, maakt u de mapkoppeling aan:
mklink /D "%LOCALAPPDATA%\ONLYOFFICE\DesktopEditors\data\sdkjs-plugins\{YOUR-GUID}" "C:\path\to\your\plugin"Vervang beide plaatsaanduidingen door de GUID en het volledige pad naar uw bronmap. Het doel van de link mag nog niet bestaan.
ln -s "/path/to/your/plugin" "$HOME/Library/Application Support/asc.onlyoffice.ONLYOFFICE/data/sdkjs-plugins/{YOUR-GUID}"ln -s "/path/to/your/plugin" "$HOME/.local/share/onlyoffice/desktopeditors/sdkjs-plugins/{YOUR-GUID}"Gebruik de paden voor uw geïnstalleerde versie; verpakte of gesandboxte builds kunnen gebruikersgegevens elders opslaan. Nadat u de broncode hebt bewerkt, opent u het document opnieuw of laadt u de plug-in opnieuw, afhankelijk van wat van toepassing is. De symbolische link voorkomt dat het archief opnieuw wordt opgebouwd, maar wijzigingen worden niet noodzakelijkerwijs overgenomen totdat de editor de plug-in opnieuw laadt.
Om een plug-in te debuggen, sluit u Desktop Editors volledig af en start u het opnieuw met --ascdesktop-support-debug-info. Gebruik de opdracht die geschikt is voor uw besturingssysteem; als u de app op een aangepaste locatie hebt geïnstalleerd, past u het uitvoerbare pad aan.
Voer dit uit in de opdrachtprompt:
"%ProgramFiles%\ONLYOFFICE\DesktopEditors\DesktopEditors" --ascdesktop-support-debug-infoAls alternatief kunt u het veld 'Doel' van een snelkoppeling bewerken door een spatie en de vlag achter het uitvoerbare pad toe te voegen. Dit heeft gevolgen voor het starten van bestanden via die snelkoppeling.
"/opt/onlyoffice/desktopeditors/DesktopEditors" --ascdesktop-support-debug-info"/Applications/ONLYOFFICE.app/Contents/MacOS/ONLYOFFICE" --ascdesktop-support-debug-infoZodra de app actief is, klikt u in een document en drukt u op F1, of klikt u met de rechtermuisknop op een bewerkbaar veld in de werkbalk en kiest u 'Element inspecteren' . Selecteer in de ontwikkelaarstools de iframe van de plug-in om de JavaScript-code en logboeken ervan te inspecteren. De code die aan wordt doorgegeven, wordt callCommanduitgevoerd in het editorvenster met de naam frameEditor, waardoor de fouten en breakpoints ervan in een andere context kunnen verschijnen dan de UI-code van de plug-in.
De optionele vlag --ascdesktop-support-debug-info-keep=1zorgt ervoor dat de debugmodus ingeschakeld blijft bij het opstarten. Om de permanente status uit te schakelen, start u met --ascdesktop-support-debug-info-keep=0; gebruik --ascdesktop-support-debug-info-keep=defaultom terug te keren naar de standaardstatus. Permanente ontwikkelaarstools zijn handig op een dedicated testmachine, maar als u ze ingeschakeld laat op een gedeeld werkstation, zorgt dit voor extra rommel en blijven inspectietools beschikbaar wanneer u ze niet nodig hebt.
F1of via 'Element inspecteren' nadat het programma is gestart met de debug-vlag.frameEditor.Als de plugin ontbreekt, controleer dan of de config.jsonbestanden index.htmlzich in de hoofdmap van het archief bevinden, of de GUID geldig is en of de map de GUID zonder asc.voorvoegsel gebruikt. Controleer of de link naar de bronmap verwijst en niet naar een bovenliggende map die de plugin bevat. Als de plugin wel verschijnt, maar zich gedraagt als een oudere versie, sluit en heropen het document zodat de editor de gekoppelde bestanden opnieuw laadt.
De debug-vlag voor desktops is geen algemene machtigingsschakelaar voor pluginontwikkeling. Het installeren van een archief of het plaatsen van een map in de map voor ondersteunde plugins maakt die plugin beschikbaar; de debug-vlag maakt inspectietools zichtbaar. Instructies voor het laden van een plugin via een URL in een webeditor zijn evenmin automatisch van toepassing op desktopeditors. Gebruik de hierboven beschreven installatie- en debugprocedure die specifiek is voor desktopeditors.
Deze instructies hebben betrekking op plug-ins voor ONLYOFFICE Desktop Editors. Ze leggen niet uit hoe u plug-ins inschakelt in DocSpace, hoe u server-side plug-ins configureert in ONLYOFFICE Docs of hoe u een plug-in publiceert in de Marketplace. Raadpleeg voor die workflows de bijbehorende officiële productdocumentatie.
Verbind ONLYOFFICE Desktop Editors met uw eigen cloudserver, meld u aan, open cloudbestanden, beheer de verbinding en los veelvoorkomende installatieproblemen op.
Troubleshoot high Collabora Online CPU usage by identifying busy kit processes, checking metrics and logs, tuning concurrency and cleanup, and verifying fixes safely.
Leer hoe je ONLYOFFICE Docs kunt personaliseren met een logo in de header en interfacekleuren, inclusief licentielimieten, het instellen van thema-JSON, Docker-paden en testen.
Verbeter de leesbaarheid van tekst in LibreOffice Calc door het thema van de app, het lettertype en de opvulkleuren van de cellen, de stijlen en de voorwaardelijke opmaak te controleren en vervolgens de afdruk te verifiëren.
Verwijder de waarschuwing voor vergrendeling door onbekende gebruiker in LibreOffice op een veilige manier. Controleer actieve sessies, beveilig een kopie, verwijder alleen een geverifieerde, verouderde vergrendeling en test het document.
Corrigeer Arabische of Hebreeuwse tekst die niet goed doorloopt, uitgelijnd is of vermengd is met Engels in LibreOffice Writer. Schakel de complexe tekstlay-out in, stel de alinearichting in en controleer het resultaat.
Learn VLOOKUP and XLOOKUP in LibreOffice Calc, including exact matches, left lookups, not-found results, reverse search, INDEX/MATCH alternatives, and common errors.
Los problemen met de WOPI-bewijsvalidatie van Collabora Online op door de ontdekkingssleutels, sleutelrotatie, proxy-URL's, tijdstempels en host-whitelists te controleren.
Schakel 'Wijzigingen bijhouden' in voor iedereen in een ONLYOFFICE-document, zorg ervoor dat deze functie actief blijft na het opnieuw openen en begrijp de beperkingen van een algemene standaardinstelling.
Vergelijk de time-outs per weergave, onscherpte, inactieve documentstatus, automatisch opslaan en proxy-time-outs van Collabora Online, en kies en controleer vervolgens de instellingen voor uw implementatie.
