odoo-forge-bundle 0.1.0

package/payload/skills/odoo18-docs/references/docs/applications/websites/website/configuration/spam_protection.md

@@ -0,0 +1,149 @@
+---
+title: "Forms spam protection"
+source_url: "https://docs.odoo.sbggai.top/applications/websites/website/configuration/spam_protection.html"
+---
+
+=====================
+# Forms spam protection
+
+:ref:`Cloudflare Turnstile <cloudflare-turnstile>` and :ref:`Google reCAPTCHA v3 <google-recaptcha>`
+protect website forms against spam and abuse. They attempt to distinguish between human and bot
+submissions using non-interactive challenges based on telemetry and visitor behavior.
+
+> **important**:
+>    We recommend using **Cloudflare Turnstile** as reCAPTCHA v3 may not be compliant with local data
+   protection regulations.
+
+> **note**:
+>    All pages using the :guilabel:`Form`, :guilabel:`Newsletter Block`, :guilabel:`Newsletter Popup`
+   snippets, and the eCommerce :guilabel:`Extra Step During Checkout` form are protected by both
+   tools.
+
+.. seealso::
+   - [Cloudflare Turnstile's documentation ](https://developers.cloudflare.com/turnstile/)
+   - [Google's reCAPTCHA v3 guide ](https://developers.google.com/recaptcha/docs/v3)
+
+.. _cloudflare-turnstile:
+
+# Cloudflare Turnstile configuration
+
+## On Cloudflare
+
+- [Create ](https://dash.cloudflare.com/sign-up) a Cloudflare account or use an existing one and
+  [log in ](https://dash.cloudflare.com/login).
+- On the dashboard navigation sidebar, click :guilabel:`Turnstile`.
+- On the :guilabel:`Turnstile Sites` page, click :guilabel:`Add Site`.
+- Add a :guilabel:`Site name` to identify it easily.
+- Enter or select the website's :guilabel:`Domain` (e.g., *example.com* or *subdomain.example.com*).
+- Select a :guilabel:`Widget Mode`:
+
+  - The :guilabel:`Managed` mode is **recommended**, as visitors can be prompted to check a box
+    confirming they are human if deemed necessary by Turnstile.
+
+    .. image:: spam_protection/turnstile-human.png
+       :alt: Cloudflare Turnstile human verification widget
+
+  - For the :guilabel:`Non-interactive` and :guilabel:`Invisible` modes, visitors are never
+    prompted to interact. In :guilabel:`Non-interactive` mode, a loading widget can be displayed to
+    warn visitors that Turnstile protects the form; however, the widget is not supported by Odoo.
+
+    > **note**:
+>        If the Turnstile check fails, visitors are not able to submit the form, and the following
+       error message is displayed:
+
+       .. image:: spam_protection/turnstile-error.png
+          :alt: Cloudflare Turnstile verification error message
+
+- Click :guilabel:`Create`.
+
+.. image:: spam_protection/turnstile-configuration.png
+   :alt: Adding a website to Cloudflare Turnstile
+
+The generated keys are then displayed. Leave the page open for convenience, as copying the keys in
+Odoo is required next.
+
+## On Odoo
+
+- From the database dashboard, click :guilabel:`Settings`. Under :guilabel:`Integrations`, enable
+  :guilabel:`Cloudflare Turnstile` and click :guilabel:`Save`.
+- Open the Cloudflare Turnstile page, copy the :guilabel:`Site Key`, and paste it into the
+  :guilabel:`CF Site Key` field in Odoo.
+- Open the Cloudflare Turnstile page, copy the :guilabel:`Secret Key`, and paste it into the
+  :guilabel:`CF Secret Key` field in Odoo.
+- Click :guilabel:`Save`.
+
+> **tip**:
+>    Navigate to Turnstile on your Cloudflare account to view the solve rates and access more
+   settings.
+
+.. _google-recaptcha:
+
+# reCAPTCHA v3 configuration
+
+> **warning**:
+>    reCAPTCHA v3 may not be compliant with local data protection regulations.
+
+## On Google
+
+Open [the reCAPTCHA website registration page ](https://www.google.com/recaptcha/admin/create). Log
+in or create a Google account if necessary.
+
+On the website registration page:
+
+- Give the website a :guilabel:`Label`.
+- Leave the :guilabel:`reCAPTCHA type` on :guilabel:`Score based (v3)`.
+- Enter one or more :guilabel:`Domains` (e.g., *example.com* or *subdomain.example.com*).
+- Under :guilabel:`Google Cloud Platform`, a project is automatically selected if one was already
+  created with the logged-in Google account. If not, one is automatically created. Click
+  :guilabel:`Google Cloud Platform` to select a project yourself or rename the automatically created
+  project.
+- Agree to the terms of service.
+- Click :guilabel:`Submit`.
+
+.. image:: spam_protection/recaptcha-google-configuration.png
+   :alt: reCAPTCHA website registration example
+
+A new page with the generated keys is then displayed. Leave it open for convenience, as copying the
+keys to Odoo is required next.
+
+## On Odoo
+
+- From the database dashboard, click :guilabel:`Settings`. Under :guilabel:`Integrations`, enable
+  :guilabel:`reCAPTCHA` if needed.
+
+  > **warning**:
+>      Do not disable the :guilabel:`reCAPTCHA` feature or uninstall the :guilabel:`Google reCAPTCHA
+     integration` module, as many other modules would also be removed.
+
+- Open the Google reCAPTCHA page, copy the :guilabel:`Site key`, and paste it into the
+  :guilabel:`Site Key` field in Odoo.
+- Open the Google reCAPTCHA page, copy the :guilabel:`Secret key`, and paste it into the
+  :guilabel:`Secret Key` field in Odoo.
+- Change the default :guilabel:`Minimum score` (`0.70`) if necessary, using a value between `1.00`
+  and `0.00`. The higher the threshold is, the more difficult it is to pass the reCAPTCHA, and vice
+  versa.  Out of the 11 levels, only the following four score levels are available by default:
+  `0.1`, `0.3`, `0.7` and `0.9`.
+- Click :guilabel:`Save`.
+
+.. seealso::
+   [Interpret reCAPTCHA scores - Google documentation ](https://cloud.google.com/recaptcha/docs/interpret-assessment-website#interpret_scores)
+
+You can notify visitors that reCAPTCHA protects a form. To do so, open the website editor and
+navigate to the form. Then, click somewhere on the form, and on the right sidebar's
+:guilabel:`Customize` tab, toggle :guilabel:`Show reCAPTCHA Policy` found under the :guilabel:`Form`
+section.
+
+.. image:: spam_protection/recaptcha-policy.png
+   :alt: reCAPTCHA policy message displayed on a form
+
+> **note**:
+>    If the reCAPTCHA check fails, the following error message is displayed:
+
+   .. image:: spam_protection/recaptcha-error.png
+      :alt: Google reCAPTCHA verification error message
+
+> **tip**:
+>    Analytics and additional settings are available on [Google's reCAPTCHA administration page
+   ](https://www.google.com/recaptcha/admin/). For example, you can receive email alerts if Google
+   detects suspicious traffic on your website or view the percentage of suspicious requests, which
+   could help you determine the right minimum score.

package/payload/skills/odoo18-docs/references/docs/applications/websites/website/configuration/translate.md

@@ -0,0 +1,112 @@
+---
+title: "Translations"
+source_url: "https://docs.odoo.sbggai.top/applications/websites/website/configuration/translate.html"
+---
+
+============
+# Translations
+
+Your website is displayed in the language that matches your visitor’s browser. If the browser’s
+language has not been installed and added to your website, the content is shown in the
+:ref:`default language <translate/default-language>`. When additional languages are installed, users
+can choose their preferred language using the :ref:`language selector <translate/language-selector>`.
+
+The :ref:`Translate <translate/translate>` feature on your website allows automatic translation of
+standard terms and provides a tool for manual content translation.
+
+# Install languages
+
+To allow translation of your website, you must first :doc:`install <../../../general/users/language>`
+the required languages and add them to your website. To do so, go to :menuselection:`Website -->
+Configuration --> Settings` and click :icon:`fa-arrow-right` :guilabel:`Install languages` in the
+:guilabel:`Website Info` section. In the dialog box that opens, select the :guilabel:`Languages` you
+want from the dropdown menu, tick the required :guilabel:`Websites to translate`, and
+click :guilabel:`Add`.
+
+To edit your website's languages, go to :menuselection:`Website -–> Configuration -–> Settings` and
+add/remove the required languages in/from the :guilabel:`Languages` field in the
+:guilabel:`Website info` section.
+
+> **tip**:
+>    Alternatively, once the languages have been installed, you can add them from the :ref:`language
+   selector <translate/language-selector>`. You might then need to refresh your page to see the new
+   language.
+
+.. _translate/default-language:
+
+## Default language
+
+When multiple languages are available on your website, you can set a default language to be used if
+the visitor’s browser language is not available. To do so, go to :menuselection:`Website –->
+Configuration -–> Settings`, and select a language in the :guilabel:`Default` field.
+
+> **note**:
+>    This field is only visible if multiple languages have been installed and added to your website.
+
+.. _translate/language-selector:
+
+# Language selector
+
+Your website’s visitors can switch languages using the language selector, available by default in
+the :guilabel:`Copyright` section at the bottom of the page. To edit the language selector menu:
+
+#. Go to your website and click :guilabel:`Edit`;
+#. Click the language selector available in the :guilabel:`Copyright` block and go to the
+   :guilabel:`Copyright` section of the website builder;
+#. Set the :guilabel:`Language Selector` field to either :guilabel:`Dropdown` or :guilabel:`Inline`.
+   Click :guilabel:`None` if you do not want to display the  :guilabel:`Language selector`;
+
+     .. image:: translate/language-selector.png
+        :alt: Add a language selector menu.
+
+#. Click :guilabel:`Save`.
+
+> **tip**:
+>   You can also add the :guilabel:`Language Selector` to the :guilabel:`Header` of your page. To do
+  so, click the :guilabel:`Header` block and go to the :guilabel:`Navbar` section to edit the
+  :guilabel:`Language Selector`.
+
+.. _translate/translate:
+
+# Translate your website
+
+Select your desired language from the language selector to see your content in another language.
+Then, click the :guilabel:`Translate` button in the top-right corner to manually activate the
+translation mode so that you can translate what has not been translated automatically by Odoo.
+
+Translated text strings are highlighted in green; text strings that were not translated
+automatically are highlighted in yellow.
+
+.. image:: translate/translated-text.png
+  :alt: Entering the translation mode
+
+In this mode, you can only translate text. To change the page's structure, you must edit the master
+page, i.e., the page in the original language of the database. Any changes made to the master page
+are automatically applied to all translated versions.
+
+To replace the original text with the translation, click the block, edit its contents, and
+:guilabel:`Save`.
+
+> **note**:
+>   When a website supports multiple languages, the core URL structure remains consistent across
+  languages, while specific elements like product names or categories are translated. For example,
+  `https://www.mywebsite.com/shop/product/my-product-1` is the English version of a product page,
+  while `https://www.mywebsite.com/fr/shop/product/mon-produit-1` is the French version of the same
+  page. The structure (/shop/product/) stays unchanged, but the translated elements (e.g., product
+  name) adapt to the selected language.
+
+> **tip**:
+>   Once the desired language is installed, you can translate some items from the backend (e.g., the
+  product's name in the product form). To do so, click the language code (e.g., :guilabel:`EN`) next
+  to the text you want to translate and add the translation.
+
+## Content visibility by language
+
+You can hide content (such as images or videos, for example) depending on the language. To do so:
+
+#. Click :guilabel:`Edit` and select an element of your website;
+#. Go to the :guilabel:`Text - Image` section and :guilabel:`Visibility`;
+#. Click :guilabel:`No condition` and select :guilabel:`Conditionally` instead;
+#. Go to :guilabel:`Languages` to configure the condition(s) to apply by selecting
+   :guilabel:`Visible for` or :guilabel:`Hidden for`, and click :guilabel:`Choose a record` to
+   decide which languages are impacted.

package/payload/skills/odoo18-docs/references/docs/applications/websites/website/configuration.md

@@ -0,0 +1,20 @@
+---
+title: ""
+source_url: "https://docs.odoo.sbggai.top/applications/websites/website/configuration.html"
+---
+
+:nosearch:
+# 
+# Configuration
+
+.. toctree::
+   :titlesonly:
+
+   configuration/domain_names
+   configuration/address_autocomplete
+   configuration/google_search_console
+   configuration/cookies_bar
+   configuration/translate
+   configuration/multi_website
+   configuration/spam_protection
+   configuration/cdn

package/payload/skills/odoo18-docs/references/docs/applications/websites/website/mail_groups.md

@@ -0,0 +1,129 @@
+---
+title: "Mail groups"
+source_url: "https://docs.odoo.sbggai.top/applications/websites/website/mail_groups.html"
+---
+
+===========
+# Mail groups
+
+The **mail groups** feature allows website visitors to have a public discussion by email. They can
+join a group to receive emails from other group members (i.e., website users who have subscribed to
+the group) and send new ones to all group members.
+
+To activate the feature, :ref:`install <general/install>` the :guilabel:`Website Mail Group`
+(`website_mail_group`) module.
+
+> **note**:
+>    The **mail groups** feature is not to be confused with the
+   :doc:`../../marketing/email_marketing/mailing_lists` in the Email Marketing app.
+
+.. _website/mailing_lists/configure_groups:
+
+# Configuring mail groups
+
+To configure mail groups, proceed as follows:
+
+#. Configure a custom email alias domain by accessing the **General settings**, scrolling down to
+   the :guilabel:`Discuss` section, enabling the :guilabel:`Custom Email Server` feature, and
+   entering the :guilabel:`Alias domain` (e.g., `@mycompany.com`).
+#. Go to :menuselection:`Website --> Configuration --> Mailing Lists`, then click :guilabel:`New`.
+#. Specify a :guilabel:`Group Name`, the :guilabel:`Email Alias`, and a :guilabel:`Description`.
+#. Enable :guilabel:`Moderate this group` and specify the :guilabel:`Moderators` if you wish to
+   :ref:`moderate messages <website/mailing_lists/moderate>` from this group. Alternatively, if the
+   group is not moderated, you can define :guilabel:`Responsible Users` who can manage the messages
+   in the group.
+#. In the :guilabel:`Privacy` tab, define who can subscribe to the mail group:
+
+   - :guilabel:`Everyone`: to make the mail group public so anyone can subscribe to it;
+   - :guilabel:`Members only`: to only allow users defined as members to subscribe to the mail group;
+   - :guilabel:`Selected group of users`: to only allow users from the :guilabel:`Authorized group`
+     to subscribe to the mail group.
+
+#. If the mail group is moderated, you can automatically notify authors when their message is
+   pending moderation by enabling :guilabel:`Automatic notification` in the :guilabel:`Notify
+   Members` tab and writing the :guilabel:`Notification message`.
+#. If you wish to send out guidelines to new subscribers, enable :guilabel:`Send guidelines to new
+   subscribers` and write them in the :guilabel:`Guidelines` tab. This is particularly useful when
+   the mail group is moderated.
+
+# Using mail groups
+
+## Subscribing/unsubscribing
+
+Based on the :ref:`configuration of the mail group <website/mailing_lists/configure_groups>`,
+users can subscribe to and unsubscribe from mail groups from the website page (`/groups` by default).
+
+.. image:: mail_groups/mail-group-page.png
+   :alt: Mail group web page.
+
+Internal users can also do this from :menuselection:`Website --> Configuration --> Mailing Lists`,
+using the :guilabel:`Join` and :guilabel:`Leave` buttons.
+
+## Sending messages
+
+To send messages to a mail group, website users can email the :ref:`mail group's email address
+<website/mailing_lists/configure_groups>`. Internal users can also create messages directly from
+Odoo. To do so, go to :menuselection:`Website --> Configuration --> Mailing Lists`, select the mail
+group, click the :guilabel:`Emails` smart button, and click :guilabel:`New`. Then, fill in the
+fields and click :guilabel:`Send`.
+
+> **tip**:
+>    - The list of messages can also be accessed by selecting the group from the `/groups` website
+     page.
+   - Group members can also unsubscribe from the group, access the mail group page, and send emails
+     to the group using the URLs in the footer of any group email they have received.
+
+     .. image:: mail_groups/mail-group-URLs.png
+        :alt: URLs in the footer of a group email.
+
+.. _website/mailing_lists/moderate:
+
+# Moderating mail group messages
+
+If the :guilabel:`Moderate this group` feature has been enabled for the
+:ref:`mail group <website/mailing_lists/configure_groups>`, one of the :guilabel:`Moderators` must
+approve the group's messages before they are dispatched to the other members.
+
+To moderate messages, go to :menuselection:`Website --> Configuration --> Mailing Lists`, select the
+mail group, and click the :guilabel:`To review` smart button. You can moderate messages using the
+buttons at the end of the message line or select a message to view its content and moderate it
+accordingly.
+
+   .. image:: mail_groups/mail-group-moderation.png
+      :alt: Moderation buttons in the message line.
+
+The following actions are available:
+
+- :guilabel:`Accept`: to accept the email and send it to the mail group members.
+- :guilabel:`Reject`: to reject the email. In the pop-up window that opens, click
+  :guilabel:`Reject Silently` to reject the email without notifying the author, or specify an
+  explanation for rejecting the message, then click :guilabel:`Send & Reject` to reject the message
+  and send the explanation to the author.
+- :guilabel:`Whitelist`: to whitelist the author, i.e. automatically accept all of their emails. As
+  a result, a :ref:`moderation rule <website/mailing_lists/moderate>` is created for the author's
+  email address with the status :guilabel:`Always allow`.
+- :guilabel:`Ban`: to blacklist the author, i.e. automatically discard all their emails. In the
+  pop-up window that opens, click :guilabel:`Ban` to ban the author without notifying them, or
+  specify an explanation, then click :guilabel:`Send & Ban` to ban the author and send them the
+  explanation. As a result, a :ref:`moderation rule <website/mailing_lists/moderate>` is created for
+  the author's email address with the status :guilabel:`Permanent ban`.
+
+> **note**:
+>    Messages can also be moderated from the group's list of messages. Go to :menuselection:`Website
+   --> Groups --> Mailing List Groups`, select the mail group and click the :guilabel:`Emails` smart
+   button.
+
+.. _website/mailing_lists/moderation_rules:
+
+# Whitelisting/Blacklisting authors
+
+You can whitelist or blacklist an author either directly :ref:`from a mail group message
+<website/mailing_lists/moderate>`, or by creating a moderation rule. To do so, go to
+:menuselection:`Website --> Configuration --> Moderation Rules` and click :guilabel:`New`. Then,
+select the :guilabel:`Group`, specify the author's :guilabel:`Email` and set the :guilabel:`Status`
+field.
+
+> **tip**:
+>    You can also access the mail group's moderation rules by going to :menuselection:`Website -->
+   Configuration --> Mailing Lists`, selecting the group, then clicking the :guilabel:`Moderations`
+   smart button.

package/payload/skills/odoo18-docs/references/docs/applications/websites/website/pages/menus.md

@@ -0,0 +1,95 @@
+---
+title: "Menus"
+source_url: "https://docs.odoo.sbggai.top/applications/websites/website/pages/menus.html"
+---
+
+=====
+# Menus
+
+Menus are used to organize your website’s content and help visitors navigate through your web pages
+effectively. User-friendly and well-structured website menus also play a crucial role in improving
+:doc:`search engine rankings <seo>`.
+
+Odoo allows you to customize the content and appearance of your website's menu to your needs.
+
+# Menu editor
+
+The menu editor allows you to edit your website's menu and add :ref:`regular menu items
+<website/regular-menus>` and :ref:`mega menus <website/mega-menus>`.
+
+To edit your website's menu, go to :menuselection:`Website --> Site --> Menu Editor`. From there,
+you can:
+
+- **rename** a menu item or change its URL using the :guilabel:`Edit Menu Item` icon;
+- **delete** a menu item using the :guilabel:`Delete Menu Item` icon;
+- **move** a menu item by dragging and dropping it to the desired place in the menu;
+- **create a regular drop-down menu** by dragging and dropping the sub-menu items to the right,
+  underneath their parent menu.
+
+.. image:: menus/menu-editor.png
+   :alt: Menu editor with sub-menus
+
+> **note**:
+>   You can also access the menu editor by clicking :guilabel:`Edit`, selecting any menu item and
+  clicking the :guilabel:`Edit Menu` icon.
+
+  .. image:: menus/edit-menu-icon.png
+     :alt: Access the Menu editor while in Edit mode.
+
+.. _website/regular-menus:
+
+## Adding regular menu items
+
+By default, pages are added to the menu as regular menu items when :doc:`they are created
+<../pages>`. You can also add regular menu items from the menu editor by clicking :guilabel:`Add
+Menu Item`. Enter the :guilabel:`Name` and URL of the related page in the pop-up window that appears
+on the screen and click :guilabel:`OK`.
+
+> **tip**:
+>    In the :guilabel:`URL or Email` field, you can type `/` to search for a page on your website or
+   `#` to search for an existing custom anchor.
+
+.. _website/mega-menus:
+
+## Adding mega menus
+
+Mega menus are similar to drop-down menus, but instead of a simple list of sub-menus, they display a
+panel divided into groups of navigation options. This makes them suitable for websites with large
+amounts of content, as they can help include all of your web pages in the menu while still making
+all menu items visible at once. Mega menus can also be structured more visually than regular
+drop-down menus, for example, through layout, typography, and icons.
+
+.. image:: menus/mega-menu.png
+   :alt: Mega menu in the navigation bar.
+
+To create a mega menu, go to :menuselection:`Website --> Site --> Menu Editor` and click
+:guilabel:`Add Mega Menu Item`. Enter the :guilabel:`Name` of the mega menu in the pop-up, click
+:guilabel:`OK`, then :guilabel:`Save`.
+
+To adapt the options and layout of the mega menu, click it in the navigation bar, then click
+:guilabel:`Edit`. Mega menus are composed of building blocks, which means you can customize each
+component individually using inline formatting, as well as the options available in the
+:guilabel:`Customize` tab in the website builder. For example, you can:
+
+- edit the text directly in the building block;
+- edit a menu item's URL by selecting the menu item, then clicking the :guilabel:`Edit link` button
+  in the small preview pop-up. Type `/` to search for a page on your website, or `#` to search for
+  an existing custom anchor.
+
+  .. image:: menus/mega-menu-option.png
+     :alt: Edit a mega menu option.
+
+- move a menu item by dragging and dropping the related block to the desired position in the mega
+  menu;
+- delete a menu item by deleting the related block.
+
+> **tip**:
+>    You can adapt the general layout of the mega menu by selecting the desired :guilabel:`Template`
+   and :guilabel:`Size` in the :guilabel:`Mega menu` section in the :guilabel:`Customize` tab in the
+   website builder.
+
+# Header and navigation bar appearance
+
+To customize the appearance of your website's menu, click :guilabel:`Edit`, then select the
+navigation bar or any menu item. You can then adapt the fields in the :guilabel:`Header` and
+:guilabel:`Navbar` sections in the :guilabel:`Customize` tab in the website builder.