EXT: Multishop

Extension Key: multishop

Language: en

Version: 2.0.8

Keywords: multishop, typo3 shop, typo3 web shop

Copyright 2010-2011, Bas van Beek, BVB Media BV (bvbmedia@gmail.com)

Official TYPO3 Multishop web site: http://www.typo3multishop.com/

PDF version of the manual: http://www.typo3multishop.com/fileadmin/user_upload/documents/manual.pdf

This document is published under the Open Content License

available from http://www.opencontent.org/opl.shtml

The content of this document is related to TYPO3

- a GNU/GPL CMS/Framework available from www.typo3.org

Table of Contents

EXT: Multishop	1

Introduction	3

What does it do?	3

Installation requirements	4

Installation instructions	5

F.A.Q.	10

TYPO3 Multishop Support	12

Help TYPO3 Multishop	13

Introduction

What does it do?

TYPO3 Multishop is the most feature rich web shop solution for TYPO3. The maintenance of the catalog happens completely in the front of the web site. This makes it very easy for the merchant to update the catalog and gives a real time view of what is being changed and how the customer would look at it.

The merchant can easily drag & drop categories, products and even navigation menu items. Because of this and many other features deep knowledge about web development and TYPO3 isn't necessary.

Multishop works with a settings database that contains definitions about which modules should be activated and how they should work. These settings can be defined globally and the developer can even change them by TypoScript, categories and even by products. This makes it very easy to adjust settings on specific spots, without doing any real web development. This gives the web developer full control and maximum flexibility.

