islandora / controlled_access_terms
Drupal module for subjects and agents
Installs: 243 163
Dependents: 8
Suggesters: 0
Security: 0
Stars: 7
Watchers: 38
Forks: 30
Type:drupal-module
Requires
- drupal/geolocation: ^3.2
- drupal/token: ^1.7
- professional-wiki/edtf: ^2 || ^3
Requires (Dev)
- drupal/coder: *
- phpunit/phpunit: ^6
- sebastian/phpcpd: *
- squizlabs/php_codesniffer: ^2.8.1 || ^3
Suggests
- drupal/name: Provides western-centric structured names.
- drupal/rdf: Provides ability to map fields to RDF.
Conflicts
- drupal/core: <=10.1
- islandora/jsonld: <2.1.0
Replaces
This package is auto-updated.
Last update: 2024-10-28 15:56:58 UTC
README
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 drupal/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). To apply some basic EDTF validation
when using Migrate API, set validate: true
in the migration's destination
.
This is a coarser validation than the widgets provided but will rule out some
malformed date strings.
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.