Documentation du projet HITWEB.: INSTALLATION Next Previous Contents 2. INSTALLATION 2.1 T�l�chargement des sources Les sources de cette application sont disponibles ą plusieurs endroits sur le net, mais comme ce documents n'est pas fait pour r�f�rencer la liste des sites ou vous pouvez trouver l'application, je vous indiquerai seulement ceux qui sont officiels. Soit sur hitweb.org : http://www.hitweb.org/download/ Ou sur sourceforge.net : http://sourceforge.net/projects/hitweb/ Je vous conseil fortement de r�cup�rer la derniŁre version de l'application sur l'un de ces deux sites. Car il m'est impossible de mettre ą jour facilement toutes les r�f�rences ą chaque nouvelle version. Vous pouvez ą tout moment r�cup�rer les sources en d�veloppement sur le CVS de sourceforge : cvs -d:pserver:[e-mail]:/cvsroot/hitweb login cvs -z3 -d:pserver:[e-mail]:/cvsroot/hitweb co hitweb 2.2 Installation L'installation de HITWEB peut se faire de plusieurs fa�ons, tout d�pend de votre systŁme d'exploitation. Mais nous allons voir la plus facile dans un premier temps. Il suffit de d�compresser l'archive que vous avez t�l�charger (zip, tgz, etc.) dans un repertoire de votre site web. Vous trouverez ą la racine de l'application HITWEB, un r�pertoire SQL ou se trouve le fichier hitweb.sql. Ce fichier est un "dump" des tables de l'application. Vous devez obligatoirement avoir une base de donn�es Mysql. Pour cr�er les tables dans votre base de donn�es, vous pouvez utiliser cette ligne de commande ou une application comme phpMyAdmin (qui est utilis�e sur FREE, par exemple). mysql --host={DBHOST} --user={DBUSER} --password={DBPASS} --database={DBNAME} < hitweb.sql Si ą la cr�ation des tables vous avez une erreur, car il y a avait par exemple d�ją une table qui portait le męme nom que l'une de l'application hitweb, alors il faut modifier le fichier sql/hitweb.sql avec un �diteur de texte en modifiant le nom de la table. AprŁs avoir cr�er les tables, vous devez remplacer les variables suivantes, du fichier conf/hitweb.conf par vos informations personnels : --host={DBHOST} // Le nom du host de mysql --user={DBUSER} // Votre login --password={DBPASS} // Votre mot de passe --database={DBNAME} // Le nom de la base de donn�es Voici un exemple pour l'h�bergeur FREE : --host=sql.free.fr // Le nom du host de mysql --user=toto // Votre login --password=totolamalice // Votre mot de passe --database=toto // Nom de la base de donn�es (meme que le login) Donc : mysql --host=sql.free.fr --user=toto --password=totolamalice --database=toto < hitweb.sql Je vous conseil de ne pas mettre en clair votre mot de passe et d'utiliser plut�t la ligne de commande ci-dessous. mysql --host=sql.free.fr --user=toto -p --database=toto < hitweb.sql Votre mot de passe vous sera demand�, mais il ne sera pas affich�. L'installation est termin�e, il faut maintenant configurer l'application. 2.3 Configuration La configuration de l'application est trŁs simple, car il suffit de modifier le fichier hitweb.conf qui se trouve dans le r�pertoire CONF de l'application. Je vais vous d�tailler chaque variable : $DBNAME = 'toto'; // Nom de la base de donn�es (chez FREE meme que le login) $DBUSER = 'toto'; // Votre login $DBPASS = 'totolamalice'; // Votre mot de passe $DBHOST = 'sql.free.fr'; // Le host de la base de donn�es (exemple pour FREE) $BASE = 'mysql'; // Type de la base de donn�es $REP_CLASS = 'class'; // R�pertoire ou se trouve les CLASS de l'application $EXT_PHP = '.php'; // Extension des fichiers PHP (pour free il faut mettre php3) $EXT_TPL = '.html'; // Extension des fichiers TEMPLATES $MAIL = '[e-mail]'; // Votre adresse email $SITE = 'hitweb.free.fr/hitweb'; // Le chemin de l'application (exemple pour http://hitweb.free.fr/hitweb/) $REP_LANG_ADMIN = 'lang'; // R�pertoire des fichiers pour l'internationnalisation de l'application $LANG_ADMIN = 'french'; // Langue utilis�e Vous pouvez soit modifier ces variables directement dans le fichier hitweb.conf ou en utilisant la partie administration de l'application en HTTP. Pour avoir un exemple concret, je vous donnerai des explications par rapport ą une installation sur le compte hitweb chez FREE, comme vous avez pu le remarquer. http://hitweb.free.fr/hitweb/ Le repertoire d'administration de l'application se trouve donc ici : http://hitweb.free.fr/hitweb/admin/ Vous devez s�lectionner dans le menu de gauche "Configuration de la base de donn�es" et renseigner les informations de connection ą votre base de donn�es. Ensuite vous pouvez modifier les informations concernant l'application hitweb, en s�lectionnant dans le menu de gauche "Fichier de configuration". Voila, la configuration de l'application est termin�e et votre annuaire doit ętre fonctionnel. Si l'annuaire ne fonctionne pas correctement, c'est que vous devez avoir une configuration sp�cifique. Lisez la section suivante afin d'avoir plus d'information. 2.4 Configuration sp�cifique Vous aurez certainement des problŁmes sp�cifiques lors de votre installation, mais je vais quand męme essayer de regrouper dans ce paragraphe les questions qui me sont revenues le plus souvent. Si votre problŁme n'est pas r�f�renc� ici, vous pouvez me l'envoyer et j'essayerai de le r�soudre. Modification de l'extension des fichiers php (php -> php3). Pour modifier les extensions des fichiers .php en .php3, il faut tout d'abord modifier la variable $EXT_PHP dans le fichier hitweb.conf qui se trouve dans le repertoire conf/ de l'application. Ensuite il faut renommer tous les fichiers .php en .php3. Je vous conseil de faire cela en ligne de commande pour automatiser ce processus. Pour les utilisateur de LINUX : find . -name "*.php" | xargs perl -pi'.old' -e "s/\.php/.php3/" find . -name "*.conf" | xargs perl -pi'.old' -e "s/\.php/.php3/" for i in `find . -name "*.php" | sed -e "s/\(.*\)\.php/\1/" ` ; do mv $i.php $i.php3 ; done Pour les utilisateurs de windows, je ne sais pas comment faire pour automatiser ceci. Donc si une personne sait comment faire je suis preneur. Utilisation du mail lors de l'enregistrement d'un site dans l'annuaire. Attention cette fonctionnalit� est pas d�fault dans l'application. En fait elle est seulement dans la partie utilisateur du site et non lors de l'enregistrement d'un site dans la partie administration. Si vous utilisez l'application sur FREE, ou sur un autre h�bergeur qui n'accepte pas la fonction mail() de php par d�fault, il faut modifier les sources de l'application. En supprimant l'appel de la fonction mail_newsite() dans le fichier ajoutsite.php ą la ligne 105. Ou en modifiant la fonction mail(), dans le fichier mail.php. Next Previous Contents