.. _widget_comments:

Виджет «Комментарии»
===============================================

.. contents::
   :depth: 2

Ключ ``comments``

Виджет для отображения комментариев к документу.

.. list-table::
      :widths: 10 40
      :class: tight-table

      * - **Введенные комментарии**
        - |

            .. image:: ../_static/widgets/comment_1.png
                  :width: 600
                  :align: center

      * - **Форма ввода комментария:**
        - | Для ввода текста используется :ref:`визуальный редактор <wysiwyg_editor>`, в котором помимо форматирования текста доступно добавление таблицы, кода, ссылки, файла
          | Чтобы в комментарии упомянуть других пользователей используете **@**

            .. image:: ../_static/widgets/comment_2.png
                  :width: 600
                  :align: center

Пользователь, которого упомянули в комментарии получит письмо следующего вида:

.. image:: ../_static/widgets/comment_5.png
       :width: 500
       :align: center

Максимальное количество символов в комментарии - 5 000. Иначе будет выдана ошибка:

.. image:: ../_static/widgets/comment_4.png
       :width: 600
       :align: center

Подробно о  :ref:`разграничении пользователей различных заказчиков <UNIFIED_PRIVATE_GROUP>`

Транcлирование комментариев при выполнении задачи
-------------------------------------------------

Для включения транслированная комментария при выполнении задачи в виджет комментариев необходимо к типу данных добавить аспект ``task-comments-broadcastable``.

.. important::

       Инпут комментария на форме задачи должен быть добавлен с id ``comment``.

Комментарий, добавленный из задачи помечается тегом с названием задачи.

.. image:: ../_static/widgets/comment_3.png
       :width: 600
       :align: center

Если необходимо выключить добавление комментария из задачи для конкретного рекорда, можно у рекорда выставить свойство ``task-comments-broadcastable:broadcastComments`` в ``false``.