Kentico CMS 5.5 R2 Developer's Guide

System requirements

Installation procedure

Setup (KenticoCMS.exe)

Web installer

Built-in web server in Visual Studio

Local IIS server

Remote server

Existing installation

New site wizard

Deployment to the live server

Uninstallation

Additional configuration tasks

Creating a virtual directory

Configuration for Medium Trust environment

Configuring Application Pools

SMTP server configuration

Installation on shared hosting server

Installation in medium-trust environment

AppPool permissions on Windows 7 or Windows Server 2008 R2

Database replication

Modifying structure of a replicated DB

Creating a publication

Creating a subscription

Configuration of full-text search in files

Configuration on MSSQL 2005 and 2008

Configuration on MSSQL 2005 Express Edition

Searching PDF files

Searching Office 2007/2010 documents

Custom URL extensions and extensionless URLs

Configuration of custom URL extensions (.html or other)

IIS 7 and higher

IIS 6

Lock violation on IIS7

Visual Studio integration

Opening the project

Adding Kentico CMS Controls to the Toolbox

Debugging

Pre-compilation (Publish function)

Visual Source Safe and Team Development

Opening a VS2005 project in VS2008

Troubleshooting installation issues

SQL Server connection problems

ASP.NET not working on Windows Server 2003

Internal server error when using Integrated pipeline mode

Disk permissions problems

Solution on Windows 7

Solution on Windows Vista or Server 2008

Solution on Windows XP

Solution on Windows 2003

System backup and recovery

Content management

Organizing pages, files and documents

Editing content

Creating a new page

Creating a new structured document

Previewing documents

Creating a linked document

Drag-and-drop operations with documents

WYSIWYG editor

Inserting image or media from Web

Insert image or media

Inserting audio/video

Quickly insert image

Insert link

Links to content within the CMS

Link properties

Editing inserted items

Copy & Paste from Microsoft Word

Defining custom toolbars

Defining styles

Dialogs configuration

Document properties

File management

File management overview

Document attachments

Example: Unsorted attachments

Example: Grouped attachments

Available inline controls

Handling attachments in transformations

Using the File field

Temporary attachments handling

Attachment names

Handling images

Image editor

Resizing images on upload

Where the files are stored

Files-related settings

Using the Media selection control

Document listing

Content search

Content scheduling

Using the built-in spell-checker

Accessing content using .NET code (API)

Permissions and security

FAQ

Managing sites

Site Management Overview

Managing sites

Starting and stopping sites

Export and import

Exporting single objects

Importing a site or objects

Folder structure and import/export

Excluding files and folders from export

Import/export troubleshooting

Configuration on W2008/IIS7

Deleting sites

Creating web templates

License management

Managing site settings

Configuring multiple web sites

Multiple web sites on a single domain (in subfolders)

Configuring nested web sites

API Examples

Website settings

Settings overview

Development

The role of a web developer

Web development overview

What is a page template

Portal templates versus ASPX templates

Portal engine development model

Portal engine overview

Creating a new page template

Re-using an ad-hoc page template

Page template scopes

Page layouts

The master page concept

Editing the master page

Visual inheritance

Content tree and page templates

Managing page template catalog

Cloning and modifying a page template

Using and configuring web parts

Web part binding (obsolete)

Adding custom code to web parts (obsolete)

Common web part properties

Path and macro expressions in web part properties

Adding custom code to the portal page template

Displaying data from an external database or Web Service

Developing sites for mobile devices

Portal engine development internals and API

Getting page template data

Page templates

Managing page templates and their categories

Assigning and removing page templates from sites

Managing page template scopes

Page layouts

Getting page layout data

Managing page layouts

ASPX page template development model

Creating a new ASPX page template

Creating ASPX master pages

Adding custom code to the ASPX page template

Combining ASPX templates and portal engine templates

Integration with your existing ASP.NET application

Displaying data from an external database

Caching and performance

Troubleshooting performance issues

Caching options

File management and performance

CSS stylesheets and design

Printer friendly CSS styles

App themes

Print page

CSS stylesheet internals and API

Getting CSS stylesheet data

Managing CSS stylesheets

Assigning CSS stylesheets to sites

Debugging

Particular debugs

Bulk keys for all debugs

System error notifications

Document types and transformations

Defining a new document type

Transformations

Writing transformations

Adding custom functions to transformations

Context menus in transformations

E-mail templates

Form controls

Developing form controls

Inline controls

