When I load my Magento product catalog, a pop-up is displayed reading : "You must install jQuery on your website to make this extension work."

-> The pop-up is quite self-explanatory, jQuery is not installed on your Magento, you can download it from this URL : http://code.jquery.com/jquery-1.4.4.min.js (from our experience version 1.4.4. works great with Magento).

Then go to your root www directory, and in "/js/", create a "jQuery/" folder, and place jquery-1.4.4.min.js in it. Then open app/design/frontend/{interface}/{theme}/layout/page.xml and at the end of the "head" <block>, insert :

<action method="addJs"><script>jQuery/jquery-1.4.4.min.js</script></action>

My Javascript console says : "jQuery(this).initProductPreviewlight is not a function"

There must be a jQuery conflict, typically with Prototype library. In order to solve this issue, just edit your jquery file and insert at the end "jQuery.noConflict();"

I have no js errors, but the Magento product preview is still not showing when I hover on products thumbnails in the catalog page.

The extension must be unactive, first check in your admin System->Configuration->Webmonster Extensions->Product Preview->General Options that Enable Product Preview is set to yes. If so, check in app/etc/modules/Webmonster_Productpreviewlight.xml that active is set to true.

My catalog of products is not showing anymore in my frontend!

You probably have disabled Product Preview Output in admin System->Configuration->Disable Modules Output. Reenable it. If you want to deactivate Product Preview, proceed as seen above.



There is indeed a pop-up displayed, but it says : "null" or "Warning: child element has not been found".

This is either a conflict with your own template or block file. Webmonster Product Preview overrides the template file: app/design/frontend/base/default/template/catalog/product/list.phtml and the block class: Mage_Catalog_Block_Product_List. If you have overriden one or both of these files yourself, it is very easy to fix this issue:

1/you have overriden list.phtml template file.

Open Webmonster's template file, i.e. app/design/frontend/default/default/template/catalog/product/list.phtml. Search for the 2 portions of code included between

"<!-----------WBM starts---------------->" and "<!-----------WBM ends---------------->"(approx. lines 37 and 89), and , and copy/paste them in your custom list.phtml file, at the exact same position.

2/you have overriden Mage_Catalog_Block_Product_List

Instead of inherit your Block class from Mage_Catalog_Block_Product_List, make it inherit from Webmonster_Productpreviewlight_Block_Catalog_Product_List, then refresh cache. If you're not confident with this inheritance fix, simply copy/paste  Webmonster_Productpreviewlight_Block_Catalog_Product_List's properties and methods in your own Block class. Notice that we advice the first method though.

After removing the extension from my site, browsing the site shows a 503 error.

Simply remove the maintenance.flag file from your www root directory.

These tips should solve about 95% of the issues you can find with Magento Product Preview (which are actually no real issues:), if you bump into other problems please let us know.