Modules

Accessibility module

Field	Description
enabled	Enable the Accessibility Module.
showContrastButton	Show a button that allows users to toggle contrast on site pages
loadMore	Navigate to the Application module to enable the load more button at the bottom of each media list.

Addcontent module

Addtoplaylists module

Advancedkauth

Field	Description
enabled
linkExpiration	expiration (in seconds)
resetPasswordEmailTemplate	email templates as configured in the EmailTemplates module . Use the template for the Forgot password request.
passwordConfirmEmailTemplate	email templates as configured in EmailTemplates module. Use the yemplate for the confirmation of a password change.

Adminaccess module

Attachments module

Authbroker module

About

AuthBroker is a "gateway" that sits on the partner (account) level and manages authentication to Kaltura via external Identity providers (IdP). AuthBroker works with the Security Assertion Markup Language (SAML) and Open Authorization (OAuth 2.0) protocols. AuthBroker users are "shared users" (users who are shared between applications / instances in the partner).

AuthBroker works with a higher version of SAML and you no longer need to set up a new profile for each new account. You can set up profile(s) just once and easily use them in multiple applications/instances.

To use Authbroker, you must first subscribe to the applicationRegistry, and have a virtual event ID in the Application module. After configuring the AuthBroker module, you must also make one configuration in the Auth module - set authNAdapter to "Kaltura Auth Broker - {name of application}" and authZAdapter to "Kaltura Auth Broker".

Prerequisite

Before connecting the KMC and Event accounts to AuthBroker, you must have created a SAML profile using the steps in Create and Manage SAML Profiles.

Configure

The AuthBrokermodule lets you enable new authentication methods by registering with the available Auth profiles on your account. Once subscribed, ensure to set up the Auth method in the Auth module. Remember to set a main alias and register your application in the Application module first.

If you don't see this module in your Configuration Management console, please contact your account representative to enable it.

Go to your Configuration Management console, and navigate to the Authbroker module. Your link should look like this: https://{your_KMS_URL}/admin/config/tab/authbroker.

The Authbroker window displays.

Enable the module

enabled - Set to 'Yes' to enable the module. When enabled, admins can activate new authentication methods by registering with the available Auth profiles on the account.

Link to page

Click Subscription page. (Please note that you must enable the module first in order to access the Subscription page.)
The authentication profile subscription window displays. Here you can view all the authentication profiles that were created on your account in KMC.

If there are no profiles on the subscription page, you can learn how to create them in our article Create and manage SAML profiles.

To subscribe, just click the toggle on.
When toggled on, your Kaltura Video Portal (aka MediaSpace) can now use that authentication profile. If a few profiles were created, you have the option to subscribe to as many as you want.

Once you have subscribed to a profile, you can configure the settings for it, as follows:

defaultRole - Choose a default role from the drop-down menu for all users authenticating via the authentication profile(s) selected in the subscription page:

viewerRole
privateOnlyRole
adminRole
unmoderatedAdmin

rolesMapping

Role mapping lets you assign specific application roles to users based on their profile information, rather than only relying on a default role. With role mapping, you can link users to designated roles by setting values in their profiles. When users log in, the system checks for these values and assigns the appropriate role. If no specific value is found, it falls back to the default role.

Click +Add "rolesMapping".
The rolesMapping section displays.
fieldLocation - Select where the IDP attribute is stored on the Kaltura partner level - within the User object or User profile. (An IDP attribute refers to specific information or data associated with a user's identity within an Identity Provider system. This attribute could include details such as the user's first name, last name, email address, country, or any other information relevant to their identity and access privileges.)
fieldName - Enter the name of the field you want to use for mapping the respective object, for example, 'country'.
fieldValue - Enter the value that should map to an application role, for example, 'US'.
applicationRole - Choose a role from the drop-down menu that will be assigned if there’s a match for the value in the field.
- viewerRole
- privateOnlyRole
- adminRole
- unmoderatedAdmin

defaultGroups

Set default groups for all users authenticated via the Auth profiles selected in this module.

Click +Add "defaultGroups".
Type in a label, for example, 'AB_users', so that everyone who logs in will be added to this group ID.

useInternalLogoutPage - Select 'Yes' or 'No' to use Kaltura's internal logout page instead of redirecting the user to the IDP once logout from the video portal has finished.

If you select 'No', a window will appear prompting you to enter the URL where the user should be redirected after logging out, for example, 'video.kaltura.com/logout'.

Finally, click Save to save your configuration settings.

Quick start instructions for using Authbroker login

Pre-start

