Kentico CMS for ASP.NET - DevNet - FAQs

How to dynamically change the number of results displayed by the UniPager

Tue, 24 Jan 2012 07:41:59 GMT

Please navigate to the file \CMSWebParts\Viewers\Basic\UniPager.ascx.cs. Please change the line:

pagerElem.PageSize = PageSize;

for the following code:

                if (CheckBox1.Checked)

                {

                    pagerElem.PageSize = 1000;

                    pagerElem.PagedControl.PagerForceNumberOfResults = 1000;

                    pagerElem.PagedControl.ReBind();                   

                    pagerElem.DataBind();

                }

                else {

                    pagerElem.PageSize = PageSize;

                }

Now add this method to the file:

    protected void CheckBox1_CheckedChanged(object sender, EventArgs e)

    {

        SetupControl();

    }

The last thing to do is to alter the file CMSWebParts\Viewers\Basic\UniPager.ascx and add the code below:


    oncheckedchanged="CheckBox1_CheckedChanged"  AutoPostBack="true" EnableViewState="true"/>

Now you’ve added a checkbox which, when checked, will display 1000 results instead of the number set in the properties of the UniPager web part.

-bp-

How to solve the "Invalid image data. Please check eventlog for more details." error message?

Thu, 19 Jan 2012 08:16:42 GMT

Please make sure you have the Data Visualization Charting component installed (please use the correct .NET version):
http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=14422

Additionally, please check the section in the web.config file if it contains a similar entry to the one below:

-bp-

How to track all downloads in the analytics module

Tue, 13 Dec 2011 06:17:41 GMT

A bit of customization is required to track all the downloaded files. The problem is that only CMS.File document type downloads are tracked by default. However, you can change that by going to the file:

\CMSPages\GetFile.aspx.cs

Within this file, around line 451 there is the following condition:

if (IsLiveSite && (file.FileNode != null) && (file.FileNode.NodeClassName.ToLower() == "cms.file"))

You have to alter it to the following one so all files are logged, not only files attached to a CMS.File document:

if (IsLiveSite && (file.FileNode != null) )

You can also add only your document type, it's up to you:

if (IsLiveSite && (file.FileNode != null) && ((file.FileNode.NodeClassName.ToLower() == "cms.file")) II (file.FileNode.NodeClassName.ToLower() == "custom.documenttype")))

-bp-

How to solve the “Could not load type 'System.ServiceModel.Activation.HttpModule' …” error message

Tue, 13 Dec 2011 06:03:26 GMT

When you encounter a similar issue, the following action may help solve the problem:
Call:
aspnet_regiis.exe /iru
through the command prompt. You can find it in the folder:
* %windir%\Microsoft.NET\Framework\v4.0.30319
* %windir%\Microsoft.NET\Framework64\v4.0.30319 (64-bit machine)

Additional info can be found under the links below:
IIS.NET blogs
DevOneNode

-rm-

How and why to unify UI elements before upgrade to version 6.0?

Tue, 13 Dec 2011 05:41:54 GMT

The import of UI elements was changed in version 6.0. The unique identifier of each element is its GUID. It may happen that on a site created in one of the previous versions elements exist with the same element names as in version 6.0, but with different GUIDs than they should have in version 6.0. As a result, after importing the site to version 6.0, UI elements are duplicated and not displayed correctly in the UI.
To ensure this will not occur, you need to unify the UI elements on the older site (for example 5.5 R2) before perfoming its export and importing it to version 6.0.

You can do it easily if you apply this script to the 5.5 R2 database.

-it-

How to resolve the System.Web.DataVisualization error message on version 6.0?

Tue, 13 Dec 2011 05:38:11 GMT

The missing assembly reference is usually caused by the missing component MSCharts. Please make sure you have it installed. Otherwise, please install it from here.

-bp-

How to let the user access a module in CMS Desk which is available only in CMS Site Manager?

Tue, 13 Dec 2011 05:16:12 GMT

