Customize the label of the search button in a multiple site project

This article describes how to customize the label of the search buttons on the different sites in your multiple site project. There are two approaches for customizing the label – you can hard-code the label for each site and you can dynamically change the label via the Labels & Messages page.

The two approaches below assume that you have three sites, named FirstSite, SecondSite, and ThirdSite. You want the search button label to be different on all sites:

  • FirstSite – the standard label Search
  • SecondSite – custom labeled Search2
  • ThirsdSite – custom label Seach3

To display different text in different search buttons, you must create a custom search widget.
Perform the following:

  1. Open your project in Visual studio.
  2. In the context menu of SitefinityWebApp, click Add » New Item…
  3. Under Visual C#, click Web » Web User Control.
  4. In Name, enter CustomButton.ascx
    You will use the file as template for the custom search widget.
  5. Inside the CustomButton.ascx, place the markup of the widget.

    EXAMPLE: For more information about the contents of the file, see the CustomButton.ascx in Sitefinity documentation-samples on GitHub.

  6. Register the custom widget template for search box widget by mapping the newly created widget to the standard Search widget.
    Perform the following:
    1. In the backend, click Administration » Settings » Advanced » Controls » ViewMap » Create new.
    2. In Host, enter Telerik.Sitefinity.Services.Search.Web.UI.Public.SearchBox
    3. In LayoutTemplate, enter ~/CustomButton.ascx
    4. Save your changes.
  7. Use one of the following approaches to display the custom button label.

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

Edit site permissions