Skip to content

ContentLocalization (OrchardCore.ContentLocalization)

This module allows you to localize your content items.

LocalizationPart

Attach this part to a content type to manage multiple localized versions of a content item.

ContentCulturePicker (OrchardCore.ContentLocalization.ContentCulturePicker)

ContentCulturePicker Feature

The ContentCulturePicker feature helps you manage cultures for the frontend.

Enabling this module results in

  • A ContentRequestCultureProvider being added as the first method used to determine the current thread culture. This Provider will set the thread culture based on the ContentItem that matches the current url.
  • 2 shapes (described below) are available to the frontend theme.

The ContentCulturePicker selects the url to redirect using the following rules

  • If the ContentItem has a related ContentItem for the selected culture, it redirects to that Item.
  • OR If a HomePage is specified, attempts to find a Localization of the Homepage ContentItem for the current culture.
  • OR redirects to the current page.

By default, the ContentCulturePicker sets a cookie for the CookieRequestCultureProvider. This can be disabled in the Configuration/Settings/ContentCulturePicker settings page.

Recipe Step

The cookie can be set during recipes using the settings step. Here is a sample step:

{
  "name": "settings",
  "ContentCulturePickerSettings": {
    "SetCookie": true
  },
},

Shapes

ContentCulturePicker

The ContentCulturePicker shape loads data for the ContentCulturePickerContainer shape.
You should always render this shape in your theme:

{% shape "ContentCulturePicker" %}
<shape type="ContentCulturePicker" />

ContentCulturePickerContainer

The ContentCulturePickerContainer shape is used to render the CulturePicker. You should override this shape in your theme.

Property Description
Model.CurrentCulture CultureViewModel {Name, DisplayName} representing the current thread culture.
Model.SupportedCultures A list of CultureViewModel objects for all supported cultures.
ContentCulturePickerContainer Example
<ul>
    <li class="nav-item dropdown">
        <a class="nav-link dropdown-toggle" href="#" id="oc-culture-picker" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">{{Model.CurrentCulture.DisplayName}}</a>
        <div class="dropdown-menu" aria-labelledby="oc-culture-picker">
        {% for culture in Model.SupportedCultures %}
            {% if culture.Name != Model.CurrentCulture.Name  %}
            <a class="dropdown-item" href="{{culture.Name | switch_culture_url }}">{{culture.DisplayName}}</a>
            {% endif %}
        {% endfor %}
        </div>
    </li>
</ul>

``` html

```

Liquid filters

switch_culture_url

Returns the URL of the Action that switches cultures.

Input

{{ Model.Culture.Name | switch_culture_url }}

Output

/Loc1/RedirectToLocalizedContent?targetculture=fr&contentItemUrl=%2Fblog

localization_set

Returns the content item in the specified culture (defaults to request culture).

Input

{{ Model.ContentItem.Content.LocalizationPart.LocalizationSet | localization_set: "en" }}

Output

Title

Last update: August 12, 2020