foing v 0.7.0 INSTALLATION
This should be very simple. To install foing you should have a number of things:
1 Access to a server with php and mysql
(foing was tested on php 4.0.6 and 4.2.0, and mysql 3.29.49)
2 The foing package
3 The phpbb 2.0.x package. (get it at
http://www.phpbb.com/)
At the time of writing 2.0.4 was the latest version of phpBB,
and seems to work fine with foing 0.7.0
4 The getId3() package. (get it at
http://getid3.sourceforge.net/)
Note that version 1.5.6 and above getId3() doesn't support remote
files (http or ftp) any more. It is most likely that you will be adding
remote mp3 files, so get version 1.5.5.
You can also choose not to use this package, but bare in
mind that then you will miss rather essential features of foing
(such as checking whether the mp3 file exists, time, bitrate, size,
and automatic artist, title, website and album extraction from the
id3(v2) header).
The installation procedure looks like this:
1 Install phpbb 2.0.x as usual.
2 Unpack / unzip foing in a directory on the server.
2a Copy the /template/foing/ directory in the foing package to
/phpbb/yourTemplateDir/foing/ , where yourTemplateDir is the
directory of the template you're using (e.g. 'subSilver' in
the standard case).
If you like, you can overwrite the overall_header.tpl of your
template with the one in the /template/ directory in the foing
package.
If you have installed foing in a non-standard directory, you may
pay anntention to the overall_header.tpl and change the url of
the foing link and images.
2b Unpack / unzip getId3() in the /foing/remote_getid3/getid3 directory
(overwriting the dummy getid3.php file).
OR
If your server doesn't allow php to upload files, you will get
an error if you use getId3() to read the id3(v2) tags of an mp3
that is to be added to foing.
In that case you can put the /foing/remote_getid3 directory and
contents on a server which allow php to upload files, and place
getId3() in the foing/remote_getid3/getid3 folder. Enter the
url of the remote_getid3.php in the corresponding field in the
configuration screen.
OR
Don't use getId3() at all. And be lame.
3 Visit your recently unzipped / unpacked foing copy through the www
(could be
http://www.yourdomain.com/foing/ )
4 You should be prompted with the install-screen. Enter the
phpbb directory relative to foing
( if phpbb is in yourdomain.com/phpbb/ and foing in
yourdomain.com/foing/ , it should be ../phpbb/ )
and the foing directory relative to phpbb
( if phpbb is in yourdomain.com/phpbb/ and foing in
yourdomain.com/foing/ , it should be ../foing/ )
and choose a table prefix.
5 If you have the config.php chmodded to 777 it should be overwritten
automatically. If not, upload the file yourself and replace the old one.
6 Remove the /foing/install/ directory.
7 Voila! your copy of foing is ready!
(the first thing you should do is going to the administration
panel and change foing's configuration to your preferred settings)
(if you're wondering why this procedure looks so familiar to you, it's because
i copied some of it from phpbb 2.0.x)
If you have any questions, feel free to ask me them at
colorblind@users.sourceforge.net
Have fun,
colorblind
