Modules à l'intérieur des articles

Introduction

Vous souhaiterez généralement associer des modules à des articles d'une manière ou d'une autre. Les modules sont habituellement attribués à des positions de module et ces positions apparaissent quelque part sur la page web, comme déterminé par le template. Cependant, il est parfois utile d'intégrer réellement un module au sein d'un article. Joomla dispose d'un plugin nommé Contenu - Charger les modules pour cela. Lorsqu'il est activé, un module peut être intégré dans un article de trois façons différentes :

    {​loadposition position,[style]}
    {​loadmodule mod_type,the title,[style]}
    {​loadmoduleid moduleId}

Où style est l'une des valeurs de Style de module de l'onglet Avancé du formulaire de saisie des données du module, par exemple html, outline, table, card ou noCard.

loadposition

Pour insérer un module dans un article, vous publiez le module dans une position et chargez cette position dans l'article comme suit :

1. Créer un module et définir sa position sur myposition. myposition peut être n'importe quelle valeur qui ne soit pas en conflit avec une position de template existante. Dans le formulaire d'édition du module, saisir la position myposition et appuyer sur entrée au lieu de la sélectionner dans la liste déroulante.
2. Assigner le module à Tous les Liens de menu. Cela garantira qu'il apparaît toujours, quelle que soit la façon dont le visiteur est arrivé à l'article. Le module ne s'affichera pas à moins d'utiliser la commande pour le charger dans un article.
3. Éditer l'article et insérer le texte {​​loadposition myposition} à l'endroit où vous souhaitez que le module apparaisse.

Remarque : Si le plugin Contenu - Charger les modules est désactivé, le texte {​loadposition myposition} s'affichera inchangé dans l'article. De plus, le nom de la position doit être entièrement en minuscules. Une CamelCapitalisation échouera.

loadmodule

La syntaxe {​loadmodule yyy} recherche le premier module dont le type correspond à la chaîne 'yyy'. Vous pourriez ainsi charger un module mod_login en plaçant {​loadmodule login} dans votre texte. Le type n'est pas toujours évident ! Par exemple, le Sélecteur de langue est de type languages. Pour trouver le type, vous devez parcourir la liste des dossiers de modules avec un gestionnaire de fichiers/explorateur et retirer la partie mod_ du nom du dossier.

Si vous souhaitez charger une instance spécifique d'un module, par exemple si vous avez plusieurs modules de connexion intitulés Login 1, Login 2, etc., vous devez utiliser {​loadmodule mod_modType, modTitle} où mod_modType serait mod_login et modTitle serait le nom/titre donné à votre instance de ce module. Ainsi, dans l'exemple ci-dessus, vous obtenez {​​loadmodule mod_login Login 2}.

Vous pouvez également ajouter le style utilisé pour afficher le module. Pour cela, ajouter le style comme troisième paramètre, comme {​loadmodule login,Login 2,xhtml}. Si vous n'ajoutez pas de style, aucun n'est utilisé.

loadmoduleid

La syntaxe {​loadmoduleid z} recherche le module dont l'id correspond au nombre z. Vous pourriez ainsi charger le module avec l'id 200 en plaçant {⁠loadmoduleid 200} dans votre texte. Cette variante n'utilise pas de paramètres supplémentaires comme le paramètre style.

Bouton de l'éditeur

Si le plugin editor-xtd Bouton - Module est activé, vous pouvez utiliser le bouton de l'éditeur Module pour insérer plus facilement les balises décrites ci-dessus dans le texte de l'éditeur. La liste des modules comporte un bouton dans la colonne Titre pour insérer par id et un bouton dans la colonne Position pour insérer par position.

Modules dans les modules

Il est possible d'inclure un module au sein d'un module HTML personnalisé. Ils sont traités par les plugins de contenu de la même manière que les articles.

Des problèmes de mise en forme peuvent survenir car le style du module HTML personnalisé va englober le style du module inclus. C'est pour cette raison que le bouton d'édition Module n'est pas disponible dans les modules de type Personnalisé.