Skip to content

Latest commit

 

History

History
50 lines (32 loc) · 1.47 KB

README.md

File metadata and controls

50 lines (32 loc) · 1.47 KB
Raw

SilverStripe Trailing Slash

Ensure that a single trailing slash is always added to the URL. URLs accessed via Ajax, contain $_GET vars, or that contain an extension are ignored.

Examples

  • example.com/contact is redirected to example.com/contact/
  • example.com/contact// is redirected to example.com/contact/
  • example.com/contact?test is not redirected
  • example.com/contact.html is not redirected

Requirements

  • SilverStripe 4.*

For SilverStripe 3, please refer to the SilverStripe3 branch.

Installation and configuration

composer require axllent/silverstripe-trailing-slash
  • Run ?flush=1

Configuration

By default it will ignore any admin/ & dev/ URLs, as well as all ajax requests. It also only acts on $_GET requests as not to interfere with any posted data, and ignores any url containing an extension (eg: /contact.html) or query parameter.

You can create additional "ignore_paths" by creating a yaml config (eg: app/_config/trailing-slash.yml):

Axllent\TrailingSlash\Middleware\TrailingSlashRedirector:
  ignore_paths:
    - 'events'
    - 'my/other/path'

These paths are relative to the base URL (/), so events will not match /page/events, but will match /events-2020.

Please note that paths do not typically contain a trailing slash unless it is only underlying URLs you wish to redirect. Wildcards etc are not supported in the syntax.