First of all, you need an http server with PHP4 (PHP3 is unsupported), and postgresql. PHP should be compiled with gettext and postgresql support (casual Debian packages should work fine).
Rename the file slooze_local.php.sample into slooze_local.php, and edit it to satisfy your needs; you should set the following parameters: database name, login and password, photos path.
Also edit init.sql and choose a password for the "admin" user.
Create a database with createdb, and create the tables :
createdb dbname psql dbname < base.sql psql dbname < init.sql
To install the files, edit Make.conf and set "INSTALL_DIR" to the directory where you the scripts to be installed and then run "make install".
If you do not have gettext installed, it is likely that some steps will fail when doing "make install". Don't worry it will work anyway, however you will only have the english version.
It should now work. You can point your browser to <base_url>/photos.php. You'll see an empty album.
* IMPORTANT NOTE *
Your php.ini must contain "register_globals = On" so that you can login.
Loggin as "admin", use the "admin view", then users. Fill in the form.
You can refer to slooze's docs for this (since tof is based on it): http://www.slooze.com/doc/use/
Images are stored in files. The $basePath parameter in slooze_local.php defines the root directory where the files are to be found. Thumbnails filenames must end with $thumb_suffix and normal size filenames must end with $picture_suffix.
To add new pictures, you should create a directory per user in $basePath. This is to avoid possible name clashes between users. A user shouldn't have to care about other users rolls. And in the directory of the user, there must be a directory per roll. For instance, for user miguel and roll birthday, you would have:
$basePath `+miguel `+birthday `+picture1-t.jpg +picture1-w.jpg +picture2-t.jpg +picture2-t.jpg . . .
Once the files are there, you can user the web interface to "declare" the new roll. You must be logged in, go to the "admin view", and then "my rolls". Or directly point your browser to "/admin.php?MyRolls". Choose a rollID for the roll, check "add all pictures", (this add all unregistered pictures found in the rolls directory in the new roll), select a initial topic where to put the pictures, and initial groups that will be able to see the pictures. When you create a new user, a single user group is created for that user. The logged in user is always added so that the owner of a picture can always see it.
Or use the web based interface on the admin page. You should first create a Roll. And it's usually more convenient to create a topic too.
Tof can now support languages other than english. Only french is available for the moment. And it is very unlikely that I will translate it into other language, so if you want to translate in into an other language here's how to proceed :
In the po directory, run the following command :
xgettext --keyword=_ -C ../slooze_render_basic.php
It will create a file named "messages.po". Rename it to <lang>.po where <lang> is the 2 characters representing your language, and edit the msgstr in that file. Then send me the result so that I can include it in the next release.
You don't need to have any knowledge of PHP in order to do this. However you may notice some HTML code in the msgid texts (like <a href=\"mailto:%s\"> or </a>). You should just leave the text between "<" and ">" as is.
However, in order to see the new language on the web pages, a little hacking in the sources is necessary. You should add a the language in the function lang_init() in slooze.php and in the file po/Makefile.
The language selection is dynamic and is done according to the accept-language variable sent by the browser. So if you have "fr" in the language preferences of you browser, you will see the french version.
There's a mailing list hosted by savannah.gnu.org. See subscribing instructions.
You should be able to post without being subscribed. To do this, just send a mail to tof-general@mail.freesoftware.fsf.org. And don't forget to mention that you are not subscribed so that you receive the answer. You can talk english or french on this mailing list.
You can consult the archives ot the ML.