USER MANUAL

1. Welcome to Sitefinity ............................................................................................................................ 6 2. About this Manual .................................................................................................................................. 7
Purpose............................................................................................................................................................................. 7 Intended Readership ................................................................................................................................................. 8 License Agreement ..................................................................................................................................................... 9

3. Basic Features and Concepts .......................................................................................................... 14 4. Login ......................................................................................................................................................... 21 5. The Sitefinity Workspace ................................................................................................................. 22
My Preferences .......................................................................................................................................................... 23 General Settings ................................................................................................................................................... 23 Dashboard Settings ............................................................................................................................................ 25 Page Editor Settings .......................................................................................................................................... 27 My Profile ..................................................................................................................................................................... 28

6. Working with Page Templates ....................................................................................................... 30
Master Pages and Templates Overview ....................................................................................................... 30 Setting Template Properties .............................................................................................................................. 32 Editing a Template .................................................................................................................................................. 32 Templates Versioning ............................................................................................................................................ 33 Duplicating a Template ......................................................................................................................................... 34 Deleting a Template ................................................................................................................................................ 34

7. Working with Web Pages ................................................................................................................. 35
Creating a New Page ............................................................................................................................................... 35 Adding an External Page ...................................................................................................................................... 37 Setting Page Permissions ..................................................................................................................................... 40 All Pages Grid View ................................................................................................................................................. 41 Editing Page Properties ........................................................................................................................................ 42 Edit Page Mode .......................................................................................................................................................... 42 Setting the Default Page ........................................................................................................................................ 43 Reordering Pages ..................................................................................................................................................... 44 Moving Pages ........................................................................................................................................................ 44 Ordering Pages ..................................................................................................................................................... 45 Duplicating a Page ................................................................................................................................................... 45

1

USER MANUAL

Page Workflow .......................................................................................................................................................... 46 Page Localization...................................................................................................................................................... 49

8. Working with Controls ...................................................................................................................... 53
Adding Controls ........................................................................................................................................................ 53 Deleting Controls...................................................................................................................................................... 54 Setting Control Properties ................................................................................................................................... 54

9. Working with Modules ...................................................................................................................... 57
ContentView Controls ............................................................................................................................................ 58 Generic Content......................................................................................................................................................... 60 Content Sharing and Branching .................................................................................................................. 60 Administrative End ............................................................................................................................................ 61 Localization............................................................................................................................................................ 67 Public End .................................................................................................................................................................... 68 News ............................................................................................................................................................................... 73 Administrative End ............................................................................................................................................ 73 Localization............................................................................................................................................................ 76 Public End ............................................................................................................................................................... 79 Blogs................................................................................................................................................................................ 80 Administrative End ............................................................................................................................................ 80 Localization............................................................................................................................................................ 83 Public End ............................................................................................................................................................... 84 Lists ................................................................................................................................................................................. 85 Administrative End ............................................................................................................................................ 86 Public End ............................................................................................................................................................... 90 Polls ................................................................................................................................................................................. 92 Administrative End ............................................................................................................................................ 92 Public End ............................................................................................................................................................... 94 Forums........................................................................................................................................................................... 96 Administrative End ............................................................................................................................................ 96 Public End ............................................................................................................................................................ 102 Images & Documents........................................................................................................................................... 103 Administrative End ......................................................................................................................................... 104 Public End ............................................................................................................................................................ 115 Events .......................................................................................................................................................................... 116

2

USER MANUAL

Administrative end ......................................................................................................................................... 117 Localization......................................................................................................................................................... 119 Public end ............................................................................................................................................................ 119 Newsletters .............................................................................................................................................................. 120 Administrative End ......................................................................................................................................... 120 Public End ............................................................................................................................................................ 126 Tags and Categories ............................................................................................................................................. 127 Tags ......................................................................................................................................................................... 127 Categories ............................................................................................................................................................ 132 Wiki .............................................................................................................................................................................. 136 Administrative Side ........................................................................................................................................ 136 Public Side ........................................................................................................................................................... 141

10. Services ............................................................................................................................................... 148
Search .......................................................................................................................................................................... 148 Administrative End ......................................................................................................................................... 149 Public End ............................................................................................................................................................ 151 RSS Feeds .................................................................................................................................................................. 153 Administrative End ......................................................................................................................................... 153 Public End ............................................................................................................................................................ 158 Tools............................................................................................................................................................................. 159

11. Users and Roles ............................................................................................................................... 159
Overview.................................................................................................................................................................... 159 Creating a User Account .................................................................................................................................... 161 Adding User Details.............................................................................................................................................. 163 Editing User Details ............................................................................................................................................. 165 Managing Users and Roles................................................................................................................................ 166 Deleting a User........................................................................................................................................................ 167 Changing Current User Details ....................................................................................................................... 168 Creating a Role........................................................................................................................................................ 170 Deleting a Role ........................................................................................................................................................ 171

12. Permissions ....................................................................................................................................... 172
Global Permissions ............................................................................................................................................... 173 Module Permissions ............................................................................................................................................ 175

3

USER MANUAL

Site Map Permissions .......................................................................................................................................... 177 Page Permissions .................................................................................................................................................. 179

13. File Manager ..................................................................................................................................... 181
Structure of a Sitefinity Site ............................................................................................................................. 182 How to Upload Files to the Server and Display Them to Users..................................................... 184

14. Caching................................................................................................................................................ 186
Page Caching ............................................................................................................................................................ 186

15. The Application Configuration .................................................................................................. 188
Overview.................................................................................................................................................................... 188 Configuring Localization - Overview........................................................................................................... 188 Site Localization ............................................................................................................................................... 188 Mapping Domain Name and Extension to Culture ......................................................................... 189 Module Localization ....................................................................................................................................... 191 Configuring Workflow and Versioning ...................................................................................................... 193 Page Level ............................................................................................................................................................ 193 Module Level ...................................................................................................................................................... 193 Page History ....................................................................................................................................................... 193 Module History.................................................................................................................................................. 194 URL Rewriting......................................................................................................................................................... 195 Setting Custom Error Pages in the Web.config ...................................................................................... 196 Search Input Validation ..................................................................................................................................... 198 Configuring Medium Trust ............................................................................................................................... 199 Extensionless URLs .............................................................................................................................................. 199 IIS 5.x ...................................................................................................................................................................... 199 IIS 6.x ...................................................................................................................................................................... 200 IIS 7.0 Classic Pipeline mode ..................................................................................................................... 201 IIS 7.0 Integrated Pipeline mode ............................................................................................................. 203 Wildcard Application Mappings............................................................................................................... 203 Configuring page extensions ........................................................................................................................... 207 Changing the default page extension..................................................................................................... 207 Using additional extensions for your Sitefinity pages .................................................................. 207

16. Deployment ....................................................................................................................................... 208
Deploying Sitefinity to a production server ............................................................................................ 208 Deploying Sitefinity in a Load Balanced Web Farm Environment .............................................. 211

4

........................................................................... 218 Using RadEditor as a Custom Field.................................................................................................................................................................................................. 212 Overview................................................................................................................................................................................................................................................ 212 Adding Custom Fields ............................................................................................................................. 235 Amazon S3 Support .............................................. 230 Disabling the Sitefinity Link Manager and Using the RadEditor Link Manager ...................................................................................................................................................................................................................................................... 233 Customizing the Images and Documents Module ................................................................................... 230 Populating the CSS Dropdown ............................... 244 Customizing the Response Chart ............................................................................................... 214 Overview .......................................... 214 Adding Custom Fields to Generic Content Based Modules ................................................ 223 Adding Providers................................................................. 240 Customizing the Polls Module ...............................................................USER MANUAL 17................................ 215 Adding Category Column ............................................................................................ 219 Using a Drop Down List or a Checkbox as a Custom Field ................. 222 Adding Thumbnails from Image and Documents Module to the News Module ................................................................... 237 Adding Custom Fields to the Images & Documents Module................................................................................. 212 Control Templates .............................................................................................................................................................................................. 244 Overview ..................................................................................................................................... 244 5 ................................................................................................. 225 Customizing the Generic Content Module . Customizing Built-In Modules ............................................................................................................................................................. 230 Adding and Removing Buttons ........................................................................ 235 Viddler Support ...........................................................

USER MANUAL 1. Welcome to Sitefinity Welcome to Sitefinity. customization and reuse of external applications and modules. familiar editing environment enables non-technical contributors to author. insert images. build tables. 6 . create and post news. rich template library.NET based Content Management System whose: simple-to-use graphical interface runs on any recent Web browser. documents. Using the familiar Word-like interface of Telerik’s leading WYSIWYG RadEditor. allowing for intuitive interaction with data. flexibility and fully exposed API allows easy integration. authors can format text. Users can conveniently set up and manage blogs and polls. Telerik’s powerful ASP. pluggable modules enhance Web site development and functionality. create hyperlinks. enables users to build Web applications that comply with W3C requirements. maintain and publish HTML content as easily as writing a document. scalable architecture streamlines the implementation of design changes and reduces deployment time. flash files. etc. compliant with XHTML and web accessibility standards.

USER MANUAL 2. About this Manual Purpose This manual is designed to be a guide to the functionality of Sitefinity CMS and to give a firm understanding of its principles. It is divided into the following main sections: Basic Features and Concepts Login The Sitefinity Workspace Working with Web Site Projects Working with Page Templates Working with Page Themes Working with Web Pages Working with Controls Working with Modules Services Users and Roles Permissions 7 .

USER MANUAL Intended Readership The intended readers of this manual are: Web site administrators and users with basic programming knowledge responsible for the installation and setup of new Web site projects. Web developers who will mainly use the default Sitefinity functionality. 8 . A separate Developer Manual is available for advanced users. Web designers responsible for the graphic design. permissions and migration of Web site projects from development to production server. page layout and structure of the Web site project. For the latest Sitefinity documentation. please visit our documentation page. roles. configuration and management of users.

