Différences

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

--- joomla [Le 27/01/2010, 15:57]
213.95.41.13
+++ 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>Dapper Feisty 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! ======
+[[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]].
-===== Qu'est ce que c'est ? =====
+===== Installation =====
-Joomla! est un système de gestion de contenu (en anglais, CMS, pour Content Management system) Open source sous licence GNU/GPL.
-Joomla! est chapeauté par Open Source Matters , Inc., organisation à but non lucratif basée aux États-Unis dont la mission est de fournir une structure légale et financière au projet. Les statuts de l'organisation sont consultables [[http://www.opensourcematters.org|ici]].
-S'il est d'abord orienté gestion de contenu, c'est-à-dire destiné à mettre en ligne des articles et des news, Joomla peut en quelques clics être " détourné " en portail, site de boutique en ligne, site communautaire, site personnel, etc., ce grâce aux centaines d'extensions disponibles sur le web.
+==== Prérequis ====
-==== Qu'est ce qu'un CMS ? ====
+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]]).
-  * **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.**
-==== Versions ====
+<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.
-  * [[http://aide.joomla.fr/telechargements/Joomla-1.0.x-packages-dinstallation-et-patches/Joomla-1.0.15-Stable-fr/details.html|Joomla! 1.0.15 Stable Fr]]  (version 1.0.x plus maintenu, ne pas utiliser ... ou à vos risques ! )
-  * [[http://aide.joomla.fr/telechargements/Joomla-1.5.x-packages-dinstallation-et-patches/Joomla-1.5.15-stable-fr/details.html|Joomla! 1.5.15 Stable Fr]]
-<note warning>Depuis la version Joomla 1.5.6, si vous exécutez sur un serveur php 5,  une version PHP supérieure à 5.0.10 est nécessaire (uniquement si votre serveur est en php5, ne concerne pas les serveurs php4 !)
+N'hésitez pas à contacter le support de l'hébergeur si ce n'est pas le cas.</note>
-Nota: PHP 5.0.4 ne doit surtout pas être utilisé avec Joomla !
+[[: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]].
-En cas de mise à jour d'un site antérieur à Joomla 1.5.10, il faut impérativement éditer la configuration globale et la re-sauvegarder !!!
-Depuis la 1.5.15, Joomla! est désormais compatible avec la version PHP 5.3, mais si vous passez sur un serveur en PHP 5.3.x, pensez a vérifier que vos extensions Joomla sont aussi compatibles !
+Donc pour installer [[:apache2|Apache]], [[:PHP]] et [[:MySQL]] ou [[:MariaDB]], suivez [[:LAMP#installation|cette documentation]].
-</note>
-===== Pré-requis =====
+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'' :
-Pour installer et utiliser Joomla!, il vous faut un [[:lamp|serveur LAMP]] installé et fonctionnel.
+<code>sudo nano /etc/apache2/sites-available/joomla.conf</code>
+Ce qui ouvre avec [[:nano|l'éditeur nano]] un fichier dans lequel nous allons coller :
+<file - joomla.conf><VirtualHost *:80>
+        ServerName joomla.localhost
+        DocumentRoot /var/www/joomla
+        <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)
-===== Préparations sur le serveur =====
+Finalement, on active l'hôte virtuel et on recharge la configuration d'Apache :
-Avant de démarrer l'installation du CMS Joomla!, il va vous falloir créer une base de données et un utilisateur pour Joomla!
+<code>sudo a2ensite joomla
+sudo systemctl reload apache2</code>
+<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>
-==== Création de la base de données ====
+==== Installation de Joomla! ====
-Créez une base de données (par exemple: joomla) soit depuis phpmyadmin, soit en ligne de commande :
-  mysql -u root -p
-pour vous connecter au serveur MySQL (le mot de passe demandé est celui de MySQL et non votre mot de passe root), puis sur le prompt qui apparaît :
-  create database joomla;
-  exit
---- petite précision
+=== Copie des fichiers ===
-Pour utiliser PhpMyAdmin si vous êtes en local sur le navigateur utilisez l'URL suivante:
-http://localhost/phpmyadmin/
+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>
+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>
+Nous allons aussi créer un fichier de configuration vide :
+<code>sudo touch /var/www/joomla/configuration.php</code>
-==== Création de l'utilisateur ====
+On va renforcer la sécurité en attribuant des [[[[:apache2#permissions|droits]] restrictifs aux fichiers :
-Choisissez un nom d'utilisateur pour Joomla! Par exemple : //user-joomla//
+<code>sudo chown -R $USER:www-data /var/www/joomla
-=== Méthode avec phpmyadmin ===
+chmod -R a-rwx,u+rwX,g+rX /var/www/joomla
-Ajoutez cet utilisateur à MySQL avec phpMyAdmin: Entrez le nom d'utilisateur "root" puis le mot de passe utilisé lors de l'installation de MySQL. Depuis la page d'accueil de phpMyAdmin accédez à la page **Privilèges**. Cliquez ensuite sur **Ouvrir une nouvelle fenêtre phpMyAdmin** puis Cliquez ensuite sur **Ajouter un utilisateur**.
+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>
-Entrez alors le nom d'utilisateur choisi, sélectionnez « serveur local » et entrez le mot de passe de votre choix (2 fois)
+=== Création de la base de données ===
-{{add_user_phpmyadmin.png|add user}}
+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>
-Cochez les cases comme ci-dessous et cliquez sur « exécuter »
+On arrive alors sur la console SQL sur laquelle nous allons entrer ces commandes (en remplaçant ''mot_de_passe'') :
+<code mysql>CREATE DATABASE joomla;
+CREATE USER 'juser'@'localhost' IDENTIFIED BY 'mot_de_passe';
+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.
-{{privileges_user_phpmyadmin.png|privilèges user}}
+On vient de créer la base de données ''joomla'' à laquelle l'utilisateur ''juser'' aura accès.
-Juste en dessous, dans __Privilèges spécifiques à une base de données__, sélectionnez votre base de données dans la liste.
+=== Installation via l'interface web ===
-De nouveau, cochez les cases comme ci-dessous et cliquez sur « Exécuter ».
+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.
-{{privilege_user_base_phpmyadmin.png|privilèges user pour la base}}
+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.
-Lorsque vous aurez fini, cliquez sur l'onglet __SQL__, puis exécutez cette requête\\
+À l'**étape 2** renseignez les champs de cette manière :
-  FLUSH PRIVILEGES;
+  * **Nom d'utilisateur** : ''juser''
-=== Méthode en ligne de commande ===
+  * **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''
-Vous pouvez aussi effectuer l'ajout de l'utilisateur et lui donner les droits sur la base de données en ligne de commande :
+  * **Nom de la base de données** : ''joomla''
+Pour le reste, conservez les valeurs par défaut.
+À l'**étape 3**, laissez la couche FTP désactivée et cliquez directement sur //Suivant//.
-  mysql -u root -p
-  use joomla
-  GRANT ALL ON joomla.* TO joomla@localhost IDENTIFIED BY 'PASSWORD_CHANGE_ME';
-  FLUSH PRIVILEGES;
-  exit;
+À 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//.
+=== Finalisation ===
+Finalement, supprimez le répertoire de l'installeur :
+<code>rm -rf /var/www/joomla/installation</code>
+Votre site est désormais installé et accessible à l'adresse [[http://joomla.localhost]]. Son administration est accessible à l'adresse [[http://joomla.localhost/administrator/]].
-===== Installation de Joomla! =====
+===== Configuration =====
-Créez un répertoire pour votre site à la racine de votre serveur (par défaut /var/www) :\\
-Par exemple : //site-joomla//
-  sudo mkdir /var/www/site-joomla
-Décompressez le fichier que vous avez téléchargé précédemment dans ce nouveau répertoire.\\
-exemple avec le fichier //Joomla_1.0.12-Stable-fr.zip// téléchargé sur votre Bureau :
-  cd /var/www/site-joomla
-  sudo unzip ~/Desktop/Joomla_1.0.13-Stable-fr.zip
-Sinon vous pouvez extraire les fichiers en mode graphique en cliquant sur les fichiers à déziper, n'oubliez pas d'indiquer l'endroit où vous souhaitez que les fichier se dézipent (dans l'exemple ci-dessus en mode texte c'est dans le répertoire var qui contient le répertoire www qui contient le répertoire site-joomla que vous avez créé précédemment).
+==== Comment activer la réécriture des URLs ====
+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//.
-<note important>A noter : la version de Joomla! 1.5.5 ne serait pas totalement au point (voir http://forum.ubuntu-fr.org/viewtopic.php?id=241061&p=2); préférez la version Joomla! 1.5.4 qui semble très bien fonctionner (http://www.joomlafacile.com/telechargements/joomla-1.5.x-packages-dinstallation-et-patches/index.php)</note>
+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>
-==== Etape 1 ====
+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''.
-Bon et bien maintenant nous allons dans notre navigateur préféré et nous tapons dans la barre d'adresse la ligne suivante:
-  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.\\ \\
-{{install-joomla-step1.png?512x384|install joomla etape1 partie haut}}{{install-joomla-step1-1.png?512x384|install joomla etape1 partie bas}}\\
-**EDIT:** si vous obtenez une page où tous les accents sont mal affichés, vous pouvez résoudre ce problème en empêchant le serveur Apache de forcer l'utilisation de l'encodage UTF-8 (ce qui ne sera correct qu'à partir de Joomla 1.5).
+===== Utilisation =====
-Dans ce cas, comme indiqué dans la documentation lamp_plus, [[:tutoriel:comment_editer_un_fichier|Éditez le fichier]] **/etc/apache2/conf.d/charset** de façon à ce qu'il contienne :
+Voir [[https://docs.joomla.org/Main_Page/fr|cette documentation]].
-<file>AddDefaultCharset off</file>
-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.\\
+===== Mises à jour =====
-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//.\\
-Dans votre terminal, tapez la commande suivante, pour modifier le groupe du répertoire de votre site :
-  cd /var/www/site-joomla
-  sudo chown -Rv root:www-data ../site-joomla
-//modifiez site-joomla par le nom du répertoire de votre site//\\
-**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//.\\
+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 :
-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) :
+<code>chmod -R g+w /var/www/joomla</code>
-  cd /var/www/site-joomla
+On effectue ensuite la mise à jour via l'interface d'administration de Joomla! : [[http://joomla.localhost/administrator/]].
-  sudo chmod -R g+w ./
-//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.
+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>
-==== Etape 2 ====
-Nous atterrissons sur la page de la licence de Joomla!, qui est la **GNU/GPL**, si vous acceptez la licence, cliquez sur //Suivant//.
+===== Voir aussi =====
+  * (fr) [[https://joomla.fr/|Site officiel]]
+  * (fr) [[https://kinsta.com/fr/blog/joomla-vs-wordpress/|comparaison avec WordPress]]
+----
-==== Etape 3 ====
+//Contributeurs : [[:utilisateurs:clement.analogue]], Coakette, [[:utilisateurs:krodelabestiole]], hyppocampedecourse//
-Nous voilà sur la page de renseignements du serveur, de la base de données et de l'utilisateur de la base. Pour cela, reprenez votre calepin et remplissez les champs suivants :
-  - __Serveur :__ //localhost//
-  - __Nom d'utilisateur :__ //Le nom de l'utilisateur que vous avez créé
- sur PhpMyAdmin//
-  - __Mot de passe :__ //Le mot de passe de l'utilisateur (**Attention, il s'affiche en clair**)//
-  - __Nom de la base de données :__ //Le nom de votre base de données//
-  - __Préfixe des tables :__ //Ne touchez pas à ça, sauf si vous êtes expérimenté//
-  - __Supprimer les tables existantes :__ //Ne cochez cette case que si vous avez déjà essayé d'installer Joomla! sur la même base de données//
-  - __Sauvegarder les anciennes tables :__ //Ne cocher cette case que si vous êtes expérimenté//
-  - __Installer des exemples de données :__ //Laisser cette case cochée, elle vous sera d'une grande utilité par la suite//
-Ensuite vérifier que tout est correct et cliquer sur //Suivant//. Si une fenêtre de confirmation s'ouvre, cliquez sur //OK//.
-Si vous êtes bloqués, pensez à redémarrer les services de Apache2
-  sudo /etc/init.d/apache2 restart
-==== Etape 4 ====
-Laissez  les paramètres tels qu'ils vous sont proposés. N'activez ainsi pas la fonction Ftp. Cliquez donc sur //Suivant//.
-==== Etape 5 ====
-Vous vous retrouvez sur la page de renseignements.\\
-  * __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//
-  * __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 permettrons 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 devrait apparaitre 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 6 ====
-Vous êtes normalement arrivés au bout de l'installation. Un message vous indique du bon déroulement de cette installation et qu'avant d'aller plus loin vous devez supprimer le répertoire //Installation//.
-  sudo rm -r /var/www/site-joomla/installation
-//modifiez 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.
-===== Comment activer la réécriture des URLs =====
-<note>Je vous présente la démarche que j'ai utilisée pour avoir des URLs plus lisibles que celles par défaut en utilisant le module rewrite de apache2 sur Joomla! 1.5. N'hésitez pas à me contacter pour toutes questions. [[utilisateurs:clement.analogue]]</note>
-Aller sur votre site, dans Joomla!, aller 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)//. Sauver.
-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
-Remplacer //AllowOverride None// par //AllowOverride All//
-Demander 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/, renommer le fichier htaccess.txt en .htaccess puis le modifier :
-  nano /var/www/site/.htaccess
-Remplacer
-  # RewriteBase /
-par
-  RewriteBase /site
-Si votre site est à la racine, il faut tout de 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.
-Actualiser la page d'accueil du site (après un certain temps si vous avez activez la mise en cache, par défaut 15min), pour que les liens de la page d'accueil soient changés. Apprécier les nouveau URLs de la forme /catégorie/id-article