TBIT DESIGN > HELPDESK > Knowledgebase

Ask a question:

How can I install the Script?


1. First, download and unzip the script file to your hard drive.

2. Using your FTP client, create a directory called MC on your webserver or hosting account. You can call the directory anything you prefer. This will be the directory that hosts your ecommerce system.

3. Go to the directory where you unzipped all the files and folders and upload all folders into the directory you created in step 2.

4. Once the upload is complete, you will have to set the following file permissions in-order for the script to run correctly:

In the folders you've uploaded, you will find a directory called connections set the permissions on this folder and all it's content to CHMOD 777
Also set CHMOD permissions --> 777 for the templates directory
Under the images directory, CHMOD permissions on the productimages folder --> 777
That‘s all you need to set for file permissions.

5. Before running the auto-installer, first you have to create a database for the system. This step will vary depending on the type of hosting panel you are using. Please consult your hosting documentation on how to create the following:

Create a new database
Create a user for the database
Link the user to the database for use by the ecommerce system

6. Run the systems autoinstaller by going to the following url address:
Replace yourdomain with your domain name, and 1MC with the directory you created in step 2 above. This will take you to the autoinstall page.

7. On the auto-install page, fill out the form fields as follows:

Hostname: localhost without the quotes. Most of the time, this value is localhost unless you know otherwise.

Database: enter the full name to the database you created in step 5 above. In cpanel, if you create mydb the server will add your domainname as a prefix to the database name, and it will look something like this: mydomain_mydb. You should enter the full name including any prefix added by the server.

Username: enter the full name of the user you created for the database in step 5 above - mydomain_mydbuser

Password: this is the password you created for the database user above.
Table Prefix: If you are not going to use a new database for the system (not recommended,) then enter the Table Prefix for the system to use for EC. Use ecom as a Table Prefix. If you are using a new database, enter here the same prefix used in the database name above. In this case, it would be: mydomain

Server Name: this SHOULD be the full url address to the directory you created in step two above: [Note: No trailing slash]

Admin Email: Your system administrative email - can be changed later from within the admin section of the script.

8. Click submit. The script will automatically email you a copy of your access links for admin, merchant,
affiliate and customer areas.

Sample Auto-Install Configuration

Here is a sample configuration, running cpanel:

Hostname: localhost
Database: 1merchantcart_1mcdemo [1mcdemo is the name you gave to the database
and 1merchantcart is the prefix added by the server - you should enter the full name]
Username: cart_1merchantcart
Password: xxxxxxx
Table prefix: ecom
Server Name: [1MC is the name of the directory you created in step 2 of the instructions above - Note: No trailing slashes]
Admin: [email protected]


1) Autoresponder module
command: 0 0 * * * [root_path]/campaign/campaign.launched.php

2) Sales Report module
command: 0 0 * * * [root_path]/merchant/merchant.sales_report.php
Above are the two tasks that need to be entered. The root_path should be replaced by your server root path. (For example: /home/username/htdocs or /home/www/public_html)

Login Details

The autoinstaller will automatically create the admin section for you from where you can handle all the administrative sections. It will also create one merchant, affiliate and buyer account for you.
Below you will see sample login details for all sections:

Admin Section
Username: admin
Password: admin

Merchant Section
Username: merchant
Password: merchant

Affiliate Section
Username: affiliate
Password: affiliate

Buyer Section
Username: Your Email Address
Password: buyer

Email Subscription Settings

The way email subscriptions work is by setting up a catch-all email address in your hosting panel, and then placing a special .forward file in the directory of the email you created under in your web space.
However for this to work, your hosting provider must have the feature which allows incoming emails to be piped through to a script or program.

If you are not sure whether your host provides this or not (most do) ask your system administrator of host provider. This is required for the autoresponder to accept subscriptions by email.

Login to your host control panel, and go to your mail settings area. Create a new email account and set it to be your catch-all email address.

Using your ftp client, login to your webspace and take note of where the server placed the directory for the email account you just created. Every email account you create gets a corrosponding
directory in the same name created in your webspace.

Then open notepad, or your favorite text editor and create a new file. Enter the code provided by the system in the admin area for sendmail or Exim/Qmail, depending on which system your server uses. Most of the time the code is the one provided for sendmail - unless you know otherwise.

Save the file as forward.txt and upload it to the email directory you made note of in step 2 above.

Using your ftp client, right-click on the forward.txt file you have uploaded, and choose rename from the menu options.
Rename the file from forward.txt to forward - removing the .txt ending and adding the period at the beginning of the name.

That's it, now all incoming emails, to whatwever usernames that do not exist on your server (but created and used by 1MC) will be caught by the catch-all email account, which has the forwarding file in there to pass it to 1MC to handle.

**Note: If you get a message saying something about overwriting an existing .forward file, click NO. This will usually be the case if you set you master account as the catch-all email address and try placing the .forward file in your public directory - it means that you already have a .forward file in your public directory used by the server, which you do NOT want to overwrite.

cPanel Notice:

If you are using cpanel, you can create an email forwarder and in the forwarding field you enter the path to the email parser script, which is the file EC uses to handle incoming email.
For example, if the autoresponder name is [email protected], in cpanel you would create a forwarder called [email protected] and in the the forwading field, enter:
This will work on most cpanels and it should work on other platforms. You would only need to create the forwarder and not a real email account.

The one thing with this approach is you would have to create a forwarder for each autoresponder. Hence the catch-all idea of having one account monitor all incoming email and routing it

The one other known way, which is sometimes used with exim and qmail is by using an alias,
however you have to have root access (access to your /etc folder) where you can set the parameters in the .qmail file or change your exim config settings.

Article details
Article ID: 11
Category: 1MerchantCart Script
Date added: 2011-09-21 01:42:17
Views: 1252

<< Go back