Welcome to FUrlX - Friendly URL registration without client browser javascript requirements.
The standard friendly url module introduced in EPiServer 4.60 relies on clientside javascript to correctly support page postbacks. This may impose a problem for sites that must be accessible from downlevel browsers.
The FUrlX module is available for download, note however that it is unsupported and used at your own risk. The module may be discontinued and/or incorporated into the core EPiServer product without further notice.
How does it work?
The FUrlX assembly contains two webcontrols, basehref and form. These controls are intended to be used on a EPiServer page template.
The form control derives from ASP.Net's HtmlForm so it would simply be a matter of renaming the <form .. > tag to <FUrlX:form .. >
Sample:
<FUrlX:form runat="server" ID="Default" enctype="multipart/form-data" class="centered">
...
</FUrlX:form>
The basehref control simply renders a <base href="..." /> and should be placed somewhere inside your <head> ... </head> block
Sample:
<head runat="server">
...
<FUrlX:basehref runat="server" />
</head>
Download
Installation
- Unzip the contained FUrlX.dll into your EPiServer's /bin folder
Configuration
The below steps indicate the typical configuration needed to enable FUrlX. As every EPiServer installation is unique, these steps may or may not be relevant in your situation. Please see the "How does it work?" paragraph above for more information on how to use FUrlX.
- Remove any existing <EPiServer:FriendlyUrlRegistration runat="server" /> from /templates/units/Header.ascx
- Open /templates/frameworks/DefaultFramework.ascx for editing
(Note, the actual path/filename may be different in your installation)
- Add the below line after the last <%@ Register .. %> line at the top of the file
<%@ Register TagPrefix="FUrlX" Namespace="FUrlX" Assembly="FUrlX" %>
- Add the below tag somewhere between the existing <head runat="server"> ... </head> tags
<FUrlX:basehref runat="server" />
- Modify the existing <form runat="server" ... > tag to:
<FUrlX:form runat="server" .. >
Note, dont forget to also change the closing </form> tag to </FUrlX:form>
- Save the file
- Done
Should you have any questions and/or comments, please email
nospam@localhost
johan.olofssonnospam@localhost
@nospam@localhost
ep.senospam@localhost
.
Copyright (C) EPiServer AB
2010 All rights reserved.
This software is unsupported and provided "as is".
EPiServer AB is not to be held responsible in any way for any damage or loss of income and/or data due to the use of the software.