Settings
Open Add-ons > Manage add-ons > EU Energy Label & EPREL Display > Settings.
General
Section titled “General”| Setting | Default | Description |
|---|---|---|
| Enable | On | When off, the storefront shows no arrows, labels or sheet links. Data and admin pages keep working. |
| Marketplace owner mode | On | Multi-Vendor. On: the owner’s EPREL key serves every vendor product and vendors have no connection page. Off: each vendor can save their own key. |
| Show on the product page | On | Arrow and sheet link next to the price on the product page and in quick view. |
| Show the product information sheet link in product lists | On | Prints the “Product information sheet” link under the arrow in lists that show prices (Regulation (EU) 2019/2016 Annex VIII ties label and sheet to the display of the price). |
| Show in product lists | On | Arrow beside the price in category, search and block lists. |
| Arrow direction | Left | Left or right arrow (both are shown in the regulation). |
| Open the label on | Click or tap | Or mouse roll-over. Touch screens always use a tap. |
| Arrow height on the product page (px) | 34 | The class letter is about 60 percent of this height. The regulation asks for the letter to be at least as large as the price: raise the value if your price is larger. 20 to 80. |
| Arrow height in lists (px) | 24 | 16 to 60. |
| Link the label at EPREL when no copy exists | On | Without a stored or uploaded label the arrow opens the label address built from the registration number. |
| Keep a copy of the label image | On | The cron job stores the label picture it reads from EPREL on your server. Off: the label is requested from EPREL when a shopper opens it. |
| Read each registration again after (days) | 7 | Registrations are cached in the database. |
| Products per cron run | 20 | Rate limit, 1 to 500. |
| Pause between requests (ms) | 300 | 0 to 5000. |
| Label / Product information sheet / Registry page address template | empty = default | Placeholders {reg} {group} {lang}; https only. Check them against the documentation you receive with your key. |
| Debug log | Off | Also stores every HTTP call with masked request and response. The key is never stored. |
| Log retention (days) | 90 | Older log entries are removed by the cron run. |
Connection
Section titled “Connection”The EPREL API key is not an ordinary setting: it is entered on the Connection page and stored encrypted (AES-256-GCM, key derived from your store’s own secret). It is never shown again; leave the field empty to keep the saved key, or tick Remove the saved key. The key is sent to eprel.ec.europa.eu only.
The two Test fields (product group and registration number) are used only by Save and test.
Product fields (tab “Energy label”)
Section titled “Product fields (tab “Energy label”)”| Field | Description |
|---|---|
| EPREL registration number | Digits only. The number beside the QR code on the label. |
| Product group | The EPREL product group identifier. Suggestions are offered; any identifier is accepted. |
| Read from EPREL | On: the cron job reads class and label and refreshes them after the cache time. Off: the typed values are used as they are. |
| Scale | A-G (rescaled labels), or the older A+++ to D, A++ to E, A+ to F. Reading from EPREL sets it. |
| Class | The letter on the label. Must belong to the scale. |
| Label address / upload | Optional. An https address, or a PNG, JPG or PDF up to 3 MB served from your domain. |
| Product information sheet address / upload | Optional. An https address, or a PDF up to 3 MB. |
When a field is invalid nothing is saved and the problem is shown.
CSV import
Section titled “CSV import”Columns (first line, any order, comma or semicolon): product_code or product_id, reg_no, product_group, class, scale, fiche_url, label_url, auto_fetch (Y or N). Up to 5000 rows, 2 MB. Rows with a problem are listed and skipped; the others are saved. A vendor can only change their own products. Export CSV on the Labels tab writes the same format.
The queue runs from cron. Use either the command line or the secret web address shown in the Cron section of the settings:
php /path/to/store/admin.php --dispatch=kv_eu_energy_label.cronhttps://your-store.example/index.php?dispatch=kv_eu_energy_label.cron&key=<secret>
Log and jobs
Section titled “Log and jobs”- Log lists every call and job with filters (level, action, text, dates) and a CSV export.
- Jobs lists the queue. A job that fails is retried after 5 minutes, 15 minutes, 1 hour, 3 hours and 12 hours, then marked “Gave up”; use Retry to queue it again. A “too many requests” answer waits for the time EPREL asks.