> Below are the installation docs for Easy JV & Affiliate Manager Before you start with the scripts, login to your server and go to your cgi-bin. Create a directory in your cgi-bin, you can name it whatever you want, in this example we will call it "jv". Inside the "jv" directory, create another directory called "data", it must be called data. Now go into the "data" directory and create 6 more directories called: archives hits messages notes sales track They all MUST be named exactly as they appear above. Now chmod the data directory and all of the directories inside the data directory to 777. Onto the scripts! Open all .cgi files and make sure the first line is the correct path to perl. Now upload them all to your "jv" directory in ASCII format(do not upload them in binary) and chmod them all to 755. Upload config.cgi, paypal.txt, stormpay.txt, and homepage.html to the same directory and chmod them to 777. All done! That was easy ehh? Now it is time to setup the program. Type the URL to the admin.cgi file in your broswer and use "test" as the password to login. Once you are in, go directly to the last link called "Change Settings". The table below explains how to set it up.
> Path to sendmail | Put your full path to sendmail (i.e. /usr/sbin/sendmail )
> URL to the admin script | Full URL to the admin.cgi script
> Path to data directory (no trailing slash) | Full path to the data directory (i.e. /home/www/username/cgi-bin/jv/data )
> URL to affiliate.cgi script | Full URL to the jv.cgi script
> URL to c.cgi script | Full URL to the go.cgi script
> URL to signup.cgi script | Full URL to the signup.cgi script
> Administrator's Email Address | you@yourdomain.com
> Password | Think of a password
> Again | Type it again (CaSe SeNsItIvE)
> Default referring URL | Type in the full URL to where you want them to go when somebody clicks on an JV partner's link
> Sale Image | URL to sale image
> Total Hit Image | URL to hit image
> How Many Levels? | Put a 1 for a one tier JV program and a 2 for two tier JV program
> If 2 levels, show partners their downline? | Put a 1 for yes and a 0 for no. This will allow JV partners to be able to view their downline.
> If above is at "1", allow them to email their downline? | Put a 1 for yes and a 0 for no. This will display a button that takes the partner to a mailform so they can send a mass personalized mailing to their downline.
> Admin approve signups? | Put a 1 for yes and a 0 for no. This is if you want to manually approve each signup
> Admin approve sales? | Put a 1 for yes and a 0 for no. Manually approve sales?
> Send email to partner upon signup? | Put a 1 for yes and a 0 for no.
> Send email to partner upon signup? | Put a 1 for yes and a 0 for no.
> Send email to partner upon sale? | Put a 1 for yes and a 0 for no.
> Send email to sponsor upon sale? | Put a 1 for yes and a 0 for no.
> Program Name | This is your JV program's name. It will be displayed throughout the script
> Cookie Name | This is how the program tracks. Try and keep it one word with no spaces or special characters
> Dark Table Color | This is for the tables in the partner login area, put the color code (i.e. 000066)
> Light Table Color | Choose the color for the light colored tables
> Dark Text Color | The dark color of the text
> Light Text Color | The light color of the text
> Border Color | The color of the table borders
> Pay Users? (1= percentage, 0 = flat fee) | Do you want to pay users a percentage of the final amount? Or a flat fee for each and any sale made?
> 1rst level percentage | What percentage of the sale amount will partners make when they make a direct sale
> 2nd level percentage | What will partnerd make when a sub-partner makes a sale (If your program is only 1 tier, put a 0 here)
> 1rst level flat fee | If you are choosing to pay a flat fee per day, enter it here (put a 0 if you chose to pay a percentage)
> 2nd level flat fee | What will partners make on their second tier (put a 0 if you chose to pay a percentage)
> Intergrate with? | Put a 1 here if you are going to use an image tag, a 2 if you are going to redirect. See below to decide on what method you want to use.
> URL of integration | Put the full path of the image or the full URL to the page you want to redirect to after a sale here.
> Referring URL protection? | Put a 1 here if you want to limit access to credit.cgi to one URL. This is used so that people cannot access it and try to steal comissions, if a 1 is put here, the only way people can access it is if they come from the exact URL below
> URL of referrer? | If the above is set to 1, put the exact URL that will be able to access calculate.cgi.
Integrating with your ordering system

