orchardcore-localization

Orchard Core Localization

Use OrchardCore.Localization for UI localization with PO files, OrchardCore.DataLocalization for database-backed dynamic strings (see orchardcore-data-localization), and OrchardCore.ContentLocalization for translated content items (see orchardcore-content-localization).

Feature	Purpose
OrchardCore.Localization	PO localization, culture settings (Settings → Localization → Cultures), request localization.
OrchardCore.Localization.ContentLanguageHeader	Adds the Content-Language response header.
OrchardCore.Localization.AdminCulturePicker	Admin navbar culture picker (admin culture cookie), shown when more than one culture is supported.

Culture Settings

{
  "steps": [
    {
      "name": "Feature",
      "enable": [
        "OrchardCore.Localization",
        "OrchardCore.Localization.AdminCulturePicker"
      ]
    },
    {
      "name": "Settings",
      "LocalizationSettings": {
        "DefaultCulture": "en-US",
        "SupportedCultures": ["en-US", "fr-FR"],
        "FallBackToParentCulture": true
      }
    }
  ]
}

The cultures page requires OrchardCore.Localization.LocalizationPermissions.ManageCultures. The Culture settings deployment step exports LocalizationSettings. Read the configured cultures through ILocalizationService (GetDefaultCultureAsync(), GetSupportedCulturesAsync(), GetAllCulturesAndAliases()).

Host-level culture behavior is configured in OrchardCore:Localization:CultureOptions:

{
  "OrchardCore": {
    "Localization": {
      "CultureOptions": {
        "IgnoreSystemSettings": true
      }
    }
  }
}

IgnoreSystemSettings stops the OS user's custom date and number formats from affecting cultures. Do not invent other localization configuration sections.

UI Strings

Use the localizer typed to the class that owns the string, and IHtmlLocalizer only for trusted translation markup:

using Microsoft.Extensions.Localization;

namespace MyModule.Services;

public sealed class GreetingService
{
    internal readonly IStringLocalizer S;

    public GreetingService(IStringLocalizer<GreetingService> stringLocalizer)
    {
        S = stringLocalizer;
    }

    public string Greet(string name, int count)
        => S["Hello {0}!", name] + " " + S.Plural(count, "{0} new message", "{0} new messages");
}