Skip to content

Commit a2fad6d

Browse files
yoelhoryoelhor
authored
Update localization.md
Removing the how to section and adding text steps
1 parent 7254f38 commit a2fad6d

File tree

1 file changed

+5
-157
lines changed

1 file changed

+5
-157
lines changed

‎articles/active-directory-b2c/localization.md

Lines changed: 5 additions & 157 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ manager: celestedg
88
ms.service: active-directory
99
ms.workload: identity
1010
ms.topic: reference
11-
ms.date: 03/09/2020
11+
ms.date: 03/11/2020
1212
ms.author: mimart
1313
ms.subservice: B2C
1414
---
@@ -203,161 +203,9 @@ Under the **BuildingBlocks** element, add the **Localization** element with the
203203
</Localization>
204204
```
205205

206-
### Provide language-specific strings and collections
206+
## Next steps
207207

208-
Add **LocalizedResources** elements inside the **Localization** element after the close of the **SupportedLanguages** element. You add **LocalizedResources** elements for each page (content definition) and any language you want to support. To customize the unified sign-up or sign-in page, sign-up and multi-factor authentication (MFA) pages for English, Spanish, and France, you add the following **LocalizedResources** elements.
209-
210-
- Unified sign-up or sign-in page, English `<LocalizedResources Id="api.signuporsignin.en">`
211-
- Unified sign-up or sign-in page, Spanish `<LocalizedResources Id="api.signuporsignin.es">`
212-
- Unified sign-up or sign-in page, France `<LocalizedResources Id="api.signuporsignin.fr">`
213-
- Sign-Up, English `<LocalizedResources Id="api.localaccountsignup.en">`
214-
- Sign-Up, Spanish `<LocalizedResources Id="api.localaccountsignup.es">`
215-
- Sign-Up, France `<LocalizedResources Id="api.localaccountsignup.fr">`
216-
- MFA, English `<LocalizedResources Id="api.phonefactor.en">`
217-
- MFA, Spanish `<LocalizedResources Id="api.phonefactor.es">`
218-
- MFA, France `<LocalizedResources Id="api.phonefactor.fr">`
219-
220-
Each **LocalizedResources** element contains all of the required **LocalizedStrings** elements with multiple **LocalizedString** elements and **LocalizedCollections** elements with multiple **LocalizedCollection** elements. The following example adds the sign-up page English localization:
221-
222-
Note: This example makes a reference to `Gender` and `City` claim types. To use this example, make sure you define those claims. For more information, see [ClaimsSchema](claimsschema.md).
223-
224-
```XML
225-
<LocalizedResources Id="api.localaccountsignup.en">
226-
227-
<LocalizedCollections>
228-
<LocalizedCollection ElementType="ClaimType" ElementId="Gender" TargetCollection="Restriction">
229-
<Item Text="Female" Value="F" />
230-
<Item Text="Male" Value="M" />
231-
</LocalizedCollection>
232-
<LocalizedCollection ElementType="ClaimType" ElementId="City" TargetCollection="Restriction">
233-
<Item Text="New York" Value="NY" />
234-
<Item Text="Paris" Value="Paris" />
235-
<Item Text="London" Value="London" />
236-
</LocalizedCollection>
237-
</LocalizedCollections>
238-
239-
<LocalizedStrings>
240-
<LocalizedString ElementType="ClaimType" ElementId="email" StringId="DisplayName">Email</LocalizedString>
241-
<LocalizedString ElementType="ClaimType" ElementId="email" StringId="UserHelpText">Please enter your email</LocalizedString>
242-
<LocalizedString ElementType="ClaimType" ElementId="email" StringId="PatternHelpText">Please enter a valid email address</LocalizedString>
243-
<LocalizedString ElementType="UxElement" StringId="button_continue">Create new account</LocalizedString>
244-
<LocalizedString ElementType="ErrorMessage" StringId="UserMessageIfClaimsPrincipalAlreadyExists">The account you are trying to create already exists, please sign-in.</LocalizedString>
245-
</LocalizedStrings>
246-
</LocalizedResources>
247-
```
248-
249-
The sign-up page localization for Spanish.
250-
251-
```XML
252-
<LocalizedResources Id="api.localaccountsignup.es">
253-
254-
<LocalizedCollections>
255-
<LocalizedCollection ElementType="ClaimType" ElementId="Gender" TargetCollection="Restriction">
256-
<Item Text="Femenino" Value="F" />
257-
<Item Text="Masculino" Value="M" />
258-
</LocalizedCollection>
259-
<LocalizedCollection ElementType="ClaimType" ElementId="City" TargetCollection="Restriction">
260-
<Item Text="Nueva York" Value="NY" />
261-
<Item Text="París" Value="Paris" />
262-
<Item Text="Londres" Value="London" />
263-
</LocalizedCollection>
264-
</LocalizedCollections>
265-
266-
<LocalizedStrings>
267-
<LocalizedString ElementType="ClaimType" ElementId="email" StringId="DisplayName">Dirección de correo electrónico</LocalizedString>
268-
<LocalizedString ElementType="ClaimType" ElementId="email" StringId="UserHelpText">Dirección de correo electrónico que puede usarse para ponerse en contacto con usted.</LocalizedString>
269-
<LocalizedString ElementType="ClaimType" ElementId="email" StringId="PatternHelpText">Introduzca una dirección de correo electrónico.</LocalizedString>
270-
<LocalizedString ElementType="UxElement" StringId="button_continue">Crear</LocalizedString>
271-
<LocalizedString ElementType="ErrorMessage" StringId="UserMessageIfClaimsPrincipalAlreadyExists">Ya existe un usuario con el id. especificado. Elija otro diferente.</LocalizedString>
272-
</LocalizedStrings>
273-
</LocalizedResources>
274-
```
275-
276-
### Edit the ContentDefinition for the page
277-
278-
For each page that you want to localize, specify the language codes to look for in the **ContentDefinition**.
279-
280-
In the following example, English (en) and Spanish (es) custom strings are added to the sign-up page. The **LocalizedResourcesReferenceId** for each **LocalizedResourcesReference** is the same as their locale, but you could use any string as the identifier. For each language and page combination, you point to the corresponding **LocalizedResources** you previously created.
281-
282-
```XML
283-
<ContentDefinition Id="api.localaccountsignup">
284-
...
285-
<LocalizedResourcesReferences MergeBehavior="Prepend">
286-
<LocalizedResourcesReference Language="en" LocalizedResourcesReferenceId="api.localaccountsignup.en" />
287-
<LocalizedResourcesReference Language="es" LocalizedResourcesReferenceId="api.localaccountsignup.es" />
288-
</LocalizedResourcesReferences>
289-
</ContentDefinition>
290-
```
291-
292-
The following example shows the final XML:
293-
294-
```XML
295-
<BuildingBlocks>
296-
<ContentDefinitions>
297-
<ContentDefinition Id="api.localaccountsignup">
298-
<!-- Other content definitions elements... -->
299-
<LocalizedResourcesReferences MergeBehavior="Prepend">
300-
<LocalizedResourcesReference Language="en" LocalizedResourcesReferenceId="api.localaccountsignup.en" />
301-
<LocalizedResourcesReference Language="es" LocalizedResourcesReferenceId="api.localaccountsignup.es" />
302-
</LocalizedResourcesReferences>
303-
</ContentDefinition>
304-
<!-- More content definitions... -->
305-
</ContentDefinitions>
306-
307-
<Localization Enabled="true">
308-
309-
<SupportedLanguages DefaultLanguage="en" MergeBehavior="ReplaceAll">
310-
<SupportedLanguage>en</SupportedLanguage>
311-
<SupportedLanguage>es</SupportedLanguage>
312-
<!-- More supported language... -->
313-
</SupportedLanguages>
314-
315-
<LocalizedResources Id="api.localaccountsignup.en">
316-
<LocalizedCollections>
317-
<LocalizedCollection ElementType="ClaimType" ElementId="Gender" TargetCollection="Restriction">
318-
<Item Text="Female" Value="F" />
319-
<Item Text="Male" Value="M" />
320-
<!-- More items... -->
321-
</LocalizedCollection>
322-
<LocalizedCollection ElementType="ClaimType" ElementId="City" TargetCollection="Restriction">
323-
<Item Text="New York" Value="NY" />
324-
<Item Text="Paris" Value="Paris" />
325-
<Item Text="London" Value="London" />
326-
</LocalizedCollection>
327-
<!-- More localized collections... -->
328-
</LocalizedCollections>
329-
<LocalizedStrings>
330-
<LocalizedString ElementType="ClaimType" ElementId="email" StringId="DisplayName">Email</LocalizedString>
331-
<LocalizedString ElementType="ClaimType" ElementId="email" StringId="UserHelpText">Please enter your email</LocalizedString>
332-
<LocalizedString ElementType="ClaimType" ElementId="email" StringId="PatternHelpText">Please enter a valid email address</LocalizedString>
333-
<LocalizedString ElementType="UxElement" StringId="button_continue">Create new account</LocalizedString>
334-
<LocalizedString ElementType="ErrorMessage" StringId="UserMessageIfClaimsPrincipalAlreadyExists">The account you are trying to create already exists, please sign-in.</LocalizedString>
335-
<!-- More localized strings... -->
336-
</LocalizedStrings>
337-
</LocalizedResources>
338-
339-
<LocalizedResources Id="api.localaccountsignup.es">
340-
<LocalizedCollections>
341-
<LocalizedCollection ElementType="ClaimType" ElementId="Gender" TargetCollection="Restriction">
342-
<Item Text="Femenino" Value="F" />
343-
<Item Text="Masculino" Value="M" />
344-
</LocalizedCollection>
345-
<LocalizedCollection ElementType="ClaimType" ElementId="City" TargetCollection="Restriction">
346-
<Item Text="Nueva York" Value="NY" />
347-
<Item Text="París" Value="Paris" />
348-
<Item Text="Londres" Value="London" />
349-
</LocalizedCollection>
350-
</LocalizedCollections>
351-
<LocalizedStrings>
352-
<LocalizedString ElementType="ClaimType" ElementId="email" StringId="DisplayName">Dirección de correo electrónico</LocalizedString>
353-
<LocalizedString ElementType="ClaimType" ElementId="email" StringId="UserHelpText">Dirección de correo electrónico que puede usarse para ponerse en contacto con usted.</LocalizedString>
354-
<LocalizedString ElementType="ClaimType" ElementId="email" StringId="PatternHelpText">Introduzca una dirección de correo electrónico.</LocalizedString>
355-
<LocalizedString ElementType="UxElement" StringId="button_continue">Crear</LocalizedString>
356-
<LocalizedString ElementType="ErrorMessage" StringId="UserMessageIfClaimsPrincipalAlreadyExists">Ya existe un usuario con el id. especificado. Elija otro diferente.</LocalizedString>
357-
</LocalizedStrings>
358-
</LocalizedResources>
359-
<!-- More localized resources... -->
360-
</Localization>
361-
</BuildingBlocks>
362-
```
208+
See the following article, for example of using localiztion:
363209

210+
- [Language customization with custom policy in Azure Active Directory B2C](custom-policy-localization.md)
211+
- [Language customization with user flows in Azure Active Directory B2C](user-flow-language-customization.md)

0 commit comments

Comments
 (0)