4 votes

SimpleRedirects

This project is a fork of the original Simple301 version: https://github.com/wkallhof/Simple301

Updates

11/05/2020 (Version 1.0.8): Fixed some bugs related to urls that have a slash in their url.

16/04/2021 (Version 1.0.9 & 1.0.10): Redid the cache manager to be more in line with Umbraco caching

05/05/2021 (Version 2.0.0-beta001): SimpleRedirects for Umbraco 9

12/07/2021 (Version 1.0.11): Fixed some issues with duplicate urls

29/09/2021 (Version 2.0): Umbraco 9 version

10/12/2021 (Version 2.0.1): Fixed issue with new installs

27/06/2022 (Version 2.1.0): Add ability for SimpleRedirects to also work on load-balanced websites

28/06/2022 (Version 3.0.0): Umbraco 10 version

Use 1.x.x for Umbraco 8

Use 2.x.x for Umbraco 9

Simple Redirects Manager is a simple to use, yet extensible, Umbraco Back-Office package that allows you to manage your 301 redirects directly in Umbraco. Includes a simple and intuitive refinement system where you can search for specific text within the URLs or notes defined for the redirect.

Utilizes ngTable for an AngularJs driven data table which includes ordering by column (Old Url, New Url, Notes and Last Updated) and simple pagination with configurable items per page selector.

Integrates directly with the Umbraco Content Pipeline, inserting itself in the first position to intercept incoming requests and checking against an in-memory collection of redirects for optimal performance (the only time a database is hit is through updating redirects in the back-office and on application start.)

Getting Started

Nuget Package: Install-Package SimpleRedirects

Configuration

By default, your web.config file will be updated with two application settings which are used to manage the cached state of the redirects that are created. They are as default :

<configuration>
   ...
  <appSettings>
      ...
      <add key="SimpleRedirects.CacheDurationInSeconds" value="3600"/>
      <add key="SimpleRedirects.CacheEnabled" value="true"/>
  </appSettings>
</configuration>

SimpleRedirects.CacheDurationInSeconds : This allows you to configure how long redirects are cached within the site. This only affects the user facing redirects so that the application doesn't read from the database for every request in the site. If you modify redirects within the back-office, the cache is automatically cleared per action (Add, Update, Delete).

SimpleRedirects.CacheEnabled : This allows you to toggle whether or not caching is enabled. Since this package is hit for every requested URL in the site, it is important to consider the performance implications of disabling cache. Use this to troubleshoot redirect issues.

These caching settings were added in order to support load balanced environments, where in previous versions the applications held on to redirects only in memory (persisting to the DB only if modified), which doesn't work in a load balanced environement (they may exist in a memory collection on one server, but not on the other).

Usage

1. Locate Simple Redirects Manager in the Content section

Navigate to the Umbraco > Content section. You will find a 'Manage Redirects' tab in the right pane. Select this to view the SimpleRedirects Redirect Manager. From this window you can view and manage all of the redirects for your site.

2. Refine & Locate

Use the provided Text search by entering text in the 'Search redirects' input box. As you type, results will display in real time. Use pagination and the results-per-page selectors to view more or fewer redirects at a time in the table.

3. Add, Update & Delete

Use the provided actions in the Action column to Add, Update & Delete existing redirects. Update your redirect in line with the rest of the redirects (make sure to click 'Save') or simply fill out a new redirect at the bottom of the table and click 'Add'.