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.
Avant d’installer Dotclear 2, vous devez vous assurer de disposer des éléments techniques suivants :
Note :
La base de données doit avoir été créée préalablement à l'installation de Dotclear.Assurez-vous en outre d'avoir le paramétrage php suivant :
Note :
La présence de l’extension php GD2 est un plus mais n’est pas indispensable pour le bon fonctionnement de l’application. Si elle n’est pas présente, vous ne disposerez pas des aperçus des images dans le gestionnaire de médias.Note :
La présence de l'extension GMP ou BC MATH est requise que le filtre antispam IPv6, mais n'empêche pas le bon fonctionnement des autres filtres.Astuce :
Un script disponible dans la section Hébergeurs vous permet de vérifier que ce dernier permet d’installer Dotclear.L’installation automatique de Dotclear 2 est la méthode la plus simple et la plus sûre. Elle va se charger de vérifier que PHP 5 est activé et, éventuellement, l’activer à votre place. Ensuite, seront téléchargés les fichiers nécessaires à l’installation de Dotclear. Cette étape réalisée, vous serez conduits vers l’installation classique.
Pour installer Dotclear 2 de cette manière :
Si tout se passe bien, vous n’aurez plus qu’à cliquer sur le bouton suivant pour accéder directement à l’assistant d’installation. Dans le cas contraire, il vous faudra utiliser la méthode « classique » décrite ci-dessous.
Note :
Sautez cette étape si vous avez utilisé l’installation automatique. → Etapes suivantesIl faut télécharger l’archive de Dotclear 2, la décompresser, et envoyer les fichiers sur votre espace web à l’aide d’un logiciel de FTP.
Important :
Si vous souhaitez profiter de la mise à jour automatique, paramétrez votre client FTP afin qu'il transfère les fichiers en mode binaire qui garantit que les fichiers ne seront pas modifiés lors du transfert.Vérifiez ensuite que les permissions sont bien réglées en lecture, écriture et exécution sur les dossiers et fichiers suivants :
Astuce :
Si vous êtes sur un système UNIX, comme Linux ou Mac, vous pouvez ajuster les droits à 775, soit lecture, écriture et exécution pour l'utilisateur et le groupe et lecture et exécution pour les autres.Cette solution fonctionnera mais ne sera peut être pas la meilleure en matière de sécurité. Si vous voulez améliorer les droits sur vos dossiers et fichiers, sachez que seuls votre utilisateur et le processus du serveur web doivent avoir les droits en lecture, écriture et exécution sur ces dossiers (pour plus d’infos voir cette documentation : Droits d’accès sous Linux : gérer les accès aux fichiers).
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 :
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 mise en place manuelle du fichier config.php.
Faites une copie du fichier inc/config.php.in que vous nommerez inc/config.php et renseignez les valeurs des constantes en suivant les indications suivantes :
Dans le cas de SQLite, ne renseignez que la valeur de DC_DBNAME avec le chemin vers le fichier de la base SQLite.
Consultez la page concernant le fichier de configuration pour plus de détails.
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. L’installation se termine et vous pouvez vous connecter.
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.Il est conseillé de ne pas laisser les fichiers « personnels » (le répertoire public) ou personnalisés (les thèmes et les plugins additionnels) 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.
Nous recommandons donc de procéder à une installation optimisée de vos fichiers personnels, que ce soit dans la perspective d'un blog unique ou d'un multiblog. Vous y lirez aussi comment avoir votre blog sur l'URL racine.
Après avoir achevé la procédure d’installation, pensez à aller configurer les paramètres de votre blog.
Si vous souhaitez abriter plusieurs blogs sur cette installation, consultez la documentation Installation optimisée.
Si avoir plusieurs blogs sur son installation ne pose pas de difficulté majeure, monter une plate-forme de blogs avec des inscriptions et des créations de blogs automatiques demande des vraies compétences pour héberger et sécuriser une telle installation. Aucun support n'est assuré pour ce type d'utilisation.