DEFINITIONS • CMS User/User seat . or testing of the SOFTWARE. The Customer needs to provide Telerik with detailed information about the problem encountered. install or use the SOFTWARE. which cannot be broken down into secondary issues. • Development Machine . or otherwise using the SOFTWARE. you are accepting the following License Agreement. Telerik does not guarantee that all problems will be resolved.an individual user who has access to the administrative (content management) capabilities of the SOFTWARE through a unique username and password. The 9 . Check the box "I have read and agree to the License Agreement" if you agree. • Support Incident .an individual who can access only the public (published) part of web-sites.USER MANUAL License Agreement Telerik Sitefinity Content Management System End-User License Agreement By downloading and installing the product identified above and/or its related materials. do not buy.A support incident is defined as a single support issue with the SOFTWARE and the reasonable effort required for resolving it. SOFTWARE PRODUCT LICENSE The SOFTWARE is protected by copyright laws and international copyright treaties. By installing. associated media. • Site visitor . downloading. A single support incident is a support problem. All bug reports and product feature suggestions are not considered support incidents. staging. Any earlier LICENSE we may have granted to you for the use of earlier versions of the SOFTWARE is replaced by this LICENSE.a computer used for custom development. as well as other intellectual property laws and treaties and contains confidential information and trade secrets. • Production Server – a computer used for the final deployment of the SOFTWARE. printed materials. copying.. created with the SOFTWARE. for the product "Telerik Sitefinity" which includes computer software. also referred to as "LICENSEE". Even though Telerik Support Engineers will make reasonable efforts to resolve the issue. accessing. before it is deployed on the Production Server. None of the Sitefinity LICENSES impose any limitation on the number of Site visitors. and "online" or electronic documentation (collectively referred to as “SOFTWARE”). you agree to be bound by the terms of this LICENSE. "YOU") and Telerik Corp. If you do not agree to the terms of this LICENSE. Such users do not have username and password for access to the administrative capabilities of the SOFTWARE. IMPORTANT – READ CAREFULLY: This license agreement (“LICENSE”) is a legal agreement between you (either an individual or a single entity. A single support incident may involve several e-mails and offline work in order to be resolved. ("Telerik").

www. • Included Support: Telerik guarantees response within 48 hours to your support inquiries. http://support. copy.com. and use the SOFTWARE for the sole purpose of testing its functionality. and all copies you may be licensed to make.mysite. • To facilitate the development process. (c) Community Edition License: • The Sitefinity Community LICENSE allows you to use the SOFTWARE for 1 (one) top level domain name (or server name). Telerik allows you to deploy the SOFTWARE on your testing and development servers and access your applications via the IP address(es). As part of your LICENSE you are entitled to receive technical support for up to 5 support incidents. Telerik also retains all rights not expressly granted to you in this LICENSE. • The Sitefinity Trial LICENSE is perpetual and works without license keys. • Telerik requires the display of the “Powered by Sitefinity” logo on all pages that use the Sitefinity Community version.com.com. you will be able to use it for all subdomains . • The Sitefinity Community LICENSE can be used for both personal and commercial websites.com. etc. The Forum is available to all Client.com. As part of your LICENSE you are entitled to receive unlimited number of support incidents. • There is no limitation to the number of CMS User accounts.com.mysite. not sold. Even though we actively monitor and answer posts. 1. development or production server. Telerik retains ownership of the copy of the SOFTWARE in your possession.com. and you accept. There is no limitation to the number of subdomains (i.e.). You are authorized to install.mysite. (b) Standard Edition Trial License: • You are granted a LICENSE for evaluation purposes only. copy. you will be able to use it for all subdomains . GRANT OF LICENSE Telerik hereby grants to you. a LICENSE to install. the Forum's main purpose is to offer convenient peer-to-peer assistance and we do not guarantee a reply to all threads. • There is no limitation to the number of CMS User accounts. etc.).mysite. You are not allowed to use it for any commercial purpose. • Included Support: Telerik guarantees response within 72 hours to your support inquiries. http://support. 10 . You can submit inquiries via the Sitefinity Forums where other members of the community will be able to provide answers.net account holders.www. • Telerik allows you to deploy the SOFTWARE on any testing. by registering a key for mysite.USER MANUAL SOFTWARE is licensed to you. http://mysite. and use the SOFTWARE only as authorized below. (a) Standard Edition Commercial License: • The Sitefinity Standard LICENSE allows you to use the SOFTWARE for 1 (one) top level domain name (or server name). The Trial LICENSE displays a random trial message that will be disabled once you purchase a license for the Standard Edition Commercial License and create a license key for your domain. http://mysite. There is no limitation to the number of subdomains (i. by registering a key for mysite.e.com. • Included Support: This LICENSE entitles you to Community support only.

but only as an integral part of the SOFTWARE. COPYRIGHT 11 . Telerik may terminate this LICENSE if you fail to comply with any of the terms and conditions herein. 5. and bug-fixes released for a period of 1 (one) year after the day of purchase. DELIVERY Telerik shall deliver to LICENSEE a master copy of the SOFTWARE licensed hereunder in compiled C# code in electronic files only. DESCRIPTION OF OTHER RIGHTS AND LIMITATIONS (a) You are not allowed to use the SOFTWARE as a whole. decode or otherwise reverse translate or engineer. logos or trademarks to market your SERVICES or IMPLEMENTATIONS related to the SOFTWARE without the express prior consent of Telerik. and defend Telerik and its resellers from and against any and all claims or lawsuits including attorney's fees that arise or result from the use or distribution of your software product. decompile or "unlock". In such event you agree to cease using and destroy all copies of the SOFTWARE. SOFTWARE labeled as an upgrade replaces and/or supplements (and may disable) the product that formed the basis for your eligibility for the upgrade. 3. (f) You agree to indemnify. TERMINATION This LICENSE shall last as long as you use the SOFTWARE in compliance with this LICENSE. (b) You are not allowed to use individually the software components comprising the SOFTWARE.NET components are not allowed to use the SOFTWARE without the express permission of Telerik. modify. 4. (g) Independent software vendors involved in the development. copy. which you have been licensed to use and distribute. or attempt in any manner to reconstruct or discover any source code or underlying algorithms of the SOFTWARE provided in object code form only. or merge copies of the SOFTWARE or any accompanying documents except as permitted in this LICENSE. (d) You are not allowed to use. as a basis for creation of another software product. (e) You may not use the Telerik product names. patches. UPGRADES The Standard Edition Commercial LICENSE entitles the LICENSEE to receive all version updates. maintenance and publication of . You may use the resulting upgraded product only in accordance with the terms of this LICENSE.USER MANUAL 2. hold harmless. or any of its comprising elements. (c) You are not allowed to disassemble. 6. Documentation shall also be provided in electronic format.

NOTWITHSTANDING ANY FAILURE OF ESSENTIAL PURPOSE OF ANY LIMITED REMEDY. Telerik'S ENTIRE LIABILITY UNDER ANY PROVISION OF THIS AGREEMENT SHALL NOT EXCEED IN THE AGGREGATE THE SUM OF THE LICENSE FEES LICENSEE PAID TO Telerik FOR THE PRODUCT GIVING RISE TO SUCH DAMAGES. updates or other modifications shall be the sole property of Telerik. Telerik does not warrant the use of the SOFTWARE will be uninterrupted or error free at all times and in all circumstances. DAMAGES FOR LOSS OF GOODWILL. ANY DATA INCLUDED IN A PRODUCT UPON SHIPMENT FROM Telerik IS FOR TESTING USE ONLY AND Telerik HEREBY DISCLAIMS ANY AND ALL LIABILITY ARISING THEREFROM. This limited warranty shall not apply to any error or failure resulting from (i) machine error. and any copies of the SOFTWARE. AND REGARDLESS OF THE LEGAL OR EQUITABLE THEORY (CONTRACT. Telerik has rights to redistribute these modules. OR ANY AND ALL OTHER COMMERCIAL DAMAGES OR LOSSES. or (iv) modifications to the SOFTWARE by any person or entity other than Telerik. THE EXTENT OF Telerik'S 12 . Telerik IS NOT RESPONSIBLE FOR ANY LIABILITY ARISING OUT OF CONTENT PROVIDED BY LICENSEE OR A THIRD PARTY THAT IS ACCESSED THROUGH THE PRODUCT AND/OR ANY MATERIAL LINKED THROUGH SUCH CONTENT. IN NO EVENT WILL Telerik BE LIABLE FOR ANY INDIRECT. SPECIAL. EVEN IF ADVISED OF THE POSSIBILITY THEREOF. WORK STOPPAGE. All title and intellectual property rights in and to the content that may be accessed through use of the SOFTWARE is the property of the respective content owner and may be protected by applicable copyright or other intellectual property laws and treaties. SO THIS EXCLUSION AND LIMITATION MAY NOT BE APPLICABLE. WITHOUT LIMITATION. LIMITED WARRANTY Telerik warrants solely that the SOFTWARE will perform substantially in accordance with the accompanying written materials for a period of ninety (90) days. In the event of a breach of warranty. The SOFTWARE includes derivate works based on the software products listed below.productivity tool developed by “Nolics” 7. and any trademarks or service marks of Telerik are owned by Telerik.USER MANUAL All title and copyrights in and to the SOFTWARE (excluding the Sitefinity software modules listed below).net” – search engine software developed by “The Apache Software Foundation” (b) “Nolics. LIMITATION OF LIABILITY TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW. bug fixes. LICENSEE 's sole remedy and Telerik's maximum liability shall be a refund of the paid purchase price for the defective SOFTWARE only. COMPUTER FAILURE OR MALFUNCTION. (ii) LICENSEE's failure to follow operating instructions. OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OF OR INABILITY TO USE THE PRODUCT. the accompanying materials. is repair of all or any portion of the SOFTWARE. (iii) negligence or accident. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OR LIMITATION OF INCIDENTAL OR CONSEQUENTIAL DAMAGES. INCLUDING. 8. however the intellectual property for these products remains with their respective publishers: (a) “Lucene. INCIDENTAL. This limited warranty is only valid if Telerik receives written notice of breach of warranty within thirty days after the warranty period expires. TORT OR OTHERWISE) UPON WHICH THE CLAIM IS BASED.net 2005” . nor that program errors will be corrected. patches. LICENSEE 's sole and exclusive remedy. All error corrections. IN ANY CASE. If such remedy fails of its essential purpose.

YOU FURTHER AGREE THAT.USER MANUAL LIABILITY FOR THE LIMITED WARRANTY SECTION SHALL BE AS SET FORTH THEREIN. OR BY PLACING OR COPYING THE SOFTWARE ONTO YOUR COMPUTER HARD DRIVE. THAT YOU UNDERSTAND THIS AGREEMENT. BY LOADING OR RUNNING THE SOFTWARE PRODUCT. 13 . Failure of a party to enforce any provision of this LICENSE shall not constitute or be construed as a waiver of such provision or of the right to enforce such provision. YOU ACKNOWLEDGE THAT YOU HAVE READ THIS AGREEMENT. YOU AGREE TO BE BOUND BY THIS AGREEMENT'S TERMS AND CONDITIONS. U. AND UNDERSTAND THAT BY CONTINUING THE INSTALLATION OF THE SOFTWARE PRODUCT. If any provision of this LICENSE is to be held unenforceable. THIS AGREEMENT IS A COMPLETE AND EXCLUSIVE STATEMENT OF THE RIGHTS AND LIABILITIES OF THE PARTIES.A. MISCELLANEOUS This LICENSE will be governed by the law of the State of Massachusetts. This LICENSE represents the entire understanding between the parties with respect to its subject matter. EXCEPT FOR WRITTEN SEPARATE AGREEMENTS BETWEEN Telerik AND YOU.S. such holding will not affect the validity of the other provisions hereof. 9.

data. Controls do not need to implement any specific interfaces in order to work with Sitefinity. Content Content Item Description 14 . Sitefinity includes four navigational controls : SiteTreeView. This may be any chunk of data stored in the CMS repository/database tables. They can be shown in the site navigation but cannot be edited within Sitefinity.USER MANUAL 3. Each content item can be reused in multiple locations throughout the Web site.ascx) or CustomControl (. Basic Features and Concepts Term Add external pages to navigation Automatic Site Map Automatic Site Navigation Definition You can add external pages to Sitefinity through the GUI. graphics and media files contained on or accessible from the Web site. Any piece that is a UserControl (. ContentPlaceholder Controls Control Defines a relative region for content in a master page. You can add any type of controls to the Sitefinity toolbox through the web. and SiteTabStrip.dll) in terms of ASP. The structure of a Web site automatically binds to its navigation controls. SitePanelBar.NET we refer to as a control. Any information. text. SiteMenu.config. The basic unit of content in Sitefinity. Sitefinity automatically creates a site map. A summary of what the content item is about. images. files.

Sitefinity supports content history. when you write a new blog post. see also Shared Content below. it is automatically displayed on the live site if you have blogs enabled. detect and set content.USER MANUAL Dashboard Summarizes the current state of the Web site and gives quick access to the administrative functions the user can view. If you delete a page where such items are published. These modules are compiled on demand. because information used by many pages can be updated in one place.config file as they are automatically detected. Dynamic content is independent of the page. They can either be published on a page or not. see Module. so the newest version is on top of the oldest version. Content items that you create and edit in the different modules are dynamic content. Metadata keywords are used by browsers or search engines to find and categorize your page. etc. Each time a user modifies content. the items remain in the module’s content repository. Dynamic content takes care of its presentation on the site. You do not need to register Intra-site modules in the project’s web. Dynamic content is very convenient when running a large site. For more info. the page stays locked but you History Intra-site Modules Keywords Locked page 15 . The old version is stored in the database together with the new version in a list. Dynamic Content Exposed API Sitefinity exposes a comprehensive set of methods and events that allow developers to handle and customize almost every aspect of the application: programmatically create users and set permissions. This helps the site administrator track all content modifications together with the user identity and the time of the modifications. and Pluggable Modules below. If you close the browser while editing. build templates and pages. For more information.ascx files within an existing Sitefinity installation. A module class and a collection of . For example. a copy is created in the database.

Membership Services Menu Label Module 16 . An independent application hosted by Sitefinity. They are not required to use the same provider or configuration model as Sitefinity. for example menu. Page Inherits the appearance of a master page and template and places its own content where the master page has defined a ContentPlaceHolder control. Usually modules are comprised of groups of controls that work together to form some business logic. Enables the administrator to validate and manage user information for the Web application. Determines the link name of the page that appears in the navigation controls. and managing user settings such as passwords and e-mail addresses. creating a consistent appearance and behavior in your application. creating and modifying membership users. Master Page Enables developers to define common areas that every page will share. A master page allows you to put the common code in a single file and have it visually inherited by content pages. footers.USER MANUAL can return to edit it later. Pluggable Modules. such as headers. Administrators cannot edit the locked page but they have the options to Save or Cancel the changes you have made. See also Intra-site Modules. It provides functionality for validating user credentials. The only interface that is required for a module to be hosted by Sitefinity is the IWebModule. navigation and so on. Both of these actions will unlock the page.

Page Template Page Title Pluggable Modules RadControls RSS 17 .and the RSS helps viewers decide whether they want to follow the link. and the controls added to its placeholders. Developed by Telerik and shipped with Sitefinity. Defines the common layout and content that is used for several pages. Pluggable modules can be customized by adding additional fields and providers. The Template is based on the master page markup together with the theme. The name which this page uses for its URL.dll files that are put in the project’s bin folder. along with other forms of information. the URL looks like this: http://domain.aspx Page Name Page Navigation Specifies whether this page should be shown in the site map by navigation controls such as a SiteMenu and SiteTabStrip.USER MANUAL Page Alias (Friendly URL) A friendly name that maps part of a URL to a physical directory on the server. RSS stands for Really Simple Syndication and it’s used to describe the technology used in creating feeds. They enable developers to rapidly build the interface of the Web site project and integrate with the core CMS application. For more information. these are precompiled . an abstraction for the master page. for example if the page name is History and it is a subpage of About. A page can have several aliases leading to it. . Friendly URLs are essential to search engines.NET AJAX suite. This name appears in the URL bar. Sitefinity is shipped with all components from the award-winning Telerik RadControls for ASP. The page title is displayed in the browser title bar. In Sitefinity. RSS is an XML-based format that commonly syndicates news and blog posts.com/About/History. Any changes made to a template will affect all the pages associated with it. see Intra-site Modules and Module.

Static content is totally dependent on the page and it cannot be edited outside the page. syndicated content. If you delete the page. Each item can have any amount of metadata associated with it. the larger it appears in the tag cloud. When you click a tag in the tag cloud. the tagged content for the particular provider (for example only blogs or only news) is displayed. The more frequently a tag has been used. Users can subscribe to feeds to automatically check for and download updates they can view later.config file and converting it into a configuration object. then you need to add a new control to the Web page first. tag clouds are sorted alphabetically. contain frequently updated content published by a Web site. also known as RSS feeds. A feed contains a list of items. Content that is used repeatedly among pages on your Web site. such as text and images inserted directly in the Generic Content controls. This is content placed through controls on Web pages. They are usually used for news and blogs. Section Handler Section handlers are responsible for reading the configuration settings from the web. One of the display modes for tags. By default.USER MANUAL RSS Feed Feeds. but you can also sort them by popularity. XML feeds. each of which is identified by a link. the static content is also removed. Shared Content Static Content Tags Words or labels attached to some content and used to describe and categorize it. If you need to display new content on the site. or web feeds. Tag Cloud 18 . Content sharing is a convenient way to save time with updates and changes. See also Dynamic Content.

css files) and graphics. A theme can include skin files that define property settings for ASP. A Web farm is a setup of a single Web site across multiple servers. which handle various web requests. other elements can easily interact with the user control programmatically. A group of one or more server controls or static HTML elements that encapsulate a piece of functionality.NET framework treats it as a standalone object. A user control typically resides on a page with other elements but the .config Web Farm 19 .NET theme is a collection of properties that define the graphical appearance of pages and controls in your Web site. Roles determine which parts of Sitefinity are accessible to users. The user URL URL Rewriter User Control User Role Web.NET Web server controls and it can include Cascading Style Sheets (. you just edit this XML file and do not need to modify the code.NET is the central location for your Web application configuration. Many properties for controls. When you want to change some setting. is set in this file. Acronym for Uniform Resource Locator. A role defines a group of users associated with the same permissions. It is formatted in XML and can be opened in Notepad or Visual Studio. It has an interface that can be completely edited and changed. A rewrite engine that modifies URLs before fetching the requested item. It can be manipulated at design-time and runtime through properties.USER MANUAL Theme An ASP. This type of setup is commonly required for larger sites that generate large amount of traffic.config file in ASP. By applying a theme. The Web address you use to access a specific Web page. you can give the pages in your Web site a consistent appearance. such as a true or false value for enabling workflow. By exposing properties of the control through the code-behind (or in the HTML). The web. Themes are defined in special directories in a Web site or on a Web server. This is a useful SEO tool as you can create user and search engine friendly Web site URLs.

an individual or group is responsible for a specific task. At each stage of the workflow.USER MANUAL requests are handled by the different servers. There is page and content workflow in Sitefinity and they are both disabled by default. Workflow * Defined series of tasks that occur between content origination and its publication on the live site. such as saving or publishing a page. Once the task is complete. 20 . the workflow ensures that the individuals responsible for the next task are notified.

click login or press the enter key. This will bring you to the administrative back-end of an existing project. There are two ways you can log into Sitefinity: • Access the Sitefinity Project Manager: Start Menu > All Programs > telerik > Sitefinity3. type in your username and password. by default. This provides access to the administrative tools. are stored in the database by default. So users can edit the website. After successful login. they must login to Sitefinity. • Log in directly: Go to this URL: http://localhost/[Virtual_Directory_Name]/Sitefinity/Login. 21 . This. Go to this URL: http://localhost/telerik/Sitefinity3.aspx Once you see the login page.USER MANUAL 4. such as the user interface for editing pages.x. images. click Edit next to a website. The default login page opens in a new browser window. Login All of Sitefinity’s content.aspx Once you access the Sitefinity Project Manager. documents and videos. such as pages. Then.x/Default.x > Sitefinity3. if you have appropriate permissions. in turn. will update the database. you will see the Sitefinity Dashboard.

Depending on your permissions. The Administration area allows you to manage services. You can also manage the permissions for these modules here. Forums. This is what the general site visitors see without logging in. News. the Live Site tab allows you to preview the published content without opening a new browser window and typing the URL. The Modules area allows you to create. Images & Documents. edit and delete pages and page templates. users and roles. The Files area allows you to manage the file structure of the Web site administered by Sitefinity. Blogs. The Dashboard is where you enter once you log in. Events and Newsletters. you may or may not be able to view all of them. This is your log of recent activities. permissions. The Sitefinity Workspace Six main Sitefinity sections are accessible through the tabs listed below. edit and delete various content items. You can create and upload files and folders here. It contains the current published version of the content. The Live Site tab leads you to the published copy of the Web site. 22 .USER MANUAL 5. You can easily check the pages status and manage page and site map permissions. Polls. If the project has been deployed on a live Web server. It is meant to help you keep track of the latest changes to the Web site. It also provides quick access to the most commonly used administrative tools. It is divided into the following modules: Generic Content. The Pages area allows you to create. and tools. Lists.

you will see the Spanish versions of the pages first. this option allows you to set the localization of the CMS. In the example below. Even if no different language versions of the web pages are available. 23 . Spanish. French.config are English. Language This option is displayed when you have enabled site localization. when you go to Pages > Site Map. Please note that the language bar is only available is localization is turned on in the CMS. German and Bulgarian.USER MANUAL My Preferences Sitefinity allows you to change some of the default settings of the GUI according to your preferences from here: There are three types of settings you can change: • General • Dashboard • Page editor General Settings 1. If you select Spanish from the dropdown and save your setting. the site languages set in the <localization> section of the application web.

Start screen By default. For details about permissions. 3.USER MANUAL 2. 24 . The contents of the dropdown list changes according to the permissions granted to the currently logged user. Here you can set a different start screen. Show FAQs everywhere Clear the checkbox if you want to hide the right panes which display FAQs at the different screens in the administration part of Sitefinity. A user with CMS access and Page Permissions. for example will be able to see Dashboard. after a successful login. refer to Page Permissions. Pages > Sitemap and Live Site only. you are redirected to the Dashboard screen.

Customize your Dashboard further by selecting which items to show in the What’s been up lately area: 25 . It is easy to hide this area of the Dashboard: To do this. clear the Show the Main Sections panel checkbox: 2.USER MANUAL Dashboard Settings 1.

If page workflow is enabled. 26 . such as last published pages and last pages submitted for approval. there will be an option to show pages in every workflow status available. select from the items in the list.USER MANUAL To do this. The list changes according to the View permissions granted to the currently logged user.

27 . please refer to Personalization in our Developer Manual. refer to Page Permissions.config file it is initially set to Overlay. Here you can change the default page edit mode. In the web. For details about permissions.USER MANUAL Page Editor Settings The link below is visible to users who are granted the Modify page permission. For more information about personalization.

Click My Profile in the top right corner of the screen: 3. Log in Sitefinity. Click Save user info. The user profile form opens. You cannot change your username. 28 . Apply your changes. 4.USER MANUAL My Profile Each Sitefinity user can change their user profile. To edit your email. 2. first name and last name: 1.

2. Click Change password. 5. 3. Click the Change Password link in the left pane. 29 . 4. Enter your old password.USER MANUAL To change your password: 1. Re-enter your new password. Enter your new password.

30 . Sitefinity page templates relate a master page to Web pages. the template for the page shown below defines three content areas.USER MANUAL 6. The developer or end user can choose what controls to place in each content area on any given page. such as those used in the TIU sample site. Many templates can use one master page and one template can be used by many Web pages. Sitefinity users can choose from the predefined templates. Master pages and page templates reduce the work involved in creating numerous pages with the same layout and behavior. which in turn are generated from Master pages. Working with Page Templates Master Pages and Templates Overview Sitefinity pages are based on page templates. Based on the master page markup together with the controls added to its placeholders. so that two pages using the same template can actually have a very different appearance. the template defines the structure and organization of a Web page. or software developers can upload master pages created by external applications such as Visual Studio® or Dreamweaver®. For example. you can use a master page to standardize the headers and footers of the Web pages in a particular site. For example.

This view is displayed when you click All Templates. Click a template in the list to view and edit it. When you click on a template. Click on properties and use it to check the following details about each template: the . you will see tabs on the right.master file used by the template the theme used by the template the published pages using the template the date and time when the template was created 31 . In the left pane is the list of all templates currently available for this project. On the right is a grid view of all templates.USER MANUAL To access the Sitefinity Page Templates Manager. go to the Pages tab and then click Templates.

Template changes do not pass through workflow and are immediately effected on the live site. 5. 4. 32 . 2. Click Save changes when you are done. Editing a Template To edit the appearance of a template: 1. It will appear in the Templates dropdown list in edit page mode and in the All Templates grid. 3. Click Edit this template. 2. Click to select the template in the list or All Templates grid. Go to Pages > Templates. Expand the Add Controls toolbox and drag controls to the placeholders defined by the corresponding master page. Head tags Inserts link and meta elements in the head section of your page template. 3. Go to Pages > Templates. Template Name The template name should be unique.USER MANUAL Setting Template Properties To edit template properties: 1. 4. Click the link buttons to set the properties for the tags. Click Save changes when you are done. Click the Properties tab on the right. Click to select the template in the list.

USER MANUAL Templates Versioning* This feature is not available in the Sitefinity Community Edition. To disable templates versioning. Telerik.Cms. 5. 33 . 2. 3.config: <add connectionStringName="DefaultConnection" allowPageHistory="false" allowPageWorkflow="false" name="Sitefinity" type="Telerik. Click to select the template in the list or All Templates grid. Click Rollback to substitute the current template with an older version.Each time you modify a template. the changes are saved as a new version of the template. Go to Pages > Templates.Data. set the allowPageHistory attribute to false in the application web.DefaultProvider.Data" /> To preview and roll back to previous template versions: 1. You can view template history as well as the user identity and the time of the changes. 4.Cms. Click View to preview an older version. Click the History tab on the right.

the following message is displayed: “No template has been selected. click the link under Pages assigned in the grid.master file to generate a similar template.master file will also be deleted if you delete the last template using it! When you go to a page whose template has been deleted. The . Also. Deleting a Template To delete a template. Click the Duplicate selected link button. click the trashcan icon in the All Templates grid. Click to select the template in the list or All Templates grid.USER MANUAL Duplicating a Template To duplicate an existing template and create a new one based on it: 1. The copy of the selected template uses the same master page as the original one and is added to All Templates. 34 .” In Page Edit Mode. 3. 2. go to Templates > Upload master page. To do this. Go to Pages > Templates. You can rename the template and edit it later similarly to the way you edit pages. A warning is displayed if there are published pages using the template you want to delete: To view which pages are using it. you can upload the old . you should choose a new template from the dropdown list in the top right of the screen.

complete the following steps: 1. Depending on the ContentPlaceHolder properties. This setting is not inherited. for example menu. A page consists of: Name: the URL of the page. If Show in navigation is set to No for a page that has subpages. Creating a New Page When you first go to Pages >Site Map. along with the entire URL. You can either create a new page or add an existing external page. They contain ContentPlaceHolder controls that define the type of content the user can enter on a Web Page. Page group: redirects to its first sub-page. External page: a link to a page created outside Sitefinity. Metadata: general settings such as Title. the user can drag and drop controls and preview the page in a full browser window. panelbar. Menu label Determines the link name of the page that appears in the navigation controls. To create a new page in Sitefinity. Set the General properties of the page: Page name The actual file name (system name) of the page. Page navigation Specifies whether this page should be shown by navigation controls like menu. treeview. Working with Web Pages Pages have predefined structural appearance inherited from a master page or a page template. The name of the page cannot be “Default”. Alias: different names and URLs for the same page. the subpages will still be shown in the site navigation. you will see a message stating that there are no pages available for this project. Reference: reference to a page template. Meta tags.USER MANUAL 7. Go to Pages >Site Map and click Create a page in the left navigation pane. etc. The page name cannot contain spaces or special characters. 35 . 2. Controls: controls assigned to the content placeholders defined in the referenced template. editable within Sitefinity. Page type Normal page: displays its own content. Visitors of the page will reference this name.

In other words. If marked to no. the rendered HTML is retrieved from the cache and written directly to the output stream. all subpages will be inaccessible by unregistered users and will require authentication. no events are fired. no additional database calls are made. Keywords Metadata keywords are used by browsers or search engines to find and categorize your page. otherwise leave unchecked ViewState Check to disable viewstate on the page. Search Indexing Mark yes to enable this page to be searched by an index. The option is disabled at the Properties tab for the subpage. The response time to serve a cached page is equal to the time needed to serve a static . instead of creating new instances of the page and its controls. Use commas to separate keywords. this page cannot be searched anywhere in the system 36 . the rendered output of the page is cached depending on the page cache settings made in the application web. That ensures that all changes made to a cached page are effected immediately on the live site. In the Head Content section.USER MANUAL 3. 4. Description A short summary of the page content. Require SSL Specifies whether this page will require a secure socket layer (https connection). set the head settings of the page: Page Title This title is displayed in the title bar of any browser viewing the page. If you set Anonymous access to Deny for a page that has subpages. Security Anonymous access Check "Deny" to restrict all access for anonymous visitors and require authentication. otherwise leave unchecked When this option is set to “Yes”. For more details on how to enable caching for pages. Performance Caching Check to allow the application to cache this page. no control instances. When the page is requested again. Expand More Options to set more advanced page properties. The output cache is cleared when a page is published. section telerik/cms.config file.HTML file. refer to Page Caching. Check "Allow" to enable anonymous access the web page without password verification. please. SSL should be installed on the server.

Go to Files and upload the FAQ. When you complete the required fields.html. Although you can edit an external page’s properties. For example. for example FAQ. Adding an External Page You can add any page created outside Sitefinity to your Web application. link and meta tags.aspx file ready and you do not need to edit its content within Sitefinity. Follow the instructions below to add an existing file. Please note that workflow is disabled for adding external pages. you cannot edit content on the page within Sitefinity. so the page goes live immediately.USER MANUAL Page URLs Enter in additional URLs for a page.html to the Files folder. click Create this page. 37 . 1. You just need to have a link to this file in the dynamically created navigation of Sitefinity. you have an . such as its location within the project. 5. to the Web site. These URLs can redirect to any other one in the list Add head tags: Additional Tags: base.

Go to Pages >Site Map and select All Pages. 38 . 4. Click Create this page. Click Create a page. 6. 5.USER MANUAL 2.html. 3. Set the Page Name property to FAQ for example. Select External Page as the Page Type.html file: ~/Files/FAQ. Type the URL to the . 7.

html. 39 .USER MANUAL You should be able to access it through this URL: http://<root>/Files/FAQ.

3. Click the Permissions tab on the right. click Save changes. please refer to Page Permissions. select the role for which you want to set the permissions: 4. From the dropdown list. When you are done. 40 . 2. For more details about setting page permissions.USER MANUAL Setting Page Permissions To set the permissions for a given page: 1. Click to select the page in the site map.

for example mass approval or mass publication. You can also sort pages in the grid by last modified. Approved and Published) and perform a group operation. by default all the pages will have the same permissions. For more details about setting sitemap permissions. please refer to Site Map Permissions. Declined. When you go to the Permissions tab. 41 . you can set the permissions for all pages. For Approval. Here you can filter pages to show only those with a given status (Draft. If you do that. last modified by a certain user or status (alphabetically). a grid view with all Web pages available for this project is displayed.USER MANUAL All Pages Grid View When you are at the Site Map tab and click the All Pages link. please refer to Page Workflow. For more details about managing the page workflow *.

Click the Properties tab on the right. Edit Page Mode To open a web page for editing: 1. 2.aspx in the application root. 2. When you are done.USER MANUAL Editing Page Properties To edit the properties of a page: 1. There are two edit page modes available: Overlay and Classic. On the More Options section. Click to select the page in the site map. 42 . Click Edit this page. click Save changes. 3. Sitefinity uses a URL rewriter and when it comes across Default. it will actually load the page that has been set as home page and displayed bold in the site map.aspx. you can now add other URLs and/or change the default URL. Click to select the page in the site map. 4. We do not recommend setting optional URLs to Default.

Click Set home page. Click to select the page in the site map. 2. Open the application web.USER MANUAL To change the default edit page mode to Classic. Find this section and set the pageEditorUIMode attribute to Classic: <cms defaultProvider="Sitefinity" pageExtension=". The default page is displayed in bold type in the site map.config file.aspx" pageEditorUIMode="Classic" disabled="false"> 3. Refresh the page. Setting the Default Page To set a page as Default (Home) page: 1. go to My Preferences > Page editor settings or: 1. 2. 43 .

44 . The action of page reordering does not pass through the workflow and will be effected immediately on the staged copy of the site. Once you move a page. Drag and drop the source page over the destination page that will become its new parent. Moving Pages To move one page from a given section (parent page) to another section: 1. all navigation controls will reflect its new location. 2.USER MANUAL Reordering Pages Sitefinity allows users with sufficient permissions to reorder pages. Click the source page to select it.

2. When page workflow is disabled.USER MANUAL Ordering Pages To change the order of pages within their own section (parent Page). You need to select the page you want to duplicate in the site map first and then click Duplicate page. Click the page that needs to be re-ordered to select it. instead of starting from scratch. in order to show the duplicated page on the live site navigation. Click Move page up or Move page down. 45 . Duplicating a Page When you need to have a page similar to an existing page. the duplicated page is published immediately. you can duplicate a page. you need to publish it first. you need to do the following: 1. If page workflow is enabled.

etc. 46 . and approval to publication. During one workflow cycle.USER MANUAL Page Workflow Please note that this feature is not available in the Sitefinity Community Edition. workflow facilitates the movement of work to the individuals responsible for the various tasks. while at the same time provides adequate levels of control and administration. Telerik Sitefinity CMS uses a linear workflow cycle facilitating expedient processing of content modifications. We define workflow as the cycle of steps that occur between the content origination and its final appearance on the live site. In addition. review. the content passes through three distinct stages: Work in Progress Staged Content Live Content The diagram below illustrates these three stages along with the respective user activities that change the content status. Every user gets real-time status of where work is in the workflow process. Those steps are the particular actions that the users perform with the content in order to change its status and move it further along the workflow cycle. The main purpose of every Content Management System is to provide an easily managed workflow process ensuring that the correct content appears at the right place and at the right time. which tasks are complete or pending. A series of predefined workflow tasks allows for tracking Web pages through the entire process from authoring.

You can send the draft page for approval or re-edit the page. The draft page can be approved for publishing to the live site. A page can be in one of the following pre-defined states: Draft For Approval Declined Approved Published Sitefinity provides the following stages in page workflow management: Create a new page or start to edit a new one. The following options are given at each stage in the Page Manager work area: Create a page/edit the current page. or cancel the changes and leave it as it is. you will see a complete list of all the pages in the site and their current workflow status.USER MANUAL All Sitefinity pages pass through a series of states in a fixed workflow. and then save or cancel those changes as required. Save the changes to the page as a draft. Saving changes to the page reassigns its status as a draft. You can preview the changes that have been made as if the page was live. The page can be edited at any of the stages in the workflow. Changes to the page are not seen in the live site until the page is approved and published. 47 . The draft page can be declined and sent back to the user for more changes. Cancelling an edit causes the page to remain at the same stage in the workflow. The page remains in the staging site until the workflow process has been completed. Draft a page. Send the draft page for approval to an administrator or user with approval permission granted. The approved page can be published to the live site. Upon navigating to the Pages area and clicking All Pages. All page workflow actions are done within the Pages area.

Page is published: If a page has been published to the live site. decline the changes (which necessitates that the pages must be re-edited). If the changes to the page have been declined.USER MANUAL Send a page for approval. or edit the page themselves. it may be edited as necessary. 48 . If the changes to the page have been approved. The approver can choose to approve the changes to the page. the users with the appropriate permissions may then publish it to the live site. Page is approved. Page is declined. the only choice available is to re-edit the page again and re-submit for approval.

49 . the following properties of which can be localized: menu label title description keywords There is a Language Selector control that you can use on the public side to allow users to switch between the languages. Here is its location in the toolbox: Here is its appearance on the page: This dropdown list will populate with a list of languages available in the Sitefinity system.USER MANUAL Page Localization The localization at page level assures that your site will have localized versions of each page. Each language version is a separate instance.

Click the language you want to add: 50 .USER MANUAL To create a foreign language of a page. Select a page in the site map. follow these steps: 1. 2.

Set the localizable properties such as menu label. and click Create this version. title. etc. 51 .USER MANUAL 3.

52 . theme and all controls are copied from the English version and there is no relation between the controls in the English and German versions of this page. The page is now displayed in Edit mode. The page template. so users can navigate between the English and German versions of the page.USER MANUAL 4. Drag and drop a language selector onto the page for the English and German versions. theme and controls from the English language version as shown below: 5. Here you have two options: edit it from scratch or copy the template. 6.

USER MANUAL 8. click the Edit this page button if localization is turned off. Working with Controls Adding Controls Sitefinity allows users to add tools from the toolbox. To edit a page.). To add a control to a page. If it’s turned on. etc. The demos instructions below assume that localization has been turned off in Sitefinity. Expand the Add Controls toolbox. Image. which is located on the right hand side of the edit a page screen. 53 . Select a control from the list (Generic Content. 2. follow these steps: 1. click Edit this language version button.

Click Edit this page. The property modifications are reflected immediately. Click to select the page in the site map. 3. Click the trashcan icon: Setting Control Properties The Control Properties Grid is a powerful tool that allows developers and end-users to configure controls placed in a particular page directly from within the browser and eliminates the need for offline configuration and upload of the control files. Deleting Controls To delete a control: 1. To set the control properties: 1.USER MANUAL 3. Click the Add button. 2. choose a container to add the control to or drag and drop the control into a placeholder. 3. From the dropdown list. 4. 54 . Click Edit this page. 2. Click Edit in the control header to access the Control Properties grid. Click to select a page in the site map.

such as the Images and Documents module’s download list shown below. which allow end users to check off boxes and use other UI controls to adjust properties: Some of the controls. such as a tags list.USER MANUAL Some controls use content view designers. use just have a properties tab instead: 55 .

56 .USER MANUAL The following images represent the Basic and Advanced tabs of the Image control.

click I’m done to save your changes. such as logical grouping of user controls that provide common functionality and business logic. 2. After adjusting properties.USER MANUAL 4. Working with Modules Modules are reusable self-contained units you can easily integrate in many different applications. 9. You can use them to present content on a Web site or to extend the functionality of your Web site. click Cancel. To exit the Control Properties grid without saving your changes. User controls: Developed by the user and easily integrated in the Sitefinity Modules section as an assembly. Sitefinity provides the structure to integrate modules and offers two options: 1. Pluggable modules: A set of pre-built pluggable modules offering the common functionality that comes with Sitefinity: 57 .

To demonstrate this functionality. The public side consists of the controls that users should insert on the page. change date format and assign labels next to fields. These controls allow end users to display content within certain categories. here are some screenshots of the ContentView for the News module: 58 . Images and Documents. change the display mode. Forums Module: Allows users to create and moderate forums on a Web site. such as the Blog Posts control. Blogs Module: Allows users to easily create and manage blogs. Polls Module: Allows users to quickly create and publish online polls on a Web site. remove fields. ContentView Controls The News. and Events modules use ContentView controls to display data on the public side. if applicable. Each module has an administrative and public side. manage and reuse separate content items. Lists Module: Allows users to create and manage all kinds of lists. The administrative side is seen by clicking on the Modules tab in Sitefinity. to show the module’s data on the page. Blogs.USER MANUAL Generic Content: Allows users to create. News Module: Allows users to manage features and articles on a Web site. Images & Documents: Allows users to upload shareable images and documents. stored in libraries Events: Provides users with ability to schedule and announce events through their website Newsletters: provides basic functionality for creating newsletters and management of emails and subscriber groups.

USER MANUAL 59 .

This feature is especially convenient when there are users responsible for content authoring/editing only and others responsible for adding that content to the Web pages. After branching. store and manage content items most comfortably. the default text is displayed in the list of items. other CMS users can select shared items from that list and add new items to it. The site is updated automatically when the content contributor makes changes to a shared item. When you want to edit just one instance of the content item. Each item of shared content is represented by a unique content ID and meta information such as name (required). and changes made to it are not reflected elsewhere. all pages where the same item appears are updated simultaneously. Content Sharing and Branching The shared content feature allows you to reuse content items over multiple Web pages. Each time a user creates a content item in the Generic Content module. If description and author are not specified. the item is independent. Locked by user: The item is open for editing and the changes are not saved or cancelled. branch the content. it is added to the shared content items list. changes made in the previously shared item are not reflected in the branched item. The content ID is used when requesting the content data. When in edit page mode. you need to remove it from the shared content items list first. an item can be in one of the following states: Published: The item is automatically published upon its creation. When content workflow is switched off. that is. 60 .USER MANUAL Generic Content This is where you create. description and author. Similarly. Whenever one instance of shared content is updated. You need to be granted the proper Module permissions to be able to manage shared content.

you need to be granted the View and Create permissions for the Generic Content module as shown below: 61 . Create a shared content item To create shared content and edit your own items. go to Modules > Generic Content.USER MANUAL Administrative End To access the Generic Content module.

4. 62 .USER MANUAL Even if you do not have any Page permissions. You can create shared content in either of the following ways. In the Generic Content module: 1. you can still contribute shared content. Go to Modules > Generic Content. A. Insert some content in the content area. It is advisable to give unique names. 3. 2. Click Create new item. Type the name of the content item. This field is required. This field is required.

7. Type the name of the author. This field is optional.USER MANUAL 5. Click Create this item. 8. 63 . 6. Add some description of the item. 9. Attach tags to the content items. Select a category from the dropdown list. This field is optional. The item is then shown in the All Content Items list.

3. 5. Go to Pages > Site Map.USER MANUAL B. Insert some content in the content area. In the Generic Content control: 1. Select a page and click Edit this page. 64 . Click Edit in the Generic Content control header. 4. Click the Share this content link. 2.

65 . 9. Click Share this item. type the name of the content item. Add some description of the item. Edit a content item 1. Click I’m done to close the Generic Content Properties grid. Go to Modules > Generic Content. This field is required.USER MANUAL 6. 2. 7. This field is optional. 8. Search for the item you want to edit and click Edit next to it. This field is optional. It is advisable to give unique names. Type the name of the author. When the dialog opens.

Go to Modules > Generic Content. Delete a content item 1. For more details about permissions. If you are using this item across many pages. 2. please refer to Module Permissions. Modify the content item and click Save changes. Select a role from the dropdown list and select the necessary checkboxes to grant permissions for that role. your changes will affect all pages and will be visible on the live site after publishing. When you go the page(s) using a content item that has been deleted. Set permissions for the Generic Content Module Click the Permissions link in the left pane. 66 . Search for the item you want to delete and click the trashcan icon next to it. you will see the following message: This content has been deleted.USER MANUAL 3. When you are done. click Save Changes.

Please read the localizing modules section for more info. Create an item in the default site language. 5. 1. 4. Create the new language version by entering the language specific content in the content area. Change the language by clicking on one in the Change Language box. and enter content in the form: 2. Click Edit this item . 3. which is English in the example below. 67 .USER MANUAL Localization This topic outlines the steps you need to follow to create different language versions of content items. Click Save changes.

If you click the trashcan icon. If you click Edit. To add existing shared content to a page. 2. click to select the page where you want to insert content. 4. do the following: 1. In the site map. go to All Content Items and select the language in the dropdown list.USER MANUAL In this example. Expand the Add Controls toolbox. the Name field is not set as localizable. Public End A. that is why it is the same for all language versions of the item. 5. 68 . Select the Generic Content control. 3. all language versions of the content item are deleted. Click Edit this page. Refer to section Multilingual Content Management > Module Localization for more details about localization of meta fields. Go to Pages > Site Map. you are redirected to edit item mode for the respective language. To view all items created for a particular site language.

Click Edit in the Generic Content control header. 7. 8. 69 . Click the Select shared content link to view all available items. Drag and drop the control to the desired page area.USER MANUAL 6.

you can filter items by name and author. 9. click Select next to the item you want to insert.USER MANUAL In the Select Shared Content Dialog. 70 . In the grid.

Click I’m done. The item is displayed in the editor content area. 71 . 11.USER MANUAL 10.

4. To branch shared content and create an item that will be stored only with the page (static content). Go to Pages > Site Map. 72 . 3. do the following: 1. Click Edit in the control header. Click the Branch this content link. Select a page and click Edit this page. Find the Generic Content control with the content you want to branch.USER MANUAL B. 2. 6. click I’m done. 5. When you finish editing the content.

The News module provides a comfortable way to incorporate news articles and display them on your web site. Complete the form that appears on screen 4. follow these steps: 1. so it shares a common user interface with it. Click Create a new item 3. go to Modules > News: Create news To create a news item. Administrative End To access the News module. Schedule when the news article should go public and its expiry date with the integrated calendar as shown below: 5. Go to Modules > News 2. Click Create this news item: 73 .USER MANUAL News The News module is based on the Generic Content module.

USER MANUAL Edit news To edit a news item. Go to Modules > News. Go to Modules > News. Modify the article and click Save changes. Delete news 1. 2. 74 . 3. follow these steps: 1. 2. Find the news article you want to delete in the list of news and click the trashcan icon next to it. This will open the News editor dialog. Find the news article you want to edit in the list of news and click Edit next to it.

click Save Changes. please refer to Module Permissions. For more details about permissions.USER MANUAL Search News Select the search criteria from the dropdown list and click Search: Set permissions for the News Module To set permissions on the news module. 75 . When you are done. click the Permissions link in the left pane.

Change the language. 3. This topic outlines the steps you need to follow to create different language versions of news. 76 . 1. Create a news item in the default site language. 2. Click Edit this language version.USER MANUAL Localization Localizing news content is almost identical to localizing content in the Generic Content module.

Click Save changes. Create the new language version by entering the language specific content in the content area. 5. To view all news items created for a particular site language.USER MANUAL 4. 77 . go to All news items and select the language in the dropdown list in the upper right corner of the screen.

USER MANUAL By clicking Edit. all language versions of the news item are deleted. you open the German version of the news article for editing. 78 . If you click the trashcan icon.

Drag and drop the control to the desired page area. click save if workflow is turned on. 6. 3. 7. do the following: 1. In the site map.USER MANUAL Public End The news module uses a single control to display news stories called the NewsView: To display news articles to a page. follow these steps: 1. Click edit on the control 8. On the top left of the screen. Select the NewsView control. Adjust the properties to fit your needs 9. Click Edit this page. Expand the Add Controls toolbox. Follow steps 1-4 for displaying news articles 2. Select the News Archive control 3. click to select the page where you want to insert the full text of the news articles. 4. If it’s off. click publish to save your changes To display archived news articles. Go to Pages > Site Map. 5. Drag and drop the control to the desired page area 79 . 2.

Blog posts typically consist of: title (headline) body (main content) post comments permalink (URL of the full. Fill in the Blog name. On the top left of the screen. the newest post is always at the top.USER MANUAL 4. Create a blog 1. Click Create this blog. Description and Author fields. If it’s off. The entries are organized in reverse chronological order. 3. 80 . click save if workflow is turned on. Click Create a blog. click publish to save your changes Blogs A blog is an online journal where you post entries and make them publicly accessible. go to Modules > Blogs. 2. that is. Now you can create the first post in this blog. individual article) post date (the date and time the post was published) Administrative End To access the Blogs module.

which will be discussed later. 2.USER MANUAL The blog page field must be filled in with the page with the Blog Posts control. 81 . Create a post 1. 4. Edit a post 1. Enter some content. Click Create this post. This will enable features such as Windows Live Writer Support. 5. Click Create a post. 3. 7. 2. Find the blog where you want to create a post and click it. Click Go to all blogs. Set the publication date. Click Go to all blogs. Fill in the post title. 6. Find the blog containing the post you want to modify and click it.

Make your changes to the blog post. Find the post in the All Posts list. Click Set Details in the left pane. 4.USER MANUAL 3. 3. The rich text editor opens. 82 . Find the blog whose settings you want to edit and click it. and click Edit. Click Save changes. Click Go to all blogs. 2. as outlined in Edit a post above Edit blog settings 1.

Localization Localizing blogs content is almost identical to localizing content in the Generic Content module. Create a post in the default site language. find the blog you want to delete and click the trashcan icon next to it.USER MANUAL Delete a blog In All blogs. 83 . 1. This topic outlines the steps you need to follow to create different language versions of blog posts.

3. 6. There are also three other controls to add functionality to the blog and here is a complete list of all controls: 1. 3. Public End A single control called Blog Posts must be inserted on the page to show content. Click Save changes. 2. BlogPosts: displays blog posts. Archive: Provides a RadTreeView used to filter posts be a specific date that have been archived Bloggers: Provides a list of bloggers Calendar: Shows a calendar used to filter posts by a specific date These controls are accessible in the page’s toolbox by expanding the blogs section: To display the blogs on the webpage. follow these instructions: 1. 4. 3. 7. Go to Pages->Site Map In the Site Map.USER MANUAL 2. Change the language. Create the new language version by entering the language specific content in the content area. Click Edit this post. click to select the page where you want to insert the BlogPosts control Click Edit This Page (or Edit this Language Version if localization has been turned on) Expand Add Controls-> Blogs: Drag and drop the BlogPosts control where you want it Hover the mouse over it. 5. Perform steps 1-4 of displaying blogs on your web page 2. 4. 5. 4. and click edit Edit Follow the Step-By-Step wizard to configure the look and behavior To display an archive on your page. Drop an archive control onto the page 84 . follow these instructions: 1. 2.

instructions. tasks.USER MANUAL To display a list of bloggers on your page. It allows you to create logically related list items. You create these items using the Lists module and then display the list on the Web page by dragging a Lists control. 2. testimonials. to-do lists. Drop a bloggers control onto the page To display the Calendar on your page. etc. follow these instructions: 1. 85 . follow these steps: 1. 4. each of which has a headline and content. interviews. 3. contacts. dictionaries. Perform steps 1-4 of displaying blogs on a web page Drop a Calendar onto the page Click edit on the calendar control Enter blogs as the provider under the data section as shown below: Lists The Lists module provides a simple and efficient way of organizing FAQs. Perform steps 1-4 of displaying blogs on your web page 2. links.

USER MANUAL

The provided public control ensures the relation between the separate elements. In FAQ, for instance, where each item consists of a question and answer, each question can be an anchor taking you to the answer further down the page; the answer can be expanded when a question is clicked; all the questions can be on a single page and each answer can be on a separate page, etc. The main advantage of the Lists module is that it eliminates the need to format items while writing content. All formatting comes from the css files and themes and content contributors do not have to worry about bullet styles, separators between the items, different css classes for each item, etc.

Administrative End
To access the Lists module, go to Modules > Lists.

86

USER MANUAL

Create a list 1. Click Create new list. 2. Type the list title in the text field. 3. Click Create this list.

4. Type the headline and content of the first list item and click Add this item.

87

USER MANUAL

Add an item to an existing list 1. Click All Lists in the left pane to display all existing lists. 2. Select the list to which you want to add items.

3. Click Add new list item. 4. Type the headline and content for the new list item and click Add this item.

Edit a list item 1. In All Lists, select the list where the item is. 2. Click Edit to open the item editor. 3. Click Save changes when you are done.

Delete a list item Select the list where the item is and click Delete.

Change the order of items in a list 1. In All Lists, select the list you want to reorder. 2. Find the item you want to move and click Up or Down.

88

USER MANUAL

Set Permissions for Lists Module Click the Permissions link in the left pane. When you are done, click Save Changes. For more details about setting permissions for Lists, please refer to Module Permissions.

89

Expand the Add Controls toolbox. do the following: 1. In the Selected lists grid. 8. 3. 90 . Select the Lists control. Click Edit this page. 9. In the site map. 4. 6. 2. 5. Go to Pages > Site Map.USER MANUAL Public End To display content created in the Lists module on a Web page. Click Edit in the control header to display the Basic Properties tab. 7. From all existing lists. click to select the page where you want to insert a list. Drag and drop the Lists control to the desired page area. select the list(s) you want the control to display. you can define the order in which the lists are displayed by clicking Up or Down.

Click I’m done to close the Basic Properties grid. You will find: a simple list in Blogs > Posts (right column) an expandable list in Academics > Majors an anchor list in Admissions > Applying FAQ an expanded list in About Us > Housing Opportunities 91 . To customize the appearance of your lists.USER MANUAL 10. To see the examples of different types of lists. go to the TIU sample site. select one of the predefined display modes. The default list display mode is Simple list. select among more predefined modes. 11. In the dropdown list.

edit and delete polls/poll questions and answers at any time prevent duplicate votes by checking IPs release blocked IPs display poll results graphically reset the vote count Administrative End To access the Polls module.USER MANUAL Polls A Poll is an excellent way to get feedback from users. then you place the poll on as many pages in your site as you like through the Poll Box control. go to Modules > Polls. Through its intuitive user interface. the Sitefinity Polls module allows you to: set up any number of polls for your Web site manage multiple polls at the same time display polls on any page activate/deactivate polls control poll layout and design add. 92 . You use the Polls module to construct the poll.

Enter the possible poll answers. Pick a chart color for each poll answer. Go to Modules > Polls tab and click Create a poll. 4. 5. 93 . Enter the poll questions. Click the Add new question button to append more questions.USER MANUAL Create a poll 1. 3. Select the type of answers for each question in the dropdown list. 7. 2. If you select checkboxes. Enter the poll title. Click Create this poll. 6. you will allow multiple selections.

Go to Pages > Site Map. 4. 94 . 6. click to select the page where you want to insert a poll. please refer to Module Permissions. delete or view a poll. 5. do the following: 1. Click Edit in the control header to display the Control Properties grid and click Select. 3. When you are done. 2. Drag and drop the control to the desired page area.USER MANUAL All Polls list Here you can edit. click Save Changes. Click Edit this page. Select the Poll Box control. In the site map. 7. Expand the Add Controls toolbox. Public End To display content created in the Polls module on a Web page. Set Permissions for the Polls Module Click the Permissions link in the left pane. For more details about setting permissions.

Click I’m done to close the Control Properties grid. Select the poll you want to insert and click I’m done. 95 .USER MANUAL 8. 9.

select a category to assign the forum to. You can edit these settings later. 3. Click Create this forum. Administrative End To access the Forums module. Create a forum 1. but users cannot create posts) 5.USER MANUAL Forums This module enables you to run multiple forums on your Web site form a single management interface. 2. start threads of questions and responses and organize the forums into categories. Now you can create the first thread in this forum. Each forum can belong to one category only. Users can create forums. 4. go to Modules > Forums. Click Create new forum. Fill in the Forum name (required) and Description fields. 96 . Set the forum as one of these: Visible (the forum is public and users can create posts) Hidden (the forum is not publicly accessible) Locked (the forum is visible on the live site. In the dropdown list.

Manage forum posts 1. Click Create this thread. 5. 4.USER MANUAL Create a thread 1. Go to All Threads. Go to All Forums. Delete a thread 1. Go to All Threads. Fill in the Thread title (required). Find the forum where you want to start a thread and click its name. Click Delete next to the thread you want to delete. Enter some content (required). 97 . 2. 2. 3. 6. Click Create a thread.

click the name of the thread you want to view. Click Save changes when you are done. 4. The Quote section displays the whole original post.USER MANUAL 2. You can edit or delete the quote altogether. 98 . Find the post you want to manage and click Edit/Delete/Reply. 3. In the list of threads.

Make your modifications and click Save changes when you are done. 99 . In All Forums. 2.USER MANUAL Change forum settings 1. click Settings next to the forum whose settings you want to edit.

When in All Forums.USER MANUAL Manage categories 1. To create a new category. click Rename in the list of categories. 2. enter a unique category name and click Rename: 100 . click Categories in the left pane. fill in the text field and click Create: 3. To rename a category.

USER MANUAL 4. For more details about setting permissions. 101 . Sample forum below belongs to the Music category which has been deleted. please refer to Module Permissions. click Save Changes. click the trashcan icon next to the category in the grid (see above). Set Permissions for the Forums Module Go to All Forums and click the Permissions link in the left pane. If there are forums assigned to the deleted category. When you are done. To delete a category. they are moved to Uncategorized.

you can make various combinations of the forums public controls listed above. please refer to this KB article: Using the different Forums module controls. If you need to customize the appearance of forums. it is usually enough to insert the Forums control on the Web page.USER MANUAL Public End There are five public controls that you can use if you want to have forums on your Web site: Forums: provides a list of forums for your site Forum List: provides a categorized list of all forums Single Forum: Lists the threads of a single forum and options to create a new thread Single Thread: Shows the contents of a single thread and all child posts Edit Post: Used to create or edit forum threads and posts To display the forums created in the module on a Web page. For details about creating and adding your own Forums provider. make sure you add a script manager in your . For details about using the public controls for Forums. you should set the LoginPage property to redirect to the registration page. If you are using the Forums public controls in your site.master file as shown below: <asp:ScriptManager ID="ScriptManager1" runat="server"> </asp:ScriptManager> This is required since the introduction of the RadEditor Prometheus control. please look at the Developer manual: Sitefinity Modules > Forums > Forums Provider Customization. If you have restricted the anonymous access (“Deny anonymous authors” property is set to true in the forum settings). 102 .

Moreover. so it can be easily reused and shared. videos and other types of media. The module’s goal is to provide end users with an easy-to-use option to create. you don’t have to take care of the image or documents paths when creating/migrating your site. instead of transferring and managing the image and documents files separately.USER MANUAL Images & Documents This module provides a shared storage medium for images. This module ensure that this content is stored in one place. documents. 103 . When migrating the project. edit and share content and select it for use in public controls. it is much easier to transfer the whole project database. The benefits for web site administrators are automatic handling of permissions and automatic storage and retrieval from and to the project database. for example.

you are prompted to create your first library. type the name that you want to appear in the user interface. Click Create your first library (or Create a library at the All libraries screen): 2.USER MANUAL Administrative End Create a library When you first go to the Modules > Images & Documents tab. 3. In the Name field. Select the type of library you want to create: • Image Library: can contain items with file extensions . See the image below. jpg. each library is a container of different types of content items. To create a library: 1. The library is the main unit of this module.gif.png. 104 . .

.xlsx. 4.ppt.txt. . You can change the allowed file types and create custom library types from the application web.xls.USER MANUAL • • • Document Library: can contain items with file extensions . . . Expand More Options to set the following restrictions: • Max library size: the maximum sum of the sizes of all items in the library in MB • Max number of files: the maximum number of items the library can hold • Max file size: the maximum size of a single file in the library in KB • Enable cache – enable this for faster browsing o Use default settings.pptx.html.doc.config file.docx. . . .wmv. Video Library: can contain items with file extensions . or o Define your expiration settings 105 . . Custom Library: can contain items with all file extensions.pdf.rtf. .

To set any of the above to unlimited. Click Upload when you have selected the items to upload. for example. you need to upload content items to it. If you re-upload a document. Click Create this library. if a file with the same name is uploaded. leave the corresponding field empty. 106 . Browse to select the item to upload. some of them are kept as metadata: • • • • Name: the name of the item appearing in the user interface. etc. At the All Libraries screen. A message is displayed if the maximum number of items to upload in the library is reached. 5.USER MANUAL This content will be cached until the content has been changed. Upload items After you create a library. 3. Select the library in which you want the item to reside. click Upload. Click Add to select more items. Every item has associated metadata. a number is appended to the name Size: the size of the file on the disk/the original size of the item Author: the name of the user who created the item Description: an explanatory note about the item To upload items to a library: 1. These are the properties of each library item. documents. or it expires. 2. depending on the type of the library it belongs to. This button is disabled when the maximum number of items for the library is reached. it is the same as the filename. 4. by default. There are different kinds of items: images. videos. then the cache expires.

USER MANUAL 107 .

Boxes: List: The operations that can be performed from the All Libraries screen are described below.USER MANUAL Manage libraries There are two view modes available for libraries: boxes and list. 108 .

View all items in a library: click the name of a library in the list. 109 . For more details.USER MANUAL 1. refer to section Create a library above. Change library settings: click Change Settings to open the key properties of the library. Delete a library: click the trashcan icon to delete the library. 4. Check how many items are currently uploaded in a library. 2. 3. the items are also deleted from the database. Clicking the number displays all the items in the library in a list.

USER MANUAL Manage items You can view the uploaded items in an image library either as thumbnails or list. Thumbnails List 110 .

Batch edit Click the Batch edit link to if you want to open all library items and edit their key properties at once or attach the same tags to all items.USER MANUAL The operations that can be performed from the All Items screen are described below. 1. 111 .

For a document library.USER MANUAL For an image library. you can edit the Title. you can edit the Title and Alternative text properties. Author and Description properties. 112 .

Edit an image item You can perform the following actions at this screen: • • • edit the name of the item open the original file in a new window reupload the file to replace the image (this replaces the thumbnail automatically) • edit the item’s Author. Width and Height properties and associate a category or tags to the item. Alternative text.USER MANUAL 2. 113 .

Edit a file You can perform the following actions at this screen: • • • • edit the name of the item download the original file reupload the file to replace the library item (metadata stays the same) edit the item’s Author and Description properties.USER MANUAL 3. associate tags and category to the item 114 .

This control has two view modes: list and table. 115 . Since most of the items from the module are used in public pages. please refer to the online FAQ. this will be done through the rich text editor.USER MANUAL 4. When an item has to be inserted in a Generic Content item for example. The module provides its own implementations of dialogs.5 only. which retrieve items from the module and include them in the Generic Content. Note: The Video control is available in the Sitefinity for .NET 3. Sort items by file extension. Public End The Images&Documents module provides three public controls that serve to display content from a set of libraries on a public Sitefinity page: The Download List displays a list of files uploaded in document or custom libraries. there should be easy ways to select which item to include in a page. Delete an item Click the trashcan icon to delete the item: 5. A typical scenario in which it may be used is creating a public picture gallery on a web site. It can be used to create a vide section on a web site. The Image Gallery displays images from libraries. The Video control is based on Telerik’s RadMediaPlayer for Silverlight and is used to display videos uploaded in video or custom libraries. download items and view links to items. For more information.

Its basic features are the following: • • • • Customization of meta fields Commenting system Categorization of events Tagging of events The module also provides geomapping feature for the location of events.in case event is taking place in United States). This feature provides built-in functionality for location geocoding (retrieving geo-latitude and geo-longitude values) based on the street. country and state (state . the Events module provides users with ability to schedule and announce events through their web site.USER MANUAL Events Based on the Generic Content module. You have the option to display maps of events’ location from three leading map services: • • • Google Maps Yahoo! Maps Live Maps Here is a screenshot of an event using Google Maps: 116 . city.

The module introduces a new specific panel for working with Geomapping settings. which allows users to provide necessary data (such as API key) for working with third party APIs. A peculiarity of the Events module is the ability to display the events both as a list and a calendar. panels for managing tags. Go to Modules > Events 7. if you are more interested in the actual date and time when an event starts or ends. On the other hand. Complete the form that appears on screen 9. with standard abilities to manipulate events (create. delete). of course ability to define module specific permissions. categories and comments. follow these steps: 6. When you are more interested in the event’s content (like Title or Category to which it belongs). with ability to observe day. and. the list view is more convenient. update. go to Modules > Events: Create events To create a news item.USER MANUAL Administrative end The administrative end of the module is largely similar to that of the other Generic Content based modules. the calendar view would be more convenient. week or month Create a new event by clicking in an empty slot of time Edit an event by double-clicking it Reschedule an event by dragging it from one location to another Reschedule the length of an event by dragging the bottom handle of an event box To access the Events module. view. The calendar view provides a familiar interface similar to Google Calendar or Outlook Calendar and provides users with the following options: • • • • • View events in a graphical calendar view. Click Create a new event 8. Schedule when the event should go public and its expiry date with the integrated calendar as shown below: 117 .

Find the news article you want to edit in the list of news and click Edit next to it. Go to Modules > Events. Go to Modules > Events. follow these steps: 4. 6. 5.USER MANUAL 10. Modify the article and click Save changes. 118 . Click Create this news item: Edit event To edit a news item. Delete events 3. This will open the News editor dialog. Find the Event that you want to delete in the list of news and click the trashcan icon next to it. 4.

Single and Auto. Public end The Events module offers two out-of-the-box controls: • Events View This control is based on the Content View control and is used for displaying a list of events as well as a single event. 5. It displays events in a calendar-like interface.USER MANUAL Localization Localizing Events content is almost identical to localizing content in the Generic Content module. Create an event in the default site language. Change the language. 4.NET AJAX. Users can browse the calendar and to get detailed information about an event. follow these steps: 1. 2. To give you a high level overview of creating language specific event content. Click Save changes. 3. Here is a picture of the EventsView control: • Events Schedule View This control is similar to the calendar view of administrative side and it’s the RadScheduler for ASP. It offers three modes of display: List. they only need to double-click the event. Create the new language version by entering the language specific content in the content area. Click Edit this event. Here is what the Events ScheduleView could look like: 119 .

This is how to do it: 120 . Administrative End The module’s administrative end provides an interface for administrators to be able to: • • create and manage subscriber groups create and send newsletters (an option to send the same newsletter/message to a specific category or a set of subscribers) SMTP Server Settings In order to use the Newsletters module you need to enter the settings of your SMTP server. General attributes of newsletters include news and upcoming events of the related organization.USER MANUAL Newsletters This module provides basic functionality for creating newsletters and management of emails and subscriber groups. as well as contact information for general inquiries. A newsletter is a publication regularly distributed to a group of subscribers.

a verification email will be sent. The settings will be applied to the Newsletter Module. Click on the link SMTP Server Settings in the left side pane. Click on button Activate. 2. Log in to the Administration and go to section Modules>Newsletters. enter the settings of your SMTP Server. 5. 121 . 3. 4. Using the SMTP server settings and email provided in step 3. Click on button Test and save current setting.USER MANUAL 1. In the page which opens.

2.USER MANUAL Create subscribers The first thing you need to do is define the potential mail recipients and group them. Type the name of the group. first and last name of the newsletter recipient. Click Add (selected). Click Create a subscriber group. To do so. To create a new subscriber group: 1. Demo. and just add an email to it. 3. you may choose to add from already registered CMS users to this subscriber group. Alternatively. 6. 122 . 4. 5. For testing purposes you can use the provided sample subscriber group. Click Create. Click Add subscriber. Enter the email address. click add registered CMS users and select the users to add as subscribers.

123 . Here you can select from existing Sitefinity roles and create groups of subscribers based on the registered CMS users assigned to the roles. thus you will not have to add the email addresses of the recipients manually. one by one.USER MANUAL Manage subscribers The Manage subscriber groups link provides a more advanced option for creating subscriber groups.

USER MANUAL In the Subscriber Groups grid. you can perform the following operations: • • • • • • sort groups by creation date sort groups by name view. add and remove subscribers view all newsletters to a given group rename a subscriber group delete a subscriber group 124 .

USER MANUAL Create a newsletter When you first go to the Modules > Newsletters tab. Type the subject. Here you can perform the following operations: • edit details such as subject. you are prompted to create your first newsletter. sender details and recipients • edit the email content • view the content in a new browser window 125 . Select the subscriber groups you want to receive the newsletter. Write the content in the formatted panel or using plain text by pressing the Use plain text button. Click Next: Preview before sending. 6. 5. 2. 3. Click Next: Write content. sender’s name and email address. (optional) 7. To create a newsletter: 1. Send a test email before sending to real subscribers. Click Create newsletter. 4.

USER MANUAL • • • • send a test email before sending it to the real recipients send the newsletter to all recipients save the content as a draft discard your changes and return to All newsletters Public End The Newsletter module offers a newsletter sign up form for public users: This form subscribes users to a specific newsletter: This form can ask for an e-mail or an e-mail and the user’s name. 126 .

USER MANUAL Tags and Categories Sitefinity supports tags and categories for content from the Generic Content. At the All Items screen. Tags These are very much like keywords you attach to content items. Forums and Events modules. they are both used to describe and organize content items and allow you to easily search for or browse related content within the CMS. Tags and categories are very similar. The author of the content item can specify as many tags as they need. type a name for the tag and click Add. 3. 127 . click the Tags link in the left pane: 2. To create a new tag. News. By default all existing tags are displayed alphabetically. Manage tags for a module 1. The number of items assigned to a given tag is shown in brackets.

click Popularity list: 7.USER MANUAL 4. 128 . 5. the larger the font size in the tag cloud view. click Tag cloud. To view a tag cloud. 6. Point the mouse over to view the rename and delete links. The more frequently a tag has been used. To sort tags by popularity. Click the tag link to open a screen with the tagged filtered items.

2. it will be displayed in the input field. If you click it.USER MANUAL Attach tags to content Users have the ability to tag content in three different ways while creating/editing the content item: By explicitly typing the tag into the textbox By selecting from already existing tags used by any CMS user By selecting from already existing tags that have already been used by the user 1. Click the Add a new tag link button to expand the dialog. A suggested word can appear from the existing tags. Start typing in the tag name field. 129 .

Click My tags/All tags to display a list of tags. 130 . Click an existing tag to add it to the list above. click the trashcan icon next to the tag in the list. Click Add to attach the tag.USER MANUAL 3. 5. To unassign an item from a tag. it is displayed in yellow and it then fades to the default background. When the new tag is added. You can also choose from existing tags. 4.

Usually. which is Generic_Content. If you leave this field empty. News Lists). you need to insert the Tags List control on a page and then edit its properties as described below: 1.USER MANUAL Display tags To display tags on the web site. 3. select the page to which the user will be redirected after opening a tag link. this is the page where the respective list control has been inserted (Post List. Click Edit in the control header. the default provider for cmsEngine will be used. type the name of the provider from which tags are displayed. Make sure that the Behavior > TagItemKey property matches up to the Category Key for the module ([ModuleName]TagID). For the news module. Expand the Data section and in the ProviderName field. this property should be NewsTagID as shown below: 131 . 2. Expand the Behavior section and for the TaggedContentURL field.

USER MANUAL

Categories
Sitefinity supports categories for content from the Generic Content, News, Blogs, Forums, and Events modules. Categories help you classify and organize related content items. The basic difference between tags and categories is that an item can belong to only one category, whereas tagged with many tags. Manage categories for a module 1. Click the Categories link in the left pane:

2. A list of all categories for this module will be displayed. Each category is a link which opens all module items associated to this category.

132

USER MANUAL

3. To create a new category, type a unique name in the Add a category text field, select a category under which it belongs (if needed) in the subcategory of drop down list, and click Add. Note: you cannot enter a category with a name which already exists.

4. To edit a category name or its position in the categories hierarchy, click Edit in the list of categories, enter a unique category name, select a parent category, and click Update:

5. To add a subcategory under an existing category, click on the Add a subcategory link, enter a unique name for Subcategory name, and click Add subcategory. 6. To delete a category, click the trashcan icon next to the category in the grid (see above). If there are items assigned to the deleted category, they will be moved to Uncategorized.

133

USER MANUAL

Categorize content To categorize content while creating/editing a content item, simply select an existing category from the Category dropdown list:

134

USER MANUAL

Display categories To display categories on the web site, you can use two controls: Categories List and Categories Tree. To use any of the two controls, drop the control on a page and then edit its properties as described below:

1. Expand the Behavior section and for the CategoryContentUrl field, select the page to which the user will be redirected after opening a category link. Usually, this is the page where the respective view or list control has been inserted (News View, News Lists). 2. In the Behavior section set the values of the fields CategoryKey and CategoryKeyType to be the same as those of the View or List control on the page selected in the previous step. To see the values of the Content View or List control, expand its Query String Keys section. 3. Expand the Data section and in the ProviderName field, type the name of the provider from which categories are displayed. If you leave this field empty, the default provider for cmsEngine will be used, which is Generic_Content. The Categories Tree control is based in the Telerik’s RadTreeView for ASP.NET AJAX and allows enhanced capabilities in terms of visualizing categories: 4. To hide the count number of the items associated to each category from the tree view, expand section Behavior, and select False for ShowContentCount. 5. To set the root category to show in the tree view, expand section Behavior, and select True for ShowRootCategory. 6. To set a filter for categories, expand section Filters, and enter a category for which you want to filter the tree view in the field RootCategory. 7. In the RadTreeView section you can make setting to the TreeView. a. Setting ShowLineImages to True displays lines connecting the Nodes. b. The CategoriesTreeView field allows you to select a different TreeView control.

135

go to the initial screen for the Wiki module. which binds all the levels in the data source to the control. The field ExpandAllNodesByDefault defines if the category node should show expanded by default. and the Wiki’s creation date. To view a list of the existing Wikis. an owner. The Wikis can be created and managed in the Wiki module or they can be created through the same Wiki control. the user has to go to the Wiki module by going to Modules > Wiki. or the author who created it. description. a short description. this property should be NewsCatID as shown below: Wiki Created through a public control. The list can be sorted by name. an author. The default is -1. owner (author) or the date the wiki was created. Wiki content has a name. Below is an image of the module’s WikiView control: Administrative Side Wiki List View To manage the Wikis. A Wiki has a name. d. The values in the MaxDataBindDepth field allow you to set the maximum number of hierarchical levels to display. a Wiki consists of Wiki contents that are articles. For the news module. html content. make sure that the Behavior > CategoryKey property matches up to the Category Key for the module ([ModuleName]CatID). For both display types. Below is a screenshot if this view: 136 . a user-friendly title.USER MANUAL c. and the Wiki content can be categorized or tagged.

These details are the name. Then. Then. The user can press the Create the Wiki button or the Cancel button to return to the previous screen. the creation date and the count of wiki contents for the specified wiki. the user has to press the Create Wiki button. the user has to go to initial screen (Modules > Wiki) and select the desired Wiki. Below is a screenshot of creating a Wiki: Wiki Preview To view an existing Wiki. the user goes to the preview screen to display Wiki details. the user types a unique name for the Wiki and optionally enters a short description. 137 . the description. the owner.USER MANUAL New Wiki View To create a new Wiki.

the user can set the permissions of the Wiki for every role. the Wiki can inherit the permissions of the Wiki module. To break inheritance or reconnect inheritance. The user can change the name and the description of the wiki as shown in the image below this paragraph: Wiki Permissions View To change the permissions for the selected Wiki. the user click the inherit or break button as shown below this sentence: 138 . the user has to select the Permissions tab. the user has to continue to the edit screen by pressing the Edit this Wiki button or selecting the Edit tab. By default. On this screen.USER MANUAL Wiki Edit View To edit the Wiki.

the user has to go to the module’s categories screen. This categories screen is identical to the categories views of the other Generic Content based modules: Generic Content. Module Permissions View To manage the permissions of the whole module. the user has to go to the Permissions screen of the Wiki module. News. Images and Documents. and Events. Blogs. Here is a screenshot of setting up permissions: 139 .USER MANUAL Categories View To manage the categories of the Wiki contents. Like the Categories View. setting up permissions is the same for the Generic Content based modules.

the user has to go to the Administration section of Sitefinity. On the next screen. the user creates a search index by clicking the Create a search index button.USER MANUAL Wiki Search Index To create or manage a search index for the Wiki content. the user completes information about the Wiki as shown below this sentence: 140 . Then.

the user has to go to the edit screen of the page where the control will be added.USER MANUAL Public Side Adding Wiki Controls to a Page To add one of the Wiki public controls. Below is the edit screen of a page with the Wiki controls circled: 141 .

To set the control properties. By default. the display mode is auto and the control itself decides how to show the content. Here is a screenshot of the property: 142 . the user has to open the edit dialog. the user must go to Behavior > BehaviorMode and select Master to show a list articles or detail to show a single article.USER MANUAL To add the WikiView control the user has to drop it onto a container. then left clicking the edit button as shown below this sentence: The WikiView control can be used to display a list of Wiki contents and a single Wiki article. This can be done by hovering over the control. To change the display mode.

The WikiView control is based on the ContentView control with some enhancements. the category and the tags of the content. To set the search index for the search controls the user has to fill the IndexCatalogue property.USER MANUAL To set one of the properties related to the Wiki content. To set a default display mode for the specified Wiki. The Content Screen displays the Wiki Content Title (or its name when a title is absent). the user has to use the WikiMode property. reviewing comments. the user has to fill the WikiName property. Below is an image of this screen: 143 . When the user clicks the tag or category. then the first content created for the specified Wiki will be displayed (usually the home content). when no Wiki is provided. To set a default Wiki content that will be displayed when no content is provided the user has to fill the WikiPage property. In detail mode. a RadEditor. a functionality deriving from the ContentView control. the content. By default this property is set to show the Content screen. If this field is left empty and no wiki content is specified. the control has several screens divided by tabs. The Edit Screen contains an input for the content title. The WikiView is the main control that can be used to list Wiki contents or to visualize a single Wiki. expand the “Wiki” category as shown below this sentence: To set a default Wiki that will be displayed. Wiki View Several controls can be used to display and to search Wiki contents. listing previous versions of the content and there is a search screen. similar to the editors in Sitefinity with a new tool for managing the wiki links. There is a section for viewing content. the user sees content related to those identifiers. editing the information.

USER MANUAL Here is an image of the link manager: 144 .

One is for the Wiki name and the field contains a combo box that lists the existing Wikis. that lists the available Wiki contents for the selected Wiki. The edit section controls editing your existing Wiki content. Below is an image of the history tab: 145 .USER MANUAL This tool can be used to modify existing Wiki links or to create new ones. If the edited Wiki content does not exist then clicking the “Save” button creates it. then she can delete the Wiki content by pressing the Delete button. To create a brand new link. so the users can select a category. The user may enter a non-existent Wiki into this field. by adding functionality for comparing revisions. The History Section contains a version control. When properly selected. The link manager has three inputs. which uses a combo box. It also creates a Wiki if the edited content does not belong to an existing Wiki. When a Wiki content name is selected (by selecting an existing from the list or by typing a new one) the Insert button is enabled and the link can be inserted. extending the Sitefinity VersionList control. The second field is for the Wiki content name. the tool has its input fields set to the corresponding parts of the wiki link. If the edited content already exists and the editing user has the right permissions. select the link with the mouse or the keyboard by highlighting it. the current Wiki will be used. highlight the word and launch the tool. To modify an existing link. manage tags and make other changes. The Comments Section contains the Sitefinity control for listing and adding comments. To create a new link from a word. When no Wiki name is provided. click on the link manager without highlighting any content. The third input is a text box for the inner text that will appear for the anchor tag representing the Wiki link.

name. The Search Section contains Sitefinity based controls for filtering Wiki contents by several criteria: keyword.USER MANUAL The two versions are compared by checking the checkboxes on their rows and pressing the compare button. One area is for the differences in the Wiki content title and the other is for the differences of the Wiki content itself. title. 146 . name. tag and category. circled above this paragraph. Two additional areas are included in the screen.

the user must have Create rights for the whole Wiki module. To view the Content. The search by keyword uses the standard Sitefinity SearchResult control and is based on indexed Wiki contents. the text box changes to a combo box. based on a tag or a category. 147 .USER MANUAL When searching for Wiki contents. The rest types of searches uses a wiki search result control based on the Sitefinity SearchResult control. The results of the search are displayed in different controls according to the filter criterion. History and Search screens the user must have View rights for the current Wiki. To create non-existing Wiki content. To create a non-existing wiki. the user must have Create rights. In order to edit the Wiki content the user must have the Modify rights and in order to delete the wiki content or rollback to a previous revision the user must have the Delete rights for the current wiki. The searches by tag and category use the master mode of the ContentView control. Comments. In order to view and use the different screens the user must have the corresponding permissions.

a new blog created . news. The last part is the Indexing Service Instances. Pages. description. The index can have multiple indexing clients. which uses Lucene. The most important members are: the event Index which is fired along with new URLs to index (say a news item added. it can even have multiple indexing clients instances of the same type (say 2 blogs clients but with different settings). Services Search The search service provides a solid and efficient way to search in your published web site pages (both normal and external). 148 . adds some details about it (name. All data related to the Indexing Services and Clients is stored in the Sitefinity database. the user creates a new index (this means Indexing Service instance but we will use index for the sake of simplicity). News. Basically. etc.net engine.net stores its indexes in the ~/App_Data/Search folder. The Indexing Clients provide URLs to the Indexing Services. It is composed of several search Indexing Clients. However. search patterns) then chooses which indexing clients will be used to “feed” this service with URLs to index. Currently. etc.USER MANUAL 10. Lucene.) Indexing Services are services that take the URLs from the IndexingClient and do the real indexing. These are the ones you can see in the Admin screen.) are classes which implement the IndexingClient interface. blogs or any other searchable module. the actual indexed URLs could be stored in a separate database. Indexing Clients (such as Blogs. we have only one indexing service.

To create an indexing service. In the Search Patterns field. Type the Index Name and Description in the appropriate fields. Click Add search index. specify the types of pages you want the index to look into: 149 . go to Administration > Services > Search. 3. you should first specify the indexing services that will index its pages. 2. Create a search index In order to start searching your Web site. you need to create a search index first.USER MANUAL Administrative End To access the Search service. following the steps below: 1.

it is displayed in the All Indexes list. you should specify which index sources the index will look into. 150 . Click again to force reindexing.USER MANUAL In each created search index. You should click the Start indexing link button so that the pages are indexed for the first time and Search public controls can work properly. Click PageIndex. 2. In the What to index part. To add an index source: 1. When you create the new index. set the properties for each client according to the client type: Starting node to index: set the path to the parent page from which to start indexing Index non-public pages: select if you want to index pages for which anonymous access is denied. Auto Index: select if you want to reindex a page automatically when the page is published.

USER MANUAL Edit a search index 1. 3. Choose the search index you want to edit. Click edit on the control 6. It contains the search box and search button The Search Results control displays the results retrieved for the keywords entered by the user in the search box. It does the actual searching. Select the search index you’d like for this search box 151 . The Search Box control is used to enable the site users to enter their keywords and search for them in the site index. Select a page where you’d like to see the search results 7. Public End There are two controls that should be placed on the page to enable the search feature for your Web site. 2. description and search patterns) and add/delete indexing sources. click pages 2. From the right hand side of the page. You can modify the index details (name. To insert a Search Box control follow these steps: 1. Click Edit this index to open the item editor. Choose a page where you would like users to search for content 3. Click Save changes when you are done. On the top navigation. 4. Click Edit this Page if localization is turned off or Edit this Language Version is localization is turned on in Sitefinity 4. drag and drop a search box onto the page 5.

Choose a page where you would like to display search results 10. based on your workflow requirements 152 . From the toolbox on the right. Click Edit this Page if localization is turned off or Edit this Language Version is localization is turned on in Sitefinity 11. based on your workflow requirements 9. Save or publish the page. drag and drop a search results control 12.USER MANUAL 8. Save or publish the page.

there are two RSS providers that allow syndicating the blogs and news you create with Sitefinity. To have RSS 2. Blogs and News modules. 153 . your blogs and news articles can become available to other sites or individual subscribers. If you need to implement RSS channel providers for your own modules. Sitefinity supports RSS feeds for content created in Pages. look at the Developer Manual: Services > RSS Implementation. there must be an RSS Provider implemented for that specific content. Through RSS feeds. go to Administration > Services > RSS Feeds. The syndication settings determine whether or not XML syndication feeds will be available for the content posted to a blog.USER MANUAL RSS Feeds With the Sitefinity RSS service you can easily feed content as RSS data. Currently. Events. Forums.0 syndication for content in your site. Administrative End To access the RSS service. letting people view the latest updates.

USER MANUAL 154 .

3. This is usually the page containing the Post List or News List control. type the path to the . Type a phrase or sentence to describe the feed in the Feed description field. select the page you want the user to be redirected to when s/he clicks the RSS feed title in an RSS reader. 2. 5.rss) or relative (for example ~/MyBlogs. 4. In the Feed URL field. The path can be either absolute (for example http://mydomain/MyBlogs. At the next step. 155 . follow the steps below: 1. Click Create new feed.rss file that the procedure creates. For the Channel page field. 6.USER MANUAL Create an RSS feed To create an RSS feed.rss). you need to specify the content to syndicate by configuring at least one channel. Type a name for your feed in the Feed name field.

Items count – type the number of news articles to display in the channel Item structure – select the type of feed to display: Full Article. Set the following channel properties: Article page – select the page in which the news article will open when the RSS item title is clicked. ii. Expand News Channel. Title and Summary or Title only. Select the news to syndicate. To syndicate content created in the News module: i. This is usually the page containing the Single News control. iii. Summary length – enter the number of characters to display in the summary 156 .USER MANUAL A.

Title and Summary or Title only.USER MANUAL B. Click Create this feed. Items count – type the number of items (posts) to display in the channel Item structure – select the type of feed to display: Full post. Summary length – enter the number of characters to display in the summary 7. ii. Select the blogs to syndicate. 157 . To syndicate content created in the Blogs module: i. This is usually the page containing the Single Post control. Expand Blogs Channel. iii. Set the following channel properties: Post page – select the page where the post will open when the RSS item title is clicked.

rss file will appear in the text field.USER MANUAL Edit an RSS feed Click Edit this feed in the list of feeds to modify feed properties. Drag and drop an RSS Feed control onto the page. Click Edit this page. Public End In order to provide RSS syndication for content in your site. The path to the . select the RSS feed. 5. 2. click to select the page where you want to insert the control. It is very similar to the Hyper Link control but apart from creating the link. Go to Pages > Site Map. For the NavigateURL field. 8. you need to put an RSS Feed control on a Web page. Click Edit in the control header. type the text to display as link. 3. 7. 6. it also inserts a link tag in the head section which shows that the page is in an RSS feed. 4. In the site map. Expand the Add Controls toolbox and then the RSS Feeds section. 158 . To add the RSS Feed control to a page. do the following: 1. In the Text field.

All users assigned to a given role inherit the permissions defined for that role. the administrator decides to allow Josh to edit post comments. one. Such users can be managed by any user who is granted the Manage Users permission. A user can be assigned zero. 11. Roles are an efficient way to manage permissions for groups of users as they classify users with similar characteristics and responsibilities. so your website can easily be reused. Roles also determine which portions of CMS a user can view. There is one role that is automatically created with each new Sitefinity project: the Administrators role. You can define the set of privileges for each role and assign users to roles. the administrator should choose between: creating a new role where this particular permission is allowed and adding Josh to it. you can: create roles and user accounts modify user profiles view and sort users 159 . So. or modifying the Editors role and granting all users assigned to it this additional permission. At the Administration > Users tab.USER MANUAL Tools Sitefinity offers site export tool. modules and site map permissions. You cannot: restrict the permissions granted to the Administration role delete the Administrators role delete the last user in the Administrators role. too. For example. For more information. The admin user is assigned to it by default and granted full global. please read Exporting Web Sites as Templates. However. Josh belongs to the Editors role that allows him to edit pages. or many roles. A user role is a group of users associated with a set of user privileges. Users and Roles Overview Sitefinity users (also referred to as CMS Users) are users who can conduct content management and/or administrative tasks with a given Web site project.

USER MANUAL delete users and roles assign users to roles remove users from roles 160 .

USER MANUAL Creating a User Account Follow the steps below to create a new user. You will see a list of all available users. 161 . All fields in the Membership Info section are required. Go to the Administration > Users. You can also do that later. Enter the user details. 3. A form with the user profile fields opens. We assume that the currently logged user belongs to the Administrators role. 5. Click Create user. 4. 2. Assign the user to role(s) by checking the role(s) in the checkbox list. 1.

Click Create this user. The new user is shown in the list: 162 . 7.USER MANUAL 6.

. Telerik.AspnetProviders. 1.. Follow the steps below to add the field Nickname. <fieldset class="userinfo set"> <cc1:ManageProfile ID="manageProfile" runat="server" Mode="Insert"> <InsertTemplate> <ol class="setIn"> <!-. Open the application web.Add the new profile field HERE. Find this section and add the new profile property: <profile defaultProvider="Sitefinity"> <providers> <clear/> <add name="Sitefinity" connectionStringName="DefaultConnection" applicationName="/" type="Telerik. open the ~/Sitefinity/Admin/CmsAdmin/Users..DataAccess"/> </providers> <properties> <add name="FirstName"/> <add name="LastName"/> <add name="Nickname"/> </properties> </profile> 2. <div class="workArea"> <div class="mainForm"> . <InsertTemplate> .config file.aspx file add the lines in red: A.DataAccess... For example: <li> <cc2:FieldLabel ID="lblNickname" runat="server" Text="Nickname" TargetID="Nickname"></cc2:FieldLabel><asp:TextBox ID="Nickname" runat="server"></asp:TextBox> </li> --> 163 . To display the field at the Administration > Create/Edit User screens.. <cc1:ManageUsers runat="server" ID="manageUsers"> .TelerikProfileProvider.USER MANUAL Adding User Details You can extend the user profile with additional fields from the application web.config file.

. For example: <li> <cc2:FieldLabel ID="lblNickname" runat="server" Text="Nickname" TargetID="Nickname"></cc2:FieldLabel><asp:TextBox ID="Nickname" runat="server"></asp:TextBox> </li> --> 3. <cc1:ManageUsers runat="server" ID="manageUsers"> .... For example: <li> <cc2:FieldLabel ID="lblNickname" runat="server" Text="Nickname" TargetID="Nickname"></cc2:FieldLabel><asp:TextBox ID="Nickname" runat="server"></asp:TextBox> </li> --> 164 . <fieldset class="userinfo set"> <cc1:ManageProfile ID="manageProfile" runat="server" Mode="edit"> <EditTemplate> <ol class="setIn"> <!-. <div class="workArea"> <div class="mainForm"> ... open the ~/Sitefinity/Admin/CmsAdmin/MyProfile.. <fieldset class="userinfo set"> <cc1:ManageProfile ID="manageProfile" runat="server" Mode="Insert"> <EditTemplate> <ol class="setIn"> <!-.USER MANUAL B.Add the new profile field HERE.aspx file and add the field as shown below: <asp:MultiView runat="server" ID="MultiView1"> <asp:View runat="server" ID="ProfileView"> <div class="workArea insert"> <div class="mainForm"> .Add the new profile field HERE. <EditTemplate> .. To allow users to change their nickname in My Profile.

When you are done. The user profile form opens.USER MANUAL Editing User Details 1. 2. 165 . Apply your changes. You cannot change the Username and Password. Click the Profile link in the list of users. click Save user info.

USER MANUAL Managing Users and Roles Click a role in the left pane and all users assigned to it will be displayed: From here. 166 . assign users to a different role. d. delete users. edit user profiles. remove users from the current role. it is most convenient to: a. b. c.

You can perform group deletion by selecting and clicking the Delete link or trashcan icon above the list. even not yet approved will be saved. 167 . click the trashcan icon in the list of users. Any content modifications made by the user.USER MANUAL Deleting a User To delete a user.

8. 168 .USER MANUAL Changing Current User Details Each Sitefinity user can change their user profile. To edit your email. Click Save user info. Click My Profile in the top right corner of the screen: 7. Apply your changes. You cannot change your username. 6. first name and last name: 5. The user profile form opens. Log in Sitefinity.

8. 7. Click the Change Password link in the left pane. Re-enter your new password. 10. Click Change password. 169 . 9.USER MANUAL To change your password: 6. Enter your new password. Enter your old password.

3. Type the desired role name: 4. 2. Click the Create a role link in the left pane.USER MANUAL Creating a Role Follow the steps below to create a new Sitefinity user role. We assume the currently logged user is assigned to the Administrators role. Click the Administration tab. Click Create. 170 . 1.

We assume the currently logged user is assigned to the Administrators role. You will see a list of all available roles. Click the Manage roles link in the left pane. 1. Click the trashcan icon next to the role you want to delete. Click the Administration tab.USER MANUAL Deleting a Role Follow the steps below to delete a user role. You cannot delete a role to which there are users assigned. You can use the View Users link to temporarily remove users from the role you want to delete. 171 . 2. 4. 3.

These permissions are set if a page will be accessible by the members of a public user role or if a secured page will be included in the navigation controls. There are two explicit permission settings in Sitefinity: Allow and Deny. 172 . authorization for that permission can be inherited from other roles to which the user is assigned. that user cannot perform that function. the permissions for the pages are the same (inherited) by default. for example the RadTreeView and RadMenu controls. the user inherits the Allow or Deny for that permission. This is why if a permission is Unset for a given user in one role and explicitly set for another role the user is assigned to.USER MANUAL 12. When certain permissions are set for the site map. Inheritance Permissions in Sitefinity are inheritable. Deny Denies authorization for the user role to perform the action stated. The permissions are left unset. Allow is the second-most powerful permission setting in Sitefinity and the one most frequently set. Deny is the most powerful permission setting in Sitefinity. because the permission is neither explicitly set to Deny nor explicitly set to Allow. even if he or she belongs to another role that has the same permission set to Allow. There are several types of permissions: Global Permissions Module Permissions Site Map/Pages Permissions Live Pages Permissions Permissions that apply to the users assigned to a public user role. If a user belongs to a role that has a specific permission set to Deny. If a Sitefinity user does not have any permission. Unset By default. they can only navigate through the public part of the site. However. Allow Grants authorization for the user role to perform the action stated. most permissions in Sitefinity are not set to either Deny or Allow. Permissions Permissions are rights that define the type of actions a given user can perform. There is also an implicit deny setting available: Unset. which implicitly denies user roles authorization to perform the action specified.

roles. his permissions are set to “unrestricted”. 1.USER MANUAL Global Permissions These are privileges to manage users. modules. permissions and files. that is. site map and pages permissions. Manage permissions allows you to: view the Administration > Permissions tab manage global. Manage users allows you to: view the Administration > Users tab create user accounts edit user details assign users to roles remove users from roles delete users create user roles delete roles with no users in them 2. 173 . By default there is one administrator user who is granted full global permissions.

4. rename and edit templates. duplicate. Edit templates allows you to: view the Templates tab upload master pages. rename and delete files/folders. copy. CMS access allows you to access the Sitefinity backend 174 . delete. Manage files allows you to: view the Files tab upload. move.USER MANUAL 3. 5.

175 . To set the permissions for a whole module. go to the respective module tab and click the Permissions link in the left pane. Select a role in the dropdown list and define the permissions for the users assigned to it. These permissions apply to all content items and not to a single item as in pages.USER MANUAL Module Permissions These allow the site administrators to control the management of third party controls that support this functionality.

Modify allows you to edit content items created by other users. Create allows you to add new content items and edit your own items. 4. 5. View allows you to see the module tab and all content items. 2. Change Permissions allows you to set the user permissions for the whole module. 176 . Delete allows you to remove content items.USER MANUAL 1. 3.

5. but not page properties. View allows you to view draft and published pages. This permission should always be set to Allow.USER MANUAL Site Map Permissions Permissions granted to control the management of the whole Web site content. Modify allows you to edit pages. go to the Pages > Site Map tab. 1. These permissions are inherited as page permissions by default. Create allows you to create new pages. 4. 2. 3. Select All Pages and click the Permissions tab on the right. ChangePermissions allows you to manage user permissions. To set the permissions for all the pages. Select a role in the dropdown list and define the permissions for the users assigned to it. Delete allows you to delete pages. 177 .

8. Publish allows you to publish pages.USER MANUAL 6. ModifyLayout allows you to change page Template and Theme. 9. ChangeProperties allows you to edit page properties. 7. Approve allows you to approve or decline page modifications. Modify must also be granted. 178 .

USER MANUAL Page Permissions Permissions given for a page to control the management of the page content and controls content. 2. Select a role in the dropdown list and define the permissions for the users assigned to it. To change this. All permissions set for the site map are inherited as page permissions. To set the permissions for a page. go to the Pages > Site Map tab. 179 . Create allows you to create new pages. 1. Select the page in the site map and click the Permissions tab on the right. View allows you to view draft and published pages. click the Break inheritance link. This permission should always be set to Allow.

6. ModifyLayout allows you to change page Template and Theme. 8. find Anonymous access. ChangePermissions allows you to change rights granted to users. Set the View page permission for the role whose access you want to restrict. 4. If you want to secure a page and restrict the access to it. Modify must also be granted. 2. 9. 180 . Click the Properties tab. 7. 5. Click to select the page in the site map. In the More Options section. Select Deny to restrict anonymous user access to the page and require authentication. 5. Delete allows you to delete pages. 4. but not page properties. Publish allows you to publish pages. Approve allows you to approve or decline page modifications. you can use the Anonymous access property: 1. 3. Go to Pages > Site Map. ChangeProperties allows you to edit page properties.USER MANUAL 3. 6. Modify allows you to edit pages.

such as the ViewTemplates folder. You need to add impersonation for the ASPNET account in the project web. right-click to select an existing folder and click New Folder from the context menu. To copy a folder.USER MANUAL 13. To create a folder. you can create. upload. The granted access will be in accordance with the permissions of the impersonated user. go to the Files tab. select Copy. File Manager The Sitefinity File Manager displays the hierarchical structure of folders and files in your project. 181 . move. and delete files and folders. Only users who are granted proper permissions will be able to access the File Manager. In order to open the File Manager. copy. To move a file or folder. The File Manager automatically appends a number in brackets to the end of the name if a folder with name already exists.config file to enable the File Manager and to access the application file system. The new folder is displayed with the default name New Folder. right-click to select it and from the context menu. rename. Using it. first select it and then drag it to an existing folder.

first select an existing folder and click Upload files.USER MANUAL To rename a file or folder. To delete a file/folder. Type the name and press Enter or click outside the textbox. browse to select a file and click the Upload button. click the Add button and select another file. In the Upload file dialog. If you need to upload more than one file. To upload files. Structure of a Sitefinity Site 182 . right-click the folder or the whole row with the file you want to rename and select Rename from the context menu. click to select the entire file/folder row and then select Delete from the context menu. click Cancel. To navigate to the parent folder. To exit the Upload file dialog. click Folder Up.

The App_Master folder contains the master pages that are available for use by pages in your Sitefinity-managed Web sites. You can add your own themes to this folder to create additional themes within Sitefinity. The bin folder contains all .USER MANUAL Sitefinity File Manager: Visual Studio: 1. 183 .master file as it is required for the proper functioning of the system. You can add your own master pages to this folder to create additional master page types within Sitefinity.dll files. which in turn map to page templates. Each theme in the folder corresponds to a choice when you are creating a new page in Sitefinity. 7. The App_Browsers folder contains the browser definition file where we have inserted an HtmlForm adapter. 5. The App_Data folder contains the database where Sitefinity stores the pages and controls used by the sites that it manages. The Files folder is created automatically by Sitefinity. Each master page in the folder corresponds to one or more page template choices when you are creating a new page in Sitefinity. The App_Themes folder contains the themes that are available for use by pages in your Sitefinity-managed Web sites. 3. Media or Flash managers in the RadEditor. 6.mdf. this is a SQL Server 2005 or 2008 database named Sitefinity. This is where all your files will be uploaded if you use the Document. You must not delete the Dummy. 4. By default.config file that control the overall configuration of your Sitefinity installation. The Application root folder contains the login and registration pages and the web. 2.

How to Upload Files to the Server and Display Them to Users Using the Images and Documents module. click Files 3. 3. On the top navigation. which will not be inserted in the Images and Documents module. and display them. The Sitefinity folder contains the files that make up the Sitefinity public controls’ interfaces. The Images folder is created automatically by Sitefinity. This is where all your images will be uploaded if you use the Image manager in the RadEditor. Click on a folder 4. 4. click Edit this Language Version or Edit if localization is turned off From the right hand side of the screen. The App_LocalResources folder contains local resources which are mapped to the upper level files. The User Controls folder contains the site navigation user controls and their VB versions. drag and drop a Generic Content module: 184 . 2. Login to Sitefinity 2. follow these instructions: 1. Click upload files To show links to files. follow these steps: 1. as well as these subfolders: The Admin folder contains all files that make up the administrative part of Sitefinity. files are uploaded as binary data to the database. The ControlTemplates folder contains the templates used by the public controls. modify the respective template. To change the markup or static data for a public control. To upload the files. Login to Sitefinity On the top navigation.USER MANUAL 8. It will allow only authenticated users to request files from this folder. 5. 9. click on Pages > Sitemap Click on a page If localization is turned on. The Common folder contains image files used by the Web pages for the public user interface. You can upload files as static files.

click Select from Already Uploaded Documents 9. Click the document icon 8. On top of that module.USER MANUAL 6. click edit 7. 185 . In the dialog. Select the file and click I’m done Sitefinity will display a link to the file. Select the Files tab 10. when these steps are finished.

If you want to apply ASP. 4. . 2.MemoryCachingProvider. Telerik.config file. Page Caching To enable caching for at the CMS level you need to apply the following settings: 1. . Add value “pageCacheProvider” and set its attribute to one of the caching providers listed in the caching section of web.Framework" /> </providers> <cacheDependency mode="InMemory"/> </caching> Caching is applied on a page level. Find the <cms> section in the application web. Caching Sitefinity comes with inbuilt caching capabilities. set the value of “pageCacheProvider” to “*ASPNET*”. set the value of “pageCacheProvider” to “*NO*CACHE*”. for example “memoryCache”: <cms defaultProvider="Sitefinity" pageExtension=".NET caching to pages.Caching.aspx" pageCacheProvider="memoryCache" . You can also cache pages individually by following these steps: 1. If you want to turn off caching for pages. Go to the Pages > Sitemap tab 2. There is one caching provider currently available: <caching defaultProvider="memoryCache"> <providers> <add name="memoryCache" type="Telerik. Either create a page or click on the page properties tab 186 .USER MANUAL 14. There is a section in the web.config. > 3.config file which lists the caching providers and their settings.

Click More Options and check off the box for enable caching: 187 .USER MANUAL 3.

Login to Sitefinity 2.config is an XML file that resides in the Web site’s root directory. Localization works on site. you should set the persistenceMode attribute to either "QueryString" or "PathPrefix" to define the way URLs will be created: 188 .config file. Configuring Localization .Overview The Sitefinity Standard Edition supports multilingual sites and each one needs to have a default language. The Application Configuration Overview Many aspects of the application can be configured through its web. This file contains configuration settings and application-wide data. When you need to change any of these settings. you do not need to modify the code or recompile your application.config file. such as database connection strings. Although you can only have one default language per Web site. For more information on the Web.config file. First.USER MANUAL 15. Click on Pages 3. page and the module level and uses the same two letter abbreviations from the CultureInfo class. Choose the appropriate language: To configure localization for pages. you only need to edit the web. custom error messages and culture settings.config file. please review this article. follow these steps: 1. Site Localization Sitefinity allows end users to pick the site’s language: Users can also choose which version of a page to edit by following these steps: 1. 2. The web. Find the <localization> section in the application web. Sitefinity supports an unlimited number of language versions of a website.

Save the web. 4. Find the localization element in the application web. this is what the web. bg"> 3. for example: <add key="www. </cultureMappings>”. follow these steps: 1. independent from the client browser settings and locale.config. If you would like to have another default language. To force a specific culture. Insert a line for each domain you want to map.config. To illustrate.com" culture="en" />. set the default culture property to the language’s two letter prefix: <localization defaultProvider="Sitefinity" persistenceMode="PathPrefix" defaultCulture="es" cultures="en. setting the defaultCulture attribute to es does not ensure that the selected language in the dropdown (and hence the language version of the page that opens) is always Spanish.config file and you will see the language selector in the top right corner of the screen. Find the <localization> section in the application web. and “culture” is the culture to which you want to map it. de. Create a new section which contains the domains and the cultures to which they are mapped. surround it with opening and closing tags: “<cultureMappings>”.USER MANUAL <localization defaultProvider="Sitefinity" persistenceMode="PathPrefix" defaultCulture="en" cultures="en.config file. fr"> Notice that the default culture is set to English. This depends on the browser settings: the default language set in the client browser definition overrides the defaultCulture definition in the application web. 2. do the following: 1.mydomain. 2. fr. Add the autoSetClientLanguage attribute and set it to false: <localization defaultProvider="Sitefinity" autoSetClientLanguage="False" persistenceMode="PathPrefix" Mapping Domain Name and Extension to Culture To Map a Domain Name to Culture. In the above example. where “key” is the domain name you want to map. The order of languages in the dropdown is the same as set for the value of the cultures attribute. es.config file will contain after the update: <localization defaultProvider="Sitefinity" 189 . 3. Set the persistenceMode attribute to "DomainName".

Localization.config file. Find the <localization> section in the application web. </cultureMappings>”.Data.config file.Localization.mydomain.mydomain. Telerik.uk" culture="en" /> <add key="fr" culture="fr" /> </cultureMappings> 190 . fr"> <providers> <clear/> <add name="Sitefinity" type="Telerik. 4. 3. Save the web.Localization. and “culture” is the culture to which you want to map it.com" culture="de" /> <add key="www.fr" culture="fr" /> </cultureMappings> </localization> 5. Create a new section which contains the domains and the cultures to which they are mapped. For each domain you want to map insert a line. To illustrate.Data.DefaultProvider.DefaultProvider. 2. fr. this is what the web. Telerik. for example: <add key="com" culture="en" />.Localization.com" culture="en" /> <add key="www.config file will contain after the update: <localization defaultProvider="Sitefinity" persistenceMode="DomainExtension" defaultCulture="en" cultures="en. bg"> <providers> <clear/> <add name="Sitefinity" type="Telerik.Data" connectionStringName="DefaultConnection"/> </providers> <cultureMappings> <add key="com" culture="en" /> <add key="co. de.USER MANUAL persistenceMode="DomainName" defaultCulture="en" cultures="en. Set the persistenceMode attribute to "DomainExtension".Data" connectionStringName="DefaultConnection"/> </providers> <cultureMappings> <add key="www. surround it with opening and closing tags:“<cultureMappings>”.mydomain-de. de. where “key” is the domain extension you want to map. To Map a Domain Extension to Culture. follow these steps: 1.

follow these steps: 6.. Save the web. note that Sitefinity maps automatically a domain extension to a culture when there is a match between the two.. To make the Description field of the Generic Content module localizable. Setting this enables you to create versions of the content items for all the site cultures and display them by switching the languages in the selector on the live web site.config file and set the allowLocalization attribute to true. 5. Find the <cmsEngine> section in the application web.config file. Module Localization You can localize the following modules: Generic Content News Blogs Events To create different language versions of a module.USER MANUAL </localization> Please. <cmsEngine defaultProvider="MODULE_NAME"> <providers> <clear/> <add name="Generic_Content" visible="True" defaultMetaField="Name" securityProviderName="" allowLocalization="True" .Description" valueType="LongText" visible="True" searchable="False" localizable="True" sortable="True" defaultValue="Add description here"/> Here is the end result in English: 191 . You do not need to set the mapping explicitly in such cases. for example. add the text in red: <add key="Generic_Content. Find the <metaFields> section and set the localizable attribute to true for all fields that you want to localize. 7.

The fields that are used to create the URL. will have a French language equivalent. so when you change to the French version. In the example above.USER MANUAL Here is the end result in German: By localizing fields. for example.aspx" 192 . The content’s description field. Use ID for URL rewriting: urlRewriteFormat="[Publication_Date]/{ID}. you can do either of the following: 1. should not be localized: <add providerName="Blogs" publicationDateField="Publication_Date" urlRewriteFormat="[Publication_Date]/[Title]. Use GUID for URL rewriting: urlRewriteFormat="[Publication_Date]/{GUID}. the title will still say language. for example Name for the Generic Content module. the content’s title is not localizable. however.aspx" If you need to make these kinds of fields localizable. you ensure that field can have a foreign language equivalent.aspx" 2.

Save the Web.Data" /> 3.Data. 193 . The site administrator can easily track the modifications. follow these steps: 1.DefaultProvider.Engine.aspx" urlDateTimeFormat="yy-MM-dd" urlWhitespaceChar="_" visible="True" defaultMetaField="Name" securityProviderName="" allowLocalization="True" allowVersioning="True" allowWorkflow="True" allowComments="false" commentsModeration="true" versioningProviderName="" connectionStringName="GenericContentConnection" type="Telerik. Telerik. Save the Web. Telerik. the user identity and the time of the changes.Data" /> 2.DefaultProvider.Cms.config: <cmsEngine defaultProvider="Generic_Content"> 2.config Module Level To configure workflow at the module level. Page Level To enable workflow on the page level. Find the module’s provider (The Generic Content module is given as an example): <add name="Generic_Content" urlRewriteFormat="[Publication_Date]/[Name]. the changes are saved as a new version of the original content.Cms. Each time some content is modified.Providers. Sitefinity stores the history of content modifications.Cms.config: <add connectionStringName="DefaultConnection" allowPageHistory="true" allowPageWorkflow="true" cachingProviderName="ASPNET" name="Sitefinity" type="Telerik.Data.USER MANUAL Configuring Workflow and Versioning Sitefinity supports workflow on the module and the pages level. Set the allow page workflow attribute to true in the Web. The original content is saved in the database and can easily be restored.Cms. follow these steps: 1.Engine. Locate this line of code in your Web.config Page History This feature is not available in the Sitefinity Community Edition.

Click to select the page in the site map and go to the History tab. The original content is saved in the database and can easily be restored.Data. find this line and set the allowPageHistory attribute to false: <add connectionStringName="DefaultConnection" allowPageHistory="false" allowPageWorkflow="false" name="Sitefinity" type="Telerik. Each time some content is modified.Cms.config file and find this section: <cmsEngine defaultProvider="Generic_Content">. Go to Pages >Site Map. In the <add> element for the respective module. the user identity and the time of the changes. News and Blogs modules.Cms.. Click View to open a preview of an older version of the page. module history is enabled. open the project web. open the application web. find the allowVersioning attribute and set it to False. This is what it should look like for the News module: <add name="News" defaultMetaField="Title" visible="False" securityProviderName="" allowVersioning="False" . 3.USER MANUAL By default. page history is enabled. Click Rollback to substitute the current template with an older version. Module History Sitefinity stores all versions of items created within the Generic Content. Telerik. The site administrator can easily track those modifications.Data" /> To preview and roll back to previous versions of a page: 1. 2. the changes are saved as a new version of the original content. To disable it. To disable it.DefaultProvider. 4.config file. By default. 194 ..

195 .Cms.Web. replace the default CmsHttpModule with CmsHttpModuleUrlRewrite (shipped with Sitefinity) <httpModules> <add name="Cms" type="Telerik.Web.Replace() method in . In the <httpModules> section. To switch it on.Add your rule elements here --> <rule> <url>[input URL pattern]</url> <rewrite>[replaced URL]</rewrite> </rule> </urlrewrites> This section above sets the rules for rewriting the URLs and you can add one or more rules here.Cms. These rewrite rules are evaluated from top to bottom. Set up your rules.USER MANUAL URL Rewriting By default. you need to do the following changes in the web.CmsHttpModuleUrlRewrite. the URL is rewritten and the search through the rewriting rules terminates.NET. Rewriting is based on the regular expressions technology and it’s similar to using the RegEx. Add a configuration section element <configSections>: <configuration> … <configSections> <sectionGroup name="telerik"> … <section name="urlrewrites" type="Telerik.config file: 1. the URL Rewriter is switched off. Please refer to Regular Expressions as a Language for more information about Regular Expressions. Telerik.AdvancedUrlRewriter. If a match is found.Cms"/> </httpModules> 3. The <url> is a pattern expression and <rewrite> is a replacement string. Add an <urlrewrites> section: <configuration> <telerik> … <urlrewrites> <!-.Cms"/> </sectionGroup> </configSections> 2. Telerik.

which looks like this: <customErrors mode="RemoteOnly"/> The required mode attribute can be one of the following: On: error details are not shown to anybody.aspx?ProdId=1 products.aspx) that will manage each product. For more information.aspx product2. even local (logged in) users.config file. they can be brought to a user friendly static page informing them of an error and that a software developer shall fix it.NET exception messages. Instead. There are several ways to implement custom error pages. which does not require changes to be made in the application web.*)\. Working with Web Pages. You can do that by setting wildcard application mappings in IIS or by configuring 404 redirection. When you first download Sitefinity. Note also that it is not possible to use the URL rewriter to create pages without file extension. 196 . Setting Custom Error Pages in the Web.config Custom error pages are created so that end users.aspx Will be rewritten to: products. You can specify more than one URL for a page from the Page Properties tab.aspx?ProdId=$1</rewrite> </rule> </urlrewrites> This will rewrite the URLs in the following manner: URL product1. primarily. If you specify a custom error page. For details about each approach.aspx </url> <rewrite> Products. don’t see ASP. it will always be used. Sitefinity provides one more way to rewrite URLs. you may have the following rule in <urlrewrites>: <urlrewrites> <rule> <url> product(. please refer to 7. please refer to Wildcard Application Mappings and Extensionless URLs topics.aspx?ProdId=2 products.config file.aspx?ProdId=Any Apart from the advanced method described above. and you want to access each product without using a query string.USER MANUAL Example: If you have a products page (products. you will see a <customErrors> section in the application web.aspx productAny. requesting a Product Id (ProdId) in the query string.

For more info on custom errors. it will not be used. The optional defaultRedirect attribute specifies the default URL to direct a browser to if any error occurs. If a custom error page is available. both local and remote users.aspx can be a page managed by Sitefinity or a static page. A generic error is displayed if the defaultRedirect attribute is not specified. while remote users will be presented with a concise page notifying them that an error has occurred.yoursite.aspx" /> <customErrors> PageNotFound.aspx) or absolute (http://www. RemoteOnly: local users will see detailed error pages with a stack trace and compilation details.aspx). The <customErrors> tag may also contain several <error> subtags for more granular error handling. If you specify a custom error page.USER MANUAL Off: error details are shown to everyone.com/errors/PageNotFound. For example. you may display a custom 404 for missing pages and a general error page for all other exceptions: <customErrors mode="RemoteOnly" <error statusCode="404" redirect="~/Errors/PageNotFound. The URL to a custom error page may be relative (~/Error/PageNotFound. Each <error> tag allows you to set a custom condition based upon an HTTP status code. please read this MSDN article. it will be shown to the remote users only. 197 .

.]..config file.. For each meatafield set the value of the attribute “searchable” to true or false 198 . if this attribute is empty.. d. contains the values for which the rule is created.... matchPattern – regular expression.USER MANUAL Search Input Validation When users enter special symbols in the Search Box. follow these steps: 1.. matchAlert– contains the content of the prompt message which appears when there is no value for replacementString.config file. follow these steps: 1. <add matchPattern="[regex]" replacementString="[regex]" enabled="true" matchAlert="[Text of alert message. users will see a prompt message with the text specified in matchAlert. The same logic can be applied when modifying the existing rules. b. To add a new replace or escape rule. you might want certain fields to be unsearchable including the thumbnail field."/> . contains the values which should replace the ones in matchPattern. enabled – indicates whether the rule is enabled or not. Find the <searchInputValidation> section in the web.. Find the <metaFields> section in the web. There are special symbols replace and escape rules set by default.. where: a. 2. Add a new line: . 2. replacementString – regular expression. Searching in Metafields When a user is searching for a news story. c. To define which fields are searchable. Sitefinity replaces them with symbols recognized by the Search or prompts the users with a warning message.

2. On the Custom Errors tab.NET. select HTTP error 404.aspx extension on HTTP 404. the workflow will be available for medium trust as well. So.aspx in your project: 199 . 1. Telerik. Click All Programs > Administrative Tools > Internet Information Services (IIS) Manager. Make sure that the health monitoring (error event logging) is disabled: <healthMonitoring enabled="false" heartbeatInterval="0"> In our next major version. type the path to sf404. Click Edit Properties. This means IIS receives the request but it serves the page configured for HTTP 404. 3. 4. you can serve extensionless URLs. Extensionless URLs This topic describes an approach that handles HTTP 404 errors which you get if you request an extensionless URL like http://localhost/YourWebSite/home where home is set as a Page Group in Sitefinity.DataAccess. choose URL.USER MANUAL Configuring Medium Trust There are a couple of things you need to do to so Sitefinity CMS could work in medium trust. 7. 8.NET ISAPI. It does not send the request to ASP.Configuration.aspx page and rewrite the path to the required URL. From the Message Type list. you get HTTP 404.config file: <cms defaultProvider="Sitefinity" pageExtension="" disabled="true" pageEditorUIMode="Overlay"> When you request an extensionless URL. In order to forward HTTP to ASP. The first thing you need to do is to set pageExtension property to empty in the web. if you can forward all HTTP 404 to ASP. Make sure that the workflow is disabled: <add connectionStringName="DefaultConnection" allowPageHistory="true" allowPageWorkflow="false" 3. you need to configure IIS to redirect to some . Make sure that all sections under <sectionGroup name="telerik"> have requirePermissions=”false”: <section name="dataAccess" type="Telerik. Expand the Default Web Site folder. 5. Follow the steps below to make Sitefinity handle the request to sf404.x 1. IIS 5. 6.SectionHandler. In the URL field. Right-click your project virtual folder and select Properties.NET ISAPI.DataAccess" requirePermission="false"/> 2. Expand the tree on the left until you see Web Sites > Default Web Site.

IIS 6.aspx in your project: 9.x 1. Right-click your project virtual folder and select Properties.USER MANUAL 9. Expand the tree on the left until you see Web Sites > Default Web Site. In the URL field. On the Custom Errors tab. 5. Expand the Default Web Site folder. 3. Click All Programs > Administrative Tools > Internet Information Services (IIS) Manager. Click Edit. From the Message Type list. 7. choose URL. type the path to sf404. 8. 6. 2. Click OK. select HTTP error 404. 200 . 4. Click OK.

Change the Path Type to Execute URL and type the path to sf404. In the right pane. 3.0 Classic Pipeline mode Note: The settings below should be applied when running the server in Classic Pipeline Mode and are not required in Integrate Pipeline Mode. 1.aspx in your project: 6. 5. click Edit. Click Edit Feature Settings.USER MANUAL IIS 7. Expand the Default Web Site folder. 2. 7. 4. Change the default error response to Custom error pages: 201 . Select your Web site and in the right pane. select Error Pages. Click All Programs > Control Panel > Administrative Tools >Internet Information Services (IIS) Manager. IIS section. Expand the tree on the left until you see Web Sites > Default Web Site.

202 . Click OK.USER MANUAL 8.

Right-click your project virtual folder and select Properties.js. 8.html. Expand the tree on the left until you see Web Sites > Default Web Site. 203 . 5. In the Extension field. 10.USER MANUAL IIS 7. follow these steps: IIS 5. click Configuration to open the Application Configuration dialog. . we would recommend the approach described in the Extensionless URLs topic. Wildcard Application Mappings Sitefinity supports URLs without extensions if you set wildcard application mappings in IIS. On the Virtual Directory tab. Select the All verbs checkbox. except setting the pageExtensions to empty string. type “ .x Click All Programs > Administrative Tools > Internet Information Services (IIS) Manager. Clear the Check that file exists checkbox. 3.50727\aspnet_isapi. 2. 1. are required.0.net\framework\v2. 9. etc.* ” to specify all kinds of extensions. As wildcard mapping makes each and every request go through ASP. . Expand the Default Web Site folder. . 7. To set up Wildcard Application Mappings.gif. Sitefinity supports a better approach for URLs with no extensions. Browse to select the c:\windows\microsoft.NET 2. 6.0 ISAPI handler (including URLs with . Click Add to open the Add/Edit Application Extension Mapping dialog.dll file for the value of the Executable field. Apart from setting wildcard application mappings. 4.) and this inevitably worsens the performance.0 Integrated Pipeline mode No additional changes.css.

10. Click OK to close the Add/Edit Application Extension Mapping dialog. Click Insert… to open the Add/Edit Application Extension Mapping dialog. 5. IIS 6. Expand the tree on the left until you see Web Sites.dll file for the value of the Executable field. Browse to select the c:\windows\microsoft.x 1. 8. Click All Programs > Administrative Tools > Internet Information Services (IIS) Manager. Click OK to close the Add/Edit Application Extension Mapping dialog.USER MANUAL 11. 7. Click OK to close the Application Configuration dialog. 2. 6.50727\aspnet_isapi. Click Configuration. 4. 204 . 9. 12.0. Clear the Verify that file exists checkbox. 3. Click OK to close the Application Configuration dialog. Expand the Web Sites folder.net\framework\v2. Right-click your Web site to select Properties.

but the idea is the same. If you are using Windows Vista. 2. On the right hand side of the screen. Select your website. Click All Programs > Control Panel > Administrative Tools >Internet Information Services (IIS) Manager. Then. If you are using Windows Server 2008. Expand the sites folder on the left until you see Web Sites > Default Web Site. 2.USER MANUAL IIS 7 Classic Pipeline mode 1. expand the Default Web Site folder 3. expand the folders as shown below: Please note that the W2008SQL32Bit icon shall be named differently on your machine. Click on the website. click Add Wildcard Script Map: 205 . follow these steps: 1. then on Handler Mappings: 3.

USER MANUAL 4.0.dll 5. Give the application mapping as name: 6. On the dialog that appears. 206 . browse to select the c:\windows\microsoft.50727\aspnet_isapi. please view this article. click yes For more information. Click OK 7.net\framework\v2. On the next dialog.

Open the web. Sitefinity will accept *.com/homepage. the requests to pages having extension other than aspx will not reach Asp. you can change the related properties in the web. When you are done with the ISAPI mappings. 207 .do and *.do" disabled="true" pageEditorUIMode="Overlay"> Example URLs after this change: http://mysite. *.*.asp request. asp" disabled="true" pageEditorUIMode="Overlay"> In this case. Find the <cms> node and add the following property: <cms defaultProvider="Sitefinity" pageExtension=". do.html. Otherwise.x. Change it to the extension you want to use: <cms defaultProvider="Sitefinity" pageExtension=".config file and find the pageExtension property.USER MANUAL Configuring page extensions When you run your web site under IIS5.com/news.NET ISAPI.config file. as well as the default ones .x in classic pipeline mode.do Using additional extensions for your Sitefinity pages By using the additional extensions mapping.aspx" additionalExtensions="html.aspx request. 2. 6. Changing the default page extension Changing the default page extension will force Sitefinity to create or use the CMS pages with a custom extension. you should map the extensions you would like to use to ASP. you use pages with extensions different than the default one.x and 7.do http://mysite.Net and Sitefinity. 1.

all CMS functionality will continue to operate as the process is a mere physical relocation of the application. Copy or upload with FTP the project folder to the destination machine (usually in the \Inetpub\wwwroot folder). You do not need to install Sitefinity on the production server. You only need to configure the IIS properly and add all external files that you have added to the staged server such as images. disable the administration on the production server by deleting this folder: C:\Program Files\telerik\Sitefinity3. If you do not want users to be able to modify anything in the administration. Source (development machine) Destination (production server) 208 . After the migration.x\WebSites\YourProject\Sitefinity\Admin 1. Deployment Deploying Sitefinity to a production server This topic provides instructions on how to migrate an existing Sitefinity project from a development machine to a production server.USER MANUAL 16. CSS or user controls and any other resources you have created.

. Go back to the Security tab. 4.. In the ASP.. to add a user. 2. (If you are using IIS6. If your Web site project uses Microsoft SQL Server database. Set the new folder as an ASP. 5.NET 2.. select the ASPNET user and give full permissions. 5. click Advanced. Select the Security tab. In the new dialog. Click Add. this user is the "Network Service” account) 209 . 7. select 2.NET version field. Give full permissions to the ASPNET user for the ~/App_Data folder: 1.0. 3.50727. Right-click the folder and select Properties... 4. In the new dialog.. click Find now.USER MANUAL 2. 3.0 web application.. 6. Select the ASPNET user from the list of available users. you need to migrate the SQL database to the new location as well.

3. following these steps: Right-click the newly created virtual folder My Site and select Properties. 9. . Access the relocated project by IP address or domain name (depends on your IIS configuration). . Only) Add mappings for .sflb. . 7. Click Configuration >Mappings >Add. 210 .2.tmb. (Required in Sitefinity v.USER MANUAL 6.template.rss to the script maps.xml in ~/[YourProject]/Sitefinity folder. Place the LicenseFile. 8. Restart IIS.

MemoryCachingProvider. you need to change the cache dependency mode from InMemory to InDatabase: <configuration> .Caching. Telerik..Framework" duration="120" slidingExpiration="true" /> </providers> <cacheDependency mode="InDatabase" /> </caching> .USER MANUAL Deploying Sitefinity in a Load Balanced Web Farm Environment There is one requirement that needs to be met in order to use Sitefinity in a load balanced environment.Caching.. Furthermore. you should move the assembly located in [YourProject]\Sitefinity\ServiceAssemblies to the bin directory [YourProject]\bin. </telerik> /<configuration> When you set the mode to InDatabase.AspNetCachingProvider.Framework" /> <add name="ASPNET" type="Telerik. the changes you make on one of the sites will be reflected on the other sites... Synchronizing images and other files between servers in the Web farm is the responsibility of your load balancing software. if you experience any problems with the Dynamic Service Assemblies.. Telerik. In the application web. <framework> <caching defaultProvider="memoryCache"> <providers> <add name="memoryCache" type="Telerik. <telerik> . 211 .config file..

Click the create a post button d. b. labels and textboxes. these control templates are embedded inside assembles. Using the blogs module as an example. Customizing Built-In Modules Overview Sitefinity’s pluggable modules can be customized in a variety of ways. Control Templates To display content. Modules can also share content with other Sitefinity websites. Sitefinity navigates to different templates by routes and these routes are hierarchical. Additional fields can be added. Figure out which template you need: a. Inside of these control templates are many common ASP. Notice that the route section says PostNewView: That is the template that you need. To extract a template. By default.NET UI controls. To make changes to these control templates. go to Modules > Blogs. you must edit its control template. such as literals. To customize a module. here is the hierarchy: 212 . follow these steps: 1.USER MANUAL 17. removed or even renamed. If you’d like to edit the template for creating a blog post. you must extract them from the assemblies and then work with the code inside the controls. Sitefinity uses a series of user controls called control templates. Click on your blog c.

xml 3. then the PostsView. the blogs module must go to the BlogsControlPanel.Blogs.WebControls.Sitefinity.Admin. then the PostNewView. Add the code below to that file: <?xml version="1. Download this file: 213 . 2.ControlsConfig.0" encoding="utf-8"?> <controlsConfig> <viewMap> <!--Provides user interface for creating new blog post in the blogs module. This is represented by dots as you see in the route query string above.--> <viewSettings hostType="Telerik.Configuration. Login to your Client.USER MANUAL To navigate to the PostNewView.PostNewView" layoutTemplatePath="~/Sitefinity/Admin/ControlTemplates/Blogs/PostNe w. Press Ctrl + f5 to build the Visual Studio Project 5.ascx" /> </viewMap> </controlsConfig> 4.net account and click on downloads 6. Create the following file in the ~/App_Data/Configuration directory : Telerik.

\Sitefinity\Admin\ControlTemplates\Blogs\App_LocalResources 8. and Blogs modules. when the user clicks on the module Sortable: Defines whether the field is sortable in the admin. Guid and DateTime.ascx. For more info. so that they can take effect. Unzip that download and copy these files \Sitefinity\Admin\ControlTemplates\Blogs\PostNewView.\Sitefinity\Admin\ControlTemplates\Blogs PostNewView.USER MANUAL 7. It could be set to shortText.ascx \Sitefinity\Admin\ControlTemplates\Blogs\App_LocalResources\PostNewView. Images and Documents. longText.ascx. Here is an example of how to use these fields: <add key="Generic_Content.resx .AuthorEMail" valueType="ShortText" visible="True" searchable="True" sortable="True" defaultValue="" /> Here is a listing of each property’s function: • • Key: This is the name of your module and it’s followed by a period and the name of the field. ValueType: Defines the data type for the field.ascx and make changes 9. News. you need to reflect the changes in the respective templates located in the ~/Sitefinity/Admin/ControlTemplates folder. and sortable.ascx . Events. 214 . These changes can include adding custom fields. Build the project and resolve any errors The project must be compiled (Ctrl + F5 in Visual Studio) before any changes will take effect. integer. Adding Custom Fields Overview You can add custom fields to the Generic Content. searchable. which is a string less than 256 characters. Visible: Defines whether the field is visible to the user Searchable: Defines whether the field is searchable in the admin. if the field has no value • • • • When you add or remove metadata. when the user clicks on the module DefaultValue: Automatically populates the field with a string. Open the ~/Sitefinity/Admin/ControlTemplates/Blogs/PostNewView. You can also set field properties such as visible.resx Into this directory in your Sitefinity project: PostNewView. which is a string longer than 256 characters. please read the Control Templates section of this guide.

--> <viewSettings hostType="Telerik.NewsItemEdit" layoutTemplatePath="~/Sitefinity/Admin/ControlTemplates/News/NewsIte mEdit. Open the project web. Blogs.USER MANUAL When adding a custom field.Admin.ascx \Sitefinity\Admin\ControlTemplates\News\App_LocalResources\NewsItemEdit.0" encoding="utf-8"?> <controlsConfig> <viewMap> <!--Provides user interface for editing a news item in the News module.ascx. please refer to the Control Templates and the Overview of Adding Custom Fields section of this manual. which is outlined in Adding Custom Fields to the Images & Documents Module.ascx . and Events modules. To that XML file.resx Into this directory in your Sitefinity project: NewsItemEdit. For example: <asp:Label ID="Label4" AssociatedControlID="Subtitle" runat="server">Subtitle<em id="Em1" runat="server"></em></asp:Label> <asp:TextBox ID="Subtitle" TextMode="MultiLine" Text="Summary" runat="server"></asp:TextBox> The Images and Documents module uses a slightly different approach for adding these fields. Adding Custom Fields to Generic Content Based Modules The following example uses the News module and describes the steps to create a field called “Subtitle”.\Sitefinity\Admin\ControlTemplates\News\App_LocalResources 3. You can safely use the same logic to add custom fields to Generic Content.WebControls. To be better acquainted with the field adding process. add this code: <?xml version="1.News. add this code: <add key="News. The ID of the textbox (in this case) must be the same as the name of the field. Unzip the templates download and copy these files \Sitefinity\Admin\ControlTemplates\News\NewsItemEdit. 1.ascx" /> </viewMap> </controlsConfig> 2.\Sitefinity\Admin\ControlTemplates\News NewsItemEdit.ascx.resx . ensure that the value of the AssociatedControlID attribute is the ID of the textbox the label is associated with.config file and in the <metaFields> collection.Subtitle" valueType="ShortText" visible="True" searchable="True" sortable="True" defaultValue=""/> 215 .

Find this code: <li> <asp:Label ID="Label3" AssociatedControlID="Author" Text="" runat="server"> <asp:Literal ID="Literal21" runat="server" Text="<%$Resources:Author %>"></asp:Literal> <em id="AuthorLabel" runat="server"></em></asp:Label> <asp:TextBox ID="Author" Text="<%$Resources:Author %>" runat="server" MaxLength="250"></asp:TextBox> <p class="example"> <asp:Literal ID="Literal22" runat="server" Text="<%$Resources:AuthorNote %>"></asp:Literal></p> </li> 6. In your Sitefinity project. open this file : /Sitefinity/ControlTemplates/News/NewsItemEdit. follow these steps: 4. and add this code: <li> <asp:Label ID="Label8" AssociatedControlID="Subtitle" Text="Subtitle" runat="server"></asp:Label> <asp:TextBox ID="Subtitle" Text="" runat="server"></asp:TextBox> </li> 216 . This is what it looks like: To insert the Subtitle field between the Summary and Author fields.ascx 5.USER MANUAL Now you need to take care of the screen where you edit news. Above <li> in step 5.

News.--> <viewSettings hostType="Telerik.ascx.USER MANUAL Here is the end result: The changes above will only appear when editing the news because edit news and create news templates are in two different files. add these lines of code to Telerik. copy ~/Sitefinity/Admin/ControlTemplates/News/NewsItemNew.Sitefinity.Admin. From the templates download.ascx and ~/Sitefinity/Admin/ControlTemplates/News/App_LocalResources/NewsItemNew.xml <!--Provides user interface for adding new news items in the News module.WebControls.a scx" /> 2.Configuration. Find this code: <li> <asp:Label ID="Label3" AssociatedControlID="Author" Text="" runat="server"> <asp:Literal ID="Literal21" runat="server" Text="<%$Resources:Author %>"></asp:Literal> <em id="AuthorLabel" runat="server"></em></asp:Label> 217 .NewsItemNew" layoutTemplatePath="~/Sitefinity/Admin/ControlTemplates/News/NewsItemNew. follow these steps: 1.ControlsConfig. Beneath the <viewMap> tags. resx into the corresponding Sitefinity directories 3. To update the template that creates the news.

From the external templates download. follow these steps: 1. please refer to the Control Templates section.News.USER MANUAL <asp:TextBox ID="Author" Text="<%$Resources:Author %>" runat="server" MaxLength="250"></asp:TextBox> <p class="example"> <asp:Literal ID="Literal22" runat="server" Text="<%$Resources:AuthorNote %>"></asp:Literal></p> </li> 4.ascx \Sitefinity\Admin\ControlTemplates\News\App_LocalResources\NewsItemList.0" encoding="utf-8"?> <controlsConfig> <viewMap> <!--Provides user interface for previewing a news item in the News module.resx Into this directory in your Sitefinity project: 218 .NewsItemsList" layoutTemplatePath="~/Sitefinity/Admin/ControlTemplates/News/NewsItemsList .--> <viewSettings hostType="Telerik.ascx" /> </viewMap> </controlsConfig> 3. copy these files \Sitefinity\Admin\ControlTemplates\News\NewsItemList. News. To add the Category column in the All Items list for the News module for example. Blogs and Generic Content modules and be able to filter items by category. To the XML file.Admin. and add this code: <li> <asp:Label ID="Label8" AssociatedControlID="Subtitle" Text="Subtitle" runat="server"></asp:Label> <asp:TextBox ID="Subtitle" Text="" runat="server"></asp:TextBox> </li> Adding Category Column You may need to display the categories for items created in the Events. To be better acquainted with the field adding process. Above <li> in step 3.WebControls. add this code: <?xml version="1.ascx.

The order of the fields is unimportant. Open this file: ~/Sitefinity/Admin/ControlTemplates/News/NewsItemList.\Sitefinity\Admin\ControlTemplates\News NewsItemPreview.Category#} </telerik:ClientTemplate> 8. In the <Columns> section of the tag beginning with <telerik:RadGrid ID="ItemsGrid". Sitefinity looks for all controls that have id of a meta key. since this method requests information for all the news items from a web service. they might not take effect immediately. such as the News module’s summary field. 'Category']..\Sitefinity\Admin\ControlTemplates\News\App_LocalResources 6. or a server restart. 'Author'. Find the section. It should look something like this: var requiredMetaFields = ['Title'.config. Using RadEditor as a Custom Field Sitefinity has a procedure how to automatically save and set meta fields.resx . 'Expiration_Date'. to templates). and change the requiredMetaFields variable to include ‘Category’. beginning with <telerik:ClientTemplatesHolder ID="GridTemplates" runat="server">. NOTE: when you make such changes (e. will force the new changes to be taken into account. insert the following snippet: <telerik:ClientTemplate Name="Category" runat="server"> {#MetaFields. a. and that can be cast to ITextControl interface.g. or application pool restart. A change in the web. right after the element with UniqueName=”View”. 7.ascx. insert the following snippet: <telerik:GridTemplateColumn UniqueName="Category" SortExpression="Category" HeaderText="Category"> </telerik:GridTemplateColumn> This will add the column header.USER MANUAL NewsItemPreview.ascx. so Sitefinity always knows that the value of meta field will be stored in control’s Text property. and between the elements named with “View” and “Source”. 'Source'.ascx . b. 219 . The importance of the ITextControl interface is that it mandates the control to have a Text property. without actually worrying what kind of a control it is. 'Publication_Date'. Find the function called DataBindGrid. This will add the category for each news item.

NewsItemEdit" layoutTemplatePath="~/Sitefinity/Admin/ControlTemplates/News/NewsIte mEdit. in edit mode. will be replaced with a RadEditor: To be better acquainted with the field adding process. follow these steps: 1.WebControls. To that XML file. please refer to the Control Templates section.USER MANUAL If you’d like to bind another property to the Text attribute. In this example. the News module’s summary textbox.--> <viewSettings hostType="Telerik.News.--> </viewMap> </controlsConfig> 2. Comment out these lines: <%--<li> <asp:Label ID="Label4" AssociatedControlID="Summary" Text="<%$Resources:Summary %>" runat="server"> <asp:Literal ID="Literal19" runat="server" Text="<%$Resources:Summary %>"></asp:Literal> <em id="SummaryLabel" runat="server"></em></asp:Label> <asp:TextBox ID="Summary" TextMode="MultiLine" Text="" runat="server"></asp:TextBox> <p class="example"> 220 .Admin. To use the RadEditor as opposed to a regular textbox as a meta field.ascx" /> <!--Provides user interface for creating new blog post in the blogs module. implement the ITextControl interface and assign its text property accordingly. add this code: <?xml version="1.0" encoding="utf-8"?> <controlsConfig> <viewMap> <!--Provides user interface for editing a news item in the News module. you’d need to make a user control with that UI component.

USER MANUAL

<asp:Literal ID="Literal20" runat="server" Text="<%$Resources:SummaryNote %>"></asp:Literal></p> </li>--%> 3. Create a new user control called RadEditorNewsSummary.ascx and place it in the ~/Sitefinity/Admin/ControlTemplates/News directory 4. To that control, add this code: ASPX: <telerik:RadEditor ID="RadEditor1" runat="server"></telerik:RadEditor> C#:
using using using using using using System; System.Collections.Generic; System.Linq; System.Web; System.Web.UI; System.Web.UI.WebControls;

public partial class Sitefinity_ControlTemplates_News_RadEditorNewsSummary : System.Web.UI.UserControl, ITextControl { protected void Page_Load(object sender, EventArgs e) { } #region ITextControl Members public string Text { get { return RadEditor1.Content; } set { RadEditor1.Content = value; } } #endregion }

5. Above the commented summary code in the NewsItemEdit.ascx file, add this code: <li> <uc1:RadEditorNewsSummary ID="RadEditorNewsSummary1" Text="Summary" runat="server" />

221

USER MANUAL

</li> 6. Below the page directive, add this code: <%@ Register src="RadEditorNewsSummary.ascx" tagname="RadEditorNewsSummary" tagprefix="uc1" %> You’ll notice that the text property is the same name as the field. This will ensure that data will be read, inserted and updated. 7. Build the project and resolve any errors

Using a Drop Down List or a Checkbox as a Custom Field
Although the DropDownList and the Checkbox each have a text property, you might want to bind the selected value property to the text property, so that value goes into the database. In this example, we shall replace the News module’s summary textbox with a RadComboBox. This process is almost identical to the steps for Using RadEditor as a Custom Field. 1. Follow steps 1 -2 of Using RadEditor as a Custom Field 2. For step 3, create a user control called RadComboBoxSummary.ascx in the ~/Sitefinity/Admin/ControlTemplates/News folder 3. To that control, add this code: ASPX: <telerik:RadComboBox ID="SummaryDropDown" runat="server" Skin="Vista "> <Items> <telerik:RadComboBoxItem Text="This is a summary" Value=" This is a summary" /> <telerik:RadComboBoxItem Text="This is another summary" Value=" This is another summary " /> <telerik:RadComboBoxItem Text="This is a third summary" Value=" This is a third summary " /> </Items> </telerik:RadComboBox> Note that the value and the text property the same. The user will see the text property, but the value property, as highlighted above, is what goes into the database. C# - Bind the Text property to the selected value property of the RadComboBox public string Text { get {

222

USER MANUAL

return SummaryDropDown.SelectedValue; } set { SummaryDropDown.SelectedValue = value; } } 4. Above the commented summary code in the NewsItemEdit.ascx file, add this code: <li> <uc1: RadComboBoxSummary ID="RadComboBoxSummary1 " Text="Summary" runat="server" /> </li> 5. Below the page directive, add this code: <%@ Register src=" RadComboBoxSummary.ascx " tagname=" RadComboBoxSummary" tagprefix="uc1" %> You’ll notice that the text property is the same name as the field. This will ensure that data will be read, inserted and updated. 6. Build the project and resolve any errors

Keep in mind that if you have another user control on the page with a tag prefix of uc1, you will need to change its tag prefix. If you wanted to use a checkbox, as opposed to the RadComboBox, you’d just replace the code in the .ascx file with a checkbox, since both controls have a selected value property.

Adding Thumbnails from Image and Documents Module to the News Module
These instructions will show you how to add a thumbnail selector, from the Images and Documents module, when you’re editing the News module in the admin. Here is the end result:

To be better acquainted with the field adding process, please refer to the Control Templates section. Here are the steps to add the field: 1. Between the <metaFields> tags of your Web.config, ensure that this code has been added:

223

USER MANUAL

<add key="News.Thumbnail" valueType="ShortText" visible="True" searchable="True" sortable="True" defaultValue="" />

2. To your XML File, add this code in between the <viewMode> tags:
<viewSettings hostType="Telerik.News.WebControls.Admin.NewsItemEdit" layoutTemplatePath="~/Sitefinity/Admin/ControlTemplates/News/NewsItemEdit.a scx" />

3. Copy these files from the templates download ~/Sitefinity/Admin/ControlTemplates/Generic_Content/NewsItemEdit.ascx ~/Sitefinity/Admin/ControlTemplates/Generic_Content/App_LocalResources/NewsItemEdit.ascx.resx Into your corresponding Sitefinity project directories 4. Open this file: ~/Sitefinity/Admin/ControlTemplates/Generic_Content/NewsItemEdit.ascx 5. Add this code:
<li class="selector"> <asp:Label ID="Label5" AssociatedControlID="Thumbnail" runat="server"> <asp:Literal ID="Literal18" runat="server" Text="Thumbnail"></asp:Literal> <em id="ThumbnailLabel" runat="server"></em></asp:Label> <asp:TextBox ID="Thumbnail" Text="" runat="server" MaxLength="250"></asp:TextBox> <sfLib:ButtonSelector runat="server" AssociatedControls="Thumbnail" /> <p class="example"> <asp:Literal ID="Literal21" runat="server" Text="Thumbnail Note"></asp:Literal></p></li>

6. Add this code below the page directive:
<%@ Register TagPrefix="sfLib" Namespace="Telerik.Libraries.WebControls" Assembly="Telerik.Libraries" %>

7. Open the ~/Sitefinity/Admin/ControlTemplates/Libraries/Dialogs/ButtonSelector.ascx. 8. In the SelectedItem JS function, add the following check:
function SelectedItem(src, altText, title, width, height) { this.src = src; this.altText = altText; this.title = title; this.width = width; this.height = height; if (typeof(beforeInsertLink) != 'undefined')

224

set the applicationName attribute for each news provider to the same value. you need to: set the connectionStringName attribute for each news provider to point to a connection string to the same database. For instance. or if you want to implement some functionality that is different from the default. height). title. if you have several sites and need to display the same news articles across those sites. for example “Breaking News” provider. width. you need to store these items in a common database.USER MANUAL beforeInsertLink(src. 225 . To achieve this. Follow the steps below to add your own news provider. Here is the end result: Adding Providers Adding a provider can come in very handy if you want your Sitefinity modules to display items from some other data source. altText.

Title" valueType="ShortText" visible="True" searchable="True" sortable="True" defaultValue=""/> <add key="Breaking_News.config file and find the <cmsEngine defaultProvider="Generic_Content"> section.Expiration_Date" valueType="DateTime" visible="True" searchable="True" sortable="True" defaultValue="#Max"/> <add key="Breaking_News.DefaultProvider.Data. Paste the elements below the last element so the new ones are added to the collection.Cms. copy the first element and paste below it.Engine. Change the key of each new element from News..Data" .. Telerik. copy all elements whose keys start with “News”.Cms.USER MANUAL 1. <add key="Breaking_News. 3.Author" valueType="ShortText" visible="True" searchable="True" sortable="True" defaultValue=""/> <add key="Breaking_News. The new provider should look like this: <add name="Breaking_News" defaultMetaField="Title" visible="False" securityProviderName="" allowVersioning="True" applicationName="/BreakingNews" versioningProviderName="" connectionStringName="GenericContentConnection" type="Telerik.Source" valueType="ShortText" visible="True" searchable="True" sortable="True" defaultValue=""/> <add key="Breaking_News.Engine. From the <metaFields> collection in the <cmsEngine> section. 226 . 2. From the providers’ collection.Summary" valueType="LongText" visible="True" searchable="True" sortable="True" defaultValue=""/> <add key="Breaking_News. Paste below it and rename it to Breaking_News for example.. Open the application web. copy the provider element named News. /> 4. Set the applicationName attribute to /BreakingNews..[FieldName] to Breaking_News. 6. Find the <news> section and from the <genericContentProviders> collection..Providers.Category" valueType="ShortText" visible="True" searchable="True" sortable="True" defaultValue="" /> 7.[FieldName]. 5.Thumbnail" valueType="ShortText" visible="True" searchable="False" sortable="False" defaultValue=""/> <add key="Breaking_News.Publication_Date" valueType="DateTime" visible="True" searchable="True" sortable="True" defaultValue="#Now"/> <add key="Breaking_News.

In ~/Sitefinity/ControlTemplates directory.USER MANUAL 8. Run the application. copy the News folder and rename it to Breaking_News. 11.6. Rename the provider to Breaking_News: <add providerName="Breaking_News" publicationDateField="Publication_Date" expirationDateField="Expiration_Date" thumbnailUrlField="Thumbnail" urlRewriteFormat="[Publication_Date]/[Title]. we recommend copying the folders in case you need to adjust templates. since templates are now embedded in Sitefinity 3. Select the provider you want to manage news for: 227 . copy the News folder and rename it to Breaking_News. You will see a drop down list in the upper left corner when you go to Modules > News 12. Although steps 9 and 10 are optional. In ~/Sitefinity/Admin/ControlTemplates. 10.aspx" urlDateTimeFormat="yy-MM-dd" urlWhitespaceChar="_" /> 9.

initial catalog=36Demo" providerName="System.DataProviders.Data" connectionStringName="Sitefinity"/> </connections> </dataAccess> Here.Cms.Engine. Telerik.SqlClient"/> 228 .SqlServer2005Provider" connectionStringName="Sitefinity"/> <add name="GenericContentConnection" driver="Telerik. you need to specify the provider name for the control.Engine.Cms.GCSql2005Provider. The ProviderName attribute is located in the Advanced > Data section of the NewsView. Please note that the connection string name is coming from the data access section of the Web. If no provider is specified.Data.Integrated Security=SSPI. since you have a duplicate of the news module in this example. the connection string name is coming from the connection string section: <add name="Sitefinity" connectionString="data source=.ORMapper. When you put a NewsView control on a page. the default one is used.USER MANUAL You can also set different user permissions for the new provider..config: <dataAccess defaultConnection="DefaultConnection"> <connections> <add name="DefaultConnection" driver="Nolics.Data.Providers.

Integrated Security=SSPI. Add the line in red: <add name="Breaking_News" defaultMetaField="Title" visible="False" securityProviderName="" allowVersioning="True" applicationName="Site1/BreakingNews" . So. Set the connectionStringName attribute in step 3 to GenericContentConnection2 If you do not want two web sites to share the same content. Add a second connection string: <add name="Sitefinity2" connectionString="data source=.. Blogs. follow these steps: 1.Providers.Engine..Data" connectionStringName="Sitefinity2"/> 3.Cms.initial catalog=36Test" providerName="System. you must use the highlighted Generic Content Connection’s driver.Data.Engine. follow these steps: 1. if you’d like to share content from two sites using two separate databases. Find the section <cmsEngine defaultProvider="Generic_Content"> 2.. 229 .Data.Cms.GCSql2005Provider.SqlClient"/> 2.USER MANUAL Since the News. Add a connection to the data acccess section <add name="GenericContentConnection2" driver="Telerik. Images and Documents and Events Module inherit features from the Generic Content module. you need to change the applicationName attribute for each provider. Telerik. To do so.

xml This file contains all of the buttons available for the Generic Content module. Paste that line of code into this file: ~/Sitefinity/Admin/EditorToolsFile. follow these steps: 1. Any changes made here will affect the admin’s version Generic Content module.Engine. which include the ones in the News and Blogs modules. so all properties for that tool apply for the Generic Content module. To populate the drop down. or when users are creating or editing pages. Copy the tag for the horizontal rule: <tool name="InsertHorizontalRule" /> 3.Cms. your code could look possibly like this: <tools dockable="false"> <tool name="Bold" shortcut="CTRL+B"/> <tool name="Italic" shortcut="CTRL+I"/> <tool name="JustifyLeft" /> <tool name="JustifyCenter" /> <tool name="JustifyRight" /> <tool name="JustifyFull" /> <tool name="InsertOrderedList" /> <tool name="InsertUnorderedList" /> <tool name="InsertHorizontalRule" /> For more info on adding and removing buttons. please review this article. such as when users edit news or create events.Design. add this code: <viewSettings hostType="Telerik. Populating the CSS Dropdown The Generic Content Module allows you to populate a drop down list with CSS options by editing its corresponding template. Adding and Removing Buttons Sitefinity’s Generic Content module is the RadEditor tool for a special wrapper.GenericContentDesign er" 230 . The steps below will outline adding a button for inserting a horizontal rule button: 1.xml This file controls which buttons are visible in all instances of the RadEditor.WebControls.USER MANUAL Customizing the Generic Content Module The Generic Content Module’s buttons can be added and removed plus the CSS Drop Down can be populated. Open this file: ~/Sitefinity/Admin/EditorToolsFileAll. 2. To get more familiar with the process. Although buttons can be added in many ways. please read the Control Templates section of this guide. one suggestion is to use an XML file. After pasting that line. Between the <viewMap> tags of your XML file.

ascx" /> 2. 231 . In the ~/Sitefinity/Admin folder. copy the ~/Sitefinity/Admin/ControlTemplates/Generic_Content/GenericContentDesigner. create a file called CSSFile1.xml" Skin="WebBlue" NewLineBr="False" Height="360px" Width="98%"> <ImageManager ViewPaths="~/Images" UploadPaths="~/Images" DeletePaths="~/Images" /> <MediaManager ViewPaths="~/Files" UploadPaths="~/Files" DeletePaths="~/Files" /> <FlashManager ViewPaths="~/Files" UploadPaths="~/Files" DeletePaths="~/Files" /> <DocumentManager ViewPaths="~/Files" UploadPaths="~/Files" DeletePaths="~/Files" /> <CssFiles> <telerik:EditorCssFile Value="~/Sitefinity/Admin/Themes/Default/AjaxControlsSkins/Sitefinit y/EditorCssFile. In the templates download.ascx file into the ~/Sitefinity/Admin/ControlTemplates/Generic_Content directory of your application 3. Inside that file.css"/> <telerik:EditorCssFile Value="~/Sitefinity/Admin/CSSFile1.redtext" /> </CssClasses> </telerik:RadEditor> 4.link" /> <telerik:EditorCssClass Name="img" Value=".Css" /> </CssFiles> <CssClasses> <telerik:EditorCssClass Name="Clear Class" Value="" /> <telerik:EditorCssClass Name="link" Value="a.USER MANUAL layoutTemplatePath="~/Sitefinity/Admin/ControlTemplates/Generic_Cont ent/GenericContentDesigner.link { color: #0000ff.css 5.css" ToolsFile="~/Sitefinity/Admin/ControlTemplates/EditorToolsFile. Add a CSSClasses element and the location of your external CSS file: <telerik:RadEditor runat="server" ID="textEditor" ContentAreaCssFile="~/Sitefinity/Admin/Themes/Default/AjaxControlsSk ins/Sitefinity/EditorContentArea. add this code: a.img" /> <telerik:EditorCssClass Name="redtext" Value=".

232 . } . Restart the application This dropdown can also be populated using inline styles. font-style: italic.link is the value of <telerik:EditorCssClass above. For more information.redtext { color: red. 6. please read this article.USER MANUAL font-weight: normal. } .img { border: none. } Notice how the class class a.

UI. For step 3. editor.USER MANUAL Disabling the Sitefinity Link Manager and Using the RadEditor Link Manager Sitefinity uses a custom link manager: Instead of the default one from the RadEditor as shown below: To use this link manager directly above.Web.ascx 3. Follow steps 1 and 2 of Populating the CSS Dropdown 2. Comment this code: //Telerik. args) { 233 .CommandList["LinkManager"] = function(commandName.Editor. follow these steps: 1. open this file: ~\Sitefinity\Admin\ControlTemplates\Generic_Content\GenericContentDesigner.

Web.nodeName == "A") // args.showExternalDialog( // path. // editorArgs.cloneNode(true). // editorArgs. Save your changes 234 . 4.WindowBehaviors.getSelectedElement(). args) { // if (typeof (editorArgs. // div.Move.Html = sel. // Telerik.appendChild(cloned). // false. // } // var myCallbackFunction = function(sender. // true) // }. // 515.WindowBehaviors. // editor.nodeName) != "undefined" && editorArgs. // editorArgs. args).UI. // } // } // var path = sf_AppRoot + 'Sitefinity/UserControls/Dialogs/LinksDialog.ownerDocument.innerHTML).Web. // myCallbackFunction.pasteHtml(div.aspx'. // false.getText(). // var div = args.nodeName) == "undefined" || editorArgs.Text = sel.getHtml().USER MANUAL // var editorArgs = editor.createElement("DIV"). // editorArgs = sel. // if (!editorArgs.getSelection(). // 750.nodeName != "A") { // var sel = editor.UI.replaceChild(editorArgs. // else { // var cloned = args. // 'ImageLibraryDialog'.Close + Telerik. // editorArgs.parentNode. // null.nodeName || typeof (editorArgs.

to see the Link Manager change Customizing the Images and Documents Module The Images and Documents module allows custom meta fields.tmb" urlDateTimeFormat="yy-MM-dd" urlWhitespaceChar="_" visible="False" defaultMetaField="Name" applicationName="/Libraries" allowVersioning="True" allowLocalization="False" localizationProviderName="" allowWorkflow="False" securityProviderName="" versioningProviderName="" connectionStringName="GenericContentConnection" type="Telerik. 1.Libraries. 5.AmazonProvider. Amazon S3 Support The Images and Documents module allows you store media on the Amazon S3. Sign up for the Amazon S3 Service 2.Data. for the exception of your own custom modules. Telerik.USER MANUAL 5.ascx" /> 4. The instructions below will show you how to add media to the Amazon S3 cloud using Sitefinity. Uncomment the highlighted S3 data provider in your web. Obtain your access key and secret access key by going to Your Account > Access Identifiers: 3.s3lb" as well in that cae there will extra libraries in the url--> <add name="Libraries" urlRewriteFormat="~/{LibraryName}/[Name].Data" tagEditorTemplate="~/Sitefinity/Admin/ControlTemplates/Libraries/Bat chTagsEditor.config as shown below: <!--Amazon Data Provider [First turn off the default one] url format can be urlRewriteFormat="~/{Provider}/{LibraryName}/[Name].Libraries.s3lb" thumbnailExtension=". Amazon S3 support and Viddler support. Use the Link Manager of any RadEditor instance. Comment default "Libraries" data provider: 235 . Navigate to the cmsEngine node.

Add your Secret API key from Amazon to the secretAccessKey property: secretAccessKey="YOUR SECRECT KEY" 8. Telerik. Publish it 236 . Add your Access Key from Amazon to the accessKey property: accessKey="YOUR ACCESS KEY" 9. In the Web.sflb.AmazonStorage. Telerik.config.Libraries.USER MANUAL <!--<add name="Libraries" urlRewriteFormat="~/{Provider}/{LibraryName}/[Name].com" accessKey="YOUR ACCESS KEY" secretAccessKey="YOUR SECRECT KEY" bucketName="Sitefinity" /> </providers> </storageSetting> 7.amazonaws.Libraries" downloadUrlPrefix="http://s3.Libraries.ascx" />--> 6.Data. find this code: <storageSetting defaultProvider="Amazon"> <providers> <add name="Amazon" type="Telerik.Data" tagEditorTemplate="~/Sitefinity/Admin/ControlTemplates/Libraries/Bat chTagsEditor.Libraries.AmazonStorageProvider.DefaultProvider. Create your blog with images 10.ashx" urlDateTimeFormat="yy-MM-dd" urlWhitespaceChar="_" visible="False" defaultMetaField="Name" applicationName="/Libraries" allowVersioning="False" allowLocalization="False" localizationProviderName="" allowWorkflow="False" securityProviderName="" versioningProviderName="" connectionStringName="GenericContentConnection" type="Telerik.

Create a Viddler account and obtain an API KEY.config file Find this section: <sectionGroup name="telerik"> 237 . you can monitor your site using Firebug and your list will look like this: Down in the bottom there are two requests for images posted by Live Writer which are directly forwarded to S3 server. To test this feature. Viddler Support Viddler allows users to share videos with other users. 4. though using the admin will also work appropriately.USER MANUAL The above picture is a blog post using Live Writer. 3. To enable Viddler support in Sitefinity. Upload some videos to your account Open Sitefintiy’s web. follow these steps: 1. 2.

ViddlerVideo.Libraries. Name.Libraries" requirePermission="false"/> 6. Find <libraryInfo> node and add the Viddler extensions and metaKeys <add name="Viddler" title="Viddler Library" defaultExtenstions=".Libraries" description="Viddler video content control" /> 7. Under the <cmsEngine defaultProvider="Generic_Content"><providers> section. Add new section for our media provider.3gp" metaKeys="Author.mpg. . Telerik.Libraries. Category"></add> 9.Libraries.sflb.USER MANUAL 5.viddler. if it does not exist <section name="mediaProvider" type="Telerik. .Viddler--> <add name="Viddler Videos" section="VIDDLER" type="Telerik. add the Viddler provider <add name="Viddler" urlRewriteFormat="~/{LibraryName}/[Name]. Extension. Description.MediaProvider. .ViddlerProvider.wma. Under toolboxControls section register a new control that will display our videos.MediaProvider.tmb" urlDateTimeFormat="yy-MM-dd" urlWhitespaceChar="_" visible="False" defaultMetaField="Name" applicationName="/Libraries" allowVersioning="True" allowLocalization="False" localizationProviderName="" allowWorkflow="False" securityProviderName="" versioningProviderName="" connectionStringName="GenericContentConnection" type="Telerik.mov.avi.Data" tagEditorTemplate="~/Sitefinity/Admin/ControlTemplates/Libraries/Bat chTagsEditor.WebControls. . .wmv. <toolboxControls> <!-.Data.ViddlerProvider" apiKey="YOUR KEY HERE" baseUrl="http://api.Libraries.MediaProviderSec tion.ashx" thumbnailExtension=".Libraries.ascx"/> 8. Find this section: <mediaProvider defaultProvider="viddler"> <providers> <add name="viddler" type="Telerik. Telerik.com/rest/v1/" /> </providers> </mediaProvider> </telerik> 238 . Telerik. Size.Configuration.

Insert your API Key from Viddler into the apiKey property of the provider 11. Go to the pages tab. Under Viddler Credentials. enter your username and password for Viddler 14. click edit on a page. Go to Synchronizer and choose which videos you want to synchronize with your library. Create a new library of type Viddler: 13. then drag and drop the Viddler control: 239 .USER MANUAL 10. Login in to your Sitefinity project and go to Modules > Images and Documents 12. 15.

USER MANUAL

Note that VdrNetCred library will be automatically created. It collects date for your account and you should not delete this library until you decide to change your credentials or remove Viddler provider.

Adding Custom Fields to the Images & Documents Module
Change the allowed file extensions To change the allowed file extensions for document libraries: 1. Open the application web.config file and in the <libraryInfo> section, modify the value of the defaultExtension attribute. In this case, we’re allowing files with the .xml extension to be uploaded in the document library <libraryInfo> <add name=" Document " title=" Document Library " defaultExtensions=".doc, .docx, .rtf, .txt, .pdf, .ppt, .pptx, .html, .xls, .xlsx, .xml" metaKeys=" Author, Description, Extension, Name, Size, Category"> </add> … </libraryInfo>

2. Save the file. Note that you cannot add to the default extensions of image and video libraries. The image libraries can only include the default ones: .png, .jpg, .jpeg and .gif. The video library can only include the default one: .wmv

240

USER MANUAL

Create custom library types To create your own custom type of library, follow these steps: 1. Open the application web.config file 2. In the section called <libraryInfo>, add your library, called MyLibrary, as shown below: <libraryInfo> … <add name="Document" title="Document Library" defaultExtenstions=".doc, .docx, .rtf, .txt, .pdf, .ppt, .pptx, .html, .xls, .xlsx" metaKeys="Author, Description, Extension, Name, Size, Category"></add> <add name="MyLibrary" title="MyLibrary" defaultExtenstions=".*" metaKeys="Author, Description, Extension, Name, Size, Category"></add> </libraryInfo> Note that if you set the value of defaultExtensions to ".*", you will allow all file extensions.

My Library is displayed at the create library screen like this:

241

USER MANUAL

Adding custom Meta fields This topic describes what you should do if you want to add a field called Caption to an image library and display it at the edit image screen like this:

To better acquaint yourself with adding custom fields, please read the Overview of Adding Custom Fields section of this guide. To add the field, follow these steps: 1. Open the project web.config file and in the <metaFields> collection, add this code: <add key="Libraries.Caption" valueType="ShortText" visible="True" searchable="True" sortable="True" defaultValue="" /> 2. In the <libraryInfo> section, add Caption to metaKeys: <libraryInfo> … <add name="Image" title="Image Library" defaultExtenstions=".png, .jpg, .jpeg, .gif" metaKeys="Author, Caption, AlternateText, Extension, Name, Height, Width, Size, Category" /> </libraryInfo>

242

USER MANUAL

3. Add this code to the XML file: <?xml version="1.0" encoding="utf-8"?> <controlsConfig> <viewMap> <!--Edit library item properties - Images & Documents.--> <viewSettings hostType="Telerik.Libraries.WebControls.Admin.LibraryItemEdit" layoutTemplatePath="~/Sitefinity/Admin/ControlTemplates/Libraries/Libra ryItemEdit.ascx" /> </viewMap> </controlsConfig>

4. Unzip that download and copy these files \Sitefinity\Admin\ControlTemplates\Libraries\LibraryItemEdit.ascx \Sitefinity\Admin\ControlTemplates\Libraries\App_LocalResources\LibraryItemEdit.ascx.resx Into this directory in your Sitefinity project: LibraryItemEdit.ascx - \Sitefinity\Admin\ControlTemplates\Libraries LibraryItemEdit.ascx.resx \Sitefinity\Admin\ControlTemplates\Libraries\App_LocalResources

5. Open the ~/Sitefinity/Admin/ControlTemplates/Libraries/LibraryItemEdit.ascx file and find section: <sfGCn:ContentMetaFields ID="itemMetaFields" runat="server"> 6. Add this code: <li> <asp:Label ID="Label8" runat="server" AssociatedControlID="Caption" Text="Caption"></asp:Label> <asp:TextBox runat="server" ID="Caption" MaxLength="255" TextMode=MultiLine></asp:TextBox> <p class="example"><asp:Literal ID="Literal10" runat="server" Text="Descriptive text that goes beneath the image" /></p> </li>

7. Press Ctrl + F5 to build your project and resolve any errors

243

Add this code to the XML file: <?xml version="1. set the Height attribute.resx Into this directory in your Sitefinity project: PollBox.if using the ~/Sitefinity/ControlTemplates/Polls/ResultsTemplateNoLegend. .ascx . set the BarWidthPercent attribute. you need to edit the templates located in the ~/Sitefinity/ControlTemplates/Polls folder and then in edit page mode.\Sitefinity\ControlTemplates\Polls 244 .PollBox" layoutTemplatePath="~/Sitefinity/ControlTemplates/Polls/PollBox.ascx.Polls. follow these steps: 1. Change the height of the bars like this: .ascx.ascx" /> </viewMap> </controlsConfig> 2. then set the Poll Box control properties as described below. Set the background color for the chart in the corresponding template by adding this Attribute to the chart tag: Background-MainColor="SomeColor".ascx \Sitefinity\Admin\ControlTemplates\Polls\ResultsBoxLegend.USER MANUAL Customizing the Polls Module Overview To customize the appearance of the poll results.Polls.ascx " /> <!--Gets or sets the path to a custom layout template for the ResultsBox control.ascx.WebControls.--> <viewSettings hostType="Telerik.0" encoding="utf-8"?> <controlsConfig> <viewMap> <viewSettings hostType="Telerik.ascx \Sitefinity\Admin\ControlTemplates\Polls\App_LocalResources\PollBox. Customizing the Response Chart To make the answers for each question in a single chart look like below. Unzip that download and copy these files \Sitefinity\Admin\ControlTemplates\Polls\PollBox.if using the ~/Sitefinity/ControlTemplates/Polls/ResultsBoxLegend.WebControls.ResultsBox" layoutTemplatePath="~/Sitefinity/ControlTemplates/Polls/ResultsBoxNo Legend.

resx .\Sitefinity\ControlTemplates\Polls PollBox. 6.ascx. 4. 5. Go to the page where you have inserted the Poll Box control and click Edit. Expand the General section. 7. Expand the Appearance section.ascx . Find the Poll Box control and click Edit to open the Control Properties dialog. Find the ResultsBox property and click Edit.USER MANUAL ResultsBoxLegend. 245 .\Sitefinity\ControlTemplates\Polls\App_LocalResources 3.

Open the ~/Sitefinity/ControlTemplates/Polls/ResultsBoxLegend. Set the TemplatePath property to point to this template: ~/Sitefinity/ControlTemplates/Polls/ResultsBoxLegend. 246 .USER MANUAL 8. Click I’m done.ascx file and modify the chart there. 9. 10.ascx.

5. 2. Go to the page where you have inserted the Poll Box control and click Edit.ascx. Find the ResultsBox property and click Edit. 4. Set the TemplateURL property to point to this template: ~/Sitefinity/ControlTemplates /Polls/ResultsTemplateNoLeg end. 8. Open the ~/Sitefinity/ControlTemplates /Polls/ResultsTemplateNoLeg end. Expand the General section. 7. Click I’m done.USER MANUAL Display each answer in a separate chart like this: 1. 247 . 3.ascx file and modify the chart. Expand the Appearance section. Find the Poll Box control and click Edit to open the Control Properties dialog. 6.

Sign up to vote on this title
UsefulNot useful