update with results of commit MapServer/MapServer-documentation@d87f7f9

Author: MapServer deploybot

MIGRATION_GUIDE.html

@@ -126,7 +126,7 @@ <h3>Navigation</h3>
 <span id="migration"></span><h1><a class="toc-backref" href="#table-of-contents" role="doc-backlink">MapServer Migration Guide</a><a class="headerlink" href="#mapserver-migration-guide" title="Link to this heading">¶</a></h1>
 <dl class="field-list simple">
 <dt class="field-odd">Last Updated<span class="colon">:</span></dt>
-<dd class="field-odd"><p>2025-11-18</p>
+<dd class="field-odd"><p>2025-11-19</p>
 </dd>
 </dl>
 <nav class="contents" id="table-of-contents">
@@ -240,11 +240,41 @@ <h3>Navigation</h3>
 <p>original Pull Request <a class="reference external" href="https://github.com/MapServer/MapServer/pull/7309/">#7309</a></p>
 </div>
 </li>
-<li><p><a class="reference internal" href="ogc/ogc_api.html#ogcapi"><span class="std std-ref">OGC API : Features</span></a> has been enhanced to allow <cite>vendorSpecificParameters</cite> passed through to the OpenAPI
-document on the <cite>/items</cite> definitions.</p>
+<li><p><a class="reference internal" href="ogc/ogc_api.html#ogcapi"><span class="std std-ref">OGC API : Features</span></a> has been enhanced to allow the appending of additional
+query parameters to all URLs generated through the API, by
+defining the <cite>ows_extra_params</cite> parameter in the MAP’s METADATA object.</p>
+<blockquote>
+<div><div class="highlight-mapfile notranslate"><div class="highlight"><pre><span></span><span class="k">MAP</span>
+  <span class="p">...</span>
+  <span class="k">WEB</span>
+    <span class="k">METADATA</span>
+      <span class="s">&quot;ows_title&quot;</span> <span class="s">&quot;My OGCAPI Server&quot;</span>
+      <span class="p">...</span>
+      <span class="s">&quot;oga_html_template_directory&quot;</span> <span class="s">&quot;../../share/ogcapi/templates/html-bootstrap/&quot;</span>
+      <span class="s">&quot;ows_extra_params&quot;</span> <span class="s">&quot;token=123&quot;</span>
+    <span class="k">END</span> <span class="c">#metadata</span>
+  <span class="k">END</span> <span class="c">#web</span>
+  <span class="p">...</span>
+  <span class="k">LAYER</span>
+    <span class="p">...</span>
+  <span class="k">END</span> <span class="c">#layer</span>
+<span class="k">END</span> <span class="c">#map</span>
+</pre></div>
+</div>
+</div></blockquote>
+<p>All subsequent URLs available through OGCAPI: Features will contain that
+<cite>token=123</cite>, such as:</p>
+<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>http://127.0.0.1/cgi-bin/mapserv.exe/local-demo/ogcapi/collections/ocean/items?f=json&amp;token=123
+</pre></div>
+</div>
+<div class="admonition tip">
+<p class="admonition-title">Tip</p>
+<p>For sensitive parameter values, you should enable <a class="reference internal" href="cgi/runsub.html#runsub"><span class="std std-ref">Run-time Substitution</span></a> to
+not store passwords and other tokens in mapfiles.  See steps at <a class="reference internal" href="ogc/ogc_api.html#ogcapi-metadata"><span class="std std-ref">OGCAPI: Features metadata</span></a>.</p>
+</div>
 <div class="admonition seealso">
 <p class="admonition-title">See also</p>
-<p>original Pull Request <a class="reference external" href="https://github.com/MapServer/MapServer/pull/7295/">#7295</a></p>
+<p>original Pull Request <a class="reference external" href="https://github.com/MapServer/MapServer/pull/7360/">#7360</a></p>
 </div>
 </li>
 </ul>
@@ -1534,7 +1564,7 @@ <h3>Navigation</h3>
     </div>
     <div class="footer" role="contentinfo">
     &#169; <a href="copyright.html">Copyright</a> 2025, Open Source Geospatial Foundation.
-      Last updated on 2025-11-18.
+      Last updated on 2025-11-19.
       Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 8.2.3.
     </div>
   </body>

_modules/index.html

@@ -159,7 +159,7 @@ <h3>Navigation</h3>
     </div>
     <div class="footer" role="contentinfo">
     &#169; <a href="../copyright.html">Copyright</a> 2025, Open Source Geospatial Foundation.
-      Last updated on 2025-11-18.
+      Last updated on 2025-11-19.
       Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 8.2.3.
     </div>
   </body>

_modules/mapscript/mapscript.html

@@ -5576,7 +5576,7 @@ <h3>Navigation</h3>
     </div>
     <div class="footer" role="contentinfo">
     &#169; <a href="../../copyright.html">Copyright</a> 2025, Open Source Geospatial Foundation.
-      Last updated on 2025-11-18.
+      Last updated on 2025-11-19.
       Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 8.2.3.
     </div>
   </body>

_sources/MIGRATION_GUIDE.txt

