Installing Live Edit

Live Edit is available for:

• MS Office 2007/2010 (standard and OOXML formats),
• OpenOffice.org 3.3+,
• LibreOffice 3.4.4+.

It is known to work with Internet Explorer 7+ and Firefox 3.6+.

The table below sumarizes the extensions and packages you need to install for each OS and browser.

The Microsoft Office extension is available in 32- and 64-bit. You need to install the version corresponding to Microsoft Office, not the operating system (if you run MS Office 32-bit on Windows 7 64-bit, you need to install Live Edit for MS Office 32-bit).

All Live Edit extension versions are available from: http://download.nuxeo.org/desktop-integration/live-edit/.

For MS Office and Internet Explorer Users

To install Live Edit for MS Office:

1. Run the Live Edit installer and follow the instructions.
2. If you are using Internet Explorer, close all windows and restart it.

3. Go on your Nuxeo application. You now have new icons displayed:

   • MS Office icons below the search box
   • an online editing icon in the workspace listing for MS office documents
     ×
     

   • an online editing icon in the Summary tab of MS office documents

     ×
     
     You can now edit documents online.
     IE 9 compatibility

     Internet Explorer 10 truncates the HTTP_ACCEPT header and prevents Live Edit from working. See the IE 9 Compatibility section for the required configuration.

For MS Office and Firefox Users

Making LiveEdit work for MS Office documents when you use Firefox takes 3 steps:

1. Install Live Edit for MS Office,
2. Install the Firefox extension for Live Edit, called protocol handler,
3. Configure the Firefox protocol handler.

Installing Live Edit for MS Office

You need to install Live Edit for Microsoft Office using the same installer as for MS Office and Internet Explorer: just run the installer and follow the instructions displayed. At the end of this step, you won't see the online editing icons, because you need to install and configure the Firefox protocol handler.

Installing Firefox Protocol Handler

The Firefox Live Edit extension is a regular Firefox extension and gets installed the same way as any other extension on that browser. To install it, click on the link to download it and follow the instructions displayed. At this stage, you still won't see the online editing icons in the application. To see the icons and be able to edit documents, you need ton configure the protocol handler.

Configuring the Firefox Protocol Handler

To configure Live Edit Firefox Protocol Handler:

1. In Firefox, go to Tools > Add-ons > Nuxeo Live Edit Protocol Handler > Preferences (or Options).
2. Change the temp folder : /tmp/ with C:\Temp (or another temp folder like C:\Windows\Temp)
3. Set the mime-types you want to use Live Edit with and click on Add new mapping (see below for the mimetypes mapping).
4. Be sure that the checkbox "Use NXWss" is un-checked.

5. Be sure that the checkbox "Preserve compatibility" is un-checked.

   "Preserve compatibility" box

   Since version 0.4.6 of the protocol handler, there is a checkbox labeled "Preserve compatibility" that allows to preserve the backward compatibility. If some cool features like WebEngine are not available (throwing exception), check that the "Preserve compatibility" is not marked.

6. Click Ok.

MS Office mimetype mapping with MS Office

For OpenOffice.org and Internet Explorer Users

To make Live Edit work when you use OpenOffice.org or Libre Office and Internet Explorer, you need to:

1. install the MS Office - IE Live Edit (see Installing Live Edit for MS Office),
2. install the OpenOffice.org - IE Live Edit extension (see below).

To install Live Edit for OpenOffice.org and Internet Explorer:

1. Run the OpenOffice.org - IE Live Edit installer (.exe) and follow the instructions displayed.
2. Restart Internet Explorer if you have windows open.

3. Go on your Nuxeo application. You now have new icons displayed:

   • MS Office and OpenOffice.org icons below the search box
   • an online editing icon in the workspace listing for MS Office and OpenOffice.org documents
     ×
     

   • an online editing icon in the Summary tab of MS Office and OpenOffice.org documents

     ×
     
     You can now edit documents online.
     IE 9 compatibility

     Internet Explorer 10 truncates the HTTP_ACCEPT header and prevents Live Edit from working. See the IE 9 Compatibility section for the required configuration.

For OpenOffice.org and Firefox Users

To be able to edit OpenOffice.org and LibreOffice documents online using Firefox, you need to:

1. install the Live Edit OpenOffice.org extension (.otx),
2. install the Firefox protocol handler,
3. configure the Firefox protocol handler.

Installing the Live Edit OpenOffice.org Extension (.oxt)

The Live Edit extension for OpenOffice.org is a regular OOo extension and gets installed the same way as any other extension: just double-click the .otx file and follow the instructions. It works on LibreOffice.

