Omeka S Module

Omeka S Module Introduction: HistoryLog - Recording Change History

Overview As of 2023/07/20, this module appears to still be in beta, but I had the opportunity to try out “Omeka-S-module-HistoryLog,” a module for recording change history in Omeka S. Here are my notes. https://github.com/Daniel-KM/Omeka-S-module-HistoryLog Installation As noted in the documentation, you may need to install the Generic module beforehand. https://github.com/Daniel-KM/Omeka-S-module-HistoryLog#installation Otherwise, the installation procedure is the same as for standard modules. After installation, the module will appear in the module list as shown below. ...

July 20, 2023 · Updated: July 20, 2023 · 1 min · Nakamura

Omeka S User Permissions and Access to Private Resources

Overview I needed to create a user with viewing permissions for private resources in Omeka S, so this is a memo about that. Omeka S User Permissions Omeka S provides multiple user permission levels. Specifically, they are described on the following page. https://omeka.org/s/docs/user-manual/admin/users/#users Below is a summary with Japanese translations for reference. English Japanese Global Administrator full installation privileges. Global Administrator Full installation privileges Supervisor robust site and content privileges. Supervisor Robust site and content privileges Editor (Content Expert) full privileges for content creation. Editor Full privileges for content creation Reviewer robust content privileges but can only delete own content. Reviewer Robust content privileges but can only delete own content Author create own content. Author Can create own content Researcher search and read privileges only. Researcher Search and read privileges only Access to Private Resources: View Private Resources Module In the table above, Researcher has only search and read privileges, making it one of the possible permission levels to use when requesting review of private resources, for example. (Additionally, permissions can be extended using modules such as the Guest module.) ...

March 17, 2023 · Updated: March 17, 2023 · 2 min · Nakamura

Updating Vocabularies Created with Omeka S Custom Ontology

Overview Custom Ontology is a module that allows you to add custom vocabularies when standard ontologies such as LOV, schema.org, and W3C are not available. Its usage is introduced below. https://nakamura196.hatenablog.com/entry/2021/07/24/235050 The above article covers vocabulary creation, but does not address how to update existing vocabularies. This article explains how to update existing vocabularies. Creating a Vocabulary As an example, we will create the following vocabulary. https://omekas.aws.ldas.jp/omeka4/ns/myprefix/ Accessing the above URL will download the following TTL file. Here, we have added a custom property called myprefix:mySpecificProperty. ...

March 16, 2023 · Updated: March 16, 2023 · 2 min · Nakamura

[Omeka S Module Introduction] Bulk Import: Batch Registration of Metadata and Images Using CSV Files (2023-03 Edition)

Overview I previously wrote the following article about how to use the “Bulk Import” module for batch registration of metadata (items) and images (media) into Omeka S. https://nakamura196.hatenablog.com/entry/2021/07/28/080952 However, due to updates to Omeka S and its modules, some behaviors differ as of March 2023. In this article, I will re-introduce the entire workflow from item set registration to media registration, while leaving the detailed explanations to the article above. ...

March 12, 2023 · Updated: March 12, 2023 · 3 min · Nakamura

Program for Batch Image Registration to Omeka S

Overview When batch importing metadata (items in Omeka terminology) and images (media in Omeka terminology) into Omeka S, the Bulk Import module is commonly used. https://github.com/Daniel-KM/Omeka-S-module-BulkImport However, it is also possible to register via the REST API provided by Omeka S. This article introduces a program I created for batch image registration using this API. Reason for Development The latest version of the Bulk Import module allows you to choose whether to stop or continue when an error occurs, but older versions of the module do not have this option. As a result, when batch registering images, there were cases where images were missing each time image retrieval failed. ...

February 3, 2023 · Updated: February 3, 2023 · 2 min · Nakamura

[Omeka S Module Introduction] BulkExport: Bulk Data Export

Overview BulkExport is a module for performing bulk data export in Omeka S. https://github.com/Daniel-KM/Omeka-S-module-BulkExport This article explains how to use this module. Installation Like other common modules, it can be installed using the standard method. Download the latest zip file from the following URL. https://github.com/Daniel-KM/Omeka-S-module-BulkExport/releases During installation, the Log module needs to be installed in advance, as shown below. Usage Click “BulkExport” in the left side of the admin screen, then click the export icon. ...

January 22, 2023 · Updated: January 22, 2023 · 1 min · Nakamura

Omeka S Module Development: FixCjkSearch - Fixing Full-Text Search Issues with Japanese in Omeka S

