Zotero plugin allows users to create bibliographies in ONLYOFFICE editors using Zotero service.
The plugin is pre-installed in ONLYOFFICE Workspace (both Enterprise and Community Edition), ONLYOFFICE cloud service, and ONLYOFFICE Personal. It can also be installed to Document Server and desktop editors manually.
-
Search references by author, title or year.
-
Among search results, choose ones you want to add to your document.
-
Choose style (e.g. Chicago Manual, American Psychological Association) and language.
-
Press
Insert citation
. -
Press the button
Isert bibliography
to add or refresh a bibliography. -
Press the button
Refresh
to refresh all citations and a bibliography fields into the document. -
Press the button
Synchronize
to synchronize data with zotero service and update data into the document. -
If you want to open this document in other editors, you should convert all fields to text. Press the button
Save as text
for it.
Please note that Zotero works only with user’s personal library associated with the your account. The desired sources must be added to your library in Zotero before you can search and add them to your bibliography via plugin.
Two installation ways are available:
-
Put the folder with the plugin code to ONLYOFFICE Document Server folder depending on the operating system:
For Linux -
/var/www/onlyoffice/documentserver/sdkjs-plugins/
.For Windows -
%ProgramFiles%\ONLYOFFICE\DocumentServer\sdkjs-plugins\
.The plugins will be available to all the users users of ONLYOFFICE Document Server. No service restart is required.
-
Edit the Document Server config to add the following lines:
var docEditor = new DocsAPI.DocEditor("placeholder", { "editorConfig": { "plugins": { "autostart": [ "asc.{BFC5D5C6-89DE-4168-9565-ABD8D1E48711}", ... ], "pluginsData": [ "https://example.com/path/to/zotero/config.json", ... ] }, ... }, ... });
Important: when you integrate ONLYOFFICE Document Server with a 3rd-party storage, you need to use special connectors (integration apps). If you compile a connector from source code or create a new one, you can add plugins using Document Server config. If you use ready connectors (e.g. from ownCloud/Nextcloud marketplaces) adding plugins via config is not applicable.
- Archive the plugin files (the archive must contain config.json, index.html, and pluginCode.js).
- Change the file extension to .plugin.
- Go to the Plugins tab, click Manage Plugins >> Add plugin, browse for the .plugin file.
-
Find Zotero plugin in
Plugins
tab of the ONLYOFFICE Document Editor and click it. -
Log in to your Zotero account.
-
Follow
Zotero API settings
link from the plugin’s window. If you are logged in, you'll be able to proceed. If you are not logged in, you'll see an error message. In this case, clickLog in
(top right corner of your screen). -
Press
Create new private key
. -
Fill in
Key Description
, make sureAllow library access
box is checked and pressSave Key
. -
Copy the newly created key and paste to
API Key
field in the plugin’s interface and save it.
For CentOS users with SELinx enabled, after copying the src folder to sdkjs-plugins, plugins may not work due to the variable file security context. To restore the rights, use the following command:
sudo restorecon -Rv /var/www/onlyoffice/documentserver/sdkjs-plugins/
After that restart the services:
sudo supervisorctl restart ds:docservice
To ask questions and share feedback, use Issues in this repository.