Skip to content

Commit 4bde417

Browse files
committed
docs: Add note about filters
1 parent ebc2643 commit 4bde417

File tree

1 file changed

+11
-0
lines changed

1 file changed

+11
-0
lines changed

user_guide_src/source/incoming/routing.rst

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -923,6 +923,17 @@ The *Route* column shows the route path to match. The route of a defined route i
923923

924924
Since v4.3.0, the *Name* column shows the route name. ``»`` indicates the name is the same as the route path.
925925

926+
Prior to v4.5.0, routes with ``{locale}`` and the enabled parameter ``$routes->shouldUseSupportedLocalesOnly(true)`` in **app/Config/Routes.php** were shown ``<unknown>`` in the *Filters* column. This was due to the fact that it was impossible to resolve filters for all languages.
927+
Now routes having ``{locale}`` are output as ``!filtername``. This means that filters are set for a group of languages, but there is no guarantee of execution for each language.
928+
929+
.. code-block:: none
930+
931+
+--------+---------------+------+-----------+----------------+---------------+
932+
| Method | Route | Name | Handler | Before Filters | After Filters |
933+
+--------+---------------+------+-----------+----------------+---------------+
934+
| GET | {locale}/feed | » | (Closure) | | !toolbar |
935+
+--------+---------------+------+-----------+----------------+---------------+
936+
926937
.. important:: The system is not perfect. If you use Custom Placeholders, *Filters* might not be correct. If you want to check filters for a route, you can use :ref:`spark filter:check <spark-filter-check>` command.
927938

928939
Auto Routing (Improved)

0 commit comments

Comments
 (0)