odoo-forge-bundle 0.1.0

package/payload/skills/odoo18-docs/references/docs/applications/general/email_communication/mailjet_api.md

@@ -0,0 +1,185 @@
+---
+title: "Mailjet API"
+source_url: "https://docs.odoo.sbggai.top/applications/general/email_communication/mailjet_api.html"
+---
+
+===========
+# Mailjet API
+
+Odoo is compatible with Mailjet's :abbr:`API (Application Programming Interface)` for mass mailing.
+Set up a dedicated mass mailing server through Mailjet by configuring settings in the Mailjet
+account and the Odoo database. In some circumstances, settings need to be configured on the custom
+domain's :abbr:`DNS (Domain Name System)` settings as well.
+
+# Set up in Mailjet
+
+## Create API credentials
+
+To get started, sign in to the [Mailjet Account Information ](https://app.mailjet.com/account)
+page. Next, navigate to the :guilabel:`Senders & Domains` section and click on :guilabel:`SMTP and
+SEND API Settings`.
+
+.. image:: mailjet_api/api-settings.png
+   :alt: SMTP and Send API Settings link in the Senders & Domains section of Mailjet.
+
+Then, copy the :abbr:`SMTP (Simple Mail Transfer Protocol)` configuration settings onto a notepad.
+They can be found under the :guilabel:`Configuration (SMTP only)` section. The :abbr:`SMTP (Simple
+Mail Transfer Protocol)` configuration settings include the server address, the security option
+needed (Use :abbr:`SSL (Secure Sockets Layer)`/:abbr:`TLS (Transport Layer Security)`), and the
+port number. The settings are needed to configure Mailjet in Odoo, which is covered in the
+:ref:`last section <maintain/mailjet-api/odoo-setup>`.
+
+.. seealso::
+   [Mailjet: How can I configure my SMTP parameters?
+   ](https://documentation.mailjet.com/hc/articles/360043229473)
+
+> **important**:
+>    Odoo :ref:`blocks port 25 <email-outbound-port-restriction>` on Odoo Online and Odoo.sh
+   databases.
+
+.. image:: mailjet_api/smtp-config.png
+   :alt: SMTP configuration from Mailjet.
+
+Next, click on the button labeled :guilabel:`Retrieve your API credentials` to retrieve the Mailjet
+API credentials.
+
+Then, click on the eye icon to reveal the :guilabel:`API key`. Copy this key to a notepad, as this
+serves as the :guilabel:`Username` in the Odoo configuration. Next, click on the
+:guilabel:`Generate Secret Key` button to generate the :guilabel:`Secret Key`. Copy this key to a
+notepad, as this serves as the :guilabel:`Password` in the Odoo configuration.
+
+## Add verified sender address(es)
+
+The next step is to add a sender address or a domain to the Mailjet account settings so that the
+email address or domain is approved to send emails using Mailjet's servers. First, navigate to the
+[Mailjet Account Information ](https://app.mailjet.com/account) page. Next, click on the
+:guilabel:`Add a Sender Domain or Address` link under the :guilabel:`Senders & Domains` section.
+
+.. image:: mailjet_api/add-domain-email.png
+   :alt: Add a sender domain or address in the Mailjet interface.
+
+Determine if a sender's email address or the entire domain needs to be added to the Mailjet
+settings. It may be easier to configure the domain as a whole if :abbr:`DNS (Domain Name System)`
+access is available. Jump to the :ref:`Add a domain <maintain/mailjet-api/add-domain>` section for
+steps on adding the domain.
+
+> **note**:
+>    Either all email addresses of the Odoo database users who are sending emails using Mailjet's
+   servers need to be configured or the domain(s) of the users' email addresses can be configured.
+
+By default, the email address originally set up in the Mailjet account is added as a trusted
+sender. To add another email address, click on the button labeled :guilabel:`Add a sender address`.
+Then, add the email address that is configured to send from the custom domain.
+
+At minimum the following email addresses should be set up in the provider and verified in Mailjet:
+
+- notifications\@yourdomain.com
+- bounce\@yourdomain.com
+- catchall\@yourdomain.com
+
+> **note**:
+>    Replace `yourdomain` with the custom domain for the Odoo database. If there isn't one, then use
+   the :guilabel:`mail.catchall.domain` system parameter.
+
+After that, fill out the :guilabel:`Email Information` form, making sure to select the appropriate
+email type: transactional email or mass emails. After completing the form, an activation email is
+sent to the email address and the trusted sender can be activated.
+
+It is recommended to set up the :abbr:`SPF (Sender Policy Framework)`/:abbr:`DKIM (DomainKeys
+Identified Mail)`/:abbr:`DMARC (Domain-based Message Authentication, Reporting, and
+Conformance)` settings on the domain of the sender.
+
+.. seealso::
+   [Mailjet's SPF/DKIM/DMARC documentation ](https://documentation.mailjet.com/hc/articles/
+   360042412734-Authenticating-Domains-with-SPF-DKIM)
+
+> **important**:
+>    If the database is not using a custom domain, then in order to verify the sender's address, a
+   temporary alias (of the three email addresses mentioned above) should be set up in Odoo CRM to
+   create a lead. Then, the database is able to receive the verification email and verify the
+   accounts.
+
+.. _maintain/mailjet-api/add-domain:
+
+## Add a domain
+
+By adding an entire domain to the Mailjet account, all the sender addresses related to that domain
+are automatically validated for sending emails using Mailjet servers. First, navigate to the
+[Mailjet Account Information ](https://app.mailjet.com/account) page. Next, click on
+:guilabel:`Add a Sender Domain or Address` link under the :guilabel:`Senders & Domains` section.
+Then, click on :guilabel:`Add domain` to add the custom domain.
+
+> **note**:
+>    The domain needs to be added to the Mailjet account and then validated through the :abbr:`DNS
+   (Domain Name System)`.
+
+After that, fill out the :guilabel:`Add a new Domain` page on Mailjet and click
+:guilabel:`Continue`.
+
+After adding the domain, a validation page will populate. Unless the Odoo database is on-premise
+(in which case, choose :guilabel:`Option 1`), choose :guilabel:`Option 2: Create a DNS Record`.
+Copy the TXT record information to a notepad and then navigate to the domain's :abbr:`DNS (Domain
+Name System)` provider to complete validation.
+
+.. image:: mailjet_api/host-value-dns.png
+   :alt: The TXT record information to input on the domain's DNS.
+
+### Setup in the domain's DNS
+
+After getting the TXT record information from the Mailjet account, add a TXT record to the domain's
+:abbr:`DNS (Domain Name System)`. This process varies depending on the :abbr:`DNS (Domain Name
+System)` provider. Consult the provider for specific configuration processes. The TXT record
+information consists of the :guilabel:`Host` and :guilabel:`Value`. Paste these into
+the corresponding fields in the TXT record.
+
+### Return to Mailjet account information
+
+After adding the TXT record to the domain's :abbr:`DNS (Domain Name System)`, navigate back to the
+Mailjet account. Then, navigate to :menuselection:`Account Information --> Add a Sender Domain or
+Address`, click the gear icon next to :guilabel:`Domain`, and select :guilabel:`Validate`.
+
+This action can also be done by going to the [Sender domains & addresses ](https://app.mailjet.com/
+account/sender) page on the Mailjet account information and clicking on :guilabel:`Manage`.
+
+Next, click :guilabel:`Check Now` to validate the TXT record that was added on the domain. A
+success screen will appear if the domain is configured correctly.
+
+.. image:: mailjet_api/check-dns.png
+   :alt: Check DNS record in Mailjet.
+
+After successfully setting up the domain, there is an option to :guilabel:`Authenticate this domain
+(SPF/DKIM)`. This button populates :abbr:`SPF (Sender Policy Framework)` & :abbr:`DKIM (DomainKeys
+Identified Mail) records to input into the :abbr:`DNS (Domain Name System)` provider.
+
+.. seealso::
+   [Mailjet's SPF/DKIM/DMARC documentation ](https://documentation.mailjet.com/hc/articles/
+   360042412734-Authenticating-Domains-with-SPF-DKIM)
+
+.. image:: mailjet_api/authenticate.png
+   :alt: Authenticate the domain with SPF/DKIM records in Mailjet.
+
+.. _maintain/mailjet-api/odoo-setup:
+
+# Set up in Odoo
+
+To complete the setup, navigate to the Odoo database and go to the :guilabel:`Settings`. With
+:ref:`developer-mode` turned on, go to the :menuselection:`Technical Menu --> Email --> Outgoing
+Mail Servers`. Then, create a new outgoing server configuration by clicking on the
+:guilabel:`Create` button.
+
+Next, input the `SMTP server` (in-v3.mailjet.com), `port number` (587 or 465), and `Security
+(SSL/TLS)` that was copied earlier from the Mailjet account. They can also be found [here
+](https://app.mailjet.com/account/setup). It is recommended to use :abbr:`SSL (Secure Sockets
+Layer)`/:abbr:`TLS (Transport Layer Security)` even though Mailjet may not require it.
+
+For the :guilabel:`Username`, input the :guilabel:`API KEY`. For the :guilabel:`Password`, input
+the :guilabel:`SECRET KEY` that was copied from the Mailjet account to the notepad earlier. These
+settings can be found on :menuselection:`Mailjet -->  Account Settings --> SMTP and SEND API
+Settings`.
+
+Then, if the Mailjet server is used for mass emailing, set the :guilabel:`Priority` value higher
+than that of any transactional email server(s). Finally, save the settings and :guilabel:`Test the
+Connection`.
+
+.. image:: mailjet_api/server-settings.png
+   :alt: Odoo outgoing email server settings.

package/payload/skills/odoo18-docs/references/docs/applications/general/email_communication.md

@@ -0,0 +1,111 @@
+---
+title: ""
+source_url: "https://docs.odoo.sbggai.top/applications/general/email_communication.html"
+---
+
+:show-content:
+# 
+# Communication in Odoo by email
+
+Communication in Odoo related to records such as CRM opportunities, sales orders, invoices, ...
+have a discussion thread called **chatter**, often displayed on the right side of the record.
+
+On the chatter, you can send direct emails or Odoo notifications to the followers of a document
+(depending on their notification preferences), log internal notes, send WhatsApp messages or SMSes,
+and schedule activities.
+
+If a follower replies to a message, the reply updates the chatter, and Odoo relays it to the
+followers as a notification. All emails - outgoing and incoming - appear in the same chatter.
+
+.. _email-online-sh:
+
+# Odoo Online and Odoo.sh users
+
+On Odoo Online and Odoo.sh, outgoing and incoming emails work out of the box, **nothing needs to be
+done**. Everything is already configured on your subdomain.
+
+By default, outgoing emails use the following :ref:`notification email address
+<email-outbound-notifications>` `notifications@company-name.odoo.com`.
+
+.. _email-online-sh-domain:
+
+## Using another domain
+
+If you prefer not to have outgoing emails sent from Odoo's subdomain `@company-name.odoo.com` but
+instead :ref:`from your own domain <email-outbound-custom-domain>`, **additional configuration will
+be necessary** on the domain and within Odoo. This introduces an extra layer of complexity and
+necessitates technical knowledge (mainly regarding DNS and mail protocols).
+
+By adding a domain and configuring the administration access rights, you can also access the
+:ref:`new domain alias <email-outbound-alias-domain>` page to configure the alias of your companies.
+If only one domain is configured, this domain will be shared by all companies on the database.
+
+If you want to keep using Odoo's mail server, you will have to :ref:`configure the SPF and DKIM
+<email-domain-spf>`.
+
+If :ref:`you want to use your own mail server <email-outbound-custom-domain-smtp-server>`, you will
+have to follow the mail server provider's specific documentation.
+
+For incoming emails, after adding your own domain, :ref:`replies from customers will come back to
+your domain <email-inbound-custom-domain>`, and you will need to use one of the three possible ways
+to get the emails back into Odoo (using either :ref:`incoming mail server
+<email-inbound-custom-domain-incoming-server>`, :ref:`redirection/forwarding
+<email-inbound-custom-domain-redirections>` or :ref:`DNS MX record
+<email-inbound-custom-domain-mx>`). Everything is covered in the :doc:`Manage inbound messages
+documentation <email_communication/email_servers_inbound>`.
+
+.. _email-on-premise:
+
+# On-premise users
+
+If you are on-premise, you will have to completely configure your outgoing and incoming emails:
+
+- For outgoing emails, you will need :ref:`to use an SMTP server and a custom domain
+  <email-outbound-custom-domain-odoo-server>`.
+- For incoming emails, set the frequency at which you fetch new emails low enough for responsiveness
+  but high enough in order not to stress your system or provider. Due to this reason and the
+  simplicity of this configuration, we usually advise on using incoming mail servers. To use an SMTP
+  server, check out the :ref:`"Use a custom domain for inbound messages" documentation
+  <email-inbound-custom-domain>`.
+
+.. _email-third-party-server:
+
+# Using a third-party provider's mail server
+
+Odoo's documentation also covers several popular mail servers. As they require specific
+authorizations and configuration, they add a layer of complexity. For this reason, using Odoo's
+outgoing mail server is recommended.
+
+- :doc:`Outlook documentation <email_communication/azure_oauth>`
+- :doc:`Gmail documentation <email_communication/google_oauth>`
+- :doc:`Mailjet documentation <email_communication/mailjet_api>`
+
+> **note**:
+>    Every provider has its own limitations. Research the desired provider *before* configuring it.
+   For example, Outlook and Gmail might not be suitable for large marketing campaigns.
+
+.. seealso::
+   - :doc:`Activities <../essentials/activities>`
+   - :doc:`Discuss app <../productivity/discuss>`
+   - :doc:`Digest emails <companies/digest_emails>`
+   - :doc:`Email Marketing app <../marketing/email_marketing>`
+   - :doc:`Email templates <companies/email_template>`
+   - :ref:`Expense creation using an email alias <expenses/email_expense>`
+   - :ref:`Helpdesk ticket creation using an email alias <helpdesk/receiving_tickets/email-alias>`
+   - :ref:`Lead creation using an email alias <crm/configure_email_alias>`
+   - :ref:`Project task creation using an email alias <task_creation/email_alias>`
+   - :doc:`Technical mail gateway for on-premise users
+     <../../administration/on_premise/email_gateway>`
+   - :ref:`Technical start of Odoo database with an outgoing mail server configured from the
+     command-line interface <reference/cmdline/server/emails>`
+
+.. toctree::
+   :titlesonly:
+
+   email_communication/email_servers_inbound
+   email_communication/email_servers_outbound
+   email_communication/email_domain
+   email_communication/azure_oauth
+   email_communication/google_oauth
+   email_communication/mailjet_api
+   email_communication/faq

package/payload/skills/odoo18-docs/references/docs/applications/general/integrations/barcodelookup.md

@@ -0,0 +1,41 @@
+---
+title: ""
+source_url: "https://docs.odoo.sbggai.top/applications/general/integrations/barcodelookup.html"
+---
+
+:show-content:
+# 
+# Barcode Lookup
+
+[Barcode Lookup ](https://www.barcodelookup.com/) allows you to scan (or enter) products' barcodes
+(:abbr:`UPC (Universal Product Code)`, :abbr:`EAN (European Article Number)`, or :abbr:`ISBN
+(International Standard Book Number)`) to automatically create them in your Odoo database, complete
+with product names, descriptions, images, categories, etc.
+
+.. _barcodelookup/configuration:
+
+## Configuration
+
+If your database is hosted on **Odoo Online**, you can use Barcode Lookup without configuration.
+
+If your database is hosted on **Odoo.sh** or **on-premise**, proceed as follows:
+
+#. Visit the [Barcode Lookup website ](https://www.barcodelookup.com/api) and click
+   :guilabel:`Sign Up for the API`.
+#. Choose the appropriate plan based on the number of barcodes you need to scan.
+#. Fill in the required details and complete the registration process.
+#. Copy the API key.
+#. In Odoo, open the Settings app, scroll down to the :guilabel:`Integrations` section, and, under
+   :guilabel:`Barcode Database`, paste the Barcode Lookup :guilabel:`API Key`.
+
+## Use
+
+To fill in product information using Barcode Lookup, create a new product and fill in the
+:guilabel:`Barcode` field. The product's details are then automatically imported from Barcode
+Lookup, updating the following fields: :guilabel:`Name`, :guilabel:`Price`, :guilabel:`Description`,
+:guilabel:`Tax`, :guilabel:`Image`, :guilabel:`Weight`, :guilabel:`Attributes`, :guilabel:`Product
+category`, and :guilabel:`Volume`. You can then modify any field(s) as needed.
+
+.. seealso::
+   :ref:`Create new products during internal transfers using the Barcode Lookup database
+   <barcode/setup/barcodelookup>`.

package/payload/skills/odoo18-docs/references/docs/applications/general/integrations/geolocation.md

@@ -0,0 +1,43 @@
+---
+title: "Geolocation"
+source_url: "https://docs.odoo.sbggai.top/applications/general/integrations/geolocation.html"
+---
+
+===========
+# Geolocation
+
+You can locate contacts or places and generate routes on a map in Odoo.
+
+.. image:: geolocation/contacts.png
+   :alt: Map displaying a contact's location.
+
+To use the feature, open the :guilabel:`Settings` app, and, under the :guilabel:`Integrations`,
+section, activate :guilabel:`Geo Localization`. Then, choose between using the OpenStreetMap or
+Google Places API.
+
+**OpenStreetMap**
+
+OpenStreetMap is a free, open geographic database updated and maintained by volunteers. To use it,
+select :guilabel:`Open Street Map`.
+
+  > **important**:
+>      OpenStreetMap might not always be accurate. You can [join the OpenStreetMap community
+     ](https://www.openstreetmap.org/fixthemap) to fix any issues encountered.
+
+**Google Places API map**
+
+The Google Places API map provides detailed info on places, businesses, and points of interest. It
+supports location-based features like search, navigation, and recommendations.
+
+> **important**:
+>    Using the Google Places API could require [payment to Google
+   ](https://mapsplatform.google.com/pricing/).
+
+To use it, select :guilabel:`Google Place Map` and enter your :ref:`API Key
+<address_autocomplete/generate_api_key>`.
+
+.. image:: geolocation/google-places-api-key.png
+   :alt: Google Places API key
+
+.. seealso::
+   :doc:`/applications/websites/website/configuration/address_autocomplete`

package/payload/skills/odoo18-docs/references/docs/applications/general/integrations/google_translate.md

@@ -0,0 +1,121 @@
+---
+title: "Google Translate"
+source_url: "https://docs.odoo.sbggai.top/applications/general/integrations/google_translate.html"
+---
+
+================
+# Google Translate
+
+*Google Translate* can be used to translate user generated text in the Odoo chatter.
+
+# Google API console
+
+A majority of the setup for integrating *Google Translate* into Odoo is done with the *Google API
+console*. Once the following processes are complete, an *API key* is created to input in Odoo.
+
+.. seealso::
+   [Google Translate setup on Google ](https://cloud.google.com/translate/docs/setup)
+
+## Create a new project
+
+To get started, go to the [Google API Console ](https://console.developers.google.com). Then, log
+in with a *Google Workspace* account, if there is one. If not, log in with a personal Gmail account
+(this should match the email address that has billing attached to it).
+
+Next, click :guilabel:`Create Project` on the far-right of the :guilabel:`OAuth consent screen`.
+
+> **tip**:
+>    If the *Google API Console* has existing projects, click the drop-down menu next to the
+   :guilabel:`Google Cloud` icon, and a pop-over window appears. Next, click :guilabel:`New Project`
+   top-right of the pop-over window.
+
+On the :guilabel:`New Project` screen, rename the :guilabel:`Project name` to `Odoo Translate`, and
+browse for the :guilabel:`Location`. Set the :guilabel:`Location` as the *Google Workspace
+organization*. If a personal Gmail account is being used, leave the :guilabel:`Location` as
+:guilabel:`No Organization`.
+
+.. image:: google_translate/new-project.png
+   :align: center
+   :alt: Project Name and Location for Google OAuth.
+
+Click on :guilabel:`Create` to finish this step.
+
+## API library
+
+Next, the *Cloud Translation API* needs to be installed on this newly-created project. To do that,
+click :menuselection:`Library` in the left menu. Then, search the term `Cloud Translation API`, and
+click into the result. This should be a *Google Enterprise API* labeled :guilabel:`Cloud Translation
+API`.
+
+Click :guilabel:`Enable` to install the library on this project.
+
+> **important**:
+>    Using the *Google Translate* API **requires** a current billing account with [Google
+   ](https://myaccount.google.com/).
+
+Once a billing account is setup with *Google* and the library is enabled, click :guilabel:`Manage`
+to finish configuration on the API.
+
+## Create credentials
+
+Now that the project is set up, and the *Cloud Translation API* is enabled, credentials **must** be
+created. This includes the *API key*.
+
+To begin this process, click :menuselection:`Credentials` in the left sidebar menu.
+
+Then, click :guilabel:`Create Credentials` in the top menu, and select :guilabel:`API key` from the
+drop-down menu.
+
+.. image:: google_translate/api-key.png
+   :align: center
+   :alt: Create an API key in the Google API console.
+
+Copy the :guilabel:`API key` for use in the next section.
+
+> **important**:
+>    For security purposes, the usage of the *API key* can be restricted.
+
+   To do that, go to the *API restrictions* by clicking on :guilabel:`Edit API key` in the pop-over
+   window, or by clicking on the listed API key on the :guilabel:`Credentials` page. From here, key
+   restrictions can be set. This includes setting an application to restrict the use of the API key,
+   and whether this API key can call any API.
+
+   It is recommended that the Odoo *Translate API* be restricted to **only** allow requests from the
+   configured Odoo database and to the *Cloud Translation API*.
+
+   To add the website restriction, click :guilabel:`Websites`, under the :guilabel:`Set an
+   application restriction`. Then, enter the address of the database *Google Translate* is being
+   used in, by clicking on :guilabel:`Add`. Lastly, add the :abbr:`URL (Uniform Resource Locator)`,
+   and click :guilabel:`Done`.
+
+   To restrict use of the key to a selected API, first, select :guilabel:`Restrict key`, under the
+   :guilabel:`API restrictions` section. Then use the drop-down menu to choose the API being
+   configured (*Cloud Translation API*).
+
+> **tip**:
+>    - Save the API key: copy the API key and store it somewhere secure.
+   - Do **not** share the API key publicly or expose it in client-side code.
+
+# Odoo configuration
+
+To access the integration in Odoo, navigate to the :menuselection:`Settings app --> Discuss
+section`. Enter the API key into the field labeled :guilabel:`Message Translation`. Then,
+:guilabel:`Save` the settings, and *Google Translate* can be used in any chatter throughout the
+database.
+
+.. image:: google_translate/odoo-config.png
+   :align: center
+   :alt: Odoo configuration of the API key from the *Google API Console*.
+
+# Translate chatter
+
+To translate a user's text from another language, click the :guilabel:`... (three dot)` icon menu to
+the right of the chatter. Then, select :guilabel:`Translate`. The content translates to the
+*language* set on the user's preferences.
+
+.. image:: google_translate/google-translate.png
+   :align: center
+   :alt: Google Translate present in an Odoo database's chatter.
+
+.. seealso::
+   :ref:`language/install`

package/payload/skills/odoo18-docs/references/docs/applications/general/integrations/mail_plugins/gmail.md

@@ -0,0 +1,159 @@
+---
+title: "Gmail Plugin"
+source_url: "https://docs.odoo.sbggai.top/applications/general/integrations/mail_plugins/gmail.html"
+---
+
+============
+# Gmail Plugin
+
+The *Gmail Plugin* integrates an Odoo database with a Gmail inbox, so users can keep track of all
+their work between Gmail and Odoo, without losing any information.
+
+# Odoo Online users
+
+For databases hosted on Odoo Online (or Odoo.sh), follow the steps below to configure the Gmail
+Plugin.
+
+## Install the Gmail Plugin
+
+First, log in to the Gmail account that the user wishes to connect to Odoo.
+
+From the Gmail inbox, click the plus sign icon on the right side panel to get add-ons. If the side
+panel is not visible, click on the arrow icon at the bottom right corner of the inbox to reveal it.
+
+.. image:: gmail/gmail-side-panel.png
+   :align: center
+   :alt: Plus sign icon on the Gmail inbox side panel.
+
+Then, use the search bar to search for `Odoo` and locate the :guilabel:`Odoo Inbox Addin`.
+
+.. image:: gmail/google-workspace-marketplace.png
+   :align: center
+   :alt: Odoo Inbox Addin on Google Workspace Marketplace.
+
+Or, go directly to the :guilabel:`Odoo Inbox Addin` page on the [Google Workspace Marketplace
+](https://workspace.google.com/marketplace/app/odoo_inbox_addin/873497133275).
+
+Once the plugin is located, click :guilabel:`Install`. Then, click :guilabel:`Continue` to start
+the installation.
+
+Next, select which Gmail account the user wishes to connect to Odoo. Then click :guilabel:`Allow`
+to let Odoo access the Google account. Google will then show a pop-up window confirming that the
+installation was successful.
+
+## Configure the Odoo database
+
+The :guilabel:`Mail Plugin` feature must be enabled in the Odoo database in order to use the Gmail
+Plugin. To enable the feature, go to :menuselection:`Settings --> General Settings`. Under the
+:guilabel:`Integrations` section, activate :guilabel:`Mail Plugin`, and then click
+:guilabel:`Save`.
+
+.. image:: gmail/mail-plugin-setting.png
+   :align: center
+   :alt: The Mail Plugin feature in the Settings.
+
+## Configure the Gmail inbox
+
+In the Gmail inbox, a purple Odoo icon is now visible on the right side panel. Click on the Odoo
+icon to open up the Odoo plugin window. Then, click on any email in the inbox. Click
+:guilabel:`Authorize Access` in the plugin window to grant Odoo access to the Gmail inbox.
+
+.. image:: gmail/authorize-access.png
+   :align: center
+   :alt: The Authorize Access button in the right sidebar of the Odoo plugin panel.
+
+Next, click :guilabel:`Login`. Then, enter the URL of the Odoo database that the user wishes to
+connect to the Gmail inbox, and log in to the database.
+
+> **note**:
+>    Use the general URL for the database, not the URL of a specific page in the database. For
+   example, use `https://mycompany.odoo.com`, not
+   `https://mycompany.odoo.com/web#cids=1&action=menu`.
+
+Finally, click :guilabel:`Allow` to let Gmail access the Odoo database. The browser will then show
+a :guilabel:`Success!` message. After that, close the window. The Gmail inbox and Odoo database are
+now connected.
+
+# Odoo On-Premise users
+
+For databases hosted on servers other than Odoo Online (or Odoo.sh), follow the steps below to
+configure the Gmail Plugin.
+
+> **note**:
+>    As part of their security guidelines, Google requires add-on creators to provide a list of URLs
+   that can be used in actions and redirections launched by the add-on. This protects users by
+   ensuring, for example, that no add-on redirects users toward a malicious website. (Read more on
+   [Google Apps Script ](https://developers.google.com/apps-script/manifest/allowlist-url).)
+
+   Since Odoo can only list the `odoo.com` domain and not every on-premise customer's unique server
+   domain, on-premise customers cannot install the Gmail Plugin from the Google Workspace
+   Marketplace.
+
+## Install the Gmail Plugin
+
+First, access the [GitHub repository ](https://github.com/odoo/mail-client-extensions) for the
+Odoo Mail Plugins. Next, click on the green :guilabel:`Code` button. Then, click
+:guilabel:`Download ZIP` to download the Mail Plugin files onto the user's computer.
+
+.. image:: gmail/gh-download-zip.png
+   :align: center
+   :alt: Download the ZIP file from the Odoo GitHub repository for Mail Plugins.
+
+Open the ZIP file on the computer. Then, go to :menuselection:`mail-client-extensions-master -->
+gmail --> src --> views`, and open the :file:`login.ts` file using any text editor software,
+such as Notepad (Windows), TextEdit (Mac), or Visual Studio Code.
+
+Delete the following three lines of text from the :file:`login.ts` file:
+
+```if (!/^https:\/\/([^\/?]*\.)?odoo\.com(\/|$)/.test(validatedUrl)) {
+        return notify("The URL must be a subdomain of odoo.com");
+   }
+
+This removes the `odoo.com` domain constraint from the Gmail Plugin program.
+
+Next, in the ZIP file, go to :menuselection:`mail-client-extensions-master --> gmail`, and open the
+file called :guilabel:`appsscript.json`. In the :guilabel:`urlFetchWhitelist` section, replace all
+the references to `odoo.com` with the Odoo customer's unique server domain.
+
+Then, in the same :guilabel:`gmail` folder, open the file called :guilabel:`README.md`. Follow the
+instructions in the :guilabel:`README.md` file to push the Gmail Plugin files as a Google Project.
+
+> **note**:
+>    The computer must be able to run Linux commands in order to follow the instructions on the
+   :guilabel:`README.md` file.
+
+After that, share the Google Project with the Gmail account that the user wishes to connect to Odoo.
+Then, click :guilabel:`Publish` and :guilabel:`Deploy from manifest`. Lastly, click
+:guilabel:`Install the add-on` to install the Gmail Plugin.
+
+## Configure the Odoo database
+
+The :guilabel:`Mail Plugin` feature must be enabled in the Odoo database in order to use the Gmail
+Plugin. To enable the feature, go to :menuselection:`Settings --> General Settings`. Under the
+:guilabel:`Integrations` section, activate :guilabel:`Mail Plugin`, and then click :guilabel:`Save`.
+
+.. image:: gmail/mail-plugin-setting.png
+   :align: center
+   :alt: The Mail Plugin feature in the Settings.
+
+## Configure the Gmail inbox
+
+In the Gmail inbox, a purple Odoo icon is now visible on the right side panel. Click on the Odoo
+icon to open up the Odoo plugin window. Then, click on any email in the inbox. Click
+:guilabel:`Authorize Access` in the plugin window to grant Odoo access to the Gmail inbox.
+
+.. image:: gmail/authorize-access.png
+   :align: center
+   :alt: The Authorize Access button in the right sidebar of the Odoo plugin panel.
+
+Next, click :guilabel:`Login`. Then, enter the URL of the Odoo database that the user wishes to
+connect to the Gmail inbox, and log in to the database.
+
+> **note**:
+>    Use the general URL for the database, not the URL of a specific page in the database. For
+   example, use `https://mycompany.odoo.com`, not
+   `https://mycompany.odoo.com/web#cids=1&action=menu`.
+
+Finally, click :guilabel:`Allow` to let Gmail access the Odoo database. The browser will then show
+a :guilabel:`Success!` message. After that, close the window. The Gmail inbox and Odoo database are
+now connected.