Version
Sitefinity 15.1 Sitefinity 15.0 Sitefinity 14.4 Sitefinity 14.0 Sitefinity 13.3

Topics

All topics

Create a widget template

Custom widgets are usually represented by a class, which implements their functionality. The mechanism of creating widgets in Sitefinity CMS allows you to specify a template. With a template you can specify the visual representation of your widget. A template is represented by an .ascx file. 

To create a widget template:

  1. In the context menu of your project, click Add » New Folder.
    Name the folder, for example, MyCustomWidgetFolder.
  2. From the context menu of the new folder, click Add » New Item...
  3. From the dialog click Visual C# » Code » Code File.
  4. Name the file the way you want your widget to be displayed in the toolbox, for example MyCustomWidget.ascx.
  5. Click Add.
    An empty .ascx file is generated under the MyCustomWidgetFolder folder.
  6. From the context menu of file MyCustomWidget.ascx, select Properties.
  7. In the Properties pane, set the Build Action property of the file to Embedded Resource.
    You do this to make the template a part of the compiled assembly.

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

Web Security for Sitefinity Administrators

The free standalone Web Security lesson teaches administrators how to protect your websites and Sitefinity instance from external threats. Learn to 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

Reference a widget template