- Magento 2.1.x or Magento 2.2.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 php
php <your Magento install dir>/bin/magento <command>
<your Magento install dir> is a subdirectory of your web server's docroot. Need help locating the docroot? Click here.
Enable the module
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 Extensions > 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
*This page shows the carriers installed in the shop and is used as an interface between the shop's carriers and the web API.
then 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 tracking API service.
If a code is not valid, you need to edit the carrier and set a valid carrie code, that will be used for the communication with the API.
Before doing that you better visit the website of your selected tracking service (AfterShip, TrackingMore, etc.), 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.
Add Custom Carriers (Optional)
In some cases, you may want to use carriers in your trackings without having the respected carrier modules installed in your shop. These cases include but not limited to inserting trackings directly to the database or using a 3rd party module that adds custom carriers to your shop.
In such cases, it's good (but not obligatory) to add those custom carriers, as carriers in ShipTracker as well. This way you can see if the carrier codes used by your custom carriers are validated by the web api and also you can add some additional info about your carriers (telephone, website, logo, etc.)
Go to ShipTracker > Carriers and click the Add Custom Carrier button.
Then you have to fill in the respected form
The 2 most important fields here are:
Code > The carrier code that used in your shop (as saved in the table sales_shipment_track)
Web Api Code > The carrier code that the web api uses for that carrier (see previous chapter).
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.