CaseInsensitiveURLs Tutorial

I could tell you how many hours it takes to develop a MODX extra Transport Package complete with a build script, properties, multiple MODX elements, internationalized strings, error checks, and then fully test it, but you wouldn't believe me. If you use this extra and like it, please consider donating. The suggested donation for this extra is $5.00, but any amount you want to give is fine (really). For a one-time donation of $50.00 you can use all of my non-commercial extras with a clear conscience.


PayPal

On servers where URLs are case-sensitive, user's who try to access a page using a link that is in the wrong case will encounter a 404 (page-not-found) error. This Plugin for MODX Revolution let's users find your pages even when the case of a link or an address entered in the browser's address bar is incorrect with respect to case.

CaseInsensitiveURLs assumes that you are using Friendly URLs and that all your aliases are all lowercase. If this is not the case, the Plugin is no good for you.

When a requested page is not found and the URL is mixed-case, the Plugin redirects the user to the lowercase version of the same URL. CaseInsensitiveURLs will not alter any query strings (any part of the URL following a '?' character), so any parameters after the '?' can include uppercase letters.

CaseInsensitiveURLs will not slow down your site because it only executes when the page-not-found event fires.

Installing CaseInsensitiveURLs

Go to System | Package Management on the main menu in the MODX Manager and click on the "Download Extras" button. That will take you to the Revolution Repository (AKA Web Transport Facility). Put CaseInsensitiveURLs in the search box and press Enter. Click on the "Download" button, and when it changes to "Downloaded," click on the "Finish" button. That should bring you back to your Package Management grid. Click on the "Install" button next to CaseInsensitiveURLs in the grid. The CaseInsensitiveURLs package should now be installed.

Usage

Once you install the Plugin, it will go to work. No further action is required.

My book, MODX: The Official Guide - Digital Edition is now available here. The paper version of the book is available from Amazon.

If you have the book and would like to download the code, you can find it here.

If you have the book and would like to see the updates and corrections page, you can find it here.

MODX: The Official Guide is 772 pages long and goes far beyond this web site in explaining beginning and advanced MODX techniques. It includes detailed information on:

  • Installing MODX
  • How MODX Works
  • Working with MODX resources and Elements
  • Using Git with MODX
  • Using common MODX add-on components like SPForm, Login, getResources, and FormIt
  • MODX security Permissions
  • Customizing the MODX Manager
  • Using Form Customization
  • Creating Transport Packages
  • MODX and xPDO object methods
  • MODX System Events
  • Using PHP with MODX

Go here for more information about the book.

Thank you for visiting BobsGuides.com

  —  Bob Ray