Installation Instructions

 

System Requirements:

  1. Servers that support PHP / MySQL (Unix-Based servers recommended)
  2. Ability to run cron jobs

Need a reliable web host? We highly recommend Server Yard

Need installation help? Get it installed for only $25


This file contains the installation instructions for this script. Please follow them before running the script:

Step 1: Editing config.php file


Just open the file "config.php" in this directory, and edit the following variables:

-$scriptDir:

This is the name of the directory where you've put this script's files. E.g if you made a directory called jv in your server's root directory, and placed the script's files in that directory, then the value for this vairable will be "/jv/" . (Notice the forward slash in the beginning and end.)

- $dbuser
Your mysql database's username

- $dbpass
Your mysql database's password

- $dbhost
Your mysql database's host name (mostly localhost)

- $dbname
Your mysql database's name (this is the database where this script's tables will be created)

-$table_prefix
If you want to have more than one installations of this script on your server, then use this variable to change the "prefix" added to each table used by the script. This way, the database of each installation will be seperated from the others.

-$uploadDir
This is the path to the directory on your server where all uploaded files are to go. This directory must be chmodded to 777. If you don't allow uploads on your website, make it blank.

-$uploadDir_www
This is the URL of the directory you put in the variable above ($uploadDir). For example, if the path to $uploadDir is /uploads/ then this variable will be probably http://www.yourwebsite.com/uploads/.

It's highly recommended that you only change this variables. After you've done that, save the file, and continue to Step 2.


Step 2: Creating the tables:


To create the table, just run the script called "setup.php" in this directory by loading it on your web browser. Upon success, you should get the message "All tables created successfully". If you provided the correct mysql information in config.php (see Step 1), then there is no reason why the tables wouldn't be created successfully.

 

 


Step 3: Editing the .htaccess file:


This is really simple. Open the file ".htaccess" in a text editor, and replace the words "this-scripts-directory" with what you provided as the value of
$scriptDir in Step 1. After that, just save the file.

 


Step 4: Accessing Admin Panel:



When the script is first installed, it uses the following login information for the admin account:
username: admin@jvfiresaleautomator.com
password: 123

That account has been given admin level priviliges, and you should be able to use all featurs of the script using that account. You can change these details once you log in.

 


Step 5: Set up Cron Job



In order to automate JV Partner emails, you need to set up a cron job. The script will check if there are any messages to send, save it memory, and send it exactly at the date/time you've designated.

Here's the file to put in the cron job:

[path-to-installation-directory]/admin/send_auto_emails.php

e.g. if you want it to run every morning at 7 am, just enter
0 7 * * * /usr/bin/php /[path-to-installation-directory]/admin/send_auto_emails.php


Step 6: IPN set-up


Since you are getting the turbo version, this no further input on IPN is required on your part. As long as your paypal/stormpay emails are working, you should be ready to go.


 

 

Customizing the templates

All the templates are at /html folder. We recommend that when you first install JV Firesale Automator, open header.html and edit the paths to the header image, background image and CSS. You might want to replace the images as well.

Then just log into admin panel, choose the settings you want, and edit the relevant templates.

We recommend you get a header graphic and background and simply replace the default ones with yours.

The JV script runs this way

1: http://[your-installation-path]/go/id

  • If you select to sign up members, this page will display salespage template and template with signup form at bottom
  • If you select to sell products in your JV, this page will display salespage template and the template with order buttons at the bottom. After they pay they'll then access the sign-up form

2: http://[your-installation-path]/jv/go/id

  • This form signs up JV Partners

Extra tips:

I don't like the way this software looks like, how do I change it?

You can easily change the entire look and feel of the software. To do that, you just change the html files located inside the "html" folder. For your convenience, below is a list of all the files in the HTML folder, as well as what they do.
What to do:
  • Add Graphics to the interface.
  • Change headings, text, etc.
  • Add a stylesheet, javascript code.
  • Change fonts, colors, etc.

What NOT to do:

  • Change file or directory names.
  • Change the "name" attribute of textboxes, or any other fields in the forms.
  • Change the "method" or "action" attribute of the forms.
  • Change the actual files that are linked to, e.g if there is a link called: <a href="admin/firesale.php?cmd=add"> Add New </a> you can feel free to change the "Add new" part, but mess with the "admin/firesale.php?cmd=add" and you have just screwed up!
  • Change the "value" attributes of textboxes that have PHP code in them, unless you are sure you aren't happy with what is displayed in them right now (when the script calls them).
  • Change pretty much any Php code in the html files.