The easiest way is to create a new link to the pages in CMS Desk by defining a new UI element. In this example we will use the UI Cultures module as an example. At first, navigate to CMSModules/UICultures in your project folder. Please find all the *.cs files in the subfolders and change the inheritance of the pages from SiteManagerPage to CMSModalPage. Now, create a new element in CMS Site Manager / Development / Modules / CMS Desk / User Interface. Here add a new element with the following properties:

Display name: UI Cultures
Code name: UICulturesCMSDesk
Parent element: CMS Desk
Elemet is custom: true
Caption: UI Cultures
Target URL: ~/CMSModules/UICultures/Pages/Development/UICultures_Default.aspx

Now, when accessing CMS Desk a new UI element should be available with the caption “UI Cultures”.

-bp-

Why several Attachment image galleries do not work on one page?

Tue, 04 Oct 2011 08:42:02 GMT

Regrettably, the Attachment image gallery contains a lightbox and more than one lightboxes on one page do not work together. You can use Document attachments web part instead of Attachment image gallery if you need more attachment web parts on one page.

Version 6 include Repeater with lightbox and Attachments with lightbox which can work in several copies on one page.

-hg-

YouTube videos are not shown in our forums

Mon, 03 Oct 2011 02:58:07 GMT

Even if you have enabled the YouTube video button in the forum WYSIWYG editor, the video is not shown in the forum post when a user fills all the necessary data for the Youtube video in the dialog and clicks OK.
The trick lies in the following setting which needs to be set on (either for the whole forum group or on a particular forum level):

Enable images in posts: Advanced dialog

You can find it in the CMS Desk -> Tools -> Forums -> Edit -> General tab.

-ov-

How to enable Google analytics to track PDF downloads

Wed, 28 Sep 2011 08:41:02 GMT

You will need to edit the ~\CMSPages\GetFile.aspx file and add your Google analytics code to this file. You should receive JavaScript code with your account number from Google. Place this code into the GetFile.aspx file under the first line of code. Please see the example below:

<%@ Page Language="C#" AutoEventWireup="true" CodeFile="GetFile.aspx.cs" Inherits="CMSPages_GetFile" %>

I cannot view a SharePoint file

Tue, 27 Sep 2011 03:21:14 GMT

If you want to view a SharePoint file using the handling file: GetSharePointFile.aspx, please check the global settings in:

Site manager -> Settings -> Microsoft SharePoint

The settings configured here are automatically used for authentication by the GetSharePointFile.aspx page. It is not enough to set up the credentials in the SharePoint web parts’ properties if you want to see the content of file (not to list only).

-hg-

How to fix server error “Type 'CMSModuleLoader' already defines a member called...” in Kentico 6.0 installation

Mon, 26 Sep 2011 02:43:06 GMT

This issue is related to 6.0 version of Kentico CMS. It may occur if you install Kentico into the same directory in the Program Files directory, by default it is:

C:\Program Files (x86)\KenticoCMS\6.0

In case you have a beta version already installed in this directory, the server error “CS0111: Type 'CMSModuleLoader' already defines a member called 'CMSModuleLoader' with the same parameter types” is thrown. To fix it you need to remove the previous installation or select a different installation folder.

-it-

How to change a default command in the FCK editor

Tue, 13 Sep 2011 02:46:04 GMT

We will demonstrate a behavior on the Paste button inside an editable text area.

If you right click on it, the Paste option is visible and Paste dialog is opened. You may need to change this default behavior and open dialog Paste as a plain text instead.

In this case can insert following line into the file: ~/CMSAdminControls/FCKeditor/editor/plugins/Shortcuts/fckplugin.js (or another registered script)

FCKCommands.LoadedCommands['Paste'] = new FCKPastePlainTextCommand();

Links to other resources: Custom FCK editor toolbar

-it-

How to apply css stylesheets and display images if the site is running on IIS 7

Tue, 06 Sep 2011 06:38:49 GMT

