Skip to content

Fix misleading nl/pl names for session energy sensor - #435

Open
rhammen wants to merge 1 commit into
custom-components:masterfrom
rhammen:fix/session-energy-translation
Open

rhammen wants to merge 1 commit into
custom-components:masterfrom
rhammen:fix/session-energy-translation

Conversation

@rhammen

@rhammen rhammen commented Sep 14, 2026

Copy link
Copy Markdown
Contributor

The total_charge_power_session sensor (kWh of the current session) was named "Totale laadsessie" in Dutch, which reads as "total charging session" rather than the session's charged energy. Renamed to "Huidige laadsessie".

Polish used "moc" (power) for this energy sensor; changed to "energia".

Other languages checked and left as-is.

🤖 Generated with Claude Code

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@c0mplex1

Copy link
Copy Markdown
Contributor

Regarding the correction in the Dutch translation, I do not agree with you or Claude. Claude knows a lot, but not all.
"Huidige laadsessie" means "Currently charging session" in Dutch, while "Totale laadsessie" means "Total charging session".

The long or full translation of total_charge_power_session into Dutch is "Totale oplaadvermogen tijdens de sessie", but as this is too long, I have shortened it to "Totale laadsessie".

@rhammen

rhammen commented Sep 27, 2026

Copy link
Copy Markdown
Contributor Author

@c0mplex1 Er is entity "Laatste laadsessie" die de waarde bevat van het energieverbruik tijdens de laatste afgesloten sessie.
En er is total_charge_power_session, die de energieverbruik waarde bevat van de huidige (nog niet afgesloten) laadsessie. Deze waarde reset ook elke keer naar nul als een laadsessie beëindigd wordt. Door deze "Huidige laadsessie" te noemen beschrijft hij volgens mij goed wat deze sensor weergeeft. En maakt ook het verschil duidelijk met de "Laatste laadsessie" sensor.
Ik vind vooral 'totale' verwarrend omdat het bij mij de associate opwekt met het totaal van alle sessies.

Waarom vindt jij Totale laadsessie de beste vertaling?

@c0mplex1

Copy link
Copy Markdown
Contributor

Buiten de vertaling om, of ze wel of niet correct is, vraag ik me af of deze entiteit en een aantal anderen nog wel bestaan. Ik heb zelf een Zaptec Go, maar kan ze niet in de integratie terugvinden.
In de translations "nl.json" bestand staan de volgende entiteiten, of zijn destijds gewijzigd of bestaan niet meer.

Regardless of whether the translation is correct, I wonder if this entity -and a few others- actually still exist. I have a Zaptec Go myself, but I cannot find them in the integration.
The "nl.json" translation file lists the following entities, which were either modified at some point or no longer exist.

oud                                 nieuw
number.hmi_brightness               number.status_indicator_brightness
sensor.charge_current_set           sensor.allocated_charge_current
sensor.charger_operation_mode       sensor.charger_mode
sensor.signed_meter_value           sensor.energy_meter
sensor.total_charge_power_session   ?
sensor.total_charge_power           sensor.charge_power
switch.authorization_required       binary_sensor.authorization_required
switch.charger_operation_mode       ?

@rhammen

rhammen commented Sep 28, 2026

Copy link
Copy Markdown
Contributor Author

@c0mplex1 Die entiteiten bestaan nog allemaal. De namen in nl.json (die jij onder "oud" hebt genoemd) zijn keys: interne namen die de code van de integratie gebruikt, in elk taalbestand hetzelfde. Per taal staat daaronder alleen een andere vertaling.

De entity_id's (de lijst die jij onder "nieuw" hebt vermeld) maakt HA eenmalig aan wanneer de entiteiten voor het eerst worden aangemaakt, op basis van de vertaling in de systeemtaal van dat moment. Bij jou was dat Engels, dus op basis van en.json: hmi_brightness → "Status indicator brightness" → number.<lader>_status_indicator_brightness. Bij mij was het Nederlands, dus op basis van nl.json: hmi_brightness → "Helderheid statusindicator" → number.zaptec_go_2_helderheid_statusindicator. Daarna blijven de entity_id's vast, ook als de vertaling later verandert.

De twee vraagtekens:

  • total_charge_power_session: "Session total charge" → sensor.<lader>_session_total_charge
  • charger_operation_mode (switch): "Charging" → switch.<lader>_charging

Terug naar de vertaling: ik ben nog steeds benieuwd waarom je "Totale laadsessie" duidelijker vindt. De sensor toont de energie van de huidige, nog lopende sessie en gaat terug naar nul zodra die sessie eindigt. Voor mij wekt "totale" juist de indruk van een totaal over alle sessies. "Huidige" maakt ook het verschil met "Laatste laadsessie" duidelijk.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants