Kentico CMS 7.0 Context Help

New/Edit alias

New/Edit alias

Previous topic Next topic Mail us feedback on this topic!  

New/Edit alias

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

On this page, you are either creating a new document alias or editing an existing one. The following properties of the alias can be defined:

 

Path type

You can choose several different URL types for the alias path. The selection made here determines how the value of the Path or pattern field will be processed.

Path or pattern

Enter a URL path for the document alias according to the selected Path type:

 

Standard URL or wildcard - the alias URL will be handled by the standard Kentico CMS rewriting engine. Wildcard URLs can be used here, as described in Wildcard URLs.

Route - the alias URL will be processed as an ASP.NET Route pattern.

MVC - requests to the alias URL will be handled as requests for an MVC page. Please see the MVC development model chapter in the Developer's Guide for more information.

 

For MVC or Route patterns, it is always necessary to include the URL extension at the end of the path. If you leave the path without an extension, the document will automatically be available under an extensionless URL.

Default controller (MVC only)

The name of the controller containing the action which should be performed when the alias URL is accessed, without the Controller part at the end. For example, if the class is called NewsMVCController, enter NewsMVC. The system first searches for the specified class in the CMS.Controllers.<current site code name> namespace. If it is not found there, the CMS.Controllers.Global namespace is searched.

Default action (MVC only)

Specifies the action defined within the controller that should be performed when the alias URL is accessed.

Alias redirection

Determines how the URL should be handled (redirected) when the document is accessed through this alias (for SEO purposes). The following options are available:

 

Use site settings (default) - with this option, the redirection behavior will follow the Redirect document aliases to main URL setting specified for the website in Site Manager -> Settings -> URLs and SEO.

Redirect to main URL - if selected, the alias URL will always be redirected to the main URL of the document, i.e. its alias path or custom URL path (if specified).

Do not redirect - if selected, the alias URL will not be redirected when accessed. This option is recommended if the URL of the alias contains a wildcard.

Culture

The cultural version of the document that will be displayed when accessing the page through this URL.

URL extensions

Additional supported extensions of the URL. For these to work, you will have to configure the system as described in Configuration of custom URL extensions. This field is optional.

Track campaign

Visitors who access the document through this alias will be assigned to the selected web analytics Campaign and tracked accordingly.

 

For example, a special alias may be created for a document and its URL can then be used by links contained in marketing materials such as banners, e‑mails etc. This way, the system will monitor how many page views the website receives as a result of the campaign and track the activity of the visitors who arrive as a result.

 

The Select button allows you to choose from a list of existing campaign objects available for the website. Edit and New may be used to directly manage campaigns.

 

This field is optional.

 

The NewDocument View all aliases link at the top right of the editing dialog allows you to access a list of all aliases defined on the website (for all documents). This can be useful if there are many aliases used on the site and you wish to manage them from a single location, or in cases where you need information to help avoid URL collisions.

 
More resources can be found in Developer's Guide -> Development -> Page processing and URLs -> Multiple document aliases.