Comdev Events Calendar 4.1
==========================

You can choose to download only the Events Calendar component or the complete One Admin Suite. 
Before installing, we recommend you to take a look at the System Requirements.

System Requirements
-------------------

Script Type 			: PHP Server Side Scripting 

Operating System 		: Linux or Windows Server

Web Server 			: Apache or IIS 

PHP Version 			: PHP 4.2 or above 

PHP Configuration 		: ZLib library *
				: Safe_Mode = OFF
						
Database 			: MySQL 

Web Browser 			: Internet Explorer 5 or above, Firefox, Mozilla, Javascript and cookie enable 

Computer Hardware 		: PC and Mac 


* ZLib library is required to run the encrypted codes. We recommend PHP 4.2 and above as the lower 
  versions will results in buffer handling error.



Installation Guides
-------------------

1. Download the Events Calendar distribution ZIP file. 

2. Extract and upload the entire oneadmin folder to the root level of your web server. 

	Example : http://your_domain_name.com/oneadmin/ 
		
 
3. For Linux system, set the permission for the oneadmin/_files folder and oneadmin/config.php file to Read, Write, 
   Execute for all parties.

	Linux command example : chmod 777 _files, chmod 777 config.php
		
		
4. To access the Installation Wizard, visit One Admin URL using your web browser, http://your_domain_name.com/oneadmin/. Follow the instructions in 
   the Installation Wizard.
   
   * For Windows Server, you access to One Admin using http://your_domain_name.com/oneadmin/index.php
   
5. Once the installation is completed, reset the file permission for 'config.php' file to 644.

6. You may proceed to login to the Administration area. 



Integration Guides
------------------

1. Using a text editor, open your web page file (.php file), and put the code below to the top of the file (line 1), to call the 'config.php' file.
   This will load all the necessary database connection and class declaration files.

 	<?php include_once("document_path_of_oneadmin_folder/config.php"); include_once($path["docroot"]."common/css.php"); ?>

 	* Note: Always insert the above code to the line 1, without any preceding character(s), not even a space.


2. To show the upcoming events, put the code below to any area of your web page file that you want it to display.

 	<?php include($path["docroot"]."calendar/home.upcoming.php"); ?>


3. To display the event search, and event types, in the menu area of your calendar site, insert the following code.

 	<?php include($path["docroot"]."calendar/home.menu.php"); ?>


4. In the body content of your .php web page file, put the line below to show the calendar view.

 	<?php include($path["docroot"]."calendar/home.calendar.php") ?>


5. For sample integration code, please refer to the source of this file. To do this, open it with your text editor.

** To find your 'document_path_of_oneadmin_folder', check the path['docroot'] value from the oneadmin/config.php file


TIPS
----

You can put your front-end file in any location you like, but put the call to the One Admin folder using the relative path. 
   
Example, if your front-end file is at   http://yourdomain.com/calendar.php and the One Admin folder is located 
at http://yourdomain.com/oneadmin/ , use the code below. 

	<?php
  		include_once("oneadmin/config.php")
  		include_once($path["docroot"]."common/css.php");
	?>

	<?php
  		include($path["docroot"]."calendar/home.menu.php");
  		include($path["docroot"]."calendar/home.upcoming.php");
	?>

	<?php include("oneadmin/calendar/home.calendar.php") ?>

	
Visit Us
--------

For more information on Events Calendar, please visit to our website at http://www.comdevweb.com/calendar.php

For detailed installation & integration guidelines, tutorial and troubleshooting, 
please visit to our knowledge base at http://www.comdevweb.com/knowledgebase.php?category_id=39&parent_id=39