Then you need to install and configure the Firefox extension.

Installing Firefox Protocol Handler

The Firefox Live Edit extension is a regular Firefox extension and gets installed the same way as any other extension on that browser. To install it, click on the link to download it and follow the instructions displayed. At this stage, you still won't see the online editing icons in the application. To see the icons and be able to edit documents, you need ton configure the protocol handler.

Configuring the Firefox Protocol Handler

To configure Live Edit Firefox Protocol Handler:

1. In Firefox, go to Tools > Add-ons > Nuxeo Live Edit Protocol Handler > Preferences (or Options).
2. Change the temp folder : /tmp/ with C:\Temp (or another temp folder like C:\Windows\Temp)
3. Set the mime-types you want to use Live Edit with and click on Add new mapping (see below for the mimetypes mapping).
4. Be sure that the checkbox "Use NXWss" is un-checked.

5. Be sure that the checkbox "Preserve compatibility" is un-checked.

   "Preserve compatibility" box

   Since version 0.4.6 of the protocol handler, there is a checkbox labeled "Preserve compatibility" that allows to preserve the backward compatibility. If some cool features like WebEngine are not available (throwing exception), check that the "Preserve compatibility" is not marked.

6. Click Ok.

OpenOffice.org and MS Office mimetype mapping with OpenOffice.org or LibreOffice

File extension

Mimetype

Editor command

Editor command arguments

.doc

application/msword

Path to the OpenOffice.org or LibreOffice soffice.exe file, for instance C:\Program Files\OpenOffice.org 3\program\soffice.exe or C:\Program Files (x86)\LibreOffice 3.4\program\soffice.exe

macro:///LiveEditOOo.launcher.load(%s))

.xls

application/vnd.ms-excel

Path to the OpenOffice.org or LibreOffice soffice.exe file, for instance C:\Program Files\OpenOffice.org 3\program\soffice.exe or C:\Program Files (x86)\LibreOffice 3.4\program\soffice.exe

macro:///LiveEditOOo.launcher.load(%s))

.odt

application/vnd.oasis.opendocument.text

Path to the OpenOffice.org or LibreOffice soffice.exe file, for instance C:\Program Files\OpenOffice.org 3\program\soffice.exe or C:\Program Files (x86)\LibreOffice 3.4\program\soffice.exe

macro:///LiveEditOOo.launcher.load(%s))

.ods

application/vnd.oasis.opendocument.spreadsheet

Path to the OpenOffice.org or LibreOffice soffice.exe file, for instance C:\Program Files\OpenOffice.org 3\program\soffice.exe or C:\Program Files (x86)\LibreOffice 3.4\program\soffice.exe

macro:///LiveEditOOo.launcher.load(%s))

.odp

application/vnd.oasis.opendocument.presentation

Path to the OpenOffice.org or LibreOffice soffice.exe file, for instance C:\Program Files\OpenOffice.org 3\program\soffice.exe or C:\Program Files (x86)\LibreOffice 3.4\program\soffice.exe

macro:///LiveEditOOo.launcher.load(%s))

For Google Chrome Users under MS Windows

For Windows users, Chrome will use Windows registry where NuxeoLiveEdit protocol is declared (LiveEdit for MS IE must be installed). However some steps are needed to configure your computer and the server.

On your machine, you need to force Chrome to handle nxedit protocol:

1. Close Google Chrome because at shutdown it dumps its properties in the file we'll modify.
2. Edit the Local Statefile located under C:\Users\<USERNAME>\AppData\Local\Google\Chrome\User Data.

3. Add the protocol nxedit under the protocol_handlersection, as such:

      "protocol_handler": {
         "excluded_schemes": {
            ...
            "nxedit": false,
            ...
      }
   
   

If the section protocol_handler doesn't exist, find a mailto link and follow it, it should initialize this section.

On the server side, because we don't have a mechanism to detect that LiveEdit is configured yet, you have to set a property to allow LiveEdit on each document type. As a consequence, you'll have to pay attention when clicking on LiveEdit links.

1. Edit $NUXEO_HOME/templates/common/config/nuxeo.properties.
2. Change the value for the property org.nuxeo.ecm.platform.liveedit.config from client to server (uncomment the line if needed).
3. Restart the Nuxeo server.

Working with an Untrusted Certificate

When working with an untrusted certificate, make sure to register it as a trusted one, or you'll encounter a System.Security.Authentication.AuthenticationException exception.

Following this link below, you'll figure out useful information:

Manage Trusted Root Certificates - Microsoft Library