#10

Product support

Get help in the plugin support forum.

Categories

  • Marketing
  • Utility

Adrenth.Redirect

The #1 Redirect plugin for October CMS (Editors' choice)

This is the best Redirect-plugin for October CMS. With this plugin installed you can manage redirects directly from October CMS' beautiful interface. Many webmasters and SEO specialists use redirects to optimise their website for search engines. This plugin allows you to manage such redirects with a nice and user-friendly interface.

What does this plugin offer?

This plugin adds a 'Redirects' section to the main menu of October CMS. This plugin has a unique and fast matching algorithm to match your redirects before your website is being rendered.

DEMO

http://demo.alwindrenth.nl/backend

Username: demo

Password: demo

Features

  • Quick matching algorithm
  • A test utility for redirects
  • Matching using placeholders (dynamic paths)
  • Match placeholders using regular expressions
  • Exact path matching
  • Importing and exporting redirect rules
  • Schedule redirects (e.g. active for 2 months)
  • Redirect to external URLs
  • Redirect to internal CMS pages
  • Redirect log
  • Categorize redirects
  • Statistics
    • Hits per redirect
    • Popular redirects per month (top 10)
    • Popular crawlers per month (top 10)
    • Number of redirects per month
    • And more...
  • Multilingual (Need help translating! Contact me at [email protected])
  • Supports MySQL, SQLite and PostgreSQL
  • HTTP status codes 301, 302, 303, 404, 410
  • Caching

Supported database platforms

  • MySQL
  • PostgreSQL
  • SQLite

Supported HTTP status codes

  • HTTP/1.1 301 Moved Permanently
  • HTTP/1.1 302 Found
  • HTTP/1.1 303 See Other
  • HTTP/1.1 404 Not Found
  • HTTP/1.1 410 Gone

Supported HTTP request methods

  • GET
  • POST
  • HEAD

Performance

All redirects are stored in the database and will be automatically "published" to a file which the internal redirect mechanism uses to determine if a certain request needs to be redirected. This is way faster than querying a database.

This plugin is designed to be fast and should have no negative effect on the performance of your website.

To gain maximum performance with this plugin:

  • Use PHP7 (really you should), this increases the performance with 200%
  • Enable redirect caching using a "in-memory" caching method (see Caching).
  • Maintain your redirects frequently to keep the number of redirects as low as possible.
  • Try to use placeholders to keep your number of redirect low (less redirects is better performance).

Caching

If your website has a lot of redirects it is recommended to enable redirect caching. You can enable redirect caching in the settings panel of this plugin.

Only cache drivers which support tagged cache are supported. So driver file and database are not supported. For this plugin database and file caching do not increase performance, but can actually have a negative influence on performance. So it is recommended to use an in-memory caching solution like memcached or redis.

How caching works

If caching is enabled (and supported) every request which is handled by this plugin will be cached. It will be stored with tag Adrenth.Redirect.

When you modify a redirect all redirect cache will be invalidated automatically. It is also possible to manually clear the cache using the 'Clear cache' button in the Backend.

Placeholders

This plugin makes advantage of the symfony/routing package. So if you need more info on how to make placeholder requirements for your redirection URLs, please go to: https://symfony.com/doc/current/components/routing/introduction.html#usage

Contribution

If you like this plugin translated to your language, please contribute. The repository for the language files can be found here: https://github.com/adrenth/redirect-lang

Questions? Need help?

If you have any question about how to use this plugin, please don't hesitate to contact me. I'm happy to help you. You can also visit the support forum and drop your questions/issues there.

Kind regards,

Alwin Drenth -- Author of the Redirect plugin


If you love this quality plugin as much as I do, please rate my plugin, contribute or consider a PayPal donation to support this plugin and my other quality October CMS plugins.


Other plugins by Alwin Drenth

HtmlPurifier

HtmlPurifier - Adds a standards compliant HTML filter to October CMS.

RssFetcher

RssFetcher - Fetches RSS/Atom feeds from different sources to publish on your website or dashboard.

Statistics

Adrenth.Redirect documentation

This plugin should be easy to understand if you are familiar with the basics of the web. If you have issues setting up some redirects, please do not hesitate to contact me.

