OA-EZB: An EPrints plug-in for integrating OA rights from alliance and national licenses into institutional repositories.
Open Access rights (OA rights) from alliance and national licences, which are stored in the Elektronischen Zeitschriftenbibliothek (EZB), can now be integrated into institutional repositories. This is now possible with OA-EZB, a plug-in specially developed for the repository software EPrints, which accesses the EZB's new OA interface services.
This plug-in was developed as part of the DFG project „OA-EZB: Open Access Services of the Electronic Journals Library (DFG project)“ at University of Regensburg Library. It consists of three modules that can be configured separately from each other. The first module accesses the OA interfaces of the EZB and displays the information on deposited secondary publication rights, e.g. for alliance licenses, in an overview. The second module retrieves publishers' OA policies in SHERPA/RoMEO. In the third module a reference to the German secondary publication law according to copyright law is issued.
In the front end of the EPrints repository, the retrieved data of all modules appear at a previously defined point, for example before uploading an article. Authors thus receive all the necessary information in an overview even before their research results are uploaded, which provides uncomplicated information about the possibilities of publishing in Open Access. This is intended to promote the use of the green path.
On the technical side, the existing EPrints plug-in for SHERPA/RoMEo (developped by Alen Vodopijevec at Ruđer Bošković Institute, Zagreb) was updated and access to the new EZB interface services implemented. OA-EZB will be developed for EPrints version 3.3.16 and will be made available for free use under the GPL license on GitHub upon completion. Its operation requires registration for API accesses to SHERPA/RoMEO and the EZB.
Open-Access-Rechte (OA-Rechte) aus Allianz-und Nationallizenzen, die in der Elektronischen Zeitschriftenbibliothek (EZB) erfasst sind, lassen sich nun in institutionelle Repositorien einbinden. Dies gelingt nun mit OA-EZB, einem eigens für die Repositoriensoftware EPrints entwickelten Plug-in, das auf die neuen OA-Schnittstellendienste der EZB zugreift.
Dieses Plugin wurde im Rahmen des DFG-Projektes „OA-EZB: Open-Access-Services der Elektronischen Zeitschriftenbibliothek (EZB)“ an der Universitätsbibliothek Regensburg entwickelt. Es besteht aus drei Modulen, die sich getrennt voneinander konfigurieren lassen. Das erste Modul greift auf die OA-Schnittstellen der EZB zu und gibt die Informationen über hinterlegte Zweitveröffentlichungsrechte, z.B. für Allianz-Lizenzen, in einer Übersicht aus. Das zweite Modul ruft verlagsseitige OA-Policies in SHERPA/RoMEO ab. Im dritten Modul wird ein Hinweis auf das deutsche Zweitveröffentlichungsrecht gemäß Urheberrechtsgesetz ausgegeben.
Im Frontend des EPrints-Repositoriums erscheinen die abgerufenen Daten aller Module an einer zuvor definierten Stelle, beispielsweise vor dem Hochladen eines Artikels.
Somit erhalten Autoren bereits vor dem Hochladen ihrer Forschungsergebnisse alle erforderlichen Informationen in einer Übersicht, die unkompliziert über die Möglichkeiten zur Veröffentlichung in Open Access aufklärt. Damit soll die Nutzung des grünen Weges gefördert werden.
Auf technischer Seite wurde das existierende EPrints-Plug-in für SHERPA/RoMEo (entwickelt von Alen Vodopijevec am Ruđer Bošković Institut, Zagreb) aktualisiert und der Zugriff auf die neuen EZB-Schnittstellendienste implementiert. Die Entwicklung von OA-EZB erfolgt für EPrints der Version 3.3.16 und wird bei Abschluss unter der GPL-Lizenz auf GitHub zur freien Nutzung bereitgestellt. Für seinen Betrieb ist eine Registrierung für die API-Zugänge bei SHERPA/RoMEO und bei der EZB notwendig.
The following requirements must be met for proper operation of the plug-in:
- Internet access
- Valid SHERPA/RoMEO Api-Key (further details)
- Your institution is participating in the corresponding alliance/national licenses
WARNING! Backup everything first, we cannot be responsible in case of failure
- Copy *.rm files to component plugin folder (usually EPRINTS_ROOT/perl_lib/ARCHIVE_ID/Plugin/InputForm/Component)
- Edit config file z_ezboa.pl and copy to EPRINTS_ROOT/archives/ARCHIVE_ID/cfg/cfg.d
- set your EZB institution-id (if the institution-id isn't set the OA-EZB API tries to determine it via IP-adress)
- set your SHERPA/RoMEO api key
- choose the plug-in modules to be displayed
- Create plugin phrases inside your phrases folder (usually EPRINTS_ROOT/archives/ARCHIVE_ID/cfg/lang/en/phrases for English phrases, see model files included)
- Edit workflow (EPRINTS_ROOT/archives/ARCHIVE_ID/cfg/workflows/eprint/default.xml)
<flow>
<stage ref="type"/>
<stage ref="files"/>
<stage ref="core"/>
<epc:if test="type = 'article'">
<stage ref="policies"/>
</epc:if>
<stage ref="subjects"/>
</flow>
<stage name="policies">
<component type="XHTML" surround="None">
<h1>
<epc:phrase ref="ezboa_main_heading" />
</h1>
</component>
<epc:if test="$config{ezb_show_ezb} = 1">
<component type="XHTML" surround="None">
<h2>
<epc:phrase ref="ezboa_sub_heading1" />
</h2>
</component>
<component type="Ezboa" collapse="no" surround="None"></component>
</epc:if>
<epc:if test="$config{ezb_show_sherparomeo} = 1">
<component type="XHTML" surround="None">
<h2>
<epc:phrase ref="ezboa_sub_heading2" />
</h2>
</component>
<component type="Romeo" collapse="no" surround="None"></component>
</epc:if>
<epc:if test="$config{ezb_show_legal_info} = 1">
<component type="XHTML" surround="None">
<h2>
<epc:phrase ref="ezboa_sub_heading3" />
</h2>
</component>
<component type="XHTML" surround="None">
<epc:phrase ref="Plugin/InputForm/Component/Ezboa:ezb_legal_info" />
</component>
</epc:if>
<epc:if test="$config{ezb_show_disclaimer} = 1">
<component type="XHTML" surround="None">
<epc:phrase ref="Plugin/InputForm/Component/Ezboa:ezb_disclaimer_body" />
</component>
</epc:if>
<component type="XHTML" surround="None">
<hr />
</component>
</stage>
- we changed workflow so that users need to input ISSN first so in the next step we can check Romeo for that Journal
- plugin is shown only for articles
- check if required perl extensions are installed
sudo apt-get install build-essential
cpan HTML::StripTags
./bin/epadmin reload your_eprints_repository
- Apply CSS styling. Copy *.css files to EPRINTS_ROOT/archives/ARCHIVE_ID/cfg/static/style/auto
- Copy image files to images folder (usually EPRINTS_ROOT/archives/ARCHIVE_ID/cfg/static/images/ ).
- restart Apache and test ...
# /sbin/service httpd restart
# /etc/init.d/apache2 restart
Data protection policy for Universität Regensburg's websites and web applications
The EZB and the extension for the administration of national and alliance licenses were developed at the University Library of Regensburg. The software EPrints 3.3.16, developed at the University of Southampton, is freely available under GPL 3.0. The plug-in OA-EZB was programmed at the University Library of Regensburg.
technical assistence / feedback
Dr. Gernot Deinzer (Open-Access-Beauftragter)
+49 941 943-2759
gernot.deinzer@bibliothek.uni-regensburg.de
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.