Drupal

The HIVO Connector is a plugin that helps you directly integrate your HIVO digital asset library into your Drupal content management system. Instead of having to download images, videos, or documents from HIVO to your computer and then re-upload them to Drupal, you can access and use them instantly from a single location.

👉 The latest version of the plugin now supports with Drupal version 9 || 10 || 11. To use this feature, you need to follow these simple steps:

How to Activate the Module

🔹 Step 1: Install the Module

Currently, Drupal provides two main versions for users to choose from:

• Dev (Development version): designed for developers.

• Drupal CMS Launcher: a standalone desktop application (Windows/macOS) that allows you to launch Drupal directly on your computer without the need for complex environment setup.

Due to the different nature of each version, the installation process will vary slightly. Please follow the detailed instructions below to proceed with the version you are using.

• If you are using the Developer version, you will need to install this module by running the command:

composer require 'drupal/hivo_connector:^1.0'

• If you use Drupal CMS Launcher: Navigate to Extend > Browse Modules tab.

  • In the Search bar, enter the keyword HIVO and turn OFF the toggle "Only show projects covered by a security policy".

  • You will see HIVO Connector, click the "Install" button to start the installation process.

🔹 Step 2: Activate the Module

After installation, you need to activate the module. Find and check the box for "HIVO Connector" in the list of modules to activate it.

• With Developer version: Navigate to Manage > Extend

• With Drupal CMS Launcher: Navigate to Extend > List tab (Install button in the top right corner)

How to use HIVO Connector

HIVO supports two methods to bring assets from the HIVO system into Drupal for use in content or web pages:

• Import assets from HIVO into the Drupal Media Library

• Use CDN link (Embed URL)

1. Import assets from HIVO into the Drupal Media

🔹 Step 1: Log In HIVO

When the module is activated, you will see a new "Hivo Connector" tab. Click this tab and use the email and password for your HIVO account to log in.

• With Developer version:

• With Drupal CMS Launcher

🔹 Step 2: Import assets from HIVO into the Drupal Media

After successfully logging in, you can access your entire HIVO library.

• Use the search bar to find the assets you need.

• Select the asset and version you want to import.

• Once imported, the asset will appear in the Drupal Media and can be inserted into your content like any other media item.

2. Use CDN link (Embed URL)

This is a faster and more flexible method that allows you to embed assets directly from HIVO without uploading them to Drupal’s Media Library.

⚠️ Important Note:

The account must be configured with a CDN URL first, or else the "URL" column will not be available. Please contact HIVO Support to configure a CDN URL.

2.1. How to set up to use CDN link

🔹 Step 1: Enable configuration

• Go to: Configuration → Content Authoring → Text formats & editors

• Select the text format to configure: Click Configure for the text format you want to enable (e.g., Full HTML).

🔹 Step 2: Add the HIVO button to the toolbar

Under Toolbar Configuration:

• Drag and drop the HIVO icon from Available buttons into the Active toolbar area.

• Purpose: this allows users to access the HIVO library directly within Drupal’s text editor.

🔹 Step 3: Enable “Enabled filters”

• Scroll down to the Enabled filters section and ensure that the “Embed media” option is turned on. If not enabled, the CDN link will not display correctly in your content.

• Other options can be flexibly enabled or disabled according to your requirements.

🔹 Step 4: Save configuration

• Click Save Configuration.

• Then click Save Text formats and editors to finalize the setup.

2.2 How to use HIVO Connector in the content editor

After completing the setup:

• In Drupal’s text editor, you will now see the HIVO icon in the Action bar.

• Click the HIVO icon:

  • If you’re not logged in, a login window will appear → Log in with your HIVO account.

  • Once logged in, the HIVO library will open.

• Select the asset and version you want to embed, then click Embed URL to insert it into your content.

If you have any questions, don't hesitate to ask, we're always here to help!