Redirect types

This plugins ships with two types of redirects:

  • Exact; performs an exact match on the Source path.
  • Placeholders; matches placeholders like {id} or {category} (like the defined routes in Symfony or Laravel framework).

Redirect target types

This plugin allows you to redirect to the following types:

  • An internal path
  • An internal CMS Page
  • An internal Static Page (RainLab.Pages plugin)
  • An external URL

Scheme matching

This plugin allows you to match requests from a http:// scheme to a https:// scheme and vice versa.

Placeholders

Every placeholder can be attached to a requirement. A requirement consists of a placeholder, requirement and an optional replacement value.

Example:

Input path:
/blog.php?category=cat&id=145

Source path: 
/blog.php?category={category}&id={id}

Target path:
/blog/{category}/{id}

Result path:
/blog/cat/145
  • The requirement for {category} would be: [a-zA-Z] or could be more specific like (dog|cat|mouse).
  • The requirement for {id} would be: [0-9]+.

Replacement value

A requirement can also contain a replacement value. Provide this replacement value if you need to rewrite a certain placeholder to a static value.

Example:

The requirement for {category} is (dog|cat|mouse), with replacement value animals.

Input path:
/blog.php?category=mouse&id=1337

Source path: 
/blog.php?category={category}&id={id}

Target path:
/blog/{category}/{id}

Result:
/blog/animals/1337

Result in TestLab:

Redirect Target

You can select a CMS Page as a Redirect target. Placeholders are supported. Let's assume there is a page 'Blog' with the following URL: /blog/:category/:subcategory.

It is possible to create a Redirect with placeholders that has this CMS Page as a target:

Redirect with:
Source: `/blog.php?cat={category}&subcat={subcategory}`
Placeholders: {category}, {subcategory}
Target: CMS Page `Blog`

Request path: /blog.php?cat=news&subcat=general
Result: /blog/news/general
  • Found the plugin useful on 12 Jun, 2017

    Perfect when you come from TYPO3!

  • Found the plugin useful on 2 Jun, 2017

    The support for this plugin is top-notch! I had an issue with my PostgreSQL database and Alwin responded to me and fixed the issue in no time. Plugin works great and saves me a lot of headaches for handling all the redirects. This plugin is a must have.

  • Found the plugin useful on 15 Mar, 2017

    Thanks for the plugin. Its easy to use and works like a charm. I don't use the statistic page that much but the design looks modern and comfortable. Also the feature to export and import stuff is very cool.

    Worth it!

  • author

    Replied on 15 Mar, 2017

    Hi Alexander,

    As of version 3.3.0 you can disable statistics completely, but also TestLab (beta) and logging can be disabled. Head over to the Settings section in OctoberCMS.

  • Found the plugin useful on 14 Mar, 2017

    Great plugin, helped me a lot because I redesigned an old website, and now using the plugin to redirect hits to old links to new ones. Super useful.

  • Found the plugin useful on 25 Jan, 2017

    The Github repository seems to have been made private or deleted. This broke our composer builds. Can we expect it to come back or should we use a fork from now onward?

  • Found the plugin useful on 11 Jan, 2017

    Wow!

  • Found the plugin useful on 11 Jan, 2017

    Great userful plugin!

  • author

    Replied on 11 Jan, 2017

    .

  • Found the plugin useful on 21 Nov, 2016

    Great plugin with many options and swift support!

  • Found the plugin useful on 6 Oct, 2016

    Good plugin, works great and good doc's! Big respect for this.

  • Found the plugin useful on 29 Aug, 2016

    Was using the nginx config to handle redirects before this plugin. Migrated servers over at one point and totally lost all of my redirects - drove me insane.

    Having it managed inside of the website now is much better. This plugin couldn't be more simple to use and it is also nice now knowing how many times the URL has been accessed. This is one of those few "must have" plugins for OctoberCMS - Keep up the awesome work!

  • Found the plugin useful on 25 Jul, 2016

    Great plugin and very fast support. I needed redirect handling relative to the october installation path (installation was in a subdirectory) and the author provided it within a day.

  • Found the plugin useful on 25 Jul, 2016

    Great plugin for projects where you want to use redirection.


    Отличный плагин для проектов, где требуется использовать редирект.

  • Found the plugin useful on 24 Jul, 2016

    This is an essential plugin if you need to manage lots of redirects easily. The features work great, are easy to use and the support is excellent - the plugin author responded to my issue almost instantly and issued a bugfix release on the same day. I highly recommended this plugin.

  • Found the plugin useful on 27 Apr, 2016

    A very complete and essential plugin for OctoberCMS. It contains all the features you'd except for a Redirect plugin.

  • Found the plugin useful on 7 Apr, 2016

    I like this plugin a lot. Keep up the good work!

  • Found the plugin useful on 28 Mar, 2016

    Awesome plugin. Works as advertised and looks great too.

  • Found the plugin useful on 25 Mar, 2016

    This is a must have plugin.

    Just remember, you must Publish the redirects in order for them to work, and you should only specify the /url not the http://www.webiste.com/url.

    OctoberCMS is getting better every day!

    Thank you Alwin!

  • author

    Replied on 25 Mar, 2016

    Hi Daniel. I've added some UI improvements to make things more understanding.

    Also added a test tool so you can test your redirect before publishing them. See the updated version 1.0.3.

    Please keep me updated about your experiences. Love to hear about it.