How to develop inline controls

Membership, permissions and security

Security model overview

User management

Role management

Username customization

Permissions

Permissions overview

Document permissions

Document-level permissions

Security

Secured website areas

SSL (HTTPS) support

Cross site scripting (XSS)

Configuration of allowed request parameters

Managing security using .NET code (API)

UI personalization

Quick example

How does it work

Personalizable parts of CMS Desk

CMS Desk -> Content -> Edit -> Properites tab

CMS Desk main tabs

CMS Desk -> Content tab

CMS Desk -> My desk tab

CMS Desk -> Tools tab

CMS Desk -> Administration tab

WYSIWYG editor

Media dialog

Enabling UI personalization

UI profile configuration

UI elements management

UI elements management overview

Example: Adding a new main tab to CMS Desk

User registration

Available registration web parts

Registration form web part

Creating a custom registration form

Registration approval and double opt-in

Shared user accounts

Badges

Defining badges

Assigning badges to users

Activity points

Available form controls

Custom fields visibility

How it works

Enabling visibility controls

Use in custom form layouts

Configuring the web parts

Authentication

Authentication overview

Windows authentication (Active Directory)

Configuring Windows authentication (Active Directory)

Windows authentification on Windows 7/2008 R2/Vista (IIS7 or higher)

Securing a web site section using Windows authentication

Active Directory Import Utility

AD Import Utility overview

Using the wizard

AD import from command line

How to recognize imported users and roles

Configuring mixed mode authentication

Integrating authentication with external systems

Single sign-on

Displaying personalized content

Third-party authentication services

Windows Live ID

Registering your application

OpenID

Facebook Connect

Registering your application

Managing imported users

Membership internals and API

Managing roles and permissions

Managing users

Managing badges

Microsoft Silverlight integration

Adding a Silverlight application to your site

IIS configuration

Multilingual and international support

Configuring multilingual content

Configuring multilingual and RTL UI

RTL languages

Languages and URLs

Default language selection

Localization Expressions

Translation management

Culture-dependent workflow scopes

Translation status overview

Language-bound editors

Page processing and URLs

Multiple document aliases

URL rewriting

URL format and configuration

Wildcard URLs

Linking pages and files

GetFile.aspx parameters

Output filters

Google Sitemap

Rebranding

Changing a logo in the header

Removing the log-on bar

Changing logo of CMS Desk and CMS Site manager

Renaming resource strings

Scheduler

Scheduling a custom code

Scheduler internals and API

Getting scheduled task data

Managing scheduled tasks

Running a scheduled task

SQL import

How to use the SQL import utility

System tables and custom fields

Web parts

Modifying web parts

Setting web part properties dynamically in your code

Customizing web part layout

Modifying code of standard web parts

Web part inheritance

AJAX support

Web part containers

Containers overview

Creating web part containers

Data source web parts

Using Data source web parts

Problems with XML data source

Developing Data source web parts

Developing custom filters

Widgets

Widget internals and API

Managing widgets and their categories

Getting widget data

Setting widget permissions

Workflow and versioning

E-mail notification in workflow process

Defining a workflow

Using workflow

Versioning and rollback

Versioning without workflow

Content locking

Managing workflow using .NET code (API)

Modules

Developing custom modules

Abuse report

Using the In-line abuse report web part in transformations

Abuse reports management

Integration with other modules

Abuse report internals and API

Submitting an abuse report

Getting abuse reports from the database

Updating an abuse report

Deleting an abuse report

Alternative forms

Creating an alternative form

Joining two classes into one form

Automatically used alternative forms

Avatars

Changing user avatars

Changing group avatars

Managing avatars

Avatars internals and API

Modifying and creating avatars

Getting avatar data

Displaying avatars in transformations

Bad words

Bad words internals and API

Getting and updating bad words

Creating bad words

Deleting bad words

Performing bad word checks

Banned IPs

Enabling IP banning

Banning an IP address

Finding an IP address

Banned IPs internals and API

Modifying and creating banned IPs

Getting banned IP data

Checking if actions are banned

BizForms

Displaying a form on the live site

Creating a new form

Managing BizForm data

Notification and autoresponder e-mails

Notification e-mails

Autoresponder e-mails

Using macros with BizForms

Defining custom form layout

BizForms internals and API

Customization possibilities

Creating a new record

Updating a record

Deleting a record

Blogs

Adding a blog to your site

Sample blog

Adding posts to your blog

