Kentico CMS for ASP.NET - DevNet - FAQs

I get page not found error on Windows 2003 server right after installing the site using webinstaller

Thu, 04 Mar 2010 03:36:09 GMT

If you have previously uninstalled and reinstalled ASP.NET on the server, this issue may be caused by the ASP.NET Web Service Extensions permissions had been reset to “Prohibited”. Please change it to 'Allowed' instead. You can find more details at http://support.microsoft.com/kb/315122

How can I resolve a localized string on the ASPX template?

Tue, 02 Mar 2010 13:03:41 GMT

You can encounter a problem that <%# ResHelper.GetString(key) %> does not work.
Please use this format: <%= ResHelper.GetString(key) %>

-hg-

"'CMS.GlobalHelper.ImageHelper' does not contain a definition for 'GetFileIconUrl'" error message in Event Log

Thu, 18 Feb 2010 04:29:02 GMT

This issue may occur after upgrade to version 5.0.

There should be following code in version 5.0 in ~\CMSInlineControls\ImageControl.ascx.cs (round the line 480):

imgParams.Url = GetFileIconUrl(this.Extension, "List");

However in version 4.x it looks like this:

imgParams.Url = ImageHelper.GetFileIconUrl(this.Extension, "List");

So it's possible that this line has been overwritten during import process of 4.1 web site into 5.0 version.

Tags specified when creating new document are not visible in cloud

Sun, 14 Feb 2010 06:27:19 GMT

This issue may happens if you specify tags into field of 'tag selector' type and if you have enabled Cache content setting in 'Settings'. This issue is caused by old tags list is cached in tag cloud. You may save blog document again or restart application in Administration -> System section. You may also consider setting Cache content to zero minutes during development phase.

Which form control is used for user password field in forms?

Sun, 14 Feb 2010 06:10:30 GMT

It may be confusing there is standard text box specified as field type of password field in User system table. This is caused by the value specified in User system table is not actually used anywhere. There is always some particular alternative form used on live page and there is already the 'password with confirmation' form control used in alternative form. You can find source of this form control in ~\CMSFormControls\PasswordConfirmator.ascx(.cs) files.

Why is my custom payment gateway form not loaded?

Mon, 08 Feb 2010 03:12:23 GMT

If the payment gateway assembly is not found by Kentico CMS, your custom payment gateway form will not be loaded.

Following properties of your custom payment gateway are case sensitive, so you need to be sure that you specify them correctly (according to Developing custom gateways) :

Payment gateway assembly name:
Payment gateway class name:

You also need to ensure that you are using correct dll files with your custom payment gateway dll file. In other words, if you have built your dll file in your development environment and you are delivering the custom payment gateway dll file to your live web site, please copy all of the other Kentico CMS dll files together.

Also please check Kentico CMS Event log (CMS Site Manager -> Administration -> Event log) for possible error messages which might lead you to the cause of this issue.

I'm receiving error when importing files after making changes described in 'Defining custom media types' article

Tue, 26 Jan 2010 06:30:48 GMT

There is mistake in sample code in documentation. We are very sorry for this inconvenience. Basically you only need to change following line in example:

if (this.Type.TrimStart('.').ToLower() == "flv")

to:

if ((this.Type != null) && (this.Type.TrimStart('.').ToLower() == "flv"))

How to display prices always with 3 decimal digits?

Mon, 25 Jan 2010 08:15:48 GMT

You can set the Currency formatting string in the CMS Desk -> Tools -> E-commerce -> Configuration -> Currencies -> . This property uses Standard Numeric Format Strings. In this example, enter following string: ${0:F3}.
See Also:
Standard Numeric Format Strings

My payment method is not in the checkout process of shopping cart, why?

Mon, 25 Jan 2010 08:13:43 GMT

First of all, please check if the payment method is enabled in: CMSDesk -> Tools-> E-commerce -> Configuration -> Payment methods -> -> Enabled: checked
Then the payment method needs to be assigned to appropriate shipping options. Please check if your payment method is enabled in: CMSDesk -> Tools-> E-commerce -> Configuration -> Shipping options -> -> Payment methods tab

How do I get the total items of a search results?

Mon, 25 Jan 2010 05:54:33 GMT

If you use the smart search you may use the Eval function in transformation: <%# Eval("Pages") %>.

If you use the SQL search you may clone the SearchResult web part and add the code like this:

protected override void OnPreRender(EventArgs e)
{

base.OnPreRender(e);
if (srchResults.DataSource != null)
ltlRepeaterCount.Text = srchResults.DataSource.Tables[0].Rows.Count.ToString();

}

It needs to add the literal control with ltlRepeaterCount ID to the template.

