Chapter 5. Setting Up Your Program

This chapter will step you through how to setup your program, using the Web Site Replicator. Please read through this chapter very thoroughly, and follow it while setting up your program. It may seem like a lot of extra work, but in the long run, it will save you a great deal of time. This chapter assumes that the Web Site Replicator has already been installed on your web server, and you have access to the Admin Control Panel.

This chapter explains how to setup a basic program, and does not go over concepts such as multiple program structures and commission plans, and editing the HTML templates. It is highly recommended that you first read through this chapter and setup a basic program. Once you have successfully completed all steps in this chapter, you can read Chapter 6. Advanced Setup, and learn the advanced concepts of setting up your program.


5.1 First Time Setup

Once the Web Site Replicator has been successfully installed on your server, the first thing you must do is run First Time Setup. To do this, login to your Admin Control Panel using the information which Envex Developments supplied you with.

Once you have logged into your Admin Control Panel, click on the Setup menu in the left hand side of your screen. Once the menu expands, click on First Time Setup which is the first action below the Setup menu in the left hand side of your screen.

This will bring you to the first page of First Time Setup. Simply go through all questions on this page, and continue until First Time Setup has been completed. If you need a more detailed description on any of the questions, click on the green Help button beside the needed section. This will bring up a new window, which contains a detailed description on the section.


5.2 Create Your Program Structure

Once First Time Setup has been successfully completed, you need to create your program structure, or in other words, you need to setup your downline structure and commission plan.

To start, go to the Setup->Program Settings menu of your Admin Control Panel. This will bring you to a page which contains two sections titled, Program Structures and Create Program Structure. Do not worry about the Program Structures section just yet. Instead, scroll down to the Create Program Structure section.

You must fill out this section, and create your first program structure. You should be currently looking at the following set of questions:
Create Program Structure - Part 1

The first question asks for the Program Name. You can enter any name you wish in this field. This is simply a name to identify this program structure throughout the rest of the script. If you do not know what to enter for a Program Name, enter First Program or Main Program.

The second question contains one select box, which asks for the Program Type. This select box contains two options, Forced Matrix and Network (unlimited width). Simply select if you would like the program structure to be a forced matrix, or not.

The third and fourth questions ask who many levels deep and wide you would like your program structure to be. Regardless of which Program Type you chose, you must specify how many levels deep you would like the program structure to be. For example, if you are creating a 3x5 forced matrix, you would enter 5 levels deep.

You only need to specify the levels wide if you are creating a forced matrix program structure. For example, if you are creating a 3x5 forced matrix, you would enter 3 in this field.

The next part of this section, looks like the following image:
Create Program Structure - Part 2

This part of the section asks if you would like your program structure to be a X-Up program. An X-Up program is commonly referred to as an Australian 2-Up Program. This type of program structure requires that every new member who joins your program, must recruit an X number of members before becoming a "qualified" member. The first X number of people who join from a new member's web site, will automatically be transferred to the sponsor.

Once a member has become "qualified", the member will then receive credit for everyone who joins under them. The people who join under the member will no longer be transferred to the member's sponsor.

For example, if you had a 3-Up program, when a new member joins your program, the first three people who join under the new member will automatically be transferred to the member's sponsor, and be placed in the sponsor's downline. Then, once three people have joined under the new member, the member will become a "qualified" member, and everyone else who joins under the member will be placed in the member's downline, instead of the sponsor's downline.

If you would like the program structure to be an X-Up program, simply select Yes to the question in this part of the section, and enter in how many people must join under a new member before becoming "qualified".

The last part of this section looks like:
Create Program Structure - Part 3

The type of compression you select will determine how the script deletes members from the database. The Web Site Replicator supports three different types of compression, which are explained below. If you do not know which compression type to choose, please choose Full compression.

Full compression
Full compression will fully compress your member's uplines when someone is deleted. If you are using a forced matrix program structure, member's uplines and downlines will be changed if you use Full Compression. However, this type of compression does ensure that no empty spots will ever be left in the matrix.

Commission only compression
Instead of using Full Compression, and completley compressing member's uplines, this type of compression will only compress the member's commission upline, and not the member's genealogy upline. If you use this type of compression, when a member is deleted, the script will end up leaving a blank spot in the matrix, but the maximum commission amount will still be paid out for that member.

No compression
Using no compression will not compress any uplines at all when a member is deleted. Instead, the script will leave a blank spot in the matrix, which can never be filled by a member. However, this does ensure that no downlines or uplines will change when a member is deleted. However, the maximum commission may not be paid out for every member.


5.3 Create Your Commission Plan

The next step is to create your commission plan. If your program is not going to use any commissions at all, you may skip this section of the manual and continue to 5.4 Upload Self Replicating Web Site.

