- Magento 2.0.x or Magento 2.1.x
Your system must also meets the Magento's system requirements
After downloading the package from our downloads area, please do the following:
- Extract/Unpack the zip file.
- Upload the extracted folder in your magento's root folder.
- Enable the module and update the database schema, using one of the following ways.
1. Using the terminal
You can run the commands in the following ways:
cd <your Magento install dir>/binand run them as
./magento <command name>
php <your Magento install dir>/bin/magento <command name>
<your Magento install dir> is a subdirectory of your web server's docroot. Need help locating the docroot? Click here.
Enable the module
magento module:enable Breakdesigns_ShipTracker
Update the database
Deploy static files
2. Using the component manager
Go to System > Web Setup Wizard and select the Component Manager
Find the component with the name breakdesigns/ship-tracker and click on Enable in the Actions column.
Then click next until the installation finishes.
Go to System > Configuration > Breakdesigns > ShipTracker
Settings regarding the use of the Web API service
1. Select the service you are going to use as Web API.
An active account with adequate credit is required, in order the extension to track the shipments
2. Enter your API Key
The Web Api services, provide an API key, to their users, that allows access to their API.
To get your API Key, you better address to your service's documentation and support.
3. Set the period/days that you want a shipment, to be monitored (Shipments Monitoring Period). The maximum limit is 60 days.
4. If your shop is already in production and has orders and shipments, you better limit our module to monitor shipments (POST new shipments) created before some days, instead of monitoring all of them. This will spare credits and resources to your Web API service, for shipments that are possibly delivered. For that you can use the setting, New Shipments Lookup Period
With these settings you can determine, when and which notification emails will be send to the customer.
All the email templates, can be customized and overwritten as any email template in magento.
For more details on that topic, please read Customize email templates using the Magento Admin.
If you create your own customized email templates, you have to come back in this section and select your prefered template.
Check the Carriers
Now the module should normally perform most of it's tasks.
Though there are cases that require some action.
Go to ShipTracker > Carriers and click on the Sync Carriers button.
This is the 1st call to the Web Api, hence it's a good chance to check if the configuration is proper and your web api account is functional. If there is any problem, you will get an error message.
If you did not get any error, check if the used carrier codes are validated by the Web Api.
What the validation process does, is to check if the carrier codes used in your shop, are the same as those used by the web api service.
If a code is not valid or somehow is not in accordance with the carrier you are using, you need to edit the carrier and set a valid carrie code, that will be used for the communication with the web api.
Before doing that you better visit your web api service, to learn what are the codes they use for your invalid carriers.
You can easily determine a carrier code from the urls of demo tracking pages related with a carrier, provided by your web api service.
e.g. https://track.aftership.com/elta-courier/PS205923435GR indicates that the code for the Hellenic Post is elta-courier.
Beyond setting a web api code, you can edit a carrier to fill in information like a website, a telephone and a logo. These information will be used both in the notification emails and in the tracking page, provided to the user.
This is the page that the shop's admin can use to get informed about the status of a shipment.
The Update Trackings button, can be used for deliberate/manual update of the trackings. The module automatically sends and fetches information about the trackings every 15 minutes through cron jobs. Also the sending of notification emails is automated as well.
By clicking the details link, you can find details such as the Itinerary/History of the Shipment or the notifications sent to the recipient.