Back to files

Release Notes for:

                            DOOW Version 0.2.2
                           ====================

0. TABLE OF CONTENTS:

1. Introduction
2. Installing and Running DOOW
3. Features In This Release
4. Known Bugs and Issues
5. Change-Log
   1. v0.1 -> v0.1.1
   2. v0.1.1 -> v0.2
   3. v0.2 -> v0.2.1
   4. v0.2.1 -> v0.2.2

---

1. INTRODUCTION

"DOOW" (pronounce: <homer>DOH!</homer>)is an abbreviation for "Database of Our Owlish Wisdom" - its an knowledge database. Its a pure webapplicaton written in PHP, so to use it you need a webserver, that supports PHP4. Also DOOW need a MySQL-Database.

Recommended Configuration:
- Apache 1.3 or higher (www.apache.org) - PHP 4.0 or higher (www.php.net)
- MySQL 11.11 or higher (www.mysql.org)

DOOW is released unter the General Public Licence (GPL) - see LICENCE.TXT.

For latest informations about DOOW take a look at the sourceforge page at

http://sourceforge.net/projects/doow

or at the offical homepage at

http://www.doow.f2s.com

Please feel free to contact the author of DOOW (thats me): Stefan Braeu
stefan-braeu@gmx.net
http://www.stefan-braeu.f2s.com

---

2. INSTALLING AND RUNNING DOOW

Simple (if webserver, php and mysql are running already).

1. extract the package doow_v0.1.zip in your choosen webdirectory (f.e. /var/www/html/doow/ in linux or c:\Apache\htdocs\ in windows)
2. create a mysql database for doow (mysql: 'create database doow'). You dont have to call it 'doow' - but its would simplify the configuration-work.
3. in /dbscript you should find the file doow.sql - run it and all needed tables will be summoned (linux: 'cat doow.sql | mysql doow', windows: 'type doow.sql | mysql doow'). The SQL-File initdata.sql will create the user 'admin' with default-password 'admin' (CHANGE IT!) - run this script AFTER you started doow.sql
4. edit the configuration-file /includes/init.php: admins the usernames of all administrators (those who may edit EVERYTHING) adminmail e-mail-adress of the administrator helplevel quality of help, the local admin could give

   (f.e. 'good', 'bad', 'lazy', ...) hostname your webserver (f.e. 'doow.mydomain.at') auth_mode may be "DATABASE" or "FTP". "DATABASE" means, that

   userid and password should be compared with userid and password in the AUTHOR-Table. If auth_mode has the value "FTP", DOOW tries to log on the specified FTP-Server using the entered userid and password. Afterwards (if this logon was successful) it checks, if the user exists in the DATABASE auth_ftpsrv must be given, if auth_mode = "FTP" - its the ftp-server auth_checkgrpfile if given, DOOW checks if the user may GET (ftp) this file

   In this way you can specify, that only a certain group of users (at the ftp-server) may use DOOW auth_tmpdir needed, if auth_checkgrpfile is used. Its a temporary Directory,

   where DOOW can load $auth_checkgrpfile to (no slash at the end!) mainurl complete URL to index.php of doow

   (f.e. 'doow.mydomain.at/index.php') logfile path and filename of the doow-errorlog dbhost your MySQL-Server (f.e. 'mysql.mydomain.at') dbname the name of the doow-database (normally 'doow') dbuser, dbpassword the user-information to connect to the database default_sortfield specifies the default for the field that defines

   the order in the thread-view (ORDER BY). this may be: userid, topic, cdate default_sortmode specifies the default sortmode. Two values are

   allowed here: 'ASC' for ascending sort and 'DESC' for descending sort author name of the table which contains the authors note name of the table which contains the notes permission name of the table which contains the permissions category name of the table which contains the categories note_cat name of the table which contains the info, which

   note belongs to which category stepsizes which options should the user have in 'show how many

   threads at once'). 0 means 'show all' defaultstep the default stepsize. Should be a number, contained

   in stepsizes. 0 means 'show all'

Thats it.

---

3. FEATURES IN THIS RELEASE

• author/category-dependend permission-system
• author may edit his profile
• threaded view
• several search-modes (search in topic, keywords, body, author, ...)
• web-administration-tool (now really working!)

---

4. KNOWN BUGS AND ISSUES

• The algorithm, which places the tree-graphics, isnt completely bugfree now. Sometimes it doesnt paint what it should - should be solved in the next milestone

---

5. CHANGE-LOG

1. v0.1 -> v0.1.1
   • Fixed serveral minor (design)bugs
   • Startscreen is now the new view 'Categories', which shows all categories, the total number of notes in them and the date of the last posted note
   • 'View in Context'-Link after user had posted a note
   • Note-View contains now the tree of the actual thread
2. v0.1.1 -> v0.2
   • administration tool for everything (authors, categories, notes, permissions)
   • added new configuration-variables in init.php:admins , auth_mode, auth_ftpsrv, auth_tmpdir, auth_checkgrpfile (see 2d)
   • added graphical buttons
   • some minor design changes
   • fixed a bug in the profiles-view (and a lot of other bugs too)
3. v0.2 -> v0.2.1
   • the admin-tool in version 0.2 didn't run, when the database (category, author) was empty. This bug is now fixed (i hope so)
   • in the directory ./dbscript you find a small sql-file 'initdata.sql' - it creates the user 'admin' with password 'admin' (CHANGE) - see also 2c in this document
4. v0.2.1 -> v0.2.2
   • fixed a great bug in author-admin (it didnt save the password)
   • fixed some other smaller bugs (permission-bug, security-bug, etc.)