[FIX] mixins: update 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.

X-original-commit: a00a6f5583
This commit is contained in:
maad-odoo 2025-02-13 06:51:50 +00:00
parent 331c2d20af
commit ae62859d2e

View File

@ -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>