Episerver CMS integration
When installing the Episerver CMS plug-in/add-on on your Episerver site, you get a set of properties and access to the ImageVault API directly from Episerver.
Prerequisites
The ImageVault Connect for Episerver (ImageVault.EPiServer.UI) requires a fully functional installation of Episerver and supports the following combinations of ImageVault and Episerver CMS versions.
| Episerver \ ImageVault | IV 5.3 [1] - latest | IV 4.8 - 5.2 | IV 4.7 |
|---|---|---|---|
| CMS 12.17 | 12.18.45 - latest [1] | N/A | N/A |
| CMS 12.3.1 | 12.13.162 - 12.17.35 [1] | N/A | N/A |
| CMS 11.5.3 | 11.6.92 - 11.14.7 [1] | N/A | N/A |
| CMS 11 | 11.6.40 - 11.6.68 | N/A | N/A |
| CMS 10 | 5.3.101 - 9.6.169 | 5.1.21 - 5.2.50 | N/A |
| CMS 9 | 5.3.101 - 9.6.169 | 4.8.234 - 5.2.50 | N/A |
| CMS 8 | N/A | N/A | 4.7.2 - 4.7.12 |
Note
The table above gives a hint on what version combinations that should be compatible. This is no guarantee that all combinations will work. Out recommendation is that you always use the latest version of ImageVault, ImageVault.EPiServer.UI and Episerver (Optimizely) CMS.
Note 1
BREAKING CHANGES
If a connected ImageVault is using Episerver authentication and using the ImageVault.EPiServer.UI v11.12 or later, then the minimum compatible ImageVault is version 5.18.
If using older versions of ImageVault, be sure to not upgrade ImageVault.Client/Common to newer versions than 5.17.14
Installation
Installation of the ImageVault Connect for Episerver is done by installing the ImageVault.EPiServer.UI nuget package from nuget.org into your Episerver solution.
See Quick installation guide for more information.
Note
For version 11 or earlier, see Quick installation guide (v11).
Properties
The following properties are supplied
TinyMCE plugin
The connector comes with a TinyMCE plugin.
MVC Display templates
You can customize the mvc templates if needed.
Installation Notes
Pop-up window should be allowed.
The browser needs to be configured to allow pop-up windows for the site.
Generate machinekey for the Episerver site
In order to achieve Single-Sign-On between the Episerver site and the ImageVault UI, these
instances needs to share the same machinekey.
Please, verify the machinekey against this instruction.