openwoo

Dutch governmental organizations have to apply the WOO. This module provides a pluggable framework to publish documents, and search documents available in different content providers.

The first provided plugin is OpenWoo.app. We also plan to add a WooGLe integration.

There are two submodules:

• OpenWoo Search
• OpenWoo Publish

Features

This module is under active development, so the features will be split up in "Available" and "Planned" features.

Available

• Base module with organization settings. These can be prefilled from https://oinregister.logius.nl/
• OpenWoo Search module with a pluggable search provider. OpenWoo.app is currently the only available provider.
  
  This module provides a search block. Available filters are year, category and a free textfield.
• OpenWoo Publish module with a custom entity type. Ik is shown as a tab on the "Content"-page, and has basic CRUD functions with a published/not published-feature. Files are added as a custom media type with the needed metadata.
  When an entity is created, the publish plugin will publish it to OpenWoo.app.

Planned

• Integration with File Resumable Upload for better support of large file uploads
• Create plugins to store attachments on external file systems.
• Create a WooGLe plugin to search and publish to WooGLe.

Post-Installation

• Set up user permissions (/admin/people/permissions#module-openwoo)
• Setup the organization (/admin/config/services/openwoo).

For the OpenWoo Search module

• Enable the module.
• Select the client you want to use (/admin/config/services/openwoo/openwoo-search)
• If you use OpenWoo.app, you can add the api-key to settings.php
  $config['openwoo_search.openwoo_app']['api_key'] = 'API_KEY';. This is optional for search, but it speeds up the search.
• Place OpenWoo search block (/admin/structure/block)

For the OpenWoo Publish module

• Enable the module.
• Select the client you want to use (/admin/config/services/openwoo/openwoo-publish)
• Select the correct endpoint. Consult the OpenWoo.app-team if in doubt.
• If you use OpenWoo.app, you can add the api-key to settings.php
  $config['openwoo_publish.openwoo_app']['api_key'] = 'API_KEY';. This is optional for search, but it speeds up the search.
• Go to `admin/content/openwoo/publications` to create a publication.
  It will be pushed to OpenWoo.app on the next cron run.

For the OpenWoo Attachments module

• Enable the module.
• Add the s3fs settings to settings.php
  

  $settings['s3fs.access_key'] = 'YOUR ACCESS KEY';
  $settings['s3fs.secret_key'] = 'YOUR SECRET KEY';
  $config['s3fs.settings']['bucket'] = 'BUCKET NAME';
  $config['s3fs.settings']['region'] = 'BUCKET REGION';
  $settings['s3fs.use_s3_for_public'] = FALSE;
  $settings['s3fs.upload_as_private'] = TRUE;
  

• Go to `admin/content/openwoo/publications` to create a publication with a attachment. The attachment will now be saved to your Bucket

For further information se the s3fs module documentation: https://www.drupal.org/project/s3fs.

Additional Requirements

• You will need an api-key to post data to the OpenWoo.app.
• The OpenWoo core module has no dependencies.
• The OpenWoo publish-submodule requires media and media_library.