Drupal est un système open source de gestion de contenu ou SGC (Content Management System ou CMS en anglais), pour lequel Selligent fournit un plugin de restitution de contenu permettant d'afficher les pages Selligent sous forme de blocs ou pages Drupal (voir la description dans cette rubrique).
Seules les versions Drupal 7.x peuvent utiliser ce module. En outre, seul le module bloc de Drupal core peut restituer les pages et formulaires Selligent dans un bloc Drupal.
Installer le plugin Drupal
- Extrayez le fichier zip contenant le module de pages Selligent dans le dossier de modules (contrib) de votre installation Drupal 7.
- Accédez à la page de l'onglet Modules de Drupal et activez le module de pages Selligent. Pour ce faire, faites défiler la page vers le bas jusqu'à l'entrée Selligent.
- Cochez la case Enabled.
Notez que la description indique clairement que le module bloc est requis.
- Cliquez sur le lien Permissions pour définir les droits utilisateur du module.
-
- Seul un élément est configurable : Administer Selligent Pages. Activez les rôles devant accéder à cet élément.
-
- Cliquez sur le lien Configure pour configurer ce module. Les pages de configuration ne sont accessibles qu'aux utilisateurs ayant les droits appropriés.
Configurer le plugin Drupal
Dans l'installation Drupal, accédez au plugin Selligent Selligent Pages administration pour activer la page d'administration :
Dans les paramètres par défaut :
- Définissez l'URL de l'outil de restitution de contenu Selligent de votre environnement d'installation Selligent. Si l'outil de restitution de contenu n'est pas encore déployé dans votre installation, contactez l'équipe de support Selligent, qui vous transmettra également l'URL.
- Une fois l'URL Selligent configurée, vous pouvez configurer la valeur de langue par défaut. Cette dernière correspond à une valeur de repli si aucune autre langue n'est détectée.
- Sauvegardez et conservez les paramètres par défaut.
Suivez la procédure ci-après pour chaque page Selligent que vous souhaitez inclure dans votre site Web Drupal :
- Cliquez sur Add new configuration pour créer une nouvelle configuration Selligent. Les propriétés suivantes sont définies :
Selligent Hash : ce paramètre obligatoire contient l'identifiant de hachage Selligent. Cette information se trouve généralement dans le Journey Selligent des propriétés du composant Input. Le code de hachage se trouve également dans les propriétés de la page s'il n'existe aucun autre composant entre le composant Input et le Composant Page.
Type : affiche le contenu restitué sous forme de bloc ou de page.
- Page : crée une nouvelle entrée de menu Drupal (notez qu'il ne s'agit pas d'un menu HTML) permettant d'accéder à la page via une URL. L'URL relative de l'entrée peut être configurée par le champ d'URL de la page. Vous pouvez choisir votre propre chemin relatif (exemple : \SubscriptionPage).
- Block : les blocs configurés s'affichent dans Drupal, dans un tableau glissable, et peuvent être glissés d'une région à l'autre. (Les blocs permettent de réaliser des présentations de contenu dans les sites Drupal, en dehors du contenu principal. Les chemins de navigation et les menus principaux/secondaires sont généralement des blocs.)
Block name or page title : paramètre obligatoire. Nom du bloc dans Drupal, ou nom du titre de la page.
Page url : L'URL de page est obligatoire si le type choisi est Page. Il doit s'agir d'une URL relative. Quand la configuration est activée, un point d'entrée de menu Drupal est créé afin d'afficher le rendu de la page.
Language parameter : le paramètre de langue est utilisé en tant que variable clé de chaîne de requête quand une requête HTTP GET est effectuée dans l'outil de restitution de contenu XML. Si ce paramètre est laissé vide, la valeur LANG par défaut est utilisée.
CSS classnames : chaque contenu de bloc ou de page est inclus dans des éléments HTML DIV. Vous pouvez ajouter des valeurs de classe CSS à l'inclusion DIV en configurant un ou plusieurs noms de classe CSS. Si plusieurs noms de classe sont appliqués, séparez-les d'un espace. Vous préserverez ainsi l'identité de chaque élément.
Active : Si cette option est cochée, la configuration est activée. Quand le type de paramètre est Bloc, un nouveau bloc est créé avec le nom de bloc indiqué. Quand le type est Page, une nouvelle entrée de menu Drupal est créée, correspondant à l'URL de page sur laquelle doit être restitué le contenu.
Dynamic content renderer url : Si cette option est cochée (recommandé), l'URL de l'outil de restitution de contenu est automatiquement définie par le module. Ce dernier utilise la même URL (sans chaîne de requête) pour la restitution de contenu que la page de restitution de la page ou du bloc.Si cette option est décochée, vous devez configurer l'URL de votre outil de restitution de rendu au démarrage du Journey Selligent auquel appartient le hachage Selligent.
- Cliquez sur Save pour sauvegarder cette configuration. Vous être alors redirigé vers la présentation de toutes les pages configurées.
Le tableau de configuration permet à l'administrateur des pages Selligent de modifier ou de supprimer des configurations de pages Selligent en cliquant sur le lien de modification ou de suppression. Cliquez sur le lien de modification pour afficher la page de configuration Selligent Page. Cliquez sur le lien de suppression pour supprimer immédiatement la page de configuration Selligent Page.
Remarque : le module ne crée que des blocs ou pages pour les configurations qui ont été activées. Le bloc ou l'entrée de menu des configurations désactivées ou supprimées sont supprimés.
Remarque2 : n'oubliez pas de définir l'URL de l'outil de restitution de contenu alternatif dans les propriétés du Journey à partir du lieu de restitution de la page Selligent.
Support multilingue
Lorsqu'une requête HTTP est effectuée dans l'outil de restitution de contenu Selligent, la requête contient toujours le paramètre de chaîne de requête de langue (exemple : LANG) défini précédemment dans la configuration. La valeur de ce dernier est déterminée dans l'ordre suivant :
1. Si la requête HTTP contient déjà le paramètre et que la valeur n'est pas vide, cette valeur est utilisée.
2. Si la requête HTTP Post en cours contient déjà le paramètre de langue dans le corps du formulaire et que ce dernier n'est pas vide, c’est cette valeur qui est utilisée (exemple : quand une page Selligent multilingue est postée, elle contient généralement un champ de saisie HTML caché dont le nom correspond au paramètre de langue). C'est cette valeur qui est utilisée.
3. Le module met en œuvre la fonction hook_language_switch_links_alter. Il préserve toutes les variables de chaînes de requêtes quand l'utilisateur modifie la langue actuelle. En outre, elle ajoute le paramètre de chaîne de requête swf à la nouvelle valeur de langue. Si le paramètre est disponible et non vide, c'est cette valeur qui est utilisée. Remarque : les hooks sont généralement utilisés dans Drupal pour remplacer ou étendre les fonctions existantes. Le hook assure ici la persistance du contexte de langue au rechargement de la page quand l'utilisateur change de langue. La valeur de langue passe via la chaîne de requête de l'URL.
4. Quand le contact modifie la langue actuelle, un cookie (DRUPAL_VISITOR_ulang) est créé, qui contient la valeur de la langue modifiée. Si le cookie est présent et non vide, c'est cette valeur qui est utilisée.
5. Quand la valeur de langue globale Drupal contient une valeur de langue non vide, c'est cette valeur qui est utilisée.
6. En tant que valeur de repli, la valeur de langue des paramètres par défaut est utilisée.
Remarque : La variable de langue globale Drupal est définie dans le système Drupal core. Pour les utilisateurs anonymes, elle diffère la langue en recherchant dans les en-têtes de requête HTTP. Pour les utilisateurs authentifiés, elle vérifie dans le profil de ces derniers. Si aucune langue n'est détectée, la langue globale devient la langue par défaut, telle que configurée dans la page de configuration de langue Drupal.
La valeur de langue est généralement transmise à un composant Input d'un Journey Selligent. Ainsi, le contenu est rendu dans la langue de l'utilisateur final. Si vous souhaitez utiliser ce paramètre, cochez sa syntaxe, configurée dans le champ Language parameter de la configuration.
