Fix up docs.

Author: dereuromark

docs/en/url-checkers.rst

@@ -5,47 +5,113 @@ To provide an abstract and framework agnostic solution there are URL
 checkers implemented that allow you to customize the comparison of the
 current URL if needed. For example to another frameworks routing.
 
+All checkers support single URLs in either string or array format (like ``Router::url()``).
+For multiple login URLs, use ``MultiUrlChecker``.
+
 Included Checkers
 =================
 
+CakeUrlChecker
+--------------
+
+The default checker when CakePHP is installed. Supports both string URLs and
+CakePHP's array-based routing notation. This checker also works with named routes.
+
+Single URL (string):
+
+.. code-block:: php
+
+    $service->loadAuthenticator('Authentication.Form', [
+        'loginUrl' => '/users/login',
+    ]);
+
+Single URL (CakePHP route array):
+
+.. code-block:: php
+
+    $service->loadAuthenticator('Authentication.Form', [
+        'loginUrl' => [
+            'prefix' => false,
+            'plugin' => false,
+            'controller' => 'Users',
+            'action' => 'login',
+        ],
+    ]);
+
+Options:
+
+-  **checkFullUrl**: To compare the full URL, including protocol, host
+   and port or not. Default is ``false``
+
 DefaultUrlChecker
 -----------------
 
-The default checker allows you to compare an URL by regex or string
-URLs.
+Framework-agnostic checker for string URLs. Supports regex matching.
+This is the default when CakePHP is not installed.
+
+.. code-block:: php
+
+    $service->loadAuthenticator('Authentication.Form', [
+        'urlChecker' => 'Authentication.Default',
+        'loginUrl' => '/users/login',
+    ]);
+
+Using regex:
+
+.. code-block:: php
+
+    $service->loadAuthenticator('Authentication.Form', [
+        'urlChecker' => [
+            'className' => 'Authentication.Default',
+            'useRegex' => true,
+        ],
+        'loginUrl' => '%^/[a-z]{2}/users/login/?$%',
+    ]);
 
 Options:
 
 -  **checkFullUrl**: To compare the full URL, including protocol, host
    and port or not. Default is ``false``
 -  **useRegex**: Compares the URL by a regular expression provided in
-   the ``$loginUrls`` argument of the checker.
+   the ``loginUrl`` configuration.
+
+MultiUrlChecker
+---------------
+
+Use this checker when you need to support multiple login URLs (e.g., for multi-language sites).
+You must explicitly configure this checker - it is not auto-detected.
 
-CakeRouterUrlChecker
---------------------
+Multiple string URLs:
 
-Use this checker if you want to use the array notation of CakePHPs
-routing system. The checker also works with named routes.
+.. code-block:: php
 
     $service->loadAuthenticator('Authentication.Form', [
-        'urlChecker' => 'Authentication.CakeRouter',
-        'fields' => [
-            AbstractIdentifier::CREDENTIAL_USERNAME => 'email',
-            AbstractIdentifier::CREDENTIAL_PASSWORD => 'password',
+        'urlChecker' => 'Authentication.Multi',
+        'loginUrl' => [
+            '/en/users/login',
+            '/de/users/login',
         ],
+    ]);
+
+Multiple CakePHP route arrays:
+
+.. code-block:: php
+
+    $service->loadAuthenticator('Authentication.Form', [
+        'urlChecker' => 'Authentication.Multi',
         'loginUrl' => [
-            'prefix' => false,
-            'plugin' => false,
-            'controller' => 'Users',
-            'action' => 'login',
+            ['lang' => 'en', 'controller' => 'Users', 'action' => 'login'],
+            ['lang' => 'de', 'controller' => 'Users', 'action' => 'login'],
         ],
     ]);
 
 Options:
+
 -  **checkFullUrl**: To compare the full URL, including protocol, host
    and port or not. Default is ``false``
+-  **useRegex**: Compares URLs by regular expressions. Default is ``false``
 
 Implementing your own Checker
 -----------------------------
 
-An URL checker **must** implement the ``UrlCheckerInterface``.
+An URL checkers **must** implement the ``UrlCheckerInterface``.