Php-MultiShop :: documentation

Documentation

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:

through the web installer interface: go to the 'install' folder via web and follow the instructions:
http://your-webportal.com/install/
After the installation, delete the folder 'install' from your server.
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:
  http://your-webportal.com/admin.php

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

[top]

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:

http://your-webportal.com/shop1/install

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:

http://your-webportal.com/admin.php?op=shops

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/

[top]

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:

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
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:

upgrades-phpnuke/7.x/upgrade76-77.php
upgrades-phpnuke/7.x/upgrade77-78.php
then, copy and run these files on your server:
http://your-webportal.com/upgrade76-77.php
http://your-webportal.com/upgrade77-78.php
after, delete these files from your server.
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: http://your_web_portal.com/ (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.
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
Import DataBase
Import the new data through the file:
Php-MultiShop/Multishop_as_Addon/multishop_addon.sql
For example, if your DB is named 'nuke' (*):
mysql nuke < multishop_addon.sql
(*) with the proper permissions: user and password
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:
http://www.your-webportal.com/install-addon.php
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

[top]

Upgrade

How to upgrade Php-MultiShop:

Backup.
First all, is STRONGLY RECOMMENDED a backup of your DataBase and FileSystem. Important: save your existing config.php file, for example:
cp config.php config.php.old
Upgrade the PhpNuke DataBase.
To upgrade from previous PHP-Nuke versions, Select the correct upgrade-file from the 'upgrades-phpnuke/' folder. For example, to upgrade PHPNuke from 7.6 to 7.8 version, select the two files:
upgrades-phpnuke/7.x/upgrade76-77.php
upgrades-phpnuke/7.x/upgrade77-78.php
then, copy and run these files on your server:
http://your-webportal.com/upgrade76-77.php
http://your-webportal.com/upgrade77-78.php
after, delete these files from your server.
Upgrade the Php-MultiShop DataBase.
After the upgrade of PHPNuke, you must use the files included in 'Multishop_Upgrade/' folder to upgrade the Php-MultiShop DataBase. Go in 'Multishop_Upgrade/' folder, select the correct upgrade-file; copy and run this file on your sever.
For example, to upgrade Php-MultiShop from 0.7 to 0.8 version, select the file:
Multishop_Upgrade/multishop_upgrade07-08.php
Copy and run this file on your server:
http://your-webportal.com/multishop_upgrade07-08.php
after, delete this file from your server.
Upload the new package.
Copy the old configuration (from the file config.php.old created at step #1) to the config.php file of the new package.
COPY ALL THE CONTENT of 'portal/' folder on your server, without the 'portal/install' directory.
IMPORTANT: remember to REMOVE the 'portal/install' directory.
OTHER IMPORTANT NOTE: probably, some variables/constants of the old config.php file are missing in the new file: don't worry, it's right.

IMPORTANT NOTE ABOUT CURRENCIES after upgraqde, remember to check your currencies through the new function "CURRENCIES" in the Multi-Shop admin module, then update the data if necessary (for example, set the default currency).
If, after a brief testing, your portal works correctly, remove the file config.php.old