Drupal Integration in Content Workflow

  • Updated

Drupal is content management software. It's used to make websites and applications. 

The Drupal integration allows you to migrate mapped content from Content Workflow to Drupal quickly and vice versa with updated content from Drupal into Content Workflow. You can create a template mapping to push and pull content between Content Workflow and Drupal.

Note: The integration supports Drupal 9 and 10. However, we suggest using Drupal 10. 

How to enable this feature in your portal?

Contact your Customer Success Manager to enable this feature in your portal and learn about any associated costs.

How to Install Content Workflow Module 

  1. Navigate to Drupal.
  2. Download the package here.
  3. Once downloaded, you can install the package on your Drupal site. 
  4. Install the Content Workflow module
    1. For a free trial of Content Workflow, you can sign up here
    2.  If you are working with Drupal Version 8.x-4.x, enable the Content Workflow UI, Content Workflow Upload, and Content Workflow Upload UI modules, which can be found in the package. 
  5.  Once installed, you will find Content Workflow as a new menu item. 
    • Admin > Configuration menu > Web Services: Content Workflow (Bynder) 

How to Configure Content Workflow Module 

  1. Navigate to Drupal > Authentication
  2. Enter your Content Workflow email address and Content Workflow-generated API Key.
  3. Select the Content Workflow account from the dropdown, and you will want to import and update content.
  4.  Select Save.Drupal 10 - Auth 2 Close.jpg
  5. You can test the connection with your Content Workflow account under the Test Connection tab.
    Test connection Bynder Drupal 10 2024-03-22 at 11.11.35 am.jpg
  6. Navigate to the Import Configuration section. Here, you can select the global options for future imports and updates, such as the default update method or default node status after an import/update.
    • Administration > Configuration > Web services > Content Workflow > Default Import configuration
      Import configuration Bynder Drupal 10 2024-03-22 at 11.13.27 am.jpg
  7. Select the Node default status.
    This will dictate whether or not the content imported from Content Workflow is published or unpublished when created in Drupal.

    • Unpublished
    • Published
  8.  Select whether or not you want a new revision to be created whenever new content is imported by selecting the "Create new revision" option.

  9. Select Save Configuration.

Configure Template Mapping

To import content from Content Workflow, you need to set up mappings between your templates in Content Workflow and content types in Drupal.

  1. Navigate to Drupal.
  2. Select Content Workflow mappings.
    • Admin > Configuration > Content Workflow > Manage Mappings > Add new Content Workflow template.
  3. Templates within Content Workflow can only be mapped to a Drupal content type once, so you can only select a template that isn't already part of a Content Workflow mapping.
  4. Select the template you want to map.
  5. Click Select.
  6. You will be directed to the Manage Mapping section. 
  7. Select Create next to the mapping you just created to map the fields.
    badbca5c-bd59-496d-a764-7a5958361d10.jpg
    • If you select Delete, you will remove the mapping from the Manage Mappings section. This will mean the template attached to the mapping can be remapped to another content type.
  8. Select the Drupal content type to which you would like to map the Content Workflow template. This will populate the fields for mapping. 
    Edit Bynder Drupal 10 2024-03-22 at 11.43.46 am.jpg

  9. You can map the fields from the Content Workflow template using the selected Drupal Content Type. Only corresponding field types can be mapped between Content Workflow and Drupal. See here for the supported field types for mapping.
    • If you don’t map a Content Workflow field, this field will be ignored during the import and future updates.
    • A Content Workflow field can only be mapped to the Drupal field once. 
  10. Select Create mapping once the mapping is complete.
  11. Once you've set up your template mappings, you can import content to Drupal.
    Screenshot 2024-03-22 at 12.48.16.png 

Supported Field Types for Mapping

See below for the supported fields for mapping.

Content Workflow field type maps to Drupal field type Comments
Text Field (Plain & Rich)

Title

Plain Text
Formatted Text

Email

Telephone

Date

Entity Reference Revision

The Content Workflow field must be plain text for mapping to the title field.
Attachment

File

Image

Entity Reference

 
Choice field (Radio & Checkbox)

List

Entity Reference

 

Importing Content

  1. Navigate to Drupal.
  2. Select Import content from Content Workflow (Bynder). 
    • Admin > Content > Import Content from Content Workflow (Bynder)
  3. From the dropdown menu, dropdown the Content Workflow project you want to begin importing content from
    Import content from Content Workflow Bynder Drupal 10 2024-03-22 at 1.12.42 pm.jpg
    •  The dropdown option will only show projects with mapped templates. If you select a Project, all the content (Items) with mapped templates will be populated.
  4. Select the items to import.
    • You can filter by Content Workflow status, item name, or template name.
  5. After you've imported the content, you can choose the status in Drupal for each item, i.e., whether the content should be published or unpublished.
    • (Optional) In each item's dropdown menu dropdown, select a specific parent to create a menu item; the default value is set to the default parent item from the Drupal content type configuration. Import content from Content Workflow Bynder Drupal 10 2024-03-22 at 1.14.46 pm.jpg
  6. Once you've selected the content you want to import, select Continue.
  7. (Optional) You can select the Content update method outlined during the module configuration process if you haven't already. 
  8. (Optional) Select if you would like to change the status of the Content Workflow item once the import is successful.  
  9. Select Import.Import content from Content Workflow Bynder Drupal 10 2024-03-22 at 1.16.15 pm.jpg
  10. Once the import is complete, you will be redirected to the import results page. From here, you can see what has been imported successfully, what has failed to be imported, and why. You can also click the links to open the imported content directly. Import content result Bynder Drupal 10 2024-03-22 at 1.16.46 pm.jpg

Update Content in Drupal with Changes Made in Content Workflow

Note: New data from Content Workflow will always override your existing Drupal content.

Suppose the content has been changed to imported Items directly in Content Workflow. In that case, you can quickly update the content in Drupal by simply re-importing it and following the steps in Importing content.

Update Content in Content Workflow with Changes Made in Drupal 

You may import content from Content Workflow to Drupal and export it back to Content Workflow. This is useful if you've changed the Drupal content and want it to be reflected again in the original Content Workflow items. 

  1. Navigate to Drupal
  2. Select Upload changes to Content Workflow 
    • Administration > Content > Upload changes to Content Workflow 
  3. From the dropdown menu, dropdown the Content Workflow project you want to begin importing content from
    Upload changes to Content Workflow Bynder Drupal 10 2024-03-22 at 1.24.48 pm.jpg
  4. Select the items to import.
    • You can filter by Content Workflow status, item name, or template name.
  5. Select Upload
    Upload changes to Content Workflow Bynder Drupal 10 2024-03-22 at 1.26.21 pm.jpg
  6. Once the upload is complete, you will be redirected to the upload results page.Upload changes to Content Workflow Bynder Drupal 10 2024-03-22 at 2.11.56 pm.jpg

FAQ

Does this integration support multiple languages?

Importing content from Content Workflow into Drupal in multiple languages is possible. Content Workflow supports multiple languages using the multiple content tabs on your Items and Templates. 

Was this article helpful?

0 out of 0 found this helpful

We're sorry to hear that!

Find out more in our community

Have more questions? Find out more in our community