About the IntelligenceBank Assets Connector for Optimizely CMS 12

The IntelligenceBank Connector for Optimizely CMS 12 lets editors browse, search and insert approved IntelligenceBank assets, as public CDN links or local copies, without leaving the CMS. A single package delivers three ways to bring assets in: a dedicated Assets Block, a property asset-picker, and inline insertion from the rich-text editor.

What the Connector Does

• Assets Block - drop a dedicated block onto any page and insert one or more IntelligenceBank assets.
• Property asset-picker - add an IntelligenceBank picker to a content property, so an asset can be chosen inline in the edit form (for example a hero image).
• Rich-text insertion - insert an asset at the cursor from the CMS rich-text (TinyMCE) toolbar.
• CDN links or local copies - insert assets as public IntelligenceBank CDN URLs, or download and store a local copy in Optimizely.
• Multiple assets per block - the Assets Block accepts several assets at once.
• One package, all patterns - everything ships in a single NuGet package, and each pattern is turned on through configuration.

Requirements

• Optimizely CMS 12 on .NET 8 (self-hosted or Optimizely DXP). Not compatible with CMS SaaS Core, per the Compatibility note above.
• An active IntelligenceBank account with access to the assets you want to insert.
• Editors reach the IntelligenceBank web app over HTTPS, as the embedded app relies on secure session cookies.

Installing the Connector

Download the NuGet package IntelligenceBank.OptimizelyCMS12, add it to your Optimizely CMS 12 project, and rebuild the solution.

The connector is a Razor Class Library, so installation is just a package reference: no source files are copied into your project and no manual Startup.cs changes are needed. Once installed, add the IntelligenceBank configuration section below.

Configuration

Add an IntelligenceBank section to your site's appsettings.json. Only PlatformURL is typically required; every other setting has a sensible default.

"IntelligenceBank": {
  "PlatformURL": "mycompany",
  "InsertionMode": "publicLinks",
  "EnableCustomURL": false,
  "EnableBrowserLogin": false,
  "EnableRichTextPlugin": true,
  "IFrameEndpoint": "https://ucprod.intelligencebank.com/app/",
  "AllowedDownloadHosts": "intelligencebank.com"
}

The Assets Block

The Assets Block is the most common way to use the connector: editors add a block to a page and insert one or more IntelligenceBank assets into it.

Add the block

Add a new block and choose IntelligenceBank Assets from the available block types, then give it a name and create it.

Sign in and insert assets

Once the block is on your page, open it to edit. Sign in to your IntelligenceBank platform, then browse or search and select the assets you want. Save to insert them. Multiple assets can be added to a single block.

The Property Asset-Picker

For a single asset on a specific field, such as a hero image or thumbnail, a developer adds the [IntelligenceBankAsset] attribute to a string property on a page or block type. Editors then get an inline IntelligenceBank picker on that field in the edit form, and the chosen asset is stored on the property, using the same sign-in, browse and select experience as the block.

Rich-Text Insertion

With EnableRichTextPlugin set to true, an IntelligenceBank button appears on the rich-text (TinyMCE) toolbar. Editors click it, choose an asset, and it is inserted at the cursor as an image, video, audio player or link, depending on the asset type.

Data and Security

• Encrypted in transit - all communication with IntelligenceBank uses HTTPS / TLS.
• Your authentication - sign-in is delegated to your IntelligenceBank platform, including SSO via Browser Login. The connector does not store your IntelligenceBank credentials.
• Same platform controls - assets you insert respect the permissions and access controls configured on your IntelligenceBank platform. When storing local copies, downloads are restricted to allow-listed IntelligenceBank hosts.

Need Help?

For help configuring the connector or access to additional assets, contact IntelligenceBank. For connector-related issues that need our team, you can submit a ticket.