Skip to content

Installing Localization Files

In this guide you will download and install community managed localization files to localize the Admin of Orchard Core CMS.

What you will need

Downloading the localization files

Localization files are managed by the community on the Crowdin website. Anyone can provide custom languages or contribute to existing ones.

image

For this guide we will download the French language.

  • Click on French, a page with the list of all .pot files should appear.
  • Click on the Download or Upload button on the top right of the page.
  • Select Download, a zip file named fr.zip will be downloaded by your browser.

image

Extracting the localization files

The zip file that you downloaded needs to be extracted in the App_Data/Localization folder of your Orchard Core CMS website.

  • Create a folder named Localization under [your_site_root]/App_Data where your_site_root is the location of your website.
  • Extract the file fr.zip in App_Data/Localization

The result should look like this:

image

Configuring the supported cultures

By default a new Orchard Core CMS website will only accept the default system culture. This step will configure it to accept French as an alternate language.

  • Open the Admin section of Orchard Core CMS by opening the browser on https://localhost:5001/admin.
  • In the Configuration, Settings, General section click on Add or remove supported cultures for the site.
  • Select fr | French then click Add.
  • Click on the Manage Settings menu item link which redirects to the General settings page.
  • Click on Save, the site is reloaded.

Enabling localization and testing the site

To enable Orchard Core CMS to use these new files, we need to enable the Localization feature.

At that point most texts should be displayed in French. From now on if a browser is configured with French as its default culture, the Admin will be displayed using the French text translations we downloaded. The ?culture=fr is just one way to simulate that the current request should use French as the UI culture.

image

Summary

You just downloaded and enabled a new localization in Orchard Core CMS.