Manuel pour Contao 3.2 Table des matières 1. Introduction 2. Installation i. Installer Contao ii. Utilisation du Safe Mode Hack iii. Mise à jour manuelle iv. Live Update Service v. Déplacer une installation vi. Configuration du serveur en ligne 3. Panneau d'administration i. Liste d'enregistrements ii. Édition des enregistrements iii. Raccourcis clavier 4. Gestion des pages i. Composants ii. Thèmes iii. Feuilles de style iv. Modules v. Présentations de page vi. Types de page 5. Gestion du contenu i. Articles ii. Actualités iii. Événements iv. Flux RSS/Atom v. Bulletins d'information vi. Formulaires vii. Commentaires viii. Modèles ix. Balises d'insertion 6. Administration du système i. Utilisateurs et groupes d'utilisateurs ii. Extensions iii. Maintenance 7. Tableaux conteneurs de données i. Référence ii. Palettes iii. Callbacks 8. Personnaliser Contao i. Contourner le cache interne ii. Configurations personnalisées iii. Ajouter des champs personnalisés iv. Personnaliser l'éditeur de texte riche (TinyMCE) v. Surcharger les méthodes de classes vi. Contao hooks 9. Référentiel d'extensions i. Ajout d'une extension ii. Ajouter une release iii. Ajouter des fichiers iv. Ajout de fichiers à partir d'un référentiel GitHub 1 Manuel pour Contao 3.2 v. Ajouter des traductions vi. Ajouter des dépendances vii. Publier une extension 10. Développement de Contao i. Création d'un nouveau ticket 2 Manuel pour Contao 3.2 Manuel pour Contao 3.2 Ceci est le manuel officiel pour les utilisateurs et les développeurs. Vous pouvez toujours trouver la dernière version sur docs.contao.org. Table des matières Introduction Installation Installer Contao Utilisation du Safe Mode Hack Mise à jour manuelle Live Update Service Déplacer une installation Configuration du serveur en ligne Panneau d'administration Liste d'enregistrements Édition des enregistrements Raccourcis clavier Gestion des pages Composants Thèmes Feuilles de style Modules Présentations de page Types de page Gestion du contenu Articles Actualités Événements Flux RSS/Atom Bulletins d'information Formulaires Commentaires Modèles Balises d'insertion Administration du système Utilisateurs et groupes d'utilisateurs Extensions Maintenance Tableaux conteneurs de données Référence Palettes Callbacks Personnaliser Contao Contourner le cache interne Configurations personnalisées Ajouter des champs personnalisés Personnaliser l'éditeur de texte riche (TinyMCE) Surcharger les méthodes de classes Introduction 3 Manuel pour Contao 3.2 Contao hooks Référentiel d'extensions Ajout d'une extension Ajouter une release Ajouter des fichiers Ajout de fichiers à partir d'un référentiel GitHub Ajouter des traductions Ajouter des dépendances Publier une extension Développement de Contao Création d'un nouveau ticket 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. Introduction 4 Manuel pour Contao 3.2 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. Installation 5 Manuel pour Contao 3.2 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). Selon la configuration de votre serveur, le dossier public est probablement nommé htdocs , httpdocs , html ou public_html . Si vous avez un accès SSH, vous pouvez télécharger et extraire l'archive avec les commandes suivantes: curl -L http://download.contao.org | 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. 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 Installer Contao 6 Manuel pour Contao 3.2 Pour importer un modèle, sélectionnez l'entrée dans le menu déroulant et cliquez sur le bouton "Importer un modèle". 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 . Installer Contao 7 Manuel pour Contao 3.2 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