JW Player App Installation Guide

JW Player is a media player for streaming audio and video on websites and mobile devices. It provides an easy-to-use interface to upload, manage, store, deliver, and publish your media files.

Its simple drag-and-drop feature lets you quickly organize and publish your videos and audio on the web or mobile devices. It supports various file formats, including MP4, WebM, Ogg, and HLS, and the playback of DRM-protected content.

The app also enables users to watch live streams, playlists, and videos in full-screen mode and access advanced playback options such as captions, speed control, and picture-in-picture.

Contentstack Marketplace lets you install and use the JW Player application within your stack to fetch and display videos from the JW Player account within your entries.

• JW Player account
• Contentstack account
• Access to the Contentstack Organization/Stack as the Owner/Admin

Let's follow this step-by-step guide to install and configure the JW Player app within your stack.

1. Retrieve the Credentials from the JW Player Account
2. Install and Configure the JW Player app in Contentstack Marketplace
3. Use the JW Player app within your Stack Entry

1. Retrieve the Credentials from the JW Player Account

   link

   To get the access token for JW Player, follow the steps given below:

   1. Log in to the JW Player account using your JW Player account credentials.
   2. Click the gear icon in the top-right corner of the JW Player dashboard, and then click API Credentials.
      
      Click to enlarge
   3. Now, click Show Credentials to view and copy the API Key.
      
      Click to enlarge
   4. To generate the Secret, click Add.
      
      Click to enlarge
   5. In the API Key modal, provide Name, select User Role from the dropdown, set the Properties checkboxes, and click Save.
      
      Click to enlarge
   6. Go to the recently created API Key and click Show Secret to view and copy the client secret.
      
      Click to enlarge

2. Install and Configure the JW Player app in Contentstack Marketplace

   link

   Follow the steps given below to install the application in Contentstack.

   1. Log in to your Contentstack account.
   2. In the left-hand side primary navigation, click the Marketplace icon to go to the Marketplace.
      
      Click to enlarge
   3. Click Apps from the left panel.
   4. Within the Marketplace, you can see all the available apps. Hover over the JW Player app and click Install App.
      
      Click to enlarge
   5. In the pop-up window, select the stack where you want to install the JW Player app, accept the terms of service, and click the Install button.
      
      Click to enlarge
   6. On the Configuration screen, enter the following details:
      1. JW Player Credentials: Enter the API Key and Client Secret retrieved from your JW Player account in step 1.
      2. Choose the JW Player Keys to Save in Entry: Choose how to save the data fetched from the JW Player account in Contentstack entries.
         1. If you select the All Fields option, you can select only a limited number of videos in the entry.
         2. For Custom Fields, you can search and add specific JW Player Keys you want to save in entries.
         Click to enlarge
         
         If you select Custom Fields then the JW Player Keys dropdown appears. By default, mediaid, title, image, pubdate, description, and link options are already selected inside the dropdown. If you want to create a new key, click the + New Key Field option.
         
         Click to enlarge
         
         In the Add Key Path modal, enter the JW Player Key Path and click the Create or Create and Apply button to create a new key.
         
         Click to enlarge
   7. On the UI Locations tab, you can see the predefined app locations. You can use the toggle button corresponding to each UI location to enable or disable it based on your requirements.
      Click to enlarge
   8. If the webhook is enabled for your app, you can view the webhook logs under the Webhook tab.

   Additional ResourceFor more information on UI location and webhooks, please refer to the Installed Apps guide.

   9. Click the Save button.
   10. Click Open Stack to start using the JW Player application.

