This article provides information on how to enable and setup the Kaltura Browse Search and Embed feature and is intended for KAF administrators.
The Kaltura Browse Search and Embed feature offers different embed options that Admins can configure in the Browseandembed module. Admins
- Allow end users to select from on of the preconfigured players and sizes
- Allow admins to determine players and customize player sizes according to media types.
Configure the Browseandembed module in KAF
To enable the Browseandembed module in KAF
- Login to your KAF application and go to the Kaltura Configuration Management window.
- Scroll down and select the Browseandembed module in the ModulesCustom/core/kaf section.
The Browseandembed Administration page is displayed.
- In the Enabled field, select Yes to enable the Browseandembed module.
For all the Browseandembed module configuration parameters and additional information, see the article Custom/Core Modules/KAF Browseandembed module. This article focus on how to set up the Browse Search and Embed Settings icon.
To configure the embed players and sizes
- In the enableNewBSEUI field, set the value to v3.
- Display or Hide the Embed Settings icon. Set the EmbedSettingsButton. Select ‘Yes’ to display the Embed Settings button, allowing users to change the embed settings before embedding media. If not set, users will not have the option of changing the embed players or their sizes.
- Enter the BSEPlayerID. You can use an existing player ID. Media types other than ‘video’ will load with players set in their dedicated modules (e.g. audioEntry, imageEntry, Quiz, kwebcast). If left empty, the BSE Player will become the default. If the BSE Player is also empty, the KAF main player will be used.
- (Optional for Assignments) - Configure the Assignment Submission Features.
This feature enables an additional pop up screen when selecting media in Browse, Search and Embed to verify if the user is submitting an assignment. If confirmed, the selected entry will be cloned under a different user name to prevent editing and deletion.
Determines the text that will appear on the pop up message when submitting an assignment. In case left empty, the default message will appear.
This sets the highest role level which will see the pop up upon selecting an entry in Browse, Search and Embed.
- Configure the EmbedSettings. The field in this section determine how many players and their respective sizes will be available for embedding media, per the type of media.
- Click +Add Embed Settings.
- Enter the playerDisplayName. In this example, "Player for Marketing".
- Enter the playerId. If the playerID is not set for an entry type in the BSE module, the default entry’s module playerID is used. If that module player is also empty, the main ‘BSEPlayerId’ for that type is used.
- Select the entryType.
- Select whether to set this player as the default player for this type of media.
- Select the embedSizes. Preconfigured sizes are set for you. In the above example, two sizes are checked. If you want to customize the player size, go to the next step.
- (Optional) Click +Add embedSize Custom and enter a value for the “width”x”height” in pixels to add a new embed size. If left empty, the default will be used.
- After configuring one or more embed players, click Save to save the module's configuration.
For example, you can configure multiple players, each with different dimensions. Each player may be configured for a specific type of media entry. The following screen displays two players have been configured for users.
The player named "Player for Marketing" has two sizes configured for embedding. (shown in the figure in Step 7.)
- Determine the display of the embed (whether the display is Auto Play or Thumbnail Embed. Either option should be toggled on/off by the user.
- Set as their default settings for the type of media they are embedding. ( Check the Default settings box to save as default).
Example of Autoplay
Example of Thumbnail Embed