Manuel Pour Contao 3.5
Total Page:16
File Type:pdf, Size:1020Kb
Table des matières Table des matières Introduction 1.1 Installation 1.2 Installer Contao 1.2.1 Utilisation du Safe Mode Hack 1.2.2 Mise à jour manuelle 1.2.3 Live Update Service 1.2.4 Déplacer une installation 1.2.5 Configuration du serveur en ligne 1.2.6 Panneau d'administration 1.3 Liste d'enregistrements 1.3.1 Édition des enregistrements 1.3.2 Raccourcis clavier 1.3.3 Gestion des pages 1.4 Composants 1.4.1 Thèmes 1.4.2 Feuilles de style 1.4.3 Modules 1.4.4 Présentations de page 1.4.5 Types de page 1.4.6 Gestion du contenu 1.5 Articles 1.5.1 Actualités 1.5.2 Événements 1.5.3 Flux RSS/Atom 1.5.4 Bulletins d'information 1.5.5 Formulaires 1.5.6 Commentaires 1.5.7 Modèles 1.5.8 Markdown 1.5.9 Balises d'insertion 1.5.10 Administration du système 1.6 Utilisateurs et groupes d'utilisateurs 1.6.1 Extensions 1.6.2 Maintenance 1.6.3 1 2 Introduction Manuel pour Contao 3.5 Ceci est le manuel officiel pour les utilisateurs et les développeurs. Vous pouvez toujours trouver la dernière version sur docs.contao.org. Licence The Contao documentation is licensed under a Creative Commons Attribution 3.0 License license (CC BY-NC-SA 3.0). If you want to redistribute a modified or unmodified version of the documentation, you can do so under the license terms. If you contribute to the documentation, e.g. by creating pull requests, you grant us full usage rights of any content you create or upload. You also ensure that your content does not violate any third-party rights. We are not claiming exclusive usage rights, therefore you are free to use your contributed content (e.g. texts or images) in any other project as well. 3 Installation Installation Les chapitres suivants expliquent comment installer et mettre à jour Contao. Vous apprendrez à utiliser l'outil d'installation de Contao, comment synchroniser une installation existante via FTP, comment configurer le "Safe Mode Hack" ainsi qu'un serveur pour Contao. 4 Installer Contao Installer Contao Premièrement, veuillez télécharger la dernière archive de Contao et l'extraire sur votre ordinateur. Déplacez les fichiers dans le répertoire htdocs de votre installation locale (par exemple XAMPP) ou les téléverser sur votre serveur avec un logiciel FTP (nous vous recommandons d'utiliser WinSCP). Assurez-vous de téléverser le fichier caché .htaccess.default et de remplacer son nom par .htaccess . Selon la configuration de votre serveur, le dossier public est probablement nommé htdocs , httpdocs , html , public_html ou www . Si vous avez un accès SSH, vous pouvez télécharger et extraire l'archive directement en ligne de commande, par exemple avec curl . Selon la version que vous souhaitez installer, ajuster les URL comme décrit. Dernière version de Contao (4.x) : curl -L http://download.contao.org | tar -xzp Version LTS de Contao (3.5) : curl -L http://download.contao.org/lts | tar -xzp Une version spécifique (par ex. 3.5.2) : curl -L http://download.contao.org/3.5.2 | tar -xzp L'outil d'installation de Contao Pour ouvrir l'outil d'installation de Contao, il suffit d'ajouter /contao/install.php à l'URL de votre installation de Contao. Notez que l'outil d'installation est protégé contre les attaques par force brute et sera bloqué si un mauvais mot de passe a été inséré trois fois de suite. Pour enlever le verrou, ouvrez le fichier system/config/localconfig.php dans un éditeur de texte, trouvez la ligne ci-dessous et définissez-là à 0 . $GLOBALS['TL_CONFIG']['installCount'] = 0; // Ceci enlèvera le verrouillage automatique Connexion à la base de données Connectez-vous au panneau d'administration de votre serveur (par exemple "Plesk" ou "cPanel") et créez une nouvelle base de données pour Contao. Ensuite, entrez les identifiants de connexion dans l'outil d'installation de Contao. Notez que le jeu de caractères par défaut de Contao UTF-8 s'écrit UTF8 dans MySQL ! Mise à jour des tables de la base de données Lorsque que vous êtes connecté à la base de données, Contao vérifie automatiquement ses tables et affiche une liste de changements recommandés dans le cas où ils ne seraient pas à jour. Assurez-vous de lire attentivement ces recommandations, car Contao ne connaît que ses propres tables et tentera de supprimer celles d'autres applications en partage avec la base de données. Confirmez les modifications et cliquez sur le bouton "Mettre à jour la base de données". Importer un modèle Un modèle est un site internet pré-configuré qui comprend un exemple de structure de site et plusieurs feuilles de style pour formater les modules de base de Contao ainsi que les éléments de contenu. 5 Installer Contao A partir de la version 3.2.11, le site internet de démonstration n'est plus inclus dans le package de téléchargement. Selon la version utilisée, la nouvelle et officielle démonstration de Contao ou l'ancienne Music Academy peuvent être installées en tant qu'extension. Les informations concernant la compatibilité sont disponibles dans le référentiel d'extensions. Comment installer le modèle de démonstration : 1. Créer une nouvelle installation de Contao avec un compte administrateur 2. S'identifier en tant qu'administrateur dans le back office 3. Installer l'extension correspondante en utilisant le référentiel d'extensions 4. Se déconnecter du back office 5. Ouvrir de nouveau l'outil d'installation Pour importer un modèle, sélectionnez l'entrée dans le menu déroulant et cliquez sur le bouton "Importer un modèle". Danger Les données existantes seront remplacées lors de l'importation d'un modèle ! Création d'un utilisateur administrateur Si vous n'avez pas importé un modèle, vous devez créer un utilisateur administrateur pour se connecter au back office de Contao. Après avoir créé le compte, le processus d'installation est terminé. Le lien dans le coin inférieur droit vous amènera vers le panneau d'administration. Si vous avez importé le site internet d'exemple, vous pouvez vous connecter en tant qu'utilisateur "k.jones" avec le mot de passe "kevinjones". Installation du modèle de démonstration de Contao Voir Comment installer le modèle de démonstration dans la section Importer un modèle Utiliser des URLs conviviales pour les moteurs de recherche Si vous utilisez un serveur Apache et êtes autorisé à utiliser mod_rewrite, vous pouvez faire en sorte que Contao génère des URLs conviviales pour les moteurs de recherche qui ressemblent à des documents HTML statiques. Un ensemble de règles de réécriture par défaut est stocké dans le fichier .htaccess.default situé dans le répertoire de Contao. Renommez ce fichier en .htaccess afin que le serveur Apache puisse le traiter, puis connectez-vous au back office et accédez à la configuration du système. Sélectionnez "Ré-écrire les URLs" dans la section "Configuration du front office" et enregistrez vos modifications. Maintenant, Contao génère des URLs statiques comme home.html au lieu de index.php?id=12 . 6 Utilisation du Safe Mode Hack Utilisation du Safe Mode Hack En essayant d'installer Contao avec l'outil d'installation, vous pourriez voir un avertissement que le fichier de configuration local n'est pas accessible en écriture. Problèmes d'autorisation de fichiers Le terme "Safe Mode Hack" peut prêter à confusion, car il implique que le problème a été causé par le safe_mode de PHP. Cependant, il est causé par des permissions de fichiers insuffisantes et peut se produire même si le safe_mode est désactivé, il devrait donc être appelé "File Permission Hack" à la place. PHP en tant que module Apache est généralement exécuté comme wwwrun , www-data ou nobody , alors que les fichiers que vous téléverser via FTP vous appartiennent (par exemple web4 ou ab5678 ). Le serveur refuse donc, au script PHP de Contao, l'accès à ces fichiers. Utilisation du FTP pour les opérations sur les fichiers Pour contourner le problème des permissions, Contao établit une connexion FTP pour modifier les fichiers et les répertoires. Tout ce que vous avez à faire est d'entrer vos identifiants de connexion FTP. Faites attention lorsque vous entrez le chemin relatif à partir de votre répertoire racine FTP vers le répertoire de Contao (par exemple html/ , public_html/ ou httpdocs/ ). Quelques répertoires nécessitent encore des autorisations d'écriture, car PHP va y accéder directement : assets/images assets/images/* system/logs system/tmp 7 Utilisation du Safe Mode Hack Les permissions (CHMOD 777) sont fixées automatiquement par l'outil d'installation et n'ont normalement pas à être ajustées manuellement. Si cela est nécessaire, veuillez, s'il vous plaît, seulement n'ajuster que les trois répertoires mentionnés ci- dessus - et cela en dépit de ce que vous pourriez avoir lu dans un tutoriel ou dans les forums de Contao ! 8 Mise à jour manuelle Mise à jour manuelle Pour mettre à jour manuellement une installation de Contao, vous pouvez soit téléverser l'archive complète de Contao sur le serveur (remplacement des fichiers) ou vous pouvez téléverser uniquement les fichiers qui ont été modifiés depuis la dernière mise à jour (synchronisation des fichiers). De toute façon, vous devriez toujours sauvegarder les fichiers et dossiers ci-dessous juste au cas où il y aurait une erreur ou lors d'un remplacement accidentel : files/* system/config/dcaconfig.php system/config/initconfig.php system/config/langconfig.php system/config/localconfig.php system/config/pathconfig.php templates/* Cela permettra de sauvegarder votre configuration locale, vos modèles personnalisés et vos fichiers. Remplacement de fichiers Le remplacement des fichiers d'une installation de Contao est assez simple. Il suffit de décompresser l'archive de Contao sur le serveur ou de l'extraire sur votre ordinateur et de téléverser les fichiers avec un client FTP.