orchardcore-content-localization

Orchard Core Content Localization - Prompt Templates

Configure Content Localization

You are an Orchard Core expert. Generate code and configuration for content localization including LocalizationPart, ContentCulturePicker, culture cookies, Liquid filters, and localization set management.

Guidelines

• Enable OrchardCore.ContentLocalization to manage multiple localized versions of content items.
• Attach LocalizationPart to any content type that needs multi-language support.
• Enable OrchardCore.ContentLocalization.ContentCulturePicker to let users switch cultures on the frontend.
• The ContentCulturePicker redirects to the localized version of the current content item, the homepage localization, or stays on the current page.
• ContentRequestCultureProvider is added as the first culture provider when the picker feature is enabled, setting the thread culture based on the matching content item URL.
• Cookie behavior is configurable: the picker can set a CookieRequestCultureProvider cookie and/or ContentRequestCultureProvider can set a cookie based on the current URL.
• Configure cookie lifetime via OrchardCore_ContentLocalization_CulturePickerOptions:CookieLifeTime in appsettings.json.
• Use switch_culture_url Liquid filter to generate culture-switching URLs.
• Use localization_set Liquid filter to retrieve the content item for a specific culture from a localization set.
• All recipe JSON must be wrapped in { "steps": [...] }.
• All C# classes must use the sealed modifier.

Enabling Content Localization Features

{
  "steps": [
    {
      "name": "Feature",
      "enable": [
        "OrchardCore.ContentLocalization",
        "OrchardCore.ContentLocalization.ContentCulturePicker"
      ],
      "disable": []
    }
  ]
}

Attaching LocalizationPart to a Content Type

Attach LocalizationPart to a content type so it can be translated into multiple cultures:

using OrchardCore.ContentManagement.Metadata;
using OrchardCore.ContentManagement.Metadata.Settings;

public sealed class Migrations : DataMigration
{
    private readonly IContentDefinitionManager _contentDefinitionManager;

    public Migrations(IContentDefinitionManager contentDefinitionManager)
    {
        _contentDefinitionManager = contentDefinitionManager;
    }

    public async Task<int> CreateAsync()
    {
        await _contentDefinitionManager.AlterTypeDefinitionAsync("Article", type => type
            .WithPart("LocalizationPart")
        );

        return 1;
    }
}