Skip to main content

Liferay

Introduction​

ONLYOFFICE allows you to edit the files stored in your Liferay account and collaborate on them using both online and desktop editors. Thereby, you can use not only online collaboration tools but also the features available in your desktop application, such as access to system fonts, the clipboard, and system printers.

To take full advantage of all these editing options, you will need to install and configure several components:

  1. It's supposed that you already have a Liferay server instance installed and configured. If not, you can refer to the Liferay official installation instructions.
  2. Install ONLYOFFICE Docs. Please note that the Liferay server and ONLYOFFICE Docs must be accessible to each other over the network.
  3. Enable our official integration app in the Liferay administrator account.
  4. Connect your Liferay server to ONLYOFFICE Desktop Editors.
note

An Internet connection is required for connecting your Liferay server, as well as for real-time co-editing.

Step 1. Install ONLYOFFICE Docs​

The easiest way to install ONLYOFFICE Docs is to use Docker. Execute the following command:

sudo docker run -i -t -d -p 80:80 --restart=always onlyoffice/documentserver

To find more detailed instructions on how to install ONLYOFFICE Docs using Docker, you can refer to this article.

To make sure that ONLYOFFICE Docs is installed successfully, enter the IP address and, optionally, port (if it has been changed during the installation) in your browser address bar, e.g., http://192.168.3.202:81 - the ONLYOFFICE Docs welcome page should open.

Step 2. Install and configure the ONLYOFFICE connector for Liferay​

You can install the ONLYOFFICE connector using the App Manager or from the official Liferay App Store. To install it using the App Manager, navigate to Control Panel -> Apps -> App Manager. Click the Options button, then click the Upload button. In the opened window, choose the ONLYOFFICE application file. To install the connector from the App Store, navigate to Control Panel -> Apps -> Store. Sign in with your Liferay account. Search for the ONLYOFFICE Connector for Liferay. Purchase the application (it is free). When the installation is completed, the application is ready for use.

When the connector is installed, you need to configure it. On the ONLYOFFICE application settings page, specify the address of the machine where the ONLYOFFICE Docs is installed in the ONLYOFFICE Docs address field. If you’ve changed the port during the installation, do not forget to specify it, e.g. http://192.168.3.202:81. Click the Save button to apply the settings.

To find out more details on configuring the integration app, you can refer to the corresponding article for Liferay.

Step 3. Connect to Liferay server​

Launch ONLYOFFICE Desktop Editors. To connect Desktop Editors to your Liferay server, follow the steps below:

  1. Click the Clouds tab on the left navigation panel. The list of the available cloud services opens.

  2. Find Liferay in the Available clouds list and click the Connect link on the right.

  3. The Connect to Liferay window opens. In the Cloud office URL field, enter your Liferay server domain name or IP address. Click the Connect button.

    Connect to Liferay

  4. The Liferay Sign In page opens in a new tab of the Desktop Editors interface. Specify the Email Address and the Password you use to access your Liferay account and click the Sign In button. Check the Remember Me box to stay signed in to Liferay.

    Sign in to Liferay

Your Liferay account main page opens in the same tab. Now you can edit your existing files, create new ones, share your documents, and collaborate with Liferay users using ONLYOFFICE editors.

Step 4. Manage your connected accounts​

Click the ONLYOFFICE tab in the upper left corner of the window to return to the main program window. The connected cloud accounts appear in the Connected clouds section at the top of the Clouds tab. Hover the mouse over a connected cloud and click the three dots Dots icon on the right to access the cloud context menu options:

Liferay connected

  • Open – to switch to the corresponding cloud storage tab if you are already logged in to this account, or to open the Connect to Liferay window if you are not currently logged in (in such a case, you will need to enter your credentials).
  • Logout – to exit from your account. The connected account still appears in the Connected clouds section, but you have to log in again next time to access your Liferay files.
  • Remove from list – to disconnect the selected account and remove it from the list.

To add more accounts or clouds, use the Available clouds list below on the Clouds tab.