Skip to content
  • There are no suggestions because the search field is empty.

How to Troubleshoot Magento 1 Installations

Resolve installation hurdles and common errors for Magento 1 extensions efficiently

Table of Contents

Overview

This guide helps troubleshoot the installation of the ShipperHQ extension for Magento 1. It's specifically for Magento 1, so if you're using Magento 2, please refer to the Magento 2 Installation Troubleshooting Guide. If you experience incorrect shipping rates, visit our Rate Discrepancies guide. 😊

Blank Page

Symptom

You encounter a blank or white page when navigating the store.

Solution

This suggests a silent error. Refer to our Completely Blank Page guide. If the compiler is enabled, ensure it has been refreshed. 💡

Method Not Defined

You see this error message:

Method "exampleMethod" is not defined in "/path/to/magento"...

This indicates trouble reading one or more files. First, re-copy all files from the ZIP as instructed in the Installation Guide. Refresh the cache and compiler (if enabled), and make sure the file permissions are correctly set. ✅

Include File Missing

You receive a warning such as:

Warning: include(...)

Ensure that the Magento Compiler is refreshed if it is enabled. ⚠️

Website Not in Environment Scope

The message "Website Not in Environment Scope" appears in System > Configuration > Shipping Methods after saving configuration.

ShipperHQ and Magento might be looking at different scopes. Ensure the scope at the top right of your ShipperHQ account matches the scope in ShipperHQ Configuration. Location to double-check the scope under ShipperHQ Configuration. Location to view current scope on ShipperHQ dashboard. 💡

Invalid Credentials

An error about invalid credentials is shown in System > Configuration > Shipping Methods after enabling ShipperHQ.

Verify that the API Key and Authentication code from the Websites configuration section are entered correctly. 🌟

SQL Not Run Successfully

An error like this appears:

SQLSTATE[42S02]: Base Table Or View Not Found

SQL install scripts have not run successfully. Please check the SQL Failed to Run article for help. 💡

PHP 7 Support

Version 2.195 of the extension supports PHP 7.2 for Magento 1. If you need the latest version, feel free to contact us. 😊