## Overview

This widget provides a user interface for adding localized text for use in the wizard. This widget is available on the wizard configuration page.

The Wizard Localizations widget allows administrators to define, edit, and maintain translations for all wizard UI elements (labels, buttons, messages, etc.) across multiple languages, ensuring wizards can be presented based on user language preferences.

## Use Cases

### Multi-Language Wizard Support

When building a wizard that needs to support users in different languages, this widget allows you to:
- Define translations for all wizard UI elements in a single location
- Manage language variants for labels, buttons, messages, and other text
- Ensure consistency across the wizard's interface

**Example Scenario**: A company operates in Germany, France, and the UK. They create an onboarding wizard that needs to display in German, French, and English. Using this widget, they define all text elements with translations for each language code (de, fr, en).

### Localization Quality Assurance

The widget helps identify configuration issues:
- Detects when localizations reference languages not enabled in the system
- Provides warnings for "unsupported languages" that won't be accessible to users
- Helps administrators audit and maintain localization completeness

## Design Considerations

### When to Use This Widget

Use this widget when:
- Your wizard needs to support multiple languages
- You need a centralized interface for managing all wizard translations
- You want to ensure translation consistency across the wizard interface
- You need to validate that all configured languages are properly supported

### Integration with Forms Wizard

This widget is part of the Forms Wizard feature set, which enables low-code creation of multi-step forms and workflows. Localizations are essential for making these wizards accessible to international user bases. The widget reads from and writes to a dedicated localization attribute on wizard entities, ensuring all modifications are properly controlled and validated.

## Common Pitfalls

- **Unsupported Languages**: Adding translations for languages not configured in cplace's system settings will generate warnings, as these translations won't be accessible to users
- **Missing Translations**: Ensure all keys have translations for all supported languages to avoid fallback behavior or missing text
- **Read-Only Attribute**: The underlying localization attribute is read-only; all modifications must go through this widget's interface

## Related Patterns

- **Forms Wizard Framework**: This widget is a specialized component within the broader Forms Wizard feature set
- **Multi-Language Data Management**: Uses cplace's standard localization infrastructure (LocalizedString, language codes)