It is a common issue on IIS 7 installations because the Static Content option is not enabled by default. You need to check this Windows setting to apply stylesheets and display images which are parts of the application's static content. Please see this article: Do not forget to check static content service for more information.

-it-

How to remove colons from labels of Custom registration form

Mon, 15 Aug 2011 03:36:57 GMT

Please clone the Custom registration web part and add this line to the SetupControl() method:

formUser.BasicForm.UseColonBehindLabel = false;

where formUser is ID of a form control.

-hg-

Is Silverlight 4 supported?

Wed, 10 Aug 2011 02:56:15 GMT

Yes, it is supported in Kentico CMS 5.5R2. You can develop your custom Silverlight 4 application with no problem.

Links to related articles: Data communication in Silverlight 2.0
Kentico CMS supports Silverlight 2.0

-ov-

Why WCF Data Services do not work on my Windows 7 server

Wed, 10 Aug 2011 02:46:26 GMT

When you’ve installed Windows 7 and all the appropriate IIS features, WCF (formerly known as ADO.NET Data Services) will still not be available on your box by default.

You can enable it if you open up the command prompt in the Administrator mode and run the following command:

c:\>"%windir%\Microsoft.NET\Framework\v3.0\Windows Communication Foundation\ServiceModelReg.exe" -r

This will map the svc file type to aspnet_isapi.dll and make IIS recognize WCF services and startup the ServiceHost for you. In other words: the svc MIME type will be registered with IIS. The parameter on the end is:

-r: Re-registers this version of WCF and updates scriptmaps at the IIS metabase root and for all scriptmaps under the root. Existing scriptmaps are upgraded to this version regardless of the original versions.

And just to be sure: restart the IIS after you’ve run this command.

You can find more information here: Configure WCF to run on Windows 7

WCF services may be used with Kentico CMS for example like: Data communication - ADO.NET Data Services

-hg-

How to smart search in custom tables

Thu, 21 Jul 2011 06:22:35 GMT

The smart search is supported by default in custom tables. You need to create a smart search index in the Site Manager –> Administration –> Smart search –> New index and finally select an Index type: Custom tables. To display search results you need to write a transformation which will be used by the web part displaying results.

Displaying detail information about some row is a little different from showing details of some document. The page with custom table row does not exist in the content tree. Therefore you need to create a special page for this purpose. You could insert for example a custom table repeater web part to this page and from the smart search transformation pass the ItemID value (or some other ID column) to this page. Using a query macro {?ItemID?} you could set a WHERE condition property of custom table repeater web part and ItemID={?ItemID?}. This way only a selected row will be displayed.

You can find more information about Smart search transformations here: Smart search transformations.

-it-

What hotfix am I currently using?

Wed, 20 Jul 2011 05:29:29 GMT

In newer versions (5.5 and higher) you can simply use the query below to get the hotfix number from the database:

SELECT KeyValue, KeyName FROM CMS_SettingsKey WHERE KeyName = 'CMSHotfixVersion'

Otherwise you will have to simply determine it by the table below:

