Vous êtes ici : Accueil Support Documentation Tutoriels Comment utiliser l'édition externe dans Plone et ZopeEdit

Comment utiliser l'édition externe dans Plone et ZopeEdit

Note: Ceci est une impression contenant toutes les pages du Tutoriel sur une seule page. La version paginée est disponible ici.

Principe de l'édition externe

Il est possible dans Plone d'utiliser un éditeur externe pour éditer certains types d'éléments, comme les fichiers.
L'idée est donc, par exemple, de pouvoir ouvrir Word pour éditer un fichier ".doc" stocké dans Plone.

Normalement, dans les applications web, pour éditer un fichier, il faut d'abord le télécharger, ensuite le modifier avec un logiciel présent sur l'ordinateur, le sauvegarder et enfin le remettre dans l'application web.

Afin de simplifier cette procédure, il est possible d'installer le logiciel ZopeEdit (diminutif de Zope External Editor") sur l'ordinateur.
C'est ce dernier qui va gérer toutes ces opérations.

Afin de profiter pleinement de cette possibilité, il faut procéder en plusieurs étapes, toutes expliquées dans les pages suivantes.

La première est l'activation de l'édition externe dans Plone, sur certains types d'éléments. On aura alors pour ces derniers un nouveau lien pour l'édition externe. Ce lien va permettre de télécharger un fichier ".zem", contenant non seulement le fichier original à éditer mais aussi d'autres informations pour faire le lien entre Plone et le fichier téléchargé sur l'ordinateur.

La seconde étape consiste en l'installation sur le poste client du logiciel ZopeEdit. C'est celui-ci qui va pouvoir ouvrir le fichier ".zem", qui contient, entre autre comme information, le type du fichier original à éditer.
En fonction de sa configuration, ZopeEdit va dès lors pouvoir choisir un logiciel pour éditer le fichier.
À chaque sauvegarde du fichier édité localement, ZopeEdit va ré-enregistrer le fichier dans Plone à la place de la version originale.
 

Activation et configuration dans Plone

Cette partie est donnée pour information car tout est normalement bien activé et configuré dans Plone.

Activation du module "collective.externaleditor"

Une fois connecté en tant qu'administrateur dans Plone, il est possible de cliquer sur le lien "Configuration du site" présent dans le menu sur le nom de l'utilisateur, habituellement en haut à droite.

La page de configuration apparaît. Il faut alors cliquer sur "Modules".

Les listes des modules à installer et déjà installés s'affichent.
Si le module "collective.externaleditor" est encore dans la liste des modules disponibles, il faut cliquer sur sa case à cocher et ensuite sur le bouton "Activer" situé en dessous.

Configuration générale du module

Une fois installé, un nouveau lien de configuration apparaît dans la deuxième partie du menu de configuration du site (colonne de gauche).

En cliquant sur le lien "Édition externe", le menu de configuration apparaît.

Par défaut, l'édition externe est déjà activée.
Il est possible de sélectionner les types d'éléments Plone qui pourront être édités de manière externe en les faisant passer à droite pour les sélectionner (ou à gauche pour les désélectionner).
Il faut bien sûr cliquer sur "Enregistrer" pour enregistrer tout changement.

Activation par utilisateur

Même si l'édition externe est déjà activée dans la configuration, il est nécessaire de l'activer également dans les préférences de chaque utilisateur.

Pour éditer les préférences personnelles, il faut passer par le menu sous le nom de l'utilisateur.

Une fois dans les préférences personnelles, il faut cocher la case pour activer l'édition externe et cliquer sur le bouton "Enregistrer".

Lorsque l'édition externe est bien activée, sur un type d'élément concerné, le lien suivant est affiché en bas de page:


 

Installation et configuration de ZopeEdit, Firefox

Installation de ZopeEdit (Zope External Editor)

ZopeEdit est un logiciel à installer sur l'ordinateur.
Suivant le système d'exploitation utilisé, il faudra installer la version adéquate.

La majorité des postes étant sur Windows, voici la version d'installation pour Windows.
Si vous disposez d'un autre système, vous pouvez nous contacter afin d'obtenir la façon adéquate d'installer l'outil.

Pour l'installation sous Windows, il suffit de lancer l'exécutable d'installation fourni ci-dessus.
Il n'est pas nécessaire d'être administrateur pour ce faire.

Après avoir lancé l'exécutable, l'écran suivant apparaît:

Il faut cliquer sur "Next" pour continuer.

Il est nécessaire de cocher la case "I accept the agreement" avant de pouvoir cliquer sur "Next" à nouveau.

Le dossier d'installation n'a pas d'importance. Il n'est pas utile de le changer mais de le retenir afin de savoir où est installé le produit.

L'installateur propose de créer une entrée dans le menu "Démarrer". Ce sera utile: il ne faut donc pas cocher la case du bas.

L'installateur montre les options d'installation choisie. On peut continuer en cliquant sur "Install".

Si des librairies nécessaires au logiciel sont manquantes, l'installateur propose de les installer.

Il faut cliquer sur "Next" pour continuer.

Il est nécessaire de cocher "I have read and accept the license terms" pour continuer en cliquant sur le bouton "Install".

L'installation des librairies requises est terminée. Il suffit de cliquer sur le bouton "Finish".

