Introduction

Installation procedure

Initial configuration

Create a redirection rule

Redirection rule features

Supported macros

Pages 404

Errors

Referers

Plugin settings

Examples and solutions to common problems

Changelog

ReDJ extension has just one package to download and install. The package includes a component and a plugin, and supports the installation with "upgrade" mode, so there’s no need any more to uninstall any previous version of ReDJ.

To install ReDJ, login to Joomla backend as administrator, and go to menu "Extensions manager". Click the browse button, select the package file (ReDJX.XCommunity.zip or ReDJX.XEnterprise.zip) and click the installation button.

That’s all. Now we are ready to start using ReDJ.

Upgrade procedure

When upgrading from a previous version of ReDJ, there is no need to first uninstall the old package. As mentioned earlier, ReDJ supports the "upgrade" mode for the installation, so it is enough to just install the new package over the old one, both component and plugin will be upgraded.

Note that during the upgrade also the database tables are upgraded when needed, but without to delete or loose any table data. It is in charge of the installation process to upgrade tables structure as needed. All the rules will be preserved.

ReDJ is a Joomla native extension that allows to efficiently manage URL redirection. This is very useful for creating URL aliases, and managing redirects from an old URL to a new one. A very similar extension has been added into Joomla since version 1.6, but ReDJ supports powerful regular expressions that allow to match more than one source URL. In this way it is possible to create a group of redirects with just one ReDJ rule.

ReDJ also supports usage of "macros" in the destination URL. A macro is like a function whose value is calculated at runtime (when the rule matches an URL). There are a loto of macros available and this allows to create dynamic destinations, with a different redirection for each source URL. To increase flexibilty in the building of dynamic destinations, also "placeholders" are supported. A placeholder is like a variable whose value can be assigned using text, macros or other placeholders, and can be used to build the destination.

Another great ReDJ feature is the configurable redirection type for each item, with support for 301 (Moved Permanently), 307 (Temporary Redirect) and also 200 (Internal Redirect) (available for Enterprise version only). With the Internal Redirect is now possible to create a "real" URL alias with Joomla.

Last but not least, there are many other features available, such custom error pages, error tracing, referer tracing and so on, that can dramatically improve your SEO ranking. We will describe each one in detail in the next part of this guide. In the following paragraphs we will also learn how to make better use of regular expressions, macros and placeholders to take full advantage from ReDJ.

How it works

ReDJ package includes a component for managing list of redirection rules, and a plugin that examines all the requests and redirect them to a different page when needed by an active rule. These are the main steps to start using ReDJ (for the impatient):

1. Install the package using Joomla Administration interface;
2. Enable the plugin "System - ReDJ" and set its ordering and other parameters;
3. Use ReDJ component to manage redirects, errors and referers.

Detailed instructions on each step are described in the following paragraphs. In this section we just want to focus on some basic concepts related to ReDJ and how it works.

The first important thing to understand is the "rule" concept. With ReDJ Manager (the component interface) you can create as many items as you want, and each item is a redirection rule. But not necessarily an item corresponds to a single page (i.e. matches just a single URL).

A rule has a "From URL" field that can be full URI or just a part of it. For example, it can be "/home.html", then this rule matches both the URL http://www.mysite.com/home.html and http://www.mysite.com/orders/home.html?view=status. So, it means that with a single rule is possible to match multiple source URLs. But the content of the "From URL" field can be a regular expression, and this provide a powerful way to specify complex search patterns for matching URL. The "Skip" field is similar to From URL", it can be a part of URL and contains a regular expression, but it offers a way to skip the rule. When the skip condition matches the rule is discarded. In the next paragraphs will be shown many regular expression examples.

For any request on the site, the ReDJ plugin compares the requested URL with all the rules enabled in the ordering set for rules. The first matching rule found (if there's at least one) is used for redirect.

ReDJ is a native extension (component + plugin) available for Joomla that allow to manage URL redirections. This is very useful for creating URL aliases, and managing redirections from an old URL to a new one. A very similar extension has been added into Joomla since 1.6 version (Redirect component), but ReDJ supports powerful regular expressions that allow to match more than one source URL. In this way it is possible to create a group of redirections with just one ReDJ item. It's so easy.

Also, now ReDJ comes with support for macros into destination URL. This means that from now the destination URL can be dynamic.

Finally, an "internal redirect" feature has been added (Enterprise version only). With these features now is possible to create "real" URL alias with Joomla.

There are two versions of ReDJ, Community and Enterprise, both released under GPL license. The Community version is completely free, while the Enterprise version has a little subscription fee, but introduces some advanced features. Here's a comparison matrix between Community version and Enterprise version:

Features	ReDJ Community	ReDJ Enterprise
Intercept and redirect any error 404 URL
Support for 301 (Moved Permanently)
Support for 307 (Temporary Redirect)
Support for 200 (Internal Redirect)
Use of regular expressions to specify matching source URLs
Case-sensitive option on the matching source URLs
Request only option to match the full URL or just the REQUEST_URI part
Decode URL option to decode URLs before to check if match with rule
Support for skip rule condition
Support for skip usergroup condition
Support for placeholders
Option to apply a rule only in case of error
Possibility to add a note for each item
Use of macros to specify destination URL (dynamic destination URLs)	(42 macros)	(54 macros)
Custom error page
Use of macros to customize error page	(6 macros)	(6 macros)
Trace redirections with hits counter and info about last visit
Trace custom error page with hits counter and info about last visit
Trace errors with hits counter and info about last referer and time
Trace referers for each visited URL with hits counter and info about last visit
Configurable list of referers to exclude from trace with macro support	(2 macros)	(2 macros)
Option to redirect any error 404 URL to a custom page
Option to shortcut extensions directly on the error page
Option to set a global base path (easy items portability)
License	GPL 2.0	GPL 2.0
Price	Free	9 €