Read Me

imacs (innovative Management of Contents)
=========================================

Beta - Pre-Release Version 
V0.7.4 trunk

The 'imacs' (innovative Management of Contents) is an Content Management 
System on base of mootools frame basically intended for light websites 
but due to a plugin concept it will be enhanced for web applications. 
The comple core was rebuild and is now available in sourceforge under
MIT License.
Internal naming convention uses 'jrcms' instead of 'imacs' which may be 
replaced in a final release.

MIT License
-----------
 @copyright Copyright (c) 2011,2012
 Permission is hereby granted, free of charge, to any person 
 obtaining a copy of this software and associated documentation 
 files (the "Software"), to deal in the Software without restriction, 
 including without limitation the rights to use, copy, modify, merge, 
 publish, distribute, sublicense, and/or sell copies of the Software, 
 and to permit persons to whom the Software is furnished to do so, 
 subject to the following conditions:
 
 The above copyright notice and this permission notice shall be included 
 in all copies or substantial portions of the Software.
 Only one restriction applies, i.e. a copy right notice "powered by imacs"
 to the imacs project have to be used on top of your application and/or 
 using the about function of the core.
 
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, 
 EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 
 MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. 
 IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, 
 DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR 
 OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR 
 THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Features
--------
- CSS Layout
- integrated content Editor (xinha)
- main and right content supported
- 3 Menu levels (horizontal, vertical, right)
- task buttons for own applications
- multiple language support (DB, Helptext)
- integrated slideshow (www.electricprism.com/aeron/slideshow/)
- integrated omnigrid
- report feature for articles
- event planner  

Limitations
-------------------------
- the maintanance is tested with Firefox only
- very basic version of menu maintenance
- MSSQL not finally proved 

Improved Features/Fixed Bugs
----------------------------
>>> Last conventionell version, structure will be changed

Installation
------------
1) Extract the archiv in a folder which could be used with PHP
2) Create a MySQL DB
3) Adapt the conf/cConfig.php (e.g. database name, see below)
4) start the content

The "webmaster" will be created with the password "123" and some further options
will be available while working as "webmaster".
After first login as webmaster some settings of database are updated. Please
reload the page manually.
For easy test purposes you could use the 'test_db.sql' of the ZIP archive, but be
aware that imacs is developed in a subdirectory named 'imacs'.


Configuration
-------------
Necessary values for first run have to be adapted in:
>> cConfig.php
	CONST proURL			= 'http://localhost';
	CONST docPath			= '/imacs'; 		// subDir for local development (e.g. XAMPP used), default empty
	CONST srcPath			= '/imacs'; 		// same as docPath
	CONST my_dbhost			= 'localhost'; 		// example for MySQL
	CONST my_database		= 'imacs'; 			// example for MySQL
	CONST my_dbuser			= 'root'; 			// example for MySQL
	CONST my_dbpwd			= ''; 				// example for MySQL
	
>> cConfig.js
	jr_pluginList:[{pluginName:'JRCmsGrid', cmp:true ,userLevel:'000'}		// mandatory
						,{pluginName:'JRCmsMenu', cmp:true ,userLevel:'220'}		// mandatory
						,{pluginName:'JRCmsUser', cmp:true ,userLevel:'220'}		// mandatory
						,{pluginName:'JRCmsEditor', cmp:true ,userLevel:'220'}		// mandatory
						,{pluginName:'JRCmsExample', cmp:false ,userLevel:'000'}	// optional
						,{pluginName:'JRCmsReports', cmp:true ,userLevel:'000'}		// optional
						,{pluginName:'JRCmsImgShow', cmp:false ,userLevel:'000'}	// optional
		               ],
		               
>> Be carefully in using compressed/uncompressed files. This files are identified by an extension 'cmp'
in the file name.		               

That's for now. A more detailed description will follow.

Jens Raabe