Kentico CMS for ASP.NET - DevNet - FAQs

Visitors download the full size of media files instead of downloading the resized version from server on live site.

Tue, 27 Jul 2010 14:52:53 GMT

The system uses the resized versions of media files only if you use the permanent URLs. Please see the settings in:

Site manager -> Settings -> Media libraries -> Site: -> Use permanent URLs

If the checkbox is unchecked it does not use the resized images from disk. If you check the checkbox it can greatly improve the page performance.

When using the Editable image control the img tag shows always: "style="border-width:0px;". How can I avoid it?

Tue, 27 Jul 2010 14:50:06 GMT

Regrettably, this is a .NET bug. Please see this forum thread.
You can find the solution there.

How do I change the context menu for managing friends?

Tue, 22 Jun 2010 14:40:04 GMT

The context menu is generated by the UserContextMenu control located in ~\CMSAdminControls\ContextMenus\UserContextMenu.ascx.cs. To change the context menu edit the mentioned file according to your needs.

-bp-

How to set some characters not to be included in forbidden URL characters

Mon, 21 Jun 2010 02:51:36 GMT

You can add following key into "/configuration/appSettings" section in web.config file:

|&%.'#[]+ =„“" />

it contains all characters forbidden by default so you can just remove characters you want not to be forbidden. E.g. if you want to set "+" character not to be forbidden you can change key to:

|&%.'#[] =„“" />

Tree menu links are not wrapped correctly

Thu, 17 Jun 2010 09:05:00 GMT

Please take a look to your CSS stylesheet and find following link CSS class definition:

.CMSTreeMenuTable a
{
white-space: nowrap;
}

It says to the tree menu not to break the lines. It should work if you remove it or comment it out.

-ov-

How to disable the colons from the BizForm labels

Thu, 17 Jun 2010 09:00:57 GMT

If you use BizForm as an inline control, you can adjust its code-behind: ~\CMSModules\Bizforms\InlineControls\BizFormControl.ascx.cs by amending the SetupControl() method. You will set the BizForm property UseColonBehindLabel to false like this (be aware of this change in case of future upgrade):

this.Bizform1.UseColonBehindLabel = false;

On the other hand, in case you use it as a webpart, there is an easy solution for that. Please locate to webpart properties (on the Design tab) where you can see the 'Use colon (:) in labels' property. You need to set it to false.

-ov-

How to resolve inline control macro using custom code

Tue, 15 Jun 2010 03:52:53 GMT

Please follow procedure bellow:

1. Add the asp:panel control into page and asp:literal control into this panel
2. Set the text with inline control macro into literal's 'Text' property
3. Call: ControlsHelper.ResolveDynamicControls(idOfPanel) to resolve the inline macros.

-md-

add custom CSS class to inputs within the “form based” webpart

Thu, 03 Jun 2010 06:31:54 GMT

We’ll see an example of Submit button element of the Logon form webpart. You can add your custom CSS class to the Logon input button following way:

1) Please open Logon form webpart properties. At the top of opened window there two tabs, right one is Layout. Please switch to this one.

2) You will need to create new layout, in order to be able to edit it.

3) Once you use your custom layout you can add CssClass property to the button control, so that it can finally look like this:

CssClass="LogonButton" ID="LoginButton" runat="server" CommandName="Login" ValidationGroup="Login1" EnableViewState="false" />

This will enforce adding CSS class to the input element which represents your button. Basically, you can change/add the CSS classes of other inputs (textboxes) the same way. Please note, this procedure is applicable also for other similar form webparts like Change password, Sign out button, etc.

-ov-

Lightbox doesn’t resize background correctly

Thu, 03 Jun 2010 01:39:52 GMT

There are two possible reasons of this issue. First one is browser based and it is described in this FAQ.

Second one could be caused by the fact, that the ‘Selected item transformation’ property of the Lightbox webpart is not set. In this case, there needs to be the image tag rendered when seeing selected items. For instance you can use our predefined ‘CMS.File.LightboxSelected’ transformation which contains code as follows:

