Installation

Install using the Joomla installer. Enable the plugin in the plugin manager

Embedding the product snapshot into a Joomla Article

Use code such as the following:

{product id=23}

This will embed the product with an id number of 23 (the id number is the one in the right hand column in the column marked id in the Virtuemart product manager).

You can set default parameters in the plugin manager. These can be overridden with user parameters, the ones available are:

• id
• showAddToCart
• showQuantityControls
• showPrice
• showCaption
• showSDescription
• showDescription
• showImage
• showName
• showProductLink
• captionLength
• imageWidth
• imageHeight
• maxImages
• layout

The imageWidth, imageHeight and layout parameters are only available in the 'Pro' version of the plugin. The id parameter is compulsory, the others are optional. If used they must be separated by semi-colons and have a zero or one value in most cases:

{product id=23;showImage=1;showAddToCart=0;showDescription=1}

This will show the image and long description but not the add-to-cart button. The other parameters will take their default values as set in the plugin manager.

The imageWidth and imageHeight parameters take an integer value for the size in pixels, the layout parameter takes the values: default, thumbnails, small_thumbnails, lightbox_gallery and slideshow. For example:-

{product id=23;imageWidth=200;imageHeight=160;layout=slideshow}

Layouts

The 'pro' version of the plugin includes extra layouts. These are installed in the tmpl sub-directory of the plugin, and can be overridden by placing your own versions in the html folder of your site template.

If you wish to override the layout there are a long list of data available to your template:-

•  $list->product_id
•  $list->category_id
•  $list->product_name
•  $list->product_link - url of Virtuemart product page
•  $list->product_link_button - html for product link  button
•  $list->product_thumb_image - html for product thumb image
•  $list->product_s_desc - product short description
•  $list->price
•  $list->addtocart_link  - url to add product to cart
•  $list->addtocart_button - html for add to cart button
•  $list->images - array of small image urls
•  $list->full_images - array full image urls
•  $list->thumbnails - array of html markup for thumbnails including lightbox if appropriate
•  $list->lightbox_links - array of <a> tags for hidden lightbox links