This article outlines how to configure and manage prebuilt Embed It widgets.
Overview
Bevy offers a collection of prebuilt widgets sourced from popular social platforms, enabling admins to effortlessly showcase feeds and content from these platforms. These widgets include:
- X (Twitter) embedded timeline widget
- Instagram profile posts
- YouTube playlist
- Facebook public page
- Spotify playlist
How Do Prebuilt Widgets Work?
Prebuilt widgets facilitate the seamless integration of content from diverse sources onto your chapter pages. These widgets comprise of three fundamental elements:
- Embed code: Bevy has built the prebuilt widgets using embed code provided by the respective external content sources; YouTube, X (Twitter), Instagram, Facebook and Spotify.
- Variables: The variable is a unique identifier for the embedded content. It resides in the embed code to ensure that the right content is pulled and displayed for each widget. The Embed It widget design offers an intuitive interface that simplifies the process for admins to configure the variable for each of the prebuilt widgets.
To learn more about the respective variable for each prebuilt widget, see the Prebuilt Widgets Available section.
Please be aware that the embed code for prebuilt widgets cannot be viewed or modified. Bevy's prebuilt widgets come with default code sourced from various origins, limiting their customization options directly within Bevy. However, you can use Embed It's custom widget feature to integrate custom embed code, tailoring the widgets to meet individual preferences and needs.
Accessing and Viewing Prebuilt Widgets
To get started with accessing and viewing the Embed It Prebuilt widgets, follow these basic steps:
- Navigate to the admin dashboard and select the Page Builder tab in the left navigation.
- Select the Widgets tab
-
You can recognize prebuilt widgets by the presence of a Star Badge on their icons.
Prebuilt Widgets Available
X (Twitter) embedded timeline widget
X’s embedded timeline widget gives you the ability to embed a collection of posts (known as a timeline) on your Bevy chapter pages. Bevy’s prebuilt widget for X’s embedded timeline widget utilizes the default embed code and layout settings from X. To learn more about how the X embedded timeline widget code works, see the X help center for How to embed a timeline.
Variables ID for the X widget
The X widget requires an “X handle” to be inputted. The format is the handle name preceded by “@”.
Instagram profile widget
If an Instagram account is public, its profile can be embedded on a chapter page via the Instagram profile prebuilt widget. This widget allows Instagram profiles to be shared along with the username and a link to the Instagram profile. To learn more about how the Instagram profile embed code, see the Instagram help center doc for Embed an Instagram post or profile.
Variables ID for the Instagram profile widget
The Instagram profile widget requires an Account name to be inputted.
YouTube playlist widget
The YouTube playlist prebuilt widget allows admins to add a YouTube video playlist to chapter pages. To learn more about how the YouTube embed code works, see the YouTube help doc for Embed videos & playlists.
Variables ID for the YouTube playlist widget
The YouTube playlist widget requires a Playlist ID to be inputted. To learn more about how to find a YouTube playlist ID, see the YouTube “Share playlist” help doc.
Facebook page plugin widget
The Facebook Page plugin prebuilt widget “lets you easily embed and promote any public Facebook Page on your website. Just like on Facebook, your visitors can like and share the Page…” To learn more about how the Facebook page plugin embed code works, see the Meta/Facebook help doc for Page Plugin.
Variables ID for the Facebook Page Plugin Widget
The Facebook Page plugin widget requires a Page name to be inputted.
Facebook only allows pages with public posts to be embedded on websites/webpages.
Spotify Playlist Widget
The Spotify Playlist prebuilt widget Embeds “allow you to include interactive playlist content from Spotify” in your Bevy chapter pages. To learn more about how the Spotify Playlist embed code works, see the Spotify help doc for Embeds.
Variables ID for the Spotify Playlist Widget
The Spotify Playlist widget requires a “Spotify ID” to be inputted. To learn more about how to find a Spotify ID, see the Spotify “Spotify URIs and IDs” help doc.
Managing and Configuring Prebuilt Widgets
Enabling Prebuilt Widgets
Enabling prebuilt widgets makes them accessible as components within the chapter page builder tool. This grants admins the convenience of adding them to the chapter page default template or individual chapter pages.
To enable a widget, follow these steps:
- Click Setup or Edit for a prebuilt widget.
- Click on the Available on dropdown and select Chapter Page.
- Click Save.
Disabling Prebuilt Widgets
Disabling prebuilt widgets removes them as components within the chapter page builder tool.
To disable a widget, follow these steps:
- Click Edit for a prebuilt widget
- Click on the Available on dropdown and select Disable.
- Click Save.
If a prebuilt widget was previously added to a chapter page canvas, disabling it will render it blank on the canvas.
Setting a Default Variables ID for All Chapter Pages
Admins have the flexibility to edit and configure the variables ID for prebuilt widgets, allowing them to establish default content for all chapter pages.
To set a default variables ID, follow these steps
- Click Setup or Edit for a prebuilt widget
- In the top field, enter an ID
- Please note that IDs are referred to with different names depending on the source platform (see details above for each prebuilt widget)
- If ID is valid a preview of the content of the widget will appear correctly at bottom of modal
- Click Save
Setting Custom Variables for Individual Chapter Pages
If the prebuilt widget is enabled, organizers have the flexibility to configure variables for the prebuilt widget via the chapter settings for their respective chapters.
To learn more about instructions on this functionality, see Chapter Page Widgets help doc.
Please be aware that the embed code for prebuilt widgets cannot be viewed or modified.
Adding Prebuilt Widgets to Chapter Pages
Once you’ve enabled and configured prebuilt widgets via the Admin Widget tab, the widgets are ready and available to be added to your chapter pages via the chapter pagebuilder canvas.
To learn more about detailed instructions, see Chapter Page Builder-Layouts, Elements and Components help doc.