Database of our owlish Wisdom

File Release Notes and Changelog

Release Name: v0.2

Notes:
                            Release Notes for:
                            ==================
                             DOOW Version 0.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
     a) v0.1   -> v0.1.1
     b) v0.1.1 -> v0.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).

a) 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)

b) create a mysql database for doow (mysql: 'create database doow'). You dont 
   have to call it 'doow' - but its would simplify the configuration-work.

c) 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'). If you just want to test DOOW you may
   also run testdata.sql, which creates 1 admin-user, 1 normal-user and 3 
   categories (java, music, stupid).

d) 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

=============================================================================
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

 a) 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

 b) 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)

Changes: