Add and update notes about URL generation

Author: Kajetan Dvoracek

Classes/Controller/DocumentController.php

@@ -118,6 +118,7 @@ public function mainAction()
      *
      * * `PAGE_NO` (for value of `tx_dlf[page]`)
      * * `DOUBLE_PAGE` (for value of `tx_dlf[double]`)
+     * * `PAGE_GRID` (for value of `tx_dlf[pagegrid]`)
      *
      * @return string
      */
@@ -155,8 +156,8 @@ protected function getUrlTemplate()
             return $result;
         };
 
-        // Generate two URLs that differ only in tx_dlf[page] and tx_dlf[double].
-        // We don't know the order of page and double parameters, so use the values for matching.
+        // Generate two URLs that differ in tx_dlf[page], tx_dlf[double] and tx_dlf[highlight].
+        // We don't know the order of these parameters, so use the values for matching.
         $a = $make(2, 1, 0);
         $b = $make(3, 0, 1);
 

Documentation/Developers/ClientSide.rst

@@ -66,6 +66,15 @@ To dynamically show the metadata sections of the current page:
 
 Rootline configuration is considered.
 
+URLs and Slugs
+==============
+
+For dynamic link generation on the client, a URL template is generated in ``DocumentController::getUrlTemplate()``.
+The template contains placeholders for the relevant parameters, which are then replaced by the current values in ``Controller::makePageUrl()``.
+The generated URL does not include a ``cHash``.
+
+This solution is intended to avoid generating all possible URL variants on the backend while still supporting slugs.
+
 Various
 =======