Table of contents

• Summary
• Installation
• Usage
• Credits
• License

Summary

Magento does not provide the ability to set special characters on controller or action names. This module fixes that by providing the ability to use -, ., ~, _ within a URL.

Installation

composer require markshust/magento2-module-specialrouter
bin/magento module:enable MarkShust_SpecialRouter
bin/magento setup:upgrade

Usage

This module is really simple to use. All you need to do is use the appropriate "name" that matches the symbol you'd like to use in the URL.

• Symbol: -, Name: Dash
• Symbol: ., Name: Period
• Symbol: ~, Name: Tilda
• Symbol: _, Name: Underscore

For example, to respond to a request with a frontName of foo at the following location:

/foo/alpha-beta/charlie-delta

Use a PHP class named:

Controller/AlphaDashBeta/CharlieDashDelta.php

The - in the URL will be translated to dash in the actionPath and actionName, so if we create files using Dash in the controller and action name, they will respond to these requests.

Credits

M.academy

This course is sponsored by M.academy, the simplest way to learn Magento.

Mark Shust

My name is Mark Shust and I'm the creator of this repo. I'm a 6X Adobe Commerce Certified Developer and have been involved with Magento since the early days (v0.8!). I create technical education courses full-time for my company, M.academy.

• 🖥️ See my Magento lessons & courses
• 📖 Read my technical articles
• 🎥 Watch my YouTube videos
• 🔗 Connect on LinkedIn
• 🐦 Follow me on X
• 💌 Contact me

License

MIT