diff --git a/content/applications/marketing/events/attendee_experience.rst b/content/applications/marketing/events/attendee_experience.rst index 6d3a86de3ca..072b35726d7 100644 --- a/content/applications/marketing/events/attendee_experience.rst +++ b/content/applications/marketing/events/attendee_experience.rst @@ -10,3 +10,4 @@ Attendee experience attendee_experience/event_tracks.rst attendee_experience/track_manage_talks.rst + attendee_experience/community_rooms.rst diff --git a/content/applications/marketing/events/attendee_experience/community_rooms.rst b/content/applications/marketing/events/attendee_experience/community_rooms.rst new file mode 100644 index 00000000000..d3eabc27f75 --- /dev/null +++ b/content/applications/marketing/events/attendee_experience/community_rooms.rst @@ -0,0 +1,124 @@ +==================== +Community Chat Rooms +==================== + +In the **Events** app, users can create *Jitsi* video conference rooms for event attendees to +connect and discuss topics related to the event. + +Configuration +============= + +To set up community rooms, the *Community Chat Rooms* feature needs to be enabled in the **Events** +settings by navigating to :menuselection:`Events app --> Configuration --> Settings`. In the +*Events* section, enable :guilabel:`Community Chat Rooms` and click :guilabel:`Save`. + +With the *Community Chat Rooms* feature enabled, users can then :ref:`create community rooms +` in the database and publish them on the website. Event attendees can +not only join rooms but also create them directly :ref:`on the website `. + +.. _community_rooms/create-room: + +Create a room +============= + +To create a community room in the database, open the **Events** app, then select or create an event. + +A :icon:`fa-comments-o` :guilabel:`Rooms` smart button appears at the top of the event form. Click +it to open the list of meeting rooms created for the event. + +.. image:: community_rooms/meeting-rooms-list.png + :alt: List of meeting rooms for an event in Odoo Events. + +Meeting room form +----------------- + +To create a new room, click :guilabel:`New`. This opens a form to configure details about the room. + +.. image:: community_rooms/meeting-room-form.png + :alt: Meeting room form in Odoo Events. + +Begin by entering the name of the topic in the :guilabel:`Topic` field. + +Then, complete the information in the following fields: + +- :guilabel:`Event`: Select the corresponding event for the meeting room. This field is + automatically populated. +- :guilabel:`Summary`: Enter a short description of the meeting room's purpose. +- :guilabel:`Audience`: Specify the intended audience of the meeting room. +- :guilabel:`Is Pinned`: Specify whether the meeting room should be pinned on the event website. +- :guilabel:`Max capacity`: Select the maximum number of participants allowed in the room. +- :guilabel:`Language`: Select the language of the meeting. + +The :guilabel:`Chat Room` field is automatically populated with a generated name for the *Jitsi* +conference room. If desired, the user can change this name by clicking the field and modifying any +details on the resulting form. + +Finally, the :guilabel:`Participant count` field automatically populates with the number of +attendees currently in the meeting room. + +Once the meeting room form is complete, a :guilabel:`Reporting` tab appears at the bottom of the +form, allowing users to monitor the :guilabel:`Last activity` date and the :guilabel:`Peak +participants` count for the event. + +Publish meeting room +-------------------- + +After configuring the meeting room form, users must publish the room on the event website to make it +visible for event attendees. To do this, click the :icon:`fa-globe` :guilabel:`Go to Website` smart +button at the top of the meeting room form. + +This opens the meeting room page on the event website, currently invisible to attendees. To publish +it, toggle the :icon:`fa-toggle-off` :guilabel:`Unpublished` button. The meeting room is then +:icon:`fa-toggle-on` :guilabel:`Published` and available for attendees to join. + +.. _community_rooms/website: + +Community rooms on the website +============================== + +Once published, community rooms appear on the event's webpage. To access them, open the **Website** +app and navigate to the :guilabel:`Events` header menu item on the website. Then, select the desired +event to open the event-specific webpage. The sub-menu appears with the :guilabel:`Community` +option. + +.. note:: + If the :guilabel:`Community` sub-menu item is not displayed, the website must first be modified + in the database using the editor mode in order to display the sub-menu. + + To start, click :guilabel:`Edit` in the top corner. In the :guilabel:`Customize` tab, toggle the + :guilabel:`Sub-menu (Specific)` option, then click :guilabel:`Save`. + +.. image:: community_rooms/meeting-rooms-page.png + :alt: Meeting rooms page on event webpage in Odoo Events. + +Clicking the :guilabel:`Community` sub-menu item opens the *Join a room* page, listing all published +meeting rooms, along with information including the topic title, a short summary of the room's +purpose, and the number of participants in the room. Optionally, attendees can also pin a meeting +room by clicking the :icon:`fa-thumb-tack` :guilabel:`(pin)` icon next to the title. + +To join a room, click on the desired topic. This opens the *Jitsi* video conferencing room where +attendees can chat. + +.. image:: community_rooms/meeting-room.png + :alt: Meeting room on event webpage in Odoo Events. + +Create a room as an attendee +---------------------------- + +The *Join a room* page on the event website also features an option for attendees to launch a new +meeting room for a specific topic. + +To create a new meeting room as an attendee, click the :guilabel:`Create a Room` button. This opens +a *Launch a new topic* pop-up window. + +Similar to creating a room in the database, continue by filling in the following details about the +room: + +- :guilabel:`Room Topic`: The name of the topic. +- :guilabel:`Short Summary`: A short description about the meeting's purpose. +- :guilabel:`Target People`: The intended audience of the meeting. +- :guilabel:`Language`: The target language of the meeting. +- :guilabel:`Capacity`: The maximum capacity of the room. + +After completing the form, click :guilabel:`Create` to finish. The room is then created and the +attendee is redirected to the conferencing page. diff --git a/content/applications/marketing/events/attendee_experience/community_rooms/meeting-room-form.png b/content/applications/marketing/events/attendee_experience/community_rooms/meeting-room-form.png new file mode 100644 index 00000000000..e5f6abedf01 Binary files /dev/null and b/content/applications/marketing/events/attendee_experience/community_rooms/meeting-room-form.png differ diff --git a/content/applications/marketing/events/attendee_experience/community_rooms/meeting-room.png b/content/applications/marketing/events/attendee_experience/community_rooms/meeting-room.png new file mode 100644 index 00000000000..6a06288430d Binary files /dev/null and b/content/applications/marketing/events/attendee_experience/community_rooms/meeting-room.png differ diff --git a/content/applications/marketing/events/attendee_experience/community_rooms/meeting-rooms-list.png b/content/applications/marketing/events/attendee_experience/community_rooms/meeting-rooms-list.png new file mode 100644 index 00000000000..3aeee16ceba Binary files /dev/null and b/content/applications/marketing/events/attendee_experience/community_rooms/meeting-rooms-list.png differ diff --git a/content/applications/marketing/events/attendee_experience/community_rooms/meeting-rooms-page.png b/content/applications/marketing/events/attendee_experience/community_rooms/meeting-rooms-page.png new file mode 100644 index 00000000000..148a26d251f Binary files /dev/null and b/content/applications/marketing/events/attendee_experience/community_rooms/meeting-rooms-page.png differ