Topics

All topics

Sample: Language selector widget

Overview

Use the Language selector widget sample to create a language selector widget, which you can use to switch between different language versions of a page

IRequestPreparation interface

This sample shows how two widgets can communicate with each other in the early stage of the pipeline. 

PREREQUISITES: You must set up:
  • Sitefinity renderer application and connect it to your Sitefinity CMS application.
    For more information, see Install Sitefinity in ASP.NET Core mode.
  • Set up Sitefinity CMS in multilingual mode and translate the page where the Language selector widget is placed.
    For more information, see .

NOTE: The instructions in this sample use Visual Studio 2022 and a Sitefinity renderer project named Renderer.

Create the folder structure

Under your Renderer project, you must create the following folders:

  • Entities/LanguageSelector
  • Models/LanguageSelector
  • ViewModelsLanguageSelector
  • ViewComponents
  • Views/Shared/Components/LanguageSelector

Create the widgets
  • In the context menu of folder Entities/LanguageSelector, click Add » Class…
  • In Name, enter LanguageSelectorEntity.cs and click Add.
  • In the class, paste the following code and save your changes:

  • In the context menu of folder Models/LanguageSelector, click Add » Class…
  • In Name, enter LanguageSelectorModel.cs and click Add.
  • In the class, paste the following code and save your changes:

  • In the context menu of folder ViewModels/LanguageSelector, click Add » Class…
  • In Name, enter LanguageSelectorViewModel.cs and click Add.
  • In the class, paste the following code and save your changes:

  • In the context menu of folder ViewModels/LanguageSelector, click Add » Class…
  • In Name, enter LanguageEntity.cs and click Add.
  • In the class, paste the following code and save your changes:

  • In the context menu of folder ViewComponents, click Add » Class…
  • In Name, enter LanguageSelectorViewComponent.cs and click Add.
  • In the class, paste the following code and save your changes:

  • In the context menu of folder Views/Shared/Components/LanguageSelector, click Add » Class…
  • Select Code File.
  • In Name, enter Default.cshtml and click Add.
  • In the class, paste the following code and save your changes:

Build your solution.

Result

When you open your Renderer application and open the New editor, you will see the Language selector widget in the widget selector.

LanguageSelector 

Run the sample

This sample is available in Sitefinity’s GitHub repository. You can run and play with it.
To do this, perform the following:

  1. Go to Sitefinity’s GitHub repository Sitefinity ASP.NET Core samples.
  2. Expand Code and click Download ZIP.
  3. Extract the files on your computer.
  4. In the extracted folder, navigate to sitefinity-aspnetcore-mvc-samples-master/src/language-selector folder.
  5. Open the language-selector.sln in Visual Studio.
  6. Open the appsettings.json file.
  7. In section “Sitefinity”, change the “Url” property to the URL of your Sitefinity CMS site.
    If you have deployed Sitefinity CMS on the IIS, point to “https://localhost:<https_port>".
  8. In Visual Studio, in the context menu of language-selector project, click View in Browser.
  9. Log in to your Sitefinity CMS instance and place the widget on a page.

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

Sample: Localized widget