/dnb

OJS plugin that exports full texts and metadata to the Deutsche Nationalbibliothek (DNB)

Primary LanguagePHPGNU General Public License v2.0GPL-2.0

=============================================================
=== OJS DNB Export Plugin
=== Version: 1.4
=== Author: Bozana Bokan, Ronald Steffen
=== Last update: January 29, 2021
=============================================================

About
-----
This plugin provides the export of article metadata and full texts (in PDF and EPUB format) for their transfer to the German National Library (DNB)
using the DNB Hotfolder method. The plugin also offers the option of directly depositing the transfer package into the DNB Hotfolder.
Details on the Hotfolder method are available at: http://nbn-resolving.de/urn%3Anbn%3Ade%3A101-2016111401
Details on the XML format and data requirements are available at: http://nbn-resolving.de/urn%3Anbn%3Ade%3A101-2014071124

License
-------
This plugin is licensed under the GNU General Public License v2. See the file LICENSE for the complete terms of this license.

System Requirements
-------------------
This plugin version is compatible with...
 - OJS 3.2.1
 
TAR executable is required and it has to be configured in config.inc.php.

For the depositing from within OJS, additionally CURL library is needed.

Installation
------------
Installalion via OJS GUI:
 - download dnb-[version].tar.gz from https://github.com/ojsde/dnb/releases
 - install plugin in OJS (Settings -> Website -> plugins -> „Upload a New Plugin“ -> upload dnb-[version].tar.gz)

Installation via command line without Git:
 - download archive from https://github.com/ojsde/dnb
 - unzip the archive to plugins/importexport and rename the main plugin folder to "dnb" if necessary
 - from your application's installation directory, run the upgrade script (it is recommended to back up your database first):
   php tools/upgrade.php upgrade or php tools/installPluginVersion.php

Installation with Git:
 - cd [my_ojs_installation]/plugins/importexport
 - git clone https://github.com/ojsde/dnb
 - cd dnb
 - git checkout [branch]
 - cd [my_ojs_installation]
 - php tools/upgrade.php upgrade or php tools/installPluginVersion.php

Export
------------
The plugin settings can be found at:
Tools > Import/Export > DNB Export Plugin > Settings

The plugin export interface can be found at:
Tools > Import/Export > DNB Export Plugin > Articles

Note
---------
In order to deposit articles to DNB from within OJS you will have to enter your username, password and subfolder ID in the plugin settings. 
If you do not enter this information you'll still be able to export the DNB packages but you cannot deposit them from within OJS.
Please note, that the password will be saved as plain text, i.e. not encrypted, due to DNB service requirements.

Contact/Support
---------------

Please see the documentation (in German) in the `docs` folder or at https://ojs-de.net/support/anleitungen/dnb-plugin. 

Documentation, bug listings, and updates can be found on this plugin's homepage
at <http://github.com/ojsde/dnb>.