To start, go to the Setup->Program Settings menu again. The program structure you just created will appear in the table in the first section of the page, titled Program Structures. You should be currently looking at something which looks like:
Create Commission Plan - Part 1

Select the one program structure which is listed in the table, and click on the Manage Commission Plans submit button. This will bring you to a new page which contains three sections. The first section simply shows information on the program structure (eg. 3x5 forced matrix). The second section will contain one blank table, and four submit buttons. You should currently be looking at an image which looks like:

Click on the Create New Commission Plan submit button. This will bring you to a new page where you can enter the commission values. The first section of this page simply describes the program structure (eg. 3x5 forced matrix).

The second section asks two questions, the name of the commission plan, and the number of days between interval commissions. You may enter any name you wish for the commission plan, and the name you enter can contain spaces and special characters. The name you enter will be used throughout the rest of the script to identify this commission plan.

The second question asks how often you would like the script to pay interval commissions. What this means is, how often would you like to pay your member's recurring commissions? For example, if you wanted to pay your member's monthly commissions, you would enter 30 in this field. Or, if you wanted to pay your members daily commissions, you would enter 1 in this field.

If you do not want to pay your member's any interval commissions, simply leave this field at 0.

The third section of this page asks for the Sign Up Commission Values. These are the commission values which are added to a new member's upline, when a new member joins your program. The below image uses an example of a 2x3 forced matrix program with two member types, Basic and Gold.
Create Commission Plan - Part 1

Let's take the above image one step at a time. The first table is titled Basic Values. When a new Basic member joins the program, the commission values inside this table will be added to the new member's upline. Using the image above, no commission will be paid out when Basic members join, so all values in this table will stay at 0.

The second and last table is titled Gold Values. When a Gold member joins the program, the commission values in this table will be added to the new member's upline. Using the above image, the three tables below show sample uplines, and how much commission will be paid out to each upline sponsor when a new Gold member joins.

Example 1:
Level Member Type Commission Added
1 Gold $15.00
2 Gold $10.00
3 Basic $3.00


Example 2:
Level Member Type Commission Added
1 Basic $5.00
2 Gold $10.00
3 Gold $5.00


Example 3:
Level Member Type Commission Added
1 Gold $15.00
2 Basic $4.00
3 Basic $3.00


The next section of this page is titled Direct Commission Values. The commission values in this section will be added to the direct sponsor of a new member. In other words, when a new member joins, the Direct Commission Values will be added to who the new member joined under. This may be different than who the new member is placed under, due to spillover in a forced matrix.

You should be looking at something which looks like:
Create Commission Plan - Part 2

The first table in this section is titled Basic Values. When a new Basic member joins, the commission values in this table will be added to the sponsor the new member joined under. Using our above example, no commission values are paid out to Basic members, so the values in this table are left at 0.

The second table is titled Gold Values. When a new Gold member joins your program, the commission values in this table will be added to the sponsor who the new member joined under. Using the above image, if a new Gold member joins under a Basic member, the sponsor will be paid $10.00 in commission, and if the new Gold member joins under a Gold member, the sponsor will receive $20.00 in commission.

The third and last section of this table is titled Interval Commission Values. The commission values in this section are added when the script adds interval commissions. For example, if you pay your member's monthly commissions, these are the commission values which will be paid out every month.

This section works exactly like the Sign Up Commission Values section. Once you have completed the table, click on the Create Commission Plan submit button to create the new commission plan. If this is the first commission plan you have created for this program structure, all members added to the program structure will be automatically assigned to this commission plan.


5.4 Upload Self Replicating Web Site

5.4.1 Upload Web Pages

You should now have your program structure and commission plan created. The next step is to upload your self replicating web site. Before starting, please read through Chapter 3.2 Setting up your web site, and make sure your web site is correctly setup for the Web Site Replicator (ie. image links have been changed appropriately).

Once you have your self replicating web site setup correctly, go to the Setup->Manage Web Site menu of the Admin Control Panel. This will bring you to a page which looks something like:
Create Commission Plan - Part 2

If your program contains multiple self replicating web sites or Member Only Areas, the names of each will be listed here. To continue, select one of the names under the Public Web Sites heading, and click on the Manage Web Site submit button.

A page will come up which shows the current contents of the web site. There are five submit buttons at the bottom of the page. Click on the Add Web Page button. This will bring up another page which allows you to upload up to ten pages from your computer. Simply click on the Browse submit button, and select a web page from your computer. Once you have selected all of the needed web pages, click on the Add Web Page submit button to upload the web pages.


5.4.2 Create Directories

If you need to create sub-directories inside your self replicating web site, go back to the Setup->Manage Web Site menu and select the web site again. Once the next page comes up, showing the contents of the web site, click on the Create Directory submit button. This will bring you to a new page which looks like:
Create Directory

