[IMP] base_rest: show first-level menu to admins only

OCA · Nov 25, 2024 · 321bf80 · 321bf80
1 parent c89c938
commit 321bf80
Show file tree

Hide file tree

Showing 4 changed files with 17 additions and 9 deletions.
diff --git a/base_rest/README.rst b/base_rest/README.rst
@@ -46,7 +46,9 @@ systems, therefore increasing maintenance costs.
 Once developed, an `OpenApi <https://spec.openapis.org/oas/v3.0.3>`_ documentation
 is generated from the source code and available via a
 `Swagger UI <https://swagger.io/tools/swagger-ui/>`_ served by your odoo server
-at `https://my_odoo_server/api-docs`.
+at `https://my_odoo_server/api-docs`. There is also a convenience menu
+visible by users with permission "Administration: Settings", but the
+docs endpoint itself is public.
 
 **Table of contents**
 

diff --git a/base_rest/readme/DESCRIPTION.rst b/base_rest/readme/DESCRIPTION.rst
@@ -16,4 +16,6 @@ systems, therefore increasing maintenance costs.
 Once developed, an `OpenApi <https://spec.openapis.org/oas/v3.0.3>`_ documentation
 is generated from the source code and available via a
 `Swagger UI <https://swagger.io/tools/swagger-ui/>`_ served by your odoo server
-at `https://my_odoo_server/api-docs`.
+at `https://my_odoo_server/api-docs`. There is also a convenience menu
+visible by users with permission "Administration: Settings", but the
+docs endpoint itself is public.
diff --git a/base_rest/static/description/index.html b/base_rest/static/description/index.html
@@ -1,4 +1,3 @@
-<?xml version="1.0" encoding="utf-8"?>
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
@@ -9,10 +8,11 @@
 
 /*
 :Author: David Goodger ([email protected])
-:Id: $Id: html4css1.css 8954 2022-01-20 10:10:25Z milde $
+:Id: $Id: html4css1.css 9511 2024-01-13 09:50:07Z milde $
 :Copyright: This stylesheet has been placed in the public domain.
 
 Default cascading style sheet for the HTML output of Docutils.
+Despite the name, some widely supported CSS2 features are used.
 
 See https://docutils.sourceforge.io/docs/howto/html-stylesheets.html for how to
 customize this style sheet.
@@ -275,7 +275,7 @@
   margin-left: 2em ;
   margin-right: 2em }
 
-pre.code .ln { color: grey; } /* line numbers */
+pre.code .ln { color: gray; } /* line numbers */
 pre.code, code { background-color: #eeeeee }
 pre.code .comment, code .comment { color: #5C6576 }
 pre.code .keyword, code .keyword { color: #3B0D06; font-weight: bold }
@@ -301,7 +301,7 @@
 span.pre {
   white-space: pre }
 
-span.problematic {
+span.problematic, pre.problematic {
   color: red }
 
 span.section-subtitle {
@@ -384,7 +384,9 @@ <h1 class="title">Base Rest</h1>
 <p>Once developed, an <a class="reference external" href="https://spec.openapis.org/oas/v3.0.3">OpenApi</a> documentation
 is generated from the source code and available via a
 <a class="reference external" href="https://swagger.io/tools/swagger-ui/">Swagger UI</a> served by your odoo server
-at <cite>https://my_odoo_server/api-docs</cite>.</p>
+at <cite>https://my_odoo_server/api-docs</cite>. There is also a convenience menu
+visible by users with permission “Administration: Settings”, but the
+docs endpoint itself is public.</p>
 <p><strong>Table of contents</strong></p>
 <div class="contents local topic" id="contents">
 <ul class="simple">
@@ -738,7 +740,9 @@ <h2><a class="toc-backref" href="#toc-entry-13">Contributors</a></h2>
 <div class="section" id="maintainers">
 <h2><a class="toc-backref" href="#toc-entry-14">Maintainers</a></h2>
 <p>This module is maintained by the OCA.</p>
-<a class="reference external image-reference" href="https://odoo-community.org"><img alt="Odoo Community Association" src="https://odoo-community.org/logo.png" /></a>
+<a class="reference external image-reference" href="https://odoo-community.org">
+<img alt="Odoo Community Association" src="https://odoo-community.org/logo.png" />
+</a>
 <p>OCA, or the Odoo Community Association, is a nonprofit organization whose
 mission is to support the collaborative development of Odoo features and
 promote its widespread use.</p>

diff --git a/base_rest/views/base_rest_view.xml b/base_rest/views/base_rest_view.xml
@@ -2,11 +2,11 @@
 <!-- Copyright 2018 ACSONE SA/NV
      License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl). -->
 <odoo>
-
     <record id="menu_rest_api_root" model="ir.ui.menu">
         <field name="name">REST API</field>
         <field name="sequence" eval="400" />
         <field name="web_icon">base_rest,static/description/icon.png</field>
+        <field name="groups_id" eval="[(4, ref('base.group_system'))]" />
     </record>
 
     <record id="action_rest_api_docs" model="ir.actions.act_url">