About the IntelligenceBank Connector for Optimizely CMS 12

The IntelligenceBank Connector for Optimizely CMS 12 makes it easy for users to browse, search and insert their approved IntelligenceBank assets as Public CDN links or local copies, either as a dedicated custom assets block, or directly from within Optimizely CMS 12's Editorial content block (legacy version).

IntelligenceBank Assets Block (Recommended)

Installation

To install the IntelligenceBank Custom Assets Block Connector, download the NuGet package here, and install it into your Optimizely CMS 12 project. Make sure you re-build the solution after the update.

Once installed, follow the configuration instructions in the README.md file.

As part of the configuration, you have the ability to set:

• Whether assets are inserted as local copies or CDN public links
• The default platform URL
• Whether browser login should be enabled by default

Add New Block

To get started, select the newly available IntelligenceBank Assets block and configure it.

Inserting IntelligenceBank Media Assets

Once the block has been added to your page, click edit to load it. You will then be able to login to your IntelligenceBank platform, browse, search and insert media assets. Note that multiple assets can be inserted against the same block.

Editorial Rich Text Block Integration (Legacy)

Installation

To install the IntelligenceBank Editorial Block Connector, download the NuGet package here, and install it into your Optimizely CMS 12 project. Make sure you re-build the solution after the update.

Upon installation, verify that 'wwwroot' contains the folder 'MyTinyMCEPlugin'.

Under 'Configuration', verify that a file 'CustomTinyMceConfigurator.cs' is present.

Here is an extract of the code present in that configuration file.

If the folder and/or file are not present, create it/them with the following code snippet:

using EPiServer.Cms.TinyMce.Core;
using Microsoft.Extensions.Options;

namespace AlloyCMS.Configuration
{
    public class CustomTinyMceConfigurator : IConfigureOptions<TinyMceConfiguration>
    {
        public void Configure(TinyMceConfiguration options)
        {
            options.Default()
                 .AddEpiserverSupport()
                 .AddExternalPlugin("backgroundplate", "/js/markbuttons.js")
                 .AppendToolbar("backgroundplate");
        }
    }
}

Next, add the following code to the Configuration function of the file "Startup.cs", which will allow for the plugin to load:

app.UseStaticFiles(new StaticFileOptions
{
    FileProvider = new PhysicalFileProvider(
      Path.Combine(_webHostingEnvironment.WebRootPath, @"MyTinyMCEPlugin\ClientResources")),
    RequestPath = new PathString("/js")
});

Also add services.ConfigureOptions<CustomTinyMceConfigurator>(); to the ConfigureServices(IServiceCollection services) section.

You can configure the IntelligenceBank Connector default login options in a file called 'markbuttons.js', located under wwwroot\MyTinyMCEPlugin\ClientResources.

Admin Settings

In complement to, or as an alternative to, modifying the markbuttons.js file as per the steps above, the NuGet package installation will automatically create a page called 'Admin Settings', which surfaces the same configuration options in the front end.

On this page, you will also be able to set the Web App URL, and the default login options for the Platform URL, Custom URL, and Browser Login fields.

The page can be removed if not needed.

Editorial Block & The IntelligenceBank Connector

The IntelligenceBank Connector will surface as a new source option of the standard Optimizely CMS 12 Editorial Block. To access the connector, you will therefore need to add an Editorial Block to your page layout. If you already have Editorial Blocks set up, the IntelligenceBank option will now automatically appear there as a new option.

Upon clicking on IntelligenceBank within the Editorial Block, the connector will load as a new window. Login fields will be pre-populated as per the configuration options covered in the previous section of this article. Enter your IntelligenceBank login credentials, or enable Browser Login to authenticate via Single Sign-On.

Once authenticated, you will be able to browse folders, search and find assets, exactly as if you were directly logged in to your IntelligenceBank platform.

To insert an asset into the Editorial Block, simply click on the card / thumbnail. If the asset is an image, you can also select any of the available Transformation Presets.