SiteBuilder Installation Instructions (v. 2.9x)

  1. Set up your database

    Log in to your hosting account and create a new database for the system. If you're using a cPanel host, view our cPanel MySQL Database Setup to help you with this step.

  2. Download files

    Download the zip file above, and upload all folders and files from within the /files/ directory of the zip packet into the public directory of your site, following the same folder structure as presented.

  3. Run the installer

    Go to yourwebsite/setup.php to run the installer, entering the following information:

    Database Setup

    The database needs to be created on your web host before entering this information.
    • Database Host - Enter your database host
    • Database Name - Enter your database name
    • Database User Name - Enter your database user name
    • Database Password - Enter your database password
    • Database Prefix - Create a prefix for your database

    Web Site Details

    Enter your site details. We've tried to determine your site URL and path for you.
    • Web Site Name - Enter your web site name or business name
    • Email Address - Enter your email address (domain email recommended; do not use AOL or Yahoo email)
    • Web Site URL - Enter your web site URL without the http
    • Home Path - Enter your web site home path
    • Unlock Key - Enter your unlock code, if you know it. (optional)

    Site Directories

    Enter the path (relative to the main site) of the following directories:
    • Include Directory - Enter your includes directory (default - enc)
    • Action Directory - Enter your action directory (default - go)
    • Pages Directory - Enter your pages directory (default - pages)
    • Thumbnail Img Dir - Enter your thumbnail directory (default - images/thumbs)
    • Large Img Dir - Enter your large image directory (default - images/items)
    • Category Img Dir - Enter your category image directory (default - images/categories)
    • General Img Dir - Enter your general images directory (default - images)

    Store Administration

    Enter a user name and password for the general user to access the administration area.
    • Create a User Name - Create a general administrator user name
    • Create a Password - Create an admin password with upper/lower case letters & numbers
    • Admin Directory - Enter the directory of your administration area

    Shopping Cart

    Our system uses the Mals-E shopping cart. Enter your cart details below:
    • Mals Cart - Enter the cart ID (user name) and server (optional)
    • Currency - Enter the cart currency symbol and code (optional)

    Master Administration

    Master administrators can access any area of the site.
    • Create a Master Key - Create a master administrator user key (optional)
    • Master Password - Create a master password with upper/lower case letters & numbers (optional)
  4. Set up your Mals cart

    The SiteBuilder system works with the Mals-E shopping cart. Set up a free Mals account. Once your Mals cart is activated and configured, you will need to make the following changes for inventory control to work properly.

    1. Mals: Create a Mals-E cart account and set the following:

      • Cart Setup -> Advanced Settings -> Remote Call

        The HTTP call must be set up in Mals for the inventory control and order tracking to work.

        • URL: In the URL field, add website/go/finish.php (note: no http://). You can also use the direct IP address to the finish page (e.g. 123.456.789.012/~client/go/finish.php)
        • Method: Select POST for the method.
        • Debug: Do not check the debug checkbox; this is only used if you are having problems with inventory control and order tracking, and want to receive debug notices.
      • Cart Setup -> Customize -> Return Link

        Optional! A return page updates the store inventory immediately after the order is placed, if the customer clicks the 'continue' button.

        • Your website address: In this field, add website/go/return.php (note: no http://). You can also use the direct IP address to the site (e.g. 123.456.789.012/~client/go/return.php)
        • Select 'Form button with the word CONTINUE. POST request.'
          - OR -
          Select 'Form button using the text above. POST request.' and enter some text in the 'Text for the link' box.
      • Cart Setup -> Customize -> Continue shopping button

        Appending the cart content allows the continue shopping button in the cart to go back to the item you were originally viewing.

        • Select 'Hyperlink'
        • Check the box marked "Append cart content vars".
      • Cart Setup -> Email Settings -> Order Notifications

        We recommend using a domain email or gMail email address for order notifications. Mailings may not work seamlessly with free emails like AOL or Yahoo email

      • Cart Setup -> Payment Methods

        Select the payment processor or method you will use to take payments from customers. Make sure you use a processor that works with 'Remote call' in the payment processor list.

      • Cart Setup -> Payment Methods -> PayPal

        If you are using PayPal as a payment processor, enter the PayPal email and then:

        • Under 'Return link from PayPal', select the second option: 'return the customer back to the cart. See the notes below...'.
        • Select the 'IPN - Instant Payment Notification' checkbox. (If you do not, a customer can close the window and it won't post back.)
    2. PayPal: Please note that if you want to use PayPal as a payment type, you must use a business account if you want to automate inventory control or log orders and sales. Personal accounts can be used with the cart, but the inventory control and order tracking will not work!

      • My Account -> Profile -> Website Payment Preferences -> Auto Return

        If you are using PayPal as a payment type, you must turn the 'Auto Return' setting On. This automates the return back to Mals after a customer pays via PayPal. (If this setting is turned off, the cart will require the customer to push a button to go back to the cart, and not all customers will do this.)

      • My Account -> Profile -> Website Payment Preferences -> Return URL

        The Auto Return setting requires a thank you page to return to after the payment is made. Mals creates a page automatically and submits it without any effort on your part. However, if you plan to use PayPal for any other reason, you will need to make a thank you page on your site. Create the page, following PayPal's thank you page rules (shown on the auto return setting page) and enter the URL in the space provided in PayPal.
        Note: If you have a DNS glitch, try using the IP address here.

        e.g.) 123.456.789.012/~client/pages/thankyou.php

        instead of:

        website/pages/thankyou.php
    3. Site Builder: Add your Mals cart details and create a thank you page.

      • Storeadmin -> Catalog Setup -> Mals-E Cart ID

        Make sure this is set to be your Mals-E user name. It's important there are NO spaces before or after the cart ID!

      • Storeadmin -> Catalog Setup -> Mals-E Server

        Make sure this is set to be your Mals-E server. It should only be the www part (ie.ww8 or ww12, etc.)

      • Storeadmin -> Pages -> Add Page

        You only have to add a thank you page if you are using PayPal as a payment processory.

        • Create a web site page called "thankyou.php".
        • On this page, type out the following text:
          Thank you for your payment. Your transaction has been completed, and a receipt for your purchase has been emailed to you. You may log into your account at https://www.paypal.com to view details of this transaction.
          Save this page to your web site.

    Important! The system's inventory control system decreases stock counts automatically, and will discourage a customer from ordering more than is available. While we have implemented checks to decrease over ordering, we cannot guarantee that a customer will not try to change the quantity within Mals or otherwise try to order more than is available.

  5. Log in to the administration area

    Log in to your site at

    http://yoursite/storeadmin/?master=y

    User Name: Whatever you entered in the user name field in the installer.
    Password: Whatever you entered in the password field in the installer.
    Master Key: Whatever you added to the master key field in the installer.

    Entering the master key will make you a master administrator. A master administrator has access to all areas of the store admin area, and can set permissions for the store owner.

  6. Enter the unlock key

    Enter the unlock code provided to you, if you have not already done so during installation.

  7. Optional

    If desired, you can set up static pages or .htm extensions, brand the administration area, set permissions, or create custom templates:

    • Social Media Icons Add social media icons to your site.

    • Theme Colors Clients can change template area colors.

    • Instant Inventory Temporarily decrease an item's stock when a customer adds it to the cart.

    • Template Images Store administrators can see theme previews and click to select.

    • TinyMCE Editor Use TinyMCE as an alternate editor, in place of Whizzywig.

    • Image Zoom Integrate Elevate Image Zoom into your catalog images.

    • Lightbox Images Integrate Lightbox 2 popups into your catalog images.

    • Permissions Set permissions if you want to specify which administration area pages the store owner can view.

    • Custom templates: Create your own HTML templates for your clients' sites, using our custom theme builder.

    • Static pages Use links like yourwebsite.com/category_4/Jewelry.htm instead of yourwebsite.com/catalog.php?category=4

    • Using .htm or .html extensions Use links like yourwebsite.com/events.htm instead of yourwebsite.com/events.php

    • Branding Resellers may rebrand the administration area with their own information

    • Secure site Use https:// prefixes for the web site, administration area, and/or shopping cart. (Payment pages always use https://)

    • Adding Local jQuery The current release uses Google's jQuery file. If you want to use your own copy, use the above FAQ to install it.