Moderating comments

Blog layout and design

On-site management via User contributions

Managing blogs using Kentico CMS API

Trackbacks

Trackbacks overview

Enabling trackbacks

Blog comments notifications

MetaWeblog API

Windows Live Writer installation

Registering blog account

Publishing first blog post

Booking system

Publishing the events

Managing attendees

Booking system internals and API

Adding a document to a category

Categories

Using the Category list web part

Content rating

How to enable content rating on the web site

Other involved web parts

Displaying ratings in transformations

Content rating internals and API

Content rating database tables and API classes

Adding document rating

Getting document rating

Modifying document rating

Resetting document rating

Content staging

Content staging configuration

What can be synchronized

Bi-directional staging

Synchronizing the content

Automatic synchronization

Using X.509 authentication

Synchronization using API

Custom tables

Managing data in custom tables

Creating custom tables

Managing custom tables

Transformations for custom tables

Custom tables internals and API

Adding an item into a custom table

Getting items from a custom table

Editing a custom table item

Deleting a custom table item

Getting custom tables

A complete example

Document library

Document library web parts

Document library widget

Creating a document library

Managing files in document libraries

E-commerce

E-mail queue

Administrating the e-mail queue

Event calendar

File import

Forums

Creating a forum group

Creating a pre-defined forum

Publishing a pre-defined forum on the website

Adding an ad-hoc forum to the web

Adding forum searching

Managing forum posts

Forum moderation

Subscriptions

Forum post attachments

BBCode support

Forum favorites

Friendly URLs

Customizing forum design

Forums internals and API

Creating forums

Creating threads

Friends

Example: Displaying offices on the map

Requesting friendships

Geo mapping

Groups

Enabling users to create groups

Groups management

Editing a group

How site users create a new group

Groups internals and API

Modifying and creating groups

Getting group data

Managing group members

Managing group roles

Creating a group invitation

Image gallery

Available page templates

Importing images

Transformations

Media libraries

Files and folders management

Creating media library

Media library content

Uploading files

Supported file types

Supported file size

File naming conventions

Displaying files from media library

Using Media library web part

Using WYSIWYG editor

Settings

Media library settings

Configuring custom storage for media library

Configuring custom file types

Configuring maximal uploaded file size

Security

Media library permissions

Secured vs. Non-secured libraries

Message boards

Using the Message board web part

Managing message boards

Editing message boards

Setting Board base URL

Adding the messaging functionality to the live site

Message board notifications

Messaging

E-mail notifications

Messaging internals and API

Adding a user to contact list

Creating a new message

Deleting all messages

Removing a user from ignore list

Newsletters

Creating a static newsletter

Authoring static newsletter issues

Creating a dynamic newsletter

Integrating newsletters into the site

Newsletter templates

Subscriber management

Subscriber import and export

Troubleshooting

Notifications

Creating a notification message template

Subscribing users to content changes notifications

Managing users' notifications

Custom notification gateway

Custom notification gateway form

Custom notification gateway class

Registering a custom gateway

Using the gateway on your site

On-line users

Enabling the On-line users module

On-line users tab

On-line users web part

On-line users internals and API

Getting on-line user data

Checking if a user is on-line

Polls

Adding a poll to your site

Multilingual support

Polls internals and API

Updating an existing poll

Creating a new poll

Add a new answer

Change the number of votes

Add authorized roles

Deleting a poll

Deleting a poll answer

Project management

Managing projects and tasks

Project management web parts and widgets

Using project management on the live site

Reporting

Managing report categories

Creating a new report

Creating a new Table

Creating a new Graph

Creating a new Value

Defining report parameters

Saving a report

Displaying a report on a website

Reporting internals and API

Managing reports and their categories

Getting report data

Creating graphs, tables and values

Editing the layout of a report

Saving the current status of the report

Getting HTML code of a saved report

Syndication (RSS, Atom, XML)

Syndication web parts and widgets

Syndication transformations

Usage examples

CMS RSS feed

RSS feed + data source

RSS repeater + Data source

Creating RSS feed pages manually (obsolete)

SharePoint integration

Usage examples

GetSharePointFile page

Smart search

Enabling Smart search indexing

How it works

Managing indexes

Creating an index

Defining document index content

Defining forums index content

Defining custom tables index content

Defining user index content

Settings for particular object types

Using the Smart search filter

Search syntax

Related scheduled tasks

Searching attachments

SQL Search overview

Smart search internals and API