=============================================================================

* Changes from 0x03_1


+ Core

   o Removed the order field ($id) from the modload() routine. The problem with
     that field is that its value only influence the previously loaded modules
     making impossible to set an absolute id for a module placed randomly into
     the modload() calls list. A new order mechanism may appear in further
     releases of CHeMS.

   o The following options has been renamed:
  
        [old name ]		[new name]	[ description ]
        ---------------------------------------------------------------------
        FIELDS_SEPARATOR	FSL		field separator list
        DEF_MODNAME		BASEMOD		base module
        *_POSTS_*		*_POSTSMGR_*	posts_mgr module
        *_PAGES_*		*_PAGESMGR_*	pages_mgr module
        *_COMM_*		*_COMMENTS_*	comments module

   o Fixed an high priority bug about USE_UTF8 which, if disabled, didn't show
     nothing at all (modules, pages, posts, ...).

   o Allowed to load modules which only have pages (_page routine)
     without a menu block (_main) by setting the $side and/or the
     $mods variable of modload() to "none".

   o New option TAG_BODY_CODE which allow to append text inside the <body>
     tag declaration. This may result useful, for example, with the option
     CHEMS_SECTION_HEAD which includes some Javascript code, then the
     onLoad() routine may be used inside the TAG_BODY_CODE option in order
     to run Javascript script on page load.

   o Toggle the menu bars when no menu modules are loaded.

   o Fixed few problems about loading multiple instances of modules.

   o Fixed "null modules" (which returns NULL or empty strings) which are
     now fully ignored from CHeMS.


+ Modules

   o Added two options: MOD_COMMENTS_PREFORM and MOD_COMMENTS_POSTFORM
     which allow to place HTML code before/after the comments module form.

   o Integrated categories support based on the categories module into the
     posts_mgr module in order to allow per-post categories in posts list.
     A new option MOD_POSTSMGR_SHOWCATS has been provided.

   o New options MOD_COMMENTS_MSG_SUBMIT and MOD_COMMENTS_MSG_RESET for the
     comments module form buttons "submit" and "reset".

   o New option MOD_POSTSMGR_LIST_SORT. Need testing.

   o Removed the "&$var" arguments from the xtrset() call into the modules
     "categories" and "navbar". The xtrset() definition is unaltered since
     it already had set the relative arguments to be passed by reference.
     A new optional argument allow to choose the sorting type (asc, desc).

   o Fixed INC files about key values for the insert() routine (id, body, etc.)
     which was variables, not strings.

   o Fixed and cleanups modules with E_ALL PHP messages enabled. All the
     modules are involved.

   o Fixed mkfeed.php which now fetch the feed in reverse order. This is not
     strictly a fix, rather it's an improvement (more correct behaviour).

   o Removed the %[posts_total] format operator from the navbar module.
     It isn't needed at all since it's show only into the single-post
     view (where posts_totals and pages_totals coincide).

   o New module "contacts" which allow users to send mails to the listed
     member (names, not email addresses). This remove the need to public
     emails into the web application preventing the spam phenomen. NOTE:
     this module doesn't have any block menu implementation so it need
     to be linked somewhere with the "?modname=contacts" URI string. The
     contacts module is disabled by default.

   o Implemented full instances support for all modules. For curious, the
     following regexp (in Vim) helped a lot:

        %s/\.\(MOD_.*[A-Z]\)/.@constant("\1$instpfx")/g
  
     The following modules couldn't be changed: pages_mgr, posts_mgr and
     navbar.

   o Fixed MOD_POSTSMGR_POSTSPERPAGE and MOD_POSTSMGR_MAXLEN which had problems
     with negative values.

   o Removed the %[modname] format operator since $_GET['modname'] produces
     the same result.

   o New module chtheme (change theme) which allow to switch between themes on
     the fly.

   o Fixed HTML modules divs IDs and classes


+ Documentation

   o Fixed a bit of documentation (lots need to be check!) and FAQs. 

   o Added few FAQs.

   o New chapter "Internals" into the guide.

   o News section about the _CEXEC constant into the guide.


+ Misc

   o The guide has been updated to reflect the upcoming changes.

   o Introduced the "core" meta-theme.

   o Theme informations interface has changed. Look a .theme file to learn about
     the new way to store theme informations.

   o Added globals format operators in main.php. Actually only the theme
     informations has been provided.

   o Defined the _CEXEC costant in index.php. This allow to check if a file has
     been called from the CHeMS core or directly by the user. In the latter case
     an error message ("Restricted access!") is print and none of the code is run.

   o New logo. THX to Roberto Cascio to made this nice new image.

   o New header, feed RSS and some meta images. THX to Azzurra Di Girolamo to made
     this great work.

   o Lots of fixes and code cleanups.

