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.

Module Module d'ajout rapide de contenus- Illustration

Themes : Contribution
Version 1.0
Compatibility : 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" : 

 topbar

 

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

 jcmsplugin.publishtopbarplugin.1.content.list

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"

jcmsplugin.publishtopbarplugin.1.content.position

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

jcmsplugin.publishtopbarplugin.2.usercontent.list

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"

jcmsplugin.publishtopbarplugin.2.usercontent.position

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

jcmsplugin.publishtopbarplugin.3.form.list

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"

jcmsplugin.publishtopbarplugin.3.form.position

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

jcmsplugin.publishtopbarplugin.4.portlet.list

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"

jcmsplugin.publishtopbarplugin.4.portlet.position

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

jcmsplugin.publishtopbarplugin.5.general.list

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

jcmsplugin.publishtopbarplugin.5.general.position

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

jcmsplugin.publishtopbarplugin.6.delete.list

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 :

 topbarplugin exemple de paramétrage 

 

DESCRIPTION

1

Le groupe « Contenus » remontera les contenus suivants :

  • Article
  • Interview
  • Brève

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 :

  • Inscription

5

Le groupe « Formulaires » sera affiché en troisième position dans le menu « Ajouter »

6

Le groupe « Portlets » remontera les portlets suivants :

  • Portlet Image
  • Portlet JSP

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 :

 topbarplugin exemple de paramétrage V2

 

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 :

publishtopbarplugin FAQ1

Menu Ajouter après avoir installé ce module :

publishtopbarplugin FAQ2

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 :

publishtopbarplugin FAQ5

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 :

publishtopbarplugin FAQ6

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 » :

publishtopbarplugin FAQ7

Et n’oubliez pas d’enregistrer !



Glossary

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.

Translation: fr ACSII ·

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é).

Translation: fr Actions entrantes & actions sortantes ·

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.

Translation: fr Classe ·

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.

Translation: fr Jsync ·

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.

Translation: fr LOG ·

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

Translation: fr LOG4J ·

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.

Translation: fr MailPolicyFilter ·

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.

Translation: fr Notifications email ·

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.

Translation: fr Portail ·

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.

Translation: fr Portlet ·

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

Translation: fr Store ·

T

Top-bar

La top-bar ou super-header correspond à la barre de menu affichée en haut de page : topbar

Translation: fr Top-bar ·

W

Wiki

Le wiki est une site Web ou page web collaborative dont le contenu peut être modifié par les internautes autorisés.

Translation: fr Wiki ·

Workflow

Les circuits de validation (ou workflow) permettent de gérer les cycles de vie des contenus dans l’outil. Ils sont paramétrables et personnalisables par contenu.

Translation: fr Workflow ·

Wysiwyg

WYSIWYG (What You See Is What You Get), en français « ce que vous voyez est ce que vous obtenez », s'applique aux éditeurs de texte et outils de présentation qui permettent d'éditer directement un contenu sous la forme qui sera affichée aux utilisateurs finaux.

Translation: fr Wysiwyg ·