Articles with the tag:
Close
Changelog
Close
Help Center
Integration
  • All
  • Overview
  • Online editors integration

Overview

Integrating ONLYOFFICE with Nuxeo open sourse content management system through a connector, available in in the official Nuxeo Marketplace or on ONLYOFFICE GitHub page, allows you to edit Office documents within Nuxeo platform.

ONLYOFFICE add-on adds the following features:

  • Creating and editing office text docuemnt,s spreadsheets and presentations.
  • Co-editing documents in real-time: use two co-editing modes (Fast and Strict), Track Changes, comments, and built-in chat.
  • Opening for editing and viewing docx, pptx and xlsx formats.
    The following formats are only available for viewing only: pdf, odt, ods, odp, doc, xls, ppt.
    Connector Connector

Online editors integration

This addon enables users to edit office documents from Nuxeo using ONLYOFFICE Document Server.

Installing ONLYOFFICE Document Server

You will need an instance of ONLYOFFICE Document Server that is resolvable and connectable both from Nuxeo and any end clients. If that is not the case, use the official ONLYOFFICE Document Server documentation page: Document Server for Linux. ONLYOFFICE Document Server must also be able to POST to Nuxeo directly.

The easiest way to start an instance of ONLYOFFICE Document Server is to use Docker Compose.

Installing ONLYOFFICE addon for Nuxeo

Go to the Nuxeo marketplace and find the latest connector version of Nuxeo ONLYOFFICE connector.

The provided instructions use the nuxeoctl script. Visit official Nuxeo documentation page to find more available options on how to install packages.
  • For a Nuxeo Online Services registered instance with internet access:
    1. Stop your server
      ./nuxeoctl stop
    2. Run the following command to install the connector:
      ./nuxeo/bin/nuxeoctl mp-install onlyoffice-nuxeo-x.x.x
      Where onlyoffice-nuxeo-x-x-x is the latest available version of the Nuxeo ONLYOFFICE connector.
    3. After the package is downloaded and installed, start your server
      ./nuxeoctl start
  • For an unregistered instance, or an offline instance:
    1. Stop your server
      ./nuxeoctl stop
    2. Download the connector
      wget https://connect.nuxeo.com/nuxeo/site/marketplace/package/onlyoffice-nuxeo/download?version=x.x.x 
      Where version=x.x.x is the latest available version of the Nuxeo ONLYOFFICE connector. Otherwise, visit the Nuxeo marketplace and find the link manualy.
    3. Install the package by providing the path to the downloaded .zip file
      ./nuxeoctl mp-install /Path/to/file/onlyoffice-nuxeo-x.x.x.zip
    4. After the package is downloaded and installed, start your server
      ./nuxeoctl start

Configuring ONLYOFFICE addon for Nuxeo

Open the nuxeo/bin/nuxeo.conf file via any available text editor and add the following lines into it:

onlyoffice.docserv.url=http://documentserver/
onlyoffice.jwt.secret=/your_secret/

Where docserv.url is an url of an installed and running ONLYOFFICE Document server and jwt.secret is the secret to validate the JSON web token in the request to Document Server.

If you used Docker to install ONLYOFFICE Document Server, use information from ONLYOFFICE Github page to properly configure JWT.

If you used other installation options, check the API documentation for configuring JWT on the Document Server side.

Compiling ONLYOFFICE addon for Nuxeo

To build Nuxeo plugin, the following steps must be performed for Ubuntu:

  1. The stable Java version is necessary for the successful build. Use the following commands to install Open JDK 8:
    sudo apt-get update
    sudo apt-get install openjdk-8-jdk
  2. Install Maven by running the following command:
    sudo apt install maven
    Installation process of Maven in details is described here. To verify the Maven installation and see the current version, run
    mvn -version
  3. Download the Nuxeo ONLYOFFICE integration plugin source code:
    git clone https://github.com/onlyoffice/onlyoffice-nuxeo.git
  4. Compile Nuxeo ONLYOFFICE integration plugin:
    cd onlyoffice-nuxeo/
    mvn clean install
  5. Built package is located here ./onlyoffice-nuxeo-package/target/onlyoffice-nuxeo-package-x.x.zip.
Download Best editors on your website Let your site users view, edit and collaborate
on all types of text, spreadsheet and presentation files
You Might Also Like This:
Close