Full-text search in Japanese does not work properly with Omeka S’s standard functionality. The following article explains the details of the issue: https://nakamura196.hatenablog.com/entry/2022/03/07/083004 In the article above, I presented several workarounds, and I have now created a module that encompasses those solutions: https://github.com/nakamura196/Omeka-S-module-FixCjkSearch While this is not a fundamental fix, I hope it proves useful when working with Japanese materials in Omeka S.

December 23, 2022 · Updated: December 23, 2022 · 1 min · Nakamura

[Omeka S Module Introduction] Folksonomy: Social Tagging

Overview Folksonomy is a module for implementing social tagging in Omeka S. https://omeka.org/s/modules/Folksonomy/ This article explains how to use this module. Installation It can be installed using the standard method, same as other common modules. Configuration After installation, the following settings screen is displayed. In particular, by enabling “Allow public to tag,” visitors can perform tagging. Additionally, by enabling “Require approbation for public tags,” an administrator approval workflow can be introduced. ...

December 20, 2022 · Updated: December 20, 2022 · 1 min · Nakamura

[Omeka S Module Introduction] Mapping Module

Overview This is an introduction to the “Mapping” module for integrating maps with Omeka S. https://omeka.org/s/modules/Mapping/ Installation This module can be installed using the standard method for Omeka S. Adding Location Information On the item editing screen, add location information from the “Mapping” tab. Map-based search and display are available on the public site.

November 25, 2022 · Updated: November 25, 2022 · 1 min · Nakamura

[Omeka S Module Introduction] Timeline Module

Overview This is an introduction to the “Timeline” module for creating timelines in Omeka S. https://omeka.org/s/modules/Timeline/ Installation You can install this module using the standard method for Omeka S. Below is an example of the installation method. cd omeka-s/modules wget https://github.com/Daniel-KM/Omeka-s-module-Timeline/releases/download/3.4.16.3/Timeline-3.4.16.3.zip unzip Timeline-3.4.16.3.zip Usage To use this module, you need to create a page on your site. In the following example, a page named “Timeline” has been created. Then, select Timeline from “Add new block” on the right side of the screen. By default, mapping to the timeline is performed targeting values stored in dcterms:date. ...

November 24, 2022 · Updated: November 24, 2022 · 1 min · Nakamura

[Omeka S Module Introduction] IIIF Search Module

Overview IIIF Search is a module for Omeka S that adds the IIIF Content Search API for full-text search. This article introduces the usage of the following module, which includes modifications for handling Japanese text. https://github.com/nakamura196/Omeka-S-module-IiifSearch Installation Clone the source code from GitHub. Replace omeka-s as appropriate for your environment. cd omeka-s/modules git clone https://github.com/nakamura196/Omeka-S-module-IiifSearch.git IiifSearch Note that when installing from GitHub, you need to rename the folder to the target module name as shown above. ...

November 24, 2022 · Updated: November 24, 2022 · 2 min · Nakamura

[Omeka S Module Modification] IIIF Search Module

Overview IIIF Search is a module for Omeka S that adds a IIIF Search API for full-text search. https://github.com/symac/Omeka-S-module-IiifSearch This time, I modified the above module. A pull request has been submitted, but the modified module is available in the following repository. https://github.com/nakamura196/Omeka-S-module-IiifSearch Specifically, the minimum query string length was set to 1 character, but I made it configurable through a settings form. The default was set to 3 characters, which prevented searching with a single kanji character, so this modification was made. ...

November 24, 2022 · Updated: November 24, 2022 · 2 min · Nakamura

[Omeka S Module Introduction] "Extract Ocr" - A Module for Performing OCR on PDF Files

Overview This article introduces “Extract Ocr,” an Omeka S module that performs OCR on PDF files. Installation Refer to the following page. https://omeka.org/s/modules/ExtractOcr/ This module requires a command-line tool called pdftohtml. In the instructions below, replace omeka-s as appropriate for your environment. In an environment using AWS Lightsail, it could be installed with the following command: sudo apt install poppler-utils Additionally, you need to edit omeka-s/config/local.config.php. Change the base_uri portion according to your environment. Example: https://omekas.aws.ldas.jp/sandbox/files ...

November 24, 2022 · Updated: November 24, 2022 · 2 min · Nakamura

Installing the Mroonga Search Module (Note: This Did Not Work Successfully)

Overview I attempted to install the Mroonga search module introduced in the following article on AWS Lightsail. https://nakamura196.hatenablog.com/entry/2022/03/07/083004 As a result, the installation did not succeed, but I am documenting it here for future reference. Setting Up Omeka S I set up Omeka S as described in the following article. Installing Mroonga I performed the installation following the instructions on the following page. https://mroonga.org/docs/install/debian.html sudo apt update sudo apt install -y -V apt-transport-https sudo apt install -y -V wget wget https://packages.groonga.org/debian/groonga-apt-source-latest-bullseye.deb sudo apt install -y -V ./groonga-apt-source-latest-bullseye.deb sudo apt update sudo apt install -y -V mariadb-server-10.5-mroonga After executing the above, enter mysql (mariadb). ...

