Overview
ShipperHQ provides additional functionality in separate modules. These are not required in order to use ShipperHQ on Magento 2, but they provide advanced capabilities. An example is ‘module-calendar’ which will display a delivery date selector on the checkout. These modules are held in a private composer repository (Satis).
You will need to request access to this satis repository by emailing support@shipperhq.com and include your ShipperHQ login email address before attempting to access them using the steps below.
Assumptions
We assume you understand Magento 2, and have it installed correctly and have updated your base ShipperHQ module to the latest version. If not, you can get the latest version from the public repo here. Instructions to update can be found in our Installation doc here.
We assume you have been granted access to our Satis repository.
It is highly recommended to backup your server files and database before installing this module. No responsibility can be taken for any adverse effects it may cause. It is also recommended you install on a test server initially to carry out your own testing.
These modules are not supported in multi-address checkouts — you will only be able to see basic rates in these instances.
Modules details & functionality
Here are the 3 available modules and what functionality is provided by each module:
shipperhq/module-option
This one is needed to display accessorial tickboxes for freight carriers, allowing your customers to choose if they need Liftgate, Inside Delivery, etc. It will also add the ability to show tooltips on shipping methods.
shipperhq/module-calendar
This is needed to display the Date & Time calendar on the checkout when you choose to display the calendar under the desired carrier date/time settings
shipperhq/module-pickup
This module is needed to display the details of the pickup location + map if you chose to display it. We highly recommend requiring this module besides the calendar module so that you can show a calendar on the checkout for in-store pickup
shipperhq/module-orderview
This module is only required alongside the standard ShipperHQ module-shipper in order for shipping insight details to be displayed within the order details in Magento’s admin panel. Feature will not provide full functionality till this module is installed.
Adding modules from our Private Repository
At any point during set up if it asks you to enter credentials, you will need to enter the credentials requested and sent to from ShipperHQ Support team.
- Using your preferred text editor, you’ll need to add the packages.shipperhq.com repository under the “repositories” section of the composer.json file located in your Magento root directory. Here’s an example of what it would look like when added to a native M2 composer.json file:
“repositories”: [
{
"type": "composer",
"url": "https://repo.magento.com/"
},
{
"type": "composer",
"url": "https://packages.shipperhq.com"
}
], - You can then add the modules via command line with the commands below:
composer require <vendor/module_name>
composer update
php bin/magento module:enable Vendor_ModuleName
for example:
composer require shipperhq/module-calendar
composer update
php bin/magento module:enable ShipperHQ_Calendar
Note: This does NOT cover installation of ShipperHQ itself. If you are looking to install or update ShipperHQ on Magento 2, please follow the installation and upgrade instructions for ShipperHQ on Magento 2.
How to check for available new versions of installed modules
If you’re ever unsure about whether you’re using the latest version of a particular module, you can use the following Composer command to check this. Composer’s output will include the current version and the latest available version:
composer show --latest <vendor/module-name>
(via Composer documentation)
Disabling Modules
From the command line you can disable these separate modules via:
php bin magento module:disable --clear-static-content ShipperHQ_Pickup ShipperHQ_Option ShipperHQ_Calendar
Lastly, run the standard cleanup commands:
php bin/magento setup:upgrade php bin/magento setup:di:compile php bin/magento indexer:reindex php bin/magento cache:clean