Intro

E-commerce Site Kit-1.5 is a database-driven CMS (Content Management System) for building and managing e-commerce websites. It`s designed for users who would like to have their own fully functional automated website for representing and selling any intangible and tangible goods online.

Operating of E-commerce Site Kit doesn`t require any programming skills. Any computer-literate person can build and manage his/her own totally independent e-commerce website using E-commerce Site Kit in a very short period of time.

In this Manual we will show you how to build and manage your very own professionally designed e-commerce website.

Installation

E-commerce Site Kit works on real web servers only, it will not work on your local computer. You have to have a website in order to install E-commerce Site Kit. Also you have to have a Business PayPal account to sell your products online. If you don`t have it yet please visit PayPal and sign up. Signing up with PayPal is easy and FREE!

Before you proceed with installation please make sure that you have a web-hosting account with all necessary features according to E-commerce Site Kit`s Server Requirements.

Server Requirements

Majority of web-hosting companies have all these Server Requirements set up by default for their clients, but you better verify it before proceeding with installation:
  1. Apache web server - E-commerce Site Kit won`t work with IIS or other web servers.
  2. PHP 4.4.8 - Your web server must have PHP 4.4.8 or greater, with 5.2.14 being highly recommended.
  3. Zend Optimizer - version 2.1.0 or newer.
  4. If your server runs PHP 5.3 or greater, please make sure it has Zend Loader 3.3 or greater.
  5. MySQL database - Your web server must be setup to allow database access. MySQL 4 or later required. MySQL 4.1 is highly recommended.
  6. Access to CPanel (or some other web-hosting Control Panel like Ensim, Plesk etc.) - you need this to set up a blank database with database user and password.
  7. ImageMagick - software suite for automatic image processing.
  8. mod_rewrite - Apache Web server module required to generate Search Engine Friendly URLs.
  9. FTP Access - You will be transferring files from your local computer to your website, so you will need some "File Transfer Protocol" client software.
  10. Write Access - You should have permission to make files and directories writable on your web-hosting account.

Pre-Installation Setup

  1. Create a blank MySQL database, database user and database password using web-hosting Control Panel database tools.
  2. E-commerce Site Kit package contains 2 folders with different installators: folder zo for PHP4.4.8 - PHP5.2.14 and folder zl for PHP5.3 or greater. If you don't know what version of PHP you have on your server, upload folder test using FTP's binary mode to the root of your website. Then type in the address bar of your browser: http://www.yourWebsite.com/test (with your actual domain instead of yourWebsite.com) and you will see which installator of E-commerce Site Kit you have to use from the package.
  3. Upload all files and folders of the corresponding installtor's folder (zo or zl) from the E-commerce Site Kit package to the root of your website using FTP client or File Manager of your web-hosting`s Control Panel.
    Important: if you uploading files via FTP please make sure that index.php and all php files from the folders admin, lib, app/controllers, app/models and app/vendors uploaded in binary mode.
  4. Set write permissions (CHMOD 777) to the following folders: categoryimages, feeds, productfiles, productimages, includes\images.
  5. Set write permissions (CHMOD 666) to the following files: _dbconfig.php, feeds/gbase.txt, feeds/rss.xml, includes/css/store.css.

Installation Procedure

Skip this paragraph if you upgrading E-commerce Site Kit to the newer version from the upgrade package.
Type in the address bar of your browser: http://www.yourWebsite.com/install (with your actual domain instead of yourWebsite.com) and press "Enter" on your keyboard.

Post-installation

Settings

Admin Account

When logged in Admin Panel of E-commerce Site Kit for the first time please click on "Settings" and change Admin Account credentials:

Customer Support

Download Manager

Layout

Here you can set up the identity of your website and customize its layout.

Navigation

Tax Calculation

Content

All changes that you may made in the described above fields will be applied only after pressing Update button.

 

Pages

Table of Static Pages shows all pages available on the site, their status and actions to manage them. Use icon buttons in the Column Action to manage your pages: Column Page Name shows clickable names of your pages. If click one or - it opens the Page Editor. Also you can open Page Editor by clicking on Add Add icon.

Page Editor

Using Page Editor you can create and edit static pages of your website.

Categories

Table of Categories shows all categories of your products, their relations and actions to manage them. Use icon buttons in the Column Action to manage your categories: Column Name shows clickable names of your categories. If click one - it opens the Category Editor. Also you can open Category Editor by clicking on Add Add icon.

Category Editor

Using Category Editor you can create, edit and manage category tree of your products.

Manufacturers

