Documentation · Admin Reference
EnVKV / Energy Reference
This document is a reference for the EnVKV / Energy screen of the ADP Car Market Hub plugin (Car Market Hub → EnVKV / Energy). It explains the WLTP reference year, fuel and electricity price assumptions, CO₂ cost scenarios and the display setting that controls the running-cost block on vehicle detail pages.
When to use this document
Read this if you are responsible for legal compliance with the German Pkw-Energieverbrauchskennzeichnungsverordnung (Pkw-EnVKV) or for keeping the displayed energy and CO₂ cost figures consistent with the values your dealership currently uses.
Overview
The EnVKV / Energy screen stores the reference data that the plugin uses to:
- Indicate the reference year for the EnVKV display.
- Calculate estimated running costs per 100 km for petrol, diesel and electric vehicles, when that display option is enabled.
- Hold the three CO₂ price scenarios (low, medium, high) per tonne of CO₂, as required by the regulation.
The actual rendering of these values on vehicle detail pages depends on the active templates and on the Show running costs per 100 km toggle on this screen.
Requirements or prerequisites
- A user with the plugin's management capability.
- The current legal reference values for fuel and electricity prices (these change over time and must be reviewed periodically).
- The current legal CO₂ price scenarios in EUR per tonne.
Step by step instructions
- Open
Car Market Hub → EnVKV / Energy. - In WLTP Base Values, set the Reference year to the current calendar year (or higher). Lower values are corrected automatically.
- Enter the Average price petrol (€/l), Average price diesel (€/l) and Average price electricity (€/kWh).
- In Estimated CO2 Costs (per tonne), enter the Low, Medium and High CO₂ price scenarios in EUR per tonne.
- In Display Settings, enable Show running costs per 100 km on vehicle details if you want the calculated cost block to appear on vehicle pages.
- Click Save EnVKV / Energy settings. (Each card has its own save button; all three save the same settings group.)
Configuration reference
WLTP Base Values
| Field | Type | Default | Notes |
|---|---|---|---|
| Reference year | 4-digit integer | Current WordPress year | Must be greater than or equal to the current year. Lower values are silently corrected to the current year. |
| Average price petrol (€/l) | Positive float | 1.85 | Used to calculate per-100 km running costs for petrol vehicles. |
| Average price diesel (€/l) | Positive float | 1.72 | Used to calculate per-100 km running costs for diesel vehicles. |
| Average price electricity (€/kWh) | Positive float | 0.42 | Used to calculate per-100 km running costs for electric vehicles. |
Negative or zero values are rejected and the previous default is kept.
Estimated CO₂ Costs (per tonne)
| Field | Type | Default | Notes |
|---|---|---|---|
| Low CO2 price (€/t) | Positive integer | 60 | Lower-end CO₂ price scenario. |
| Medium CO2 price (€/t) | Positive integer | 127 | Mid-range CO₂ price scenario. |
| High CO2 price (€/t) | Positive integer | 200 | Upper-end CO₂ price scenario. |
All three values are stored as non-negative integers.
Display Settings
| Field | Type | Default | Notes |
|---|---|---|---|
| Show running costs per 100 km on vehicle details | Checkbox | Off | When on, the frontend can show a per-100 km running-cost figure derived from the fuel or electricity price above and the vehicle's WLTP consumption. |
Operational notes
- The defaults shipped with the plugin are intended as a working starting point. They are not a substitute for the values that are legally binding for your dealership.
- The reference year is enforced to be the current year or later. This avoids accidentally publishing a stale year in legal labelling.
- The display toggle only controls visibility of the per-100 km cost line. The reference values are still saved and may be used by other plugin features or template overrides.
- Translation files do not change the stored numeric values; only the UI labels.
Troubleshooting
- The reference year always reverts. A value below the current calendar year is corrected automatically to the current year.
- Fuel price did not save. Negative or zero values are rejected and the default is kept. Use a positive float such as
1.95. - Running costs are not visible on the frontend. Confirm the Show running costs per 100 km on vehicle details toggle is on, that the vehicle has consumption values and that no template override is suppressing the block.
- CO₂ figures look wrong. The values are stored in EUR per tonne. Re-check the unit before saving.
- Calculated values look outdated after deploying a translation. Translation files do not affect the numeric values; verify the saved options in this screen.