Due to the transition from COVE/Merlin to Media Manager, Bento users must request a Media Manager API key in order to access new video content.
Sites that do not obtain new keys will continue to function as they do today, however, after the transition they will not be able to access new video content. Bento3 users who have already obtained Media Manager keys can continue to use them and won’t need new ones.
To obtain a Media Manager API key and secret, please submit a ticket here: http://digitalsupport.pbs.org/support/tickets/new
What is the Explorer Carousel custom component?
The Explorer Carousel custom component rotates through a maximum of seven (7) Media Manager objects, displaying one object at a time. Objects scroll automatically; however, arrows placed on the right and left side allow users to scroll through each object manually. The image and title text click through to the full video or object.
The Explorer Carousel is intended to be placed in the Page Content section of your page.
This section demonstrates how to add Media Manager objects, however, external objects can be added by manually typing the full URL path to the object and image. Find the prefix for your site by opening your Master page then clicking Show next to Advanced Settings. Find your prefix in the Overwrite URL textbox as shown here.
How to implement the Explorer Carousel
- In the Page Content section, click the Available Component dropdown menu and click Add Component (Figure 1.1).
- Click Add Component (Figure 1.2).
- Click the component dropdown menu and click Explorer Carousel (Figure 4).
- Three of the seven items you can appear. Click the blue Choose button next to Search the Media Manager Library to browse and select your first carousel item (Figure 3).
You need a Media Manager API key to access Media Manager objects. Request a Media Manager API key
- To search for a specific object or video, type search criteria into the textbox at the top and click Search (Figure 4.1).
- Click the Object Type dropdown menu to select a video or web object and click the Start and End date textboxes to search by specific dates (Figure 4.2).
- A list of possible matches surface. Next to the selection you want, click the radio button to the left of the search result title (Figure 4.3).
- When finished, click Add selected to add the item to your carousel (Figure 4.4).
- The fields are populated with information from the video or web object. All fields must be populated with text. If a field is not populated and you have nothing you want to add to it, put your cursor in the empty textbox and press the space key on your keyboard (This is a workaround while the custom component is being redesigned).
- Follow the same steps as in Figures 3 and 4 to add more items. If you wish to add more than three items, click Add another item (Max 7) located near the bottom of the custom component (Figure 5.1)
- When finished, click Save (Figure 5.2).
- All images manually imported (ie: not from Media Manager) must have a 16x9 ratio with a minimum width of 640 pixels. Carousel images will display incorrectly if any other ratio is used.
- All text fields can be edited, however, editing the Image and URL fields can result in an error if the path is not absolutely correct. Be very careful when modifying all fields but those in particular.
- Click Preview site in the upper right side of the screen to view this component in a browser (Figure 6).
- Your Explorer Carousel appears on the page (Figure 7). The user can click the left and right-facing arrows on the carousel image to scroll through each image or click the image or the title to view the content page.
How to change a carousel item
After you have added your Explorer Carousel items you may decide that you want to change one or all of them. No problem!
- Click the blue Choose button in the object you want to change (Figure 1). Select another item as you would when you first add your carousel items.
How to rearrange items
Once you've added your carousel items, they can be reordered at any time.
- If your items are not condensed, begin by click the upward-facing arrow to condense each section (Figure 1). This will make it easier to move items around.
- On the left side of each Media Manager object, click the grey patterned box and drag the object to the place you want it to appear in the list. When it is in place, release your mouse (Figure 2).
- When an item is placed in its new location, the label changes automatically to reflect its new position (i.e.: Item 1 becomes Item 3).
How to delete an item
- To delete an item from your carousel, click Remove item located at the bottom of the object you want to remove (Figure 1).
Once you delete an object it cannot be recovered. You must manually add it again.
- A popup box appears asking you to confirm the deletion. Click Confirm (Figure 2).
- The item is removed from the list and must be manually added back in if you want to include it again in your carousel.