#75

Product support

Get help in the plugin support forum.

Categories

  • Marketing
  • Miscellaneous
  • Utility

IMPORTANT: This plugin was formerly known as Adrenth.Redirect. The plugin has been renamed to Vdlp.Redirect. Please install this plugin which automatically migrates data and settings from Adrenth.Redirect. The current version of Adrenth.Redirect will stay available for users which have it installed, but will be hidden from the October CMS marketplace. Upgrade to Vdlp.Redirect as soon as possible.

The #1 Redirect plugin for October CMS

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.

History

This plugin was originally build in 2016 by Alwin Drenth a Software Engineer at Van der Let & Partners. As of 2018 this plugin is re-distributed to the October CMS Marketplace with vendor name Vdlp.Redirect (formerly known as Adrenth.Redirect).

The Redirect plugin will now be maintained by Van der Let & Partners and You (the open source community).

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.

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 us 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 the latest version of PHP7 (really you should)
  • 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 Vdlp.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

Please feel free to contribute to this awesome plugin.

Questions? Need help?

If you have any question about how to use this plugin, please don't hesitate to contact us at [email protected] We're happy to help you. You can also visit the support forum and drop your questions/issues there.


If you love this quality plugin as much as we do, please rate our plugin.


Dashboard

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 14 Aug, 2018

    This is a great plugin. Works like a charm, is packed with features and does exactly what is expected.

    The level of attention to details and nice visual presentation make it a pleasure to work with.

  • Found the plugin useful on 1 Mar, 2018

    This is an excellent plugin. Not only it is jam-packed with features, but the live demo site and video tutorial make it easy to evaluate the usefulness of the plugin even before installing it.

    The plugin is very easy to use and also doubles up as a brilliant showcase for how flexible October's backend forms are for plugin development; it's a great learning experience just looking through the source code.

    I have just made a bitcoin donation equal to €15 and encourage others to do the same as this is a very high quality plugin and the author should be encouraged to maintain it and build more!

    Thanks again!

  • Found the plugin useful on 12 Dec, 2017

    This is one of the best plugins I have every used with October. It is power packed with loads of features to handle various types of redirects.

    Superior quality plugin with excellent support from the author. A++

  • 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.

1.0.0

Transfer vendor ownership. Adrenth.Redirect -> Vdlp.Redirect

Aug 31, 2018

Upgrade Adrenth.Redirect 4.0 to Vdlp.Redirect 1.0

If Adrenth.Redirect plugin is installed, the database will be migrated automatically. Please make sure Adrenth.Redirect plugin is installed while installing Vdlp.Redirect.

This upgrade is supported with SQLite and MySQL databases. Other database platforms have not been tested.