====== Installation ====== Cette page présente la procédure d'installation standard. Quelques tutoriels pas à pas propres à chaque hébergeur sont disponibles [[..:hosting/|sur cette page]]. **Wanted !** Si vous avez installé Dotclear chez un hébergeur pour lequel aucun tutoriel pas à pas n'est disponible, n'hésitez pas à contribuer au projet en envoyant votre tutoriel sur le modèle des autres à documentation (at) dotclear.net. ===== Prérequis ===== Avant d'installer Dotclear 2, vous devez vous assurer de disposer des éléments techniques suivants : * PHP 5.0 ou supérieur avec le support des extensions suivantes : * mbstring * iconv * le support des fonctions ob_ * le support utf8 sur les fonctions preg_ * simplexml et domxml * SPL * Une base de données supportée (au choix) : * PostgreSQL 8.0 minimum * MySQL 4.1 minimum avec InnoDB * SQLite La présence de l'extension php GD2 est un plus mais n'est pas indispensable pour le bon fonctionnement de l'application. S'il n'est pas présent, vous ne disposerez pas des aperçus des images dans le gestionnaire de média. Un script disponible dans la section [[..:hosting#tester-votre-hebergeur|Hébergeurs]] vous permet de vérifier que ce dernier permet d'installer Dotclear ===== Fichiers ===== Il faut télécharger l'archive de dotclear2, la décompresser, et envoyer les fichiers sur votre espace web à l'aide d'un logiciel de ftp. ===== Installation avec l'assistant ===== Il suffit de vous rendre sur **%%http://url-mon-dotclear/admin/install/%%**. Un message vous avertit que vous n'avez pas de fichier de configuration et vous propose de vous rendre sur l'assistant wizard. Cliquez sur le lien. Un formulaire apparaît et vous demande certains renseignement de configuration : * **Type de base de données** * **Nom d'hôte de la base de données** : nom de l'hôte de la base((Vous pouvez éventuellement le laisser vide si la base est sur localhost)) * **Nom de la base de données** * **Nom d'utilisateur de la base de données** * **Mot de passe de la base de données** * **Préfixe des tables de la base de données** Validez le formulaire, le programme va vérifier que les conditions d'installation de Dotclear sont remplies et, le cas échéant, vous amener directement à la [[#fin_de_l_installation|fin de l'installation]]. Si pour une raison quelconque l'installation échoue, il faut faire une [[#installation-a-partir-du-fichier-config.php|installation à partir du fichier config.php]]. ===== Installation à partir du fichier config.php ===== Renommez le fichier **inc/config.php.in** en **inc/config.php** et renseignez les valeurs des constantes en suivant les indications suivantes : * **DC_DBDRIVER** : type de base de données ('mysql', 'pgsql' ou 'sqlite') * **DC_DBHOST** : nom de l'hôte de la base((Vous pouvez éventuellement le laisser vide si la base est sur localhost)) * **DC_DBUSER** : nom de l'utilisateur de la base * **DC_DBPASSWORD** : mot de passe pour la base de données * **DC_DBNAME** : nom de la base de données * **DC_DBPREFIX** : préfixe de nommage des tables dotclear Dans le cas de SQLite, ne renseignez que la valeur de DC_DBNAME avec le chemin vers le fichier de la base SQLite. * **DC_MASTER_KEY** : insérez une chaîne de caractères assez longue de votre composition **sans apostrophe**. N'en changez plus jamais. * **DC_ADMIN_URL** : URL complète vers l'interface d'administration. Ce n'est pas obligatoire mais il est préférable de l'indiquer. * **DC_SESSION_NAME** : nom du cookie de session pour l'interface d'administration * **DC_PLUGINS_ROOT** : chemin(s) vers l'emplacement des plugins * **DC_TPL_CACHE** : emplacement du répertoire de cache (doit absolument être accessible en écriture) Vous pouvez également définir les constantes **HTTP_PROXY_HOST** et **HTTP_PROXY_PORT** vous permettant de spécifier respectivement l'hôte et le port d'un éventuel proxy qui sera utilisé pour toute opération HTTP (pings, trackbacks, lecture de fils RSS...) **fonction _mail()**: il est possible de surcharger la fonction utilisée pour envoyer des mails, par défaut celle-ci utilise le mécanisme standard de php (la fonction mail()). Si vous rencontrez des problèmes avec l'envoi de mails, par exemple si les mails envoyés sont trop fréquemment arrêtés par des filtres antispams, nous vous conseillons de configurer l'envoi de mail. Pour plus d'informations, reportez-vous à : [[.:install:custom-sendmail|Personnaliser l'envoi des mails]] ===== Fin de l'installation ===== Une fois le fichier **inc/config.php** créé, il ne vous reste plus qu'à vous rendre sur **%%http://url-mon-dotclear/admin/install/%%** et répondre aux quelques questions posées. Vous obtiendrez alors votre mot de passe (une copie est envoyé par email.) Il ne vous reste plus qu'à bloguer :) Un message peut vous indiquer que le répertoire de cache n'est pas accessible en écriture. Dans ce cas, changer la valeur de DC_TPL_CACHE dans votre fichier de configuration ou donnez les permissions nécessaire au répertoire en question. L'installation propre à certains hébergeurs est détaillée dans la section [[..:hosting|Hébergeurs]] de ce guide. ===== Etapes suivantes ===== ==== Facilitez-vous la mise à jour ==== Il est conseillé de ne pas laisser les fichiers « personnel » (le répertoire **public**) dans le dossier de Dotclear. En cas de [[upgrade|mise à jour]], cela permet de ne pas avoir à recopier l’ensemble du contenu (qui peut être conséquent) de l’ancien au nouveau dossier. Il suffit pour cela de créer ledit dossier « à côté » du dossier Dotclear sur le FTP. Ensuite, dans l’administration de Dotclear, rendez-vous dans ''about:config'', et, réglez les entrées ''public_path'' (chemin depuis le dossier Dotclear) et ''public_url'' (chemin depuis la racine du domaine) vers ce nouveau dossier. Vous pouvez procéder de même pour le dossier **themes**. ==== Multiblog ==== Si vous abritez plusieurs blogs sur cette installation, consultez la documentation [[multiblog|multiblogs]]. ==== Paramètres du blog ==== Après avoir achevé la procédure d'installation, pensez à aller [[..:usage:blog-parameters|configurer les paramètres de votre blog]].