List of HTML files, and what they do:
NOTE: this list is in alphabetical order of the file names.
File Name/Path: Purpose:
activation_email_resend_form.html This small form is displayed whenever someone requests the 'Account Activation Email' to be resent to them. The text box is often automatically filled in with the email address.
activation_email_resent.html This message is displayed when the activation email has been successfully emailed. You can edit this file and change the message displayed.
after.html If someone goes to yourwebite.com/go/id/ after the 'Jv End Date' for your script has been passed, this message is displayed on top of payment buttons/ sign up form.
before.html Same thing as after.html, except its displayed if your Jv Start Date hasn't arrived yet.
footer.html This small message is displayed at the end of (almost) each script. A great place for adding a copyright/disclaimer/any other legal crap!
forgotpass_form.html This form is displayed whenever someone clicks at a 'Forgot my password' link.
forgotpass_success.html If a forgotten password email was successfully sent, this message is displayed to the user.
header.html This is displayed on top of (almost) each page in the script. What better place to add your website's logo, and navigation links!
homepage.html This page is displayed on this script's main page (index.php).
login_form.html If someone tries to access a members only link, or simply clicks a 'Login' link, this form is displayed to him.
payment2.html After a customer makes his first Split payment, he is returned to this page. Paypal and Stormpay buttons are displayed after this page has been displayed automatically.
product.html This is your main sales letter.
register_form.html This form is displayed when a new member is signing up.
registration_success.html If a registration was successful, this form is displayed.
teaser.html Just a sample teaser :)
teaser2.html Another sample teaser
template_main.html This page is displayed on top of your registration form / payment buttons. You can put some introduction about your website here.
admin/autoemails.html This page is for displaying all the auto emails in your admin area, as well as provide links to edit/delete them.
admin/autoemails_add.html This page is displayed when a 'Add new autoemail' link was clicked at.
admin/autoemails_edit.html This page is displayed when an 'Edit' link next to an auto email was clicked at.
admin/contest.html Here the content settings are displayed and can be edited.
admin/downloads.html Displays all of the downloads offered in the Members area, as well as links to edit/delete them.
admin/downloads_add.html Used for adding a new download.
admin/downloads_edit.html Used for editing a download.
admin/firesale.html Displays all firesales, as well as some payment settings.
admin/firesale_add.html Used for adding a FireSale.
admin/firesale_edit.html Used for editing a FireSale.
admin/gifts.html Here ALL gifts in the database are displayed. The admin can change their statuses, and delete them too.
admin/header.html It contains the navigation links for the Admin area, and its showed on top of all pages in the admin area.
admin/jvlist.html Shows a list of all the JV partners in the database, and offers links to delete and downgrade them to normal members.
admin/mass_email.html This form is used for sending a mass email to all members in the database.
admin/mass_email_success.html If a mass email was sent successfully, this file is displayed.
admin/memberslist.html Shows a list of all the normal members in the database (excluding the JV partners) and offers links to delete them, upgrade to JV partners, etc.
admin/register_form.html Used for adding a new member when a member clicks the 'Add member' link.
admin/search.html Search the members in the database using this form!
admin/search_results.html Shows the results of a search.
admin/settings.html It displays all of the settings in the admin area. Settings can be changed, and updated using this form.
admin/settings_emails.html Used for editing the emails displayed on the 'Invite a friend' page.
admin/teasers.html Shows all the teasers in the database.
admin/teasers_add.html Used for adding a new teaser.
admin/teasers_edit.html Used for editing new teaser.
jv/header.html Contains all of the navigation links for the 'Jv Partner's Area' and its displayed on top of each page in the Jv Partner's Area.
jv/home.html This page is displayed in the JV partner Area's Home.
jv/invite_success.html If an 'Invite a friend' email was successfully displayed, this page is displayed.
jv/inviteform.html This form is displayed whenever someone clicks at the 'Invite a friend' link. The emails displayed can be changed from the Emails page in the admin area.
jv/mygifts.html Displayed when a 'Manage your gifts' link is clicked at.
jv/mygifts_success.html Displayed when a gift is successfully updated.
members/earn.html This page is displayed both when someone clicks a 'Earn Money' link in the members area, and 'Promote' link in the JV partner area.
members/getdownloads.html Displays all the downloads submitted by the Admin.
members/header.html This page is displayed on top of all other pages in the members area. Contains the navigation links.
members/home.html Displayed in the Members Area homepage.
members/profile_form.html Used for editing a member's profile.
members/profile_success.html This message is displayed when a member's profile was successfully updated.
members/showgifts.html Displayed when a 'Get gifts' link is clicked at.

 

Links in admin Panel

  1. Settings - Main program settings
  2. Member list
  3. JV Partner List
  4. Search
  5. Add Member
  6. Mass Email - You can email all members, JV Partners or everyone from here
  7. Edit Emails - These are the emails that appear in the JV Partner area "Promote" and member area "Earn Money"
  8. Automate JV Partners Email - Set automated emails from here. You must set a cron job for this feature to work!
  9. Manage Gifts - Approve/disapprove gifts. Approved gift sends an email that their gift has been approved
  10. Manage Downloads - This is the place where you add new downloads that will appear in the download page, e.g. if you are running a firesale with multiple downloads
  11. Firesales/Payment Set Up - From this menu you must enter when your JV starts and ends, and if you'll be selling products.
    You must enter the price for each day of the firesale!
  12. Manage Teasers - allows you to add your teaser pages that appear just when a member logs in
  13. Manage Contests - Add the beginning/ending day and prizes. Contest information is only displyed on member's area after it starts