Create a SAML profile in the KMC.
Navigate to the Application module (https://{your_KMS_URL}/admin/config/tab/application). Enter a virtual event Id and subscribe to the applicationRegistry.

Step 1: Authbroker module

Navigate to the Authbroker module (https://{your_KMS_URL}/admin/config/tab/authbroker).
Click Subscription page. (Please note that you must enable the module first in order to access the Subscription page.)
The Authentication profile subscription page displays.
Next to the desired profile, click the toggle on.
Click Save.

Step 2: Auth module

Navigate to the Auth module (https://{your_KMS_URL}/admin/config/tab/auth).
authNAdapter - set to Kaltura Auth Broker - {name of your application}
authZAdapter - set to Kaltura Auth Broker
Click Save.

To learn more about the Auth module and its capabilities, check out our article Auth Module.

Captions

Field	Description
enabled	Enable the Captions Module.
thumbnailRotator	Enable thumbnail image rotation on mouseover in the captions search results
entriesPageSize	How many entries are displayed as captions search results on each page? (The default is 10)
captionsPageSize	How many caption lines are displayed for each entry in search results? (The default is 5)
allowToggleDisplayOnPlayer	Select "Yes" to allow the user to decide whether to display the caption on the player.
allowEditCaptions	Select "Yes" to enable the Caption Editor button in the Captions tab.
maxCharsPerLine	Editor: Max char per caption line.
preventSaveOnOverlap	Editor: do not allow saving changes if there is time overlapping.

Channelplaylists module

Chapters

The Chapters module enables adding, editing and viewing chapters and slides on a media entry.

About

The basic configuration of enable/disable is in the Chapters module in KMS or KAF Admin page.

Once enableFullDeck is enabled, Users can upload a full deck of slides to present alongside their media (dual-screen experience), using the timeline functionality. The supported formats are PPT, PPTX, PDF, and Images of the following types "*.3gp;*.jpg;*.jpeg;*.bmp;*.png;*.gif;*.tif;*.tiff;*.3GP;*.JPG;*.JPEG;*.BMP;*.PNG;*.GIV;*.TIF;*.TIFF;"

Edit Media

After you enable the module, the Timeline tab is added to the entry-edit page.
The media owner/editor can add new Chapters or Slides on the timeline through this tab by uploading an image and providing metadata text. See the article The Kaltura Player- Editing/Deleting Chapters and Slides for more information.

Chapters are markers on the media timeline that are used to provide context to a segment of the media. Chapters are in the top hierarchy and can include slides within them.

Slides are synchronized visual elements to the main media.

Note - Uploading a .pptx file created in Apple Keynote might return an error due to a security setting that has been set on Microsoft files since 07 - files whose format ends in x. Converting a file from keynote to .pptx has not undergone the security mechanism. There are three ways to overcome this:

After converting keyNote to pptx format open the file from PowerPoint and save it.
Converting the keyNote file to ppt format.
Converting the keyNote file to pdf format.

User Interaction

After chapters and slides are created, the player is displayed with a matching plugin that presents the chapters and slides view on it. The viewer sees only the extended player and not the timeline for editing. The viewer can navigate between chapters and slides inside the player view, as well as search on their text.

The minimum player version required for this module to work is v2.26.

Comments module

About

The Comments module enables interactive discussions on media entries. By activating this feature, you can allow authorized users to add new comments, reply to existing ones, or delete comments when necessary.

Configure

1. Go to your Configuration Management page, and click on the Comments module. You can also navigate directly using a link: https://{your_KMS_URL}/admin/config/tab/comments.

The Comments page displays.

2. Configure the following:

enabled - Set to 'Yes' to enable the module

channelCommentsProfileId - Custom Metadata profile Id for channels.

entryCommentsProfileId - Custom Metadata profile Id for entries.

entryCommentsCountProfileId - Custom Metadata profile Id for entry comments count.

commentsAllowed - Choose who can add comments by checking the following options:

viewerRole
privateOnlyRole
adminRole
unmoderatedAdminRole

pageSize - Choose the number of comments that can be displayed from the dop-down options:

10
25
50

sort - Choose whether to sort comments by newest or oldest first.

allowClose - Set to 'Yes' to allow content owners to disable/close comments for particular entries. When set to 'No', owners that had their comments disabled, will not be able to reactivate them.

showInGalleries - Set to 'Yes' to enable showing public comments for entries in context of galleries.

showInChannelsOnly - Set to 'Yes' if you want to show comments on media entries to users only in the context of a channel/gallery. In this case, users will not be able to see media comments if browsing to the media from search results, My Media or any other context that doesn't include the context of the channel/gallery.

showAddTimedCommentsCheckbox - Set to 'Yes' to show Add comment at mm:ss checkbox (shown in the image below) to allow viewers to add a comment at a specific point in the video.

showPrivateCommentsConfig - Set to 'Yes' to allow channel/gallery managers to set comments as private; comments will only show in the context of this channel/gallery.

3. Click Save.

User experience

The image below shows the Comments box located beneath a media entry. Users can type a comment and click 'Add' to post it to the media page, as well as read comments from other viewers.

Contentpolicy module

About

The Contentpolicy module lets you display a customizable policy message on media pages. On desktop view, the policy will appear as a box to the right of the media. This feature is not available on tablet or mobile views.

Configure

Go to your Configuration Management console and click on the Contentpolicy module. You can also navigate to it directly using a link: https://{your_KMS_URL}/admin/config/tab/contentpolicy.

The Contentpolicy page displays.

enabled - Set to 'Yes' to enable the module.
ContentPolicyText - Enter the desired text. The content policy will be displayed on each media page in the top right corner (see example below).

You can use BB code to format your text. You can click on the link provided in the module (full list here) or use the basic tags provided below.

Click Save.

User experience

Non-Theming users

For users who don't have Theming enabled, the content policy displays on the media page to the right of the player:

Theming users

For users who have Theming enabled, the content policy displays under the player :

BB code tags

BB code is a simplified version of HTML that lets you format your messages without affecting page layout. Here’s a list of basic BB code tags you can use to format your text:

Remember:

Don't put spaces between the bracketed code and the text you are applying the code to.

The end brackets must include a forward slash ([/list])

Format	Usage	Example usage
Bold / italics / underline	[b] [I] [u]	[b]this text is bold[/b] [I]this text is italic[/i] [u]this text is underlined[/u]
Color	[color=Option]value[/color]	{color=blue]this text is blue[/color] [size=Option]value[/size] = size
Size	[size=Option]value[/size]	[size=+2]this text is two sizes larger than normal[/size]
Alignment	[left]value[/left] [center]value[/center] [right]value[/right]	[left]this text is left-aligned[/left] [center]this text is center-aligned[/center] [right]this text is right-aligned[/right]
Bulleted list	[list]value[/list]	[list] []list item 1 []list item 2 [/list]
Font	[font=Option]value[/font]	[font=courier]this text is in the courier font[/font]
URL hyperlinking	[url]value[/url] [url=Option]value[/url]	[url] https://knowledge.kaltura.com/help[/url] [url=https://knowledge.kaltura.com/help]Knowledge Center[/url]

Cssupload

Field	Description
enabled	Enable the Cssupload Module.
bootstrap	Upload a replacement bootstrap.min.css file to the one in use by KMS. Only useable for Bootstrap based themes.
additional	Upload an additional css file to KMS to include additional classes not defined as part of the standard Bootstrap CSS file.

Customdata module

Customfavicon

Field	Description
enabled	Enable the Customfavicon Module.
faviconName	Click Upload and select an image file.
favviconURL	Click Reset to reset to the default file.

Custompages module

About

The Custompages module allows you to create additional site pages using template pages from the TemplatePages module. With the Custompages module, you can select a template, set its URL and permissions, and publish the page.

For detailed instructions on using templates and custom pages, see our article Create and use a template page.

Applies exclusively to the Video Portal and depends on the Theming module.

Prerequisite

Before working with the Custompages module, you need to create at least one page in the Templatepages module. In our example below, we have created a template page called 'Example'. After you create a template page, it will be available in the pageTemplate drop-down menu in this module (see below).

Template page

Configure

1. Go to your Configuration Management console, and click on the Custompages module. You can also navigate directly using a link: https://{your_KMS_URL}/admin/config/tab/custompages.

The module page displays.

2. Configure the following:

enabled - Set to 'Yes' to enable the emodule.

Click the + Add "CustomPage" button to add your templatepage to the site.

A new section displays.

Set the following fields to enable your new custom page and determine its availability:

published - When your page is ready to be used, set the published field to 'Yes'. Once published, users with permission can view the page. As long as it is set to 'No', the page won't be available to any user.

pageTemplate - This field provides a drop-down menu of the templates you created in the templatepages module. Select the desired template page. Below you can see that the example template page we created is now in the menu:

pageSlug - Enter a unique semantic slug for your page. This will create a new URL in the format https://{your_site_url}/{slug}, for example, entering the slug 'help' will create the URL https://videoportal.kaltura.com/help.

Users with permission can access the page using the slug (see example below). You can also add the page to the navigation menu. For more details, see our article Navigation module.

Use only alphanumeric characters without spaces. While underscores ("_") are allowed, avoid using capital letters and spaces.

permission - Select the minimum role needed to access this page.

Use anonymousRole to allow guests to view the page if your site is set to support anonymous users (set in the Auth module). If not, choose guest override to make the page public.

3. Scroll to the bottom of the page and click Save.

Below is the final configuration:

User experience

Page access via slug:

Page access via header menu:

Disclaimer module

About

Administrators can require end-users to review and accept the Terms of Agreement via a checkbox before they upload or publish content.

Please note that displaying different disclaimer messages based on the audience's country is not supported.

Configure

1. Go to your Configuration Management console and click on the Disclaimer module. You can also navigate to it directly using a link: https://{your_KMS_URL}/admin/config/tab/disclaimer.

The Disclaimer page displays.

2. Configure the following:

enabled - Set to 'Yes' to enable.

disclaimerProfileId - Enter the custom data profile ID for the disclaimer.

See our article Create a custom data schema to learn more about creating a custom data profile.

disclaimerField - Specify the custom data field that must be checked when uploading or publishing media.

disclaimerText - Enter the text that explains the purpose of the disclaimer checkbox (see example below).

You can use BB code to format your text. You can click on the link provided in the module (full list here) or use the basic tags provided below.

agreeText - Enter the text displayed next to the checkbox, indicating the user agrees to the terms.

Does not apply to the Theming upload page and KMSGo Mobile app.

displayArea - Choose from the following options:

Before Upload - Terms of agreement are shown before users can contribute content. After agreeing, the upload and other options are enabled, and the checkbox cannot be unchecked.
Before Publish - Terms of agreement appear as part of the metadata on the upload and edit media screens. The checkbox can be required, preventing media from being published unless selected. Once agreed to, the checkbox becomes view-only and cannot be unchecked.

3. Click Save.

Example

Below is a sample configuration and the resulting user experience.

Configuration:

What the user sees before uploading content:

Once the box is checked, the upload screen displays:

BB code tags

BB code is a simplified version of HTML that lets you format your messages without affecting page layout. Here’s a list of basic BB code tags you can use to format your text:

Remember:

Don't put spaces between the bracketed code and the text you are applying the code to.

The end brackets must include a forward slash ([/list])

Format	Usage	Example usage
Bold / italics / underline	[b] [I] [u]	[b]this text is bold[/b] [I]this text is italic[/i] [u]this text is underlined[/u]
Color	[color=Option]value[/color]	{color=blue]this text is blue[/color] [size=Option]value[/size] = size
Size	[size=Option]value[/size]	[size=+2]this text is two sizes larger than normal[/size]
Alignment	[left]value[/left] [center]value[/center] [right]value[/right]	[left]this text is left-aligned[/left] [center]this text is center-aligned[/center] [right]this text is right-aligned[/right]
Bulleted list	[list]value[/list]	[list] []list item 1 []list item 2 [/list]
Font	[font=Option]value[/font]	[font=courier]this text is in the courier font[/font]
URL hyperlinking	[url]value[/url] [url=Option]value[/url]	[url] https://knowledge.kaltura.com/help[/url] [url=https://knowledge.kaltura.com/help]Knowledge Center[/url]

Downloadmedia module

Editor module

About

The Editor module activates the Kaltura video editing tools, giving users video editing capabilities directly within the platform. To create quizzes using the Kaltura video editor, please note the Quiz module must also be enabled.

Configure

1. Go to your KMS or KAF Configuration Management console and click the Editor module. Or navigate directly using a link: https://{your_KMS_URL}/admin/config/tab/editor.

The Editor page displays.

2. Configure the following:

enabled - Set to 'Yes' enable the module.

enableClipping - Set to 'Yes' to enable users to clip entries using the editor. If set to 'No,' the Save a Copy option will be disabled in the Kaltura video editor.

enableTrimming - Set to 'Yes' to enable users to trim entries using the editor. If set to 'No,' the Save option will be disabled in the Kaltura video editor.

showClipAttribution - Set to 'Yes' to include an attribution to the original entry on a clipped entry page.

The showClipAttribution feature is not currently supported for Theming users.

clipperProfileId - Metadata profile ID for clipping permissions. You can leave this field as it is; no changes are needed.

keaPlayerId - Enter the player ID used in the Kaltura Editor Application. The player must be version 2 (v2). If left blank, the main player from the player module will be used. Ensure the main player is also version 2 (v2).

keaDocumentationURL - Enter the link to the custom Kaltura Editor Application documentation. This link will appear when users click the help button (? icon) at the bottom left of the editor (as shown below). Leave it empty to use the default documentation link.

User experience

keaPreviewPlayerId - Enter the player ID of the preview player used in Kaltura Editor Application. Leave blank to use the main player from the player module.

keaCustomCss - Upload CSS file. Uploading a custom CSS file lets you tailor the editor's appearance and functionality to match your brand. Adjust styles like colors, fonts, and layout for a consistent look and feel across your platform.

downloadLocales - The Kaltura video editing tools can be localized to any of the supported localization languages. You can download a zip file which contains all texts for all built-in locales. These can be used to create custom languages, as follows:

Download the zip file (downloadlocales)
Open the zip to get the .json file.
Edit the .json file in your preferred software with the translations you want.
For each language use the uploadCustomLanguage section below to upload the customized language information.

uploadCustomLanguage

Click +Add "uploadcustomLanguage".

A new field displays.

languageCode - Select the language code. Note that the selected language code should match an existing localized version of the application.

localeFile - Upload your customized .json file.

3. Click Save.

Emailnotifications

Field	Description
enabled	Enable the Emailnotifications module.

Embed module

About

Embed code is used to embed Kaltura media in a website, HTML page, or any other online tool. The Embed module allows administrators to make this functionality available to users (depending on their role) through the Share tab located on the Media Page in MediaSpace and KAF applications.

Configure

Enable the Module

enabled - When enabled, the Share tab is displayed alongside the Details tab for users on a Media page in MediaSpace and KAF applications. Users can click on the Share tab to find various sharing media options. See the example below.

Secure Embed

secureEmbed - Setting secureEmbed to Yes, provides an additional layer of protection, by which users will first have to log in to view the content. Kaltura MediaSpace entitlements will be enforced on media that is embedded in external sites. When embedding restricted or private media to your sites and blogs, you will be prompted to authenticate (if not already authenticated). The media will play if a user is authorized to watch the media according to the entitlements defined in MediaSpace. Otherwise, a message will be displayed that they are not authorized to watch the media.

In the iframe embed example below, secureEmbed is set to No.

<iframe id="kaltura_player" src="http://cdnapi.kaltura.com/p/2311101/sp/231110100/embedIframeJs/uiconf_id/40179251/partner_id/2311101?iframeembed=true&playerId=kaltura_player&entry_id=1_3inimdwj&flashvars[streamerType]=auto&amp;flashvars[localizationCode]=en&amp;flashvars[leadWithHTML5]=true&amp;flashvars[sideBarContainer.plugin]=true&amp;flashvars[sideBarContainer.position]=left&amp;flashvars[sideBarContainer.clickToClose]=true&amp;flashvars[chapters.plugin]=true&amp;flashvars[chapters.layout]=vertical&amp;flashvars[chapters.thumbnailRotator]=false&amp;flashvars[streamSelector.plugin]=true&amp;flashvars[EmbedPlayer.SpinnerTarget]=videoHolder&amp;flashvars[dualScreen.plugin]=true&amp;&wid=1_nl9vrlrr" width="400" height="285" allowfullscreen webkitallowfullscreen mozAllowFullScreen frameborder="0" title="Kaltura Player"></iframe>

In the iframe embed example below, secureEmbed is set to Yes.

<iframe id="kmsembed-1_3inimdwj" width="400" height="285" src="http://2311101.mediaspace.kaltura.com/embed/secure/iframe/entryId/1_3inimdwj/uiConfId/40179251?flashvars[streamerType]=auto&amp;flashvars[localizationCode]=en&amp;flashvars[leadWithHTML5]=true&amp;flashvars[sideBarContainer.plugin]=true&amp;flashvars[sideBarContainer.position]=left&amp;flashvars[sideBarContainer.clickToClose]=true&amp;flashvars[chapters.plugin]=true&amp;flashvars[chapters.layout]=vertical&amp;flashvars[chapters.thumbnailRotator]=false&amp;flashvars[streamSelector.plugin]=true&amp;flashvars[EmbedPlayer.SpinnerTarget]=videoHolder&amp;flashvars[dualScreen.plugin]=true&amp;" class="kmsembed" allowfullscreen webkitallowfullscreen mozAllowFullScreen frameborder="0" title="Kaltura Player"></iframe>

As you can see from the above examples, when secureEmbed is set to No, the iframe embed code displays a direct link to the media. When secureEmbed is set to Yes, the iframe embed code displays a direct link to MediaSpace which requires the user to enter login credentials to view the content.

For additional information about this feature, see Enhanced Settings for Secure Embed in KMS/KAF.

If secureEmbed is set to Yes, additional functionality is displayed.

Additional Functionality for Secure Embed

autoRedirect -

Select Yes to automatically redirect the user to the SSO login page in case the user is not authenticated with MediaSpace. (If the user is globally authenticated, they will be auto-authenticated by MediaSpace and then redirected back to the page with the video.) In the example below, the user is not globally authenticated, therefore the Sign In page displays.

Select No to display a message to the user so that the user can manually select when/whether to re-authenticate. In the example below, the user has not been automatically redirected and must manually click "Click here to login" to log in to MediaSpace.

autoReirectiframe -

When autoRedirect is set to Yes and autoRedirectIframe is set to No (default), the redirect for authentication will use the top browser window.

When autoRedirect is set to Yes and autoRedirectIframe is set to Yes, the redirect will occur in the iframe.

autoRedirectMessageHTML - HTML text to display while the user is auto-redirected to the login page. In the example below, the HTML text was set to "Please login with your MediaSpace credentials."

notAuthenticatedHTML - HTML text (may include links) to display inside the iFrame if autoRedirect is set to No. In the example below, the HTML text was set to "Not authenticated".

notAuthorizedHTML - HTML text (may include links) to display inside the iFrame in case Kaltura Entitlement authorization fails.

In the example below, the HTML text was set to "You are not authorized to view this media". The user was prompted to log into KMS and authentication was successful, but upon doing so, was unable to access the media because the user did not have the authorization to view the media.

Note: If you wish to further restrict users from viewing media in KMS, you may consider disabling allowAnonomous in the Auth module.

noCategoryEmbedAccessHTML - HTML text (may include links) to display inside the Embed tab of an entry page accessed not via a category/channel/gallery when requireCategoryContext is set to Yes.

In the example below, requireCategoryContext was set to Yes and the user did not access the entry page via a category/channel/gallery. In other words, the user attempted to grab an embed of an entry from a category/channel that prevents embed grabbing. The HTML text was set to that shown in the orange shaded box.

noCategoryPlayAccessHTML - HTML text (may include links) to display inside the iFrame when category-level embed grab and play are disabled for the category/gallery from where embed was originally grabbed, and/or when requireCategoryContext is set to Yes and a (legacy) secured embed is missing a category context. In the example below, the HTML text was set to "Playback of this content is only allowed on its original publishing destination. Please contact owner or support".

overrideCSSURL - URL to an alternate Cascading Style Sheet (CSS) to allow a customer to customize the iFrame design to fit the corporate style guide.

categoryLevelEmbed - Allow KMS category/channel (or KAF course gallery) managers to prevent grabbing and playing embed content from a specific category. Depends on CategoryEmbed/ChannelEmbed modules. For more information see Enhanced Settings for Secure Embed in KMS/KAF.

requireCategoryContext - Set to Yes, in conjunction with categoryLevelEmbed set to Yes, to make sure embeds are only grabbed from category/gallery contexts. Grabbing an embed from a regular (context-less) entry page will not be allowed. NOTE: Setting this to Yes will cause secured embeds that lack a category context to stop authorizing playback. The requireCategoryContext field should only be enabled for customers not already using the secureEmbed feature. Otherwise, secured embeds already embedded will play content that was previously accessible. Again, for more information see Enhanced Settings for Secure Embed in KMS/KAF.

Allow/Restrict Sharing Using iFrame

allowEmbedIframeShare - Allow/Restrict sharing using iFrame. This configuration is only supported for non-v2 supported players. When allowEmbedIframeShare is set to No, the option to choose iframe embed is eliminated.

Enable/Disable Responsive Sizing

embedResponsiveness - Enable/Disable the' Responsive Sizing' option in the embed view. When enabled, the Responsive Sizing toggle button is displayed on the Share > Embed tab.

Select the User Roles Allowed to Embed

embedAllowed - Select one or more roles that can use the Embed functionality. In the following example, viewerRole, privateOnlyRole, adminRole, and unmoderatedAdminRole are all allowed to use the Embed functionality.

Define Skins For the Embedded Players

embedSkins - Define skins that can be used for embedded players. When configured, the Player Skin options are displayed on the Share > Embed tab.

Additional Information on Skins

name - What is the name of the skin? The skin name is displayed when the user selects an embedded skin.

imgFile - What is the relative path to the image file on the server? The image file represents how the skin looks.

uiConfId - What is the numerical value of the player ID to use in the embed code?

Define Sizes For the Embedded Players

embedSizes - Define sizes that can be used for embedded players. Define the player size in the following format: {width}x{height}

large 608x402
medium 400x285
small 304x231

Save

Save - Click Save to save your configuration settings.

For the user manual, please see Share & Embed Media Via Media Page.

Embedplaylist

About

The embeddplaylist module allows you to control the embed capabilities for the playlist, available on the Playlist Details page under the "Share and Embed" button.

This module is only relevant for MediaSpace, not for KAF applications.

The players must contain the Playlist plugin available in the KMC Studio.

If no player is selected, the default Playlist player will be used. See PlaylistPage.

Configure

Enable the Module

enabled - When the embedplaylist module is enabled, the Share & Embed button/tab is displayed to users under the My Playlist Page, the Playlist Edit page, and the Playlist Media Page. See the examples below.

My Playlists Page

Playlist Edit Page

Playlist Media Page

Secure Embed

secureEmbed - Setting secureEmbed to Yes, provides an additional layer of protection, by which users will first have to login to view the content. MediaSpace entitlements will be enforced on media that is embedded in external sites. When embedding restricted or private media to your sites and blogs, you will be prompted to authenticate (if not already authenticated). If a user is authorized to watch the media according to the entitlements defined in MediaSpace, the media will play. Otherwise, a message will be displayed that they are not authorized to watch the media.

In the iframe embed example below, secureEmbed is set to No.

<iframe id="kaltura_player" src="http://cdnapi.kaltura.com/p/2311101/sp/231110100/embedIframeJs/uiconf_id/40179251/partner_id/2311101?iframeembed=true&playerId=kaltura_player&entry_id=1_3inimdwj&flashvars[streamerType]=auto&amp;flashvars[localizationCode]=en&amp;flashvars[leadWithHTML5]=true&amp;flashvars[sideBarContainer.plugin]=true&amp;flashvars[sideBarContainer.position]=left&amp;flashvars[sideBarContainer.clickToClose]=true&amp;flashvars[chapters.plugin]=true&amp;flashvars[chapters.layout]=vertical&amp;flashvars[chapters.thumbnailRotator]=false&amp;flashvars[streamSelector.plugin]=true&amp;flashvars[EmbedPlayer.SpinnerTarget]=videoHolder&amp;flashvars[dualScreen.plugin]=true&amp;&wid=1_nl9vrlrr" width="400" height="285" allowfullscreen webkitallowfullscreen mozAllowFullScreen frameborder="0" title="Kaltura Player"></iframe>

In the iframe embed example below, secureEmbed is set to Yes.

<iframe id="kmsembed-1_3inimdwj" width="400" height="285" src="http://2311101.mediaspace.kaltura.com/embed/secure/iframe/entryId/1_3inimdwj/uiConfId/40179251?flashvars[streamerType]=auto&amp;flashvars[localizationCode]=en&amp;flashvars[leadWithHTML5]=true&amp;flashvars[sideBarContainer.plugin]=true&amp;flashvars[sideBarContainer.position]=left&amp;flashvars[sideBarContainer.clickToClose]=true&amp;flashvars[chapters.plugin]=true&amp;flashvars[chapters.layout]=vertical&amp;flashvars[chapters.thumbnailRotator]=false&amp;flashvars[streamSelector.plugin]=true&amp;flashvars[EmbedPlayer.SpinnerTarget]=videoHolder&amp;flashvars[dualScreen.plugin]=true&amp;" class="kmsembed" allowfullscreen webkitallowfullscreen mozAllowFullScreen frameborder="0" title="Kaltura Player"></iframe>

As you can see from the above examples, when secureEmbed is set to No, the iframe embed code displays a direct link to the media. When secureEmbed is set to Yes, the iframe embed code displays a direct link to MediaSpace which requires the user to enter login credentials to view the content.

For additional information about this feature, see Enhanced Settings for Secure Embed in KMS/KAF.

If secureEmbed is set to Yes, additional functionality is displayed.

Additional Functionality for Secure Embed

autoRedirect -

Select Yes to automatically redirect the user to the SSO login page in case the user is not authenticated with MediaSpace. (If the user is globally authenticated, they will be auto authenticated by MediaSpace then redirected back to the page with the video.) In the example below, the user is not globally authenticated, therefore the Sign In page displays.

Select No to display a message to the user so that the user can manually select when/whether to re-authenticate. In the example below, the user has not been automatically redirected and must manually click "Click here to login" to login to MediaSpace.

autoReirectiframe -

When autoRedirect is set to Yes and autoRedirectIframe is set to No (default), the redirect for authentication will use the top browser window.

When autoRedirect is set to Yes and autoRedirectIframe is set to Yes, the redirect will occur in the iframe.

autoRedirectMessageHTML - HTML text to display while the user is auto-redirected to the login page. In the example below, the HTML text was set to "Please login with your MediaSpace credentials."

authorizedForSubsetHTML - HTML text (may include links) to display inside the iFrame if a user is only allowed to a subset of the playlist content due to entitlements. In the example below, the HTML text was set to "You are only authorized to access a subset of the original playlist."

notAuthenticatedHTML - HTML text (may include links) to display inside the iFrame if autoRedirect is set to No. In the example below, the HTML text was set to "Not authenticated".

notAuthorizedHTML - HTML text (may include links) to display inside the iFrame in case Kaltura Entitlement authorization fails.

In the example below, the HTML text was set to "You are not authorized to view this media". The user was prompted to log into KMS and authentication was successful, but upon doing so, was unable to access the media because the user did not have authorization to view the media.

Note: If you wish to further restrict users from viewing media in KMS, you may consider disabling allowAnonomous in the Auth module.

overrideCSSURL - URL to an alternate Cascading Style Sheet (CSS) to allow a customer to customize the iFrame design to fit corporate style guide.

Select the User Roles Allowed to Embed Playlists

playlistEmbedAllowed - Select one or more roles that can use the Embed Playlist functionality.

Allow Users to Embed Channel Playlists

channelPlaylistEmbedAllowed - Select Yes to allow users to embed channel playlists. Select No if you would rather users not be allowed to embed channel playlists.

Select the Embed Types

embedType - Select the embed types that a user can use when embedding a playlist.

In the example above, the Admin has allowed the user to select from all three embed types when embedding a playlist. Therefore, the following three options are displayed to the user on the Share and Embed window.

Set the Players Used to Embed Playlists

players - Set the player(s) a user can use to embed playlists, vertical and/or horizontal. The first player in the list is used as the default player.

Add additional players by clicking the blue + Add "players" button.

Delete players by clicking the red DELETE button.

playerDisplayName - Type a player name that displays to users.

In the example below, the Admin has allowed the user to select from two players when embedding a playlist - a Vertical player named "Vertical Player" or Horizontal player named "Horizontal Player". Therefore, the following two options are displayed to the user in the Share and Embed page.

playerId - Type the player ID found in the KMC studio.

embedSizes - Select the embed sizes for the player.

In the example below, the Admin is only giving the user one option for Max Embed Size - 400X620.

embedSizeCustom - Type a custom embed size ("width"x"height" in pixels).

Add additional custom embed sizes by clicking the blue + Add "embedSizeCustom" button.

Delete custom embed sizes by clicking the red DELETE button.

Save

Save - Click Save to save your configuration settings.

For the user manual, please see Share & Embed Media Via Media Page.

Entrydesign module

About

The Entrydesign module allows media owners and co-editors to modify the styling of a specific media page.

This module is designated for Kaltura Video Portal and KAF applications.

Configure

1. Go to your Configuration Management console, and click on the Entrydesign module. You can also navigate directly using a link: https://{your_KMS_URL}/admin/config/tab/entrydesign.

The Entrydesign page displays.

2. Configure the following:

enabled - Set to 'Yes' to enable the module. When enabled, the Display tab is added to the editing capabilities on the edit media page, as shown below:

entryDesignRole - Decide which roles are allowed to design media pages. Choose from the options in the drop-down menu:

specific users or groups
privateOnly
admin role
unmoderatedAdmin role

players

In this section you can add players you want users to use on the entry page. If none is provided, the site’s default player will be used.

Click +Add "players".
An additional section displays.
playerDisplayName - Enter a name for the player.
playerId - Enter the player ID for the player that shows in the Display tab on the edit media page.
entryType - Select an entry type from the options in the drop-down menu:

Video
Audio
Quiz
Image
Webcast/Live
Rapt media

Continue to add players as desired by clicking +Add "players".

showEmbedPlayerOption - Select the player behavior with the embed and default players. Choose from the options in the drop-down menu:

Force Entrydesign Player in Embed Code - If selected, the Entrydesign player will be used in the embed code of the Share tab. Players designated in the Embed module will be overridden.
Use Embed Module Players (default) - If selected, the Embed player will be used in the embed code of the Share tab. Players designated in the Entrydesign module will be overridden.
User Selects - If selected, in case a player is set for the corresponding entry type in the Entrydesign module, the owner/co-editor will see additional fields to select the "Entry Player" and a tickbox “Set as Embed Player”. Players designated in the Embed module will be overridden.

If you choose User Selects, a button called Set as Embed Player displays on the Display page under the player selection, as shown below:

allowedElements - Select which elements are displayed for the media owners to control. Choose from the following options:

Sidebar
Entry properties
Entry tabs
Comments
Header
Header logo
Footer

Media owners will be able to choose which of these elements to display or remove. For more information on each option, see our article Customize media display.

In our example below, the Administrator has chosen to provide users control of showing the sidebar, comments, and footer. The user has chosen to show all three elements on the page with the video (all three are checked).

allowCSS - Set to 'Yes' to allow the entry owner to use CSS to change the look and feel of the page. If enabled, this option displays to the user on the Edit Entry page as follows.

allowLogoChange - Set to Yes to allow the entry owner to set a new logo for KMS when viewing the entry. If enabled, this option displays to the user on the Edit Entry page as follows.

showLastArchived - Set to 'Yes' to allow live entry owners to customize the default setting, enabling a link to the last archived video at the top of the live page.

3. Click Save to save your configuration settings.

Facebook module

About

This module allows metadata tags like the thumbnail, entry name, description, and URL to display in posts on platforms like Facebook, LinkedIn, and MS Teams. Without this module, pasting a Kaltura media page URL in a social media post will only show the URL, not the rich content.

Prerequisites

Your Kaltura representative must disable Default Entitlement Enforcement in the Admin Console.
To share an entry, make sure it is published to an open category (gallery) or set as 'unlisted'. Please note that if the entry is published to a channel that requires authentication, it will not play. To learn about publishing entries, visit our article Publish media.

Step 1: Configure the Embed module

Go to your Configuration Management console, and navigate to the Embed module. Your link should look like this: https://{your_KMS_URL}/admin/config/tab/embed.
The embed module page displays.
In the secureEmbed field, select 'No' from the dropdown.
Scroll to the bottom of the page and click Save.

Step 2: Configure the Auth module

Select Auth from the panel on the left of the Configuration Management console.
The Auth module page displays.
In the allowAnonymous field, select 'Yes'.
Scroll to the bottom of the page and click Save.

Step 3: Configure the Facebook module

Select Facebook from the panel on the left of the Configuration Management console.
The Facebook module page displays.
Configure the following:
- enabled - Set to 'Yes'.
- fPlayerID - Enter the player ID (uiConf ID) of the player that will play your media on Facebook. The player ID can be found in the Player Studio. Click here to go to the Player Studio.
- useHighestQuality - Select Yes or No from the dropdown, depending on if you want the media to be played in the highest quality available.
- siteDescription - Enter the text to send on the ‘og:description’ property for the shared link for non-player pages. 'OG' stands for Open Graph, a protocol used by social media platforms to extract and display rich information from web pages. The og property specifically allows you to set a description that will appear when the page is shared on social media.
- shareImageURL - Type in the link of an image you would like to use when users share content to non-media pages (such as the homepage). Leave this field empty to use the site logo.
Click Save.

Below is an example of a shared link with text and logo.

Footer

About

Use the Footer module to create and configure your site's footer. The Footer module is replacing the basic footer that was available in the Application module and once enabled, all the previous footer configuration values are overridden.

Note: This is a KMS-only module that depends on the Theming module.

Related modules

Getting started

enabled - Set the enabled field to Yes to enable the Footer module.

Basic UI - Logo Selection and Display

showLogo - Select one of the following options:

No - do not display a logo on the footer.
Use header's logo - select to display the same logo that is taken from the Header module.
Upload your own - select to upload a custom logo file for the footer. recommended 132px x 32px. Enter the logo URL in the footerLogo field.

logoAltText - The configuration options are:

If you insert an image file in the footerLogo' field, you may enter alternate text for the tag's 'alt' attribute;
If you enter 'false' or an empty string in the 'footerLogo' field, you must enter text for the page image.

logoLink - The options for defining the behavior when clicking the logo are:

Enter 'false' if you do not want the logo to be clickable.
Enter 'home' to display the home page (displayed when MediaSpace opens).
Enter a full URL (starting with http://) to open a different page in a new browser window/tab.

Basic footer configuration

bottomText - Enter plain text for the bottom part of the footer. Leave empty to set the section as plain text

backgroundUpload - use to set a custom banner at the bottom of the page. Recommended 2160px w / 404px h. The image will be aligned to the bottom right of the footer, allowing for atmospheric transparent images to be added.

backgroundColor - use to setup a different color for the footer background. Make sure the color is compliant with the accessibility standards.

Social Links

Use the socialLinks section to add links to your social network pages in the form of icons to the right of the footer.

Click +AddSocialLinks to expand this section.

Type - Select one of the following social networks from the drop down menu.

URL - Enter the URL for the social network.

Add values for each social network you want to display in your site's footer, using these fields.

An example footer:

Text and Links

textAndLinksSeparator - Choose a separator for the texts. Leave empty to use the default bullet style '•'.

Use the textAndLinks section to add text and links separated by a divider to the left side of the footer.

You may add simple text, links, and even scripts.

sectionText - Enter the text for the clickable item.
sectionType - Select if this clickable item is a URL or a Script.
sectionLink - Enter a URL or a Script for the clickable item. Leave empty to set the section as plain text. For script, please add the script directly e.g. console.log('hi');alert('what?')

Add values for each text or link you want to display in your site's footer, using these fields.

Use the bottomText field to add a one line below the textAndLinks elements.

Additional features

Promotional section

A promotional section may be added, by setting promotionSection field to YES. When set to Yes, fill in the fields with the desired text and link, to display the new section.

promotionHeader - Enter the main text for the promotion section. (HTML markup supported).

promotionText - Enter the main text for the promotion section. (HTML markup supported).

promotionButtonText - Enter the text for the promotion button.

promotionButtonUrl - - Enter the URL for the promotion button.

The results:

Exclude footer from page

You can exclude the footer from different pages on the site from the exceptions section. This can be used to hide the entire footer or just the promotion section from any page.

In the following example, the site is configured so that it does not display the promotional section on the registration page, and does not display the footer on the login page.

To set footer options for specific pages

URL - Set the URL to which this exception should be applied.

showFooter - Choose if you want the footer to be displayed on this page. When set you Yes you may also configure whether to hide or display the promotion.

GroupPage module

About

Once enabled, this module allows you to create a dedicated 'group page' where users from a group are displayed in a tidy grid layout, while promoted users take the spotlight in a carousel. Each page can display up to 500 users. The groups are created and managed in the 'Manage Groups' section of the Configuration Management console. It's the perfect tool to organize and highlight the standout members of your community or enterprise.

Exclusively for MediaSpace Video Portal. Requires the Theming and PersonalProfile modules to be enabled.

Group page with 2 promoted users at the top

Configure

1. Go to your KMS Configuration Managment page, and navigate to the GroupPage module. Your link should look like this: https://{your_KMS_URL}/admin/config/tab/grouppage .

2. In the GroupPage window, configure the following:

enabled - Set to 'Yes' to enable the module.

groupPage

groupId - Click Select Groups and type in the group name that you want display on the group page. If a corresponding user group has been configured, the system will trigger auto-complete.

title - Enter a title for the group page. This title will show at the top of page and also on the browser tab. If left empty, the group's name will be used.

description - Add a description to display at the top of the group page.

showSearchIndicator - Check this box to display a search bar, and the number of group members along with the word users. You can customize the word users in the searchindicator fields below.

If showSearchIndicator is checked, complete the following fields:

searchIndicatorSingle - Enter text (for example, Speaker, Presenter). If left empty, the default word User will be displayed.

searchIndicatorPlural - Enter text (for example, Speakers, Presenters). If left empty, the default word Users will be displayed.

Please note you must input both the singular and plural forms, otherwise the default 'users' will be displayed.

pageSlug - Enter a unique semantic slug for the group page. This will be used in the link to the group page URL (for example, www.yourvideoportal/{pageSlug}). Only lowercase alphanumeric characters are allowed. If left empty, the group ID will be used in the URL.

permission - From the drop-down, select the minimum role allowed to access the page:

Guest override
anonymousRole
viewerRole
privateOnlyRole
adminRole
unmoderatedAdminRole
Specific Users/Groups

Select the minimum role allowed that can access this page. Set as 'anonymousRole' to allow guests to view the page. If your KMS does not support anonymous users, choose 'guest override' to make this page public to all.

Click +Add 'groupPage' and repeat the process to create another group page.

promoteUsers

This allows you to 'promote' users to a carousel above (limited to 20 users).

Click +Add "promotedUsers" and then configure the following:

userId - Click Select Users and choose users to promote. If a corresponding user has been configured, the system will trigger auto-complete.
order - Specify the order of promoted users in the carousel. Promoted users are arranged from left (lower value) to right (higher value) within the carousel.

Repeat this process to add more promoted users.

Click Save.

Headermenu

About

This module allows you to specify the items visible at the top right of the navigation bar ('header') or within the user drop-down menu. Additionally, you can use it to add a link to your My Profile page, whether it's accessed through the user menu or directly from the navigation bar.

Enable the module

Go to your KMS Configuration Management console, and navigate to the Headermenu module. Your link should look like this: https://{your_KMS_URL}/admin/config/tab/headermenu.
enabled - Set to 'Yes' to enable the module.

Configure the header menu

Click +Add "menu".

A new section appears with configurable fields.

Personal page options

To configure the URL or Menu option, follow the steps in the next section.

type - Choose one of the options (My Media, My Playlists, My Channels, My History, My Live Rooms, My Powtoons, My recycle bin, My Content Analytics) from the drop-down menu.
To add more items to the menu, click +Add "menu" and repeat the step above.
When you've finished configuring your menu, click Save.

URL

type - Choose URL from the drop-down menu.
A new section displays.
Configure the following:
- label - Enter the URL label (name you want to display in the menu)
- link - Enter a URL. The URL may link to external sites (should start with http://) or an internal page (should start with /).
- sameWindow - Select whether the link should open in new window (target = _blank) or in the same window. This is applied to external links only(absolute URLs).
- linkLocation - Select whether the link should appear in the Header or in the User Drop Down.

Example

To add My Profile to the user menu:

Type = URL
Label = My Profile
link = /profile
sameWindow = Yes
linkLocation = User Drop Down

To add My Profile to the header:

Type = URL
Label = My Profile
link = /profile
sameWindow = Yes
linkLocation = Header

type - Choose Menu from the drop-down menu.
label - Enter the Menu label (name of the menu)
Click +Add "items".
A new section displays.
- label - Enter the label for the menu item.
- link - Enter a URL. The url can link to an external site or to an internal page.
- sameWindow - Select whether the link should open in new window (target = _blank) or in the same window. This is applied to external links only (absolute URLs).

Example

In our example below, we added a menu called 'Resources':

Type = Menu
Label = Resources
link = https://knowledge.kaltura.com/
sameWindow =No

Note that if administrators opt to keep the search bar open for all users in the Search module settings, any header menu items will be covered by the search bar.

Helppage

About

Use this module to set up a Help or FAQ page with sections for questions, answers, and optional titles or "Contact us" links. After enabling, your page will be accessible via "/help" URL. Make sure there are no conflicts with other modules using the same slug, such as the Custompages module.

Note: This is a KMS-only module that depends on the Theming module.

Language tokens and exceptions are allowed so that the page's content can be translated to multiple languages.
You can configure a CTA button that directs users to a dedicated URL or sends an email using the "mailto:email@company.com" syntax. Any user can view the help page by entering {KMS_URL}/help.

Getting started

enable - Use the enabled field to enable the page. You may keep this setting disabled while configuring the module.

pageTitle - Use the pageTitle field to set the top page title.

Contact Us button

contactUs - Adds a box on the top right of the help page with a clickable call to action button. Set to Yes to expand this section and configure the contact us fields.

titleText - Enter the title text to present at the top of the box.

buttonText - Enter the text for the Call to Action button.

buttonLink - Enter the URL for the Call to Action button ('mailto' tag is accepted).

bottomText - Enter the text to present below box (HTML markup supported).

Enter the title, the button and its link (you can use an "https://help.company.com" link or a "mailto:email@ocmpany.com"), and additional text below the button.

Sample Contact Us button

Questions and Answers aka FAQs

The helppage UI may be separated into sections for FAQ according to topics, or you may use just one section. You can place multiple questions and answers in each section.

Click "+ Add faqSections" to create a section.

title - Enter the section title in the title field:

Click +Addquestions to add questions and answers.

question - Enter the question text (plain text).

answer - Enter the answer text (HTML markup supported).

Note: You can add links and make text bold using html tags (e.g. <a> or ) in the questions or answers

History module

About

The History module allows video portal users to access their watch history from the My History option in the user menu or header menu, or via https://{your_KMS_URL}/history. After enabling this module, you can configure the My History option in the headermenu module. For the My History user guide, visit our article My History.

Additionally, this module is used to enable the Resume Playback feature, displaying a progress bar below the video. This feature is applicable to both KMS and KAF applications.

Only the Resume Playback feature is available in KAF applications. The My History link is blocked in KAF applications.

Below is an example of a video portal user menu with the My History option.

Configure

Go to your KMS Configuration Management console, and navigate to the History module. Your link should look like this: https://{your_KMS_URL}/admin/config/tab/history.

The History module page displays.

Configure the following:

enabled - Set to 'Yes' to enable the module.

resumePlayback - Set to 'Yes' to enable the resume playback feature. This feature displays an indicator bar below the video thumbnail, showing the progress. It allows both KMS and KAF users to resume watching from the last point viewed.

When set to 'Yes', the resumeplaybackOptions section opens:

videoEndPercent - Enter the percentage of the remaining playback to consider the video 'completely watched'. Reaching this percentage or higher will count as ‘finished watching’.
videoEndSeconds - Enter the amount in seconds before the end of the video that will be considered as 'a completely watched video'. Reaching this amount of seconds or lower will count as ‘finished watching’.
barColorBackground - Enter the hex code for the background color of the progress bar.
barColorDone - Enter the hex code for the background color of the finished progress bar.
emptyHistory - You can customize the message users see when reaching an empty History page by changing the text here. The default message is: 'Your feed is empty. But it doesn't have to be! Go to the Homepage or browse our Channels to fill your feed with amazing videos each and every day.

deleteAllText - You can customize the message users see when clicking the 'Clear all History' button by changing the text here. The default message is: 'This will clear all your watch history, from other applications as well. Are you sure you want to clear your entire watch history? You can't undo this.'
showUnlisted - Set to 'Yes' to show unlisted entries in the history.
supportSecureEmbed - Set to 'Yes' to allow videos that are securely embedded to be added to history.
addToHistoryTrigger - Choose the way videos are added to the user's history: 'Play' or 'View'.
'Play' = videos will be added with a play trigger (click on the Play button is needed if autoplay is not turned on).
'View' = videos will be added by landing on the video page. (Entries of type image will always be triggered by view event.)

Click Save.

Home

Field	Description
enabled	Enable the Home Module.
thumbnailRotator	Enable thumbnail image rotation on mouseover in homepage
carouselEnabled	Show the carousel.
carouselInterval	interval (in miliseconds) between carousel transitions
carouselStyle	Select carousel style.
carousel
type	Select content for the Carousel:
carouselBg	carousel background color
lists	To add playlists to your home page. Add – click on the blue “Add lists” button. Remove – click on the red “Delete” button. Change – change the name and/or switch between the ‘Recently Watched’ playlist and the ‘Continue Watching’. The results are displayed on the KMS Home page. You can use playlists that have been configured in the KMC.
type	Select content for the list from the type drop down.
Name	Enter the list name to display. Choose “custom” to enter a KMC playlistid.

Hotspots module

Importchannel

Field	Description
enabled	Enable the Importchannel Module.

Emailnotifications module

About

The emailnotifications module lets you easily set up and customize email notifications to be automatically sent every time a user carries out a specific action. You can choose to enable email notifications for alerting channel moderators about new items awaiting moderation, informing media creators of the approval or rejection status for their content in a channel, and much more.

The 'Event Notifications' feature must be enabled on the account level for the email notifications and channel subscriptions feature to work. If your account does not have these features enabled, contact your account representative for additional information.

Changes to Application Specific notifications will only affect this application. Notifications of type Reach and External will take effect on all video portal (MediaSpace) and KAF instances under the same Kaltura Partner ID.

Configure the module

Go to your Configuration Management console, and click the Emailnotifications module. You can also navigate directly using a link: https://{your_KMS_URL}/admin/config/tab/emailnotifications.
Enable the module by selecting 'Yes'.
Click Save to apply your changes.
Click on the dedicated page link ('here').

The email notifications page displays.

Configure the notifications

On this page, you can enable the different email notification events and define the email templates for each. In each notification, the recipient, type, subject & body text and sender information will display.

There are three types: REACH, Application Specific, and External.

REACH refers to notifications coming from the REACH module.

REACH notifications will appear in the list only when the REACH module is enabled and configured. Please see the Kaltura REACH V2 KMS/KAF Administration Guide for instructions on enabling and configuring the REACH module.
Application Specific refers to notifications that are triggered by events in a specific application. Each application can have its own notifications. Different text and alerts can be sent according to the trigger location.
External refers to global notifications that affect all applications under the same account. If you have a few Video Portal instances and a KAF, the same external notifications are sent by triggers from any instance events. These also include notifications from applications outside of Video Portal/KAF (API or KMC for example).

Please note you should only enable one email notification if you have both External and Application Specific to avoid getting duplicate emails.

Click on the toggle button to enable the requested notification. Note that all enable switches are defaulted to OFF position.
Click the pencil icon to configure the notification.
Make the desired changes to the sender name, sender email, subject and / or body text.

Default Sender's Name and Sender's Email are "Kaltura Automated Response" and customer_service@kaltura.com respectively. You can customize these fields per individual email notification. Only one value per field is possible.

Changing the Sender email requires additional actions from the customer's side and Kaltura side. The customer needs to approve Kaltura to send emails on behalf of their domain. This can be done via SPF record (Sender Policy Framework) by adding include:mailer.kaltura.com. Then Kaltura can configure the requested email in the partner's admin console whitelist and edit each email notification template with the desired “Sender Email” value.
Click Update.
To enable, disable or edit the sender information for several notifications in bulk, select the desired notifications and click enable, disable or Edit Sender Info under the Bulk Actions menu.
Click Update.

Notification types

Task rejected for execution

Recipient = the task creator, Type = Reach

Sender Name: {from_name}
Sender email: {from_email}
Subject: MediaSpace - Your request was rejected for execution
Body: Your {service_feature} request [#{task_id}]: For entry name {entry_name} and entry ID {entry_id} requested on {request_date} Was Rejected. Rejection reason is {reject_reason}

Task Pending Moderation

Recipient = Configured Users, Type = Reach

Sender Name: {from_name}
Sender email: {from_email}
Subject: MediaSpace - New request is awaiting approval
Body: New task is pending approval for entry name {entry_name}, entry id {entry_id}. Task was requested on {request_date} by {creator_name}({creator_email}). In order to approve please go to the services requests page in [AppTasksUrl]

Task Finished Processing

Recipient = the task creator, Type = Reach

Sender Name: {from_name}
Sender email: {from_email}
Subject: MediaSpace - Your request has finished processing.
Body: Your {service_feature} request [#{task_id}]: For entry name {entry_name} and entry ID {entry_id} requested on {request_date} finished processing. To view task go to https://4834032.mediaspace.kaltura.com/media/{entry_id}

Task approved for execution

Recipient = the task creator, Type = Reach

Sender Name: {from_name}
Sender email: {from_email}
Subject: MediaSpace - Your request is approved for execution
Body: Your {service_feature} request: For entry {entry_name} with {entry_id} requested on {request_date} Was approved. {service_feature} will be automatically uploaded to your video upon completion. To view progress go to https://4834032.mediaspace.kaltura.com/media/{entry_id}

New Item Pending Moderation

Recipient = Category Moderators, Type = Application Specific

Sender Name: {from_name}
Sender email: {from_email}
Subject: MediaSpace - Your request is approved for execution
Body: Your {service_feature} request: For entry {entry_name} with {entry_id} requested on {request_date} Was approved. {service_feature} will be automatically uploaded to your video upon completion. To view progress go to https://4834032.mediaspace.kaltura.com/media/{entry_id}

Entry Approved In Category

Recipient = The Entry Creator, Type = Application Specific

Sender Name: {from_name}
Sender email: {from_email}
Subject: MediaSpace - Your request is approved for execution
Body: Your {service_feature} request: For entry {entry_name} with {entry_id} requested on {request_date} Was approved. {service_feature} will be automatically uploaded to your video upon completion. To view progress go to https://4834032.mediaspace.kaltura.com/media/{entry_id}

Entry Rejected In Category

Recipient = The Entry Creator, Type = Application Specific

Sender Name: {from_name}
Sender email: {from_email}
Subject: MediaSpace - Your Media has been rejected
Body: Your media {entry_name} <a href="https://4834032.mediaspace.kaltura.com/media/{entry_id}">https://4834032.mediaspace.kaltura.com/media/{entry_id}</a> has been rejected to be published in <a href="https://4834032.mediaspace.kaltura.com/channel/{category_name_encoded}/{category_id}">{category_name}</a>

Entry Rejected

Recipient = The Entry Creator, Type = Application Specific

Sender Name: {from_name}
Sender email: {from_email}
Subject: MediaSpace - Your Media has been rejected
Body: Your media {entry_name} has been rejected

Entry Rejected

Recipient = The Entry Creator, Type = External

Sender Name: {from_name}
Sender email: {from_email}
Subject: Your Media has been rejected
Body: Your media {entry_name} has been rejected

Entry Approved

Recipient = The Entry Creator, Type = Application Specific

Sender Name: {from_name}
Sender email: {from_email}
Subject: MediaSpace - Your Media has been approved
Body: Your media {entry_name} has been approved

Entry Approved

Recipient = The Entry Creator, Type = External

Sender Name: {from_name}
Sender email: {from_email}
Subject: Your Media has been approved
Body: Your media {entry_name} has been approved

Entry Ready

Recipient = The Entry Creator, The Account Owner, Type = Application Specific

Sender Name: {from_name}
Sender email: {from_email}
Subject: MediaSpace - Entry is Ready for Publishing: {entry_name}/ ID: {entry_id}
Body: Hello,A new entry is ready for publishing:Entry Name: {entry_name} Entry ID: {entry_id} Entry Creator: {creator_name}, {creator_id}/{creator_email} Entry Link: <a href="https://4834032.mediaspace.kaltura.com/media/{entry_id}">https://4834032.mediaspace.kaltura.com/media/{entry_id}</a>

Entry Ready

Recipient = The Entry Creator, The Account Owner, Type = External

Sender Name: {from_name}
Sender email: {from_email}
Subject: Entry is Ready for Publishing: {entry_name}/ ID: {entry_id}
Body: Hello,A new entry is ready for publishing:Entry Name: {entry_name} Entry ID: {entry_id} Entry Creator: {creator_name}, {creator_id}/{creator_email} Entry Link: <a href="https://4834032.mediaspace.kaltura.com/media/{entry_id}">https://4834032.mediaspace.kaltura.com/media/{entry_id}</a>

User was added to category as [role]

Recipient = The Category Member, Type = Application Specific

Sender Name: {from_name}
Sender email: {from_email}
Subject: MediaSpace - You have been added to {category_name}
Body: You have been added as {role} to <a href="https://4834032.mediaspace.kaltura.com/channel/{category_name_encoded}/{category_id}">{category_name}</a>

User's role was changed in category

Recipient = The Category Member, Type = Application Specific

Sender Name: {from_name}
Sender email: {from_email}
Subject: MediaSpace - Your {category_name} role has changed
Body: Your role in <a href="https://4834032.mediaspace.kaltura.com/channel/{category_name_encoded}/{category_id}">{category_name}</a> has changed and is now {role}

User was removed from category

Recipient = The Category Member, Type = Application Specific

Sender Name: {from_name}
Sender email: {from_email}
Subject: MediaSpace - You have been removed from {category_name}
Body: You have been removed from {category_name} by the user {remover_user_id}

Entry was added to channel

Recipient = Channel Subscribers, Type = Application Specific

Sender Name: {from_name}
Sender email: {from_email}
Subject: MediaSpace - A new media was added to {category_name}
Body: Media {entry_name} was added to <a href="https://4834032.mediaspace.kaltura.com/channel/{category_name_encoded}/{category_id}">{category_name}</a>. You can see the media here: <a href="https://4834032.mediaspace.kaltura.com/media/{entry_id}">https://4834032.mediaspace.kaltura.com/media/{entry_id}</a>

Comment was added to entry

Recipient = The Entry Creator, Type = Application Specific

Sender Name: {from_name}
Sender email: {from_email}
Subject: MediaSpace - A new comment was added to your video {entry_name}
Body: A new comment was added to your media {entry_name}. Comment: {comment_text}. You can see the media here: <a href="https://4834032.mediaspace.kaltura.com/media/t/{entry_id}/{category_id}">https://4834032.mediaspace.kaltura.com/media/t/{entry_id}/{category_id}</a>

User replied to a comment

Recipient = The Original Comment Creator, Type = Application Specific

Sender Name: {from_name}
Sender email: {from_email}
Subject: MediaSpace - A new reply was added to your comment
Body: A new reply was added to your comment on media <a href="https://4834032.mediaspace.kaltura.com/media/t/{entry_id}/{category_id}">{entry_name}</a> by {reply_user_id}. Reply Text: {comment_text}

User deleted a comment

Recipient = The Comment Creator, Type = Application Specific

Sender Name: {from_name}
Sender email: {from_email}
Subject: MediaSpace - A comment was deleted from media {entry_id}
Body: The comment id {comment_id} was deleted from media <a href="https://4834032.mediaspace.kaltura.com/media/t/{entry_id}/{category_id}">{entry_name}</a> by {delete_user_id} Original Comment: {comment_text}

Content parameters

The following parameters are available:

The term 'category' in this guide refers to both a 'gallery' and 'channel' in the Video Portal (MediaSpace) and to the Media Gallery in KAF applications.

from_email - sender email
from_name - sender name
from_email - Server configuration: partner_notification_email
from_name - Server configuration: partner_notification_name
entry_id - entry ID
entry_name - entry name
comment_text - comment text
comment_id - comment ID
category_id - category ID (entry context)
delete_user_id - ID of the user who deleted the comment
creator_id - entry creator user ID
creator_name - entry creator name
creator_email - entry creator email
category_name_encoded - HTML-encoded category name (better to use in the message body)
reply_user_id - ID of the user who wrote the reply
role - user role
remover_user_id - ID of the user who executed this action
request_date - date requested
AppTasksUrl
service_feature
#{task_id}
reject_reason - reason for rejection

Kalturacapture module

Field	Description
enabled	Enable the Kalturacapture Module.
AllowDownloadingClient	Allow end users to download the Kaltura Capture desktop application from KMS/KAF.
AddNewLabel	Add new Kaltura Capture label.
allowedRoles	Who can create Kaltura Capture? if a role is selected, any role above it will also be able to create Kaltura Capture.
entryURL	What URL to show the user after the captured media is uploaded. Leave blank for KMS base URL.
enableBSE	[KAF ONLY] Enable launching Kaltura Capture from Browse, Search, and Embed module.
limitAppToken	Select 'Yes' to limit the time of the Capture application token to 12 hours.

Kmsapi

About

This module is used to enable and configure the KMS GO application on a mobile device.
KMS GO, is available for Android and iOS and is associated with your MediaSpace instance.
For more information about KMS GO, please see Kaltura MediaSpace GO (KMS GO).

This guide is intended for the Generic setup (default). If you are interested in more information for the branded setup (or customizing your application), please contact your Kaltura representative.

Configuration

To enable the module:

Go to your KMS admin page.
Navigate to the Kmsapi module.
Set Enabled to Yes.

Deep Linking

The next set of attributes builds the Deep Linking that is used to open a MediaSpace URL via the KMS GO application.
You may skip this section if you are using the Generic setup. If your app is branded by Kaltura, make sure to modify it to your custom values.

IOSAppId - The Apple application id that is used when smart banners on iOS Safari are displayed.
For the Generic setup, the default value is 1054967774.

iOSBundleId - The bundle ID of the iOS app to use to open the smart banner link.
For the Generic setup, the default value is com.kaltura.kmsv2.

AndroidAppId - The Android application id that is used when smart banners on Android mobile browsers are displayed.
For the Generic setup, the default value is com.kms.kaltura.kmsapplication.

deepLinkSubDomain - The iOS/Android branded application subdomain. Used for deep-linking.
For the Generic setup, the default value is kmsgoapplication.

storeAppName - The name of the branded mobile application.
For the Generic setup, the default value is Kaltura MediaSpace Go.

appStoreAppId - (iOS) Your app's App Store ID, is used to send users to the App Store when the app isn't installed.
For the Generic setup, the default value is 1054967774

storeAppLogoUrl - The URL for the branded application logo. Image dimensions: 64x64 pixels.
Keep empty to use the default logo. ((The image URL can be obtained by right-clicking on an image on your website and selecting "Copy image address".)

The following screen captures demonstrates the Generic setup and Deep Linking example:

The KMS GO Homepage

The next set of attributes are used to setup the KMS GO app home page.

homeCarouselMode - Set to Automatic to use the Web home carousel configuration or configure it manually for mobile.

Kaltura's best practice is to configure the mobile home playlist manually. Otherwise, you might experience an empty home page.

If Manual is selected, configure the Home Playlists section.

Home_Playlists - Define the playlists for the native home screen. Add as many playlists as you want, but the recommended number of playlists is less than 8.

type - Select the type of playlist.
name - Enter the playlist name that will be displayed.

The first playlist defines the videos in the carousel.

1st example; is a dynamic playlist option "Most Recent", with the name 'What's New".

2nd example; It is very useful to add a playlist that features a channel on the home page. Note that if the channel is not public, it will only be displayed after users have logged in. See example:

Note that you can subscribe to Channels. To set a subscription, go to MediaSapce Channel Subscriptions.

3rd example; For a specific channel playlist, AKA Podcast, choose the following setup as in this example:

The following screenshot demonstrates the home page with three playlists examples.

Global Attributes

playerAutoPlayOnLoad Should the video begin playing automatically when the entry page loads?

mobileSessionLifeTime - The length of a mobile KMS user session (in seconds). Note that every KMS SaaS version deployment will force a new session (on top of the value input here).

appColorR - The R value for RGB that is used as the custom brand color of the app. Input a number between 0-255.
Note: RGBalpha fields cannot be partially filled out.

appColorG - The G value for RGB that is used as the custom brand color of the app. Input a number between 0-255.
Note: RGBalpha fields cannot be partially filled out.

appColorB - The B value for RGB that is used as the custom brand color of the app. Input a number between 0-255.
Note: RGBalpha fields cannot be partially filled out.

The following screenshots demonstrate the application color RGB(0, 255, 255).

splashImageUrl - Set an image URL for the KMS GO app splash screen. The splash image is displayed at the app start.

Use an image size of 192x131, URL must be a secured URL (begin with https://).

The image URL can be obtained by right-clicking on an image on your website and selecting "Copy image address".

The following are an examples of an image URL and a splash image:
https://cfvod.kaltura.com/p/4353783/sp/435378300/thumbnail/entry_id/1_urnrp39k/version/100001/width/280

downloadEnabled Enable to allow downloading media for offline viewing.

downloadQuality Choose the rendition/flavor of the video to be available for users to download for offline playback. High downloads are the highest quality possible (in terms of dimensions and bitrate) and low is the lowest.
downloadToGoQuality Chooses the quality of the video to be available for users to download for offline playback.

When enabled, Downloading media can be accessed via tapping the three dots icon on a media page (left figure below), or by swiping a media to the left from a vertical view of a gallery or a playlist (right figure below).

smartBannerEnabled Enable the smart banner for Android and iOS applications.

When opening your KMS links on a mobile device via the browser, Kaltura automatically pushes a banner at the bottom of the page inviting the end user to open the Kaltura Go app instead.

dontShowLoginInMyPage Don't show the login button on my page.

When set to 'No', the login button is displayed on My Page (see left figure). When set to 'Yes', the login button is not displayed (see right figure).

uploadEnabled Enable displaying the upload functionality.

When set to 'Yes', the Upload button is displayed on the bottom navigation bar, as seen below:

showMySubscriptionSection Enable displaying the list of channels on top of the home screen that the user is subscribed to.

playlistContinuousPlay Select whether the playlist entries should play automatically one after the other.

allowPushNotifications Allow the app to push notifications on Android and iOS mobiles.

hideInspireMe Selects whether to hide or show the Inspire Me section.

hidePublisherName Selects whether to hide the entry's publisher name.

iosTermsOfUse - Add the terms of use that will be displayed to the user on iOS devices.
Note: For translation, fill this field with 'terms_of_use_ios' and translate via a PO file.

androidTermsOfUse - Add the terms of use that will be displayed to the user on Android devices.
Note: For translation, fill this field with 'terms_of_use_android' and translate via a PO file.

Go to Settings and select Legal for the KMS GO End User License Agreement.

spotlightSearchEnabled Enable spotlight Search from outside the application on iOS. Spotlight lets you search your entire Mac or iOS device at once. When using this feature, you may not want a certain file type disaplying in your search results.

adTagUrl - Add the URL for the IMA (Interactive Media Ads) to enable DFP (DoubleClick for Publishers – to display ads on top of videos).

idleTimeout - Max allowed idle time before the session’s timeout (in seconds). To disable the idle timeout, enter 0.

disableIosBackgroundSnapshot Disable the cache background snapshot in iOS.

shareUrlAsDeepLinks Selects whether the shared URLs will be deep links.

For example, when shareUrlAsDeepLinks is set to No:
https://4353783.mediaspace.kaltura.com/media/How+to+add+a+Header+Image+Logo+in+MediaSpace/1_mf3yyeq1

For example, when shareUrlAsDeepLinks is set to Yes:
https://kmsgoapplication.page.link/?link=https://4353783.mediaspace.kaltura.com/media/How+to+add+a+Header+Image+Logo+in+MediaSpace/1_mf3yyeq1&ibi=com.kaltura.kmsv2&isi=1054967774&apn=com.kms.kaltura.kmsapplication

deleteRecordedContent When enabled, content that is recorded using KMS GO will not be stored on the user's device after upload.

appleAppSiteAssociation - Add the apple-app-site-association response for deep linking. Associated domains establish a secure association between domains and your app so you can share credentials or provide features in your app from your website. Log into your Apple developer account and go to the app's ID page. Enable the Associated Domains app service. Take note of your Prefix (bundle ID) and your ID (team ID) - you will need them later. Add the "Associated Domain" capability to your app in Xcode, and add your web servers' domain as an associated domain.

webAuthenticationLogin Use web authentication login instead of Webview login. WebView by default only displays a web page.

Listpage module

About

In the Listpage module, admins are able to create a new type of page containing a list of thumbnails with descriptions, each with links to external or internal pages.

Note: KMS only Module. Depends on the Theming module.

Page configurations

Enable the module, and start creating your pages. Click the Add "listPage" button to create a new page.

General page settings

Here are the general configurable options available for each page:

Page Title - Use the pageTitle field to set the top page title.
Page Description - Set a description to show at the top of the page using the pageDescription field.

Create the List

Use the Add placeholdersList button to create a new line in the list called a list item, or a placeholder.

For each placeholder, the following configs are available:

Title - Set the list item title from the title field.
Description - Set the list item title from the description field.
Thumbnail - Set the list item title from the thumbnailUrl field. A 16:9 aspect ratio is suggested.
Links - Setup links at the bottom of the list item, using the Add buttons button. Enter a link and a text for each

Each such placeholder can hold many links, however three to four is the recommended number, depending on the text of each button.

Publish your page

Each created page will have a Path making it available for users per the Permissions set in the config:

Path/URL - Select the custom page's URL using the pageSlug field.
1. Enter alphanumeric only with no spaces, with special care for capital letters (recommended not to use capital letters). Signs such as Underscore ("_") are accepted, however, do not use Space (" ").
2. The results will be a new URL in the application https://{your_site_url}/{slug}
  (e.g. Enter the slug 'help' to create a help page in the https://mykmssite.kaltura.com/help URL).
Permissions - Choose who can navigate to the selected page using the permission field.
1. The selection is of a minimum role, starting with everyone, up to a limited availability.
2. To allow this page for guests/anonymous users:
  1. Set 'anonymousRole' to allow guests to view the page if your site is set to support anonymous users (set from the auth module).
  2. If your KMS does not support anonymous users, choose 'guest override' to make this page public to all users.

When choosing a path make sure it is available first. For example, the Helppage module provides a page in the /help path, do not use that path if that module is already used.

Page example

Mediastitching module

Meetingentry

Oembed

Field	Description
enabled	Enable the Oembed Module.
type	Which type of oEmbed code should be displayed? 'Short' is the common type. For example: http://url.for.mediaspace/id/xyz, where xyz is the media asset ID (entry ID). 'Short' links are valid URLs. A 'Short' link entered in a browser loads MediaSpace with the video loaded in the player. 'Full' is much longer than 'Short.' Use 'Full' when your oEmbed 'consumer' cannot convert a link embed code to a full oEmbed request.
enableCustomization	When a user selects 'oEmbed' for the 'Select Embed Type' option, should the options for selecting a player skin and player size be displayed? Note: If you enable customization, your oEmbed must be able to accept the oEmbed link format that is created.
playerId	What player ID (uiConf ID) should be used to display the embedded video? Note: If you are not sure, enter 'default' (without quotes) or leave the playerId field empty. MediaSpace will use the value of the first embedSkin config.
height	What is the height (in pixels) of the oEmbed player? Enter only the number.
width	What is the width (in pixels) of the oEmbed player? Enter only the number.

OneDrive module

Field	Description
enabled	Enable the OneDrive module.
allowedRoles	Select the minimum role to be able to import files from OneDrive.
applicationId	Enter the application (client) ID from the application page in Microsoft Azure.

Personalprofile

This is a KMS-only module that depends on the Theming module.

About

The Personalprofile module provides the ability to create a My Profile page in KMS Video Portal. Users can access their profile by visiting {KMS_URL}/profile, where they can view and update their information. Each profile is visible to all logged-in users and has a unique URL.

In this module, admins can customize what information appears on the user's info card, which fields are editable, and the header background for all profiles. They can also enable the groupChange feature, allowing users to switch groups.

Presenters, as defined in the presenters module, will have a tab on their profile displaying all media where they are presenting. Additionally, the profile owner can access a tab showing their watch list if the watchlater module is enabled.

When 'Created by' links are enabled, they will direct users to the creator's profile page instead of a search page.

Configure

Page UI - Use the headerBannerDefaultImg field to set a custom banner at the top of the page.
User Fields - In the fields section, you can choose which user fields to show, and which can the user edit.
Editing - To allow any editing in the page by the user, turn on the allowEdit field. Note, that the editing of each field can be limited from the fields section.
- Once editing is allowed, you can also allow upload of user thumbnail. If no thumbnail available, initials will be used instead.

Enable

Once you have enabled and configured the PersonalProfile module, you can add a "My Profile" link to the site's user menu on the top left.

To do so, navigate to the Headermenu module, click the "add menu" button, and set the new menu item as described below:

Type = URL
Label = My Profile
link = /profile
sameWindow = Yes
linkLocation = User Drop Down

Profile page features

Each user profile is visible to all logged in users, and has a unique URL.

Any user can reach their profile by entering {KMS_URL}/profile. This will allow them to view their info and to update elements of their profile as allowed by the admin.

Once enabled, ‘created by’ links will redirect the user to the creator’s profile page instead of a search page.

Presented Sessions

Users set as presenters (see presenters module), will have an additional tab on their profile showing all users the media in which they are presenting, per the viewing user's entitlements permissions.

This content presented on this tab is limited to scheduled live sessions and scheduled meeting rooms.

Watch List

The watch list tab, viewed by the profile owner only, will show the user’s their watch list (Admins permission required in the watchlater module).

Presenters

Field	Description
enabled	Enable the Presenters Module.

Publish module

REACH

REACH offers two different service options, human captioning and ASR machine transcription, which can be used separately or together. Captions ordered directly within the Kaltura interface are automatically delivered and can be edited for quick review and modification.

Field	Description	Values
enabled	Enable the REACH Module.
reachProfileId	ID of the REACH profile to use with Kaltura MediaSpace or KAF.The Reach profile includes the credit, and other parameters such as: moderation flow, file types etc.	At least one profile must be selected.
orderScreenText	Text to show on the order task form: 1000 characters max.
unitFieldName	Select a label for the 'Unit' field . If left empty "Unit" will be used.
availableServices	Allow users to select the following services.	Combinations of all available services, features are TAT. For example: HUMAN, CAPTIONS, THIRTY_MINUTES HUMAN, CAPTIONS, SIX_HOURS HUMAN, CAPTIONS, FORTY_EIGHT_HOURS HUMAN, CAPTIONS, BEST_EFFORT HUMAN, CAPTIONS, TWENTY_FOUR_HOURS HUMAN, TRANSLATION, TWENTY_FOUR_HOURS HUMAN, TRANSLATION, IMMEDIATE HUMAN, TRANSLATION, THREE_HOURS HUMAN, TRANSLATION, SIX_HOURS MACHINE, TRANSLATION, SIX_HOURS MACHINE, TRANSLATION, BEST_EFFORT MACHINE, CAPTIONS, THREE_HOURS MACHINE, CAPTIONS, SIX_HOURS MACHINE, CAPTIONS, THIRTY_MINUTES
viewEntryRequestsRole	Select the role required to access the entry task requests screen.	privateOnlyRole adminRole unmoderatedAdmin Role Co-Editor Owner
orderer	Select who can order tasks.	Specific Roles Specific Users
orderRole	The minimal role required to order tasks.	privateOnly Role admin Role unmoderatedAdmin Role Co-Editor Owner
serviceTypeDefault	Select the default service type.	Machine Human
serviceFeatureDefault	Select the default service feature	Captions Translation Alignment Audio Description
sourceLanguageDefault	Select the default source language.	See Source Media Languages.
turnaroundTimeDefault	Select the default turnaround time.
serviceSelectionRole	The minimal role required for service selection.	privateOnly Role admin Role unmoderatedAdmin Role Specific Users
featureSelectionRole	The minimal role required for feature selection.	privateOnly Role admin Role unmoderatedAdmin Role Specific Users
TatSelectionRole	The minimal role required for TAT selection.	privateOnly Role admin Role unmoderatedAdmin Role Specific Users
speakerSelectionRole	The minimal role required for speaker selection.	privateOnly Role admin Role unmoderatedAdmin Role
dashboardAccessRole	The minimal role required to approve task requests. Once a user/group is added in dashboardAccessRole, a new menu item displays for them on the User menu in KMS - "Services Request".	Specific Users admin Role unmoderatedAdmin Role
requestApprovalRole	The minimal role required to approve task requests.	Specific Users admin Role unmoderatedAdmin Role
notifiedUsers	Select specific users who will receive email notifications about items pending moderation. To customize notifications, go to email notifications configuration.	Enter the user name. Existing users may be found using the autocomplete feature: type in the first three characters of the user’s name.
trustedUsers	Select users who do not need approvals for their requests.
categoryRuleOrderRole	Select who can order on category level.	Channel Manager Channel Owner
captionEditRole	This role is required to open captions editor	privateOnly Role admin Role unmoderatedAdmin Role Co-Editor Owner
allowProfilePermissions	Allow individual profile configurations.	Select Yes and then configure values for each profile according to the values in this article.

Recorder module

Recyclebin module

Replacemedia

Field
enabled	Enable the Replacemedia module.

Robots

SAML module

About

This module enables admins to set up SSO authentication for their video portal using the SAML 2.0 standard. For detailed setup instructions and error log documentation, visit our article Kaltura Video Portal SAML integration guide.

This module is for the video portal only and does not support instances created by Kaltura Events.

Configure

1. Go to your Configuration Management console and click on the Saml module. You can also navigate to it directly using a link: https://{your_videoportal_URL}/admin/config/tab/saml.

The Saml page displays.

2. Configure the following:

enabled - Set to 'Yes' to enable the module.

metadataMode - Select Manual or Automatic.

enableMultiIdp - Enable using multiple IDPs (requires MultiAuth to be enabled)

loginRedirectUrl - Enter the URL to redirect the user when authentication is required (relevant only if metadata mode is set to Manual). For SP initiated it would be a URL where the request is posted. For IdP initiated a URL with the entity ID as a parameter.

SP Initiated Example: https://idp.example.com/identity

IdP Initiated Example: https://idp.example.com/identity/UnsolicitedSSO?entityID=mediaspaceentityID

logoutRedirectUrl - Enter the URL to redirect the user after logout.

This field is only applicable if useInternalLogoutPage is set to "No" and metadataMode is set to "Manual". When the video portal session expires, the user is redirected to this URL, along with a SAML logout request. This request is made via POST request.

The video portal does not expire login session from the identity provider. For the logout request, video portal uses the value that was provided in the NameID element in the SAML login request.

relayStateUrlParam - Enter the parameter name used by the IdP to specify the redirect URL for relay state when in 'IdpFirst' mode. This defines the default redirect location if it’s not included in the request. For example, in PingFederate, this would be TARGET, while for most other SAML providers, it defaults to RelayState.

enableMetadataEndpoint - Enable the SP metadata endpoint to retrieve SP metadata. Once enabled, you can access the SP metadata at https://{hostBaseURL}/saml/index/sp-metadata. Make sure to replace {hostBaseURL} with the value specified in the host field of the spMetadata section below.

useInternalLogoutPage - If set to 'Yes', logging out will terminate the video portal session, and use the internal logout page instead of redirecting to the IdP logout page, accompanied by a message such as the following: You have signed out of MediaSpace. For improved security, we recommend closing all browser windows at the end of your online sessions.

allowKeepAlive - When set to 'Yes', session will be extended upon user's interaction. Default is 'No'.

logoutText - If useInternalLogoutPage is set to 'Yes', you can define a custom message to users. You can use HTML tags to display a message.

shouldNestRelayState - Choose whether to append the relay state as a regular query string or as a URL-encoded query string.

shouldPost - When set to 'Yes', the SAML request will be posted instead of using get. Default is 'No'.

shouldSignLogoutRequest - When set to 'Yes', the SP SAML logout request will be signed. Default is 'No'.

shouldDecodeRelayState - When set to 'Yes', RelayState will be decoded before redirect.

spMetadata

Configure the settings of this Service Provider (SP) as defined in the Identity Provider (IdP).

name - Enter the entity ID of the service provider (video portal) as it was configured in your Identity Provider. For example: https://partner_id.mediaspace.kaltura.com (this will be used as the SP entity ID).

host - Enter the desired video portal alias URN (no https:// needed). Please note that only one video portal alias can be used with the SAML module. This is the host of your video portal instance (for example, partner_id.mediaspace.kaltura.com).

The host can only be configured with a single URL per video portal instance. If you are using a custom alias for your video portal (for example, video.company.com), use that alias instead.

relayState - Enter the value for the relative URL to redirect the user after login if a relay state is not passed as part of the authentication request. The default is /.

nameIdFormat - This field is only applicable for SP-initiated mode and will not function if the NameID is not released. Select from the following options:

Transient: Recommended for Shibboleth setup.
Persistent: Preferred setup.
None: Removes the NameIDPolicy element from the SAML request.

certificate - (Optional) Enter the certificate information for encryption of the SAML response. Paste the content of the .crt file without the comment lines (for example, do not paste in: -----BEGIN CERTIFICATE----- and -----END CERTIFICATE-----). Make sure all text is in a single line with no spaces or line breaks. See Generating a Certificate Workflow.

The certificate value is used to encrypt the response provided by the IdP. The following example shows how the crt file would look including the comment lines and the extra line breaks that should be removed:

privateKey - (optional) SP Private Key PEM format. The privateKey value is used to decrypt the response provided by the IdP.

idpMetadata

Configure the settings for the Identity Provider (IdP) as follows:

host - IdP Host Name. Enter the Identity Provider's entity ID (for example, https://openidp.feide.no).

issuer - IdP Issuer: The entity ID of the Identity Provider as it appears in the SAML response (for example, https://openidp.feide.no).

name - Enter a user-friendly display name for the IdP (in English).

certFilePath - Enter the full path on the video portal server where the SAML certificate is stored, including the file name. Make sure the certificate file does not contain comment lines like -----BEGIN CERTIFICATE----- or -----END CERTIFICATE-----.

certFileContent - Use this field as an alternative to certFilePath. Paste the content of the .crt file without the comment lines (for example, do not paste in: -----BEGIN CERTIFICATE----- and -----END CERTIFICATE-----). Ensure all text is in a single line, and leave certFilePath empty if using this field.

attributes

userIdAttribute - (Optional) The SAML attribute containing the user id. When blank, NameID element will be used. Example: urn:oid:1.3.6.1.4.1.5923.1.1.1.6

firstNameAttribute - (Optional) The SAML attribute containing the first name. Example: urn:oid:2.5.4.42

lastNameAttribute - (Optional) The SAML attribute containing the last name. Example: urn:oid:2.5.4.4

emailAttribute - (Optional) The SAML attribute containing the email. Example: urn:oid:0.9.2342.19200300.100.1.3

logoutUrlAttribute - (Optional) The SAML attribute containing the logout URL. Example: urn:oid:0.9.2342.19200300.100.1.3 When configured, if useInternalLogoutPage is set to No, the value passed in the attribute will be used instead of the value set in logoutRedirectUrl.

defaultRole

In the defaultRole section, select the default role that should be assigned to each user that is authenticated.

You can configure the option to retrieve the role of the user from the Identity Provider through the Auth module refreshRoleOnLogin setting every time a user logs in. This option allows you also, to define a default role for all users and then manually override the role through the MediaSpace user management section.

allowDefaultRole - Set to 'Yes' or 'No'.

role - Select the default role that should be assigned to each user that is authenticated. Choose from the following options:

viewerRole
privateonlyRole
adminRole
unmoderatedAdminRole

roleAttributes

Click +Add "roleAttributes to map attribute values to video portal roles.

An additional section displays:

Configure the following:

attribute - Enter the SAML attribute name.

value - Enter the SAML attribute value.

role - Choose the mapped video portal role from the following options:

anonymousRole
viewerRole
privateonlyRole
adminRole
unmoderatedAdminRole
emptyRole
partnerRole

If more than one attribute value is found (a user belongs to multiple groups) the user will be mapped to the role that was defined in the last roleAttribute found.

In the following example the SAML response will be parsed to find an attribute named group. If the attribute is found in the assertion and its value is student, the user will get the privateOnlyRole.

roleAttributesCsv

Complete the following values:

roleAttributesCsv - Map attribute values to video portal roles. Each CSV row should include three values: attributeName, attributeValue, and videoportalRole. Invalid video portal roles would not be saved.

Click Load a new CSV to upload a CSV with role attributes.

storageDataEntryId - Enter the data entry ID that stores the parsed csv data

blockAuthorizationAttributes

In the blockAuthorizationAttributes (optional), you can map individual groups and values that are returned in the SAML response and should lead to unauthorizing an authenticated user from using the video portal.

Click +Add "blockAuthorizationAttributes".

A new section displays:

Complete the following:

attribute - Enter the SAML attribute name.

value - Enter the SAML attribute name.

unauthorizedBehavior

The unauthorizedBehavior (optional) is applicable only if the blockAuthorizationAttributes is used. If the field usersuseInternalUnauthorizedPage is in use (set to ‘Yes’), you can optionally set the text to be presented to the unauthorized user. If usersuseInternalUnauthorizedPage is not used, you can specify the URL where the user will be redirected to.

Complete the following values:

usersuseInternalUnauthorizedPage - Default is 'Yes'. If set to 'No', unauthorizedRedirectUrl will be used.

unauthorizedRedirectUrl - (Optional) The URL to redirect the authenticated, but unauthorized users. Should be used only in cases where the customer wants authenticated users to be redirected to his self hosted page.

unauthorizedText - (Optional) Enter the text to be shown in the internal unauthorized page. Leave empty to use the default text.

nameIdStructureAsArray - Specify whether to construct the Name ID attribute as an array when building a SAML Logout Request (leave empty to use as a string).

3. Click Save.

Samlgroupsync

Scheduling

Field	Description
enabled	Enable the Scheduling module.
dateFormat	Define the date format for the time presented.

Securitytxt

Field	Description
enabled	Enable the Secuirtytxt module.
configSecurityTxt	Enter the content for the security.txt file.

Sidemymedia

Field	Description
enabled	Enable the Sidemymedia module.
limit	How many Sidemymedia items can be displayed?
showInCategory	Should the module render the sidebar if in category context?

Sideplaylists

Field	Description
enabled	Enable the Sideplaylists module.
limit	How many items can be displayed in a side playlist?
items	Define playlists to display on the right side next to the player.
label	Enter the playlist label.
id	Enter the ID of the playlist to display.

Ssogroupsync

Staticpages

Field	Description
Module Info
description	Create custom static pages in KMS.
styling	It is best to use Bootstrap css classes in the markup.
custom styling	Use inline styles, or consider using the cssupload Module.
enabled	Enable the Staticpages module.
title	The title of your page to display as the page header
pageSlug	What is the *unique* semantic slug for your page? (e.g.www.yourvideoportal/<slug>) The unique identifier for the page to be accessed as a URL. For example, if you provide 'privacy' as a slug, you can add links to your static page as [MediaSpace URL]/privacy. You can add these links in Navigation or Headermenu modules or anywhere you want to include links to your pages within the MediaSpace site.
permission	Select the minimum role allowed that can access this page. Set as anonymousRole to keep this page public. Use the “guest override” field to allow anonymous users to access static pages even if anonymous is turned off in KMS.
content	What is the content of this page? You can use HTML and Bootstrap.

Styling

About

The Styling Module for Video Portal (aka MediaSpace) and KAF administrators, provide the ability to create a new style based on most common use cases. With the Styling module, admins can view the newly generated theme, and share it with other admins before setting it up on production.

This guide demonstrates the V2UI Styling capabilities, for the new Theming Feature Set, see Theming.

For advanced theme creation, for which a deep CSS understanding is required, please use Kaltura’s Cssupload Module

Custom CSS Fonts

Enable - Select Yes to enable the Styling module

Fonts - Select +Add"fonts" These fonts will be available in custom CSS and in the Font selectbox on the styling page

familyName- Font family name that will be used in CSS and will be appended to the Font select box on the styling page.
fallbackFonts- Font families and font types which should be used as a fallback when the desired font family is not ready or doesn't exist (comma-separated list, like in CSS specifications).
Specifying generic font type (like serif or monospace) is mandatory.
Example: 'Helvetica Neue',Arial,sans-serif
type - Font assets source type:
- System font - use worldwide supported font by name
- Import from URL - use an external font service (like Google Fonts)
- Upload files - upload your own font asset files

isCssApplied - This field indicates whether the style created in the Styling Module is applied on the site or not. Click Reset to clear all previously set styles.

The Styling Configuration Page

The Styling Configuration page provides administrators with an interface where they can modify look and feel attributes like text color, background color, and fonts.

Use the link provided in the description to access the new Styling Page.

The Styling Configuration page displays.

Here is a list of the items that can be modified in the Styling module:

Tab Location	Attribute	Description	Visual
Fonts & Text	Font	This modifies the default MediaSpace font.
Fonts & Text	Text Color	This modifies the default text color within MediaSpace.
Fonts & Text	Links Color	This modifies the color of hyperlinked text within MediaSpace, as well as certain icons and other dominant UI elements.
Fonts & Text	Links Color (:hover)	This modifies the color of hyperlinked text that is currently being interacted with by the end user, as well as certain icons and other dominant UI elements that are being interacted with by the end user
Page Elements - Buttons	Buttons Color	This modifies the text color and border color of buttons.
Page Elements - Buttons	Buttons Color (:hover)	This modifies the text color of buttons when they are active or being hovered by a user.
Page Elements - Buttons	Primary Buttons Color	This modifies the background color and border color of primary buttons.
Page Elements - Buttons	Primary Buttons Color (:hover)	This modifies the background color of primary buttons when they are active or being hovered by a user.
Page Elements - Buttons	Danger Buttons Color	This modifies the background color and border color of danger buttons.
Page Elements - Buttons	Danger Buttons Color (:hover)	This modifies the background color of danger buttons when they are active or being hovered by a user.
Page Elements - Background	Header Background	This modifies the background color of the KMS header. This area that contains the logo and primary navigation.
Page Elements - Background	Footer Background	This modifies the background color of the KMS Footer at the bottom of each page.
Page Elements - Background	Page Background Color	This Modifies the background color of the primary content wrapper.
Page Elements - Background	Tags Color	This modifies the border as well as font color of any tags associated to videos.
Menus - Header Navigation	Header Navigation Text	This modifies the color of both the text and the underline effect on the primary navigation.
Menus - Header Navigation	Header Navigation Text (:hover)	This modifies the color of both the text and the underline effect on the primary navigation when hovered.
Menus - Dropdown Menus	Dropdown Menu Text	This modifies the color of the text and icons in dropdown menus
Menus - Dropdown Menus	Dropdown Menu Text (:hover)	This modifies the color of the text and icons in dropdown menus when that element is actively hovered.
Menus - Dropdown Menus	Dropdown Menu Background Color	This modifies the background color of a dropdown menu.
Menus - Dropdown Menus	Dropdown Menu Background Color (:hover)	This modifies the background color when a child element of a dropdown menu is hovered or clicked.
Extras	Black & White Home Page Thumbnails	This applies a black and white filter to the home page playlist thumbnails below the carousel. On hover, filter is removed, and thumbnail will come back to full color.
Extras	Black & White Home Carousel Thumbnails	This applies a black and white filter to the home page carousel background thumbnails. The small thumbnail in the carousel will keep its color.
Extras	Black & White Channel/Galleries Thumbnails	This applies a black and white filter to the gallery thumbnails, and the channel’s playlist and media thumbnails as well (but not to the header). On hover, filter is removed, and thumbnail will come back to full color.
Extras	Black & White Channel Thumbnails	This applies a black and white filter to the channel’ thumbnails within the All-Channels and My-Channels pages. On hover, filter is removed, and thumbnail will come back to full color.
Extras	Remove Media Type Icon	Remove the little icon indicating the media type from the thumbnails top left corner.
Extras	Carousel Buttons Always On	Set the left and right buttons of the home carousel to always show. When off, the buttons will be displayed only when hover.

Templatepages module

About

Administrators can use the Templatepages module to create multiple pages containing different components suitable for each page. Once a template page has been configured, use the CustomPages module and set it with its own unique URL and permissions.

To learn more, visit Create and use a template page.

Applies exclusively to the Video Portal. The Theming module must be enabled.

Configure

Go to your KMS admin page, and navigate to the Templatepages module. Your link should look like this: https://{your_site_url}/admin/config/tab/templatepages

enabled - Set to 'Yes' to enable the module.

previewPlayerId - This is the player ID that will be used for hero and single player components across all pages. The player will be automatically created upon enabling the module.

heroPlayerAnalytics - By default, player analytics for the hero banner on template pages are disabled because the player operates in a "gif" mode. To activate analytics for the hero carousel player, simply set to 'Yes' to enable this option.

Create a template page

Click the +Add TemplatePage button. This will allow you to create a page from any of the template pages.

At the top of your new template page there are three general page fields:

pageName - Enter a name for your page. This name will be presented in other modules when prompted to select a template page from a drop-down list. For example, in the Custompages module.

pageTitle - Enter a title for the page. This title will show on the browsers' tabs names.

pageHeader - Enter a header for the page (optional field). This header will show on the top of the page only when using a Hero unit.

Page elements

There are three types of elements on the page that as a page builder you can choose from:

Navigation Bar
Hero Unit
Components

Below you will find the information on each type.

Navigation bar

For each page, a navigation bar will be presented. You can choose from two types of navbars: Site Navigation or Clean NavBar.

Site navigation

This navbar will present the same navbar as the site's navigation. This navbar is controlled from the navigation module, and will be the same on all the site's pages.

Clean navbar

This navbar will provide simplified and clean navigation. Limited to a call to action button and a custom logo, this will provide different settings for the page.

If you choose a clean navbar, an additional window displays:

Configure the following fields:

logoImageUpload - Upload your own or use the site's logo.

logoAltText - enter alternate text for the logo

logoLink - Select the click behavior of the logo

If you'd like to present a call to action button, fill in the callToAction section.

If you'd like to present the language selector (assuming it is available on the site), set the showLanguageSelector field to 'Yes'.

Hero unit

A hero unit is a component that can only be available at the top of the page. This is for a few reasons, mainly because of the interaction with the navbar and its transparency. It's not mandatory to have a hero unit on the page.

You can select from two types of hero units: Player Carousel or Text & Counter.

Player carousel

This hero will present a dynamic carousel, playing back a list of live or VOD media on a muted player to create a feeling of a live site and moving elements. The video is muted, and cannot be played in the ordinary way - you could consider it as a carousel of GIFs.

Note the heroPlayerAnalytics option above. By default, player analytics for the hero banner on template pages are off due to the "gif" mode. To turn on analytics for the hero carousel player, just set it to 'Yes'.

There are three sets of media that can be displayed on the carousel: Live events, VOD playlist, or Images.

liveCategory - select the category from which the live sessions will show. Leave it empty to not show live media on the banner.

When choosing a category is name/ID, entitlements may apply and hide any media not published in the site.

Select a fallback option - 'VOD Playlist' or 'Images and CTA list' (see how to configure these below below).

VOD list - Select a playlist to show using the vodPlaylist section. Note that the available playlist types include a custom playlist and a channel playlist. If no VOD list is selected, the hero unit will not show on the page. Live media will be presented at their scheduled time. Meaning, if the event is not live, the player and carousel will not show. If no media is live at that moment, the hero will fall back to present either on the player the VOD list of media or the images.

Scheduled Room type media is not supported.

Image List - You can add up to 8 images to the hero carousel. In the imageCarousel window, configure the following:

uploadHeroImage - Upload the image you want in your hero.
imageAlt - Add an alt text string (this will be shown if the image doesn't load immediately)
Title - Add a title or wording you want to be shown on the image.
Description - Add short description to be shown on the image (optional).
Add a CTA url - Add a link for the users to navigate to when they click the CTAbutton.
callToActionText - Add text you want to show on the CTA button.

You can add more images to the hero carousel by clicking +Add "ImageCarousel" repeating the steps above.

For more than one image, you will need to type the carousel transitions interval (in seconds) in the carouselInterval field. For best results, it's recommended to have a 30-second transition time.

UI/UX - Note that users can always skip between elements, and for accessibility reasons, the carousel transitions can always be stopped by the end user.

The image below is our hero with the 'imageCarousel' configuration:

Text & Counter

This hero will show static texts and selected background at the top of the page with the option to add a time counter.

All elements on this hero unit are optional and can be hidden by leaving the fields empty.

Enter the Title and Description to show at the top of the unit.
Fill in a Start and End Date(fill in both or none) to show a "from...to" element on the screen below the description. Acceptable date formats:
- Unix Timestamp - Example: 1580518923 (look for 'unix timestamp converter' in any browser)
- String format under the UTC time zone (Example: 2020-02-01T01:02:03)
Add a Call-to-Action button. You can add one or two buttons, that will show up as a Primary and Secondary.
Add a Time Counter to your hero unit, counting down to a specific time and date. The counter will disappear once it reaches the deadline.
Upload a Background atmospheric image for the hero. We recommended a 1920x1080 resolution, with no text to prevent clashing with the formatted text on the hero.

The image below shows the hero with the 'Text & Counter' configuration:

Components

Click +Add "components" to create a new component.

All components have a few shared fields:

Type - Select the type of component you want: Text only, Single Playlist, 2 Images Side by Side, News Images, Registration, Collection of channels, Banner & CTA or Group of users.

Order - Fill in a number (larger than 0) for the order in which the components will appear on the page, for example 1 = highest position on the page. However, we suggest using large, non-consecutive numbers such as 10, 20, 30, as this will allow for simple changes in the future. For example, if you want to add a new component between the first and the second component, you can call it 15 and you won't have to renumber all your components.

Allowed Groups - This feature allows you to limit the visibility of each component to a selected set of users in a group/s. Leave empty to show to all users.

Note that the page is not limited to one component type per page. You can add many components of a single type of the page. However, please note that adding too many components will cause the page to load slower (for example, adding 100 playlists to the page will slow it down, and is not a good UX anyway).

Text only

This component is simple text which is centered on the page. The text color and background can be set (as shown in the example below).

Line breaks and other capabilities can be achieved using html tags (e.g. )

Settings example:

Settings result:

Single playlist

This component shows a list of media in the form of a carousel.

headerText - Enter a title to show at the top left of your playlist(s).

headerLinkText - If you don't enter any text, the default "See All" is automatically set and will take the users to the playlist page.

Select the content of the playlist from the playlist section. (If you choose Custom playlist, see note* below.)

The forceShowContent will allow you to override entitlements for the playlist. However, the content will not be clickable.
(The "See All" link will also be removed or redirected to a link of your choosing in the headerLinkAction field.)

This feature is mainly used for external pages, where the site guests (unauthenticated users) will be able to get a sneak peek of the content.

*If you select Custom Playlist, you have additional configurations:

playlistID - Enter the ID for your custom playlist.

PlaylistDisplay - Choose how the playlist is displayed when the viewer clicks "See All" - as a grid layout or as the playlist player page with the list of other entries in the playlist.

itemsPerPage - Select how many thumbnails you want to display on the page.

Time Shift - Set a time in minutes where the the media will shift one thumbnail to the left. Leave empty to disable.

The image below shows a playlist configuration with three thumbnails:

User interaction with single playlist component

Channel Content Playlist:

When a user clicks "See All", they're directed to the channel page where they can explore all content.
When a user clicks a thumbnail, they're directed to the selected video in the single entry player.

Manual Custom Playlist:

When user clicks "See All", they're navigated to either grid or player view, depending on what was configured in PlaylistDisplay.
When a user clicks a thumbnail, they're navigated to that item either in the playlist player or the entry page, depending on what was configured in the Playlistpage module > ThumbLink field.

Dynamic Playlist ('Most Recent', 'Recently Watched', etc. excluding 'Recently Watched' and 'Continue Watching'):

When a user clicks "See All", they're navigated to the grid view to browse the playlist. (Clicking a thumbnail there directs them to the single entry page.)
When a user clicks a thumbnail, they're navigated to the entry page of that item.

Two images side by side

Configure the left and right images using one of the following three options: image entry ID, image URL or image upload.

For best results, the aspect ratio of the image should be 16:9.

callToActionUrl - Add a link to navigate the users to. The link will open in a new tab. If left empty, the image will not be clickable.

AnalyticsString - This adds the "data-analytics" to the image tag. Enter a keyword or intuitive description, for example, 'tools'.

Not to forget - Alt Text for accessibility.

The image below shows two images side by side:

News images

This component shows images with texts in the form of a carousel. Each element on the carousel will open to an article. For information on creating news images, visit our article News Images playlist.

You can change the background color using the modalBoxMaskColor field.

After you have created a News Images playlist, enter the playlist ID.

Example of our configuration of two News images:

Registration

This component makes registering quick and easy for users. By clicking the "Register" button, the registration page opens on the side of the page for easy completion. No need to navigate elsewhere!

title - Enter a title for your registration page, for example, Register for the event.

buttonText - Add any text you want. If you leave the field empty, the default text Register will display.

scheduleTimeFrom - Enter the time you want registration to begin in unix time. Leave empty if you don't want to show a time.

Unix time is a common computer timestamp system. It counts seconds from 00:00:00 UTC on January 1, 1970, known as the Unix epoch, without considering leap seconds. You can use the on-line EpochConverter tool to convert your times.

scheduleTimeTo - Enter an end time (unix time). Leave empty if you don't want to show a time.

inScheduleText - Enter text that you'd like to display while registration is open.

outofScheduleText - Enter text to display after registration has closed.

If the Siteregistration module is disabled, this component won't be visible to users. In addition, if the registrationClosed function in the Siteregistration module is set to 'Yes', the component won't appear.

Below is an example of the Registration component on a MediaSpace site.

Collection of channels

This feature gives users an easy way to explore and access channel collections. Clicking 'See All' will take users to your channel collection page. If you don't have any channel collections yet, you can set them up in the ChannelCollections module.

If the ChannelCollections module is disabled, this component won't be visible to users.

headerText - Type in any name you'd like for the component header, for example, 'Our channel collections'.

headerLinkText - Select the text for the component header link (simple text). Leave empty to use the default text.

timeShift - This determines how often each thumbnail in the collection will move to the left. Simply enter a duration in minutes (e.g., 1, 2, 3, 4) or leave empty to disable. The channels will appear on the page in the order specified in the ChannelCollections module's 'sortBy' field (the default sort you chose for your channel collection). The timeshift feature ensures that all channels will be displayed over time.

This shift occurs when the page is refreshed.

In the collection window, choose the channel collection you want to display on the page. All your channel collections appear in the drop-down menu.

forceShowContent - Choose 'Yes' to display all collection content to every user, regardless of entitlements. This makes the component unclickable, but you can still choose a different link for the component's items, for example if you want to use this templatepage as an external page / landing page that everyone can see.

headerLinkAction - This is where you can add a link to take your users to the page you choose.

channelsInLine - Choose how many channels you'd like to display on one line - 6 or 8. (Choosing 8 will reduce the size of each circle.) The thumbnails come from your channel. If you've added a banner icon (see our Edit a Channel article), it becomes the thumbnail. Otherwise, the thumbnail uses the banner's central background.

maxLinesNumber - Choose how many lines of channels to display from the drop-down menu. The default is 2 lines.

Below is an example of the Collection of Channels component on a Video Portal site in 2 rows of 8:

Banner & CTA

This component provides a banner with text, a call-to-action button and background image.

HeaderText - Add the text that you want to appear as a title on the banner.

DescriptionText - Add a description or text that you want to display below the header.

The more text you add, the bigger the banner will become.

Banner image - You have three options for adding an image: entryID, imageURL or imageupload. Feel free to upload any image size - the system adjusts it to fit perfectly. It's best to use atmospheric images instead of those with text.

Button - Enter text for the CTA button and the URL that will redirect users when they click it. (Note: If you have text but no URL, the button will not appear on the banner.)

OpenLinkInNewTab - Select 'Yes' to open the link in a new tab, or 'No' to open it in the same window.

All fields are optional. If you don't add an image, the banner will automatically use the design system colors.

Banner with a short description:

Banner with a long description:

Group of users

This component highlights a group of individuals, such as speakers or presenters, on your site's landing page. It presents a row of thumbnail images (or initials if no image is provided). Clicking on See All opens the group page (configured in the grouppage module) itself. Clicking on a group member's thumbnail opens a window displaying their bio, along with details of their previous or upcoming sessions. To navigate to that person's profile page, simply click on either "See profile page" or "See all sessions".

This component requires the Grouppage module and Personalprofile module to be enabled.

headerText - Add the text that you want to appear as a title (for example "Meet our Speakers").

headerLinkText - Type the text you want to display on the right for users to click. Leave empty to use the default text “See All”.

group - Choose a group from the allowed groups in the Grouppage module to display its users on the page. Only the first 20 people will show on the page.

If no group is chosen, the component will be empty, and won't be displayed on the page.

uiType - Select how to display group members:

Carousel - (default) People are displayed in a carousel format with right and left arrows for navigation. Users can scroll left to reach the last user on the list (round-robin).
Side by Side - People are displayed horizontally next to each other without a carousel.

usersToShow - Select an option:

Group list - Displays the first 20 people from the chosen group on the page, ordered alphabetically by name (A-Z).
Promoted users only - Displays only the promoted people from the selected group on the page, following the manual ordering as set on the group page.

timeShift - The group members list will periodically shift by one person to the left. You can specify the duration of the shift in minutes. For example, if you have a group with 30 users and set a 1-minute shift interval, initially users 1 to 20 will be displayed. After 1 minute, users 2 to 21 will be displayed, and this pattern will continue until all users are displayed. Please note that the change will only take effect upon refreshing the page. If you want to disable this feature, simply leave the duration field empty.

This feature is only active when "Group list" is selected in the usersToShow field.

Below is an example of a Group of Users component. Clicking See All displays the group page, which is configured in the grouppage module:

Once you have finished configuring, click the Save button, which will save your new page, and will also save and clear the cache for the module and site.

To set up a homepage for your site, visit our article Setting up a homepage with Theming.

Theming module

About

The Theming module lets you customize the appearance of your Video Portal with a unique set of pages and features. Using the theme builder, you can create and preview multiple themes to find the perfect look for your site's aesthetic or branding. Some pages are exclusive to Theming, while others can toggle between Theming and the non-Theming system. Check out the list below for Theming-based pages and features available to you.

KMS and KAF module. Enabling the module will set a different look and feel for the site's header. For KMS instances with custom CSS or styling, please contact your Kaltura representative.

Related modules

Enabling the Theming module is a prerequisite for the following modules:

Working with themes

Enable and choose a theme

To get started, enable the module using the enable field.

There are two default themes available for use - Dark and Light. All the theming pages that are set to 'Yes' in the features section, will be affected by the theme selected.

To create your own custom theme, use the Themes section.

Create a theme

To create a custom theme

Navigate to the Themes section, and click the +Add Themes button.
Click Edit.
The Theme Builder displays.

You can create and manage your theme from the Theme Builder. For more information, about creating and customizing themes, read our article Theme Builder.

After you have customized a theme, you can set it as your site's default theme from the CurrentTheme dropdown.

Preview your theme

Click Preview to test your theme without changing the site's UI for all users.

After clicking Preview, you will be redirected to the site and be presented with a preview banner below the navbar, indicating that you are in preview mode. This is a local view preview only (based on a temp cookie in your browser), and won't affect any other users.

To exit the Preview mode, click Turn Preview Off in the preview banner.

Additional information

Custom CSS

To add Custom CSS for Theming-based features and pages, use the themingAdditional field under the cssupload module.

Certain pages, like the customPages feature set, cannot be disabled and will always be turned on.

Features section

Choose which of the Theming features and pages to enable. Once a feature is set to 'Yes', the Theming-based page layout and design will be applied to all users, and be affected by the selected theme in the CurrentTheme field. Keep a feature set to 'No' to be able to preview it before enabling using the Preview feature, as the ‘Preview’ feature will show all pages as if they are set to Yes.

Some Theming-based pages and features won't be shown in the list, as they are Theming-based only and cannot be used without the Theming module enabled (see module description for list of pages).

The Features section is an advance settings section, and should only be used by a Kaltura representative. Note, that when preview is enabled, it will display the site and all Theming pages with the previewed theme, regardless of the settings in the Features section.

header - The header feature is a must when using any of the Theming features and pages set. Keeping it set to 'No' will result in different headers in different pages on the site.

login - This is configured in the login module.

mediapage - Turn on the Theming-based media page for all types of media, including draft entry, video, audio, image, video quiz, live, kwebcase, interactive (path) video, meeting rooms, and playlist.

Only player v7 is supported on these pages. Please make sure to update all players to the v7 player version.

globalsearch - This turns on the Theming-based global search page.

playlistsgrid - This turns on the Theming-based playlist grid page design. When a user clicks 'See All', they will be redirected to that playlist in grid view, as shown below:

Only player v7 is supported on this page. Please make sure to update your playlist player ID to the v7 player version on the playlistPage module.

mymedia - This turns on the Theming-based My Media page design

playlist - This turns on the Theming-based playlist playback page design.

Only player v7 is supported on this page. Please make sure to update your playlist player ID to the v7 player version on the playlistPage module.

channels - These are configured in the channelthemingui module.

personalprofile - This is configured in the personalprofile module.

registration - This is configured in the Siteregistration module.

channelcollections - This is configured in the channelcollections module.

footer - This is configured in the footer module.

helppage - This is configured in the helppage module.

kcapture - This is configured in the kalturacapture module.

recorder - This is configured in the recorder module.

Thumbnails

Field	Description
enabled	Enable the Thumbnails module.
extensionWhitelist	Define allowed extensions, example: jpg, png, jpeg, gif (one item per extension)

Twitter

Field	Description
enabled	Enable the Twitter module.
tPlayerId	What is the player ID (uiConf ID) of the player that plays videos on Twitter? This should be a V2 play.
siteUserName	@username of website, to be used as value for twitter:site meta tag
useHighestQuality	Use the best quality flavor that can be played in Facebook.
siteDescription	Enter the text to send on the ‘twitter:description’ property for the shared link for non-player pages.
shareImageUrl	Enter a link to an image you would like to use when users share content for non media pages (such as home page). Leave empty to use the site logo.

Uploadmedia module

About

The Uploadmedia module enables users to upload, share, and edit media via the +Create menu in the navigation bar. With our Theming-based feature, users can bulk upload, edit, and set privacy statuses all at once, without waiting for uploads to complete.

A user with an application role of privateOnlyRole and higher (adminRole, unmoderatedAdminRole) can upload content to the video portal.

This module is supported in both KMS and KAF applications and requires the Theming module to be enabled.

Prerequisites

Enable the Theming module and set the header configuration to 'Yes' to upgrade the video portal header appearance to the new design.
Enable the AddNew module. Use this module to manage the +Create menu options.

Configure

Go to your Configuration Management console and click on the Uploadmedia module. You can also navigate to it directly using a link: https://{your_site_url}/admin/config/tab/uploadmedia.

The Uploadmedia page displays.

Set enabled to 'Yes' to enable the module.
Click Save.

User experience

After the module is enabled, users can and upload and share videos, audio files, and images.

For more information, visit our article Upload media - Theming.

Accessibility module

Addcontent module

About

Configure

User experience

Addtoplaylists module

About

Configure

Enable the module

allowCreation

ownerOnly

Save

Advancedkauth

Adminaccess module

About

Configure

Attachments module

About

Configure

User experience

Entry with 'showOnlyAttachmentType' set to 'Yes'.

Entry with 'showOnlyAttachmentType' set to 'No'.

Authbroker module

About

Prerequisite

Configure

Enable the module

Link to page

rolesMapping

defaultGroups

Quick start instructions for using Authbroker login

Pre-start

Step 1: Authbroker module

Step 2: Auth module

Captions

Channelplaylists module

About

Prerequisites

Configure

User experience

Chapters

About

Edit Media

User Interaction

Comments module

About

Configure

User experience

Contentpolicy module

About

Configure

User experience

Non-Theming users

Theming users

BB code tags

Cssupload

Customdata module

About

Configure

Customfavicon

Custompages module

About

Prerequisite

Configure

User experience

Disclaimer module

About

Configure

Example

BB code tags

Downloadmedia module

About

Configure

Example of downloadFlavors settings:

Editor module

About

Configure

uploadCustomLanguage

Emailnotifications