Vertaalbestanden 7: resterende Engelse API-antwoorden (wachtwoord/gebruikersbeheer, 13) en interne-serverfoutzin naar de tekstbestanden; docs/mail-teksten.md (gegenereerd overzicht van alle mailteksten)

TWEEDE GEDRAGSWIJZIGING (goedgekeurd): de 13 Engelse antwoorden van auth/users zijn Nederlands bij Texts:DefaultLanguage=nl; en-bestand = oude tekst letterlijk. De admin toont voor wachtwoord vergeten zijn eigen tekst.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-15 20:54:06 +01:00
co-authored by Claude Sonnet 5.5
parent 2307417134
commit 352f84b860
10 changed files with 632 additions and 23 deletions
+413
View File
@@ -0,0 +1,413 @@
# Teksten van de mails van het CMS
Gegenereerd door `scripts/Export-MailTexts.ps1` uit `src/SlpModularCms.Core/Texts/nl.json` en `en.json` (en de voorbeeldmails in `src/SlpModularCms.Core.Tests/Golden/mail`). Niet met de hand wijzigen: pas de tekstbestanden aan en draai het script opnieuw. Zie [translation-files.md](translation-files.md) voor de opzet.
In de teksten staan plaatshouders tussen accolades die bij het versturen worden ingevuld: `{site}` (naam van de site), `{validity}` (hoe lang een link geldig is, bijvoorbeeld "48 uur" of "30 minuten"), `{role}` (de nieuwe rol) en `{name}` (naam van de ontvanger). Elke mail heeft bovenaan een kop, optioneel een aanhef, de inleiding, eventueel een knop met de link, een opmerking en onderaan een vaste voettekst.
## Vaste onderdelen
| Onderdeel | Nederlands | Engels |
|---|---|---|
| Aanhef (als de naam van de ontvanger bekend is) | Hallo {name}, | Hello {name}, |
| Voettekst onder elke mail | Deze mail is automatisch verstuurd door {site}. | This message was sent automatically by {site}. |
| Rol: eigenaar | Eigenaar | Owner |
| Rol: beheerder | Beheerder | Administrator |
| Rol: gebruiker | Gebruiker | User |
| Geldigheid, 1 uur | {count} uur | {count} hour |
| Geldigheid, meerdere uren | {count} uur | {count} hours |
| Geldigheid, minuten | {count} minuten | {count} minutes |
## Uitnodiging
Wanneer: Een beheerder nodigt iemand uit.
| Onderdeel | Nederlands | Engels |
|---|---|---|
| Onderwerp | Uitnodiging voor {site} | Invitation to {site} |
| Kop | Je bent uitgenodigd | You have been invited |
| Inleiding | Je bent uitgenodigd om een account aan te maken voor {site}. Kies met de knop hieronder je wachtwoord om je account te activeren. | You have been invited to create an account for {site}. Use the button below to choose your password and activate your account. |
| Knop | Account activeren | Activate account |
| Opmerking onderaan | Deze link is {validity} geldig. Is hij verlopen, vraag dan de beheerder om een nieuwe uitnodiging. | This link is valid for {validity}. If it has expired, ask the administrator for a new invitation. |
**Voorbeeld (tekstversie, Nederlands)**, met voorbeeldwaarden (site 'Test <Site> & Co', ontvanger 'Jan "de" Vries'):
```text
Je bent uitgenodigd
Hallo Jan "de" Vries,
Je bent uitgenodigd om een account aan te maken voor Test <Site> & Co. Kies met de knop hieronder je wachtwoord om je account te activeren.
Naam:
Jan <script>
Bericht:
regel 1
regel 2 & meer
https://test.example.nl/activate?token=a&b=c
Deze link is 48 uur geldig. Is hij verlopen, vraag dan de beheerder om een nieuwe uitnodiging.
--
Deze mail is automatisch verstuurd door Test <Site> & Co.
```
**Voorbeeld (tekstversie, Engels)**, met voorbeeldwaarden (site 'Test <Site> & Co', ontvanger 'Jan "de" Vries'):
```text
You have been invited
Hello Jan "de" Vries,
You have been invited to create an account for Test <Site> & Co. Use the button below to choose your password and activate your account.
Naam:
Jan <script>
Bericht:
regel 1
regel 2 & meer
https://test.example.nl/activate?token=a&b=c
This link is valid for 48 hours. If it has expired, ask the administrator for a new invitation.
--
This message was sent automatically by Test <Site> & Co.
```
## Nieuwe uitnodigingslink
Wanneer: Een beheerder maakt een nieuwe uitnodigingslink aan.
| Onderdeel | Nederlands | Engels |
|---|---|---|
| Onderwerp | Nieuwe uitnodigingslink voor {site} | New invitation link for {site} |
| Kop | Je hebt een nieuwe uitnodigingslink | You have a new invitation link |
| Inleiding | Er is een nieuwe uitnodigingslink voor je aangemaakt voor {site}. De vorige link werkt niet meer. | A new invitation link has been created for you for {site}. The previous link no longer works. |
| Knop | Account activeren | Activate account |
| Opmerking onderaan | Deze link is {validity} geldig. | This link is valid for {validity}. |
**Voorbeeld (tekstversie, Nederlands)**, met voorbeeldwaarden (site 'Test <Site> & Co', ontvanger 'Jan "de" Vries'):
```text
Je hebt een nieuwe uitnodigingslink
Hallo Jan "de" Vries,
Er is een nieuwe uitnodigingslink voor je aangemaakt voor Test <Site> & Co. De vorige link werkt niet meer.
Naam:
Jan <script>
Bericht:
regel 1
regel 2 & meer
https://test.example.nl/activate?token=a&b=c
Deze link is 1 uur geldig.
--
Deze mail is automatisch verstuurd door Test <Site> & Co.
```
**Voorbeeld (tekstversie, Engels)**, met voorbeeldwaarden (site 'Test <Site> & Co', ontvanger 'Jan "de" Vries'):
```text
You have a new invitation link
Hello Jan "de" Vries,
A new invitation link has been created for you for Test <Site> & Co. The previous link no longer works.
Naam:
Jan <script>
Bericht:
regel 1
regel 2 & meer
https://test.example.nl/activate?token=a&b=c
This link is valid for 1 hour.
--
This message was sent automatically by Test <Site> & Co.
```
## Wachtwoord opnieuw instellen
Wanneer: Iemand vraagt een nieuw wachtwoord aan.
| Onderdeel | Nederlands | Engels |
|---|---|---|
| Onderwerp | Wachtwoord opnieuw instellen voor {site} | Reset your password for {site} |
| Kop | Wachtwoord opnieuw instellen | Reset your password |
| Inleiding | Er is gevraagd om het wachtwoord van je account bij {site} opnieuw in te stellen. Gebruik de knop hieronder om een nieuw wachtwoord te kiezen. | A request was made to reset the password of your account at {site}. Use the button below to choose a new password. |
| Knop | Nieuw wachtwoord kiezen | Choose a new password |
| Opmerking onderaan | Deze link is {validity} geldig en werkt één keer. Heb jij dit niet gevraagd? Negeer deze mail dan: je wachtwoord blijft ongewijzigd. | This link is valid for {validity} and works once. Did you not ask for this? Ignore this message: your password stays unchanged. |
**Voorbeeld (tekstversie, Nederlands)**, met voorbeeldwaarden (site 'Test <Site> & Co', ontvanger 'Jan "de" Vries'):
```text
Wachtwoord opnieuw instellen
Hallo Jan "de" Vries,
Er is gevraagd om het wachtwoord van je account bij Test <Site> & Co opnieuw in te stellen. Gebruik de knop hieronder om een nieuw wachtwoord te kiezen.
Naam:
Jan <script>
Bericht:
regel 1
regel 2 & meer
https://test.example.nl/activate?token=a&b=c
Deze link is 30 minuten geldig en werkt één keer. Heb jij dit niet gevraagd? Negeer deze mail dan: je wachtwoord blijft ongewijzigd.
--
Deze mail is automatisch verstuurd door Test <Site> & Co.
```
**Voorbeeld (tekstversie, Engels)**, met voorbeeldwaarden (site 'Test <Site> & Co', ontvanger 'Jan "de" Vries'):
```text
Reset your password
Hello Jan "de" Vries,
A request was made to reset the password of your account at Test <Site> & Co. Use the button below to choose a new password.
Naam:
Jan <script>
Bericht:
regel 1
regel 2 & meer
https://test.example.nl/activate?token=a&b=c
This link is valid for 30 minutes and works once. Did you not ask for this? Ignore this message: your password stays unchanged.
--
This message was sent automatically by Test <Site> & Co.
```
## Account gedeactiveerd
Wanneer: Een beheerder deactiveert een account.
| Onderdeel | Nederlands | Engels |
|---|---|---|
| Onderwerp | Je account bij {site} is gedeactiveerd | Your account at {site} has been deactivated |
| Kop | Account gedeactiveerd | Account deactivated |
| Inleiding | Een beheerder heeft je account bij {site} gedeactiveerd. Je kunt niet meer inloggen. | An administrator has deactivated your account at {site}. You can no longer sign in. |
| Opmerking onderaan | Denk je dat dit niet klopt? Neem dan contact op met de beheerder. | Think this is a mistake? Please contact the administrator. |
**Voorbeeld (tekstversie, Nederlands)**, met voorbeeldwaarden (site 'Test <Site> & Co', ontvanger 'Jan "de" Vries'):
```text
Account gedeactiveerd
Hallo Jan "de" Vries,
Een beheerder heeft je account bij Test <Site> & Co gedeactiveerd. Je kunt niet meer inloggen.
Naam:
Jan <script>
Bericht:
regel 1
regel 2 & meer
Denk je dat dit niet klopt? Neem dan contact op met de beheerder.
--
Deze mail is automatisch verstuurd door Test <Site> & Co.
```
**Voorbeeld (tekstversie, Engels)**, met voorbeeldwaarden (site 'Test <Site> & Co', ontvanger 'Jan "de" Vries'):
```text
Account deactivated
Hello Jan "de" Vries,
An administrator has deactivated your account at Test <Site> & Co. You can no longer sign in.
Naam:
Jan <script>
Bericht:
regel 1
regel 2 & meer
Think this is a mistake? Please contact the administrator.
--
This message was sent automatically by Test <Site> & Co.
```
## Account weer actief
Wanneer: Een beheerder activeert een account weer.
| Onderdeel | Nederlands | Engels |
|---|---|---|
| Onderwerp | Je account bij {site} is weer actief | Your account at {site} is active again |
| Kop | Account weer actief | Account active again |
| Inleiding | Een beheerder heeft je account bij {site} weer geactiveerd. Je kunt weer inloggen. | An administrator has reactivated your account at {site}. You can sign in again. |
| Knop | Inloggen | Sign in |
**Voorbeeld (tekstversie, Nederlands)**, met voorbeeldwaarden (site 'Test <Site> & Co', ontvanger 'Jan "de" Vries'):
```text
Account weer actief
Hallo Jan "de" Vries,
Een beheerder heeft je account bij Test <Site> & Co weer geactiveerd. Je kunt weer inloggen.
Naam:
Jan <script>
Bericht:
regel 1
regel 2 & meer
https://test.example.nl/activate?token=a&b=c
--
Deze mail is automatisch verstuurd door Test <Site> & Co.
```
**Voorbeeld (tekstversie, Engels)**, met voorbeeldwaarden (site 'Test <Site> & Co', ontvanger 'Jan "de" Vries'):
```text
Account active again
Hello Jan "de" Vries,
An administrator has reactivated your account at Test <Site> & Co. You can sign in again.
Naam:
Jan <script>
Bericht:
regel 1
regel 2 & meer
https://test.example.nl/activate?token=a&b=c
--
This message was sent automatically by Test <Site> & Co.
```
## Rol gewijzigd
Wanneer: Een beheerder wijzigt de rol van een gebruiker.
| Onderdeel | Nederlands | Engels |
|---|---|---|
| Onderwerp | Je rol bij {site} is gewijzigd | Your role at {site} has changed |
| Kop | Rol gewijzigd | Role changed |
| Inleiding | Een beheerder heeft je rol bij {site} gewijzigd naar: {role}. | An administrator has changed your role at {site} to: {role}. |
| Opmerking onderaan | Denk je dat dit niet klopt? Neem dan contact op met de beheerder. | Think this is a mistake? Please contact the administrator. |
**Voorbeeld (tekstversie, Nederlands)**, met voorbeeldwaarden (site 'Test <Site> & Co', ontvanger 'Jan "de" Vries'):
```text
Rol gewijzigd
Hallo Jan "de" Vries,
Een beheerder heeft je rol bij Test <Site> & Co gewijzigd naar: Beheerder.
Naam:
Jan <script>
Bericht:
regel 1
regel 2 & meer
Denk je dat dit niet klopt? Neem dan contact op met de beheerder.
--
Deze mail is automatisch verstuurd door Test <Site> & Co.
```
**Voorbeeld (tekstversie, Engels)**, met voorbeeldwaarden (site 'Test <Site> & Co', ontvanger 'Jan "de" Vries'):
```text
Role changed
Hello Jan "de" Vries,
An administrator has changed your role at Test <Site> & Co to: Administrator.
Naam:
Jan <script>
Bericht:
regel 1
regel 2 & meer
Think this is a mistake? Please contact the administrator.
--
This message was sent automatically by Test <Site> & Co.
```
## Nieuw contactbericht
Wanneer: Een bezoeker verstuurt het contactformulier; de mail gaat naar de eigenaar van de site.
| Onderdeel | Nederlands | Engels |
|---|---|---|
| Onderwerp | Nieuw bericht via {site} | New message via {site} |
| Kop | Nieuw bericht via het contactformulier | New message from the contact form |
| Inleiding | Er is een bericht verstuurd via het contactformulier van {site}. | A message was sent through the contact form of {site}. |
**Voorbeeld (tekstversie, Nederlands)**, met voorbeeldwaarden (site 'Test <Site> & Co', ontvanger 'Jan "de" Vries'):
```text
Nieuw bericht via het contactformulier
Hallo Jan "de" Vries,
Er is een bericht verstuurd via het contactformulier van Test <Site> & Co.
Naam:
Jan <script>
Bericht:
regel 1
regel 2 & meer
--
Deze mail is automatisch verstuurd door Test <Site> & Co.
```
**Voorbeeld (tekstversie, Engels)**, met voorbeeldwaarden (site 'Test <Site> & Co', ontvanger 'Jan "de" Vries'):
```text
New message from the contact form
Hello Jan "de" Vries,
A message was sent through the contact form of Test <Site> & Co.
Naam:
Jan <script>
Bericht:
regel 1
regel 2 & meer
--
This message was sent automatically by Test <Site> & Co.
```
+13 -3
View File
@@ -11,7 +11,8 @@ Levend document (2026-11-15). De vaste, voor gebruikers bedoelde teksten van de
| Beschikbaarheidsmeldingen (`availability.*`) | Foutcodes van het contactformulier (`required`, `too_long`, `invalid`, ...): dat is een contract met de websites |
| Validatiemeldingen van pakketten en banners (`offerings.validation.*`) | Interne uitzonderingen (Master), log- en SecurityEvent-teksten |
| De pagina als er geen website is geplaatst (`core.host.placeholder.*`) | De HTML-structuur van mails en pagina's (alleen de zinnen gaan naar de bestanden) |
| 'Boek {name}' in de gewone lijst die de host in de website schrijft (`offerings.injection.book`) | Twee Engelse API-meldingen die bewust niet zijn verplaatst: het 'als dit adres bij een account hoort...'-antwoord van wachtwoord vergeten en 'You cannot delete your own account.' |
| 'Boek {name}' in de gewone lijst die de host in de website schrijft (`offerings.injection.book`) | |
| De antwoorden van de wachtwoord- en gebruikersbeheer-endpoints (`core.identity.auth.*`, `core.identity.users.*`) | |
De golden files van de website (ASF) voor de lijst-HTML blijven leidend: de tekst 'Boek {name}' moet in het Nederlands exact zo blijven.
@@ -52,9 +53,18 @@ Sleutelstijl: kleine letters en camelCase per onderdeel, `module.onderwerp.onder
- Karakteriseringstests: alle mails (7 soorten × nl, en, een onbekende taal × volledig en kaal) zijn vastgelegd in `SlpModularCms.Core.Tests/Golden/mail` en moesten na de verhuizing byte-identiek blijven; de placeholder-pagina is vergeleken met het originele bestand (zonder witruimte-verschillen); de Nederlandse meldingen van Identity en Availability zijn per tekst vastgelegd; de golden files van de website staan in `SlpModularCms.Modules.Offerings.Tests/Golden/host-injection`.
- Regenereren van de mail-snapshots met opzet: `UPDATE_GOLDEN=1 dotnet test --filter MailGoldenTests`.
## Gedragswijziging bij de verhuizing
## Gedragswijzigingen bij de verhuizing
Eén bewuste wijziging, goedgekeurd door Bryan: de validatiemeldingen van pakketten en banners waren Engels en zijn nu Nederlands bij `Texts:DefaultLanguage=nl` (de beheerders zijn Nederlandstalig en de admin toont de melding letterlijk). De Engelse bestandsversie bevat de oude meldingen letterlijk. Verder is de uitvoer ongewijzigd; de uitzondering `MasterControlledAvailabilityException` heeft een technische Engelse melding gekregen, de zin voor de beheerder komt uit `availability.masterControlled`.
Twee bewuste wijzigingen, goedgekeurd door Bryan (via de leider): teksten die alleen in het Engels bestonden zijn nu Nederlands bij `Texts:DefaultLanguage=nl`; de Engelse bestandsversie bevat de oude teksten letterlijk.
1. De validatiemeldingen van pakketten en banners (`offerings.validation.*`, 9 teksten). Beheerders zijn Nederlandstalig en de admin toont de melding letterlijk.
2. De Engelse antwoorden van de endpoints voor wachtwoord vergeten/instellen en gebruikersbeheer (`core.identity.auth.invalidEmail`, `resetRequested`, `linkInvalid`, `passwordSet`, `passwordRejected` en `core.identity.users.*`, 13 teksten), zoals 'You cannot delete your own account.' De admin toont voor wachtwoord vergeten zijn eigen tekst (`forgotPassword.sentMessage`) en niet het antwoord van de server, dus er wordt niets dubbel getoond.
Verder is de uitvoer ongewijzigd; de uitzondering `MasterControlledAvailabilityException` heeft een technische Engelse melding gekregen, de zin voor de beheerder komt uit `availability.masterControlled`.
## Leesbaar overzicht van de mails
[mail-teksten.md](mail-teksten.md) toont alle mailteksten per soort in het Nederlands en Engels, plus de tekstversie van een voorbeeldmail. Het bestand wordt gegenereerd met `./scripts/Export-MailTexts.ps1` (niet met de hand wijzigen).
## Productie
+92
View File
@@ -0,0 +1,92 @@
<#
.SYNOPSIS
Writes docs/mail-teksten.md: a readable overview of every mail the CMS sends (the texts per kind in Dutch and English,
and the plain-text version of each Dutch and English example).
.DESCRIPTION
Reads src/SlpModularCms.Core/Texts/nl.json and en.json (the single source of the sentences) and the recorded example
mails in src/SlpModularCms.Core.Tests/Golden/mail. Run it after changing a mail text; the file is generated, do not
edit it by hand.
.EXAMPLE
./scripts/Export-MailTexts.ps1
#>
[CmdletBinding()]
param([string] $Output)
$ErrorActionPreference = 'Stop'
$here = if ($PSScriptRoot) { $PSScriptRoot } else { Split-Path -Parent $MyInvocation.MyCommand.Path }
$root = Resolve-Path (Join-Path $here '..')
if (-not $Output) { $Output = Join-Path $root 'docs\mail-teksten.md' }
$nl = Get-Content -LiteralPath (Join-Path $root 'src\SlpModularCms.Core\Texts\nl.json') -Raw -Encoding UTF8 | ConvertFrom-Json
$en = Get-Content -LiteralPath (Join-Path $root 'src\SlpModularCms.Core\Texts\en.json') -Raw -Encoding UTF8 | ConvertFrom-Json
$golden = Join-Path $root 'src\SlpModularCms.Core.Tests\Golden\mail'
$kinds = [ordered]@{
Invitation = @{ Key = 'invitation'; Title = 'Uitnodiging'; When = 'Een beheerder nodigt iemand uit.' }
NewInvitationLink = @{ Key = 'newInvitationLink'; Title = 'Nieuwe uitnodigingslink'; When = 'Een beheerder maakt een nieuwe uitnodigingslink aan.' }
PasswordReset = @{ Key = 'passwordReset'; Title = 'Wachtwoord opnieuw instellen'; When = 'Iemand vraagt een nieuw wachtwoord aan.' }
AccountDeactivated = @{ Key = 'accountDeactivated'; Title = 'Account gedeactiveerd'; When = 'Een beheerder deactiveert een account.' }
AccountReactivated = @{ Key = 'accountReactivated'; Title = 'Account weer actief'; When = 'Een beheerder activeert een account weer.' }
RoleChanged = @{ Key = 'roleChanged'; Title = 'Rol gewijzigd'; When = 'Een beheerder wijzigt de rol van een gebruiker.' }
ContactMessage = @{ Key = 'contactMessage'; Title = 'Nieuw contactbericht'; When = 'Een bezoeker verstuurt het contactformulier; de mail gaat naar de eigenaar van de site.' }
}
$parts = [ordered]@{ subject = 'Onderwerp'; heading = 'Kop'; intro = 'Inleiding'; button = 'Knop'; note = 'Opmerking onderaan' }
function Cell([string] $text) { if ([string]::IsNullOrEmpty($text)) { '-' } else { $text.Replace('|', '\|') } }
$sb = [System.Text.StringBuilder]::new()
[void]$sb.AppendLine('# Teksten van de mails van het CMS')
[void]$sb.AppendLine()
[void]$sb.AppendLine('Gegenereerd door `scripts/Export-MailTexts.ps1` uit `src/SlpModularCms.Core/Texts/nl.json` en `en.json` (en de voorbeeldmails in `src/SlpModularCms.Core.Tests/Golden/mail`). Niet met de hand wijzigen: pas de tekstbestanden aan en draai het script opnieuw. Zie [translation-files.md](translation-files.md) voor de opzet.')
[void]$sb.AppendLine()
[void]$sb.AppendLine('In de teksten staan plaatshouders tussen accolades die bij het versturen worden ingevuld: `{site}` (naam van de site), `{validity}` (hoe lang een link geldig is, bijvoorbeeld "48 uur" of "30 minuten"), `{role}` (de nieuwe rol) en `{name}` (naam van de ontvanger). Elke mail heeft bovenaan een kop, optioneel een aanhef, de inleiding, eventueel een knop met de link, een opmerking en onderaan een vaste voettekst.')
[void]$sb.AppendLine()
[void]$sb.AppendLine('## Vaste onderdelen')
[void]$sb.AppendLine()
[void]$sb.AppendLine('| Onderdeel | Nederlands | Engels |')
[void]$sb.AppendLine('|---|---|---|')
foreach ($row in @(
@('Aanhef (als de naam van de ontvanger bekend is)', 'greeting'),
@('Voettekst onder elke mail', 'footer'),
@('Rol: eigenaar', 'role.owner'), @('Rol: beheerder', 'role.administrator'), @('Rol: gebruiker', 'role.user'),
@('Geldigheid, 1 uur', 'validity.hoursOne'), @('Geldigheid, meerdere uren', 'validity.hoursOther'), @('Geldigheid, minuten', 'validity.minutes'))) {
$get = { param($o, $path) $v = $o.core.mail; foreach ($p in $path.Split('.')) { $v = $v.$p }; $v }
[void]$sb.AppendLine("| $($row[0]) | $(Cell (& $get $nl $row[1])) | $(Cell (& $get $en $row[1])) |")
}
foreach ($kind in $kinds.Keys) {
$info = $kinds[$kind]
[void]$sb.AppendLine()
[void]$sb.AppendLine("## $($info.Title)")
[void]$sb.AppendLine()
[void]$sb.AppendLine("Wanneer: $($info.When)")
[void]$sb.AppendLine()
[void]$sb.AppendLine('| Onderdeel | Nederlands | Engels |')
[void]$sb.AppendLine('|---|---|---|')
foreach ($part in $parts.Keys) {
$n = $nl.core.mail.($info.Key).$part
$e = $en.core.mail.($info.Key).$part
if (-not $n -and -not $e) { continue }
[void]$sb.AppendLine("| $($parts[$part]) | $(Cell $n) | $(Cell $e) |")
}
foreach ($lang in 'nl', 'en') {
$file = Join-Path $golden "$kind.$lang.full.txt"
if (-not (Test-Path $file)) { continue }
$text = (Get-Content -LiteralPath $file -Raw -Encoding UTF8) -replace "`r`n", "`n"
$idx = $text.IndexOf("--TEXT--`n")
if ($idx -lt 0) { continue }
$plain = $text.Substring($idx + 9).TrimEnd()
$label = if ($lang -eq 'nl') { 'Voorbeeld (tekstversie, Nederlands)' } else { 'Voorbeeld (tekstversie, Engels)' }
[void]$sb.AppendLine()
[void]$sb.AppendLine("**$label**, met voorbeeldwaarden (site 'Test <Site> & Co', ontvanger 'Jan ""de"" Vries'):")
[void]$sb.AppendLine()
[void]$sb.AppendLine('```text')
[void]$sb.AppendLine($plain)
[void]$sb.AppendLine('```')
}
}
$full = [System.IO.Path]::GetFullPath($Output)
[System.IO.File]::WriteAllText($full, $sb.ToString().Replace("`r`n", "`n"), [System.Text.UTF8Encoding]::new($false))
Write-Host "Written $full"
@@ -31,4 +31,32 @@ public class CoreTextsTests
TextCatalog.Default.Get(CoreTexts.Identity.Invitation.CreateFailed, args: ("errors", "a, b")).Should().Be("Kan gebruiker niet aanmaken: a, b");
TextCatalog.Default.Get(CoreTexts.Identity.Setup.CreateOwnerFailed, args: ("errors", "a, b")).Should().Be("Fout bij aanmaken eigenaar: a, b");
}
[Theory]
[InlineData("core.identity.auth.invalidEmail", "Enter a valid e-mail address.")]
[InlineData("core.identity.auth.resetRequested", "If this address belongs to an account, an e-mail with a link has been sent.")]
[InlineData("core.identity.auth.linkInvalid", "This link is invalid or has expired.")]
[InlineData("core.identity.auth.passwordSet", "Password set. You can sign in now.")]
[InlineData("core.identity.auth.passwordRejected", "The password does not meet the requirements.")]
[InlineData("core.identity.users.emailInUse", "Email is already in use.")]
[InlineData("core.identity.users.unsupportedLanguage", "Unsupported language.")]
[InlineData("core.identity.users.updateProfileFailed", "Failed to update profile.")]
[InlineData("core.identity.users.lastOwner", "At least one Owner must remain.")]
[InlineData("core.identity.users.cannotChangeOwnActive", "You cannot change your own active status.")]
[InlineData("core.identity.users.updateUserFailed", "Failed to update user.")]
[InlineData("core.identity.users.cannotDeleteSelf", "You cannot delete your own account.")]
[InlineData("core.identity.users.deleteUserFailed", "Failed to delete user.")]
public void TheEnglishTexts_OfTheFormerlyEnglishOnlyMessages_AreTheOldWording(string key, string expected)
=> TextCatalog.Default.Get(new TextKey(key), "en").Should().Be(expected);
[Fact]
public void TheInternalErrorDetail_IsTheOldDutchSentence()
=> TextCatalog.Default.Get(CoreTexts.Errors.Internal).Should().Be("Er is een interne serverfout opgetreden.");
[Fact]
public void TheFormerlyEnglishOnlyMessages_AreNowDutchInTheDefaultLanguage()
{
TextCatalog.Default.Get(CoreTexts.Identity.Users.CannotDeleteSelf).Should().Be("Je kunt je eigen account niet verwijderen.");
TextCatalog.Default.Get(CoreTexts.Identity.Auth.ResetRequested).Should().StartWith("Als dit adres bij een account hoort");
}
}
@@ -1,3 +1,4 @@
using SlpModularCms.Core.Texts;
using System.Diagnostics;
using Microsoft.AspNetCore.Diagnostics;
using Microsoft.AspNetCore.Http;
@@ -58,7 +59,7 @@ public class GlobalExceptionHandler : IExceptionHandler
Title = title,
Detail = exception is InvitationOrUserAlreadyExistsException
? exception.Message // Dutch, written for the user, contains no internals
: _env.IsDevelopment() ? exception.ToString() : "Er is een interne serverfout opgetreden.",
: _env.IsDevelopment() ? exception.ToString() : HttpTexts.From(httpContext).Get(CoreTexts.Errors.Internal),
Instance = httpContext.Request.Path
};
+27
View File
@@ -26,6 +26,13 @@ public static class CoreTexts
}
}
/// <summary>Generic error texts of the API (the technical ProblemDetails titles stay in code).</summary>
public static class Errors
{
/// <summary>The detail of a 500 answer outside development: no internals.</summary>
public static readonly TextKey Internal = new("core.errors.internal");
}
/// <summary>Messages of sign-in, invitations and first-time setup (shown to the administrator). Key path <c>core.identity.*</c>.</summary>
public static class Identity
{
@@ -35,6 +42,26 @@ public static class CoreTexts
public static readonly TextKey InvalidRefreshToken = new("core.identity.auth.invalidRefreshToken");
public static readonly TextKey TokenReuse = new("core.identity.auth.tokenReuse");
public static readonly TextKey UserNotFound = new("core.identity.auth.userNotFound");
// Answers of the password-reset endpoints (the admin shows its own text for most of them).
public static readonly TextKey InvalidEmail = new("core.identity.auth.invalidEmail");
public static readonly TextKey ResetRequested = new("core.identity.auth.resetRequested");
public static readonly TextKey LinkInvalid = new("core.identity.auth.linkInvalid");
public static readonly TextKey PasswordSet = new("core.identity.auth.passwordSet");
public static readonly TextKey PasswordRejected = new("core.identity.auth.passwordRejected");
}
/// <summary>Answers of the user-management endpoints.</summary>
public static class Users
{
public static readonly TextKey EmailInUse = new("core.identity.users.emailInUse");
public static readonly TextKey UnsupportedLanguage = new("core.identity.users.unsupportedLanguage");
public static readonly TextKey UpdateProfileFailed = new("core.identity.users.updateProfileFailed");
public static readonly TextKey LastOwner = new("core.identity.users.lastOwner");
public static readonly TextKey CannotChangeOwnActive = new("core.identity.users.cannotChangeOwnActive");
public static readonly TextKey UpdateUserFailed = new("core.identity.users.updateUserFailed");
public static readonly TextKey CannotDeleteSelf = new("core.identity.users.cannotDeleteSelf");
public static readonly TextKey DeleteUserFailed = new("core.identity.users.deleteUserFailed");
}
public static class Invitation
+19 -1
View File
@@ -63,7 +63,12 @@
"invalidCredentials": "Invalid credentials.",
"invalidRefreshToken": "Invalid refresh token.",
"tokenReuse": "Possible token abuse detected. All sessions have been ended.",
"userNotFound": "User not found."
"userNotFound": "User not found.",
"invalidEmail": "Enter a valid e-mail address.",
"resetRequested": "If this address belongs to an account, an e-mail with a link has been sent.",
"linkInvalid": "This link is invalid or has expired.",
"passwordSet": "Password set. You can sign in now.",
"passwordRejected": "The password does not meet the requirements."
},
"invitation": {
"userExists": "A user with this e-mail address already exists.",
@@ -76,6 +81,16 @@
"alreadyInitialized": "The system has already been initialised.",
"createOwnerFailed": "Could not create the owner: {errors}",
"completed": "System initialised successfully. The first owner has been created."
},
"users": {
"emailInUse": "Email is already in use.",
"unsupportedLanguage": "Unsupported language.",
"updateProfileFailed": "Failed to update profile.",
"lastOwner": "At least one Owner must remain.",
"cannotChangeOwnActive": "You cannot change your own active status.",
"updateUserFailed": "Failed to update user.",
"cannotDeleteSelf": "You cannot delete your own account.",
"deleteUserFailed": "Failed to delete user."
}
},
"host": {
@@ -87,6 +102,9 @@
"note": "This page is replaced automatically as soon as the website is deployed.",
"fallback": "<p>There is no website here yet. Manage the site at <a href=\"/admin/\">/admin/</a>.</p>"
}
},
"errors": {
"internal": "An internal server error occurred."
}
}
}
+19 -1
View File
@@ -63,7 +63,12 @@
"invalidCredentials": "Ongeldige inloggegevens.",
"invalidRefreshToken": "Ongeldig refresh token.",
"tokenReuse": "Mogelijk token misbruik gedetecteerd. Alle sessies zijn beëindigd.",
"userNotFound": "Gebruiker niet gevonden."
"userNotFound": "Gebruiker niet gevonden.",
"invalidEmail": "Voer een geldig e-mailadres in.",
"resetRequested": "Als dit adres bij een account hoort, is er een e-mail met een link verstuurd.",
"linkInvalid": "Deze link is ongeldig of verlopen.",
"passwordSet": "Wachtwoord ingesteld. Je kunt nu inloggen.",
"passwordRejected": "Het wachtwoord voldoet niet aan de eisen."
},
"invitation": {
"userExists": "Er bestaat al een gebruiker met dit e-mailadres.",
@@ -76,6 +81,16 @@
"alreadyInitialized": "Systeem is al geïnitialiseerd.",
"createOwnerFailed": "Fout bij aanmaken eigenaar: {errors}",
"completed": "Systeem succesvol geïnitialiseerd. De eerste eigenaar is aangemaakt."
},
"users": {
"emailInUse": "Dit e-mailadres is al in gebruik.",
"unsupportedLanguage": "Deze taal wordt niet ondersteund.",
"updateProfileFailed": "Het profiel kon niet worden bijgewerkt.",
"lastOwner": "Er moet minstens één eigenaar overblijven.",
"cannotChangeOwnActive": "Je kunt je eigen actieve status niet wijzigen.",
"updateUserFailed": "De gebruiker kon niet worden bijgewerkt.",
"cannotDeleteSelf": "Je kunt je eigen account niet verwijderen.",
"deleteUserFailed": "De gebruiker kon niet worden verwijderd."
}
},
"host": {
@@ -87,6 +102,9 @@
"note": "Deze pagina wordt automatisch vervangen zodra de website is geplaatst.",
"fallback": "<p>Er staat hier nog geen website. Beheer via <a href=\"/admin/\">/admin/</a>.</p>"
}
},
"errors": {
"internal": "Er is een interne serverfout opgetreden."
}
}
}
@@ -1,3 +1,4 @@
using SlpModularCms.Core.Texts;
using System.Security.Claims;
using Microsoft.AspNetCore.Authorization;
using Microsoft.AspNetCore.Http;
@@ -101,10 +102,10 @@ public class AuthController : ControllerBase
var email = request?.Email?.Trim();
if (!EmailAddressRules.IsValidAddress(email))
return BadRequest(new { code = "invalid_email", detail = "Enter a valid e-mail address." });
return BadRequest(new { code = "invalid_email", detail = HttpTexts.From(HttpContext).Get(CoreTexts.Identity.Auth.InvalidEmail) });
_dispatcher.Dispatch(email!);
return Accepted(new { message = "If this address belongs to an account, an e-mail with a link has been sent." });
return Accepted(new { message = HttpTexts.From(HttpContext).Get(CoreTexts.Identity.Auth.ResetRequested) });
}
/// <summary>Anonymous. Sets a new password with the link from the mail; only a completed reset ends sessions.</summary>
@@ -118,14 +119,14 @@ public class AuthController : ControllerBase
if (request is null || request.UserId == Guid.Empty
|| string.IsNullOrWhiteSpace(request.Token) || request.Token.Length > 2048
|| string.IsNullOrEmpty(request.NewPassword) || request.NewPassword.Length > 128)
return BadRequest(new { code = "invalid_link", detail = "This link is invalid or has expired." });
return BadRequest(new { code = "invalid_link", detail = HttpTexts.From(HttpContext).Get(CoreTexts.Identity.Auth.LinkInvalid) });
var result = await _passwordReset.ResetAsync(request.UserId, request.Token, request.NewPassword, ct);
return result.Status switch
{
PasswordResetStatus.Succeeded => Ok(new { message = "Password set. You can sign in now." }),
PasswordResetStatus.PasswordRejected => BadRequest(new { code = "password_rejected", detail = "The password does not meet the requirements.", problems = result.Problems }),
_ => BadRequest(new { code = "invalid_link", detail = "This link is invalid or has expired." })
PasswordResetStatus.Succeeded => Ok(new { message = HttpTexts.From(HttpContext).Get(CoreTexts.Identity.Auth.PasswordSet) }),
PasswordResetStatus.PasswordRejected => BadRequest(new { code = "password_rejected", detail = HttpTexts.From(HttpContext).Get(CoreTexts.Identity.Auth.PasswordRejected), problems = result.Problems }),
_ => BadRequest(new { code = "invalid_link", detail = HttpTexts.From(HttpContext).Get(CoreTexts.Identity.Auth.LinkInvalid) })
};
}
@@ -1,3 +1,4 @@
using SlpModularCms.Core.Texts;
using System.Security.Claims;
using Microsoft.AspNetCore.Authorization;
using Microsoft.AspNetCore.Identity;
@@ -105,7 +106,7 @@ public class UsersController : ControllerBase
{
var existing = await _userManager.FindByEmailAsync(request.Email);
if (existing is not null)
return BadRequest(new { detail = "Email is already in use." });
return BadRequest(new { detail = HttpTexts.From(HttpContext).Get(CoreTexts.Identity.Users.EmailInUse) });
}
// null = leave the preference alone (older clients); "" = clear it (use the site default);
@@ -117,7 +118,7 @@ public class UsersController : ControllerBase
else if (MailLanguages.Normalize(request.Language) is { } language)
user.PreferredLanguage = language;
else
return BadRequest(new { detail = "Unsupported language." });
return BadRequest(new { detail = HttpTexts.From(HttpContext).Get(CoreTexts.Identity.Users.UnsupportedLanguage) });
}
user.DisplayName = request.Name;
@@ -128,7 +129,7 @@ public class UsersController : ControllerBase
var result = await _userManager.UpdateAsync(user);
if (!result.Succeeded)
return StatusCode(500, new { detail = "Failed to update profile." });
return StatusCode(500, new { detail = HttpTexts.From(HttpContext).Get(CoreTexts.Identity.Users.UpdateProfileFailed) });
var roles = await _userManager.GetRolesAsync(user);
var role = roles.FirstOrDefault() ?? "User";
@@ -154,7 +155,7 @@ public class UsersController : ControllerBase
return Forbid();
if (!string.IsNullOrEmpty(request.Language) && !MailLanguages.IsSupported(request.Language))
return BadRequest(new { detail = "Unsupported language." });
return BadRequest(new { detail = HttpTexts.From(HttpContext).Get(CoreTexts.Identity.Users.UnsupportedLanguage) });
var token = await _invitationService.CreateInvitationAsync(request.Email, request.Role, request.Language);
var inviteLink = $"/invite/complete?token={Uri.EscapeDataString(token)}";
@@ -249,7 +250,7 @@ public class UsersController : ControllerBase
{
var ownerCount = (await _userManager.GetUsersInRoleAsync("Owner")).Count;
if (ownerCount <= 1)
return BadRequest(new { detail = "At least one Owner must remain." });
return BadRequest(new { detail = HttpTexts.From(HttpContext).Get(CoreTexts.Identity.Users.LastOwner) });
}
if (targetRoles.Count > 0)
@@ -277,7 +278,7 @@ public class UsersController : ControllerBase
if (target is null) return NotFound();
if (IsSelf(target))
return BadRequest(new { detail = "You cannot change your own active status." });
return BadRequest(new { detail = HttpTexts.From(HttpContext).Get(CoreTexts.Identity.Users.CannotChangeOwnActive) });
var targetRoles = await _userManager.GetRolesAsync(target);
var targetRole = targetRoles.FirstOrDefault() ?? "User";
@@ -288,14 +289,14 @@ public class UsersController : ControllerBase
{
var ownerCount = (await _userManager.GetUsersInRoleAsync("Owner")).Count;
if (ownerCount <= 1)
return BadRequest(new { detail = "At least one Owner must remain." });
return BadRequest(new { detail = HttpTexts.From(HttpContext).Get(CoreTexts.Identity.Users.LastOwner) });
}
var wasActive = target.IsActive;
target.IsActive = request.IsActive;
var result = await _userManager.UpdateAsync(target);
if (!result.Succeeded)
return StatusCode(500, new { detail = "Failed to update user." });
return StatusCode(500, new { detail = HttpTexts.From(HttpContext).Get(CoreTexts.Identity.Users.UpdateUserFailed) });
// A notice only on a real change; a mail failure never fails the action.
if (wasActive != request.IsActive)
@@ -324,7 +325,7 @@ public class UsersController : ControllerBase
}
if (IsSelf(target))
return BadRequest(new { detail = "You cannot delete your own account." });
return BadRequest(new { detail = HttpTexts.From(HttpContext).Get(CoreTexts.Identity.Users.CannotDeleteSelf) });
var targetRoles = await _userManager.GetRolesAsync(target);
if (!UserManagementRules.CanManage(await GetRequesterRoleAsync(), targetRoles.FirstOrDefault() ?? "User"))
@@ -334,14 +335,14 @@ public class UsersController : ControllerBase
{
var ownerCount = (await _userManager.GetUsersInRoleAsync("Owner")).Count;
if (ownerCount <= 1)
return BadRequest(new { detail = "At least one Owner must remain." });
return BadRequest(new { detail = HttpTexts.From(HttpContext).Get(CoreTexts.Identity.Users.LastOwner) });
}
await _invitationService.DeleteInvitationsByEmailAsync(target.Email ?? string.Empty);
var result = await _userManager.DeleteAsync(target);
if (!result.Succeeded)
return StatusCode(500, new { detail = "Failed to delete user." });
return StatusCode(500, new { detail = HttpTexts.From(HttpContext).Get(CoreTexts.Identity.Users.DeleteUserFailed) });
return NoContent();
}