Enter the name of the directory you would like to create in the provided text box, and click on the Create Directory submit button. Next, go back to the Setup->Manage Web Site menu and select the web site again. You should now be looking at a page which looks something like:
Manage Web Site

As you can see, the new directory program is now displayed in the list. To move into the directory you just created, click on the directory name (the blue letters). This will move you into the directory, where you can upload web pages exactly as you did before.


5.4.3 Validate Web Pages

If you are not sure that your web site is setup correctly for the Web Site Replicator, you may validate your web pages. To do this, go to the Setup->Manage Web Site menu of the Admin Control, and select the needed web site again. This will show the current contents of the web site. To validate a web page, select a web page from the list and click on the Validate Web Page submit button.

The script will then go through the selected web site, and perform several checks to ensure that all image and HTML links are correct. A new page will appear showing all errors which the script found in the selected web site. If wanted, you may allow the script to try and automatically fix the errors by clicking on the Fix Validation Errors submit button.

NOTE: There is no guarantee that this will fix any problems with your web pages, or update your web pages correctly. It is strongly recommended that you have a backup of the web page on your computer before allowing the script to fix any validation errors.


5.5 Generate Newuser HTML Form

The next thing you need to do is generate your newuser HTML form, and upload it to your self replicating web site. Your newuser HTML form is what allows new members to automatically join your program, by filling out a form on your self replicating web site.

To start, go to the Setup->Generate HTML Forms menu of the Admin Control Panel, and a list will come up. Select Newuser HTML Form from the list, and click on the Generate HTML Form submit button.

Another page will appear with several select boxes. If wanted, you may select the exact newuser HTML form to generate by using the provided select boxes. Then, just click on the Generate HTML Form submit button, and a page will appear with the results of the generated newuser HTML form.

Copy and paste the results to a web page, and save it on your computer (eg. join.html). Next, go to the Setup->Manage Web Site menu of your Admin Control Panel, and select your public web site from the list. Upload the newuser HTML form you just saved to your computer, to your self replicating web site.


5.6 Setup Member's Only Area

5.6.1 The Login Form

If you are using NCSA htaccess as the authentication method for the Member's Only Area, you do not need a login form. All you need to do is simply place a link on your web site to the /members_only/members_only.cgi script on your server which is probably located at:
http://www.domain.com/members_only/members_only.cgi

If you used cookie based authentication for your Member's Only Area, your members will need to login through an HTML form. To generate your login form, go to the Setup->Generate HTML Forms menu of the Admin Control Panel. When the list of HTML forms comes up, select Member's Only Area - Login Form from the list. This will automatically generate the HTML code for your login form.

Copy and paste the results to a web page, and save the web page on your computer (eg. login.html). Next, upload the login form to your web server. You can upload it anywhere on your server you wish, including your member's self replicating web sites.


5.6.2 The Home Page

The next step it to upload the home page for your Member's Only Area. Go to the Setup->Generate HTML Forms menu of the Admin Control Panel and select Member's Only Area - Home Page from the list. Copy and paste the results to a web page, and save the web page on your computer named as index.html.

Next, go to the Setup->Manage Web Site menu of the Admin Control Panel. When the list of web sites come up, select the Member's Only Area site from the list and click on the Manage Web Site submit button. Next, simply upload the index.html web page which you just saved to your computer.

NOTE: The home page for your Member's Only Area MUST be named index.html, as this is what the script defaults to for the home page.


5.6.3 Upload Additional Web Pages

You may want to upload additional web pages to your Member's Only Area (eg. informational reports for your members). To do this, upload web pages to your Member's Only Area, exactly the same way you uploaded your self replicating web site in 5.4 Upload Self Replicating Web Site. The web pages you upload to your Member's Only Area will password protected, and only member's who have logged in will be able to view them.

After you have uploaded all needed web pages to the Member's Only Area, you will need to link to them. For example, if you upload a web page named page.html, to link to this, you would place a link in your web pages to:
http://www.domain.com/members_only/members_only.cgi?authtext=~authtext~&page=page.html

See how that works? Just add &authtext=~authtext~&page=page.html after the members_only.cgi in the URL. Please note, you MUST include authtext=~authtext~& in the URL, or the script will give an Invalid Username or Password error.


5.7 Edit E-Mail Messages

The next step to setting up your program is to edit all needed e-mail messages. To do this, go to the Communicate->Edit Message menu of the Admin Control Panel. The next page that comes up will show two different sets of e-mail messages, Pre Written Messages and System Messages. Under System Messages there will be several messages. You need to edit all of the messages under this section. To do this, simply select a e-mail message from the list and click on the Edit Message submit button. This will bring you to another page where you can enter the contents of the e-mail message.


5.8 Create Your First Member

Congratulations! Your program is now fully setup. The last thing you need to do is create your first member by going to the Database->Create New Member menu of the Admin Control Panel. Simply fill out the form, and the script will replicate the member's self replicating web site.