nglasl / silverstripe-misdirection
This module allows both simple and regular expression link redirections based on customisable mappings, either hooking into a page not found or replacing the default automated URL handling.
Installs: 73 912
Dependents: 2
Suggesters: 0
Security: 0
Stars: 4
Watchers: 3
Forks: 18
Open Issues: 9
Type:silverstripe-vendormodule
Requires
- silverstripe/framework: ~4.0
- dev-master / 3.1.x-dev
- 3.1.1
- 3.1.0
- 3.0.x-dev
- 3.0.0
- 2.3.x-dev
- 2.3.1
- 2.3.0
- 2.2.x-dev
- 2.2.26
- 2.2.25
- 2.2.24
- 2.2.23
- 2.2.22
- 2.2.21
- 2.2.20
- 2.2.19
- 2.2.18
- 2.2.17
- 2.2.16
- 2.2.15
- 2.2.14
- 2.2.13
- 2.2.12
- 2.2.11
- 2.2.10
- 2.2.9
- 2.2.8
- 2.2.7
- 2.2.6
- 2.2.5
- 2.2.4
- 2.2.3
- 2.2.2
- 2.2.1
- 2.2.0
- 2.1.x-dev
- 2.1.8
- 2.1.7
- 2.1.6
- 2.1.5
- 2.1.4
- 2.1.3
- 2.1.2
- 2.1.1
- 2.1.0
- 2.0.x-dev
- 2.0.3
- 2.0.2
- 2.0.1
- 2.0.0
- 1.0.x-dev
- 1.0.8
- 1.0.7
- 1.0.6
- 1.0.5
- 1.0.4
- 1.0.3
- 1.0.2
- 1.0.1
- 1.0.0
This package is auto-updated.
Last update: 2024-12-10 20:25:51 UTC
README
The current release is 3.1.1
This module allows both simple and regular expression link redirections based on customisable mappings, either hooking into a page not found or replacing the default automated URL handling.
Requirement
- SilverStripe 3.1 → 4.0
This module does not require the CMS.
Getting Started
- Place the module under your root project directory.
/dev/build
- Select
Misdirection
through the CMS. - Create a link mapping.
/mapping
Overview
Link Mappings
These allow both simple and regular expression link redirections, and can be used for legacy page redirection, vanity URLs (more below), or redirection based on specific URL patterns.
The link mapping with the highest priority (followed by greatest specificity) will be used, and replaces the default automated URL handling out of the box. This default behaviour may be configured to only hook into a page not found:
nglasl\misdirection\MisdirectionRequestFilter: enforce_misdirection: false
When there are multiple matches, the link mapping first created will be used. This default behaviour may be configured to prioritise the link mapping most recently created:
nglasl\misdirection\LinkMapping: priority: 'DESC'
Vanity URLs and Fallbacks
Vanity URLs
While it is possible to create these manually (as above), a content author may directly create a link mapping from a page. However, it should be noted that these are instantiated with a low priority of 2
, and therefore other link mappings with higher priority will take precedence.
Fallbacks
When a user happens to encounter a page not found, a specified rule may be triggered to prevent displaying this. It is possible for an administrator to configure a global fallback through the site configuration, however a specific page setting will take precedence.
- Select
Settings
- Select
Pages
What's Happening?
The link mappings are processed server side to prevent inefficient and problematic mappings, using a request filter.
When you want to see exactly what is happening behind the scenes for a given URL, the model admin provides a powerful testing interface!
Once a maximum number of requests has been reached, the server will respond with a page not found. The following is the default configuration:
nglasl\misdirection\MisdirectionRequestFilter: maximum_requests: 9
Bypassing Misdirection
It is possible to bypass the request filter completely by appending ?misdirected=1
to the URL. This is fantastic for debugging, however does not apply to the testing interface for obvious reasons.
Default Automated URL Handling
This may be completely replaced, in which case legacy URLs will no longer resolve based on page version history.
nglasl\misdirection\MisdirectionRequestFilter: replace_default: true
When a page is moved, the appropriate link mappings are automatically created and maintained. This allows full control over which legacy URLs remain in the system.
Maintainer Contact
Nathan Glasl, nathan@symbiote.com.au