Installation de DotClear 1.2.2
Pré-requis
Note : Toute référence à www.mon_site/dotclear indique l'emplacement où DotClear est installé sur votre site.
DotClear fonctionne sur les hébergements supportant PHP 4.1 minimum et MySQL 3.23 minimum (liste d'hébergements testés dans la FAQ.)
- Le module XML de PHP doit être présent.
- Le support de sessions doit être activé.
- Le navigateur servant à l'installation doit être configuré pour accepter les cookies de session.
Au démarrage de la procédure d'installation, DotClear vérifiera que ces conditions sont bien remplies.
Installation automatique
DotClear propose un système d'installation simplifié via un installeur qui se chargera de récuperer tous les fichiers nécessaires à l'installation.
- Connectez vous en FTP sur votre serveur (voir plus bas pour savoir comment faire).
- Créez un répertoire vide (par exemple dotclear ou blog).
- Téléchargez le fichier http://www.dotclear.net/download/loader/dc_loader.php puis déposez-le dans le répertoire précédemment créé.
- Rendez-vous sur ce fichier avec votre navigateur (par exemple www.mon_site/dotclear/dc_loader.php).
- Laissez location à sa valeur par défaut (/) et cliquez sur continue.
Si tout se passe bien, vous devrez patienter quelques instants et serez dirigé vers l'écran d'installation de DotClear.
Si cette procédure échoue, suivez les instructions de transfert des fichiers sur votre serveur.
Transfert des fichiers sur votre serveur
Note : Sautez cette étape si vous avez utilisé l'installation automatique.
Téléchargement et décompression de l'application
Téléchargez DotClear (choisissez le format de compression zip ou tar.gz en fonction de l'application de compression dont vous disposez - zip par défaut pour les utilisateurs de Windows XP, tar.gz pour les utilisateurs Mac OSX). Vous devez décompresser localement l'archive (par exemple dans un répertoire nommé dotclear) avant de transférer son contenu sur votre serveur.
Transfert de DotClear sur le serveur
DotClear peut être installé dans n'importe quel répertoire. Choisissez la racine du site si vous souhaitez que votre weblogue soit directement accessible à l'adresse www.mon_site/.
Si vous êtes grand débutant, nous vous conseillons d'installer DotClear dans un répertoire nommé dotclear : vous aurez ainsi un minimum de manipulations à faire pour configurer votre weblogue. Il sera alors accessible à l'adresse www.mon_site/dotclear.
Pour transférer le contenu décompressé de l'archive, vous pouvez utiliser n'importe quel client FTP, par exemple FileZilla pour Windows ou RBrowser Lite pour Mac. Reportez-vous à la documentation fournie par votre hébergement pour connaître :
- Le nom du serveur FTP (aussi appelé nom d'hôte) ;
- Votre nom d'utilisateur (aussi appelé identifiant ou login) ;
- Votre mot de passe.
Lancement de l'assistant d'installation
Une fois les fichiers de DotClear installés sur le serveur, allez à l'adresse www.mon_site/dotclear/install/ ou www.mon_site/install/ selon le répertoire où vous avez déposé l'application.
Langue et encodage
L'assistant d'installation se lance et vous demande de choisir une langue et un encodage pour vos caractères.
Note : L'encodage ISO-8859-1 est celui par défaut pour les alphabets occidentaux (Europe de l'ouest, Amérique). UTF-8 est bien plus universel et peut être un choix plus judicieux si vous comptez publier dans des langues comme l'arabe, le russe, le japonais, le chinois...
Vérifications
Un ensemble de vérifications est effectué afin de déterminer si DotClear peut être installé sur votre serveur. Si un des points de la configuration PHP ne passe pas, contactez votre administrateur ou votre prestataire d'hébergement.
Si le répertoire conf n'est pas accessible en écriture, vous devrez donner les droits adéquats avec votre client FTP. Voir plus bas (changer les droits des fichiers et répertoires) pour la démarche à suivre.
Paramètres de la base de données
Vous devrez indiquer, et donc posséder, les informations suivantes :
- le nom de la machine hébergeant la base MySQL (consultez votre hébergeur).
- votre nom d'utilisateur pour se connecter à MySQL (généralement votre login).
- votre mot de passe pour se connecter à MySQL.
- le nom de la base de données qui sera exploitée par DotClear.
- laissez le préfixe à sa valeur par défaut si vous ne savez pas de quoi il s'agit.
Conservez ces informations quelque part, vous en aurez besoin lors des mises à jour de DotClear.
Attention : la base de données MySQL doit exister. Si vous en avez la possibilité sur votre hébergement (ou si vous travaillez en local), créez une base spécifique pour DotClear. Reportez-vous à la documentation de votre hébergement pour savoir comment faire.
Cliquez sur Créer les tables, un écran récapitule alors le bon déroulement de l'opération.
Création du premier utilisateur
Le premier utilisateur que vous allez créer sera administrateur. Vous devez fournir obligatoirement un nom, un identifiant (qui servira à vous connecter) et un mot de passe. Ne les oubliez pas !
Configuration de votre weblogue
Laissez l'emplacement de DotClear à sa valeur par défaut à moins de bien savoir ce que vous faites. Donnez ensuite un nom à vote weblogue.
Vous devrez enfin choisir entre deux formats d'URL. Le format Query string donne des URLs de la forme www.mon_site/dotclear/index.php?2002/04, alors que le format Path Info donne des URLs de la forme www.mon_site/index.php/2002/04.
Attention : Le format d'URL Path Info ne fonctionne pas avec tous les hébergements, notamment avec Free.fr.
Vous pourrez changer le format d'URL de votre weblogue avec l'outil de configuration de DotClear si jamais vous vous êtes trompé.
Fin de l'installation
Après avoir configuré votre weblogue, l'installation se termine par la création d'un premier billet.
Il ne vous reste plus qu'à cliquer sur Administrer votre weblogue pour passer aux choses sérieuses.
Vous serez alors automatiquement connecté à l'interface d'administration de votre weblogue. Retenez son adresse (www.mon_site/dotclear/ecrire/ par exemple) qui sera celle où vous vous connecterez par la suite pour administrer ou publier sur votre weblogue.
En allant à l'adresse de votre blogue (www.mon_site/dotclear/ ou www.mon_site/), vous constaterez qu'une première catégorie Général aura été créée, ainsi qu'un premier billet.
Votre weblogue est ouvert, félicitations ! Si vous avez des questions, des soucis d'installation, des astuces à partager, rendez-vous sur le forum pour entrer en contact avec les membres de la communauté.
ANNEXE : Changer des droits sur des fichiers ou répertoires
À l'aide de l'outil "À propos de DotClear" (interface d'administration, onglet Outils) vous pouvez savoir si certains fichiers ou dossiers sont accessibles en écriture par votre serveur Web. Si ce n'est pas le cas, vous pouvez en changer les droits en utilisant un client FTP.
Avec FileZilla par exemple, cliquez avec le bouton droit sur le répertoire ou fichier dont vous souhaitez changer les permissions et cochez ensuite toutes les options d'écriture.
Commentaires
Comment by kozlika on Wed Mar 1 00:56:52 2006
Pour toute question relative à des problèmes lors de l'installation, dirigez-vous vers le forum.
Comment by anonymous on Thu Dec 8 19:03:13 2005
Pour ceux qui, comme moi, désiraient utiliser un blog sur un réseau privatif à but non lucratif (atelier d'initiation à l'informatique dans un Centre d'Hébergement et de Réinsertion Sociale), j'ajouterai qu'une utilisation en local est très simple :
- installer EasyPHP
- télécharger l'achive d'installation de DotClear
- la décompresser dans le répertoire www de EasyPHP
- créer un répertoire portant le nom du blog (ou un autre) dans le répertoire \EasyPHP1-8\mysql\data (genre drive:\EasyPHP1-8\mysql\data\mon blog, ce qui a pour effet de créer la base pour DotClear.
- suivre le tuto en choisissant localhost comme adresse du serveur et continuer...
ça marche !!!
Merci pour ce superbe outil de communication
Comment by anonymous on Fri Jan 20 13:23:02 2006
Pour une installation sous OpenBSD veuillez à modifier votre php.ini (/var/www/conf/php.ini) afin de permettre l'accès à la base de donnée via le socket ou en http (dans le cas du socket n'oublier pas que votre serveur apache est chrooter ;-)).