To install a copy of the Crystal Trader script on your domain you should have a valid license key. This key is mandatory for the all installation types.
First you need to login to the license server from the main page of site. If you don’t have a login on the site you can get one by registering here. The registration process is one click and takes less than a minute: just fill out all fields and press the button. Once you register you will be redirected to the main account page. If you already have an account, skip this step and log in.
On the main account page you can get the installation script in different formats for your convenience. The installation script will assist you with the installation process to your domain. To install the Crystal Trader script to your desired domain you should download (and unpack the archive if necessary) and then upload the install script to the root directory of your domain or directory crtr in the domain root. The root domain directory or directory crtr should have world-writable permissions (chmod 777) to successfully complete installation process.
To install the copy of Crystal Trader script you’ll need a valid license key. The license key is domain-based so you can use only one copy of the Crystal Trader script per domain. At the moment you can get license for free from you account's main page. To get the license please choose Crystal trader from products list and choose the latest version of product. We recommend you use the latest version of the software for all new installations with the exception of special cases when it is necessary to use a previous version. After making your selection a new license will appear in the license list. From this page you can control how many copies of the Crystal Trader script you have installed on your domains. A newly created license doesn’t have an assigned domain until you’ve done so.
To start the installation process please point your browser to http://yourdomain.com/install.php (or http://yourdomain.com/crtr/install.php depending on script location) and follow the instructions. You’ll be asked for the newly generated license key. It can be used for one copy of the script on one domain. The script will ask a few questions and do preinstall checks to make sure the server requirements are met (PHP version and so on). The actual installation process is subject to change and that's why not covered here but it’s simple and easy to understand. If you need help please do not hesitate to ask support for assistance. After all checks are passed the installation script will attempt to get all the necessary files from the server and will create working folders. It can take some time depending on the connection speed between servers and current server's load. If the install process is completed without error the script should show a congratulatory message with a link to the admin area along with a login and temporary admin password. It is strongly recommended that you change this password to a stronger one after your first login to the admin area. Also the last installation screen will show instructions about manual modifications that should be done to complete installation. At this point you should add new items to the crontab.
You will get string for cron after install process finished.
* * * * * cd /full_path/to/your/domain/root/directory/crtr/bin && ./cron.sh 1>/dev/null 2>/dev/nullback First steps After script is installed and the job is added to crontab you need to do the following:
Crystal Trader always organizes trades by niche. If you don’t need niche trading you will have one default niche: 'Main'.
A trader is added to a niche when its weight bigger than 0. The trader’s position in the outlist depends on its weight in the niche. Our recommended value for weight for all traders is 100. But weight is a relative parameter and you can choose any value as your base.
Every niche has its own outlist and traffic is not mixed between niches by default. You can add a trader to more than one niche with different 'weights' and mix traffic in that way.
Don't forget to add an nt parameter to query to out.cgi if you have more than 1 niche. Where nt is the id or name of niche where you want to send this click.
out.cgi?nt=1 – script will looks for traders in the niche ‘Main’ to send this click.
You need to put a code with in.cgi on all pages of your site. Crystal trader doesn't count ins when the referrer is your domain.
back Add/Edit niche
All your Niche1 pages are located at /niche1 directory. Url pattern=/niche1. So the script will count all incoming traffic to this directory for Niche1. Using this parameter in.cgi can detect in what niche the traffic was started.
You can reach the edit outlist positions form in two ways. Click on the image in the header of the niche stats table or from the top edit niches menu.
By setting points for every position in the outlist you can distribute traffic between positions. At anytime you can reset them to one of 3 predefined defaults (Stable, Optimal, Dynamic).back incoming (in.cgi):
in CGI mode in.cgi receive all traffic and show page or redirect it to some niche page
In this mode you can make in.cgi your index page on domain by puting this string
into your .htaccess file
out.cgi possible parameters:
'id' or 'ref' - trader id or trader domain to send click,
'l' or 'tag' or 'link' - link name,
'p' or 's' - skim scheme (60 or 60g or 60g,100t,50g etc.),
'hp' or 'hs' - hard skim scheme, it has the biggest priority than skim scheme or trader's skim
'cc' or 'c' or 'fc' -number of first clicks to content
'u' or 'url' or 'trade' - gallery or trader url
'nt' or 'nicheto' or 'grto' or 'groupto' - niche id or name to send click
Possible toplist variables:
<table width="240" border="0" cellspacing="0" cellpadding="0">
<td width="120"><a href="/crtr/cgi/out.cgi?id=##id_0##&l=top_top&u=##url_0##">##title_0##</a><br />
<a href="/crtr/cgi/out.cgi?id=##id_1##&l=top_top&u=##url_1##">##title_1##</a><br />
<a href="/crtr/cgi/out.cgi?id=##id_2##&l=top_top&u=##url_2##">##title_2##</a><br />
<a href="/crtr/cgi/out.cgi?id=##id_3##&l=top_top&u=##url_3##">##title_3##</a><br /></td>
<td width="120"><a href="/crtr/cgi/out.cgi?id=##id_4##&l=top_top&u=##url_4##">##title_4##</a><br />
<a href="/crtr/cgi/out.cgi?id=##id_5##&l=top_top&u=##url_5##">##title_5##</a><br />
<a href="/crtr/cgi/out.cgi?id=##id_6##&l=top_top&u=##url_6##">##title_6##</a><br />
<a href="/crtr/cgi/out.cgi?id=##id_7##&l=top_top&u=##url_7##">##title_7##</a><br /></td>
<table width="240" border="0" cellspacing="0" cellpadding="0">
<td width="120"><a href="/cgi-bin/crtr/out.cgi?id=##id_0##&l=top_top&u=##url_0##">##title_0##</a><br />
<a href="/cgi-bin/crtr/out.cgi?id=##id_1##&l=top_top&u=##url_1##">##title_1##</a><br />
<a href="/cgi-bin/crtr/out.cgi?id=##id_2##&l=top_top&u=##url_2##">##title_2##</a><br />
<a href="/cgi-bin/crtr/out.cgi?id=##id_3##&l=top_top&u=##url_3##">##title_3##</a><br /></td>
<td width="120"><a href="/cgi-bin/crtr/out.cgi?id=##id_4##&l=top_top&u=##url_4##">##title_4##</a><br />
<a href="/cgi-bin/crtr/out.cgi?id=##id_5##&l=top_top&u=##url_5##">##title_5##</a><br />
<a href="/cgi-bin/crtr/out.cgi?id=##id_6##&l=top_top&u=##url_6##">##title_6##</a><br />
<a href="/cgi-bin/crtr/out.cgi?id=##id_7##&l=top_top&u=##url_7##">##title_7##</a><br /></td>
To include toplist on your pages use following code
for .shtml pages:
<!--#include virtual="/crtr/toplists/TOPLIST_NAME.html" -->
for .php pages:
<?php virtual('/crtr/toplists/TOPLIST_NAME.html'); ?>
The main page of the admin panel consists of top menu and stats tables and most can be excluded from showing. You can do it, clicking on this icon
in the top menu and remove the check from the tables you would like to exclude or by clicking the [X] in the right top corner of table.
To refresh the stats you don’t need to reload the page. Just click on the in the top menu or in the header of any stats table.
From any domain in your site’s network you can check stats and control any other domain. For switching you should choose the domain on the top and press the button. If you want it to open in new window, use the checkbox next to it.
You can switch to the domain by clicking on the domain name on the bottom of the stats.
Also, you can choose which columns should be shown in the table along with their colors and titles. You can do it if you click on the
in the header of the table you would like to change. You can change it quickly if you click on the in the header of the table
If you want to change the sorting of traders, just click on the column title.
There are two possibilities for getting access to the control menu and the stats for traders and groups of traders. By default you can do it clicking on the on the left of the domain or group name (niche, trades, system, feeders, total). If you disabled this column from showing the popup menu will activate after you mouse over the domain (group) name.
Clicking on the cell 'forces' you can setup forces for a chosen trader. You can edit weight in the niche in the same way.back Skim and skim types
There are 3 types of skim that you can set for every trader:
Click on the Add trader button in the top menu or Add trader->Add single
See Add/Edit trader
Add trader->Add multiple in top menu
Select a field from left 'Select' and press to add it. Put the trader’s string in the bottom text area. Add only one string for each trader.
Domain and Url fields are required. Separator – symbol that separates trader fields in bottom text areaback Add/Edit trader
Add/Edit trader form can be 'Normal' or 'Extended'Normal form
Feeders checkbox – check it to put the trader in a separate stats table. Summary statistics for such traders show as a separate raw entry in the summary stats table.Forces:
By default script forces hits only from niches in which the trader has weight > 0. You can force it by checking Force from all niche
back Multiple edit Click on trader’s row in stats table to select trader. At bottom of every niche stats table there is a block for multi edit
Click on expand/collapse button.
Select parameter(s) to change or action and click Apply button.
You should choose the script you are going import from and set its database parameters. Attention! The current traders will be deleted.
Choose with the help of niches checkboxes from which you are going to export and trader’s status. You can choose multiple if you hold down Ctrl while clicking. Choose the fields you would like to export for each trader in the 'Set trader column' block.
Set field separator in the 'separator'.
After pressing the export button you will get a list of traders in the bottom text area.back Thumbnail grabber
Crystal Trader can make up to 5 thumbnails for each active trader.
Settings->Checker & Grabber - Grabber block
To enable grabber set the width and height > 0 for at least 1 thumb here.
The grabber can crop or just resize images. Select crop to allow cropping.
You can override this setting in the Trader edit form.
It grabs the first thumb by default from the trader’s site. You can set a thumb number for each trader
All thumbs are located in the 'crtr/thumb' directory. Each thumb has a filename that consists of the trader’s id and the image width and height
Each thumb has a filename that consists of the trader’s id and image setting id (1-5)
thumbnail for trader with id=54 and with 240x180 size - crtr/thumb/54_240x180.jpg
When you check the option feeder in the edit trader menu you are marking this trader a feeder. Such traders do not get traffic back and have separate stats in the Site total table.back Settings
You can set username/password session time here and grant access by IP(s) or networks.
New trader settings will used by default when you add new trader(s) or a trader signs up.
Auto skim block:
MySQL database settings. Use search button to find mysql socket.back Network
Each domain can only be in one network. You can add new sites to the network from any site which is already in it. If it’s a new network then there is restriction on which domain you are adding. If you have enabled an IP protection you should disable it temporally or add to the allowed IPs list that is showed in that window.
To check summary stats by domain you should have the network stats table active to show on every domain you want to see in the stats. Button in the top right menu.back Update
System->Updates , When a new update is available you will see it here with a description and the link which will update your script. You will also be informed about update by the icon in the top right corner.back Anticheat
Stats by link from Site total table.
You will see the amount of clicks and the % to all clicks with link parameter, and % of all clicks on the site. If you click the link you get a list of domains that made clicks. Clicking on the domain and you get hourly stats.back Send bug or Suggestion
Click on image at top right to send bug or suggestion.back Troubleshooting
Crystal Trader doesn't store your password so it can't be restored. There is only one way to get access back. You must reset the password. Edit file crtr/config/config.php to do this. You must change value of $admin_password variable to
Now you can access the admin panel with the password 111111.back
out.cgi or in.cgi 500 error
In most cases this means apache+suexec is enabled on your server. In.cgi and out.cgi scripts must be copied to a new location. Go to Settings->Main settings->Other , CGI Path block. Enter path to cgi-bin directory here or press search button to find your path then press the Update cgi path button
Warning!!! Cronjob was not started for at least 2 minutes
- Haven’t added job to crontab
- Go to System->Updates , and click Update current version files if you get this error after an update