November 21, 2022 · Updated: November 21, 2022 · 2 min · Nakamura

[Omeka S Module Development] Adding Features to Sitemaps

In the following article, I introduced the “Sitemaps” module, which adds dynamic sitemap XML files for each site in Omeka S. I made a simple feature addition to the above module. Specifically, I added options to choose whether to include pages and itemsets in the sitemap XML. The forked repository is below. https://github.com/nakamura196/omeka-s-module-Sitemaps The changes can be reviewed at the following URL. https://github.com/nakamura196/omeka-s-module-Sitemaps/commit/03325f79e4e5b83c4ff7867fd37ed210fdf8eab2 I hope this serves as a useful reference for module modifications. ...

November 20, 2022 · Updated: November 20, 2022 · 1 min · Nakamura

[Omeka S Module Introduction] Sitemaps

Overview This module adds dynamic sitemap XML files for each site in Omeka S. https://omeka.org/s/modules/Sitemaps/ Installation It can be installed using the standard Omeka S method. Configuration First, select the site where you want to add a sitemap. Then navigate to Site Admin > Settings as shown below. At the bottom of the settings screen, there is an option to enable dynamic sitemap generation as shown below. When enabled, a sitemap is generated as shown below. ...

November 20, 2022 · Updated: November 20, 2022 · 1 min · Nakamura

[Omeka S Module Introduction] Custom Vocab

Overview I introduce Custom Vocab, one of the Omeka S modules. https://omeka.org/s/modules/CustomVocab Below is my translation of the description from the official site. The Custom Vocab module allows you to create controlled vocabularies and add them to specific properties in resource templates. When using that template for items, properties are loaded as dropdown menus limited to the controlled vocabulary options, instead of text input boxes. For example, you can create an institution-specific list of locations corresponding to various collections on campus, or a controlled list of people or places related to holdings. This can reduce typos and name variations, and provide metadata references for more fields. ...

November 6, 2022 · Updated: November 6, 2022 · 3 min · Nakamura

[Omeka S Module Development] Updating IIIF Viewers

Overview I made feature improvements to the Omeka S module “IIIF Viewers,” which configures IIIF manifest icons and multiple IIIF-compatible viewers. https://github.com/omeka-j/Omeka-S-module-IiifViewers Along with these improvements, version 1.1.0 has been released. https://github.com/omeka-j/Omeka-S-module-IiifViewers/releases/tag/1.1.0 For the release, the method described in the following article was used. The specific improvements are described below. Fixing IIIF Manifest Icon URLs As mentioned in the following article, there was a bug where the IIIF manifest icon could not be loaded into other viewers via drag and drop. This improvement fixes that bug. ...

September 26, 2022 · Updated: September 26, 2022 · 2 min · Nakamura

Creating a GitHub Release Script for Omeka S Module Development

I created a GitHub release script for Omeka S module development. For this development, I referenced the GitHub repository usage of Daniel-KM, who has developed numerous Omeka S modules. Specifically, GitHub repositories are created with the naming convention “Omeka-S-module-{module name}”. Example: https://github.com/Daniel-KM/Omeka-S-module-EasyInstall For releases, they are tagged with “{module name}-{version}” and a file named “{module name}-{version}.zip” is attached. Example: https://github.com/Daniel-KM/Omeka-S-module-EasyInstall/releases/tag/3.3.6 When this zip file is extracted, a folder named “{module name}” is created. This is necessary because Omeka S requires the module folder name to match the module name. ...

September 22, 2022 · Updated: September 22, 2022 · 1 min · Nakamura

Registering Resource Classes with Bulk Import and Editing Settings

I have written the following articles about batch registration and updating using Bulk Import. nakamura196.hatenablog.com nakamura196.hatenablog.com Since the above articles did not cover how to register resource classes, I address this here. I also provide supplementary information on how to edit Bulk Import module settings. Registering Resource Classes I have prepared a sample CSV file for registering resource classes at the following link. https://github.com/omeka-j/Omeka-S-module-BulkImport-Sample-Data/blob/main/resource_class/sample.csv The key point is to set the column name to “o:resource_class.” The cell values should be the Term values that can be confirmed in Omeka S. For example, enter values such as dctype:Collection. ...

March 11, 2022 · 2 min · Nakamura