Installation de DotClear 1.2.1
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 anonymous on Tue Sep 13 22:06:35 2005
Ah là là :) Si tous les softs pouvaient faire des tutoriaux comme ça ! Merci en tout cas. Là je suis en train de m'y mettre :) Arnaud un futur DotClearer?
Comment by anonymous on Sat Sep 24 21:08:32 2005
Salut à vous et Merci pour le merveilleux logiciel, J'ai essayé toutes les methodes connues pour configurer
'''les paramètres de ma base de données'''
sans succès. Après plusieurs jours, je me décide enfin à écrire. Si quelqu'un peut me donner un coup de main, c'est avec beaucoup de joies que je l'accepterait.
Voici mon mail au cas ou..........championsdrivers@yahoo.fr
Merci bien à vous.
Comment by anonymous on Sun Sep 25 11:00:27 2005
Tutoriel très progressif, très clair.
Bravo !
Comment by anonymous on Mon Oct 3 13:21:29 2005
install sans probleme avec un hébergeur free:
à noter pour lancer l'installation, cest pas /dotclear/dc_loader.php qu'il faut exécuter mais
http://monsite/dotclear/install
voilà ;)
Comment by kozlika on Mon Oct 3 13:58:45 2005
Réponse au message du 3/10. Lis mieux le tuto, tu confonds l'install automatique et l'install via upload du répertoire complet.
Comment by anonymous on Sun Oct 9 03:40:57 2005
Juste pour vous informer :
A l'execution, php me dit que la fonction utilisée dans le fichier /monsite/dotclear/inc/classes/class.mysql.php : mysql_escape_string($str) est DEPRECATED et qu elle est donc a remplacer par celle ci : mysql_real_escape_string($str);
Ce que j ai fait. Ca evite d avoir des warnings
Autrement, l installation se fait tres simplement Pour l instant je n ai pas la mise en page attendue. Ce n est qu une question de minutes.... ;-)
Comment by pep on Sun Oct 9 16:04:53 2005
A ce niveau, il ne s'agit pas d'un warning mais d'un notice.
De plus, la fonction mysql_real_escape_string() n'a été introduite que depuis PHP 4.3.0 et je rappelle que DotClear 1.2.x doit pouvoir se contenter d'un PHP 4.1 (Cf. [http://www.dotclear.net/features.html] )
Comment by anonymous on Mon Oct 10 00:49:30 2005
hello Chez Free, ils m'avouent être débordés et être très en retard pour les créations des bases MySQL (promise dans les 24h) Donc ne vous enervez pas trop avec l'install de DotClear sous Free actuellement !!! ... comme moi ... patience Bye
Comment by anonymous on Mon Oct 10 09:55:43 2005
Et chez club internet, ça peut marcher ce truc ? Je le vois pas dans la liste. Merci.
Yoj
Comment by anonymous on Tue Oct 11 09:41:14 2005
Pour free. Il faut d'abord creer une base de donnees dotclear, docn se connecter a sa base mysql (voir la page support de free: se connecter a la base ) mysql. Creer une base dotclear et sortir. Ensuite avec son client FTP se connecter sur son site et creer un folder sessions (avec un s a la fin) et dedans deposer son fichier dotclear. Le chemin est donc : monsite.free.fr/sessions/dotclear. Suivre le tutorial ci dessus. Tout fonctionne
Comment by anonymous on Tue Oct 11 09:46:34 2005
Toujours pour free. Si vous avez merde l'installation ne pas oublier de tout virer via votre client ftp (dossier st sous dossiers dotclear dans votre dossier sessions - ce sernier etant a conserver ) mais aussi votre base mysql dotclear (accesible via votre navigateur - Firefox bien sur ;O) voir mon post d'avant) Et il n'y a plus qu'a recommencer -
Comment by bruno on Tue Oct 11 10:30:01 2005
Nope ... chez free, il n'est pas du tout nécessaire de créer un dossier sessions pour utiliser dotclear, et ce depuis la version 1.2.1 De surcroît, c'est une très mauvaise idée d'uploader dotclear dans le dossier sessions. Ce dernier a été prévu dans un but tout autre (gestion des sessions php, point barre), et en général il vaut mieux ne rien y mettre, à l'exception d'un .htaccess contenant "deny from all", ou à défaut un fichier index.html vide