SelectSingleNode method doesn't work in version 5.0

Sat, 23 Jan 2010 13:23:49 GMT

Please check if you use '%' character in your path for representation of sub-tree. If so, please remove it and specify full alias path of document instead. This macro is no longer supported by this method as it can be used in name of document (you can still use it in SelectNodes method though).

I'm receiving following error: "Error calling [msvcrt.dll]:_wmkdir"

Sat, 23 Jan 2010 13:10:16 GMT

This error message occurs if you don't have sufficient permissions for writing to disk. Please check disk permissions of process used by application.

I'm getting "Temporary files haven't been created yet!" error when importing or creating new site

Sat, 23 Jan 2010 12:55:40 GMT

This error can be caused by some content in the App_Data folder. Could you please try to delete content of ~\App_Data\CMSTemp directory in appropriate project folder and then try to import again?

How to get data of file attached to document

Sat, 23 Jan 2010 12:36:25 GMT

You can use sample code bellow:

using CMS.SiteProvider;

...

// Tree node

CMS.TreeEngine.TreeNode node = null;

// Tree provider

UserInfo ui = UserInfoProvider.GetUserInfo("administrator");

CMS.TreeEngine.TreeProvider tree = new CMS.TreeEngine.TreeProvider(ui);

// Get Single node specified by it`s ID

node = tree.SelectSingleNode(nodeId);

//Get GUID of attachment

Guid existingGuid = ValidationHelper.GetGuid(node.GetValue("FileAttachment"), Guid.Empty);

if (existingGuid != Guid.Empty)

{

// Get the attachment

AttachmentInfo existingAttachment =

am.GetAttachmentInfo(existingGuid, CMSContext.CurrentSite.SiteName);

}

How to get last comment from version history in custom workflow handler

Sat, 23 Jan 2010 12:10:38 GMT

You can use sample code bellow:

CMS.TreeEngine.TreeNode node = treeNodeObj as CMS.TreeEngine.TreeNode;
int documentCheckedOutVersionHistoryID = node.DocumentCheckedOutVersionHistoryID;
CMS.WorkflowEngine.VersionHistoryInfo whi = CMS.WorkflowEngine.VersionHistoryInfoProvider.GetVersionHistoryInfo(documentCheckedOutVersionHistoryID);
string comment = whi.VersionComment;

How to disable website for maintenance

Sat, 23 Jan 2010 11:55:52 GMT

You can add HTML file with following name into root of project folder: app_offline.htm

