2 - Installer Corpus

Corpus s'installe comme n'importe quelle extension Joomla. Il ne demande aucun plugin, aucune bibliothèque, aucun composant compagnon.

Ce qu'il vous faut

Joomla 6.2 ou plus récent. Les versions actuelles de Corpus ne s'installent pas sur un Joomla plus ancien : l'installation et la mise à jour sont refusées, avec le message « Corpus x.y.z demande Joomla 6.2 ou plus récent. Mettez d'abord Joomla à jour. » Mettez donc Joomla à jour en premier, puis installez Corpus.

Corpus utilise le mécanisme des Content Templates apparu en Joomla 5, la balise <search> et les requêtes de conteneur CSS.

Aucune version de PHP particulière au-delà de celle qu'exige Joomla lui-même.

L'installation

Extensions → Gérer → Installer, onglet Téléverser le paquet, déposez le fichier corpus-x.y.z.zip.

Une mise à jour se fait exactement de la même façon : réinstallez le zip par-dessus. Vos réglages sont conservés : ils vivent dans le style, pas dans les fichiers.

Activer le template

Système → Styles de site. Corpus y apparaît sous le nom Corpus - Par défaut. Cliquez l'étoile de la colonne Par défaut pour qu'il s'applique à tout le site.

Le style : le vrai objet à comprendre

Un style est un jeu de réglages. Un template peut en avoir autant que vous voulez, et chaque style s'assigne à des entrées de menu précises.

C'est le mécanisme qui remplace, chez Corpus, les « variantes de page d'accueil » que vendent d'autres templates :

1. Système → Styles de site, cochez Corpus - Par défaut, bouton Dupliquer.
2. Ouvrez la copie, renommez-la, changez ce que vous voulez : la teinte, la variante de forme, le Layout.
3. Onglet Assignation de menus, cochez les entrées concernées.

Les pages ainsi assignées prennent le nouveau style ; toutes les autres gardent le style par défaut. Aucun second template à installer.

Une conséquence à connaître. Les réglages du Layout appartiennent au style. Deux styles peuvent donc avoir des sections différentes, des largeurs différentes et des positions de module différentes, mais les modules eux, restent assignés par le gestionnaire de modules, indépendamment du style.

Le premier réglage à faire : les blocs de l'éditeur

Corpus livre 56 blocs rédactionnels prêts à insérer dans TinyMCE. Ils demandent une manipulation, une seule fois par site, en deux points :

Système → Plugins → Éditeur - TinyMCE, ouvrez le jeu d'options que vous utilisez, puis :

1. dans l'onglet de la barre d'outils, faites glisser le bouton Modèles (Templates) dans la barre. Sans lui, rien ne se charge et il n'y a aucun bouton sur lequel cliquer ;
2. dans le champ Modèles, choisissez corpus/html/tinymce dans la liste déroulante.

Le chemin complet, pas corpus. Joomla ne descend pas dans les sous-dossiers : il lit les fichiers .html du dossier indiqué, et de lui seul. corpus ne contient aucun fichier .html à sa racine, la liste ressort donc vide, sans message.

Le bouton Insérer un modèle de la barre d'outils propose alors les 56 blocs. Voir Écrire dans Corpus.

Ce qu'il ne faut pas faire

Ne modifiez pas les fichiers du template. Une mise à jour les écrasera. Si vous devez changer quelque chose que les réglages ne couvrent pas, passez par un template enfant : voir Aller plus loin.

N'ajoutez pas de feuille de style dans templates/corpus/css/ pour la même raison. Le champ CSS personnalisé du style, ou un template enfant.

Ne désinstallez pas le style par défaut avant d'en avoir activé un autre : Joomla refuse de laisser un site sans style, et vous vous retrouveriez à le faire en base.

À jour pour Corpus 2.1.683.