Installation
============

Step 1 - upload
===============
Create a directory in your webspace (e.g. newcj)
Unpack the script and upload to your webspace

Step 2. - set permissions
=========================
set CHMOD 777 to the setup directory
set CHMOD 777 to the toplist directory
set CHMOD 666 to the setup/config.php file
set CHMOD 666 to the toplist/* files (all files in toplist directory)

Step 3. - Start install script
==============================
Open your web browser go go to the http://yousite/scriptdir/install/install.php
(e.g. http://www.yoursite.com/newcj/install/install.php) and follow instructions.

Step 4. - deleting install files
================================
After succesful installation, DELETE the install directory from your webspace, because it's dangerous
to keep there.
Change the admin password after the first login!

Features

* Next generation trading algorythm
* Optimized for high traffic sites
* Detailed statistics
* Advanced cheat detection system
* Proxy detection
* Country detection
* Automated toplist generation with highly customizable toplist templates
* Link category tracking support
* Easy to use, no useless statistics
* Easy install system helps you to install without programming knowledge
* No extra PHP extension needed (both PHP4 or PHP5 supported with MySQL support)
* FREE!

Installating

See INSTALL file

Getting started

After installing the script you should do the following:

* Activate tracking for incoming visitors
* Change outgoing links to track outgoing visitors

Activationg incoming visitors tracking

The page where your visitors come (e.g. http://www.yoursite.com/index.php) must be .PHP extension! Edit this file and add the following code to the top of the file:
<? include ("NEWCJDIR/in.php");?>

Replace NEWCJDIR with the directory where you installed newcj (e.g. <? include ("cj/in.php");?> )
Add this code to all files where visitors can enter (e.g. gallery.php, ...)

Outgoing visitors

All links should be directed to the trade script's out.php to enable trading. You can specify a lot of parameters here to satisfy your needs:

1. Normal trade with 50% chance:

The chance of going to the specified URL is 50%. If it's not come true, the visitor is redireected to one of your trade partners. If this visitor has already visited all your trade partners, he will be redirected to the real URL for some hours.

Usage of this trade is the following:
send links to: NEWCJDIR/out.php?url=THEREALURL
(e.g. newcj/out.php?url=http://www.google.com)

2. Normal trade with custom percentage

The same as the first one, but you have to specify the percentage of being traded. If you specify 70, it means that the chance of being redirected to a trade partner is 70%. If you specify 0%, the visitor is being redirected to the real URL all the time.

Usage:
send links to: NEWCJDIR/out.php?p=PERCENTAGE&url=THEREALURL
(e.g. newcj/out.php?p=70&url=http://www.google.com)

3. No trade for the first click

When a new visitor arrived to your site, we don't redirect him to a trade site for the first time. This type of trade can be combined with custom percentage (from the second click it behave as a normal trade)

Usage:
send links to: NEWCJDIR/out.php?f=1&p=PERCENTAGE&url=THEREALURL or NEWCJDIR/out.php?f=1url=THEREALURL
(e.g. newcj/out.php?f=1&p=70&url=http://www.google.com)

4. Normal trade with categorized link tracking

If you want to track how many clicks have been made in a link (or in a category) you can add a custom link tag to the URL to track it. This can be combined with the previos types.

Usage:
send links to: NEWCJDIR/out.php?link=LINKNAME&url=THEREALURL
(e.g. newcj/out.php?link=archive&url=http://www.google.com)

5. Direct trade to a partner

If you want to redirect to a specified partner, you should use this type of trade.

Usage:
send links to: NEWCJDIR/out.php?tradel=THEPARTNERURL
(e.g. newcj/out.php?link=archive&url=http://www.google.com)

The URL must be between your trade partners.

6. Trade with 100% chance

The visitor is always being redirected to a trade partner, it's not the same as p=0, because it doesn't stop trading when the visitor has visited all partners.

Usage:
send links to: NEWCJDIR/out.php
(without any parameters)

The admin page

After logging in, you can see the main statistics page. You can refresh it by clicking the refresh link in the menu.
The following informations are displayed here:

* Hourly and daily raw incoming visitors number
* Hourly and daily unique incoming visitors number
* Hourly and daily clicks number (the number of requests that out.php got)
* Hourly and daily outgoing visitors number (the traded visitors number)
* Hourly and daily productiviy ( clicks / unique incoming visitors)
* Hourly and daily return % ( outinging visitors/ unique incoming visitors)
* Remaining forces (you can set up to trade a certain number of visitors to the choosen page, unless it doesn't send incoming visitors)
* Editing, deleting pages

The disabled pages are highlighted with orange color.
The pages highlighted in cyan color are new pages, no visitors are sent to them, unless they send the required visitors (can be set up in the settings page, see below)

Adding new trade partner: Click to Add trade link in the menu and fill in the form.
Settings: you can setup the following parameters of your site:

* Site URL: the URL of your site
* Site Name: the name of your site
* Your Email
* Your ICQ UIN
* Minimum Hits In to start trade: when somebody registers to the trade program, he have to send this amount of visitors to start the trade. The new members who doesn't reach the limit are highlighted in cyan color.
* Default Max Return %: sites having higher return ratio then this number are displayed in the Cheat page.
* Default Max Prod % and Default Min Prod %: sites having higher productivity ratio than max prod or lower than min, are displayed in the Cheat page.
* Default Max Clicks: sites having higher number of clicks per hour than this number, are displayed in the Cheat page.
* Max Trades partner: when the trade partners number reaches this number, people can't register in webmaster.php (you can add new site in the add trade page)
* Default Hourly Force: if you set up default hourly force to 10 and one of your pages sends 10 visitors, the script try to send back 20 visitors. So the force counts as an incoming visitor. You can also set up forces individually per sites when you edit a page.
* New Trade: Is the site open for registration (webmasters can register in webmaster.php)
* Trade Status: when somebody registers, does his page enabled by default or nut?

Links: if you define category links in outgoing visitors trade (e.g. out.php?link=toplist&link=http://www.google.com), you can see the statistics of the links here. You can also see the statistics per sites in the trade stats page.

Daily: the daily stats are displayed in this page

Blacklist: you can disable sites from your trade program. If you add a domain to the blacklist, people can't submit this page anymore.

Cheat: sites having bad rates are diplayed here. You can set up the limits in settings. It doesn't mean that the site is a cheater ff it's displayed here.

Toplist:

The program can create a highly customized toplist of the trade partners. You can create 7 different template files for different toplists (7 sample templates are already included). The template files placed in the toplist directory and named template1.templ to template7.templ. These are normal html files with special tags. These special tags are replaced with values when the toplist is generated (toplists automatically generated every hour, but you can manually regenerate it in this page). The following special tags can be placed in the template (not necessary to place all tags, only if you wish):

##sitename1## .. ##sitename100## Replaced by the site name. sitename1 is the first site, sitename100 is the 100th.
##sitedomain1##.. ##sitedomain100## The URL of the site.
##sitedesc1## .. ##sitedesc100## The description of the site
##in1## .. ##in100## The unique incoming visitors send by this site
##clicks1## .. ##clicks100## : The clicks made by the visitors from this site
##out1## .. ##out100## : The outgiong visitors send of this site
##prod1## .. ##prod100## : The productivity of the site

The generated toplist files named template1.html to template7.html

Change Pass: you can change the admin password here.

Proxy: you can import proxy list to the program. This addresses are identified as proxy.

Trade Stats: there are detailed stats for sites. You can see the proxy requests number, the country stats, the referer stats and the links stats as well.