Ajout des espaces projets


Ce chapitre traite de l'ajout et la configuration de votre application pour utiliser les espaces projets

Dépendances ivy

Dans les fichiers ivy-webapp.xml de votre application, ajoutez les dépendances au plugins workspaces, workspaces-site et à la charte workspaces

Dans l'ivy du cms

<dependency org="org.ametys.plugins" name="workspaces" branch="2.0.x" rev="latest.release" conf="web_compile_dependencies->compile_dependencies;web_runtime_dependencies->runtime_dependencies;web_compile,web_runtime->runtime"/>
<dependency org="org.ametys.skins" name="skin-workspaces" branch="4.3.x" rev="latest.release" conf="web_compile_dependencies->compile_dependencies;web_runtime_dependencies->runtime_dependencies;web_compile,web_runtime->runtime"/>

Dans l'ivy du site

<dependency org="org.ametys.plugins" name="workspaces-site" branch="2.0.x" rev="latest.release" conf="web_compile_dependencies->compile_dependencies;web_runtime_dependencies->runtime_dependencies;web_compile,web_runtime->runtime"/>

Attention, par le jeu des dépendances, la version de jquery apportée par le noyau peut être modifiée.
La version minimale du web est 1.12, alors que la skin workspaces apporte la 3.3.1

Il se trouve que de nombreuses fonctions ont changé en jquery 3 et donc de nombreux scripts peuvent ne plus marcher si ils ont été conçus pour jquery 1 ou 2

Il est donc nécessaire de comparer la version de jquery présente dans WEB-INF/lib avant/après l'installation des espaces projets et si un saut de version majeur est constaté, il faut retester les chartes graphiques principalement au niveau des fonction jquery (boite de dialogues...) ou des composants basés dessus (pirobox, carrousel, galeries photos...)
En cas de problèmes constaté, il faudra migrer ces composants pour supporter la dernière version de jquery.
Il existe un script nommé jquery-migrate qui essaie de faire en sorte que les scripts prévus pour jquery 1 ou 2 continuent de fonctionner en jquery 3. Vous pouvez l'importer dans votre head.xsl en 1er script .

Fichiers de workflow

Télécharger les fichiers de workflows nécessaires à l'utilisation des espaces projets.

Copiez ces fichiers dans le répertoire WEB-INF/param/workflows de votre application.

Le fichier wall-content.xml est le workflow dédié aux mur de brèves.

Le fichier editionfo.xml est le workflow dédié aux contenus des pages "wiki".

Les fichiers calendar-default.xml et calendar-simple.xml sont des exemples de workflow pour les événements des calendriers.

Le fichier content.xml est le fichier de workflow des contenus standard. Il inclut les actions nécessaire à la modification front-office des actualités, alertes, et autres contenus.

Fichier de configuration

Télécharger les fichiers de configurations à mettre dans le répertoire WEB-INF/param de votre application.

Le fichier cms-uitools-project-workspace.xml contient les outils ouvert par défaut lorsqu'on accède au backoffice d'un espace projet.

Clés i18n

Quelques clés i18n liées aux workflows sont à rajouter dans le catalogue  i18n du plugin "default-workflow" de votre application

<message key="WORKFLOW_ACTION_CREATE_AND_VALIDATE">Création et validation</message>
<message key="WORKFLOW_ACTION_CREATE_AND_VALIDATE_DESCRIPTION">Crée et publie un contenu</message>
<message key="WORKFLOW_ACTION_CREATE_AND_VALIDATE_ACTION_DESCRIPTION">&lt;strong&gt;{user}&lt;/strong&gt; a créé et publié le contenu.</message>

<message key="WORKFLOW_ACTION_EDIT_FO">Modification depuis le site</message>
<message key="WORKFLOW_ACTION_EDIT_FO_DESCRIPTION">Cliquez ici pour modifier le contenu sélectionné.</message>
<message key="WORKFLOW_ACTION_EDIT_ACTION_DESCRIPTION">&lt;strong&gt;{user}&lt;/strong&gt; a modifié le contenu.</message>

Quelques clés i18n sont également à rajouter dans le catalogue i18n de l'application (WEB-INF/i18n/application*.xml) pour l'intitulé des nouveaux workflows

<message key="WORKFLOW_calendar-default">Sans cycle de vie</message>
<message key="WORKFLOW_calendar-simple">Cycle avec validation</message>
<message key="WORKFLOW_wall-content">Brève</message>
<message key="WORKFLOW_editionfo">Wiki</message>
Retour en haut