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 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 DotclearIl 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.
Si vous ne voulez pas créer vous même le fichier config.php, vous pouvez vous laisser guider par l'assistant de configuration. 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.
Renommez le fichier inc/config.php.in en 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.
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 mailsUne 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.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.
Si vous abritez plusieurs blogs sur cette installation, consultez la documentation multiblogs.
Après avoir achevé la procédure d'installation, pensez à aller configurer les paramètres de votre blog.