The integration with Sitevision allows you to publish images and videos from Mediaflow directly within Sitevision's editing mode. This offers a seamless solution for web editors, ensuring that they always have access to GDPR-compliant files with the correct alt-texts and accessibility-adapted videos.
Settings in Mediaflow
The integration with Sitevision can be used as soon as it is installed. However, for the files to be available and optimally utilised, administrators must first prepare the settings for them in Mediaflow.
Installing the Integration for Sitevision
Get the integration directly from the Sitevision Marketplace:
-
Open the top menu navigation in Sitevision and click on Marketplace.
-
Search for the Mediaflow plugin and install it by clicking the Install button.
Important information for those of you using our old plugin (portlet)
Important: Do not uninstall the old plugin yet
If you are using our older plugin, referred to as the portlet, you will need to retain it for the time being—even if you choose to install our new plugin from the Sitevision Marketplace. This is because, at present, there is no method available to migrate module data from a portlet to the new plugin, which means it is not yet possible to rely solely on the modern version. Consequently, if you uninstall or delete the old plugin, any currently embedded images and videos from Mediaflow in your Sitevision site will disappear. Alternative approaches:
Reinsert images and videos manually
If the number of embedded images and videos is relatively low, you may remove the content inserted via our old plugin and reinsert it using the new one. Sitevision has developed a tool called Module Control, which provides a list of image and video modules that may require removal and reinsertion. This tool can serve as a checklist to work through when time allows. It also offers a summary of the total number of images and videos that editors will need to replace, making it easier to determine whether to proceed manually or await a potential solution from Sitevision.
Retain existing embedded content and replace it gradually
Begin using the new plugin (ensuring that appropriate permissions are set in Sitevision to prevent users from continuing to use the old one). Then, as you edit your content and encounter modules with legacy content, simply remove them and reinsert the same image (or a new one) using the new plugin. This gradual approach enables a smooth transition to using only the new plugin for all media.
Wait and see
Sitevision is currently working on a solution to allow data to be transferred to the new plugin. Provided you restrict permissions to prevent further embedding of media using the old plugin and use the new one for any newly added content, you may wait to see what developments emerge. There is no cost associated with keeping both the old and new plugins installed simultaneously.
Configuring the Integration
After installing the plugin, you will be directed to the plugin’s settings page, where you’ll need to enter user keys to establish a connection with Mediaflow. On this page, you can also configure basic settings for the plugin, such as selecting the video format for embedding videos and choosing whether to sync alt-texts from Mediaflow.
To access files from Mediaflow in the plugin, you must add user information in Sitevision under the plugin's Global Settings.
-
Click on the top menu navigation.
-
Select Add-ons.
-
Find Mediaflow in the list of add-ons and click on the name in the Name column.
-
In the list of current Versions, find the one with Active status and click on the name Mediaflow.
-
On the next page that loads, click on Global Settings.
Sitevision allows multiple Mediaflow accounts to be linked to one Sitevision site. Below is how to link one account to a Sitevision site. If you need to link multiple Mediaflow accounts, read further down the page.
Linking a Mediaflow Account to a Sitevision Site
To view and mount images and videos from Mediaflow in Sitevision, you need three user keys:
-
ClientID
-
ClientSecret
-
Refresh token
ClientID and ClientSecret are keys you should have received during your onboarding. If you are an administrator with the appropriate rights in Mediaflow, you can retrieve the Refresh token yourself under Settings > Integration. (This only needs to be done once as the information is saved in Sitevision.)
Fill in the three fields with the following information:
Click the "Show/hide values" button to see the keys you have entered.
Click OK to save the key information in Sitevision.
After this is set up, click the Modules icon. Under Image and Media, you will find the Mediaflow module, which you can click to open its shared folder structure.
To find material from Mediaflow in your integration, folders and download formats must be made available for Sitevision. You manage folders under the Access tab in Mediaflow. Enable download formats under Settings > Download presets.
For the integration to work, Sitevision servers must be able to make requests over HTTPS (also works via proxy) to our servers, and the web browsers of the web editors must be able to make requests via HTTPS to our servers.
Linking Multiple Mediaflow Accounts to Different Pages in Sitevision
Sometimes, more than one department works within the same Sitevision solution. This might create the need to add page-specific keys. This means you have two or more departments with their own Mediaflow accounts and their own keys for Sitevision. These need to be added to the respective page so you can access the right department's material from the correct page in Sitevision.
-
Right-click the “house” and select Properties.
-
Click Add metadata field.
-
Enter Refresh token prefix in the Name field. Optionally, you can fill in a description in the Description field, but do not write or check anything in the other fields.
-
Click on Advanced.
-
In the Identifier field, enter: mfRefreshTokenOverridePrefix.
mfRefreshTokenOverridePrefix must be correct
Ensure mfRefreshTokenOverridePrefix is correct by copying it, as our code is based on this identifier being available. If the text string is incorrect, it will not work.
-
Click the top menu navigation again.
-
Select Add-ons.
-
Find Mediaflow in the list of add-ons and click the name in the Name column.
-
In the list of current Versions, find the one with Active status and click on the name Mediaflow.
-
On the next page that loads, click on Global Settings.
-
Add the refresh tokens to be used on your Sitevision page with a row number followed by a colon at the beginning, one per row, as shown below. Avoid spaces.
-
Determine which pages (nodes) should be given access to different accounts in Mediaflow, the accounts you entered refresh tokens for in the Global Settings in the previous step.
-
Right-click the page you want to link a Mediaflow account to and select Properties.
-
Uncheck Inherit value, and in the Refresh token Prefix field, enter the number for the Mediaflow account that this specific page (node) should have access to, e.g., 1 or 2.
-
The new key and ID will now be inherited by subpages of the selected subpage.
Repeat steps 13 and 14 for each part of the site's pages (nodes) that need to be linked to different accounts in Mediaflow.
Automatic updates
The Mediaflow plugin installed via the Sitevision Marketplace is updated automatically when new versions are released. The update takes place overnight on the day following the release of a new version.
Removing/Uninstalling the Integration
It is, of course, possible to remove the Mediaflow plugin. However, all inserted images and videos will also be removed. This is due to how Sitevision is built. The result will be that the image disappears, and the following error message appears in its place:
Follow these steps to remove the plugin:
-
Click on the top menu navigation (the square with the nine smaller squares).
-
Select Add-ons.
-
Find Mediaflow in the list.
-
Click the gear icon on the far right.
-
Select Remove.
-
You will be asked if you really want to remove the plugin. If you confirm, the plugin will be removed from your Sitevision site.