If you’ve found an error, spotted something missing, or feel a section could be clearer or better explained, we’d love to hear from you. Your feedback helps keep the documentation accurate and useful for everyone.
Please report issues or suggest improvements on GitHub. Community input is invaluable in making the docs stronger.
Not comfortable with GitHub? No problem — you can also get in touch with us directly via our contact form. We welcome all feedback.
Custom Routing - Practical Examples
There may be situations when you'd like to create custom page URLs. For example, let's assume that you own an online shop that sells laptops. A typical URL for a product page might look something like this:
Wouldn't it be nice if you could change these types of URLs so that they are:
- More search engine friendly
- Easier for visitors to remember
Custom routing makes this and more possible. Let's go through a few different scenarios and explore how we could use custom routing to create attractive page URLs.
Scenario 1: 'News to Blog'
Challenge: You'd like to use a 'news' module from a previous project (we'll call it 'website A') to create a new blog for a second website ('website B'). However, you don't want the new blog module to contain URLs that start with 'news/'. Instead, you'd like the URLs to start with 'my-blog/'.
More Info: Let's assume that the homepage for the 'news' module is:
Typing the URL shown above into the address bar would load the index method for the 'news' module. Your goal might be to load the news module by going to:
How It's Done:
- In your text editor, open the file 'custom_routing.php'. It's inside the 'config' directory.
-
Inside the custom_routing.php file, add a new key-value pair to the
$routesarray where 'my-blog' is assigned to 'news'. For example:
Scenario 2: 'Dealing With Numeric Wildcards'
Challenge: You have an online shop that sells laptops. All of the product pages in your online shop have a first segment of 'store_items/'. For example:
You'd like to change the URLs so that instead of the first segment saying 'store_items', the product pages should all have a first segment of 'laptops'. For example:
How It's Done:
In custom_routing add the following key-value pair to the $routes array:
Scenario 3: 'Super SEO-friendly URLs'
Challenge: Sticking with our online shop example, let's imagine that you'd like to have product pages where all of the URLs are super search engine friendly. So, instead of having a URL like:
Perhaps you would prefer to have a URL like this:
This kind of URL could rightfully be considered to be super search engine friendly. Having an online shop with those kinds of URLs could be extremely valuable for anyone who had an interest in achieving a high search engine ranking.
How It's Done:
The first step to creating a super search engine friendly URL, as described above, would involve giving all of our products a unique 'slug'. In the Trongate Desktop App, this gets called a 'URL column'.
Having created a unique slug (URL column value) for each product, we would then add the following key-value pair to the $routes array, inside 'custom_routing.php':
If you can follow the steps above then congratulations! You now know how to build pages that are super search engine friendly and that load approximately twenty times faster than Laravel. Best of all, your clients will think you're a genius after they've made it to the top of Google and recommended you to all of their friends!