From 875a0be668597ca482502504e3b5c5a92afce973 Mon Sep 17 00:00:00 2001
From: maad-odoo <maad@odoo.com>
Date: Tue, 18 Feb 2025 12:55:44 +0000
Subject: [PATCH] [FW][FIX] developer/mixins: chatter integration instructions
 in form view

Previously, the chatter integration instructions described an outdated method using fields and widgets. However, the integration approach has changed, requiring only the `<chatter/ >` element in the form view with configurable options. This commit updates the instructions accordingly.

See odoo/odoo@351b047c3726527d8f59c0ba701c8934dd7c9af5

closes odoo/documentation#12087

Forward-port-of: odoo/documentation#12057
Signed-off-by: Victor Feyens (vfe) <vfe@odoo.com>
Signed-off-by: Aditya Maurya (maad) <maad@odoo.com>
---
 content/developer/reference/backend/mixins.rst | 17 ++++++++++-------
 1 file changed, 10 insertions(+), 7 deletions(-)

diff --git a/content/developer/reference/backend/mixins.rst b/content/developer/reference/backend/mixins.rst
index c1b8ce607..ebc5b1e92 100644
--- a/content/developer/reference/backend/mixins.rst
+++ b/content/developer/reference/backend/mixins.rst
@@ -23,8 +23,14 @@ Basic messaging system
 ~~~~~~~~~~~~~~~~~~~~~~
 
 Integrating messaging features to your model is extremely easy. Simply inheriting
-the ``mail.thread`` model and adding the messaging fields (and their appropriate
-widgets) to your form view will get you up and running in no time.
+the ``mail.thread`` mixin and adding the chatter ``<chatter/>`` element to your form
+view will get you up and running in no time. The chatter element supports some
+options to control form behavior:
+
+* ``open_attachments``: Shows attachment section expanded by default
+* ``reload_on_attachment``: Reloads form view when attachments are added/removed
+* ``reload_on_follower``: Reloads form view when followers are updated
+* ``reload_on_post``: Reloads form view when new messages are posted
 
 .. example::
 
@@ -54,11 +60,8 @@ widgets) to your form view will get you up and running in no time.
                 <form string="Business Trip">
                     <!-- Your usual form view goes here
                     ...
-                    Then comes chatter integration -->
-                    <div class="oe_chatter">
-                        <field name="message_follower_ids" widget="mail_followers"/>
-                        <field name="message_ids" widget="mail_thread"/>
-                    </div>
+                    Then comes chatter integration with options you might want to set -->
+                    <chatter open_attachments="True"/>
                 </form>
             </field>
         </record>