Module d'ajout rapide de contenus
Ce module permet de personnaliser le menu du bouton « Ajouter » de la top-bar en choisissant tous types de publication que l'on souhaite y voir apparaître, et notamment des publications que vous avez créées spécifiquement pour votre site.
La personnalisation de ce bouton devient alors une opération réalisable à 100% depuis le Back Office de JCMS et ne nécessitant pas de redémarrage du serveur.
Thèmes : Contribution
Version 1.0
Compatibilité : JCMS 9, 10
Documentation
Introduction
Ce module permet de personnaliser le menu du bouton « Ajouter » de la top-bar en choisissant tous types de publication que l'on souhaite y voir apparaître, et notamment des publications que vous avez créées spécifiquement pour votre site.
La personnalisation de ce bouton devient alors une opération réalisable à 100% depuis le Back Office de JCMS et ne nécessitant pas de redémarrage du serveur.
Ces types sont regroupés en quatre groupes :
- Type de contenu
- Type de contenu utilisateur
- Type de formulaire
- Type de portlet
Le module permet également de :
- Choisir l'ordre d'affichage des groupes de publication et de liens d’ajout des types de publication
- Remonter l’affichage d’un lien d’ajout d'un ou plusieurs types de publication au premier niveau du menu, c'est-à-dire en dehors des groupes
Exemple de rendu du menu "Ajouter" :
Dans l’exemple ci-dessus, on retrouve les 4 groupes de type de publication (Contenus, Contenus utilisateur, Formulaires et Portlets) et 2 types de publication remontés en premier niveau (Brève et Actualité WISEN) les autres étant réparties dans les différents groupes au 2ème niveau.
Informations techniques
Compatibilité JSync
Ce module est compatible jSync, il fonctionnera sans problème sur un environnement à plusieurs réplicas.
En revanche, il est important de noter que la configuration du module ne sera pas répliquée et sera à faire sur chaque nœud.
Compatibilité JDK
Ce module est compatible avec la version 1.7 de JDK (Java Development Kit). Si vous êtes sur la version 1.6 de JDK, contactez-nous.
Prérequis
Pour une meilleure compréhension et utilisation de ce module, il est conseillé d’avoir suivi les formations JCMS suivantes :
- Formation d’administrateur technique
- Formation d’administrateur fonctionnel
Installation du module
Ajouter ce module avec le gestionnaire de modules depuis l’administration technique et redémarrer JCMS.
Paramétrage
Liste des propriétés
Editez le module pour paramétrer ou modifier ses propriétés :
Note : Les positions prises en comptes vont de 1 à 99. Au-delà, la valeur ne sera pas prise en compte.
| Propriété |
Nom technique |
Description |
|---|---|---|
| Liste des types de contenu |
|
Indiquez dans cette propriété les noms Java (attention aux majuscules) des types de contenu que vous souhaitez voir apparaître dans le groupe "Contenus", séparés par des espaces. Exemple : Article Interview SmallNews FileDocument DBFileDocument |
| Position du groupe "Contenus" |
|
Indiquez dans cette propriété un chiffre correspondant à la position à laquelle vous souhaitez voir apparaître le groupe "Contenus" dans le menu. |
| Liste des types de contenu utilisateur |
|
Indiquez dans cette propriété les noms Java (attention aux majuscules) des types de contenu utilisateur que vous souhaitez voir apparaître dans le groupe "Contenus utilisateur", séparés par des espaces. Exemple : DBComment BlogPost … |
| Position du groupe "Contenus utilisateur" |
|
Indiquez dans cette propriété un chiffre correspondant à la position à laquelle vous souhaitez voir apparaître le groupe "Contenus utilisateur" dans le menu. |
| Liste des types de formulaire |
|
Indiquez dans cette propriété les noms Java (attention aux majuscules) des types de formulaire que vous souhaitez voir apparaître dans le groupe "Formulaires", séparés par des espaces. Exemple : SignUp |
| Position du groupe "Formulaires" |
|
Indiquez dans cette propriété un chiffre correspondant à la position à laquelle vous souhaitez voir apparaître le groupe "Formulaires" dans le menu. |
| Liste des types de portlet |
|
Indiquez dans cette propriété les noms Java (attention aux majuscules) des types de portlet que vous souhaitez voir apparaître dans le groupe "Portlets", séparés par des espaces. Exemple : PortletImage PortletJsp |
| Position du groupe "Portlets" |
|
Indiquez dans cette propriété un chiffre correspondant à la position à laquelle vous souhaitez voir apparaître le groupe "Portlets" dans le menu. |
| Liste des types de publication de 1er niveau |
|
Indiquez dans cette propriété les noms Java (attention aux majuscules) des types de publication que vous souhaitez voir apparaître en dehors de tout groupe (dans le premier niveau se déroulant au clic sur le bouton « Ajouter »), séparés par des espaces. Exemple : Glossary WebPage PortletJsp BlogPost |
| Position des types de contenu de 1er niveau |
|
Indiquez dans cette propriété un chiffre correspondant à la position à laquelle vous souhaitez voir apparaître les types en dehors des groupes dans le menu. Si plusieurs types ont été définis en « 1er niveau », ils apparaitront dans l’ordre saisi dans le champ. |
| Eléments à supprimer |
|
Indiquez dans cette propriété les noms de propriété d'affichage des types de publication standard JCMS que vous ne souhaitez plus voir apparaître dans le menu, séparés par des espaces. Se référer au fichier de propriété du module concerné (plugin.prop) pour obtenir les noms de propriété d'affichage. Exemple : publish-menu.item.other.80.core.send-alert. Notez que pour faire réapparaître un type de contenu supprimé, un redémarrage du site est nécessaire après la modification de cette propriété. |
Enregistrement des nouvelles propriétés
Les changements de valeur des propriétés sont pris en compte directement lors de l'enregistrement sans avoir besoin de redémarrer l'application.
Le module écrit (et met à jour) les propriétés dans le custom.prop.
Exemple de paramétrage
Avec les paramétrages ci-dessous :
| N° |
DESCRIPTION |
|---|---|
| 1 |
Le groupe « Contenus » remontera les contenus suivants :
|
| 2 |
Le groupe « Contenus » sera affiché en première position dans le menu « Ajouter » |
| 3 |
Le groupe « Contenus utilisateurs » ne sera pas affiché |
| 4 |
Le groupe « Formulaires » remontera les formulaires suivants :
|
| 5 |
Le groupe « Formulaires » sera affiché en troisième position dans le menu « Ajouter » |
| 6 |
Le groupe « Portlets » remontera les portlets suivants :
|
| 7 |
Le groupe « Portlets » sera affiché en quatrième position dans le menu « Ajouter » |
| 8 |
Le type de contenu « Glossaire » sera affiché dans le premier niveau du menu « Ajouter » |
| 9 |
Le type de contenu « Glossaire » sera affiché en deuxième position dans le premier niveau du menu « Ajouter » |
Nous obtenons le menu suivant :
Remarques :
Pour que vos contenus apparaissent dans le menu, assurez-vous par ailleurs qu’ils sont bien activés dans votre ou vos espaces de travail.
Ils existent d’autres modules JCMS qui peuvent ajouter des groupes et/ou publications au menu « Ajouter » que ce module ne gère pas.
FAQ
Il suffit de laisser les propriétés de position à vide.
Il faut indiquer dans les propriétés les noms Java des types dans l'ordre dans lequel vous souhaitez qu'ils apparaissent dans un groupe.
Cette entrée native à JCMS et présente initialement dans le premier niveau du menu ajouter a été remplacée par 2 entrées distinctes (« Document » et « DB document ») positionnées dans le groupe « Contenus ».
Menu Ajouter en natif dans JCMS :
Menu Ajouter après avoir installé ce module :
L’intérêt étant ici de bien séparer l’ajout de ces 2 types de contenu (document stocké en base et document stocké en store) en 2 modales distinctes au lieu d’avoir une seule modale d’ajout de document.
La gestion de cet élément est un peu particulière dans JCMS et ne fait pas partie des 4 groupes de publication paramétrables dans ce module. Il est cependant possible de le retirer du menu en utilisant le champ des éléments à supprimer dans le module et en entrant la valeur « publish-menu.item.other.80.core.send-alert ».
Non, il n'est pas prévu de pouvoir les déplacer pour le moment.
Dans un premier temps, il faut s'assurer que le mode développement soit activé. Pour ce faire, allez dans les propriétés du site puis dans l’onglet avancé et vérifiez que l’option « Outils de développement » est sur « Afficher ».
Dans le bloc « Développement » de l'administration technique, partie « Structure des données », sélectionnez le type de publication souhaité.
Le nom Java d'un type est dans la colonne « Nom interne ».
La visibilité de ces liens est gérée en fonction des droits de contribution des contenus paramétrés dans les groupes utilisateurs en natif dans JCMS :
Les membres de ces groupes verront les contenus cochés en contribution.
Assurez-vous que votre publication est bien activée dans votre ou vos espaces de travail. Pour le vérifier, ouvrez votre espace de travail. Dans la partie Administration, cliquez sur l’onglet Types de publication :
Assurez-vous que votre publication est bien paramétrée sur un workflow de votre site ou que la valeur sélectionnée est « Utiliser » :
Et n’oubliez pas d’enregistrer !
Glossaire
A
ACSII
L'American Standard Code for Information Interchange (Code américain normalisé pour l'échange d'information), plus connu sous l'acronyme ASCII ([askiː]) est une norme de codage de caractères en informatique ancienne. Le jeu de caractères codés ASCII est le principal système qui a permis l'échange de textes en anglais à un niveau mondial, limitant ainsi l'usage des langues locales au travers d'extensions régionales.
Actions entrantes & actions sortantes
Ces actions sont paramétrables dans les workflows. Elles définissent l’entrée ou la sortie d’un état de workflow. Une action entrante signifie l’arrivée dans un état du workflow (ex : une publication qui est planifié). Une action sortante signifie la sortie d’un état vers un autre (ex : une publication qui passe de l’état planifié vers l’état publié).
C
Classe
En programmation orientée objet, une classe définie un ensemble d’objets ayant des attributs communs, et le même ensemble d'opérations.
J
Jsync
Jsync est un moteur de réplication des données et des fichiers. La tâche principale de JSync est de synchroniser les données d'un groupe de serveurs JCMS (aussi appelés réplicas), et de répartir la charge de ces serveurs. Ainsi, toute création, modification ou suppression de données (catégorie, membre, contenu, …) sur l'un des réplicas sera propagée par le réplica leader aux réplicas membres du groupe. JSync assure ainsi la cohérence globale des données d'un groupe de serveur JCMS. Ajouter un lien vers la fiche jsync sur jalios.com.
L
LOG
Correspond à un historique d’évènements stockés dans un fichier, appelé fichier de log (diminutif de logging), permettant de suivre et repérer toutes activités du site. Les évènements sont horodatés et ordonnés en fonction du temps.
LOG4J
Log4j est une bibliothèque de log en Java. Elle permet entre autres de gérer plusieurs niveaux de log :
- FATAL: utilisé pour journaliser une erreur grave pouvant mener à l'arrêt prématuré de l'application
- ERROR: utilisé pour journaliser une erreur qui n'empêche cependant pas l'application de fonctionner
- WARN: utilisé pour journaliser un avertissement, il peut s'agir par exemple d'une incohérence dans la configuration, l'application peut continuer à fonctionner mais pas forcément de la façon attendue
- INFO: utilisé pour journaliser des messages à caractère informatif (nom des fichiers, etc.)
- DEBUG: utilisé pour générer des messages pouvant être utiles au débogage
- TRACE: utilisé par exemple pour journaliser l'entrée ou la sortie d'une méthode
M
MailPolicyFilter
Il s’agit d’un point de débranchement (hook) intervenant lors de l’envoi d’un e-mail dans JCMS. Plus détails ici.
N
Notifications email
Il s’agit de notifications transmises par email à un ou plusieurs utilisateurs JCMS. Ces emails permettent d’alerter, informer ou d’envoyer un rappel aux utilisateurs concernant un évènement passé ou à venir, d’une action traitée ou à traiter. Sous JCMS, il existe 3 types de notification : INFO, ACTION, ALERTE.
P
Portail
Un portail permet d’agréger et de personnaliser des informations de provenances multiples pour en offrir une vision unique. On distingue les portails documentaires étroitement liés à la gestion de contenu, et les portails d’infrastructure liés à des problématiques d’intégration d’applications.
Portlet
Elément de portail. Il existe différents types de portlets :
- portlets de construction de page
- portlets de contenu (en charge de récupérer et de formater l'information),
- portlets de navigation,
- portlets fonctionnelles,
- portlets de log.
L'assemblage des différents types de portlets permet de construire des gabarits de page portail.
S
Store
Fichier .xml stockant des données sur les publications, les portlets, les espaces de travails, et d'autres fonctionnalités propres à JCMS.
Certaines données de l'application peuvent aussi être stockées en base.
Voir les contenus liés :
- Fiche "Utiliser le store" (fiche Jalios ou Wisen)
- Fiche "Nettoyer le store" (fiche Jalios ou Wisen)
- Autre entrée de glossaire
T
W
Wiki
Le wiki est une site Web ou page web collaborative dont le contenu peut être modifié par les internautes autorisés.
Français