📚List of contents

A widget List of contents can group together both text zones and resources from your site, such as a page, a live, a forum, etc.

Create a widget

To create a widget List of contents, click on the New button at the top of the page and then on List of contents. A drawer opens:

• Choose the rendering mode for your widget:

  • Embed: the widget appears as an embed and you can integrate it anywhere on your site or application.

  • Modal: the widget is in a window opened with a button.

  • Drawer: the widget is in a side panel opened with a button.

• Enter a title. 💡 This title will not be visible in the widget integrated into your application.

• Add sections to your widget.

• Click on Create: that's it, your widget is ready to be integrated! 👉 Find out more here.

Modal widget example

Good to know:

• By default, the widget contains a text zone and 2 zones for adding resources.

• You can add up to 40 sections per widget.

Sections management

Adding sections

To add a section, click on one of the 2 buttons at the bottom of the drawer:

• Text section: to add a text zone into which you can insert images, videos, links, etc.

• Spot content: to add a Spot resource. Thanks to the search bar, you can quickly find the content you're looking for.

Types of resources

Each Spot content section is displayed as a clickable card that leads to the resource selected by the admin. Each card showcases the content essential information.

Content type	Information displayed
Forum	- Forum icon, title and description - A Forum tag - The number of topics in the forum
Topic	- Topic title and description - The icon and name of the forum to which it belongs - Topic score and number of replies to this topic
Channel	- Channel icon, title and description - A Channel tag - The number of posts in the channel
Collection	- The icon, title and description of the collection - A Collection tag - The number of pages and links in the collection
Page	- Page cover and title - Collection icon and name - The number of posts on this page
Links	- Link cover and title - Icon and collection name
Lives	- Cover, title, date and time of live event - Type of live (Workshop, Conference) and status (Planned, Live and Ended) - Number of messages on this live
Courses	- Course cover, title and description - A Course tag

Good to know:

If content is deleted by the admin on the Spot, it is no longer listed in the widget.

Reorder sections

You can change the order of sections by drag and drop.

Delete a section

You can delete a widget section by clicking on the Delete icon to the right of the section.

Edit a widget

You can edit a widget in two different ways:

• From the widget list, by clicking on the three small dots to the right of a widget's card and then on Edit.

• From the widget preview window, click on Edit.

The widget drawer opens, where you can :

• Modify the widget's rendering type. Warning, switching your widget type requires you to update the code.

• Modify the widget title

• Modify the order of widget sections

• Add sections (text or Spot content)

• Modify the content of a text section (Warning, you cannot modify a Spot content section; you can only move or delete it).

• Delete a section. Warning, all deletions are final!

Once you've made all your changes, you can save the widget by clicking on Save.

Widget preview

The widget preview depends on its rendering type:

• If it's an Embed or Modale widget: When you click on a widget card, a window opens. In this window, you can see a preview of the widget's rendering in your application or site (in the case of an embed, grey zones materialize the content of your site).

• If it's a Drawer widget: when you click on a widget's card, a side panel opens. Here you can see a preview of how the widget will look in your application or site.

At the bottom of the modal, there are several buttons:

• Get code: gives you the choice between sending the widget code directly by e-mail (with Send instructions) or retrieving and copying the widget code (with Copy code).
• Edit: opens the editing drawer.

Preview of a modal widget

Widget display

Many members of your site or application will be able to access your widget. Don't worry, they'll only see the content to which they have access in the Spot :

• If the member is logged in, he'll see all the content for which he has rights.

• If the member is not logged in, he or she will see content visible to a visitor (i.e. public lives) and Text sections.

To ensure that users can see all widget content, they need to be logged in the widget integration space. To enable that, we recommend you set up SSO authentication.

🔑Single Sign-On

Once SSO has been set up, the JWT token authenticating the user can be transmitted directly to the widget script. Find out more here.

Redirection on clicking on a Spot content card

Each content card is clickable. The content will then open in a new tab. Depending on whether or not embedding is enabled, the redirection may vary.

If the Spot is not embedded, the content will open on go.meltingspot.io.

If the Spot is embedded, we apply the choice you made in your Redirection settings:

• If you have selected No redirection, the content will open on go.meltingspot.io.

• If you have selected SSO users only, the content will open in the embed for SSO-connected members and on go.meltingspot.io for non-connected members.

• If you have selected All users, the content will open in the embed.

If you have embedded your Spot into several domains, you can specify in your widget script which domain the user should be redirected to on click. 👉 More information here.

Deleting a widget

There are 2 ways to delete a widget:

• From the widget card, click on the three small dots on the right, then on Delete.

• From the widget editing drawer, click on the three small dots in the top right-hand corner, then on Delete.

Clicking on either of these two buttons opens a confirmation window.

Warning, all deletions are final!

If you delete a widget in your Spot settings, we recommend you also remove it in the code of your application or site - no worries if you forget, your members will only see an empty insert 😉