Virtual Store Showcase

Documentation

Virtual Store Showcase (VSS) installation how-to

By arequaldev@gmail.com

Requirements 

- Concrete5 5.5.2 or later. It has not been tested in older C5 versions, but it could work under your responsibility

WARNING: In Concrete5 5.5.2 disable Basic cache if you experience Fatal error: Block::getInstance():  

- Virtuemart 2.0.6 or later on Joomla 2.5.4 or later. 

OR

- Magento 1.7 or later

OR

- Prestashop 1.5

Installation stepsHow to install and configure Virtuemart Extension to serve data to VSS

1.- Log in Virtuemart as admin user

2.- Go to Extensions->Extension Manager->Install

3.- Click on Upload Package File->Browse, and select your com_xmldataserver VX_x.zip. Cross your fingers

4.- In the Extension Manager->Manage you can enable or disable this extension by clicking on the red or green circle

How to configure Magento to serve data to VSS

1.- Log in as admin user

2.- Go to System->Web Services->SOAP/XML-RPC Roles

3.- Add a new role with the following permissions in the "role Resources" tab

  • Catalog->Product ->Product downloable links ->List
  • Catalog->Product ->Retrieve products data
  • Catalog->Product->Allowed attributes
  • Catalog->Product->Product attributes->Get full information about attribute with list of options
  • Catalog->Product->Product attributes->Attribute Sets->List
  • Catalog->Product->Product attributes->Get list of possible attribute types
  • Catalog->Product->Product attributes->Retrieve attribute data
  • Catalog->Product->Tag->List
  • Catalog->Product->Product Images
  • Catalog->Category->Retrieve category data
  • Catalog->Category->Allowed Attributes (REST Only)
  • Catalog->Category->Retrieve categories tree
  • Catalog->Category->Assigned Products->Assign

4.- Save changes and go to System->Web Services->SOAP/XML-RPC Users

5.- Add new user. Take care of its name and API Key. These are the credentials

6.- Enroll this new user to the new role you have just added by clicking on "User role" tab and selecting the new role. Do not forget to save your changes

 

How to configure Prestashop 1.5 to serve data to VSS

1.- Log in Prestashop backend as admin user

2.- Go to Advanced Parameters->Webservice

3.- Enable PrestaShop Webservice->Yes and Save

4.- Click on "Add New"

5.- Complete these fields

  • API key (Remember this value. You will need that when you configure your VSS block )
  • Status On
  • Permissions: 
    • View(GET) -> Categories
    • View(GET) -> Products
    • View(GET) -> Images
    • View(GET) -> Currencies

 

How to install and configure Virtual Store Showcase

1.- Extract (unzip) your purchased Virtual Store Showcase package to a temporal folder

2.- Move your C5 package folder called "virtualstoreshowcase" to your Concrete5 folder "...../packages". You get a path like "/var/www/concrete5/packages/virtualstoreshocase"

3.- Log in Concrete5 as an admin user and install VSS package

4.- Deploy the VSS block on a page by editing it and adding as a new block

5.- Now you need to configure Magento, Virtuemart, etc data server component

Notes

  • If your are using Magento or Virtuemart as a server you must to remove index.php from your Magento installation. Check your documentation
  • If you can not display any category then check Concrete5 log interface. Login failures are displayed there.
  • In Magento prices must be tax included