Read Me

==============================================================================
 Release notes for Redaction System
 Current RS Codename:				calypso
 Current RS Development Status:		rs1_final
 Current RS Build Date:				19th March 2008
==============================================================================

*** Have questions? Send e-mail to: cyberghost636@users.sourceforge.net ***

<========================================================================================================================>

 ----------------------------------------------------
>>> RS NEEDS DEVELOPERS AND DOCUMENTATION WRITERS! <<<
 ----------------------------------------------------

!! If you are a PHP+MySQL+JavaScript developer and you like this CMS,
!! or you are a person able to write documentation for the project,
!!
!! -> JOIN Redaction System Team! <-
!!
!! Send e-mail to cyberghost636@users.sourceforge.net for more information!

<========================================================================================================================>


===========
CONTENTS ===
============
1. Release Notes
2. Credits
3. FAQ (Frequently Asked Questions)



<========================================================================================================================>



==================
1. Release Notes ===
==================

Bugfixes and features since last release /the usual stuff :)/
(version beta2, codename = atlantis):

---
Background Scripting Fixed and Features
---
o menu items do not point to aliases when in admin mode anymore in all themes
o determination of default content page fixed when using aliases
o fix for unserialization procedure when getting the aliases list
o aliases.ser file is now transferable (i.e. from testing server to real server)
o form submit now redirects to an alias, if present
o mailer class updated, so quotes in e-mails will not result in database insert
  errors anymore when storing e-mails into the e-mails log
o old aliases are now being removed correctly when the alias name is changed
  from old value to new value
o lost debug error messages removed from Forms Wizard
o file upload function updated, so it saves real filename into database
o uploaded files with custom file name are chmodded to 644
o Forms Wizard bug fixed that prevented form to be inserted into FCKEditor in MSIE
o old image paths replacement routine in database restoration module has been
  replaced by preg_replace function and now works correctly and much faster
o CountPages() function got ready for AJAX implementation and multiple instances use
o the checkAliasesCompatibility() function has been updated, so it correctly updated
  aliases when running RS from URL root (i.e. no subfolder)
o default content page getting for tabs when using aliases fixed for all themes
o mysql database backup script now handles NULL fields with NULL correctly
o aliases checking and saving procedures were updated to correctly handle root RS
  installation (i.e. into server root :)
o JQuery has been upgraded to newest version
o fix for content pages removal including database indexes change and aliases gaps
  closing fix
o CountPages() function has been rewritten and corrected
o aliases management and displaying for cross-tab menu items fixed
o database class updated, so database now correctly uses UTF8 charset connection
o database backup and restoration module updated, so it includes aliases updates
o function checkInt() has been updated, so it now allows resetting given variable
  value to zero (0) in case it is not numeric
+ ModulesManager ready for custom modules for Form Wizard fields
+ Forms Wizard data replacement function updated, so it accepts associative arrays
  for both, table style and TD style
+ form redirection script now also returns form id as get parameter for dynamic
  data manipulation
+ added function to handle string shortening

---
Interface Fixes and Features
---
o if only one language file exists, language selection page will no longer
  be displayed
o help icon next to unique form fields will only bring up help overLib box
  if you click on it - it did bring the help window when you moved mouse over it
o fix in Forms Wizard for selection box options adding - did not display option text
  in MSIE
o form field description in Forms Wizard has now HTML characters allowed
o selection box options in Forms Wizard now displays special characters (&, ...) correctly



<========================================================================================================================>




============
2. Credits ===
============

I would like to address some copyright notes here, as I have not created
everyhing here alone :)

---------------
Credits go to --
---------------
-> Frederico Caldeira Knabben and the whole FCKEditor team
   http://www.fckeditor.net

-> Erik Bosrup, OverLib JavaScript library
   http://www.bosrup.com/web/overlib

-> Leo West, SMTP class
   lwest@free.fr

-> Andrea Ingaglio <andrea@coders4fun.com>, Marcus Vincius <mv@cidademais.com.br>
   MySQL database backup class (mysqldump.php)

-> Alex Kunin (alx@cooldev.com), CoolMenu JavaScript
   http://javascript.cooldev.com/scripts/coolmenu/

-> Yahoo! Inc., YUI JavaScript Library
   http://developer.yahoo.com/yui

-> John Resig, jQuery
   http://jquery.com

-> re-Captcha
   http://recaptcha.net

-> Mike Crawford, Ben Maurer, PHP re-Captcha library
   http://recaptcha.net/plugins/php

-> phpletter team, JQuery file upload extension
   http://www.phpletter.com

-> every visual theme creator (you'll find copyrights at the end of each theme)



<========================================================================================================================>



=====================================
3. FAQ (Frequently Asked Questions) ===
=====================================

Q: What if I have JavaScript turned off on my machine as a security measure?
A: You will have to turn it on, at least for the period of website administering,
   otherwise you won't be able to administrate the website at all.
   Most browsers today have very tight security measures to ensure comfortable
   and secure browsing even with JavaScript turned on.
   You will still be able to browse the existing website created by RS even
   if you don't have JavaScript active, though.

Q: Something does not work correctly. Is there any support?
A: Please, write an e-mail to cyberghost636@users.sourceforge.net with a description
   of what you did when the error occured and what exactly is the error.
   Include error message (if any visible) and place where the error occured.
   I will fix it as soon as possible and release a patch.

Q: Why can't I remove myself from administrators?
A: Only other administrator can remove yourself from the system admins list.
   This is a security measue, so when you are the only administrator left, you
   will not lock yourself out of the system completely by accidentally removing
   yourself as the last admin.

Q: I have created a tab, menu and a content page but none of them are visible
   when I log out from administration and look at the real website. What's wrong?
A: By default, every new element, i.e. tab, menu and menu item, is deactivated.
   This means that you can see and update them in admin mode, but in order to show
   them to visitors, you will have to activate them using their editation menus.
   Content page is an exception that is active right after its creation.

Q: I have created new tab for rank XXX but when page refreshed, I still could not
   see it, even though I am in admin mode. Why?
A: At the right-top side of the website you can see a login/logout information.
   When you log into admin mode, you can also see a dropdown box under this info
   that will let you see page as one of the existing ranks would see it.
   You see pages for unregistered visitors by default.
   If you created new tab and you set that if should be shown to rank XXX only,
   you need to select the XXX rank in this right-top side dropdown menu.

Q: The installer doesn't seem to do anything when I click the Next link.
   /possibly also: When I click the Next link, I see there are errors on page./
A: AJAX (asynchronous JavaScript) support is required for installer to perform
   some checks and set the system settings correctly. Most of today's browsers
   have this functionality built-in, however there are still some that
   don't support it.
   In order to solve this situation, please download newer version of your
   favourite browser or the latest version of one of the following browsers:
   - Microsoft Internet Explorer
   - Mozilla, Firefox
   - Opera
   - Safari
   - Camino
   - Netscape