Installing Magento Extensions : Troubleshooting

Magento Help

Something unexpected happened?

Try not to worry too much, take a deep breath and read through these common issues and solutions below.

Most issues have been seen before and are quickly fixable or at least revertible-from.

 

"I can't see the module in the configuration settings page"

• Try deleting your cache manually. Inside your Magento installation folder, go into var folder and rename the cache folder (eg. to cache1). You can delete that renamed folder if everything works afterwards.
• If there is still nothing showing in the configuration page, you may have missed some files. Please repeat the installation of the extension.

"I see a white screen / 'Mag registry key' error message"

• Double check that compilation is turned off SystemToolsCompilation
• If you can't access that page any more (eg. if you installed without disabling the compiler) you'll need to manually disable compilation.

• If you have shell access, run this from the magento site root:

$ php shell/compiler.php disable

You may also need to clear compiled files:

$ php shell/compiler.php clear

• A quick way to do this, if you don't have shell or database access, is to comment this line in /includes/config.php, from

define('COMPILER_INCLUDE_PATH', dirname(__FILE__).DIRECTORY_SEPARATOR.'src');, to

#define('COMPILER_INCLUDE_PATH', dirname(__FILE__).DIRECTORY_SEPARATOR.'src');

This exact format is important as one of the compilation scripts looks for it.

"I see a blank SalesOrders page"

• If you're using "Magemaven OrderComment" try editing Magemaven_OrderComment > config.xml

Change :

<sales_resource>
  <rewrite>
    <order_grid_collection>Magemaven_OrderComment_Model_Mysql4_Order_Grid_Collection</order_grid_collection>
  </rewrite>
</sales_resource>

To:

<adminhtml>
  <rewrite>
    <sales_order_grid>Magemaven_OrderComment_Block_Adminhtml_Sales_Order_Grid</sales_order_grid>
  </rewrite>
</adminhtml>

"I get a 404 error in the config page"

• Log out then log in :)

"I get an error when printing a PDF in pickPack"

• If you've uploaded images (eg. for the logo, shipping address label), please check that they all are non-interlaced, non-transparent, .png files.

"I still have issues"

• First, check the log files. If you haven't turned on logging do so now. SystemAdvancedDeveloper > Log Settings

Try running Magento and then check those log files - the default location is /var/log.

• Add a number to the log filenames to see recent messages only.
• Next, check your server log files (look for php and server log files) for errors (location will depend on your server).
• Still problems? Let's turn it off:

1. Disable the extension by navigating to /app/etc/modules and renaming your the extension xml file, eg from .xml to .xml_off
2. Clear the cache (if you can't access your backend cache page, just rename /var/cache (eg. to /var/cache1))

"I stilll have issues!"

• Drop us a line with your (S)FTP and Magento access details and we'll take a look.