+1-888-365-2779
Try Now
More in this section
Categories
Bloggers
Blogs RSS feed

5 Things: Useful Examples of the Sitefinity ViewMap

by Josh Morales

As we discovered in last week’s post Customizing Sitefinity 4 Controls with the ViewMap, the ViewMap is a simple but powerful way to take control of your controls, allowing you to globally map all instances of those controls to a custom external template file.

Templates

The Sitefinity 4 SDK includes a zip file containing all of the templates used by the system. You can extract these from the default location of C:\Program Files (x86)\Telerik\Sitefinity 4.x\SDK\Content\Resources\WidgetTemplates.zip.

Use these as starting points for your external templates, modifying them as needed to fit the needs of your site.

Note: Although you can edit the markup in your custom templates as you see fit, be sure not to remove any of the actual server controls (labels, textboxes, etc.) as the will likely be required by the backing control.

Examples

Here’s a few more ideas for controls that you can customize with the ViewMap. Remember that these are global mappings, meaning that all instances of the control will now use your mapping.

HtmlField

HostType: Telerik.Sitefinity.Web.UI.Fields.HtmlField

We previously saw how you can map the HtmlField to change the Toolbox in the RadEditor. However, by mapping to an external template, you can set any property of the RadEditor.

For example, by changing the EditModes property, you can enable only the Html view for the editor.

Sitefinity-4-ViewMap-Html-Only-Editor


SearchBox

HostType: Telerik.Sitefinity.Services.Search.Web.UI.Public.SearchBox

The search box doesn’t currently offer a way to set the external template from the control designer itself. The ViewMap overcomes this and allows you to specify your own external template to layout the search box however you wish.

Sitefinity-4-ViewMap-Custom-Search-Template


Image

HostType: Telerik.Sitefinity.Web.UI.PublicControls.ImageControl

Mapping the various content widgets such as the Image allow you to add simple customizations to every instance of the widget on your site.

In this example, I’ve modified the Image control to wrap itself with a CSS class so that I can style all images consistently throughout the site with padding and a border.

Sitefinity-4-ViewMap-Customized-Widgets


Login

HostType: Telerik.Sitefinity.Web.UI.PublicControls.LoginControl

By mapping the login control to a global template, you can easily customize it with a new layout and structure.

Sitefinity-4-ViewMap-Custom-Login-Template


Pager

HostType: Telerik.Sitefinity.Web.UI.Pager

The great thing about mapping the pager is that it will globally configure ALL pager instances, regardless of the module (News, Events, etc) so that you can have a custom, yet consistent layout.

Sitefinity-4-ViewMap-Custom-Pager


Conclusion

This is just a short collection of ideas to show examples of the ViewMap in action. Any templateable control in Sitefinity can be globally mapped to an external template with the ViewMap, allowing you to quickly and easily customize your controls.

Take a moment to download the Sitefinity SDK and extract the templates from the Resources folder to customize your own external templates. And be sure to share your experiences, comments, and suggestions with us in the Sitefinity SDK forum.

3 comments

Leave a comment
  1. Mike Aug 03, 2011
    and how do we add these templates to our website to customize them for our needs? Do we add them via the admin section, create an XML file like we  did in 3.x, etc.? How is it done, thats a key piece and it's missing or I can't find it or something
  2. Mike Aug 03, 2011
    and how do we add these templates to our website to customize them for our needs? Do we add them via the admin section, create an XML file like we  did in 3.x, etc.? How is it done, thats a key piece and it's missing or I can't find it or something
  3. Josh Aug 03, 2011
    the template files can be extracted from the SDK, then copied to a folder in your site, then customize them with Visual Studio or any text editor.

    We are already looking to improve this experience so that you can add them from the admin interface as well as manage them in the widget templates editor in a future release.

    thank you for your feedback I will certainly share it with the team!

    Leave a comment