This transformation is intended for CMS.File document type based documents, so if you store files any other way, you will need to adjust it as per your needs.

Links to other resources:

Writing transformations
Lightbox properties

-ov-

How to make names in the 'styles' dropdown in editor's toolbar look like the classes they represent

Tue, 25 May 2010 05:36:52 GMT

Regrettably, neither styles from stylesheet specified in 'Site CSS stylesheet' nor 'Editor CSS stylesheet' are applied in toolbar of WYSIWYG editor. You will need to put styles also into ~\CMSAdminControls\FCKeditor\editor\css\fck_toolbarcombopreview.css file. You may need to clear browser's cache for these changes to take effect.

How to create print version for whole page content

Tue, 25 May 2010 05:24:02 GMT

Basically, you can follow the Print page article from Dev.Guide. Regrettably, there is no method that returns whole content of page, but you can get content from all editable regions by calling GetEditableValue method manually for every editable region on the page:

<%# GetEditableValue("IdOfEditableRegion") %>

-md-

Why some documents are not inheriting the Header from page template

Fri, 16 Apr 2010 05:51:39 GMT

The Header section of page template is not inherited from parent document's page template, if the document type used for this document is not set to "Behave as Page (menu item)".
You need to set the property to true:
Site manager -> Development -> Document types -> edit document type -> General -> Behaves as Page (menu item) type

-hg-

Why is the 'Maximize the editor size' button disabled on WYSIWYG toolbar?

Fri, 16 Apr 2010 01:51:48 GMT

This functionality is not supported when shared toolbar is used. You may change the 'HTML editor toolbar location' property of particular editable region (in 'configure' dialog) to 'In-line toolbar'. Please note that the FitWindow will fit the region into current frame, i.e. the section under 'Save' and 'Spellcheck' buttons where the page mode is displayed, not the whole page.

Why are the document names displayed in strange way?

Mon, 29 Mar 2010 05:02:21 GMT

It may happen that document name (especially for certain document types) can contain different information from the expected value set on Form tab. This is probably caused by setting incorrect field which is used for document name within particular document type. One can choose it during document type creating or for preexisting document type by accident anytime else.
You can change it in: Site Manager -> Development -> Document types -> particular_document_type -> Fields. Here is dropdown list called ‘Document name source field’ where you can choose whatever field from actual document type as per your needs. Finally you need to save document itself to change its name to correct one.

Defining a new document type documentation.

-ov-

How to display smart search results without linked documents

Thu, 25 Mar 2010 09:55:57 GMT

Could you please add following code into 'Search condition' property of SmartSearchResults web part:

-NodeLinkedNodeID:[0 TO 999999999]

-md-

Why the PDF files are not working on 5.0 site?

Thu, 25 Mar 2010 07:53:48 GMT

Actually this is known issue in version 5.0, where there is a support for resumable download. Regrettably in combination with Adobe PDFs (which has unexpected specification of bytes) it crashes. Fortunately within the hotfix 5.0.11 (well, you could rather apply the latest one), there is implemented workaround for this issue, so please try it.

It will be also necessary to add following key to your web.config file:

-ov-

How come cultures are not changed even if “lang” query string is generated by Language selection web part correctly?

Thu, 25 Mar 2010 07:31:50 GMT

The possible reason could be Google analytics JavaScripts. If you use them please try to remove them and test the behavior. Regrettably, they do not work well together with our multilingual system.

Another reason could be that one culture uses the same custom URL (Properties -> URLs) as document Alias path. Please check the custom URLs of all cultures, all of them should use different strings. Alternatively, you may use empty string (Use custom URLs is checked) for all cultures. Then the system will handle cultures correctly.

-hg-

Visual Studio shuts down right after opening the Kentico CMS solution file

Mon, 22 Mar 2010 08:05:42 GMT

This issue may be caused by using some plug-in in the Visual Studio. You can try running the Visual Studio with /SafeMode parameter to see if any of installed plug-ins causes the problem. You can also open the project as an existing web site. More details about running the Visual Studio in the Safe Mode can be found on Microsoft web site.

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.