orchardcore-content-localization

Orchard Core Content Localization

Guidelines

• Enable OrchardCore.ContentLocalization (depends on Content Types and Localization) to manage localized versions of content items. Configure the site cultures first (see orchardcore-localization).
• Attach LocalizationPart to every content type that needs translations. Each item stores its Culture; all translations share a LocalizationSet.
• Enable OrchardCore.ContentLocalization.ContentCulturePicker (requires Autoroute) for a front-end culture picker and URL-based culture detection.
• Enable OrchardCore.ContentLocalization.Sitemaps for localized sitemaps with hreflang alternates.
• Use switch_culture_url and localization_set Liquid filters for custom culture switchers and lookups.
• All recipe JSON must be wrapped in { "steps": [...] }.
• All C# classes must use the sealed modifier, except View Models.

Enabling Content Localization Features

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

Attaching LocalizationPart to a Content Type

using OrchardCore.ContentManagement.Metadata;
using OrchardCore.ContentManagement.Metadata.Settings;
using OrchardCore.Data.Migration;

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;
    }
}

Attaching LocalizationPart via Recipe

{
  "steps": [
    {
      "name": "ContentDefinition",
      "ContentTypes": [
        {
          "Name": "Article",
          "DisplayName": "Article",
          "Settings": {
            "ContentTypeSettings": {
              "Creatable": true,
              "Listable": true,
              "Draftable": true
            }
          },
          "ContentTypePartDefinitionRecords": [
            {
              "PartName": "LocalizationPart",
              "Name": "LocalizationPart"
            },
            {
              "PartName": "TitlePart",
              "Name": "TitlePart"
            }
          ]
        }
      ]
    }
  ]
}