The source code of this program is available in several places on the Internet, but as this
documents is not aimed at listing the sites where you can get them, you can find it officially
on the following web sites.
Either at hitweb.org :
http://www.hitweb.org/download/
Or at savannah.gnu.org :
http://savannah.gnu.org/projects/hitweb/
Or at freshmeat.net :
http://freshmeat.net/projects/hitweb/
I strongly recommend to download the latest version of the application on one of those three sites,
as it is impossible to update all the reference in new versions.
At any time, you will be able to find the beta version on the CVS at Savannah :
cvs -d:pserver:anoncvs@subversions.gnu.org:/cvsroot/hitweb login cvs -z3 -d:pserver:anoncvs@subversions.gnu.org:/cvsroot/hitweb co hitweb
There are several ways to install HITWEB, everything depends on your OS.
To start with, we are going to go through the easiest one.
First, uncompress the archive that you downloaded in a directory (zip, tgz, etc.) of your web site.
In this directory, you will find a SQL directory with a file hitweb.sql. This file is a "dump" of the tables.
You need a
Mysql database motor engine on your web site.
To create the tables in your database, you can use this command line or an application like
phpMyAdmin
(the one used by
FREE, for example).
mysql --host={DBHOST} --user={DBUSER} --password={DBPASS} --database={DBNAME} < hitweb.sql
If an error occur as you create the table (because a table was already named like one of the table of hitweb,
then you shall edit and modify the file sql/hitweb.sql and give a new name to the given table.
Once the tables have been created, you shall open file conf/hitweb.conf so that the following
variables match with yours own settings :
--host={DBHOST} // MySql hostname
--user={DBUSER} // Your login
--password={DBPASS} // Your password
--database={DBNAME} // Your database name
Here is an exemple for the french provider/host http://www.free.fr :
--host=sql.free.fr // MySql hostname --user=toto // Your login --password=totolamalice // Your password --database=toto // Your database name (same as login) So : mysql --host=sql.free.fr --user=toto --password=totolamalice --database=toto < hitweb.sql My advice is not to leave the password in clear and use the following command line at the prompt. mysql --host=sql.free.fr --user=toto -p --database=toto < hitweb.sql You will be asked your password, but it will not be displayed in clear.
The install part is now over, let's move to the configuration part.
The configuration is very simple, since you only need to modify the hitweb.conf file in the CONF directory.
Here is an example :
$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'; // Database type $REP_CLASS = 'class'; // CLASS Directory $EXT_PHP = '.php'; // PHP files extension (for free you shall put php3) $EXT_TPL = '.html'; // TEMPLATES files extension $MAIL = 'webmaster@hitweb.org'; // Your e-mail address $SITE = 'hitweb.free.fr/hitweb'; // Path to the application (exemple for http://hitweb.free.fr/hitweb/) $REP_LANG_ADMIN = 'lang'; // Directory of the internationalisation files $LANG_ADMIN = 'french'; // Language used
You can either modify these variables directly in the file hitweb.conf or using the
administration part of the application using HTTP.
For example, here is the way you can access it if your site is hosted by www.free.fr.
http://hitweb.free.fr/hitweb/ The administration directory of HITWEB is located here : http://hitweb.free.fr/hitweb/admin/
You shall select in the left-hand menu "Database configuration" and fill in the connection
information to your database.
Then you can modify the informations concerning HITWEB by clicking in the
left hand menu "Configuration file".
The configuration of the application is now over and your directory is now operational. If the directory (bookmark) does not properly work, then you must have a specific configuration. You shall then read the following.
You will probably have specific problems during installation, but I am trying to group here the most frequently asked questions. If your problem is not referenced here. You can send it to me and I will try to work it out.
To modify the file extension from .php to .php3, you shall first modify the variable $EXT_PHP in
the conf/hitweb.conf file. Then, you will have to rename all the files from .php to .php3.
You shall use the command line to this.
For LINUX users :
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
For windows users, I do not know how to do it automatically. If someone knows, I will take it.
Beware !!! this function is not on by default in the application. Actually, it only is in
use in the user part, and not in the admin part.
If you want to use the application with FREE as host provider, or with another host provider
who deactivated the default PHP mail() function , you need to modify the
sources of HITWEB.
By getting rid of the functoin mail_newsite() in file ajoutsite.php on line 105.
Or by modifying the mail() function in the mail.php file.