opencultureconsulting
/
simple-oai-pmh
mirror of https://github.com/opencultureconsulting/simple-oai-pmh.git
2
0
Fork 0
Code Issues Releases Activity
50 Commits 1 Branch 10 Tags 531 KiB
PHP 64.7%
XSLT 35.3%
Go to file
Sebastian Meyer 1c6015ed18 Fix syntax error in oaiconfig.php 2017-10-08 12:59:57 +02:00
data Support multiple data formats 2017-10-05 18:02:15 +02:00
LICENSE.txt Restructure and update meta files 2017-05-12 18:12:31 +02:00
README.md Fix format of README file 2017-10-08 12:51:50 +02:00
index.php Support multiple data formats 2017-10-05 18:02:15 +02:00
oai2config.php Fix syntax error in oaiconfig.php 2017-10-08 12:59:57 +02:00
oai2exception.php Update copyright information and readme 2017-05-13 12:08:11 +02:00
oai2server.php Support deletions by keeping 0-byte files 2017-09-28 14:47:24 +02:00
oai2transform.xsl Support multiple data formats 2017-10-05 18:02:15 +02:00
oai2xml.php Add XLST output transformation 2017-09-28 15:34:28 +02:00

README.md

Simple OAI-PMH 2.0 Data Provider

This is a stand-alone and easy to install data provider for the Open Archives Initiative's Protocol for Metadata Harvesting (OAI-PMH) written in PHP. It serves records in any metadata format from directories of XML files using the directory name as metadata prefix, the filename as identifier and the filemtime as datestamp. 0-byte files are considered deleted records and handled accordingly. Resumption tokens are managed using files. Sets are currently not supported.

Just put the records as XML files in the data directory, adjust a few configuration settings and you are ready to go!

A demo installation can be found here.

Installation

  1. Deploy all the files to a webserver.

  2. Edit oai2config.php and adjust the settings according to your preferences.

  3. Put the records into the specified data directory. Each record has to be a separate XML file with its identifier as filename (i.e. 12345678.xml). Optionally you can maintain deletions by keeping 0-byte files for deleted records.

  4. Congratulations! Now you are running an OAI-PMH 2.0 compatible data provider.

History

This project was originally initiated in 2002 by Heinrich Stamerjohanns at University of Oldenburg. His latest implementation can be still found via the Internet Archive's Wayback Machine.

It was then modified in 2011 by Jianfeng Li at University of Adelaide for The Plant Accelerator. The modified version can be found in the Google Code Archive.

In 2013 Daniel Neis Araujo at Federal University of Santa Catarina modified the project again in order to integrate it with Moodle. His implementation can be found on GitHub. In 2014 Kazimierz Pietruszewski provided some further bugfixes.

The current implementation was derived from the latter in 2017 by Sebastian Meyer at Open Culture Consulting for the German Literature Archive. It is a simplified stand-alone version focused on easy deployment and file based record handling.