The SharePoint integration enables publishing of images from Mediaflow directly in SharePoint's editing modes. This is an excellent way for web editors to always have access to files that are GDPR-compliant and have the correct alt texts.
Settings in Mediaflow
The SharePoint integration can be used as soon as it's installed. However, for the files to be available and used optimally, administrators need to prepare their settings in Mediaflow first.
Install the Sharepoint integration
Start by downloading the installation file for the SharePoint Online (365) plugin. The installation file for the web part add-on is available under item 5.
1. Upload the SharePoint package to the App Catalog
To use Mediaflow's integration to SharePoint, you must start by uploading the SharePoint package. This must be uploaded to a so-called app catalogue set up by the SharePoint administrator. This only needs to be done once for each organization and is necessary to use all types of external apps in SharePoint.
2. Add the integration app to your site
When step 1 is completed, you'll have the ability to add the app to your sites. Go to site contents and choose add app. There, add the Mediaflow extension.
Can’t see the plugin or lack the option to add it for your organisation?
If you’ve completed the first step but can’t proceed, it could be due to two reasons:
1. You are using the modern interface in SharePoint, and the plugin from Mediaflow doesn’t appear because of that. Try switching to the classic interface and check if the plugin becomes visible.
2. You don’t have sufficient permissions to manage the plugin. You need to be a site owner. More information about permission issues can be found on Microsoft’s support pages.
When it's finished adding the app, three things will have appeared among the site contents:
Mediaflow – The library where you sync the images.
MediaflowKeyStorage – a list that requires an object to know which account the integration should fetch images from.
Mediaflowextension – The code that is packaged and run for the integration to work.
3. Configure KeyStorage
After you've completed step 2, you need to configure your account in MediaflowKeyStorage.
Go to the list and select "New".
Write the value "RefreshToken" in the title field (Case Sensitive).
Fill in an integration key in the KeyValue field.
Click Save. An administrator in Mediaflow can find the key under Settings>Integrations inside Mediaflow.
4. Add Keywords column
For Mediaflow to transfer all data correctly, you need to add an extra "Keywords" column. Keywords added in Mediaflow will be placed here when selected images are transferred to SharePoint.
Click on "Add column" when you're in the Mediaflow folder.
In the menu, choose "Single line of text"
Enter "Keywords" under name
Click the "Save" button at the bottom.
5. Add an extension package for a better user experience in SharePoint
To make content work in SharePoint a bit smoother, there is a WebPart (an add-on) that you can choose to add to SharePoint pages to more easily transfer images from Mediaflow to SharePoint.
The WebPart allows you to open Mediaflow’s file picker directly on the page, select an image, and choose to download it. The image is not inserted directly onto the page, but is only downloaded to the file structure in SharePoint.
The advantage of this add-in is that editors do not need to leave the page they are editing, navigate to the folder tree, download the image there, navigate back to the content page, and insert the image from the media library. Instead, the entire selection process can take place from one and the same content page.
1. Choose to add a WebPart to a section in your SharePoint installation.
2. Search for, or type in the search box to find, the Mediaflow WebPart.
3. After you have added it, a button with the text “Get image from Mediaflow” will be displayed.
4. Click it to open the file picker, where you can select the file to be transferred to SharePoint.
5. The selected file that has been downloaded can then be inserted using SharePoint’s built-in media dialog.
We recommend adding this web part to the templates that editors use in SharePoint, so that the web part is always available.
The WebPart add-on is included in the following installation file.