Ektron 9.00
Creating User-Friendly URLs with Aliasing
Ektron’s URLUniversal Resource Locator aliasing makes it easy to create descriptive, meaningful and SEOSearch Engine Optimization - improving the visibility of search results-friendly URL aliases consistently, maximizing your website’s placement in search results. Use of words and phrases that actually define the page increases an aliases’ search engine rankings. If you follow a pattern, you can scale your aliases across your sites as they grow. Search engines find URL aliases generated by Ektron. Ektron caches aliases to improve performance of your site.
If you have a static website (for example, all HTML pages) that is indexed in a search engine, create aliases for your site and retain complete content management without affecting your search engine ranking.
If you have a PHP"PHP: Hypertext Preprocessor" is a widely-used Open Source general-purpose scripting language that is especially suited for Web development and can be embedded into HTML. Its syntax draws upon C, Java, and Perl, and is easy to learn. The main goal of the language is to allow web developers to write dynamically generated web pages quickly, but you can do much more with PHP. (Source: us2.php.net) site, alias PHP pages and use the same query string names to pass needed information to the new .aspx pages.
NOTE: Query strings appended to an aliased page pass to the .aspx page and may be used if necessary.
Existing sites migrate easily to Ektron, adopting the new aliasing scheme. Aliasing keeps old links valid and you do not have to make changes to web.config
. When URL aliasing is configured and enabled, content inherits the new aliasing structure.
The following link, Creating User-friendly URLs with Aliasing, is a video that explains the various types of URL aliases.
www.example.com/steve
.
www.example.com/cars
.
www.bionics.com
address and the new www.newgen.com
address. See Creating a URL Alias for a Site . Before you can set up aliases, you must enable the feature using the URL Aliasing Settings screen. Choose Workarea > Settings > Configuration > URL Aliasing > Settings. Then, click Edit.
IMPORTANT: If you performed a database sync and the site being synchronized uses URL aliasing, you must go to its URL Aliasing Settings screen and click Clear Cache () to update its aliasing information. Also, If you enable or disable any alias type or caching, you must run a full crawl of your Search Server. See Also: Managing the Search Crawl
Do not add any extension entered into the Handler Mapping list. See Restrictions on Extensions
The values in this field appear as drop-downs in the Add a New Manual Alias and Add a New Automatic Alias screens.
www.example.com/dynamic.aspx
. If this happens, and a site visitor types such an address into the browser, this check box determines if the template page or the alias appears. If this box is checked, the alias appears instead of the template.NOTE: The template must be defined within the Workarea Settings > Template Configuration screen.
alias’s query string parameter:
http://www.ektron.com/Contact.aspx?id=84
Target: http://www.ektron.com/aboutus.aspx?id=35&Userid=1
Result: http://www.ektron.com/aboutus.aspx?id=84
(The target parameters id=35&Userid=1
are replaced by the alias parameter id=84
)
Alias: http://www.ektron.com/Contact.aspx?id=84&lang=1033
Target: http://www.ektron.com/aboutus.aspx?id=35&Userid=1
Result: http://www.ektron.com/aboutus.aspx?id=35&Userid=1 & id=84&lang=1033
(The parameter from the alias is appended to the target)
alias’s query string parameter:
http://www.example.com/Contact.aspx?id=84
Target: http://www.example.com/aboutus.aspx?id=35&UserId=10
Result: http://www.example.com/aboutus.aspx?id=84&UserId=10
(id=35
is replaced by id=84
since it matched the query string parameter. UserId=10
was not affected because it did not match the alias query string parameter.)
You can set the default document file (for example, default.aspx
) in the ek_DefaultPage
element of siteroot/web.config
for client requests of a website that did not specify a document name. For example, if someone types www.example.com/jobs
, and the default document is default.aspx
, this URL resolves to www.example.com/jobs/default.aspx
.
NOTE: The concept of default document is explained in the following Microsoft KB article: Configure the List of Default Documents in IIS 7
The ek_DefaultPage
element determines your website’s default document regardless of whether you are using URL aliasing.
If a site visitor enters an address without a page name, Ektron refers to ek_DefaultPage
’s values. For example, the first page is default.aspx
. If found, that page displays. If not, it looks for the second page listed, and so on. If no pages are found or a page is not specified in ek_DefaultPage
, Page not found appears in browser.
NOTE: By default the Alias-Author role is applied to the Everyone group. This role can however be removed to further restrict the permissions to the CMS User state.
Task |
Alias-Admin |
Alias-Author | CMS User |
---|---|---|---|
View Settings Page | |||
Edit Settings | |||
View Rule List Pages | |||
View Rule | |||
Edit Rules | |||
View Alias List Page | |||
View alias | |||
Add Aliases | |||
Edit Alias | |||
Delete Alias | |||
View Redirects Page | |||
Edit Redirects Page | |||
View Alias on content tab | |||
Edit Alias on content tab |
IMPORTANT: After you enable Aliasing, relative links embedded in your Web pages that are not preceded by a slash (/) may demonstrate symptoms such as runtime error notifications, broken images (you see a red X where the image should be), or missing text styling. The following Ektron Knowledge Base article analyzes this problem and presents solutions: Avoiding Style Problems, JavaScript Errors, and Broken Images When Using URL Aliasing.
You cannot apply aliasing to the following areas of Ektron.
TemplateProduct
property. If you assign a page, it is used in the product’s URL, not the alias.If a site visitor hovers the cursor over HTML content, the alias does appear.
IIS7Internet Information Services (IIS) for Windows® Server, version 7 handles Web page extensions other than .aspx. There are 2 scenarios.
NOTE: After you do this, you cannot use these extensions as part of an alias. So, do not enter them into the Extension field of the URL Aliasing Settings screen.
An alias is cached whenever anyone uses it. You should periodically clear the cache so that aliases are kept current.
IMPORTANT: If your Ektron supports multi-site configurations, you must sign in to each site’s Workarea, then manually clear its cache.
When a site visitor selects a language for viewing your site and enters the alias, Ektron displays the aliased content in the selected language. See Also: the Enable Language Awareness field in Configuring URL Aliasing.
You can assign a different alias to each language version of content. To do this, select the content, language, go to the Alias tab, and assign a language-specific alias. For example, your English home page’s alias is default, while your Spanish alias is defecto.
Also, alias names must be unique only within a language. So, for example, you cannot have 2 aliases named Ektron
within U.S. English content. But, you can have 2 two aliases namedEktron
if one is applied to U.S. English content, and the other applies to Spanish content.
You can have many aliases. Ektron lets you sort and filter the aliases to make it easy to isolate a subset of aliases, to work on, activate, deactivate, delete, and so on. The Aliases screen (Workarea > Settings > Configuration > URL Aliasing > Aliases) has the following features for filtering. You can combine these filters to narrow your focus.
You can choose a page name that makes complex URLs easier to read and remember. For example, you can create an alias for www.example.com/help.aspx?id=27
that resolves to www.example.com/help.htm
. From then on, the content can be identified either by its original URL or its alias. You can create any number or aliases for a content block.
NOTE: You cannot apply an alias to the root website. For example, you cannot alias www.example.com
with www.example2.com
. However, you can alias anything below the root folder.
On multi-site environments, you can apply an alias to a folder on the root site, or to a folder on other sites, but not both. For example, you can have the alias content.aspx
applied to a root-folder, but then the content.aspx
alias cannot be used on a site-folder at the same time. However, if you apply content.aspx
to site1-folder, you can also apply content.aspx
to site2-folder.
To activate or disable manual aliasing, choose Settings > Configuration > URL Aliasing > Settings. The URL Aliasing Settings screen appears, which indicates if manual aliasing is on or off. To change its state, click Edit, check or uncheck the box, and click Save.
To view a manual URL alias:
To add or edit a manual alias, manual aliasing must first be enabled.
NOTE: If there are many aliases, use the search to find one. You can filter by alias name, Content ID, and so on.
NOTE: After you enable manual aliasing, every content block includes an Alias tab. You can create a new alias by clicking Add Manual Alias from that Alias tab. However, if you insert/update an alias from the Alias tab, the alias is available only after you publish the content.
Also, a folder may require its content to have a manual alias. In this case, you must add a manual alias before you can check in or submit content.
(comma), (space), \, <, >, “, :, |
.Alias: http://www.ektron.com/Contact.aspx?id=84&lang=1033
Target: http://www.ektron.com/aboutus.aspx?id=35&Userid=1
Result: http://www.ektron.com/aboutus.aspx?id=35&Userid=1 | & id=84&lang=1033
(The parameter from the alias is appended to the target)
Query string parameter: http://www.ektron.com/Contact.aspx?id=84
Target: http://www.ektron.com/aboutus.aspx?id=35&Userid=1
Result: http://www.ektron.com/aboutus.aspx?id=84
(The target parameters id=35&Userid=1 are replaced by the alias parameter id=84)
Query string parameter: http://www.example.com/Contact.aspx?id=84
Target: http://www.example.com/aboutus.aspx?id=35&UserId=10
Result: http://www.example.com/aboutus.aspx?id=84&UserId=10
(id=35
is replaced by id=84
because it matched the query string parameter. UserId=10
was not affected because it did not match the alias query string parameter.)
?gclid=CO7gs_L0_ZICFRkTIgodBgV9CQ
. Your website's analytics software can track the source of the query through the variable.NOTE: Within the page load event that returns the query string parameters, use the Request.RawURL()
property instead of request.querystring
.
NOTE: Content choices are affected by value of the Language field on the Add Manual Alias screen. Only content in the language of the selected alias appears. Also, only approved content appears.
NOTE: A folder’s content appears below its subfolder list. You may have to scroll down to see the content.
Automatic aliasing lets you create rules for several types of CMS entities, based on taxonomya content-level categorization system that uses one-to-many relationships (such as Ronald Reagan is to Actor, Governor, and President) to create a scalable organization of content. A taxonomy lets your site visitors navigate content independent of the folder structure., folder, user, or group designations. You can select additional elements of the alias pattern and save all information as a configuration. Because you can assign a single content block to several taxonomies, that content block can have many automatic aliases. When you activate an automatic alias configuration, any content added to the taxonomy, folder, user, or group in the future is assigned that alias (as long as the configuration is active).
To enable automatic aliasing, choose Settings > Configuration > URL Aliasing > Settings. The screen indicates if automatic aliasing for taxonomy, folder, community user, and community group is on or off. To change the state for any of these, click Edit, then check or uncheck the box, and click Save.
To view an automatic URL alias assigned to a content item, go to a content item and view the content, then click the Alias tab. Manual aliases appear near the top, followed by any automatic aliases.
Automatic URL alias pattern combines the following elements—separated by a slash (/)—in the following order.
www.example.com/Medical_Conditions/Kidney_Disease/
.www.example.com/CMS400Developer/CMS400Demo/About_Us/Company_Profile/Board_of_Directors.aspx
. You can determine which path components appear in the Customize Alias Path field on the Add Aliasing Rule screen.http://www.example.com/Marketing/
. http://<website>/John/
Spaces are replaced by the replacement character.
NOTE: Aliases must be unique. If you try to create a duplicate alias, a value is appended to the alias to make it unique.
Examples:
Folder-based automatic alias
Suppose that you assign an automatic folder alias called “History” to the MainSite/Content/Company/Company_News/
folder and you specify the additional rule that excludes some of the folder path from the URL. When you create NewHistoryEvent.aspx
and put it in the Company_News
folder, it has the following URL automatically generated:
www.example.com/Company_News/New_History_Event.aspx
Taxonomy-based automatic alias
Suppose that you create a new job posting called SalesAdministrator and give it the Administration and Sales taxonomy categories.
SiteNavigation Company Jobs [x] Administration [x] Sales [ ] Marketing [ ] Engineering [ ] Support
A taxonomy-based alias automatically generates the following URLs based on the taxonomy selections:
www.example.com/Jobs/Sales/SalesAdministrator www.example.com/Jobs/Administration/SalesAdministrator
User-based automatic alias
A user alias can simplify a reference to someone’s profile page.
www.example.com/member/steve
Group-based automatic alias
A group alias can simplify a reference to a group page.
www.example.com/group_interest/sports_cars
NOTE: Activity streams, SMSShort Message Service (SMS); used for texting., and email notification messages that include links to users or community groups use the community URL alias in their links. If you want to show the template alias, use the proper token in the message. For example, to use the alias for the SubjectUser, use the @SubjectUser.TemplateAlias@
token in your message. See Also: Working with Tokens.
If you enable a user-based community alias, community users display their alias name on their profile's Profile Links tab.
Similarly, if you enable a group-based community alias, community groups display their alias name on the profile's Links tab.
After enabling automatic URL aliasing, you can create rules in a configuration, which lets you
NOTE: You cannot create a configuration whose values match an existing one.
WARNING! If you uncheck this box, automatic aliases set up using this configuration are deleted from the associated content.
/CMS400Demo/About Us/Careers
, you can choose any option from the drop-down menu to indicate the folder or taxonomy path in the automatic alias pattern. Sample Content Block
30
30/1033
Do not add any extension entered into the Handler Mapping list. See Restrictions on Extensions
content.aspx?id=123
). Taxonomy Template can have its own template assigned to the taxonomy node. When creating the automatic alias, this setting indicates which template to use for the target URL. Quicklink uses the behavior just described. Taxonomy Template uses the template assigned to the designated taxonomy along with the querystring parameters from the Quicklink. For example:content.aspx
taxtemplate.aspx
/content.aspx?id=123
/content.aspx?id=123
/taxtemp.aspx?id=123
taxid
. Here is an example of the parameter in a URL: http://localhost/eIntranetv2/Blogs.aspx?id=238&blogid=115&taxId=28
IMPORTANT: Do not enter id
here because that will clash with the content id.
Do not enter more than one parameter.
About Us
, and you enter an underscore (_) here, the aliased version of the title is About_Us
. Specify other replacement characters in the Replacement Character Map section.You cannot enter one of the following as the replacement character: [, \ / < > (Space): |? '] # * &%
NOTE: If you're using IIS Admin, and specify a plus sign (+), you get this error: HTTP Error 404.11 Not Found The request filtering module is configured to deny a request that contains a double escape sequence
. For a solution, see Error message when you visit a website that is hosted on IIS 7.0: "HTTP Error 404.11 – URL_DOUBLE_ESCAPED".
If you deactivate an automatic alias configuration, automatic aliases created by that configuration are removed from content to which they are applied. The configuration is saved, so you can reactivate it.
If you delete an automatic aliasing configuration, automatic aliases are removed from content to which they are applied.
WARNING! No confirmation message appears when you save the Automatic Aliasing Rules screen, so be deliberate when checking the Delete boxes.
If you do not see the community alias when you hover over or click a link to a community group or user, check the following.
TemplateUserProfile
setting. If it does, that value takes precedence over the URL alias.A RegExregular expression; an alias that creates a pattern. For example, blogs.aspx?blogmonth=3&blogyear=2012&blogid=41 can be a RegEx blogs/2012/03/41. From that, a site visitor can infer blogs/2012/03/40 to see the previous post, or enter blogs/2012/03 to see all March 2012 posts lets site visitors enter a descriptive URLUniversal Resource Locator into the browser address field and transform that entry into the query string component of an Ektron page. This lets site visitors “guess” other pages based on a recognizable pattern. For example, a RegEx expression aliases blogs.aspx?blogmonth=3&blogyear=2013&blogid=14
as blogs/2013/03/14
. From that, a site visitor can infer that blogs/2013/03/13
would display the previous post, and blogs/2013/03
would display March 2013 posts, and so on.
To view a RegEx, go to Workarea > Settings > Configuration > URL Aliasing > Aliasing Rules > RegEx, then click the expression that you want to view.
http://ecmintranet/blogs.aspx?blogmonth=3&blogyear=2013
www.example/com/blogs/2013/03/14 to access a blog page even though the actual URL is www.example/com/blogs/blogs.aspx?blogmonth=3&blogyear=2013&blogid=4
$1
, $2
, and so on.) in the Expression map. If you want to insert a question mark into the Expression, you must precede it with a backslash (\). $1
, $2
, and so on. As a result, a site visitor can identify other pages that use this pattern by changing the variable values. You can click Expression Library to view sample RegEx expression maps. To copy any map that resembles your page pattern, click it then modify it.As another example, you can create a pattern without knowing in advance what URL a user may type, using a querystring
variable. When a user types:
www.example.com/catalog/search/christmas
The alias can use a querystring
variable after catalog/search/
to see if content is available in the catalog using the following aliased URL:
www.example.com/catalogsearch.aspx?term=christmas
This field enhances the aliasing feature's response time—it first tries to match a site visitor’s entry with high priority expressions, then medium, then low.
If your site supports the multi-site feature, you can enter aliases for any site. For example, suppose that your company changed its name from Bionics to NewGen, but the content of your site remains essentially the same. By adding a site alias, along with appropriate DNS mappings and domain registration, customers can still get to your site with the bionics.com
URL and now also with the new company URL newgen.com
.
Note the following conditions for creating a site alias:
ser4325/min
), you must add the subfolder to the alias. For example, you could not enter http://www.myalias.com
as an alias for that site. Instead, enter http://www.myalias.com/min/
.www.example.com
with www.example2.com
. However, you can alias anything below the root folder. On multi-site environments, you can apply an alias to a folder on the root site, or to a folder on other sites, but not both. For example, you can have the alias content.aspx
applied to a root-folder, but then the content.aspx
alias cannot be used on a site-folder at the same time. However, if you apply content.aspx
to site1-folder, you can also apply content.aspx
to site2-folder.NOTE: The alias cannot end with a slash (/).
From now on, if a site visitor enters the alias into a browser address field, he is redirected to the site URL (set on the folder properties tab’s Production Domain field).
You may have an old or original URL that you want to continue to work after you have moved the content to a new URL. So, you create a URL redirect from an original URL to a new URL, essentially leaving a "forwarding address" to a new URL. For example, you can redirect an previously known link (/OnTrek/default.aspx
) to a new one (http://www.example.com/home/
).
NOTE: When adding a redirect, the 404 target URL field is optional. If you do not provide a target URL,a 404 error is handled by the configuration in either the web.config
or IIS.
IMPORTANT: Create separate 301 redirects for your http:// and http://www versions of your website. They are considered separate URLs.