Kentico CMS Widgets
The Kentico CMS Widgets reference contains detailed documentation for all widgets that are included in the default Kentico CMS installation and its sample websites. Widgets are building blocks that may be used to define the content of pages by editors, or create unique personalized versions of pages by individual users. The structure of this guide reflects the widget selection catalog, so users can easily find information about a specific widget and its configuration options by looking into the appropriate category.
Widgets introduce support for the personalization of pages. This feature allows users and editors to edit the structure of page templates. The personalized settings are saved within the system and can be invoked from the live site by authorized users or through the CMS Desk interface in the case of website editors and administrators.
From a designer's point of view, widgets are the basic building blocks of page templates in the same way as Web parts. Like web parts, they are placed into zones, which must be configured to contain a certain type of widgets. For more information about web development basics, such as page templates, please refer to the Web development overview -> Portal engine development model chapter of this guide. Widgets may also be used on pages based on ASPX page templates as long as they contain the appropriate zones and are configured as described in ASPX page template development model -> Adding portal engine functionality to ASPX templates.
There is a predefined set of widgets included in the default Kentico CMS installation. A description of these widgets and their properties can be found in the Kentico CMS Widgets reference. Because all widgets are based on existing web parts, you can also add your own widgets. Widgets can be created and managed at Site Manager -> Development -> Widgets. The details are given in the Developing widgets topic.
As mentioned above, widgets provide the same functionality as ordinary web parts. However, users with the appropriate permissions can modify the properties of widgets and their placement on the web page, add and remove widgets from their pages and so on. Users are divided into four different groups according to the possible ways they can use widgets:
- Site developers/Administrators - define the placement of widget zones and their default content, select the web part properties that should be available when configuring widgets and manage all available widgets
- Page editors - define the content of widget zones created on page templates by the site developers/administrators
- Group administrators - define the content of widget zones located on the pages of their group via the live site
- Website users - customize the content of widget zones on personalizable pages via the live site
Widgets can additionally be added directly into editable text areas as described in the Inline widgets topic. Dashboards in the administration interface also utilize widgets as customization components. Please refer to the Modules -> Dashboards chapter for detailed information.
Security issues, such as the definition of where individual widgets can be used and permissions for different types of roles are discussed in the Security topic.
The Widget internals and API sub-chapter provides information about the database tables and classes used by widgets and examples of how widgets can be managed using the API.