Rewrite Manager

Note: This application is free for testing but redirects will work only under a valid Enonic license.

Rewrite Manager supports two types of providers to manage rewrite rules:

• File - configuration file per a virtual host. With this type of provider redirect rules are defined inside the config file.
• Repository - using this type of provider you can manage redirect rules directly from the application UI. Configuration for each virtual host is stored in the repository called "`com.enonic.app.rewrite`".

If you are using both types of providers for the same virtual host, then File provider will take precedence.

Configuration

To configure this application, place a file called "`com.enonic.app.rewrite.cfg`" inside the configuration directory of your XP instance with the following options:

enabled - this option is used to enable or disable handling the request redirects by application.

includePattern - a RegExp pattern for request URI that should be processed by the application.

excludePattern - a RegExp pattern for request URI that should not be processed by the application.

ruleFileNameTemplate - template of the virtual host configuration filename with rewrite rules. Default template is `com.enonic.app.rewrite.{{vhost}}.conf`, where `{{vhost}}` is a name of a virtual host mapping specified in `com.enonic.xp.web.vhost.cfg`, for instance, `adm`.

By default this application is shipped with the following configuration:

enabled=false
excludePattern=^/admin/.*|.*/_/asset/.*|.*/_/image/.*
includePattern=^/site/.*
ruleFileNameTemplate=com.enonic.app.rewrite.{{vhost}}.conf
 

Usage

Currently the application supports Apache syntax (simplified):

com.enonic.app.rewrite.myvhost.conf

RewriteRule "/oldURL$" "/newURL" [R=301]
RewriteRule "/allUnderThis/(.*)" "/movedToHere/$1" [R=301]
RewriteRule "/kontakt" "/contact" [R=301]
RewriteRule "/avis" "https://rett24.no" [R=302]

If you want to specify a rewrite rule which contains URI-illegal characters, then you have to percent-encode source and target:

RewriteRule "/reparasjon%20og%20vedlikehold%20av%20kj%C3%B8ret%C3%B8y.pdf" "/kj%C3%B8ret%C3%B8y" [R=301]
 

Currently the application uses the following flags implicitly for each rule:

NE - noescape
L - last
NC - nocase
 

Note: Changes to configuration files with rewrite rules won't take effect until the Rewrite app is restarted.