@@ -6,7 +6,7 @@
 MapServer Migration Guide
 *****************************************************************************
 
-:Last Updated: 2025-11-18
+:Last Updated: 2025-11-19
 
 .. contents:: Table of Contents
     :depth: 2
@@ -101,10 +101,38 @@ MapServer 8.4 to 8.6 Migration
 
   .. seealso:: original Pull Request `#7309 <https://github.com/MapServer/MapServer/pull/7309/>`__  
 
-- :ref:`ogcapi` has been enhanced to allow `vendorSpecificParameters` passed through to the OpenAPI 
-  document on the `/items` definitions.
+- :ref:`ogcapi` has been enhanced to allow the appending of additional 
+  query parameters to all URLs generated through the API, by
+  defining the `ows_extra_params` parameter in the MAP's METADATA object.
+  
+    .. code-block:: mapfile
+  
+      MAP
+        ...
+        WEB
+          METADATA
+            "ows_title" "My OGCAPI Server"
+            ...
+            "oga_html_template_directory" "../../share/ogcapi/templates/html-bootstrap/"
+            "ows_extra_params" "token=123"
+          END #metadata
+        END #web
+        ...
+        LAYER      
+          ...
+        END #layer
+      END #map
+      
+  All subsequent URLs available through OGCAPI: Features will contain that 
+  `token=123`, such as::
+  
+    http://127.0.0.1/cgi-bin/mapserv.exe/local-demo/ogcapi/collections/ocean/items?f=json&token=123
+    
+  .. TIP::
+     For sensitive parameter values, you should enable :ref:`Run-time Substitution <runsub>` to
+     not store passwords and other tokens in mapfiles.  See steps at :ref:`OGCAPI: Features metadata <ogcapi_metadata>`.
 
-  .. seealso:: original Pull Request `#7295 <https://github.com/MapServer/MapServer/pull/7295/>`__    
+  .. seealso:: original Pull Request `#7360 <https://github.com/MapServer/MapServer/pull/7360/>`__    
 
 .. _migration-8-4:
 

_sources/ogc/ogc_api.txt

@@ -9,7 +9,7 @@
 
 :Author:       Jeff McKenna
 :Contact:      jmckenna at gatewaygeomatics.com
-:Last Updated: 2025-10-10
+:Last Updated: 2025-11-19
 
 .. contents:: Table of Contents
     :depth: 3
@@ -435,6 +435,8 @@ Further Configuration
 
 The following metadata may be used for additional configuration of the service:
 
+.. _ogcapi_metadata:
+
 Web Object Metadata
 -------------------
 
@@ -452,11 +454,11 @@ Web Object Metadata
   to be valid. Default is *http://schemas.opengis.net*
 
 .. index::
-   triple: OGCAPI; METADATA; ows_schemas_location
+   triple: OGCAPI; METADATA; ows_extra_params
 
 **ows_extra_params**
 
-  .. versionadded:: 8.4.0
+  .. versionadded:: 8.6.0
 
 - *Description:* (Optional) The ``ows_extra_params`` (or ``oga_extra_params``) metadata entry allows you to append
   additional query parameters to all URLs generated by MapServer. This can be used, for example, 

about.html

@@ -244,7 +244,7 @@ <h3>Navigation</h3>
     </div>
     <div class="footer" role="contentinfo">
     &#169; <a href="copyright.html">Copyright</a> 2025, Open Source Geospatial Foundation.
-      Last updated on 2025-11-18.
+      Last updated on 2025-11-19.
       Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 8.2.3.
     </div>
   </body>

announcements/2021-03-30-limit-mapfile-access.html

@@ -183,7 +183,7 @@ <h3>Navigation</h3>
     </div>
     <div class="footer" role="contentinfo">
     &#169; <a href="../copyright.html">Copyright</a> 2025, Open Source Geospatial Foundation.
-      Last updated on 2025-11-18.
+      Last updated on 2025-11-19.
       Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 8.2.3.
     </div>
   </body>

announcements/2021-06-11-community-condolences.html

@@ -195,7 +195,7 @@ <h3>Navigation</h3>
     </div>
     <div class="footer" role="contentinfo">
     &#169; <a href="../copyright.html">Copyright</a> 2025, Open Source Geospatial Foundation.
-      Last updated on 2025-11-18.
+      Last updated on 2025-11-19.
       Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 8.2.3.
     </div>
   </body>

announcements/announcements_archive.html

@@ -677,7 +677,7 @@ <h3>Navigation</h3>
     </div>
     <div class="footer" role="contentinfo">
     &#169; <a href="../copyright.html">Copyright</a> 2025, Open Source Geospatial Foundation.
-      Last updated on 2025-11-18.
+      Last updated on 2025-11-19.
       Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 8.2.3.
     </div>
   </body>

announcements/index.html

@@ -168,7 +168,7 @@ <h3>Navigation</h3>
     </div>
     <div class="footer" role="contentinfo">
     &#169; <a href="../copyright.html">Copyright</a> 2025, Open Source Geospatial Foundation.
-      Last updated on 2025-11-18.
+      Last updated on 2025-11-19.
       Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 8.2.3.
     </div>
   </body>