Une fois l'installation de ZopeEdit terminée, il suffit de cliquer sur le bouton "Finish".
À ce moment, le logiciel est bien installé.
 

Configuration du navigateur (ici Firefox)

Comme expliqué dans l'introduction, Plone (via son lien d'édition externe) va proposer de télécharger un fichier avec l'extension "zem".

Il faut régler le navigateur pour lui indiquer d'ouvrir tous les fichiers ".zem" avec le logiciel "Zope External Editor".

Toute première fois

La première fois que l'utilisateur clique sur le lien d'édition externe, le navigateur va demander quoi faire avec le fichier zem.

Si zopeedit a bien été installé avant, le navigateur va proposer l'association automatiquement.

Si ce n'est pas ZopeEdit qui est indiqué dans la liste déroulante, il faut aller choisir le programme manuellement en cliquant dans la liste déroulante sur "Autre".
Une fenêtre de sélection permet de choisir dans la liste des programmes. 

Si Zope External Editor n'est pas dans la liste, il faut cliquer sur le bouton "Parcourir" et aller sélectionner le fichier "zopeedit.exe" dans le dossier où il a été installé.

Après avoir sélectionné le fichier "zopeedit.exe", il faut cliquer sur le bouton "Ouvrir" pour valider.

Une fois que Zope External Editor est bien sélectionné dans la fenêtre d'association, il est intéressant de cocher "Toujours effectuer cette action pour ce type de fichier" afin de ne plus devoir faire la même opération la prochaine fois.


 

Modification ultérieure

Il est toujours possible de changer une mauvaise association, en accédant aux options du navigateur (via le menu "Outils" > "Options").

C'est le menu "Applications" qui contient les associations.

Afin de trouver l'association adéquate, il faut effectuer une recherche sur le mot "zope" ou "zem".

Une fois que la bonne entrée est trouvée, il faut cliquer dans la colonne "Action" pour changer la valeur.

Le plus simple est de sélectionner "Toujours demander" afin de retrouver le scénario "Toute première fois" ci-dessus.
 

Configuration de ZopeEdit

Une fois installé, ZopeEdit dispose d'un fichier de configuration, placé dans un dossier de configuration de Windows.

Il n'est pas recommandé de changer les options de ce fichier, sauf si les réglages par défaut ne sont pas suffisants.
En effet, par défaut, ZopeEdit laisse faire le système d'exploitation pour associer tel type de fichier à éditer, à tel programme.
Parfois, ces associations ne sont pas correctes et il est possible de les forcer via le fichier de configuration.

Avant de changer le fichier de configuration, soyez certain que le navigateur est bien configuré et que le problème vient bien de ZopeEdit.

Pour ouvrir ce fichier, le plus simple est de passer par le menu "Démarrer" et de lancer "Zope External Editor".

La première fois, le fichier de configuration s'ouvre dans un éditeur de texte.

La seconde partie du fichier contient les associations entre le type de fichier, son extension et le programme à utiliser pour l'ouvrir.
C'est cette partie qu'il faut en général compléter ou modifier.

Un exemple ci-dessous pour un document de type odt (libreoffice)

[content-type:application/vnd.oasis.opendocument.text]
extension=.odt
editor=

Après modification du fichier, il est nécessaire de l'enregistrer.

Si on lance à nouveau "Zope External Editor", une petite fenêtre va demander quoi faire.

En cliquant sur "Oui", le fichier de configuration va être réinitialisé à des valeurs par défaut avant ouverture.
En cliquant sur "Non", la version actuelle du fichier de configuration est ouverte.
Dans le doute, cliquer sur "Non".
 

Résolution des problèmes

ZopeEdit utilise un fichier de log pour écrire ses messages d'erreur.
En cas de problème, le plus simple est donc d'ouvrir ce fichier afin d'obtenir toutes les infos sur ce premier.

Le fichier de log se situe habituellement dans le dossier indiqué dans la variable %TEMP%. Cela peut être un des dossiers suivants:

  • C:\Documents and Settings\utilisateur\Local Settings\Temp

 

Problème à l'ouverture du fichier

Il faut vérifier en premier lieu si Firefox est bien configuré pour ouvrir les fichiers ".zem", en se rendant dans la configuration de Firefox.

Si c'est bien le cas, il faut alors adapter la configuration de ZopeEdit.

Pour les applications iA.Urban et iA.Docs, les documents générés ou les modèles à éditer sont au format ".odt" et doivent être impérativement ouverts avec LibreOffice, comme indiqué dans les prérequis.
Si ce n'est pas LibreOffice qui ouvre ces fichiers, il faut modifier le fichier de configuration de ZopeEdit en modifiant ou ajoutant les lignes suivantes:

[content-type:application/vnd.oasis.opendocument.text]
extension=.odt
editor=

Si cela n'est pas suffisant, il faut préciser dans la ligne "editor" le chemin complet vers LibreOffice Writer (partie document texte de LibreOffice).
Le chemin de l'exécutable peut varier suivant le PC.
Afin de connaître le chemin exact, le plus simple est de trouver le lien vers le programme "LibreOffice Writer" dans le menu "Démarrer", de faire un clic droit dessus, ensuite "Propriétés". Dans l'onglet "Raccourci" se trouve le chemin complet vers l'exécutable.

editor="C:\Program Files (x86)\LibreOffice 5\program\swriter.exe"