All requests will be automatically redirected to this file then (it's general .NET functionality). You can optionally add some 'site under maintenance' text/image into this file.

I cannot login to site, because the "Use SSL for administration interface" option has been switched on

Mon, 04 Jan 2010 04:28:15 GMT

Sometimes it might happen that you accidentally switch on the option "Use SSL for administration interface" within Site Manager -> Settings -> (global) -> Security.

First option is generating SSL certificate and configure your IIS to use it. The easiest way is using SelfSSL certificate service, you can find more info about it using Google.

Another option is switching off this option manually in the database. Please open the database and in table CMS_SettingsKey find this record: CMSUseSSLForAdministrationInterface and in column KeyValue change the value to false. Now, you need to make some change in web.config file, e.g. add some space and save it. This will force the application to restart and after this everything should be like before.

How to select page templates for custom document types?

Mon, 04 Jan 2010 04:25:04 GMT

When you create document based on your custom document type in the CMSdesk -> Content (or other type than Page (menu) item), it inherits the page template from the parent document automatically. However you might want to choose the page template for it manually.

To achieve this aim you will need to define special "new page" step. It could be the same as for Page Menu Item document type. So please go to Site Manager -> Development -> Document types -> Edit -> General tab and define New page property like this: ~/cmsdesk/Content/newpage.aspx.

“Object doesn't support this property or method” error in IE8 while inserting links in WYSIWIG editor (3.x versions)

Tue, 22 Dec 2009 14:00:34 GMT

Please note that IE8 was not supported in 3.x versions. You may upgrade to the latest FCKEditor 2.6.5 (in /CMSAdminControls/FCKEditor/) and then just commented out lines 141, 142

// if ( typeof window.DoResizeFixes == 'function' )
// window.DoResizeFixes() ;

How to sort documents selected by SelectNodes API method

Fri, 18 Dec 2009 11:24:03 GMT

You may use the overloaded method with OrderBy parameter (see API Reference for more details) but it sorts documents only within one document type. If you use more document types (classes) please use standard ASP.NET methods to sort the dataset. Please see the MSDN documentation for more information.

How to validate a multiple choice field in BizForms with a regular expression?

Mon, 14 Dec 2009 09:53:43 GMT

Kentico CMS is using ‘|’ to separate multiple choices. That means, if you have for example a quiz like form, with the correct answers 1 and 3, defined for example as 1;True 2;False 3;True you need to use the regular expression [1][|][3]. You don’t need to use at the start the combination ‘^(‘ and at end the combination ’)$’ - they are inserted automatically.

Why Content changes notifications are not working correctly?

Mon, 14 Dec 2009 09:51:25 GMT

It is possible that you have changed the settings of Content subscription web part. Please note that these changes are not applied for current subscriptions but only for new ones.
It would help if you re-new all subscriptions – delete them and create once again. You may delete them on Administration -> Users -> edit -> Notifications tab.
There is a feature in 5.0 version that if you are a Global administrator you may log on as edited user (Administration -> Users -> edit -> General) so you may re-create his/her content subscriptions.

Documentation for Content changes notifications

How to resolve BBcode in the transformation?

Mon, 14 Dec 2009 09:36:23 GMT

If you are using the document type field of BBcode editor type you may see that the BBcode tags are not resolved if you use simply the Eval function (<%# Eval("field_name") %>).
You can use the ResolveDiscussionMacros function like here in this case:
<%# CMSContext.ResolveDiscussionMacros(Eval("field_name").ToString()) %>

How to enable auto completing for tag selector in field of document type

Mon, 07 Dec 2009 13:09:15 GMT

Regrettably, field “Tag Selector” of type doesn't support auto completing. Please use following procedure instead:

Please create new field for Tags using 'New system attribute' button and then choosing 'Document attributes' as 'Group' and 'DocmentTags' as 'Attribute name'. You can inspire by 'DocumentTags' field of CMS.BlogPost document type.

I am able to log on to CMSDesk and see the site but when I log out there is neither content nor error message.

Thu, 03 Dec 2009 06:31:46 GMT

Could you please check unless you use SSL? You may see it when you edit content root -> Properties -> Security -> Requires SSL

If so, please configure it to “No” and check the live site. If it is all right now, you did not configure SSL properly. Please see this article for more information about SSL configuration on your server.

If you add a product to wishlist, the product is displayed without tax classes. How can it be fixed?

Tue, 01 Dec 2009 08:02:48 GMT

This is a matter of what code is used in appropriate transformation.
You can edit transformation used for wishlist web part, find following line:

<%# EcommerceFunctions.GetFormatedPrice(Eval("SKUPrice"), Eval("SKUDepartmentID"))%>

And replace it by this one:

<%# EcommerceFunctions.GetFormatedPrice(Eval("SKUPrice"), Eval("SKUDepartmentID"), Eval("SKUID"))%>

How can I change a page template which is used as default one when I create a new document of XXX document type?

Tue, 01 Dec 2009 08:00:26 GMT

You can change default page template in Site Manager -> Development -> Document types -> edit appropriate document type (e.g. Event) -> Default page template (select).

I'm receiving "Section or group name 'system.web.extensions' is already defined" error after installation

Mon, 30 Nov 2009 10:45:27 GMT

This issue is most probably caused by Kentico CMS site has been put into sub-directory of another web site and is inheriting web.config setting from parent folder. If you use same version of 'system.web.extensions' library in parent folder, you can just remove following line from web.config file of Kentico CMS site:

Otherwise you can change following lines:



to:

How can I change design of Kentico logon page, use different images, styles, etc.?

Tue, 17 Nov 2009 16:19:34 GMT

The Logon page is available in ~/CMSPages/logon.aspx within the project folder. There are following classes used for design:

.LogonPageBody
{

background-image: url(Images/Dialog/BackgroundNew.gif);
background-repeat: repeat-x;
background-color: #e7f2f8;
height: auto;
height: 98%;

}

.loginBox
{

margin: auto;
padding: 80px 0 12px 0; /* width: 503px; */
background: url(Images/Dialog/LoginBox05.gif) no-repeat;

}

Both are defined in ~/App_Themes/Default/CMSDesk.css file. You can change them according to your needs.

Are you getting “Maximum request length exceeded” message when trying upload a file?

Tue, 17 Nov 2009 16:17:14 GMT

This exception is thrown because incoming request is greater than allowed maximum request length. By default ASP.NET http runtime allows to receive requests that are not greater than 4 MB. This value can be increased by specifying maxRequestLength parameter of section of the configuration file (web.config).

1. Open the Web.config file in VS or Notepad.
2. Find the httpRuntime element in the system.web section as follows:

Example:

executionTimeout="90"
maxRequestLength="10000"/> (increase the marked number of bytes)

More detail information about mentioned parameters can be found in Microsoft documentation or in this blog post as well.