Différences

Ci-dessous, les différences entre deux révisions de la page.

--- joomla [Le 10/10/2014, 22:36]
hyppocampedecourse [Etape 2]
+++ joomla [Le 07/11/2020, 23:32] (Version actuelle)
krodelabestiole restaurée (pas de bugs de beta dans la doc, demande d'aide -> forum)
@@ Ligne 1: / Ligne 1: @@
-{{tag>Lucid CMS BROUILLON}}
+{{tag>xenial bionic serveur internet cms}}
-----
+{{  https://upload.wikimedia.org/wikipedia/commons/thumb/e/e8/Joomla!-Logo.svg/2560px-Joomla!-Logo.svg.png?240}}
 ====== Joomla! ======
-===== Qu'est ce que c'est ? =====
+[[wpfr>Joomla!]] est un [[:CMS]] utilisant [[:PHP]] et [[:MySQL]]. C'est le second CMS le plus utilisé au monde après [[:WordPress]] et avant [[:Drupal]].
-{{  http://upload.wikimedia.org/wikipedia/fr/7/7f/Joomla_Logo.png?140}}
-==== Qu'est ce qu'un CMS ? ====
+===== Installation =====
-  * **Pour faire simple, un [[CMS]] (système de gestion de contenu) est un logiciel web qui permet de créer un site internet dynamique en toute simplicité, sans connaissances techniques particulières, l'idée étant de séparer le volet technique du logiciel de la forme et du contenu qui seront eux la partie visible de l'iceberg : votre site tel qu'il sera vu par vos futurs visiteurs.**
-//En italique et précédé de "Note Ubuntu 14.04 et joomla! 3.2.7 :", les modifs (légères) à apporter à ce tuto pour l'installation en tout cas avec la version 3.2.7 de Joomla! sous Ubuntu 14.04. Attention, je ne suis pas l'auteur de ce tuto et pas franchement super expérimenté. Ces modifs permettent de suivre le tuto sans trop devoir chercher des solutions dans les forums en cours de route. Si vous avez mieux, n'hésitez surtout pas!//
+==== Prérequis ====
+Pour installer Joomla! vous aurez besoin d'un [[:web#serveurs|serveur HTTP]], de [[:PHP]], et d'un serveur de base de données MySQL ([[:MySQL]] ou [[:MariaDB]]).
-===== Pré-requis =====
+<note>Sur un hébergement web géré par l'hébergeur, ces prérequis devraient déjà être en place, donc toutes ces étapes devraient être inutiles.
-Pour installer et utiliser Joomla!, il vous faut un [[:lamp|serveur LAMP]] installé et fonctionnel.
-<note warning>
+N'hésitez pas à contacter le support de l'hébergeur si ce n'est pas le cas.</note>
-Nota: Vérifier bien les pré-requis de version Apache, PHP, MySQL (ou autre) disponible sur le site français de Jooma :[[http://aide.joomla.fr/administration-joomla/pre-requis-techniques-joomla]]
-</note>
+[[:apache2|Apache]] est le serveur HTTP le plus couramment utilisé, et cette configuration (en conjonction avec MySQL et PHP) s'appelle une pile [[:LAMP|LAMP]].
-===== Installation de Joomla! =====
+Donc pour installer [[:apache2|Apache]], [[:PHP]] et [[:MySQL]] ou [[:MariaDB]], suivez [[:LAMP#installation|cette documentation]].
-==== Choix de la version ====
-Un peu comme Ubuntu, il existe une version LTS (Long Time Support) à privilégier en production et une version de "développement" à utiliser pour des essais et pour préparer un nouveau site ou une migration.
-==== Chargement de Joomla ====
+Une fois la pile [[:LAMP]] installée (avec les modules PHP les plus courants), nous allons créer un [[:apache2#hotes_virtuels|hôte virtuel]] pour Joomla!, dont la racine sera ''/var/www/joomla'' :
-Créez un répertoire pour votre site à la racine de votre serveur (par défaut /var/www ; ou dans le répertoire de Xampp pour ceux qui utilisent Xampp.) :\\
+<code>sudo nano /etc/apache2/sites-available/joomla.conf</code>
-Par exemple : //site-joomla//
+Ce qui ouvre avec [[:nano|l'éditeur nano]] un fichier dans lequel nous allons coller :
-  <code>sudo mkdir /var/www/site-joomla</code>
+<file - joomla.conf><VirtualHost *:80>
+        ServerName joomla.localhost
-//Note Ubuntu 14.04 et joomla 3.2.7! : entrez//
+        DocumentRoot /var/www/joomla
- <code> sudo mkdir /var/www/html/site-joomla </code>
+        <Directory /var/www/joomla>
+                AllowOverride all
+                Require all granted
+        </Directory>
+        ErrorLog /var/log/apache2/error.joomla.log
+        CustomLog /var/log/apache2/access.joomla.log combined
+</VirtualHost></file>
+Si un nom de domaine pointe sur le serveur, on l'indique à la place de ''joomla.localhost'' pour la directive ''ServerName''.\\
+(''Ctrl+X'' puis ''O'' pour quitter en sauvegardant)
-//C'est le chemin utilisé par votre navigateur pour aller chercher la page d'installation de Joomla (on peut aussi changer ce chemin, et là un vrai pro Ubuntusien va apparaître sur sa souris blanche et améliorer mes petits ajouts ;-)//
+Finalement, on active l'hôte virtuel et on recharge la configuration d'Apache :
+<code>sudo a2ensite joomla
+sudo systemctl reload apache2</code>
-[[http://aide.joomla.fr/telechargements/joomla-1-6-x-package-d-installation-et-patches|Téléchargez Joomla!]] puis décompressez (avec les [[:sudo|droits administrateur]]) l'[[archivage|archive]] dans ce nouveau répertoire.\\
+<note important>Si votre serveur est sur le [[:Web]], pensez à [[:apache2#securite|sécuriser]] l'accès au site en particulier en forçant [[:apache2#HTTPS]].</note>
-Exemple avec le fichier //Joomla_3.2.2-Stable-Full_Package_French_v2.zip// :
-  cd /var/www/site-joomla
-  sudo unzip Joomla_3.2.2-Stable-Full_Package_French_v2.zip
-//Note Ubuntu 14.04 et joomla 3.2.7! :  Idem, cd /var/www/html/site-joomla ...//
+==== Installation de Joomla! ====
-==== Etape 1 ====
-Lancez votre [[:navigateur]] préféré et dans la barre d'adresse saisissez la ligne suivante :
+=== Copie des fichiers ===
-  http://localhost/site-joomla/installation/index.php
-Bien sûr, remplacez //site-joomla// par le nom de votre dossier que vous venez de créer. Vous devez tomber sur une page similaire à celle ci-dessous.\\ \\
-{{ :Etape1.png?500 }}
+Tout d'abord téléchargeons la dernière version française de Joomla! :
+<note important>Adaptez la commande suivante au numéro de la dernière version que vous trouverez [[https://github.com/AFUJ/joomla-cms-fr/releases/latest|ici]].</note>
+<code>wget -O Joomla.zip https://github.com/AFUJ/joomla-cms-fr/releases/download/3.9.15.1/Joomla_3.9.15-Stable-Full_Package_French_v1.zip</code>
-Sélectionnez la langue de l'installation, Joomla vous propose le français par défaut.
+Ensuite nous allons extraire le contenu du zip à la racine de notre hôte virtuel (''/var/www/joomla'' dans cet exemple) :
+<code>sudo unzip Joomla.zip -d /var/www/joomla</code>
-==== Etape 2 ====
+Nous allons aussi créer un fichier de configuration vide :
+<code>sudo touch /var/www/joomla/configuration.php</code>
-Cliquez sur "suivant" pour passer à l'étape 2. **Pendant toute l'installation vous devez utiliser les flèches suivant et précédant de l'installateur, et non celles de votre navigateur.**
+On va renforcer la sécurité en attribuant des [[[[:apache2#permissions|droits]] restrictifs aux fichiers :
+<code>sudo chown -R $USER:www-data /var/www/joomla
+chmod -R a-rwx,u+rwX,g+rX /var/www/joomla
+chmod -R g+w /var/www/joomla/cache /var/www/joomla/tmp /var/www/joomla/administrator/cache /var/www/joomla/administrator/logs /var/www/joomla/configuration.php</code>
-//Note Ubuntu 14.04 et joomla! 3.2.7 :  l'ordre d'installation change quelque peu pour des éléments mineurs (nom de compte etc...) remplissez les consciencieusement et revenez chercher les infos sur ce tuto dès que ça devient technique.
+=== Création de la base de données ===
-En gros, en premier, on vous demande ce qui est en étape 6 de la version de Joomla"présentée dans ce tuto//
-{{ :Etape2.png?500 }}
+Pour créer la base de données qu'utilisera Joomla!, le plus simple est de se connecter avec le client [[:MySQL]] :
+<code>sudo mysql</code>
-Comme vous le remarquerez, le fichier //configuration.php// n'est pas accessible en écriture, mais c'est normal. Sinon, le paramètre Joomla! RG_EMULATION est sur `ON`, laissez pour l'instant, nous verrons ça plus tard.\\
+On arrive alors sur la console SQL sur laquelle nous allons entrer ces commandes (en remplaçant ''mot_de_passe'') :
-Ce qui nous intéresse pour le moment, ce sont les accès aux répertoires de notre site par l'installateur de Joomla!. Pour qu'il puisse avoir accès, nous allons modifier l'accès en écriture pour le groupe d'utilisateurs //www-data//.\\
+<code mysql>CREATE DATABASE joomla;
-Dans votre terminal, tapez la commande suivante, pour modifier le groupe du répertoire de votre site :
+CREATE USER 'juser'@'localhost' IDENTIFIED BY 'mot_de_passe';
-  sudo chown -Rv root:www-data /var/www/site-joomla
+GRANT ALL ON joomla.* TO 'juser'@'localhost';
+FLUSH PRIVILEGES;
+QUIT;</code>
+Il faut remplacer ''mot_de_passe'' par un vrai mot de passe complexe qu'on note pour la prochaine étape.
- //Note Ubuntu 14.04 et joomla! 3.2.7 : un petit html/ entre www/ et site-joomla hein?!//\\
+On vient de créer la base de données ''joomla'' à laquelle l'utilisateur ''juser'' aura accès.
-//modifiez site-joomla par le nom du répertoire de votre site//\\
+=== Installation via l'interface web ===
-**EDIT:** Insérez les options //-Rv// pour modifier les sous-fichiers et les sous-documents, autrement le groupe propriétaire restera //root// et pour visualiser les opérations.
-Finalement, il faut rendre le répertoire accessible en écriture pour le groupe //www-data//.\\
+Joomla! devrait alors être accessible à l'adresse [[http://joomla.localhost/]], et cette adresse nous redirige sur une interface qui nous permet de finaliser l'installation en 4 étapes.
-Dans votre terminal, taper la commande suivante (la première ligne n'est pas nécessaire si vous vous trouvez déjà dans le répertoire de votre site) :
-  sudo chmod -R g+w /var/www/site-joomla
-//modifiez site-joomla par le nom du répertoire de votre site//\\
-chmod sert à changer les droits en accès des fichiers. +w ajoute le droit en écriture (write), g spécifiant que ce droit doit être ajouté seulement au groupe.
-Maintenant, cliquez sur le bouton "vérifiez à nouveau", et tout devrait être ok.
+Il faudra remplir plusieurs champs pour chacune de ces étapes. La description de ces champs est bien indiquée et vous ne devriez pas rencontrer de problème particulier.
+À l'**étape 2** renseignez les champs de cette manière :
+  * **Nom d'utilisateur** : ''juser''
+  * **Mot de passe** : le mot de passe qu'on a noté lors de la création de la base de donnée et de l'utilisateur ''juser''
+  * **Nom de la base de données** : ''joomla''
+Pour le reste, conservez les valeurs par défaut.
-==== Etape 3 ====
+À l'**étape 3**, laissez la couche FTP désactivée et cliquez directement sur //Suivant//.
-{{ :Etape3.png?500 }}
+À l'**étape 4** choisissez en //Type de site// les données que vous souhaitez voir insérées sur votre nouveau site (elles peuvent vous servir d'exemple). Vérifiez dans l'encart //Pré-installation// que tous les voyants sont verts puis cliquez sur //Installer//.
-La page de la licence de Joomla! (qui est la **GNU/GPL**) s'affiche. Acceptez la licence en cliquant sur //Suivant//.
+=== Finalisation ===
-//Note Ubuntu 14.04 et Joomla! 3.2.7 : ne cherchez pas, il n'y en a pas. juste un lien pour la consulter, mais rien à valider//
+Finalement, supprimez le répertoire de l'installeur :
-==== Etape 4 ====
+<code>rm -rf /var/www/joomla/installation</code>
-{{ :Etape4.png?500 }}
-Nous voilà sur la page de renseignements du serveur, de la base de données et de l'utilisateur de la base. Pour cela, remplissez les champs suivants :
-  * Type de serveur : MySql
-  *Serveur : localhost
-  *Nom d'utilisateur : root
-  *Mot de passe : Le mot de passe d'accès à Mysql, celui que vous avez choisi lorsque vous avez installé Mysql et qui n'est pas forcément votre mot de passe root d'ordinateur.
-  *Nom de la base de données : Le nom de la base de données qui va être créée par Joomla! ( FIXME : je pense qu'il faut éviter les caractères spéciaux)
-Ensuite vérifiez que tout est correct et cliquez sur Suivant. Si une fenêtre de confirmation s'ouvre, cliquez sur OK.
-Si vous êtes bloqué, pensez à redémarrer les services de Apache2 via la [[commande_shell|commande]] suivante :
-  sudo /etc/init.d/apache2 restart
-==== Etape 5 ====
-{{ :Etape5.png?500 }}
-Configuration FTP  :vous n'en avez pas besoin ( pour l'instant ), cliquez sur suivant.
-==== Etape 6 ====
-{{ :Etape6.png?500 }}
-**Configuration générale :**
-Nom du Site : laissez donc libre cours à votre imagination !
-Votre e-mail : renseignez l'e-mail de l'administrateur du site
-Mot de passe de l'admin : Le mot de passe que vous souhaitez utiliser pour accéder à l'interface d'administration de Joomla!. **Le nom du super administrateur sera "admin"**, on ne peut pas le changer pendant l'installation. Pour des raisons de sécurité,** il sera important de le changer par la suite via l'interface administration.
-**
-Installer les données d'exemple : Les données d'exemple sont des menus, des sections, des rubriques et des articles installables en une seule fois et qui vous permettront de mieux comprendre le fonctionnement de ce CMS. Il est conseillé de les installer pour les débutants. Pour les installer cliquez sur le bouton Installer les données d'exemple. Ceci fait il devrait apparaître sur ledit bouton Données d'exemple installées.
-Charger le script de migration : ne cocher que si vous êtes un utilisateur averti ; ne pas cocher les éventuelles autres cases disponibles. Puis cliquez sur Suivant.
-==== Etape 7 ====
-{{ :Etape 7.png?500 }}
-Vous êtes normalement arrivé au bout de l'installation. Un message vous indique le bon déroulement de cette installation et qu'avant d'aller plus loin vous devez supprimer le répertoire Installation via la [[commande_shell]] suivante :
-  sudo rm -r /var/www/site-joomla/installation
-(remplacez "site-joomla" par le nom du répertoire de votre site)
-Revenez sur http://localhost/site-joomla/, vous devriez arriver sur la page d'accueil de votre site d'exemple Joomla!. L'installation de Joomla! est ainsi terminée.
-Pour accéder à la partie administration allez à : http://localhost/site-joomla/administrator/
-(remplacez site-joomla par le nom du répertoire de votre site).
-Dans la case identifiant, mettez "admin", et comme mot de passe mettez celui que vous avez choisi étape 6.
+Votre site est désormais installé et accessible à l'adresse [[http://joomla.localhost]]. Son administration est accessible à l'adresse [[http://joomla.localhost/administrator/]].
 ===== Configuration =====
@@ Ligne 151: / Ligne 104: @@
 ==== Comment activer la réécriture des URLs ====
-Allez sur votre site, dans Joomla!, allez dans l'administration, puis dans le menu site choisir //configuration générale//, onglet //site//, mettre //oui// à //URLs explicites (SEF)// et //Utiliser le module Apachemod_rewrite (réécriture au "vol" des URLs)//. Sauvez.
+Rendez vous dans l'administration de votre Joomla!, puis cliquez sur //Configuration//. Dans les //Paramètres SEO//, mettre //oui// pour //Réécriture d'URL en clair (SEF)// et //Réécriture au 'vol' des URL//. Puis cliquez sur //Enregistrer//.
-Ensuite, il faut activer le module //rewrite// de apache2 avec la commande :
-  a2enmod rewrite
-Modifier le fichier /etc/apache2/sites-available/default. Attention, si vous avez des virtual hosts, ne pas modifier //default// mais le fichier correspondant au virtual host de joomla!.
-  sudo nano /etc/apache2/sites-available/default
-Remplacez //AllowOverride None// par //AllowOverride All//
-Demandez gentiment à apache de prendre en considération vos nouvelles exigences =):
-  sudo /etc/init.d/apache2 restart
-=== Cas sans virtual hosts ===
-Ensuite, on va supposer que le site est hébergé dans /var/www/ et Joomla! dans un sous répertoire //site//. À la racine de Joomla!, c'est à dire dans /var/www/site/, renommez le fichier htaccess.txt en .htaccess puis modifiez-le :
-  nano /var/www/site/.htaccess
-Remplacer
-  # RewriteBase /
-par
-  RewriteBase /site
-Si votre site est à la racine, il faut tout fe même penser à enlever le #.
-=== Cas avec virtual hosts ===
-Si vous avez des virtual hosts, reprenez la même procédure en faisant attention en modifiant le fichier //.htaccess//. Dans ce cas, à l'option RewriteBase, il ne faut plus mettre le répertoire à partir de /var/www/ mais à partir de la racine du virtual host.
-Actualisez la page d'accueil du site (après un certain temps si vous avez activé la mise en cache, par défaut 15min), pour que les liens de la page d'accueil soient changés. Appréciez les nouveau URLs de la forme /catégorie/id-article
-=====Utilisation=====
-Voir [[http://aide.joomla.fr/documentation|cette documentation]]
+Activez le module [[:apache2#mod_rewrite]] :
+<code>sudo a2enmod rewrite</code>
+Puis renommez le fichier ''htaccess.txt'' :
+<code>mv /var/www/joomla/htaccess.txt /var/www/joomla/.htaccess</code>
-===== Désinstallation =====
+Actualisez la page d'accueil du site (après un certain temps si vous avez activé la mise en cache, par défaut 15min), pour que les liens de la page d'accueil soient changés. Appréciez les nouvelles URLs de la forme ''/catégorie/id-article''.
-Il suffit de supprimer d'une part le répertoire contenant le site et d'autre part la base de donnée ( via[[phpmyadmin| phpmyadmin]]).
-===== Problème connu =====
+===== Utilisation =====
-Si après l'installation de Joomla! ou suite à une mise à jour de celui-ci, vous avez un problème avec la création d'articles ou l'éditeur de message, [[:tutoriel:comment_modifier_un_fichier|éditer le fichier]] ''libraries/joomla/html/editor.php'' en remplaçant
+Voir [[https://docs.joomla.org/Main_Page/fr|cette documentation]].
-  		// Try to authgnticate -- only add to array if authentication is successful
+===== Mises à jour =====
-			$resultTest = $plugin->onDisplay($editor);
-			if ($resultTest) $result[] =  $resultTest;
-par
+Pour mettre à jour l'intégralité de Joomla!, le serveur a besoin d'un accès en lecture et en écriture à l'ensemble des fichiers. Il faut donc l'y autoriser temporairement :
-			// Try to authenticate
+<code>chmod -R g+w /var/www/joomla</code>
-			if (method_exists($plugin, 'onDisplay')) {
+On effectue ensuite la mise à jour via l'interface d'administration de Joomla! : [[http://joomla.localhost/administrator/]].
-			$result[] = $plugin->onDisplay($editor);
-			}
+Puis on rétablit les permissions sécurisées :
+<code>chmod -R a-rwx,u+rwX,g+rX /var/www/joomla
+chmod -R g+w /var/www/joomla/cache /var/www/joomla/tmp /var/www/joomla/administrator/cache /var/www/joomla/administrator/logs /var/www/joomla/configuration.php</code>
-====="Voir aussi =====
+===== Voir aussi =====
-  * (fr) [[http://joomla.fr/|Site officiel]]
+  * (fr) [[https://joomla.fr/|Site officiel]]
-  * (fr) Discussion [[http://forum.ubuntu-fr.org/viewtopic.php?pid=3600842#p3600842|Installation de Joomla]] sur le forum ubuntu-fr
+  * (fr) [[https://kinsta.com/fr/blog/joomla-vs-wordpress/|comparaison avec WordPress]]
-  * (fr) [[tutoriel:lamp_repertoires_de_travail|Travailler sur un autre répertoire que /var/www]]
-  * (en) [[http://forum.joomla.org/viewtopic.php?p=1459968&sid=42aadce16b662a88b47b204506cbcf4a#p1459968|Problème avec l'éditeur html]]
-  * (fr) [[http://www.foilen.com/category/joomla16|Tutoriels vidéos sur l'installation et l'utilisation de Joomla!]]
 ----
-//Contributeurs : [[:utilisateurs:clement.analogue]] ,Coakette
+//Contributeurs : [[:utilisateurs:clement.analogue]], Coakette, [[:utilisateurs:krodelabestiole]], hyppocampedecourse//