Kentico CMS 7.0 Controls

Document menu settings

Document menu settings

Previous topic Next topic Mail us feedback on this topic!  

Document menu settings

Previous topic Next topic JavaScript is required for the print function Mail us feedback on this topic!  

Various navigation related settings can be configured for individual Kentico CMS documents. This can be done in the CMS Desk interface in Content -> Edit -> ... select document ... -> Properties -> Navigation.

 

controls_clip0018

 

These settings apply to CMS Navigation controls (and web parts) displaying the given document and they override any conflicting property settings of the controls unless a property is set to ignore them.

 

The following settings are available:

 

Basic properties

 

Menu caption

The name of the document that will be displayed in navigation. It may be different than the document name. If no value is entered, the document name is used.

Show in navigation

Indicates if the document should be displayed by navigation controls and web parts (in menus).

 

Please note: the document is displayed in the navigation if all of the following conditions are met:

 

1.The Show in navigation box is checked.

2.The document is published.

3.The type of the document matches the document types configured in the appropriate navigation control (web part) - by default, only Page (menu item) documents are displayed in navigation.

4.If you turn on the Check permissions property of the menu control, the user must be allowed to read the given document so that it appears in the navigation controls.

Show in site map

Indicates if the document should be included in the website's Google sitemap and displayed by the CMSSiteMap control.

 

Menu actions

 

Standard behavior

Clicking the menu item redirects the user to the page as expected.

Inactive menu item

Clicking the menu item doesn't cause any action — the item is disabled. If selected, the Redirect to URL field appears, where you can enter the URL of a page to which users will automatically be redirected if they access the given page, e.g. through a link.

Javascript command

The entered JavaScript command will be executed when this menu item is clicked instead of standard redirection.

 

Example: alert('hello');return false;

URL redirection

The user is redirected to the target location when they try to access the given page.

Example: http://www.domain.com or ~/products.aspx

 

Macro expressions can be used in the URL redirection and JavaScript command fields. These macros allow you to dynamically replace the given expression with specified values of the current menu item, such as alias path, id path, node name.

 

You only need to place macros in format {%ColumnName%} into the property field. For example, entering:

 

~/products.aspx?show=brand&aliaspath={%NodeAliasPath%}

 

Into the Redirect to URL field of e.g. the /MobileStore/Products/Nokia document will cause users to be redirected to:

 

http://<domain>/products.aspx?show=brand&aliaspath=/MobileStore/Products/Nokia

 

Please note: All apostrophes (') in the source data are escaped to \' so that they do not break JavaScript.

 

Menu design

 

The menu item design properties are available in three alternatives:

 

standard design

mouse-over design - style used when a user hovers their mouse over the menu item,

highlighted design - style applied if the page represented by the menu item is currently selected.

 

These values override the settings of individual navigation controls (web parts) unless their ApplyMenuDesign property is set to false. The CSS styles defined in the CSS stylesheet are overridden as well.

 

Please note: some of the following properties may not be applied to the menu control depending on the menu control you are using.

 

Menu item style

Style definition of the menu item. Values can be entered the same way as when defining a CSS class in a stylesheet.

Sample value: color: orange; font-size: 140%

Menu item CSS class

CSS class defined in the website's stylesheet.

Sample value: h1

Menu item left image

Image that will be displayed next to the menu caption on the left side. Sample values as below.

Menu item image

Image that will be displayed in the menu instead of the menu caption. You can enter either an absolute URL or a relative path in the content tree.

Sample values: http://www.domain.com/image.gif

~/Images-(1)/icon.aspx

Menu item right image

Image that will be displayed next to the menu caption on the right side. Sample values as above.