3.15.0

Improve code and redirect handling logic

Jul 05, 2017

3.14.1

Fix issue with cache key (if caching is enabled)

Jul 02, 2017

3.14.0

Fix PosgreSQL compatibility issues and minor code improvements

Jun 02, 2017

3.13.0

Minor UI improvements and bugfixes

May 22, 2017

3.12.0

Add new plugin icon for main navigation

Apr 29, 2017

3.11.0

Performance improvements to statistics Dashboard

Apr 28, 2017

3.10.3

Minor improvements to settings screen and plugin documentation

Apr 22, 2017

3.10.2

Fix issues related to unvalidated imported redirects

Apr 13, 2017

3.10.1

Fix issue when creating redirect with unsupported cache driver

Apr 13, 2017

3.10.0

Add Bulk actions (delete / enable / disable all redirects)

Apr 11, 2017

3.9.1

Minor code and documentation changes

Apr 10, 2017

3.9.0

Add redirect caching (enable in Plugin settings section)

Apr 08, 2017

3.8.0

Add Top 10 Redirects widget for Dashboard

Apr 06, 2017

3.7.1

Update French (fr) translation (merci Pierre-André Vullioud)

Apr 04, 2017

3.7.0

Improve Import and Export of Redirects (also fixes several reported issues)

Apr 04, 2017

3.6.0

Add a quick Create Redirect widget for Dashboard

Apr 03, 2017

3.5.4

Small fixes and UI improvements

Apr 02, 2017

3.5.3

Fix CSV reader issues after updating to 3.5.0

Mar 27, 2017

3.5.2

Add Dutch (nl) translation (dank je Arnoud van Susteren)

Mar 27, 2017

3.5.1

Fix MySQL query issue on Statistics dashboard (sql_mode=ONLY_FULL_GROUP_BY)

Mar 27, 2017

3.5.0

Add scheme matching HTTP <-> HTTPS (advanced)

Mar 23, 2017

3.4.0

UI Improvements and bugfixes

Mar 14, 2017

3.3.0

Add Redirect settings (see Settings > Misc > Redirect) and minor fixes

Mar 12, 2017

3.2.0

Improvements to Statistics dashboard

Mar 08, 2017

3.1.2

Fix redirect schedule issue

Mar 07, 2017

3.1.1

Resolves PHP 5.6 compatibility issues and other minor fixes

Mar 07, 2017

3.1.0

Add TestLab (beta); allows you to mass test your redirects

Mar 07, 2017

3.0.0

New major version; license change and as of now a paid plugin

Jan 27, 2017

2.0.24

Minor fixes and code optimization

Jan 20, 2017

2.0.23

Add missing query part of the URL when creating a Redirect from Request Log

Jan 19, 2017

2.0.22

Add Russian language and fix backend menu navigation issue (спасибо sheck87)

