* WebCollab 3.40 - Glenorchy *
----------------------------- 

  "Reading computer manuals without the hardware is as frustrating as reading manuals without the software.

     --- Arthur C. Clarke


* What's New *
--------------

Welcome to WebCollab 3.40:

This version of WebCollab includes minor bugfixes and performance enhancements.

Password security has been improved with new passwords being encrypted with the Blowfish algorithm. Existing 
passwords will not be changed until the password is manually changed.  Note that this is only applicable to 
versions of PHP 5.3.7 (or higher); since earlier versions of PHP have a buggy implementation of the Blowfish 
algorithm.

Uploaded files are now stored with random hash id's instead of the file name.  This increases security and 
solves potential problems with non-ascii filenames in filesystems.  Again, this only applies to new uploaded 
files, and the code is still backwardly compatible with existing uploaded files.

The Italian language translation has been updated.

Note that a database upgrade is necessary for earlier versions to implement the new hashed uploaded file 
names.


* Thanks * 
----------

Thanks to the following for contributions and bug feedback for this release:

  Favern

  
* Translations *
----------------

Thank you to the following for Italian translation updates:

  Giuseppe Dantini
  Igor Falcomata


* Setup Program *
-----------------

WebCollab has a web-based setup program.

- After unpacking the files, point your web browser at:

    http://your_site/webcollab-3.40/setup.php

  (Replace 'your_site' with your site address).

  ** You will need to make your /config/config.php file world writable **

- Follow the on screen instructions.

For more detailed instructions look in the /docs directory after unpacking.

---

WebCollab 3.xx requires PHP 5.3.0 (or higher).

- The optional PHP mb_string library is required to be installed. 

- The PHP PDO database extension is required.

Both these PHP requirements should be automatically met with most recent PHP 5 installations.

The minimum database version for MySQL  is 4.1.3.  Earlier versions of MySQL will not work, and will 
give an error message about not being able set the timezone and/or character set.


* Database Compatibility for Upgrading *
----------------------------------------

Before attempting to run with any existing database records from a version earlier than WebCollab
 3.40 you need to upgrade your database.  This can be done automatically by the WebCollab software
for any earlier version of WebCollab.

Point your browser at:

  http://your_site/webcollab-3.40/update.php

(You need to replace 'your_site' with your site address).

Enter a valid admin user name and password when prompted... Database upgrade is automatic.


* Running Setup after an Upgrade *
----------------------------------

After an upgrade setup must be run to incorporate the new configuration changes.

1. Open the file [webcollab]/config/config.php with your favourite text editor.  Find this line:

   $WEB_CONFIG = "N";

   It is near the top of the file.  Change "N" to "Y".

2. Make sure the file world writable - or, at least writable by the webserver.

3. Point your web browser at:

    http://your_site/webcollab-3.40/setup.php

4. Make sure to choose 'no' when prompted to create a new database....

5. Follow the on screen instructions.


*Config File Changes in this Version*
-------------------------------------

A parameter WORK_FACTOR has been added.  This determines work factor when passwords are set using the Blowfish
encyption algorithm.  The default value is '8'.

Options for formatting dates have been added.  These options are controlled by $FORMAT_DATE and 
$FORMAT_DATETIME.  The former controls date only, and latter controls date & time. 


*CSS File Changes in this Version*
----------------------------------

Added 'tr.searchlist td' for search results

Removed 'ul.search-ul' and 'li.search-li' (Superseded by above).


*Database Changes in this Version*
----------------------------------

Added column 'hashid' to table 'files'.


* CHANGELOG *
-------------

*Improvements

- improve formatting to Forum Search.  Add to CSS code.

- improve and simplify conformance to RFC 2045 of quoted printable encoding in emails

- minor improvements to email headers

- add Blowfish password encryption for PHP > 5.3.7

- add configurable dates

*Changes

- time.php: change from preg function to mb_substr for better execution speed. Cache escaped date results.

- simplify encoded headers in email using iconv_mime_encode()

- change to storing uploaded files with hashed id

- change md5() hashes to sha1() hashes

- improve salt generation for passwords

*Translations

- Updated Italian translation (Credit: Giuseppe Dantini )

- Italian translation partially updated (Credit: Igor Falcomata )


*Bugfixes

- Bug #97  - Fix for foreign cookies overwriting POST & GET by removing $_REQUEST superglobals. (Reported by: Favern)


*Javascript Editor*
-------------------

The javascript editor is a modified version of code found at this URL:

http://corpocrat.com/2008/08/15/free-wysiwyg-bbcode-editor-in-javascript/

This code was obtained as 'free to use' public domain with no licence attached.


*Silk Icons*
------------

WebCollab uses the Silk icons from the following site:

http://www.famfamfam.com/lab/icons/silk/

Thanks to Mark James for his permission for the icons to be used under the GPL v2.
