Article Syndication Script (Version:1.5)
========================================
Step by Step Installation
=========================

This ReadMe.txt file will guide you thru the steps required 
to configure and install Article Syndication Script on your web site.

Master Resale Rights :- When you purchase this Software, you will 
automatically have Exclusive Master Resale Rights to this Perl source 
code. That means, you own the Script's copyright and you can sell 
the master resale rights, resale rights, or whatever. You can brand 
whatever you like. You can sell as a stand-alone package or with 
other products.

As an example, you can see an article syndicated page at:
http://www.ecommercedealers.com/articles/example.htm

Content of this Package
-----------------------
This package (Syndicate.zip) contains 5 files:

- articlesyn.cgi (PERL Script)
- template.js (Template File)
- articles.csv (Article Title Database)
- CodeCreator.htm (JavaScript code generator)
- and Readme.txt (this document)


Step:1 Configure the 'articlesyn.cgi' Script
-------------------------------------------

Open the Script 'articlesyn.cgi' on Notepad or any text editor.

A) Locate the first line which specify the location of PERL 
in your system.

The Default value is: #!/usr/bin/perl

Generally this is the location in almost all servers. 

In some cases this may be;

#!/usr/sbin/perl

If you are not sure, verify it with your server administrator then 
make necessary changes. Please don't remove the '#' sign at the 
beginning. You don't have to change the default value if the Script 
works properly.

B) Save the 'articlesyn.cgi' file.
When you save the file, some times it will save as 'articlesyn.cgi.txt'
instead of 'articlesyn.cgi'. In that case, your have to rename it.


Step:2 Configuring other files
------------------------------

A) template.js File

NO CHANGES are necessary.

If you want to change the look of the Articles, you can edit the template using 
any text editors. Please don't make any changes to the variables 
like $BorderSize,$BorderColor,$BkgImage etc. This step is 
recommended only for EXPERIENCED users.

B) articles.csv - Database of Articles.

This is a simple CSV database having 4 fields. Article Title, 
Article URL, Category and a dummy field 'x' has been 
separated by '|' pipe sign. You can add any number of articles 
into this database.

To add more Articles to this database, Just open 'articles.csv' 
file on a text editor or spread sheet program and enter 
the following 4 values seperated by '|'.

Article Title|URL|Category|X

(You must press the 'ENTER' key at the end of each line.)

Then save 'article.csv' file.

You can download 'CSVed', an easy and powerful CSV file editor 
software from the following link:

http://home.hccnet.nl/s.j.francke/csved/csvedsetup.exe

You can add more articles to your database with this free tool.

PS: please don't rearrange column order.

Step:3 Upload the modified files
--------------------------------

Upload the following files to your server into a directory 
that is allowed to run Perl CGI programs ( Generally /cgi-bin/ ) as 
ASCII (PLAIN TEXT) Mode. If you uploaded in Binary mode by mistake, 
it will not work. 

Set CHMOD (global execute permissions) as follows:

- articlesyn.cgi set to 755
- template.js set to 777
- articles.csv set to 777

STEP:4 Creating JavaScript Code
--------------------------------
Before using the Code Creator, you have to configure it 
by editing a value.  Just open this file on a text 
editor and look for the following code at the top 
portion (8th line from the top):-

var murl = "http://www.YourDomain.com/cgi-bin/articlesyn.cgi";

Replace the above URL with actual location of the script 
in your server.

Now, you have to create JavaScript code to place on your 
sites where the Articles to be appeared. Just double-click 
on 'CodeCreator.htm' file to launch it.

Fill-up the form and press 'Generate Code' button. Place 
the generated code on suitable places on your WebPages.
You can place these JavaScript codes in any number of pages.


Support
-------

When you experience a problem in installation that gives you a server 
error, it is suggested that you back up and start at the beginning with 
a clean unedited copy of the scripts. Always save a clean copy of any 
script that you intend to install. 

After carefully rechecking your installation, if you are still 
experiencing problems, please contact us.

Our team will Install this Script for you without any additional 
charges. we will also provide all new versions to our direct buyers.


Peace and God bless,

Ali
Noor Overseas
(91)-484-2446071.
ali@promoteindia.com
ecomdeal@hotmail.com