/controlled_access_terms

Drupal module for subject and agents

Primary LanguagePHPGNU General Public License v2.0GPL-2.0

Mascot Controlled Access Terms

Build Status Contribution Guidelines LICENSE

Introduction

This Drupal 8 module creates vocabularies to represent common named entities in archival description (Corporate Bodies, Families, and Persons) as well as subject terms.

It is intended to be used in conjunction with both the ArchivesSpace/Drupal 8 Integration project and Islandora 8.

Requirements

This module requires the following modules:

Installation

Download and install as with other Drupal modules.

For example, using composer from the Drupal site's web directory:

$ composer require islandora/controlled_access_terms
$ drush en -y controlled_access_terms

Enable controlled_access_terms_defaults to create the default vocabularies.

Configuration

Provided vocabularies and fields may be configured in the same manner as other Drupal 8 vocabularies.

Provided Vocabularies

Below is a list of the vocabularies provided by controlled_access_terms_defaults. The fields with "EDTF" accept and display dates corresponding to the Library of Congress 2018 Extended Date/Time Format Specification (EDTF). See the section below for more information on EDTF.

  • Corporate Body
    • Preferred Name (Name)
    • Type
      • Organizational Unit (org:OrganizationalUnit)
      • Airline (schema:Airline)
      • Corporation (schema:Corporation)
      • Educational Organization (schema:EducationalOrganization)
      • Government Organization (schema:GovernmentOrganization)
      • LocalBusiness (schema:LocalBusiness)
      • Medical Organization (schema:MedicalOrganization)
      • Non-Governmental Organization (schema:NGO)
      • Performing Group (schema:PerformingGroup)
      • Sports Organization (schema:SportsOrganization)
      • Sports Team (schema:SportsTeam)
    • Authority Link
    • Founding Date (EDTF)
    • Dissolution Date (EDTF)
    • Alternate Name
    • Description
    • Related Entities
  • Family
    • Display Label (Name)
    • Description
    • Date Begin (EDTF)
    • Date End (EDTF)
    • Authority Link
    • Relation
  • Person
    • (Display) Name
    • Authority Link
    • Preferred Name
    • Alternate Name
    • Description
    • Birth Date (EDTF)
    • Death Date (EDTF)
    • Relationships
  • Geographic Location
    • Name (Title)
    • Authority Link
    • Latitude/Longitude (WGS 84)
    • Description
    • Alternate Name
    • Broader
  • Subject
    • Name
    • Language
    • Description
    • Authority Link

Extended Date/Time Format (EDTF)

The Library of Congress created the Extended Date/Time Format Specification which was subsequently incorporated with ISO 8601-2019. This modules provides a custom EDTF field type with a corresponding formatter (for display) and widget (for data entry).

Both the formatter and widget include settings for controlling how the EDTF is entered and displayed. For example, the widget allows EDTF values to use intervals; however, the widget settings (accessible through the bundle's form display page) can restrict the field to only accept single-dates.

Note: widget settings will not apply to data imported through other means (e.g. the Migrate API or REST-based updates).

The formatter settings allow administrators to control how the date is displayed. The default setting is YYYY-MM-DD (e.g. 1900-01-31) but settings can change, for example, the separator and the date order to display dates in 'mm/dd/yyyy' format (e.g. 01/31/1900).

Documentation

Further documentation for this module is available on the Islandora 8 documentation site.

Troubleshooting/Issues

Having problems or solved a problem? Check out the Islandora google groups for a solution.

Maintainers/Sponsors

Current maintainers:

Development

If you would like to contribute, please get involved by attending our weekly Tech Call. We love to hear from you!

If you would like to contribute code to the project, you need to be covered by an Islandora Foundation Contributor License Agreement or Corporate Contributor License Agreement. Please see the Contributors pages on Islandora.ca for more information.

We recommend using the islandora-playbook to get started.

License

GPLv2.