Developer FAQ
The website I am working on is a 'second generation' website where a lot of the 'old URLs' are of importance and should still 'work' after the new Composite C1 site launches. How can I associate 'old URLs' with pages in Composite C1, so visitors using old URLs get redirected to a related C1 page?
Answer:
You may solve this using one of the following tools:
- the "Friendly URL" mechanism in Composite C1
- the C1 add-ons that allows you to remap URLs
- the IIS Rewrite module
- custom 404 pages
The “Friendly URL” approach is by far the simplest and can be 'implemented' by the customers themselves, but there are some restrictions on this approach.
Mapping old URLs using the Friendly URLs
When editing a page you have a field labeled “Friendly URL” on the Settings tab. This field enables the editor to associate a “short URL” to the page and is typically used to create URLs for printed material and other external communication where a short URL like http://docs.c1.orckestra.com/Configuration-FAQ is desired.
If a page is given the Friendly URL “FAQ”, the resulting complete URL is http://docs.composite.net/FAQ - or on multilingual sites http://docs.composite.net/en-US/FAQ where ‘en-US’ is the “URL Mapping Name” of the page language.
The URL Mapping Name for a language can be controlled by editing the language in the System perspective. One (and only one) language can have an empty URL Mapping Name, making friendly URLs look like http://docs.composite.net/FAQ (i.e. no root folder is injected).
A Friendly URL need not be a short string – it could also be “Products/Plungers.php” – adding this to a page would make the URL http://www.contoso.com/Products/Plungers.php go to this page – again - provided that the URL Mapping Name of the pages language is an empty string.
So, in conclusion, customers that only have ‘old URLs’ pertaining to one language can use the Friendly URL feature right out of the box – the only requirement is that the language is configured to use an empty URL Mapping Name.
Please see "Friendly URLs".
Mapping old URLs using C1 add-ons
You can map old URLs to new URLs by using the functionality of one of the following C1 add-ons:
- URL Aliases by CphCloud
Mapping old URLs using the IIS URL Rewrite module
You can also make use of the IIS URL Rewrite module. For more information, please see http://www.iis.net/learn/extensions/url-rewrite-module/using-the-url-rewrite-module
Using custom 404 pages
If you are using the Hostname mappings of the URL Configuration feature in Composite C1, you can use custom 404 pages to catch and handle all the requests to no longer existing pages.
Please see "Hostnames"
Other tools
For advanced URL re-mapping tools, see http://www.helicontech.com/
Please see Creating a URL remapping functionality.