Adobe Magento Commerce Extension User Guide

This document provides step-by-step instructions for using the Brightcove extension for Adobe Magento Commerce.

  1. Login to Magento Commerce:
    Magento Login
    Magento Login
  2. Note the Brightcove Module link in the left-side navigation:
    Magento Navigation
    Magento Navigation
  3. Click the Brightcove icon to reveal the Brightcove Module menu:
    Brightcove Module Menu
    Brightcove Module Menu

Uploading Videos

  1. From the Brightcove Module Menu, open the Add Videos page.
    Add Videos Page
    Add Videos Page
  2. Select the Store View to add the video to.
  3. Add the Video Title (required).
  4. Browse to find the local video file (required).
  5. Browse to find the local thumbnail image file (required).
  6. Browse to find the local poster image file (optional).
  7. Enter comma-separated tags for the video (optional).
  8. Enter a description for the video (optional).
  9. Click Save.

Note: the Store View will be stored in the video metadata as a tag. This tag will be used for implementing Localization in the Assign page.

Assign Videos to Categories and Products

Videos can be assigned to Categories and Products. In this section we will look at how to assign videos to Categories, and then how to assign them to Products in the following section.

Assigning to Categories

  1. From the Brightcove Module Menu, open the Assign Videos to Categories page.
    Assign Videos to Categories Page
    Assign Videos to Categories Page
  2. The initial page presents a list of categories, showing videos that are currently assigned to them, and there are links to Unassign or Change existing video assignments, as well as Assign videos to a category.

    Also note:

    • The Scope selector, allowing you to implement the localization filter
    • When you hover over a video ID, a thumbnail image of the video will appear
  3. Click Assign beside a category to assign to open a grid of videos to be assigned:
    Video Grid for Category Assignment
    Video Grid for Category Assignment
  4. If you don't see the video you are looking for, you can search by video title to find it.
  5. Use the localization dropdown menu to get the language you want.
  6. In the Video column:
    • Choose the player for the selected video
    • Use the selector to choose the video slot
    .
  7. If the video is already assigned to this category, it will display an orange border and an Unassign option.

Assigning to Products

  1. From the Brightcove Module Menu, open the Assign Videos to Products page.
    Assign Videos to Products Page
    Assign Videos to Products Page
  2. As with Categories, you can Assign videos, or Unassign or Change already assigned videos. You can also hover over a video ID to display the thumbnail.
  3. Click of the Assign links to assign a video. This will bring up the video grid:
    Video Grid for Product Assignment
    Video Grid for Product Assignment
  4. If you don't see the video you are looking for, you can search by video title to find it.
  5. Use the localization dropdown menu to get the language you want.
  6. In the Video column:
    • Choose the player for the selected video
    • Use the selector to choose the video slot
    .
  7. If the video is already assigned to this product, it will display an orange border and an Unassign option.

Generate Embed Code

  1. From the Brightcove Module Menu, go to the Generate Embed Code page:
    Generate Embed Code Page
    Generate Embed Code Page
  2. Select the player you want to use and a video, and then click Get Code to see and copy either the Basic (iframe) or Advanced (in-page) code for the player.
  3. We recommend that you use the Basic embed code unless you are customizing the player in some way that requires and in-page script.

Brightcove Configuration

You can update or add to the Brightcove configuration.

  1. Go to Stored -> Brightcove Video Configuration:
    Brightcove Configuration Page
    Brightcove Configuration Page
  2. The client id, client secret, API Base URL (for getting access tokens), and the Store ID should already have been filled in during installation, but you can update these values if needed.
  3. You can also set the number of video slots for Categories, Masters, and Variants.
  4. Finally, if you want to use the Bulk Data Import option (descibed in the following section), enter a comma-separated list of email addresses to receive notifications related to bulk imports.

Bulk import data

There are several kinds of data you can bulk import, including a list of videos to upload to Brightcove, video Category assignments, and video Product assignments.

  1. Go to System -> Import open the Bulk Import page:
    Bulk Import Page
    Bulk Import Page
  2. Select the kind of import you want to do.
  3. Here is a sample of the Bulk Upload Videos to Brightcove page:
    Bulk Upload Video Page
    Bulk Upload Video Page
  4. If you don't have a sample CSV file for the import, you can download one using the sample download link.
  5. Select the Import Behavior:
    • Add/Update - Add and replace existing records
    • Replace - Replace the existing records
    • Delete - Delete the existing records
  6. Using the Browse button, select your CSV file.
  7. Click Check Data to ensure the data is valid. (If the CSV file does not contain any valid records, the import option won't be shown).
  8. Click the Import button to import the data. You should see a success message.