Installation d'une extension

Documentation de l'extension

Avant de commencer, il est toujours judicieux de lire la documentation associée à une extension. La plupart des extensions ont des pages d'accueil et des forums, et il est conseillé de les consulter en premier lieu. Si un fichier README est inclus avec l'extension, vous devriez le lire. Il peut contenir des instructions spéciales d'installation ou de configuration.

Installer des extensions depuis Système

Le formulaire Système / Installer / Extensions est assez bien documenté dans l'écran d'aide. Ce qui est moins évident, c'est que chacune des méthodes d'installation est un plugin. Dans les premières versions de Joomla 4, le plugin Installer depuis le Web était le premier de la liste, et il est possible que ce soit toujours le cas dans les versions mises à jour. Avoir cette méthode en premier est gênant si vous utilisez habituellement l'une des autres méthodes, car il faut quelques secondes pour récupérer les données du site de l'annuaire d'extensions Joomla.

Pour changer l'ordre :

Aller sur Panneau d'administration / Plugins
Sélectionner installer dans le filtre déroulant Sélectionner le type.
Sélectionner l'icône Ordre de tri pour afficher les poignées de tri (ellipse verticale).
Faire glisser l'élément Installer - Installer depuis le Web vers le bas de la liste.
Retourner sur Système / Installer / Extensions pour voir le résultat.

Vous êtes alors prêt à utiliser l'une des méthodes d'installation standard.

Téléverser un pack

Pour la plupart des extensions et des utilisateurs, la procédure sera :

Télécharger l'extension sur votre ordinateur sous forme de pack au format zip.
Depuis l'arrière-plan de votre site Joomla (administration), sélectionner Système → Installer → Extensions.
Depuis l'onglet Téléverser un pack, sélectionner le bouton Parcourir et sélectionner le pack de l'extension sur votre ordinateur, ou glisser-déposer le fichier depuis votre gestionnaire de fichiers.
Le processus de téléversement et d'installation démarre automatiquement.
Certaines extensions peuvent fournir des instructions supplémentaires sur l'installation.
Notez que les modules et les plugins doivent généralement être activés pour fonctionner.

Installer depuis un dossier

Certaines extensions peuvent être trop volumineuses pour utiliser la méthode Téléverser un pack, généralement en raison d'une limite sur la Taille maximale de téléversement définie par votre hébergeur. Dans ce cas, vous pouvez utiliser la méthode Installer depuis un dossier.

Créer un répertoire temporaire sur votre disque dur local et décompresser le fichier d'archive de l'extension dans ce répertoire temporaire.
En utilisant FTP, téléverser le contenu de ce répertoire (y compris les fichiers et sous-répertoires) vers le répertoire /tmp de la racine Joomla sur votre serveur, de sorte à obtenir un chemin tel que /tmp/acmeextension.
Dans le champ Répertoire d'installation, indiquer le répertoire du serveur où vous avez téléversé les fichiers et sous-répertoires du pack, par exemple /home/username/public_html/tmp/acmeextension.
Sélectionner le bouton Vérifier et installer et Joomla! installera le contenu du répertoire indiqué.

Installer depuis une URL

Au lieu de télécharger un fichier zip sur votre ordinateur, vous pouvez simplement utiliser l'URL de téléchargement. Joomla récupérera directement le fichier zip et vous évitera les étapes de téléchargement et de téléversement des méthodes précédentes.

Installer depuis le Web

Cette option permet d'installer une extension directement depuis l'annuaire d'extensions Joomla!. La liste initiale est classée par nombre d'avis, mais vous pouvez filtrer par catégorie pour trouver rapidement une liste d'extensions susceptibles de répondre à vos besoins.

Découvrir des extensions depuis Système

Comme décrit dans l'écran d'aide, la fonction Découvrir permet d'installer des extensions trop volumineuses pour certains systèmes, en particulier les environnements d'hébergement mutualisé à bas coût. Quelque chose qui peut ne pas être évident est que vous devrez peut-être créer des dossiers à différents endroits sur votre service d'hébergement, généralement :

Téléverser les fichiers du site vers siteroot/components/com_mybigcomponent
Téléverser les fichiers d'administration vers siteroot/administrator/components/com_mybigcomponent
Téléverser les médias (css et javascript) vers siteroot/media/com_mybigcomponent
Téléverser les fichiers de langue du site vers siteroot/language/en-GB s'ils ne se trouvent pas dans un dossier de langue du dossier site du composant.
Téléverser les fichiers de langue d'administration vers siteroot/administrator/language/en-GB s'ils ne se trouvent pas dans un dossier de langue du dossier d'administration du composant.

Une fois cela fait, Découvrir devrait trouver le composant et permettre son installation, et il se pourrait même qu'il fonctionne.

Installer des langues depuis Système

La langue par défaut est l'anglais (GB). Elle ne peut être ni supprimée ni installée. Ce qui peut ne pas être évident, c'est que chaque page charge d'abord les chaînes appropriées en en-GB afin de s'assurer que les clés de langue utilisées par les développeurs n'apparaissent pas dans le rendu de la page. Si la langue sélectionnée par l'utilisateur n'est pas l'anglais, alors la langue d'utilisateur est chargée, en remplaçant les chaînes anglaises. Si une langue n'a pas été entièrement traduite, le résultat sera un mélange de la langue d'utilisateur et de chaînes anglaises. Cela peut sembler étrange, mais c'est préférable à un mélange de langue d'utilisateur et de clés de développeurs.

Dans la liste des langues disponibles, sélectionnez celle(s) dont vous avez besoin. Certaines sont marquées d'un bouton vert indiquant qu'elles sont à jour avec la version actuelle de Joomla!. D'autres sont marquées d'un bouton jaune indiquant qu'elles ne sont pas tout à fait à jour. Vous pouvez tout de même les installer. Vous pourrez voir quelques mots en anglais à des endroits qui devraient être dans la langue que vous avez sélectionnée. Mais cela devrait être rare.