In this topic you will learn about how to use the People Widget using the Immersion Gallery Template.

People Widget on the Immersion Gallery template

The people widget lets you highlight people on your page. This is very helpful when you have an event and want to showcase the presenters.

Create a Widget

First, you must create a custom page on an Immersion Experience to use an Agenda Widget implementation. Follow these steps:

  1. In the left navigation, click Gallery.

    gallery
    gallery module
  2. Choose Immersion. You can create a new Immersion page or select a previously created one. For more information, see Working with the Immersion Portal Template.
    immersion
    immersion
  3. In Experience Overview, customize your experience. Add a description and select the experience language. Then, click Create Experience.
    experience overview
    experience overview
  4. Create a custom page. Click + Add a Page and configure the page name and path.
    custom-page
    custom-page
  5. Once the custom page has been created, click the add a section button.
    add a section
    add a section
  6. Click People.
    add people
    add people

If you haven't added any people yet:

  1. Click the Select people button.

    select-people
    select-people
  2. Notice how a modal titled New People Section appears.
    create people
    create people
  3. Click the Add people button within this modal to be redirected to the Agenda Module, where you can create people.
  4. After creating people, return to the Custom Page experience to proceed with selection and ordering.

If you already have added people:

  1. Back on the Custom Page, click Select People again in the People Section to reopen the New People Section modal.
  2. The modal has two tabs:
    • Select People: This tab displays those previously added to the Agenda Module.
    • Display Order: This tab is initially disabled. In this tab, the selected people will be displayed, and we will be able to reorder them.
    selecting people
    select people modal

Using the Select People Tab

  • The tab includes a Search Input to filter people by name. If we type in the search input field, an alert shows up with the following message:
    search input
    search input
  • An Add people button allows users to add more people by redirecting them back to the Agenda Module if necessary.
  • The list of people includes columns for Name, Role/Job Position, and Company.
  • At the top of the list, a master checkbox allows users to select or deselect all people simultaneously, while individual checkboxes enable specific person selections.
  • The Next button is initially disabled. When at least one person is selected, the button becomes enabled, allowing users to proceed to the next tab.

Accessing the Display Order Tab

  • After clicking the Next button, users are directed to the Display Order tab, which only displays the people selected in the previous step.
  • This tab replaces checkboxes with a drag icon next to each person. Hovering over this icon changes the cursor to a "grabbing" hand, indicating that items can be dragged.
    display order
    display order

Reordering People with Drag-and-Drop

  • Users can rearrange people by dragging them within the list. The Order column shows numbers starting from 1, reflecting each person's position.
  • When a person is moved to a new position (e.g., moving #3 to #1), the order numbers automatically update to reflect the new sequence.

Saving the Custom Order

  • Once the desired order is set, clicking Save finalizes it and stores it directly within the People Custom Section.

    people custom order
    people custom order

How To:

Editing People

To edit the people you added, follow these steps:

  1. Click the people widget, and then click Edit.

    people widget
    people widget
  2. It immediately sends you to the People page. Click on the ... next to the user you want to edit, then click Edit.
    Edit one person
    Edit one person
  3. Edit the data.
    edit Jose
    edit Jose
  4. Click Save.

Deleting People

To delete the people widget follow these steps:

  1. Click the people widget, and then click Delete.
    removing people
    removing people

Deleting One Person

Let's suppose that one or more people cannot attend an event, and we want to remove it without removing the whole widget. To do so, follow these steps:

  1. Click the people widget, and then click Edit.

    people widget
    people widget
  2. It immediately sends you to the People page. Click on the ... next to the user you want to remove, then click Delete.
    remove one by one
    remove one by one
  3. .
  4. Click Delete
    delete person
    delete person

Removing a person from the component without deleting them from the database.

The following video shows removing a person without deleting them from the database.