Skip to content

Commit

Permalink
[DOCS] add a quick start section to the routing chapter
Browse files Browse the repository at this point in the history
This will probably sufficient for 90% of inexperienced users. And I always have to search for the quick basic configuration in small projects again
  • Loading branch information
linawolf authored Nov 16, 2023
1 parent 53ee78e commit 0a29d1d
Showing 1 changed file with 51 additions and 0 deletions.
51 changes: 51 additions & 0 deletions Documentation/Tutorials/BestPractice/Routing/Index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,57 @@ if you are not familiar with the concept yet. You will no
longer need third party extensions like RealURL or CoolUri to rewrite and
beautify your URLs.

.. _routing_quickstart:

Quick start
===========

This section explains in short how to rewrite the URLs for the detail page in a
project where there is only one detail view page on the whole site and where
rewriting of things like pagination is not desired or needed.

Open the configuration of the site. You should find it at
:file:`/config/sites/<your_identifier>/config.yaml`.

At the bottom of the file include the following:

.. code-block:: yaml
:caption: /config/sites/<your_identifier>/config.yaml
routeEnhancers:
News:
type: Extbase
limitToPages:
- <uid of single page>
extension: News
plugin: Pi1
routes:
- routePath: '/{news-title}'
_controller: 'News::detail'
_arguments:
news-title: news
aspects:
news-title:
type: NewsTitle
Save the file, delete all caches and try it out

Troubleshooting
---------------

* Did you save the site configuration file?
* Did you delete all caches?
* In the format YAML indentation matters. The code above **must** be indentated exactly
as shown, the keyword `routeEnhancers` **must not** be indeted.
* The configuration above is limited to only one page containing a single view of news.
Did you put the correct pid of page containing the news plugin displaying single news?


.. _routing_detailed:

Detailed explaination and advanced use cases
============================================

.. _how_to_rewrite_urls:

How to rewrite URLs with news parameters
Expand Down

0 comments on commit 0a29d1d

Please sign in to comment.