3. Use the JW Player app within your Stack Entry

   link

   To use the JW Player application within an entry of your stack, follow the steps given below:

   1. Go to your stack, click the Content Models icon in the left navigation panel, and click the + New Content Type button.
   2. Create a content type by adding relevant details as displayed below:
      
      Click to enlarge

   There are two ways to use the JW Player application in your entry:

   1. Custom Field
   2. JSON Rich Text Editor Field

   Steps to use the JW Player application using a Custom field:

   link
   1. In the Content Type Builder page, add a Custom field in your content type by clicking the Insert a field link represented by a + sign.
   2. Under Select Extension/App, select JW Player, and click the Proceed button.
      
      Click to enlarge
      Change the Display Name of the custom field to your choice, for example, JW Player Custom Field. Optionally, you can add Help Text and Instruction Value for your custom field. This adds the JW Player app in the custom field.
      
      Click to enlarge
   3. After adding the app in a custom field, click Save or Save and Close to save your changes.
   4. To use the JW Player app, create an entry for this newly created content type. To do this, in the left navigation panel, navigate to the Entries page, click + New Entry to create a new entry for the above content type, and then click Proceed.
      You can see the JW Player app’s custom field on your entry page as shown below:
      
      Click to enlarge
   5. Click the + Choose Video(s) button.
      
      Click to enlarge
   6. Select the video(s) from your JW Player selector page and click the Add Videos(s) button to add them to your entry.
      
      Click to enlarge

      NoteYou can add multiple videos in one go.

      You can search for videos on the JW Player selector page.
      
      Click to enlarge
      Also, you can view the videos in a Comfortable or Compact view. By default, the Comfortable view is selected.
      Hover over the video on the JW Player selector page, and you can see the Open in JW Player option to go directly to the JW Player platform.
      
      Click to enlarge
      The selected video(s) are referenced in the thumbnail view within your entry.
      
      Click to enlarge
      Select the list view option from the dropdown to view the video(s) in the list view.
      
      Click to enlarge
      The selected video(s) are referenced in the list view within your entry .
      
      Click to enlarge
   7. Hover over the video to access these features:
      1. Click the Reorder icon to drag and reorder the video.
      2. Click the Open in JW Player icon to open the video on the JW Player platform.
      3. Click the Remove icon to remove the video.

      Thumbnail View

      Click to enlarge

      List View

      Click to enlarge
   8. After adding the video(s), Save and Publish your entry.

   Steps to use the JW Player application using a JSON Rich Text Editor field:

   link
   1. In the Content Type Builder page, add a JSON Rich Text Editor field in your content type by clicking the Insert a field link represented by a + sign.
   2. Under Select JSON RTE Plugin(s), select JW Player, and then click Add Plugin(s).
      
      Click to enlarge
      This adds JW Player in the JSON Rich Text Editor field.
      
      Click to enlarge
   3. After adding the app in a JSON Rich Text Editor field, click Save or Save and Close to save your changes.
   4. To use the JW Player app as a JSON RTE plugin, create an entry for this content type. In the left navigation panel, navigate to the Entries page, click + New Entry to create a new entry for the above content type, and then click Proceed.
      You will see the JW Player app icon inside the JSON RTE field in your entry page as shown below:
      
      Click to enlarge
   5. Click the JW Player app icon.
      
      Click to enlarge
   6. Select the video(s) from your JW Player selector page and click the Add Videos(s) button to add them to your entry.
      
      Click to enlarge

      NoteYou can add multiple videos in one go.

      You can search for videos on the JW Player selector page.
      
      Click to enlarge
      Also, you can view the videos in a Comfortable or Compact view. By default, the Comfortable view is selected.
      Hover over the video on the JW Player selector page, and you can see the Open in JW Player option to go directly to the JW Player platform.
      
      Click to enlarge
      The videos you selected get referenced within your entry:
      Click to enlarge
   7. To resize the video, drag the corner and adjust the size as required. Hover over the video to access these features:
      1. Click the Preview icon to preview the video on the JW Player platform.
      2. Click the Edit icon to edit the video.
      3. Click the Remove icon to remove the video.
   Click to enlarge

   Additional ResourceYou can use alignment and inline asset features to edit the video placement within the JSON Rich Text Editor field.
   

   8. After adding the video(s), Save and Publish your entry.