Comdev Newsletter 4.0
========================

You can choose to download only the Newsletter 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 *
						
Database 				: MySQL 

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

Computer Hardware 		: PC and Mac


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

* AVOID SPAM: Our Newsletter component is not built for spamming purpose. Our support does not include spam 
  related issues, such as by-pass spam filter, sending to invalid email addresses, etc.


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

1. Download the Newsletter distribution ZIP file. 

2. Extract and upload the entire folder to your website under your domain name. 

		Example : http://your_domain_name.com/oneadmin/ 
		
 
3. For Linux system, set the permission for the _files folder and 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 the URL with your web browser. Follow the instructions in 
   the Installation Wizard. 
   
5. Once the installation is complete, you can proceed to login to the Administration area. 


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

1. One of our product uniqueness is we made our scripts capable to fit into your existing web design. 

2. First, you will need to save your HTML file with .php extension. Then, open the file with your favorite 
   text editor to edit its HTML source code.  
   
3. Before calling any script, put the line below to include the config.php file. The config.php file will 
   loads all the class libraries and creates database connection.  
 
		<?php include_once("config.php") ?> 
		
		
4. In your HTML code, put the line below to call the newsletter content area such as subscription form and 
   archive listing.
 
		<?php include("newsletter/home.newsletter.php") ?> 
		
		
5. If you need more code reference, you can look for the samplenewsletter.php as example. 

6. Finally, as an additional tip, 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/newsletter.php and the One Admin folder is 
   located at   http://yourdomain.com/oneadmin/ , use the code below. 


 		<?php include_once("oneadmin/config.php") ?>  

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



Visit Us
--------

For more information, please visit our website at http://www.comdevweb.com.


