How to install the Videoteca Player integration through Azion Marketplace

The Videoteca Player integration offers a fast and efficient solution for hosting Videofront’s Videoteca player using the iframe embedding method. With this integration, you can load videos by simply passing the video-id query string argument to specify the content to be displayed.

Requirements

To set up this integration, you need to provide a Username and an API Token from Videoteca. To obtain these credentials, you need to have an account on the Videoteca website.

Getting the integration

To install this integration provided by Azion Marketplace, you have to:

Access Azion Console > Marketplace.
On the Marketplace homepage, select the integration’s card.
Once the integration’s page opens, click the Install button, at the bottom-right corner of the page.

You’ll see a message indicating that your integration was successfully installed.

Setting up the integration

Instantiating the edge function

To create an instance of the integration’s function:

On the Products menu, navigate to BUILD > Edge Application.
Select the application from the list to which you want to add the integration or create a new edge application.
Select the Functions tab.
Click the Add Function button.
Give a name to your instance.
On the dropdown menu, select the Videoteca Player function.

This action will load the function, showing a form with the function’s source-code and, just above it, two tabs: Code and Args. By clicking on the Code tab, you’ll be able to navigate through the source-code, but won’t be able to change it.

In the Args tab, you’ll pass these parameters:

{
"videoteca_user": "<your_username>", // Replace with your Videoteca username
"videoteca_token": "<your_token>", // Replace with your Videoteca API token
"custom_html": "<your_html>" // Replace with your custom html
}

Where:

Variable	Required	Description
`videoteca_user`	Yes	The name of the account from which the function will retrieve the videos
`videoteca_token`	Yes	The token to access the Videoteca’s API
`custom_html`	No	Custom HTML for the page delivered by the function. It must include the tag `<!-- videoteca_iframe -->` in the HTML, as the function will replace it with the actual iframe of the video

Click the Save button to save your configuration.

Done. Now your Videoteca Player instance is saved.

On the Products menu, navigate to Build > Edge Application.
Select the application from the list to which you want to add the integration or create a new edge application.
Select the Functions Instances tab.
Click the + Function Instance button.
Give a name to your instance.
On the dropdown menu, select the Videoteca Player function.

This action will load the Arguments tab, where you can add the parameters to execute your application.

In the Arguments tab, pass these parameters:

{
"videoteca_user": "<your_username>", // Replace with your Videoteca username
"videoteca_token": "<your_token>", // Replace with your Videoteca API token
"custom_html": "<your_html>" // Replace with your custom html
}

Where:

Variable	Required	Description
`videoteca_user`	Yes	The name of the account from which the function will retrieve the videos
`videoteca_token`	Yes	The token to access the Videoteca’s API
`custom_html`	No	Custom HTML for the page delivered by the function. It must include the tag `<!-- videoteca_iframe -->` in the HTML, as the function will replace it with the actual iframe of the video

Click the Save button to save your configuration.

Done. Now your Videoteca Player instance is saved.

Setting up the Edge Application Rules Engine

To finish, you have to set up the Rules Engine to configure the behavior and the criteria to run the function.

Still on the Edge Application page:

Select the Rules Engine tab.
Click the + Rule Engine button.
Give a name to the rule.
In Criteria, define the conditions for running the function.
Below, select the Run Function behavior.
- Select the adequate function according to the name you gave it in the instantiate step.
Click the Save button.

Done. Now the integration will run according to the criteria you set.