PHPackages                             born-digital/islandora\_oral\_histories - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. born-digital/islandora\_oral\_histories

ActiveDrupal-module

born-digital/islandora\_oral\_histories
=======================================

Islandora Oral Histories

25601PHP

Since Sep 19Pushed 9mo ago1 watchersCompare

[ Source](https://github.com/Born-Digital-US/islandora_oral_histories)[ Packagist](https://packagist.org/packages/born-digital/islandora_oral_histories)[ RSS](/packages/born-digital-islandora-oral-histories/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (4)Used By (0)

islandora-oral-histories
========================

[](#islandora-oral-histories)

Oral Histories Functionality for Islandora 2.0+

### Install and configuration

[](#install-and-configuration)

Install and enable this module as you would for any other Drupal module. Incorporating this into the site's composer.json is outside the scope of this document.

The module will provide several field formatters and all of the module code with some javascript and CSS to parse a transcript. A subsequent version of this module will include minimal configurations, but it will have to be a manual process to configure the dependencies for content to use the features of this module.

##### Manual configurations

[](#manual-configurations)

The srt, vtt or txt format of a time-based transcript is stored as a File media related to the audio or video item. This uses the "Transcript" Islandora Media Use taxonomy term. If your site doesn't already have this term, you will need to add it, and make sure the External URI's "URL" field value is: `http://pcdm.org/use#Transcript`.

The File Media type needs to be configured to allow the File extensions on the field\_file. This is needed if you have transcript files with either vtt, xml (srt), or asc file formats.

To store a text version of the entire transcript (without any time encoding information), a new Islandora Media Use taxonomy term must be created called "Transcript Text." The External URI's "URL" value must be `http://pcdm.org/use#TranscriptText`.

A new display mode called "Oral Histories" will need to be added and a corresponding context to trigger this display mode. Separate context rules will need to be made for Audio and for Video. The context rules should have the conditions of "Node has term with URI" = "Moving Image" and "Video" for video oral histories, or "Node has term with URI" = "Sound" and "Audio" for audio oral histories.

[![image](https://user-images.githubusercontent.com/19391126/226608409-ea63ad4b-4cd9-4f69-ae42-921281d16777.png)](https://user-images.githubusercontent.com/19391126/226608409-ea63ad4b-4cd9-4f69-ae42-921281d16777.png)

For the "Oral Histories" display of the transcript, a Quicktabs called "Oral History Quicktabs" is used to configure the display of the transcript as well as the Islandora metadata. The code references the machine name of "oral\_history\_quicktabs", so be sure that the name matches.

The "Oral Histories" display mode will need to be configured to display the previously mentioned "Oral History Quicktabs" as well as the Media EVA for the player.

[![image](https://user-images.githubusercontent.com/19391126/226612042-b2766393-b534-45b9-a432-b07e17b3cd1a.png)](https://user-images.githubusercontent.com/19391126/226612042-b2766393-b534-45b9-a432-b07e17b3cd1a.png)

##### Usage

[](#usage)

Of course, none of this would work unless an audio or video file has a Transcript media at least. Oral History objects must use the Model = "Video" and Resource Type = "Moving Image" (for video objects) or Model = "Audio" and Resource Type = "Sound" (for audio objects) -- and must have srt (xml), vtt, or txt file media which is set to Media Use = "Transcript" and/or txt or asc file media set to Media Use = "Transcript Text."

[![image](https://user-images.githubusercontent.com/19391126/226374188-a748864f-bc69-4e79-a566-7b39b161762d.png)](https://user-images.githubusercontent.com/19391126/226374188-a748864f-bc69-4e79-a566-7b39b161762d.png)

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance40

Moderate activity, may be stable

Popularity19

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity25

Early-stage or recently created project

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/507888823c4f3dc3538e2b734f9e1e2d29d37087ac3044c25b000dbbff725d58?d=identicon)[noahwsmith](/maintainers/noahwsmith)

---

Top Contributors

[![dannylamb](https://avatars.githubusercontent.com/u/20773151?v=4)](https://github.com/dannylamb "dannylamb (13 commits)")[![alxp](https://avatars.githubusercontent.com/u/82412?v=4)](https://github.com/alxp "alxp (11 commits)")[![wgilling](https://avatars.githubusercontent.com/u/19391126?v=4)](https://github.com/wgilling "wgilling (7 commits)")[![mitchmac](https://avatars.githubusercontent.com/u/618212?v=4)](https://github.com/mitchmac "mitchmac (5 commits)")[![noahwsmith](https://avatars.githubusercontent.com/u/39922?v=4)](https://github.com/noahwsmith "noahwsmith (2 commits)")[![dara2](https://avatars.githubusercontent.com/u/72275887?v=4)](https://github.com/dara2 "dara2 (1 commits)")

### Embed Badge

![Health badge](/badges/born-digital-islandora-oral-histories/health.svg)

```
[![Health](https://phpackages.com/badges/born-digital-islandora-oral-histories/health.svg)](https://phpackages.com/packages/born-digital-islandora-oral-histories)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