Table Manufacturers shows the list of brands of your products. If you are going to sell your products please put your company name as a manufacturer by clicking on Add Add icon. It is necessary to have at least one manufacturer, because it`s mandatory field of Yahoo and Google Base data feeds. Adding a manufacturer is simple and pretty straightforward.

 

Products

Product List page shows product search engine, catalog of your products, their SKUs, URLs,  Names, Price, visibility status and Delete-Delete icon. You can sort products by their SKUs Names and Prices by clicking on the column titles. Also you can search catalog of your products by keywords using Find Product search engine.
 
Column SKU shows clickable product codes. If click one - it opens the Product Editor. Also you can open Product Editor by clicking on Add Add icon.

Product Editor

Using Product Editor you can create and edit product pages.

Featured Products

Featured Products - is a table of products that you previously selected as featured in the Product Editor. If click on a particular product in the SKU column - it will open this product in the Product Editor. Here is a JavaScript code to display the List of Featured Products on any page of your website:

If you want to display your featured products as a separate HTML page use the following link: http://www.yourDomain.com/category/home

Options

Product Options table shows list of your option sets.  
Column Name shows clickable option names. If click one - it opens the Product Options Editor. Also you can open Product Options Editor by clicking on Add Add icon.

Product Options Editor

Product Flags

Product Flags is a powerful feature that allows to create groups of your products (e.g.: "On Sale"), then flag some of your products and display them anywhere on your website by inserting automatically generated JavaScript code into HTML of E-commerce Site Kit templates or directly into the content of your pages.
Product Flags table shows the list of your Product Flags.

Product Flag Editor

Bulk Import of Products

Bulk Import of Products is a powerful tool that allows to import database your products in CSV format to the databse of E-commerce Site Kit.
Before you begin uploading please prepare CSV file according to the following requirements:
  1. Products must be listed in CSV format
  2. The first row contains column names for mapping
  3. Required columns:
    • Product SKU (unique product identifier)
    • Product URL (without ".htm", unique)
    • Manufacturer ID
    • Product name
    • Product price
    • Product Options ID
    • Type of Product:
      • 0 for intangible (downloadable) products
      • 1 for tangible products
      • 2 for intangible (e.g.: licenses) products
  4. Optional columns:
    • Product description
    • Keyword metatag for product page
    • Description metatag for product page
    • Product shipping cost
    • Product quantity (if product quantity is not set product will be "Out of Stock")
    • Featured Product (0=no, 1=yes)
    • Visible (0=no, 1=yes)
    • Downloadable Content filename
    • Product Category ID
    • Product Image filename
  5. Product Category ID must match your existing category map
  6. Manufacturer ID must match your existing manufacturer list
  7. Product Options ID must match your existing options list
Important: before you begin uploading your CSV file you have to: When you're ready to upload your CSV file just click on the "Begin Upload" button.
On the next page Step 1: Upload file click on "Browse" to select your prepared CSV file on your computer and upload it.
On the next page Step 2: Map Columns you have to map columns of your CSV file with actual columns of the Product Table of E-commerce Site Kit database. Then click "Upload" button.
If you did everything right your products will be successfully imported to the E-commerce Site Kit database.

Orders

Product table shows orders search engine and list of your orders, their Number, Date,  Amount, Status and Transaction number. You can sort orders by their Number, Date, Amount and Status by clicking on the column titles. Also you can search for some order by its number using Find Order search engine.
If you wish to delete some orders, just put corresponding checkmarks and press Delete Selected button.
Column Order# shows clickable product numbers. If click one - it opens the Order Details page.

Order Details

Order Details Table shows list of ordered products their SKUs, Names, Quantities, Prices, Shipping fees and Total amount.
Customer Info Table shows Customer's IP, Billing Address, E-mail Address and Shipping Address.
Order Comments shows comments left by a customer along with his/her order.
Order Status - here you can manage the status of the order: Transaction shows a transaction number of the order.

Discounts

Discounts table shows list of your discounts, their Edit link, their corresponding properties and Delete icon. If you click on the Edit link of some corresponding discount or Add Add icon, it will open Discount Editor form with the following fields: Click on "Add" button to save the changes.

Coupons

Coupons table shows list of your Coupons, their Coupon Code (Edit link), their corresponding properties and Delete icon. If you click on the Coupon Code link of some corresponding discount or Add Add icon, it will open Coupon Editor form with the following fields: Click on "Add" button to save the changes.

Shipping Options

Shipping Options table shows list of your Shipping Options, their Name (Edit link), Cost and Delete icon. If you click on the Name link or Add Add icon, it will open Shipping Options Editor form with the following fields: Click on "Add" button to save the changes.

Payment Systems

Payment Systems - is a table of available payment gateways. In the current version of E-commerce Site Kit only PayPal is supported. Currently only PayPal provides reliable API system to control payments in the real time to sell intangible products with automatic immediate delivery to customers via direct download from the site.
You have to have a Business PayPal account to sell your products online. If you don`t have it yet please visit PayPal and sign up.