Hotfixes (build #) Hotfix version Build number
5.5 R2
5.5.31 R2 4216
5.5.30 R2 4206
5.5.29 R2 4202
5.5.28 R2 4191
5.5.27 R2 4188
5.5.26 R2 4181
5.5.25 R2 4175
5.5.24 R2 4164
5.5.23 R2 4160
5.5.22 R2 4150
5.5.21 R2 4147
5.5.20 R2 4136
5.5.19 R2 4129
5.5.18 R2 4125
5.5.17 R2 4115
5.5.16 R2 4108
5.5.15 R2 4104
5.5.14 R2 4097
5.5.13 R2 4090
5.5.12 R2 4083
5.5.11 R2 4073
5.5.10 R2 4070
5.5.9 R2 4059
5.5.8 R2 4051
5.5.7 R2 4045
5.5.6 R2 4041
5.5.5 R2 4031
5.5.4 R2 4027
5.5.3 R2 4020
5.5.2 R2 4014
5.5.1 R2 4006
5.5 R2 final / upgrade 3996

5.5
5.5.30 3999
5.5.29 3992
5.5.28 3981
5.5.27 3978
5.5.26 3971
5.5.25 3964
5.5.24 3957
5.5.23 3950
5.5.22 3943
5.5.21 3936
5.5.20 3926
5.5.19 3922
5.5.18 3912
5.5.17 3905
5.5.16 3901
5.5.15 3894
5.5.14 3887
5.5.13 3880
5.5.12 3873
5.5.11 3866
5.5.10 3859
5.5.9 3849
5.5.8 3842
5.5.7 3834
5.5.6 3828
5.5.5 3821
5.5.4 3817
5.5.3 3810
5.5.2 3803
5.5.1 3793
5.5.0 final / upgrade 3789
5.5.0 beta 3751

5.0
5.0.19 3784
5.0.18 3778
5.0.17 3771
5.0.16 3765
5.0.15 3758
5.0.14 3742
5.0.13 3733
5.0.12 3733
5.0.11 3722
5.0.10 3715
5.0.9 3708
5.0.8 3702
5.0.7 3693
5.0.6 3688
5.0.5 3681
5.0.4 3677
upgrade includes 5.0.3 3671
5.0.3 3670
5.0.2 3659
5.0.1 3656
5.0.0 final 3644
5.0.0 beta 3630

4.1
4.1.21 3667
4.1.20 3639
4.1.19 3639
4.1.18 3638
4.1.17 3631
4.1.16 3625
4.1.15 3617
4.1.14 3612
4.1.13 3603
4.1.12 3597
4.1.11 3590
4.1.10 3582
4.1.9 3576
4.1.8 3571
4.1.7 3561
4.1.6 3554
4.1.5 3552
4.1.4 3541
4.1.3 3537
4.1.2 3525
4.1.1 3523
4.1.0 3518
4.1.0 pre final 3513

4.0
4.0.15 3511
4.0.14 3505
4.0.13 3492
4.0.12 3492
4.0.11 3485
4.0.10 3481
4.0.9 3470
4.0.8 3464
4.0.7 3455
4.0.6 3436
4.0.5 3436
4.0.4 3432
4.0.3 3420
4.0.2 3397
4.0.1 3387
4.0.0 3328

-bp-

How to resolve text with Localization macros according to a specific culture

Tue, 19 Jul 2011 03:41:56 GMT

You can use a code like:

string output = ResHelper.RegExLocalize.Replace(input, LocalizedStringMatch);

where input is a string with localization macros.

Then you need to specify LocalizedStringMatch, for example:

///

/// Match evaluator for the string localization
///

/// Regular expression match
private static string LocalizedStringMatch(System.Text.RegularExpressions.Match m)
{
string expression = m.Groups[1].ToString();
return ResHelper.GetString(expression, culture);
}

where culture is a global string variable which contains a culture code (i.e. “en-US”).

-hg-

Hiding the spell check button

Mon, 18 Jul 2011 01:51:10 GMT

For disabling of the spell check option please set the "ShowSpellCheck" property of the editmenu in the file ~\CMSModules\Content\CMSDesk\Edit\EditMenu.aspx to "false". This disables the button in CMSDesk. If you want to hide this button on a User Contribution, you should be able to apply the same approach on the file ~\CMSModules\Content\Controls\UserContributions\EditForm.ascx.

-bp-

Functionality of "Remember me" checkbox in logon web part

Mon, 06 Jun 2011 06:21:05 GMT

If you log in and have this checkbox ticked and you stop working at all with your pages but don't log out, this feature will be useful because next time you access the pages you won't have to log in again. It’s something like persistent connection. It works like e.g. Google account - if you check it, you should stay logged into the system. You don't need to fill your credentials anymore (until you click the 'Sign out button').

Many customers think that it provides auto-filling functionality of the username and password fields so that they wouldn’t need to enter them every time they try to login to the site. It is handled by browser itself. Please take a look at the below links for more details.

See also: Auto complete in Firefox , Auto complete in Internet Explorer

-it-

Why do secured Word and Excel documents need an extra logon page?

Mon, 06 Jun 2011 03:51:18 GMT

If you secure Word and Excel documents uploaded as CMS.File-s (they require authentication) and the documents contain links to other secured documents, it always displays the logon screen if you click on the links no matter if you are already logged in. In other words, if you browse through the documents via links in the document content, you need to type the username and password every time you open a new document.

Microsoft Word and Excel applications use a special request before the standard request which should check the URL. The extra request does not include needful information for Kentico and that is why it displays the extra logon screen.

Regrettably, we cannot affect the behavior of these processors. For example Outlook and PDF reader use the standard way and it works OK.

-hg-

Do Cross-page postbacks work with Kentico CMS?

Thu, 02 Jun 2011 07:22:55 GMT

Regrettably, the Cross-page postbacks do not work with Kentico CMS. The issue is caused by .NET and arises when used both of UrlRewrite and Cross-page postbacks.

Workaround: You can use the MultiView .NET control which can be used for the wizard-like behavior.

-hg-

Can I use nested macros for the (equals) or (not equals) macro parameter?

Thu, 02 Jun 2011 06:42:25 GMT

Regrettably, the nested macros are resolved too late for the condition. That is why the nested macros work for the branches of condition - (truevalue) and (falsevalue) parameters but not for the condition expression. If you want to compare two macros, please use custom macros. You can find a sample code here: Macro expressions

More information about nested macros can be found here: New in 5.5 - Macro parameters

-hg-

How to set up a web part to be visible on two pages

Wed, 25 May 2011 06:23:33 GMT

If you want to configure a web part to be visible on one page (e.g. Home), you can use a simple macro in the Visible web part property:

{%DocumentName|(equals)Home|(truevalue)true|(falsevalue)false%}

If you want to display the web part on the Home OR News document, you would need to use a nested macro. For example:

{%DocumentName|(equals)Home|(truevalue)true|(falsevalue){(1)%DocumentName\|(equals)New\|(truevalue)true\|(falsevalue)false%(1)}%}

You can also develop a custom macro instead of nesting macro expressions like: Macro expressions

More information about nested macros: New in 5.5 - Macro parameters

-hg-

How to use multiple paths on a web part

Mon, 23 May 2011 01:18:55 GMT

Regrettably, web parts don't support multiple paths. However, you can mimic this behavior with a custom WHERE condition if it is available. For example, the WHERE condition could look something like this:

NodeAliasPath like '/Articles/%' OR NodeAliasPath like '/Misc/%'

Please don't forget to set the path property to /% to include all the documents into the query.

-bp-

Where can I manage the generic document fields which are indexed by Smart search (i.e. Document URL path)?

Thu, 12 May 2011 06:28:51 GMT

You can manage these generic fields in Site manager -> Development -> System tables -> edit Ecommerce - SKU -> Search fields. You can uncheck the Content checkboxes so that the field content is not involved in the standard search. Please do not uncheck the ID fields - they need to be Searchable.

-hg-

May I change the location of Smart search indexes in the file system?

Tue, 10 May 2011 02:24:48 GMT

You can change the location by the CMSSearchIndexPath key in your web.config. For example:

-hg-

My site is off due to the CMSRoleProvider error. What should I do now?

Wed, 04 May 2011 05:25:00 GMT

It is usually enough to restart the application. Since you are unable to reach the Site Manager with this error, you can do that an alternative way: by making a small change in your web.config file (it can be a 1 character space somewhere). Afterwards, your site will be restarted and should be up and running.

Please see the following detailed error message to check if this article applies to you:

Description: An error occurred during the processing of a configuration file required to service this request. Please review the specific error details below and modify your configuration file appropriately.

Parser Error Message: Thread was being aborted.

Source Error:
Line 62:
Line 63:
Line 64:
Line 65:
Line 66:

-ov-