Welcome to the Magento Laboratory!

These tips should solve about 90% 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.

I don't know where to start to install the module.

It's really easy. You can find a link to your extension package in the order confirmation email you received from MagentoLab, or in your user account on MagentoLab website under "My downloadable products" tab.

The extension is provided as a .ZIP file, you just need to unpack it on your local computer, and merge its content with the web root of your server, through any FTP client. Then clear the Magento cache.

In order to activate the module you need an extension key, which was sent to you in the order confirmation email. Once the module installed you will have to insert this key in Magento Admin Panel : System->Configuration->eCommerceLab Extensions->Product Preview, then save the configuration.


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 platform, you can download it from this URL : http://code.jquery.com/jquery-2.1.0.min.js.

Then go to your root www directory, and in "/js/", create a "jQuery/" folder, and place jquery-2.1.0.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-2.1.0.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 inactive, first check in your admin System->Configuration->MagentoLab Extensions->Product Preview->General Options that Enable Product Preview is set to yes. If so, check in app/etc/modules/Magentolab_Productpreview.xml (respectively Magentolab_Productpreviewlight.xml) that active node 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".

A/If you get the message "Warning: child element has not been found" only in Firefox,

this may be due to a conflict with the prototype-deprecation script, which happens only with the newest versions of Firefox. To make sure, open your Javascript console, if you see something related to "getElementsByClassName", that's it. This is a Firefox bug, we can't unfortunately solve it, but there is an easy workaround detailed here: https://support.mozilla.org/en-US/questions/955992.


B/if the message appears on every browser,

this is a conflict with either your own template, your block file, or a 3rd party theme. MagentoLab 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 MagentoLab Product Preview's template file, i.e. app/design/frontend/default/default/template/catalog/product/list.phtml. Search for the 2 portions of code included between

"<!-----------eLB starts---------------->" and "<!-----------eLB 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 MagentoLab_Productpreviewlight_Block_Catalog_Product_List, then refresh cache. If you're not confident with this inheritance fix, simply copy/paste  MagentoLab_Productpreviewlight_Block_Catalog_Product_List's properties and methods in your own Block class. Notice that we advice the first method though.


An easy way to know which template/block is loaded is to activate template hints in your admin panel.  


3/you are using a 3rd party theme, like for instance "modern" theme.

It could be that your design is not correctly configured: in general->design->Themes, if no field is set to "default", that means no fallback is defined for your design. Since Magentolab's template is in default, its list.phtml file cannot be loaded. More info here: 



Going to system->config->Magentolab->Product preview shows a blank page.

Refresh Magento's cache and logout/login back to your admin.



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.