Draft:X-Cart:X-Showroom

Getting started

1. Install the X-Showroom module:
   • Installing the module
2. Make sure the installed module is active:
   • Activating the module
3. Check and adjust the module configuration settings:
   • Configuring the module
4. Try creating some interactive banners using the Showroom section of your store's back end.
   • Creating interactive banners
5. View and manage the interactive banners you have added using the Showroom section of your store's back end.
   • Managing interactive banners

Activating the module

If the module X-Showroom is installed, but not active, you can enable (activate) it.

To enable the module:

1. Go to the Modules section of your store's Admin area (Settings -> Modules).
2. In the list of your store's installed modules, locate the entry for X-Showroom.
3. Select the check box on the left of the module name.
   The module will be enabled.
   
   

Deactivating the module

It is possible to temporarily disable (deactivate) the installed X-Showroom module. Deactivation stops the module from operation, but it does not remove any settings you made to the module configuration nor clear any data that was generated during the period that the module was in operation. If you wish to completely remove all the data related to using the module, you need to uninstall it. See Uninstalling the module for more info.

To disable the module:

1. Go to the Modules section of your store's Admin area (Settings -> Modules).
2. In the list of your store's installed modules, locate the entry for X-Showroom.
3. Unselect the check box on the left of the module name.
   The module will be disabled.

Configuring the module

After installation and activation, the X-Showroom module runs with the default parameters specified in its configuration settings. If you wish, you can adjust these parameters to better suit your needs; however, it is recommended to avoid using values that are too large or too small as it may negatively affect the usability of the user interface for the store administrator.

To adjust the module configuration:

1. Go to the Modules section of your store's Admin area (Settings -> Modules).
2. In the list of your store's installed modules, locate the entry for X-Showroom and click the Configure button next to it. (The Configure button is displayed only when the module is active).
   The X-Showroom module configuration settings page opens:
   
   
   
3. Adjust the module settings as you require. Detailed information regarding the X-Showroom module configuration settings is available below.
4. Click the Apply changes button to save the changes.
   
   

The configuration settings for the X-Showroom module are as follows:

• Max thumbnail width in admin area and Max thumbnail height in admin area: These are the maximum pixel dimensions of a banner image thumbnail as displayed in the general list of uploaded banner images on the Showroom page (Content ->Showroom) in your store's Admin area:
  
  The default value for both these settings is 300 px.
  
  
• Max photo width in admin area and Max photo height in admin area: These are the maximum pixel dimensions of a banner image displayed on the Edit Photo page in the Admin area where you tag the banner image with links to specific products:
  
  The default value for both these settings is 820 px.
  
  

Creating interactive banners

Creation and management of interactive banners is done in the Showroom section (Content -> Showroom).
To create a banner, complete the following steps:

1. Add an image to be used in your banner:
   1. In the Showroom section menu (the area on the right-hand side of the screen titled "In this section"), select "Add Photo".
      
      
      This opens the Add Foto page where you can add an image that will serve as the banner background against which product links will appear:
      
      
      
   2. Click the Upload button at the bottom of the page. The image upload manager dialog window will be displayed:
      
      
      
   3. Use the image upload manager to upload the image you require: Select the image from one of the three sources (File on this server, File on your local computer or File on the Internet; for details see explanation below) and click the Apply button opposite the respective section of the dialog.
      • File on this server: Use this section if the image file you require is located on the file system of the server on which your X-Cart store is installed. To use this file source: Click Browse... in the respective section of the image upload manager dialog. A new dialog window displaying the files and folders on your store's server will be displayed:
        
        
        Choose the image file you require and click Select.
      • File on your local computer: Use this section if the image file you require is located
      • File on the Internet:
2. Create a link that will point from an area inside your banner to a certain product in your store (Mark the area of the banner image that you want to be clickable, then select the product to which the link should point). Add more links if necessary.
3. Specify the pages of your store on which the banner should be displayed.
4. Click Update to save the changes.

700px

Managing interactive banners

The list of previously created interactive banners can be found on the Showroom page (Content -> Showroom).