File Release Notes and Changelog
Release Name: 0.7.0
Notes: Project Based Calendaring System (PBCS) Version 0.7.0 - August 2006 PBCS is an open source web-based calendaring system, designed to be an useful aid for people who manage schedules for one or more persons. The main feature of PBCS, which distinguishes it from all other calendar applications, is that schedule planners can plan schedules for other people easily using day or week overviews showing multiple people at once. There are the regular single-user overviews for those who look mainly at their own calendar. For people on the road it is now possible to sync your appointments into a Palm PDA (Serial devices tested) or a GMate Yopy. This 0.7.0 release is the first release with a scalable and flexible group and permission system, making it an enterprise ready piece of software. Other included elements in this release are the following items: - Improved CSS support in the templates - XML sync library with a client side sync tool (in contrib/) - Appointments now include Locations - The file and directory setup is restructured. INSTALLATION - FRESH INSTALL In the installation/ directory there is an pbcs_installer.html to do a fresh install using a web-browser. You can access this .html file using a browser and it will pop-up an installation wizard. The installer is not yet ready to do a seamless upgrade from an existing PBCS 0.6.2 installation. - UPGRADE There is a special PHP script in the installation/ directory to do an upgrade for you from a 0.6.2 install without the wizard. The file is called 'upgrade_pbcs.php'. You must modify the define UPGRADE_DB_URL database URL to the database which must be upgraded. The MySQL user in the UPGRADE_DB_URL should have ALTER and CREATE priviledges. If possible use the root user, instead of the pbcs user. Don't run this script yet! !!!! First make a backup of your database before upgrading !!!! Modify the 0.7.0 config/config.php to match you old settings. Be sure to match the $groups[] definition as it was in the 0.6.2 install. This information will be used in the 'Import Old Userbase' in the new User Admin section. Also modify the file functions/pbcs_db.php (the original db.php file was renamed and moved to this file) to contains valid MySQL user credentials (possibly the same as UPGRADE_DB_URL). Now run the upgrade_pbcs.php script command-line or from the browser. A command-line example will be: php ./upgrade_pbcs.php or php4 ./upgrade_pbcs.php Log in as Admin user of PBCS. Then follow point 3 in the upgrade list actions below. If you want to do a manual upgrade do the following: Modify the 0.7.0 config/config.php to match you old settings. Be sure to match the $groups[] definition as this is used in the 'Import Old Userbase' 1. In the installation/scheme-diffs you can find a file v0.6-v0.7-mysql-diffs.mysql which should apply changes in the MySQL tables on an existing PBCS database. 2. However due to the new user/group/permission system you cannot log in anymore. You should insert the SQL file 'adminuser-v0.7.0.sql' into the existing install and use that default admin account to log in. (password: admin) 3. Then browse to the Admin section and go to the 'User & Groups Management' section. 4. Use the 'Import Old Userbase' button to import all setting from the old $groups[] array and the user status information. I will then generate those groups with members in the new group system. Now your PBCS should be upgraded. In the doc/ directory you will find an INSTALL.txt file and all other documentation of PBCS. There is also a phpdoc entry which is used as a start to document the code better from now on. If you have problems installing and running PBCS, try the FAQ section or the forum on www.pbcs.org. If that provides no suitable answer mail me on roalt@kwenie.org. If required existing PBCS environments can be upgraded at a fixed fee. Good luck, Roalt Zijlstra
Changes: New Features in 0.7.0: - New User & Group management system using a new permission system. - New Permission system using Permission Templates - Made the overviews HTML 4.01 compliant as much as possible. - Started to convert the code to use CSS for the overviews. In next releases this will be continued to make use of CSS only for the templates. - Click on the overview and you will be redirected to the appointment form. Click on an appointment and you will be able to edit it. - More Object Oriented code usage. Which means code reuse and more structured usage of code. - Cleaned up the codebase and used an improved include_once strategy. Now all files are in sub-directories. The used method is like it is done in Squirrelmail. In 'src' you find .php files which show directly to the user. In 'functions' directory you will find all supporting files for the 'src' dir. PBCS_PATH is a define to find the root PBCS directory in all files. This is used in all files, including plugin files. - New Modular Authentication system for MySQL usage and POP3. This makes writing new auth methods easier. - Location support in appointments - Appointment protection to restrict people to remove appointments for others, unless you are the creator. - New XML sync library and client side PHP sync scripts for Palm and Yopy PDAs the clients are located in the contrib/ directory. - A new PHP installation wizard for fresh installs. - Default focus on login!
