If the Drupal integration is enabled on your Widen Collective site, use the instructions below to install and configure Drupal 8. See the "How do I install Drupal 7?" article for installation and configuration instructions for that version.


Install the Module

To use the Drupal module, first download and install it then configure it in Drupal to authorize use with your Widen Collective site.


To install, download the Widen DAM module ZIP file from your user profile in the Collective, then place the widendam module folder in modules directory in your Drupal site.


Next, enable the module:

  1. Click Extend.

  2. Search for the Widen Collective and check the checkbox when it displays on the List page.

  3. Click Install.



Set up User Permissions

After installing and enabling the module, you’ll need to set up user permissions in Drupal. To do that, go to Manage > People > Permissions and choose the Administer Widen Collective configuration permission. 


Users must have that permission enabled to use the integration.


Configure the Module

When you configure the module, you’re connecting your Collective site to your Drupal site. To configure:

  1. Click Configuration.

  2. Enter your site URL in the Widen Collective Domain box.

  3. Click Save configuration.



Authenticate Your User Account

To set up authorization between your Drupal site and the Collective, go to the Admin tab then click Authorize with Widen Collective. Log in to the Collective, then click Allow to authorize the module.


 


After authenticating, you’ll be taken back to the Admin tab, where you’ll see that the account was authorized.




Set up the CKEditor Plugin

In this step, you’ll configure where you want the Collective module to display in the CKEditor.

  1. Click Configuration.

  2. Click Text format and editors.

  3. Select the text format you want to add the Collective button to.

  4. Click Save configuration.


The button will display in the available buttons. Drag it to the Active toolbar or place it in a different toolbar group, if desired.




Text Format Configuration

For the installation, there are four built-in text formats: basic HTML, restricted HTML, full HTML, and plain text. The Collective module works best in full HTML format because there’s no HTML filtering enabled in it.


In the basic HTML format, some features of the module will not work properly by default. One example is video players in the PDF viewer, because those are rendered using an iframe tag.


If you want to enable the Collective button in the CKEditor and use its full features on a basic HTML or a custom text format that has the Limit allowed HTML tags and correct faulty HTML enabled, add the tag below to the Allowed HTML tags field.


Text format.jpg


Here’s how to enable an iframe tag in an HTML text format.


Basic HTML

  1. Log in to your Drupal site.

  2. Click Navigate to Manage > Configuration > Content authoring > Text formats and editors.

  3. Click Configure on Basic HTML.

  4. Scroll to the bottom of the page. On the vertical tab click Limit allowed HTML tags and correct faulty HTML.

  5. In the Allowed HTML tags field, add this iframe: <iframe width height frameborder allowfullscreen allowtransparency mozallowfullscreen scrolling src>


Restricted HTML

If the CKEditor is not enabled, follow the steps for basic HTML to enable the iframe tag.


Plain Text

Since HTML tags aren’t allowed in plain text, the Collective module will not work.


For custom text formats that have the limit allowed HTML tags and correct faulty HTML filter enabled, follow the steps for basic HTML to enable the iframe tag.


Using the Module

Text formats are applied to each field that you configure in the CKEditor. In the example below, we’ll be creating an article. The Collective button displays based on the text format you selected. In this case, we chose full HTML.


Click the Collective button, as shown in the image below, to open a dialog where you can search to add assets from your site to your Drupal site.



Search for Assets

Enter your search terms in the asset search. From search results, select the asset and size to include in your content. After choosing the asset, it will be added to the editor in the style you chose.