3.2. Automatic Installation
Prev | 3. Installation | Next

mambo-phpShop

### 3.2. Automatic Installation

mambo-phpShop is a complex script. It's not component-only, but also requires a Module. So it comes to you in a file called '`mambo-phpShop_x.x_COMPLETE_PACKAGE.zip`'. This file contains various Elements for mambo-phpShop.

| Important
This file is not installable! It's contents are, but they must be unpacked first.

Package Contents:

- 1 Component (`com_phpShop_x.x.tar.gz`)

- 1 Main mambo-phpShop module (`mod_phpShop_x.x.tar.gz`)

- 6 additional Modules

- 2 Mambots (1 Search, 1 Content Mambot)

1. Unpack the file '`mambo-phpShop_x.x_COMPLETE_PACKAGE.zip`' to a local directory.

2. Log in into Mambo's Backend (using the URL ' `http://mambourl/administrator`') to access the administrative interface.

   Backend Login Screen

   You need to have the priviliges of an Administrator / Superadministrator to install Elements.

3. Click 'Components' -> 'Install/Uninstall' in the Top Menu.

   List of installed components

   In the part 'Upload new component' select the file '`com_phpShop_x.x.tar.gz`'. This is the package file which contains all files for the mambo-phpShop Component , located on your computer (see Step 1).

   Now click on 'Upload File & Install'. Since the tar.gz file is about 1 MB in size, you will have to wait a moment while the file is being uploaded to your server and unpacked.

   If the upload takes too long, try Step 4 or do the Manual Installation.

4. Alternative: You can unpack the contents of '`com_phpShop_x.x.tar.gz`' and upload those files to a remote directory using a ftp connection. Now specify the directory on the server from where you want to install the files and click 'Install'.

   | Note
   Package Files are mostly a ZIP or tar.gz compressed file directory, which includes all information for the installation. The main file is an XML document which describes the installation process. In order to use this function for your installation, your web server must support the `zlib extension`. You can check this in the Admin Section Menu item, System > System Info > System Information.

5. The mambo-phpShop Component should be installed now. You'll seethe Welcome Message Screen with some options how to go on:

   You can now choose wether you want to install some Sample Data (18 products, with attributes, in 5 categories) to see how things have to be set up.

   Or you can ' go directly to the Shop >> ' without installing Sample Data.

   | Caution
   This step again takes some time & the mambo-phpShop installer is running a lot of Database Queries now. So please be patient!

6. Click 'Modules' -> 'Install/Uninstall' in the Top Menu to proceed to the installation of the mambo-phpShop Main module.

   Choose the file '`mod_phpshop_x.x.zip`' in the File Dialog and click 'Upload File & Install'.

   Repeating this step you can install the additional modules for mambo-phpShop.

   Publishing the Module:

   Click 'Modules' -> 'Site Modules' in the Top Menu. Now browse through the list of installed modules and find the one with the name 'mambo-phpShop Module'. Select it (click on the name) and modify its settings/details. You can now choose where to put the Module on your Mambo site. For more information about modules please refer to the Mambo documentation ( http://mamboserver.com ).

   | Important
   Anywhere you place the module on your site, IT MUST BE PUBLISHED. This is because all category navigation is done via this module. So using the mambo-phpShop Component without the module is somehow 'difficult'.

7. Recommended: Mambot Installation

   Click on 'Mambots' -> 'Install/Uninstall' in the Top Menu.

   SearchBot: Performs a search on the product table and delivers search results for Mambo's site search.

   Select the file '`phpshop.searchbot_x.x.tar.gz`' and click 'Upload File & Install'.

   Mambot ProductSnapshot: Displays product figure/price/add-to-cart link in Mambo Content.

   Select the file '`mosproductsnap_x.x.tar.gz`' and click 'Upload File & Install'.

   Publishing the Mambots:

   Mambots need to be published before they do ANYTHING. Click on 'Mambots' -> 'Site Mambots' in the Top Menu. Now browse through the list of installed Mambots and find 'phpshop.searchbot' and 'mosproductsnap'. Select one (click on the name) and modify its settings/details. Remember to publish it. For more information about Mambots please refer to the Mambo documentation ( http://mamboserver.com ).

You're now done with the Installation of mambo-phpShop and its elements.

mambo-phpShop

Prev | Up | Next
3.1. Installation Procedure | Home | 3.3. Manual Installation