DE EN EN (Google)

Plugins

The easydb provides a number of plugins already, the so-called base plugins.

Apart from this, you may develop plugins yourself or install plugins installed by others. We describe the installation of such a plugin in the Extension-Plugin.

Plugins found on https://github.com/programmfabrik support both ways. You may activate them as a base-plugins or install them as an extension-plugins. The latter is much more complicated.

List of active plugins

Which plugins are currently active can be seen in the web front end of the easydb, on the far left via the “i”(nfo) button and then with its subpoint “About”.


Base plugin

Available base plugins

Pluginname Description
presentation-pptx Allows to create powerpoint presentations in easydb5
server
eventmanager Allows you to see all events in easydb5 frontend
hotfolder Allows you to configure the hotfolder
export-transport-ftp Allows you to export your files via ftp
remote-plugin Allows you to connect your frontend to another easydb5
connector Allows you to connect your easydb5 to other instances
basemigration
oai
detail-map
editor-tagfilter-defaults
easydb4migration
a-frame
sso Allow the easydb to communicate with Kerberos or Shibboleth
ldap Allow the easydb to communicate with the LDAP
webhook-plugin
wordpress
typo3
drupal
falconio
barcode
hijri-gregorian-converter github hijri-gregorian-converter
custom-data-type-dante dante
custom-data-type-gazetter
custom-data-type-link link
custom-data-type-getty getty
custom-data-type-gvk gvk
custom-data-type-geonames geonames
custom-data-type-gn250 gn250
custom-data-type-georef georef
custom-data-type-gnd gnd
custom-data-type-tnadiscovery tnadiscovery
custom-data-type-location

Base plugins have already been installed with the easydb installation and must therefore only be activated.

Compare the following lines to the configuration file config/easydb-server.yml below the data store (defined during the installation). Add the missing lines.

plugins:
  enabled+:
    - base.detail-map
    - base.eventmanager

… for e.g. The two plugins detail-map and eventmanager.

After that, you should restart the easydb.


Extension plugin

Available extension plugins

Pluginname Plugin website Description
example-plugin example-plugin Just for testing purposes

Extension plugins are typically made by developers outside of Programmfabrik.

Thus the installation procedure can be different than shown here. In that case please contact the plugin developer for more information.

For the plugin shown here (example-plugin) and others on github.com there is a so called issue tracker for each plugin: https://github.com/programmfabrik/easydb-plugin-examples/issues

Installation example:

Commands to be executed in the data store directory (defined during installation):

mkdir config/plugin
cd config/plugin
git clone https://github.com/programmfabrik/easydb-custom-data-type-geonames easydb-custom-data-type-geonames
cd easydb-custom-data-type-geonames
git submodule init
git submodule update
make

If “make” asks for the programm “coffee” then please install the newest version which starts with “1.” e.g. version 1.12.7 during the time of writing this. On a Debian 10 server, these commands have been tested to achieve that:

apt-get install npm
npm install -g coffee-script@1
cd /usr/bin
ln -s nodejs node  # this may not be needed

After that you should return to the directory where you executed “make” and execute it again.

Now the plugin is ready but the easydb does not yet know of the plugin. To change that, compare the following lines to the configuration file config/easydb-server.yml below the data store. Add the missing lines:

extension:
  plugins:
    - name: easydb-plugin-example
      file: plugin/example-plugin/example-plugin.config.yml
plugins:
  enabled+:
    - extension.easydb-plugin-example

In detail, look for the name of the yml-file in the git clone directory.

Also look for the name of the plugin in that yml-file. Place the names in the configuration. For clarification, here another example with capital letters as emphasis to show where to replace strings:

extension:
  plugins:
    - name: NAME_FROM_YML_FILE
      file: plugin/CLONE_DIRECTORY/NAME_OF_THE_YML_FILE
plugins:
  enabled+:
    - extension.NAME_FROM_YML_FILE

Lastly, you should restart the easydb to load the new plugin:

docker restart easydb-server easydb-webfrontend

Solution plugin

If we are developing a plug-in for you, we can deliver it as a solution plug-in.

In this case, we also create documentation for the plugin. You will get the documentation from us.


CMS Plugins

Wordpress Plugin

Wordpress Plugin to easily transport media files to Wordpress CMS.

Currently, this plugin supports the creation of new media as well as the updating of related metadata. When a new record is created in easydb, a new record is also created in Wordpress. There is no support for deleting media.

Prerequisites

Setup (Wordpress)

Install Plugin in easydb

Add the following lines to your easydb-server.yml:

base:
  plugins+:
    - name: wordpress
      file: easydb-wordpress-plugin/wordpress.yml

plugins:
  enabled+:
    - base.sso
    - base.simple-example
    - base.wordpress

Now go to Basic Configuration to finish the WP configuration for easydb.

Falcon.io Plugin

Plugin to easily transport media files to Falcon.io CMS. Currently this supports sending selected media to Falcon.io. Updating is not supported, new files are created in Falcon.io instead.

Setup (Falcon.io)

Install Plugin in easydb

Add the following lines to your server.yml:

base:
  plugins+:
    - name: falconio
      file: easydb-falconio-plugin/falconio.yml

plugins:
  enabled+:
    - base.falconio