Installation

Cette page présente la procédure d'installation standard. Quelques tutoriels pas à pas propres à chaque hébergeur sont disponibles 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

Note :

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.

Astuce :

Un script disponible dans la section 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¹⁾
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.

Si pour une raison quelconque l'installation échoue, il faut faire une 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²⁾
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)

Astuce :

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…)

Astuce :

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 à : 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 :)

Important :

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.

Note :

L'installation propre à certains hébergeurs est détaillée dans la section 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 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 multiblogs.

Paramètres du blog

Après avoir achevé la procédure d'installation, pensez à aller configurer les paramètres de votre blog.

¹⁾ , ²⁾ Vous pouvez éventuellement le laisser vide si la base est sur localhost

Plan des sites