Free Software for a Virtual Mall: CMS & e-Commerce Multi-Store


This page provides some basical intructions about the installation of the platform; for further problems, doubt, questions ..., you can post or read some topics on the Forums of this project.

Php-MultiShop can be installed on any server where a web server with PHP has been installed on and has access to a MySQL database server.
This includes shared servers, dedicated servers, and even locally on the computer you are currently using, using Linux, Unix, BSD, Mac OS X, and Microsoft Windows operating systems.

You can make a full installation (first the portal-side, after the store-side) or, if already you have a PhpNuke portal, you can install Php-MultiShop as Add-on. In facts, Php-MultiShop works as Add-on on PhpNuke.

The DB of the platform is unique, it's the same for the CMS and the stores, with the following structure:
  • the portal table names start with the 'portal-prefix' (for example 'nuke');
  • for each store: the table names start with the 'store-prefix', (e.g.: shop1, shop2, bookshop, jewellershop,...);
  • there are other tables without 'prefix' which are in common use, by the portal and the stores.
Portal-Side Installation
The first step is the installation of the portal.
Copy the content of 'portal/' folder where you want, for example:

mkdir /var/www/your-portal-dir
cp -R Php-MultiShop/portal/* /var/www/your-portal-dir/

There are 2 ways to install the portal:
  1. through the web installer interface: go to the 'install' folder via web and follow the instructions:

    After the installation, delete the folder 'install' from your server.
  2. manually:
    1. Create a database called, for example, nuke:

      mysqladmin create nuke

    2. Now fill the database with the tables in 'portal/install/includes/db/nuke.sql' file:

      mysql nuke < nuke.sql

    3. In order to use the ultramode.txt news file please be sure to chmod 666. This file is used to show news from your site in some old programs and frontends and is reserved to future use in PHP-Nuke. For backend use backend.php file instead.
    4. That's it!... now you need to edit the file "config.php" to set the database and other options. Please read carefully the instruction on that file! After that, you must create the Super-Administrator and set the configuration of the portal; point your browser to:

If you already have a PHPNuke portal installed, Php-MultiShop can be installes as module (Addon): go to the section Installation as Addon.


Store-Side Installation
After the installation of the portal you can install a store through the 'store/' folder of the package: copy the content of the 'store/' folder into a directory of your server, where you want, for example in 'shop1' (for example having this full path: /var/www/your-portal-dir/shop1):

mkdir /var/www/your-portal-dir/shop1
cp -R store/* /var/www/your-portal-dir/shop1/

Then, through your favourite browser, go to the web installer interface (the 'install' directory) and follow the instructions:

After the installation and configuration of your store, when a minimum quantity of content (as products, ...) is available, you can add (to link) the store to the portal: go to the portal Administration Panel, in the Multi-Shop admin module, click on Shops/Stores, then add your new store.
The Url for this operation is:

when 'admin.php' is your admin file, that you can rename for security reason, edit the config.php file.
After adding the new store, you should set some preferences and add further information by editing this store (click on 'edit' link).

Installing many stores

If you want to install other store(s), simply repeat the 'Store-Side Installation' but in other directory on your server, for example in '/var/www/your-portal-dir/shop2/':

mkdir /var/www/your-portal-dir/shop2
cp -R Php-MultiShop/store/* /var/www/your-portal-dir/shop2/


Installation as Addon
If you already have a (standard, with no changes) PhpNuke portal and you want to install Php-MultiShop as Add-on, follow the instructions below:
  1. Backup.
    First all, is STRONGLY RECOMMENDED a backup of your DataBase and FileSystem.
    Important: save also your existing config.php file, for example:

    cp config.php config.php.old

    mysqldump nuke > backup.sql (*)

    (*) if your DB is named 'nuke', use the proper permissions: user and password
  2. Upgrade the PhpNuke DataBase
    IMPORTANT NOTE: with the current version of Php-multishop (0.8), you must upgrade to PHPNuke 7.8
    (Note: PHP-Nuke version 7.9 (or successive) doesn't works on Php-multishop 0.8 !!!)
    To upgrade from previous PHP-Nuke versions, select the right upgrade-file from the 'upgrades-phpnuke/' folder. For example, to upgrade PHPNuke from 7.6 to 7.8 version, select the two files:


    then, copy and run these files on your server:

    after, delete these files from your server.
  3. Edit the new config.php file (portal/config.php)
    the new config.php file includes some new variables/constants required by Php-Multishop, like: DEFAULT_LANGUAGE, HTTP_SERVER, DIR_FS_DOCUMENT_ROOT, $lang_id, ...
    The most important are:
    1. DEFAULT_LANGUAGE: english (or german, spanish, italian, french)
    2. HTTP_SERVER: (here enter the Url of your portal)
    3. DIR_FS_DOCUMENT_ROOT: /var/www/html/ (here enter the full path of your portal on filesystem)
    You must set correctly the variables above, and you can ignore (leave unchanged) the other variables.
  4. Upload the new package on your server
    For security reasons, make a backup of your filesystem, then COPY ALL THE CONTENT of 'portal/' folder on your server, with the edited config.php file (at previous step), and without the 'portal/install' folder.
    IMPORTANT: do not copy the 'portal/install' folder.
    For example, in a unix-like filesystem:

    cp -r Php-MultiShop/portal/* /var/www/your-phpnuke-dir/

    rm -r /var/www/your-phpnuke-dir/install

    NOTE: the package includes the Security Patch 3.1 for PHPNuke
  5. Import DataBase
    Import the new data through the file:


    For example, if your DB is named 'nuke' (*):

    mysql nuke < multishop_addon.sql

    (*) with the proper permissions: user and password
  6. Run the 'install-addon.php' script
    Copy and run the 'Multishop_as_Addon/install-addon.php' file on your server, for example:

    cp Php-MultiShop/Multishop_as_Addon/install-addon.php /var/www/your-phpnuke-dir/

    then, run via web:

    Follow the instructions provided by the script and, after the regular process of installation, delete the file from the server.
It's all..., You have converted your portal in a Web Mall.
Now you can manage your multishop through the admin module 'Multi-Shop', available among the other modules in the Administration Area of your portal. Here, there are four Sections: Stores, Categories, Configuration, Currencies, and you have also a guide online within a popup window, by clicking on the image