Jan 19, 2017

2.0.21

Add HTTP status code 303 (See Other) (requested by ayumihamsaki) and some small fixes.

Jan 17, 2017

2.0.20

Add HTTP status code 410 (Gone) (requested by jan-vince)

Jan 16, 2017

2.0.19

Fix SQLite compatibility issues (thanks jan-vince)

Jan 12, 2017

2.0.18

Add redirect statistics (WIP) (please submit your ideas!)

Jan 10, 2017

2.0.17

Minor fixes and code optimization

Jan 10, 2017

2.0.16

Add spanish language (gracias arzola)

Dec 07, 2016

2.0.15

Add redirect log

Dec 02, 2016

2.0.14

Automatic (system) redirect creation when Static Page or CMS Page URL changes

Nov 25, 2016

2.0.13

Language update (sv) and Postgres compatibility

Nov 23, 2016

2.0.12

Fixes some issues and add ability to reset redirect statistics

Nov 23, 2016

2.0.11

Add categories for categorizing redirects. And added swedish language (tack Hambern)

Nov 22, 2016

2.0.10

Fixes critical issue with writing redirects file (thanks jan-vince)

Nov 21, 2016

2.0.9

Reduce logging entries for "Route not found" on placeholder redirects

Oct 24, 2016

2.0.8

Database maintenance. Updated all timestamp columns to be nullable.

Oct 11, 2016

2.0.7

Fix uninstall issue

Jul 25, 2016

2.0.6

Fix path issues with redirects when OctoberCMS installed in a subdirectory

Jul 24, 2016

2.0.5

Fix issue with URL character encoding source path

Jul 22, 2016

2.0.4

Database fixes and fixed issue with publishing redirects

Jul 12, 2016

2.0.3

Add functionality that allows you to create redirects from Request Log items (feature-request by pvullioud)

Jul 08, 2016

2.0.2

Support for Static Pages (RainLab.Pages)

Jul 08, 2016

2.0.1

Added French language (thanks pvullioud) and small improvements/fixes

Jul 07, 2016

2.0.0

!!! New major version with lot of new features (Use only with OctoberCMS stable)

Jul 04, 2016

1.1.3

Add PhpUnit tests and minor improvements

May 23, 2016

1.1.2

Fixes a bug for scheduled redirects

Apr 27, 2016

1.1.1

Fixes a bug that occured while editing a redirect (thanks lorajc)

Apr 27, 2016

1.1.0

!!! Add support for redirection to a CMS Page (re-publishing redirects is required)

Apr 25, 2016

1.0.13

Add 404 status code (link spamming)

Apr 11, 2016

1.0.12

Fixes/improvements and support for Laravel 5.1

Apr 07, 2016

1.0.11

Improve language file and messages

Apr 05, 2016

1.0.10

Small fixes

Apr 03, 2016

1.0.9

Fixes issue with installing update 1.0.9

Apr 03, 2016

1.0.8

Improvements to code base

Apr 03, 2016

1.0.7

Improve UI for managing redirects

Mar 31, 2016

1.0.6

Some fixes and add scheduling support for redirects

Mar 31, 2016

1.0.5

Add support for importing and exporting redirects

Mar 27, 2016

1.0.4

Add more improvements and fixed some bugs

Mar 27, 2016

1.0.3

Add several UI improvements and added a redirect tester!

Mar 25, 2016

1.0.2

Add extra checks for published redirect file

Mar 25, 2016

1.0.1

First version of Redirect

Mar 24, 2016

Version 2.0.0

As of version 2.0.0 all redirects will be published automatically. Please test your redirect using the integrated Redirect tester before using on a production site. If you experience problems upgrading, please feel free to contact me. I'm happy to help you.

Reset to defaults? Make sure you have a database backup and execute this command from CLI: php artisan plugin:refresh Adrenth.Redirect

Version 3.0

As of version 3.0 this plugin is a paid plugin. If you have bound your project to OctoberCMS.com marketplace you can upgrade to version 3.0 (free). Otherwise you should freeze updates for this plugin or purchase a license. If you use Redirect plugin on multiple websites you should purchase an Extended License.