Troubleshooting

The following sections list some of the more common issues encountered when working with the modules and blocks covered in this chapter. The e-commerce modules can be somewhat complicated to configure, and it's best to be very patient when first setting up your store. Having a clean and professional storefront really makes the difference in your sales. In addition, having general patience throughout the process reduces your install problems as well.

Banner Is Added to Theme But Does Not Display

When adding banner code to Xanthia theme templates, you must always remember to reload your template files. The physical files are not accessed with every page load. Go to the Xanthia Themes Administration page and click the Reload link for your theme.

If your banner still does not display, verify that the template file you edited is being used with the page you are currently browsing. Templates are very dynamic and you might not realize that a similar template file is associated with the actual page you are testing. View the source of the page using your browser. Can you see evidence of your code addition? It might be partially displayed, and what is missing illustrates the problem in your code. If there is no evidence at all, you are either viewing the wrong template, or the templates did not reload.

You can also try removing and readding your theme altogether to clear out cached templates that might be giving you trouble.

Security Alert from the Donations Block

Many of the donations blocks use <form> tags. External systems like PayPal often require the tags for their code to work. You are receiving the security messages because your PostNuke site is concerned about the use of the <form> tag, which is disabled in the default install.

Your options are to either ignore the security alerts, or go into your site's Website Settings page and allow the <form> tag through the table at the bottom of the page.

File Has Been Encoded with the ionCube PHP Encoder

This error message occurs when you attempt to install a module encoded by ionCube's utilities without having the Loader installed to read the files. You need to download the appropriate ionCube Loader DLL or SO from their website (www.ioncube.com) and install it per their instructions.

Install of the Loader is very simple and requires the editing of your php.ini file as well as the copy of the DLL or SO file to the folder referenced in php.ini.

Access Denied to cmsMerchant

This is likely caused by a version incompatibility with your PostNuke version. cmsMerchant is customized for your specific server and domain, and it is only guaranteed to work with the version of PostNuke available at the time of purchase. Customizing or upgrading your PostNuke install might cause a conflict with the module resulting in the preceding error message.

For this problem, you need to contact cmsMerchant support about patches or the possible need to upgrade your module itself.