Able Player

Able Player Manual Update

This update includes an implementation of Able Player for audio and video chunks. A manual update is required to use Able Player. An automatic update tool is also available. Pages containing audio and video chunks will need to be published after the manual update is applied. You may need to clear your web browser's cache to see the updated player. See the IU Knowledge Base document Clear your web browser's cache, cookies, and history.

Framework sites created before March 7, 2024, will need to follow these steps or utilize the automatic update tool to apply this update.

Framework sites with localized audio and video chunk Velocity must implement additional manual updates. More information is available on the Able Player Velocity Manual Update documentation.

Note: We strongly recommend publishing all changes to your test/development site first to confirm all audio and video chunks are working as expected. Once confirmed, updates can then be published to your live/production site.

Able Player introduces new fields and requirements for videos. Please see the audio chunk documentation and video chunk documentation for more information.

Step 1

In the Manage Site area of your site, update the following Data Definitions:

Page – Standard
Page – Event
Page – News
Page – Profile

Original - Line 153

<text default="-" identifier="video-type" label="Video Type" type="dropdown">

Updated - Line 153

<text default="-" help-text="Please refer to the video chunk documentation at https://framework.iu.edu/creating-content/chunks/video/index.html. " identifier="video-type" label="Video Type" type="dropdown">

Move and Update

Locate and move the following XML from line 181 to between lines 161 and 162. This will make the moved XML the next sibling of the video-type dropdown.

<text default="-" identifier="audio-type" label="Audio Type" type="dropdown"><dropdown-item value="-"/><dropdown-item show-fields="section/chunk/details/mp3, section/chunk/details/transcript" value="HTML5"/></text>c</code></pre>
<br />
<p>Update the newly moved <code>audio-type</code> dropdown on line 162.</p>
<pre><code><![CDATA[<text default="-" identifier="audio-type" label="Audio Type" type="dropdown"><dropdown-item value="-"/><dropdown-item show-fields="section/chunk/details/mp3, section/chunk/details/transcript, section/chunk/details/heading-level, section/chunk/details/vtt" value="HTML5"/></text>

Original - Line 157

<dropdown-item show-fields="section/chunk/details/widescreen, section/chunk/details/url, section/chunk/details/title, section/chunk/details/caption, section/chunk/details/transcript" value="YouTube"/>

Updated - Line 157

<dropdown-item show-fields="section/chunk/details/heading-level, section/chunk/details/vtt, section/chunk/details/descriptions-file, section/chunk/details/url, section/chunk/details/video-id-described, section/chunk/details/caption, section/chunk/details/transcript" value="YouTube"/>

Original - Line 158

<dropdown-item show-fields="section/chunk/details/widescreen, section/chunk/details/url, section/chunk/details/title, section/chunk/details/caption, section/chunk/details/transcript" value="Vimeo"/>

Updated - Line 158

<dropdown-item show-fields="section/chunk/details/heading-level, section/chunk/details/vtt, section/chunk/details/descriptions-file, section/chunk/details/url, section/chunk/details/video-id-described, section/chunk/details/caption, section/chunk/details/transcript" value="Vimeo"/>

Original - Line 160

<dropdown-item show-fields="section/chunk/details/thumbnail, section/chunk/details/mp4, section/chunk/details/webm, section/chunk/details/vtt, section/chunk/details/caption, section/chunk/details/transcript" value="HTML5"/>

Updated - Line 160

<dropdown-item show-fields="section/chunk/details/heading-level, section/chunk/details/thumbnail, section/chunk/details/mp4, section/chunk/details/webm, section/chunk/details/mp4-described, section/chunk/details/webm-described, section/chunk/details/vtt, section/chunk/details/descriptions-file, section/chunk/details/caption, section/chunk/details/transcript" value="HTML5"/>

Add between lines 165 and 166

<text help-text="Able Player includes a hidden &amp;quot;Media Player&amp;quot; heading to assist screen reader users in finding the player. Manually adjust this heading level only if the default setting doesn't align with your website's hierarchy. Otherwise, leave it as is." identifier="heading-level" label="Heading Level" type="dropdown">
	<dropdown-item label="h2" value="2"/>
	<dropdown-item label="h3" value="3"/>
	<dropdown-item label="h4" value="4"/>
	<dropdown-item label="h5" value="5"/>
	<dropdown-item label="h6" value="6"/>
</text>

Original - Line 176

<asset identifier="vtt" label="VTT file (closed captions)" type="file"/>

Updated - Line 176

<asset identifier="mp4-described" label="MP4 - H.264 (described version)" type="file"/>
<asset identifier="webm-described" label="WebM (described version)" type="file"/>
<asset identifier="vtt" label="Closed Captions (VTT file)" type="file"/>
<asset identifier="descriptions-file" label="Audio description (VTT File)" type="file"/>

Original - Line 189

<text help-text="Use an appropriate title that is reflective of the video. Example: 'Fulfilling the Promise: Ailyn Perez'. The title is used as part of the embedded player. It is not visible on the page." identifier="title" label="Title" size="80"/>

Updated - Line 189

<text help-text="Use an appropriate title reflective of the video. Example: 'Bring on Tomorrow'. The title is used as part of the embedded player. It is not visible on the page. " identifier="title" label="Title" size="80"/>

Step 2

Submit to save changes. Repeat Step 1 on each of the listed Data Definitions.

Step 3

If needed, update any missing information on pages with audio or video chunks. Please see the updated Audio chunk and Video chunk documentation.

Step 4

Confirm the updates are working as expected by publishing all pages with audio and video chunks to your test/development site (Sitehost-test).

Step 5

Once confirmed, pages with audio and video chunks can be published to your live/production site.

Revert the Update

Did the update not work as expected? You can revert changes to the Data Definition by following the Hannon Hill Knowledge Base version control instructions. Contact Web Services Support for additional support.