If you click on PayPal in the column Name it opens PayPal Settings page:

Important: you must have PayPal Business or PayPal Premium account to use PayPal with E-commerce Site Kit.

Data Feeds

Here you can generate the following data feeds:

Newsletters

Newsletters table shows list of your newsletters that you sent or going to send to your customers and/or subscribers.
Column Title (click to edit) shows clickable newsletter names. If click one - it opens the Newsletter Editor. Also you can open Newsletter Editor by clicking on Add Add icon.
Column Status shows the status of the current newsletter.
Column Delete shows the delete Delete icons that can remove the newsletter from the list.

Newsletter Editor

Using Newsletter Editor you can create, edit and manage your newsletters. When you click on "Send" button it opens the new page:

Check and Send Newsletter

Test Newsletter - click on "Send Test" to send a newsletter to adman's email address.
Send Newsletter - click on "Send" to send a newsletter to your customers or to subscribers.

Subscribers

Here you can search for some particular subscriber using Find Subscriber search engine.
Subscribers table shows list of your newsletters subscribers.

Customization

Customizing design and layout of the site built with E-commerce Site Kit required basic knowledge of HTML/XHTML, CSS and computer graphic software such as Photoshop, Paint Shop, Photo-Paint etc.
Most of design modifications can be done by editing Style Sheet CSS file using Style Editor of the Settings section. You can also edit style sheet file using Adobe Dreamweaver or any other similar software, e.g. TopStyle Pro. You can also keep several design themes by using different CSS files and switching between them in Website Style field of the Settings section.
If you need to change some wording used in E-commerce Site Kit you can do it by editing PHP template files located in the "app/views/" folder. Here is a table of files that you can modify to customize an appearance of your website:

Location Description
/includes/css/store.css Main style sheet file of the site
/includes/css/editor.css Style sheet file with styles used in pull-down menu Styles of HTML Editor
/includes/images/ Folder with images used on the site
/app/views/_layout_default.tpl.php Main layout template
/app/views/_layout_checkout.tpl.php Main shopping cart checkout template
/app/views/404.tpl.php 404 error (file is not found) template
/app/views/category/display.tpl.php Main template for browsing of categories
/app/views/category/featured.tpl.php Featured Products JavaScript template
/app/views/category/home.tpl.php Featured Products HTML Page template
/app/views/category/flagjs.tpl.php Featured Products JavaScript template
/app/views/category/flag.tpl.php Featured Products HTML Page template
/app/views/category/search.tpl.php Search results template
/app/views/checkout/cart.tpl.php Shopping Cart template
/app/views/checkout/checkout.tpl.php Checkout template
/app/views/checkout/pay.tpl.php Processing Payment template
/app/views/checkout/thankyou.tpl.php "Thank you for your order" template
/app/views/download/order.tpl.php Download page template
/app/views/download/error.tpl.php "Order is not found" template
/app/views/email/order_confirmation.tpl.php Order confirmation email message to customer
/app/views/email/order_confirmation_admin.tpl.php Order confirmation email message to admin
/app/views/email/paypal_ipn.tpl.php Email message to customer with Download link
/app/views/email/newsletter_subscribe_active.tpl.php Email message to newsletter subscriber
/app/views/email/newsletter_subscribe_confirm.tpl.php Confirmation email message to newsletter subscriber
/app/views/email/newsletter_unsubscribe_confirm.tpl.php Confirmation email message of newsletter unsubscription
/app/views/newsletter/index.tpl.php Newsletter Welcome Page template
/app/views/newsletter/subscribe.tpl.php Newsletter Subscription Form template
/app/views/newsletter/unsubscribe.tpl.php Newsletter un-Subscription Form template
/app/views/forms/contactus.tpl.php Contact Us form template
/app/views/forms/thankyou.tpl.php Contact Us form "Thank you" template
/app/views/layout/menu_static.tpl.php Top and bottom menu template
/app/views/payment/cancel_paypal.tpl.php Template of the page where customer is sent from PayPal if payment was canceled
/app/views/product/display.tpl.php Product page template
/app/views/admin/ Folder with templates used in Admin Panel

Tips

If you have any questions or suggestions regarding exploitation of E-commerce Site Kit please do not hesitate to contact us.
© SitesOutlet 2011