Language selector

The following tutorial demonstrates how to add a Language selector in your widget's designer. You use the Language selector to select different cultures, defined in your Sitefinity CMS application. 

Add Language selectors

  1. Sitefinity CMS automatically registers the scripts you need and, if no other designer view with explicitly set priority exists, Sitefinity CMS sets your designer view priority 1. In case you need to have full control over the scripts that are loaded or you want to set custom priority, you can alternatively create your own DesignerView.YourView.json file. If you have a JSON file that matches the convention (even if empty), this automatic scripts registration will not occur. In your DesignerView.<YourView>.json file, add a scripts array. The content of the file should be similar to the following:

    For more information on the scripts that you must load, see List of selectors scripts reference.

  2. Sitefinity CMS automatically finds all AngularJS modules you rely on and references the widget designer to them. In case you rely on custom AngularJS modules or have logic that needs an AngularJS controller, you can create your own designerview-<yourview>.js file. If you have a .js file that matches the convention (even if empty), this automatic modules referencing will not occur. In your designerview-<yourview>.js file, place the following code right before the definition of your custom view controller:
  3. In your DesignerView.<YourView>.cshtml file, place the following tag where you want to render the Language selector:

    NOTE: You must use the sf-site attribute with the Language selector.

Get or set the selected culture

To load the culture for a specific site, you use the sf-site attribute. You can use the optional attribute sf-culture to access the selected culture. The value of these attributes are scope properties -sfCulture and sfSite - that you must add in your widget's controller:

NOTE: If you do not supply an sfSite attribute value, the Language selector is not rendered .

You can combine The Language selector to work alongside the Site selector to display the selected site's available cultures.

The sf-site attribute has the following structure of the JSON properties:

The sf-culture attribute has the following structure of the JSON properties:

Increase your Sitefinity skills by signing up for our free trainings. Get Sitefinity-certified at Progress Education Community to boost your credentials.

Get started with Integration Hub | Sitefinity Cloud | Sitefinity SaaS

This free lesson teaches administrators, marketers, and other business professionals how to use the Integration hub service to create automated workflows between Sitefinity and other business systems.

Web Security for Sitefinity Administrators

This free lesson teaches administrators the basics about protecting yor Sitefinity instance and its sites from external threats. Configure HTTPS, SSL, allow lists for trusted sites, and cookie security, among others.

Foundations of Sitefinity ASP.NET Core Development

The free on-demand video course teaches developers how to use Sitefinity .NET Core and leverage its decoupled architecture and new way of coding against the platform.

Was this article helpful?

Next article

File URL selector