Tutoriels inédits sur le CMS Joomla

Par défaut, Joomla regroupe les champs personnalisés dans des onglets séparés de l'éditeur d'article. Pratique pour ne pas surcharger l'interface, mais parfois contre-productif quand vos contributeurs doivent remplir ces champs à chaque article. Voici comment les ramener au premier plan.

01 Comprendre le problème

Quand vous créez des groupes de champs personnalisés dans Joomla (via Contenu → Champs → Groupes de champs), ils apparaissent automatiquement sous forme d'onglets dans l'interface d'édition d'article. L'utilisateur doit cliquer sur cet onglet pour accéder aux champs — une étape supplémentaire qui peut être oubliée.

L'objectif : afficher ces champs directement sous l'éditeur de texte, dans l'onglet principal, sans onglet intermédiaire.

02 Le principe de la surcharge admin

Joomla permet de surcharger les vues de l'administration en plaçant des fichiers dans le dossier du template administrateur. Pour le template Atum (template par défaut de Joomla 5), le dossier de surcharge est :

Joomla vérifie d'abord si ce fichier existe dans le template avant de charger le fichier original situé dans :

03 Les deux fichiers en comparaison

Voici les différences clés entre le fichier original et la surcharge.

	Fichier original	Fichier surchargé
Champs personnalisés	Générés dans des onglets séparés via joomla.edit.params	Affichés sous l'éditeur ET exclus des onglets
Position	Onglet indépendant, après l'onglet principal	Intégrés dans la colonne principale, sous le texte
Onglets restants	Tous les onglets sont présents	Les onglets de champs personnalisés sont supprimés
Mises à jour Joomla	Écrasé à chaque mise à jour	Préservé — indépendant du core
Compatibilité	Tous les groupes de champs	Universel : détecte automatiquement les fieldsets fields-*

04 Les modifications apportées

Modification 1 — Afficher les champs sous l'éditeur

Dans l'onglet principal (Contenu de l'article), juste après le champ éditeur, on ajoute une boucle qui détecte tous les fieldsets dont le nom commence par fields- — ce sont les groupes de champs personnalisés — et les affiche directement :

<!-- AJOUT dans la colonne col-lg-9, après le fieldset éditeur -->
<?php // Champs personnalisés affichés directement sous l'éditeur ?>
<?php foreach ($this->form->getFieldsets() as $name => $fieldset) : ?>
    <?php if (strpos($name, 'fields-') === 0) : ?>
        <fieldset class="options-form mt-3">
            <?php if (!empty($fieldset->label)) : ?>
                <legend><?php echo Text::_($fieldset->label); ?></legend>
            <?php endif; ?>
            <div>
                <?php echo $this->form->renderFieldset($name); ?>
            </div>
        </fieldset>
    <?php endif; ?>
<?php endforeach; ?>

Modification 2 — Exclure les champs des onglets

Sans cette étape, les champs personnalisés apparaîtraient en double : une fois sous l'éditeur, et une fois dans leurs onglets d'origine. On les exclut en les ajoutant au tableau $this->ignore_fieldsets avant l'appel à joomla.edit.params :

<!-- AJOUT juste avant LayoutHelper::render('joomla.edit.params', $this) -->
<?php
// Exclure les groupes de champs personnalisés des onglets
// (ils sont déjà affichés sous l'éditeur)
foreach ($this->form->getFieldsets() as $name => $fieldset) {
    if (strpos($name, 'fields-') === 0) {
        $this->ignore_fieldsets[] = $name;
    }
}
?>
<?php echo LayoutHelper::render('joomla.edit.params', $this); ?>

05 Mise en place pas à pas

06 Résultat et avantages

Voici un résumé de l'architecture finale :

---