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 working with content in SharePoint a bit smoother, there is an extension package (a web part add-on) that adds a web part at the top of SharePoint pages, making it easier to transfer images from Mediaflow to SharePoint.
.
The add-on 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-on is that editors don’t have to leave the page they’re editing, navigate to the file 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 a single content page.
The selected and downloaded image can then be inserted via SharePoint’s media dialog.
The web part add-on is included in the following installation file.