This section describes the most common problems that customers report and how they can be resolved:
- Do not want the Advanced Dashboard to be the default startup page
- No valid keys error
- How can I translate columns' labels
- State, province or place is not highlighted on a map in the Sales by Geo-data report
After the module installation, the Advanced Dashboard page is becoming a default startup page at the admin panel area.
You need to change the startup page in the admin panel settings.
For this navigate to the Stores > Settings > Configuration > Advanced > Admin and change the startup page. For more information, please refer to the official Magento documentation.
The error No valid keys may appear in the logs or in the cron_schedule table as the message for the job_code reports_postcode_update.
Our module, Mirasvit Reports, uses the Google Maps API to download the detailed information of the postcodes specified in the orders, to make it possible to view the "Sales by Geo-data" report.
This process gets executed once an hour and only by cron (in the background).
To access Google Maps API, we provide keys with the extension. The keys have a daily quote, by the time when the quote is expired, our module shows this message. So it actually even not an error, it just tells that today's quote for the keys has expired and will be restored tomorrow.
So you can ignore this error.
The columns' titles are created dynamically, based on the tables field's names of your database. To translate them you need to use the column name:
Some of the names do not contain the "Total" or "Average" keywords, so you should translate them without "Total" or "Average" keywords (columns with aggregator sum and avg correspondingly).
To translate "Total" and "Average" keywords, you can use the following strings:
"Average %1", "Average %1"
"Total %1", "Total %1"
In some cases, a row with a country's state (province or place) is displayed in the grid of a report. However, the corresponding part of a map is not highlighted.
Google, in its documentation, states that a region code should be written in uppercase ISO-3166-2 compliant format. For example, for Germany, in order to highlight the state, we can use either its Subdivision Name (Bayern) or a corresponding Code (DE-BY).
For states, our module uses the subdivision names. However, the practice proves that not all the correctly formed subdivision names are always visible on a map. So, if it's true for you, you just need to use the appropriate Code instead.
To change the subdivision name to code you can simply use the Magento translation mechanism, you can place the string below to your theme's translation file (in admin panel):
Then clean the translation cache
php bin/magento cache:clean translate and refresh the report.