Importing lots of products from Excel is possible with just a few mouse clicks, since TYPO3 Multishop provides a swish knife for importing many types of product feeds. Supported formats are: XML, CSV and Excel ('97 format). When importing products that contain images they get downloaded and resized to thumbnails.

Because the implementation of a payment service provider can be a challenge and is time consuming TYPO3 Multishop provides most important payment service providers straight out of the box. For an up to date list of supported payment service providers you can check the following web page:

http://www.typo3multishop.com/payment-service-providers/

Last but not least... TYPO3 Multishop supports multiple catalogs within the same page tree. This gives the possibility to maintain several web shops in one single TYPO3 installation.

For real world examples check the following web page:

http://www.typo3multishop.com/live-shops/

Installation requirements

To run Multishop properly on your TYPO3 web site make sure that:

Your web server is running PHP 5

The PHP memory limit is higher than 30MB. 75MB is recommended.

CURL is enabled, which is required by some payment service providers

SimpleXML module is enabled for reading XML as object

If you run your TYPO3 web site on a shared host and you are not able to adjust the server settings you can try to add the following lines to the .htaccess file that is located in the root folder of the web site:

php_value upload_max_filesize 25M

php_value post_max_size 25M

php_value max_execution_time 200

php_value max_input_time 200

Installation instructions

TYPO3 Multishop works intensively with jQuery. Because of this we decided to depend Multishop on the great extensions T3jQuery and rzcolorbox (developed by Jürgen Furrer). T3jQuery is providing jQuery. This makes it possible to run many plugins that needs jQuery without loading jQuery double. Also it's possible to update jQuery without having to change Multishop.

Make sure you install and configure them properly or else Multishop won't work well.

Configuring the extension T3jQuery

After you have installed the plugin go to the extension manager and press the plugin T3jQuery to configure it. We suggest to configure it as follows:

“Always integrate jQuery”: enable this checkbox

“jQuery Version”: select 1.6.x (or later)

“jQuery Version”: select 1.8.x (or later)

“jQuery TOOLS Version”: select 1.2.x (or later)

Don't enable the checkbox “Integrate jQuery to footer” cause Multishop also provides JavaScript that must be loaded after the jQuery library.

Now press Update to save the configuration.

Configuring components T3jQuery

Now you have to configure which components of jQuery should be loaded. At the left panel of TYPO3 press on the menu item “T3 jQuery”.

On the top right there is a dropdown menu. Change the selection to: “Process & Analyze t3jquery.txt in extensions”.

Press “Select all” to select all extensions and then press “Check”.

Now the list of jQuery components will be displayed. Browse to the bottom of the page and press “Use”.

The required components are now automatically selected. Browse to the bottom of the page and press “Create jQuery Library”.

Front-end Login

In our example we have used the page tree that is shipped inside the introduction package of TYPO3. This is a very suitable setup for testing purposes and for explaining how to integrate Multishop to your web site. In this package the FE login is already configured meaning you can login as front-end user in the web site itself. This is required by Multishop to be able to manage the catalog.

Note: you are not allowed to use the template that ships with the TYPO3 introduction package for commercial purposes.

Because Multishop needs to know to which usergroup administration permissions should be granted we need to create a new usergroup. Also we will create a admin user that is member of the created admin usergroup.

Adding front-end admin usergroup

At the left panel press

Click the following page

Click to create a new usergroup

In the “Group Title” field define: Admin users

Click to save the usergroup and to go back to previous screen

Hover your mouse over the usergroup to see the id number. Write it down, cause we will need to define this number later when configuring the TYPO3 template constants field.

Adding front-end admin user

Click to add a new username

In the “Username” and “Password” field define your desired user credentials

In the Groups form (Available Items) click the Admin usergroup

Click to save the username and to go back to previous screen

Creating the web shop page

First we need to create a new page that contains the web shop. This is a page that is a sub page of the root page. In our case we called it Multishop as you can see on the right side of this page. If you hover your mouse on the page name you will see the id number.

Write the number down, cause we will need it later when configuring the constants of the TYPO3 template.

Now the page is created it's time to add a content element on the middle column that will display the shop. We call this the “Core Shop” content element.

At the left panel press “Page”

Click on the page “Multishop”

In the middle column press

Click the tab “Plugins”

Choose “Multishop”

Press the tab “Multishop”

Now you see the Multishop Flexform. On default the form activated the first tab which is “Module”. This section tells which type of content element you want to add.

In “Choose section” select “Core Shop”.

Click to save the content element

Is it really that simple? The answer is: yes! Because the rest of the required configuration is defined through the constants field of your TYPO3 template.

Including the static templates

We arrived at the last step of the setup, which is one of the most important things to do. Configuring the TYPO3 templates by including the required static templates!

We need to include two static templates. One for the root of the web site. The other one that is saved on the web shop page itself.

Web shop page

At the left panel press “Template”

Click on the page “Multishop”

Click on “Edit the whole template record”

Press the tab “Includes”

Inside “Include static (from extensions)” add the static template “Multishop Core Page Setup (multishop)”

Press to save your changes

Root page

Normally we include the static template to the root page of the page tree, but since the new introduction package splited the static templates in sections it's better to include the Multishop static template to the extension_configuration section.

At the left panel press “Template”

Click on the page “extension_configuration”

Click on “Edit the whole template record”

Press the tab “Includes”

Inside “Include static (from extensions)” add the following static templates:

Multishop Root Page Setup (multishop)

4.5 jQuery ColorBox Base for t3jquery

jQuery ColorBox Style 1 (or any other style that you prefer)

Press to save your changes

Configuring the TYPO3 template

At the left panel press “Template”

Click on the page “extension_configuration”

In the third frame of the TYPO3 admin panel on top press the dropdown menu and select “Constant Editor”

After the “Category” label open the dropdown menu and select: “PLUGIN.MULTISHOP”

Now you see a form with all the Multishop constants that makes Multishop run properly. We explain the required constants:

plugin.multishop.shop_pid
This constant tells Multishop where the products are saved to. This number is also used to create the deeplinks inside the shop. This should reflect the id of the “Core Shop” page, which is in our case the page “Multishop”.

plugin.multishop.fe_customer_usergroup
The id number of the customers usergroup. When Multishop has to create a new customer (fe_user) the user will be made member of this usergroup.

plugin.multishop.fe_customer_pid
The id number of the page that contains the front-end users and usergroups. In the introduction it's the id of the page “Frontend users and groups”.

plugin.multishop.fe_admin_usergroup
The id number of the admin usergroup. Members of the admin usergroup will see the Multishop admin panel and are able to manage the catalog.

plugin.multishop.fe_rootadmin_usergroup
The id number of the rootadmin usergroup. Members of the rootadmin usergroup have the ability to clear the whole catalog with just one single mouse click. Not really the right permission for “normal” admin users. This usergroup is meant for the the developer.

More details about all the other constants will follow shortly.

F.A.Q.

The admin panel is not showing in the front.

First of all make sure you are logged in with your front-end username and that this user is member of the admin usergroup. In the TYPO3 template the constants field “plugin.multishop.fe_admin_usergroup” should contain the id number of the admin usergroup.

If this is all true than most likely you have a jQuery issue. Open FireBug in FireFox and login the front-end. Check the console for any errors. It happens a lot that developers load jQuery double cause of included plugins that ship their own jQuery library. Make sure that other plugins are configured so that they don't include their own jQuery library and validate that T3jQuery is configured properly.

I'm running my site with RealURL and when I try to edit a product I get a black popup screen.

On default the page type that Multishop uses (id 2002) is not defined in the RealURL configuration file. Open the RealURL configuration and find the key: postVarSets and configure it like:

'preVars' => array(

array(

'GETvar' => 'L',

'valueMap' => array(

'en' => '1',

),

'noMatch' => 'bypass',

),

array(

'GETvar' => 'no_cache',

'valueMap' => array(

'nc' => 1,

),

'noMatch' => 'bypass',

),

array(

'GETvar' => 'type',

'valueMap' => array(

/******* MULTISHOP BEGIN **/

//enable 2002 for multishop

'chinminshop' => 2002,

/******* MULTISHOP ends here **/

),

'noMatch' => 'bypass',

),

),

'fileName' => array(

'defaultToHTMLsuffixOnPrev' => FALSE,

/******* MULTISHOP BEGIN **/

'chinminshop.html' => array(

'keyValues' => array(

'type' => 2002,

),

),

/******* MULTISHOP ends here **/

),

More tips can be found here: http://www.typo3multishop.com/forum/list_post/site-within-site/1/

TYPO3 Multishop Support

We have published a YouTube movie where we demonstrate how to install and configure TYPO3 Multishop in less than 5 minutes. This movie can be found on the following location:

http://www.typo3multishop.com/documentation/installing-typo3-multishop/step-by-step-video/

If you have issues the best way to go is by checking the official TYPO3 Multishop Forum:

http://www.typo3multishop.com/forum/

More documentation will follow shortly. This is very time consuming and we want to do it right. So please be patient and keep on checking the official TYPO3 Multishop web site:

http://www.typo3multishop.com/welcome/

Help TYPO3 Multishop

Do you like Multishop? Share it and join us on:

http://www.facebook.com/typo3multishop

https://twitter.com/typo3multishop

http://www.linkedin.com/groups/TYPO3-Multishop-3117344

https://www.xing.com/net/typo3multishop

http://www.typo3multishop.com/forum/

You'd like to do something back for our hard work?

Send your rating to TYPO3!

Open the following location to sign in to typo.org:
https://typo3.org/community/your-account/loginlogout/

When you are successfully signed in open:
https://typo3.org/extensions/repository/view/multishop/current/rating/

At the bottom of the page you can add your rating

Your support is truly appreciated!

EXT: Multishop - multishop	Help TYPO3 Multishop

13

EXT: Multishop

multishop

multishop typo3 shop typo3 web shop

Bas van Beek

2011-11-10T23:37:46.97