Fed up with IIS not providing permalinks? Don’t have access to the IIS control panel on your host? Then wp-aspxrewriter is for you!
Allowing URLS such as: http://www.pynchon.net/discourse/2008/03/06/24/two-amusing-pynchon-posts.aspx this is the easiest way to enable completely pretty permalinks on IIS 6 or IIS 7.
The plugin consists of two components:
- A standard WordPress plugin.
- An ASP.NET HttpModule.
- Upload the wp-aspxrewriter folder to the
- Upload the URLRewriteModule to your IIS /bin/ directory
- If you are using WordPress 2.3 or 2.4, modify your source code to contain the additional hook that is implemented at https://trac.wordpress.org/ticket/5969 that will feature in 2.5. Hint: it’s in function get_pagenum_link.
- Activate the plugin through the ‘Plugins’ menu in WordPress
- Create your desired permalink structure on Options -> Permalinks, ensuring that it ends with .aspx.
Recommended bases are:
- Navigate to Manage -> ASPX Rewriter in the admin control panel and copy the setup that is shown
Modify or create a web.config file that contains the following under
replacing all the values in
<RewriterRules> with the configuration generated by you in stage 6.
Add the following line to
- Add the following to your web.config under <system.web>:
- Try it out!
How does it work?
That depends on which version of IIS you are using.
In IIS 6 without Integrated Pipeline mode, the request comes in, is matched by the engine which then makes a web request to the correct php page. In IIS 7 proper path rewriting is done and the PHP handler is invoked by IIS.
It doesn’t work with my plugin!
Get in touch and I’ll see what I can do to fix it. This is an early release and has worked in the situations I’ve tested, I can’t guarantee it will in all circumstances.
Contributors & Developers
“ASPX WebRequest Rewriter” is open source software. The following people have contributed to this plugin.