You can pretty much integrate with any payment system out there with the options that Easy JV & Affiliate Manager gives you.
* Image Tag - This is probably the simplest way to integrate the script. All your payment system has to do is to have the final purchase amount(if you are paying by percentage) on the thank you page after an order has been made. If you are paying flat fees, then you dont even need the final amount. All you do is link to the script using an image tag and the final purchase amount like so:
<img src="http://www.yourdomain.com/cgi-bin/jv/credit.cgi?amount=total">
The URL should be the full URL to the credit.cgi file. "total" needs to be the total dollar amount. If you are paying a flat fee, then you can just put a 1 where "total" is. Now when somebody orders, it will trigger the script and look for the referring affiliate cookie or match the IP address and credit the sale.
* Redirect - This works by forwarding the visitor to the URL with the amount variable right in the URL. So your order form would just send the customer to:
http://www.yourdomain.com/cgi-bin/jv/credit.cgi?amount=total
Then it would look for the affiliate, do commissions, then forward the customer on to the URL that you put in for "URL of integration"
After you get the settings form filled out, log back in and create all of the emails and HTML for the script to run off of. This should be the very next thing you do so that you do not get any "Could not open template" errors.
Paypal and Stormpay Instant Commission feature.
This system can pay your affiliates instantly on one tier using Paypal and Stormpay as payment processors.
To set this up, you will take the homepage.html file and replace it with your sales letter. Make sure to put the tags <paypal> and <stormpay> inside the HTML of the sales letter whever you want the order buttons for paypal and stormpay to be.
Next, open up paypal.txt and stormpay.txt. This is the button HTML that those two processors use. You can go to Paypal.com or Stormpay.com and create the buttons and then paste them in here if you wish, or you can just edit the HTML right in this file.
The only thing that needs to be changed is the field for the payee's email address. Replace that with <paypalemail> for paypal.txt and <stormpayemail> for stormpay.txt
Once you do the above, type the full URL to the homepage.cgi file on your server. It will read the JV partner's cookie or IP address from the visitors and display the proper payment email for the visitor to pay the JV Partner directly.
If you are going to use this system, then your default URL that go.cgi will redict to needs to be homepage.cgi.
Frequently Asked Questions
I get the error "Cannot open file(No such file or directoy)"
This means that you either have a folder in the "data" directory setup wrong(spelled wrong, or not set to 777) or you have your data path enter wrong in the settings area. Make sure you are not using an URL for the data path instead of an actual path. A path looks like this:
/home/user/username/cgi-bin/jv/data
Where are URL would be:
http://www.yourdomain.com/cgi-bin/jv/data
The above path is just an example, if you do not know your path, ask you webhost :) A wrong data path is the number 1 problem with setting up this script.
I get a "page not found" or "internal server" error when I run a script
Page not found usually means that your server does not have the CGI.pm module installed. This is a very popular module used by thousands of perl programs and you should definately have it installed on your server. This is something your webhost will have to do, send them an email and they will most likely install it right away. If they do not install it, you need another webhost :) It is a pretty important module.
An Internal Server Error means that the permissions on the file are not set right.
Which integration method should I choose?
This completely depends on the payment gateway you are using. If you have multiple products, then you are going to need to have your payment system display the total amount(if you are paying partner by percentage) either in a redirect URL, or on the thank you page.
If you are using a shopping cart, it needs to either be able to forward to the calculate.cgi URL with the total amount in it(see above) or use an image tag to activate the calculate.cgi.
If you are using authorize.net, then it is very simple to install. Just have authorize.net to post the order information to the script. Ibill and Anacom work this exact same way.
If you are using a third party, like clickbank.com, then you can just use an image tag on a static HTML page to call the script, no problem :)
That is pretty much all I can tell you about installing the script. If the script just flat out won't work on your server, you should probably be looking for a new webhost. This script has nothing special about it, no special modules are needed, nothing. If this script won't work on your server, than neither will 90% of the other cgi programs out there.
A Few Tips
The "Edit Pages" section is quite unique. You can add product pages for your partners to promote. All you have to do is add the code, and then the URL in to create the product page. Like this:
code = mmp
URL = http://www.yourdomain.com/mmp/
Now all partners have to do to promote that specific page is just add ?mmp to the end of their URLs.
Tracker IDs - When you create the links page, you should tell partners that they can change "ad" to anything they want and it will show up in their partner login area when that specific tracker gets traffic. This is the most powerful feature in Easy JV & Affiliate Manager and you should definately teach partners how to use it!
Archives - The archives section is created whenever you make a payout to partners, it will archive all of the information that you paid out so you can view it later. I plan to use this feature so that I do not have to pay out all partners on one day, but rather split it up over a few days. Pretty neat.
Clean files - this feature is needed in every partner program, but none seem to have it. This is to erase old data that isn't really being used by the system so that your partner program can run smoothly. I suggest logging into this section once per month and erasing any sale files and hit files that are more than 3 months old. You can choose 4,5, or 6 of course, but I dont think partners need to know if they got any traffic 4 months ago, therefore, it is just taking up space and with this section, you can easily get rid of it.