* WebCollab 3.31 - Baldy *
---------------------------- 

  "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.31:

This is a bug and security fix version with two changes.

Internet Security Auditors have found a HTTP Response Splitting Vulnerablity in the 'help' files
(CVE-2013-2652).This vulnerability would appear to have been present since the first released version
of WebCollab, and is not considered to be high impact.  Nevertheless, all users are recommended to 
upgrade. 

As an alternative to upgrading, add the file '[webcollab]/help/help_language.php' from this release
to any earlier release, overwriting the existing file of the same name.

A bug in setting passwords with PHP 5.5+ has been fixed.  An internal function shared a common name
with a new reserved function in PHP 5.5.


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

WebCollab has a web-based setup program.

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

    http://your_site/webcollab-3.30/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.2.0 (or higher) with the optional PHP mb_string library installed. 
Both these requirements should be met with most recent PHP installations.  The last version of
WebCollab to work without the mb_string library is version 2.71 (non UTF-8 version).

For all WebCollab 3.xx versions (and most 2.xx versions), 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.

The PHP PDO database extension is required.  This should be automatically installed in PHP5. 

---

After installing, be sure to enter the 'Admin Config' menu to set your return email addresses.  Then
select 'Edit user' from the main screen to set your correct email address.


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

Before attempting to run with any existing database records from a version earlier than WebCollab
 3.00 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.30/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.30/setup.php

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

5. Follow the on screen instructions.




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

The javascript editor in this release 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.
