[IMP] doc: note about XMLRPC + Odoo Online

Also added some styling for guilabel as it was indistinguishable from
regular body text.

3 files changed, 38 insertions, 0 deletions

diff --git a/doc/_extensions/odoo/static/style.css b/doc/_extensions/odoo/static/style.css
index a24a820603a..d1802c8abfb 100644
--- a/doc/_extensions/odoo/static/style.css
+++ b/doc/_extensions/odoo/static/style.css
@@ -8515,6 +8515,12 @@ main article sub {
     top: 0.4em;
   }
 }
+.guilabel:before {
+  content: "❮";
+}
+.guilabel:after {
+  content: "❯";
+}
 body,
 header {
   position: relative;
diff --git a/doc/_extensions/odoo/static/typography.less b/doc/_extensions/odoo/static/typography.less
index aa5b588b95d..3c6ce8b6967 100644
--- a/doc/_extensions/odoo/static/typography.less
+++ b/doc/_extensions/odoo/static/typography.less
@@ -185,3 +185,12 @@ main article {
     }
   }
 }
+
+.guilabel {
+  &:before {
+    content: "❮";
+  }
+  &:after {
+    content: "❯";
+  }
+}
diff --git a/doc/api_integration.rst b/doc/api_integration.rst
index b41fd1990e0..22720ed6301 100644
--- a/doc/api_integration.rst
+++ b/doc/api_integration.rst
@@ -94,6 +94,26 @@ Configuration
 If you already have an Odoo server installed, you can just use its
 parameters
 
+.. warning::
+
+    For Odoo Online instances (<domain>.odoo.com), users are created without a
+    *local* password (as a person you are logged in via the Odoo Online
+    authentication system, not by the instance itself). To use XML-RPC on Odoo
+    Online instances, you will need to set a password on the user account you
+    want to use:
+
+    * Log in your instance with an administrator account
+    * Go to :menuselection:`Settings --> Users --> Users`
+    * Click on the user you want to use for XML-RPC access
+    * Click the :guilabel:`Change Password` button
+    * Set a :guilabel:`New Password` value then click
+      :guilabel:`Change Password`.
+
+    The *server url* is the instance's domain (e.g.
+    *https://mycompany.odoo.com*), the *database name* is the name of the
+    instance (e.g. *mycompany*). The *username* is the configured user's login
+    as shown by the *Change Password* screen.
+
 .. rst-class:: setup doc-aside
 
 .. switcher::
@@ -126,6 +146,9 @@ parameters
                 username = "admin",
                 password = <insert password for your admin user (default: admin)>;
 
+demo
+''''
+
 To make exploration simpler, you can also ask https://demo.odoo.com for a test
 database: