GithubHelp home page GithubHelp logo

patdunlavey / archivesspace-drupal Goto Github PK

View Code? Open in Web Editor NEW

This project forked from unlv-libraries/archivesspace-drupal

0.0 1.0 0.0 218 KB

ArchivesSpace-to-Drupal 8 integration

PHP 99.94% HTML 0.06%

archivesspace-drupal's Introduction

AS2D8: ArchivesSpace-to-Drupal 8 integration

AS2D8 is a series of Drupal modules for harvesting data from ArchviesSpace. AS2D8 extends the Drupal core Migrate API with plugins, provides sensible defaults for displaying ArchivesSpace resources in Drupal and all of the usual Drupal content and website management tools. AS2D8 closely tracks the Islandora CLAW project. When the next-generation of Islandora is stable, AS2D8 will offer an integration point for Islandora.

A few possible use cases include:

  • Using Drupal Views to build glossary displays, user-configurable sorting,
  • Optionally deploying with Search API with Apache Solr to provide a configurable and granular control over search results
  • Building custom reports, logs, and user analytics
  • Developing customized "Omeka-like" online exhibitions of archival material
  • Researcher annotations, user-administered "favorites", save-for-later carts
  • Managing research requests
  • Joining archival records to geo-locations

Changes can be made in real time or asynchronously in batches during cron run. Once ArchivesSpace records are consumed by Drupal, they can be further enriched with NISO-defined metadata, published in a customizable discovery theme layer, and published in web service formats for consumption by other resources.

Pre-history

The original ArchivesSpace/Drupal Integration project is a began in 2014 as a Kress Foundation-funded suite of Drupal 7 modules to support cataloging and discovery at the American Academy in Rome. The project extends several Drupal modules including RESTClient, Web Service Data, and custom code to request ArchivesSpace JSON objects and pipe them into Drupal entities. These entities can then be formatted, manipulated, and indexed via traditional Drupal methods (Views, Solr, Elastic Search, etc.). The original project is monitored and updated for maintenance fixes only. No new features will be considered or added.

Instead, this project provides an entirely new suite of Drupal 8 modules that adhere to PSR coding standards and module development best practices in order to release this suite to both ArchivesSpace and Drupal developer communities.

Roadmap & product pipeline

Building the Drupal data model

The content types and vocabularies cover:

  • Repositories
  • Resources
  • Archival Objects
  • Subjects (with a Geographic Location-specific sub-type)
  • Agents (except software)
  • Digital Objects (in a sub-module)

Migration plugins

This module provides migrations for all the supported content types and vocabularies.

By default, resources or archival objects that do not have the "publish" flag set are not migrated, nor do archival objects with an unpublished ancestor. However, once a resource or archival object is migrated it will remain in Drupal even if the flag is changed in ArchivesSpace unless manually removed.

Authentication

To migrate content the module must be configured with a valid ArchivesSpace API point, username, and password. The migrations assume the API point of 'localhost:8089', 'admin' user, and 'admin' password unless configured. Visit the page /admin/configuration/archivesspace in your Drupal site to configure these settings.

Templates

TBD

Search

TBD

Features

TBD

CMI

TBD

Documentation

TBD

Quick Start Guide

Assuming the Drupal site and ArchivesSpace are installed on the same host:

  • Ensure all the dependencies are installed.
  • Save the module to your drupal site's modules directory.
  • Enable the ArchivesSpace module. (E.g. drush en -y archivesspace)
  • Run the migrations. Note: most of the migrations will run relatively quickly, within a few minutes. However, the final migration, archival objects, can take a very long time to process for large sites (more than an hour).

Using AS2D8

TBD

System Requirements

TBD

Other Notes

TBD

License

AS2D8 is licensed on the same terms as Drupal, under GPLv2 or later.

About Drupal licensing

The AS2d8 license also covers its related modules, hacks, plugins, and configuration management.

archivesspace-drupal's People

Contributors

seth-shaw-unlv avatar jasloe avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.