Investigating PLY Files Not Being Output in IIIF Manifest Items with Omeka S IIIF Server Module

Overview I investigated an issue where PLY files were not being output as items in IIIF manifests by the Omeka S IIIF Server module, while GLB files were output correctly. Prerequisites: Omeka S Configuration By default, PLY files cannot be uploaded to Omeka S. The following configuration is required. Error When Uploading PLY Files With default settings, upload errors occur because the PLY file’s media type (application/octet-stream) and extension (.ply) are not permitted. ...

February 6, 2026 · 10 min · Nakamura

Achieving Japanese Full-Text Search with the MroongaSearch Module for Omeka-S

Introduction Omeka-S is a powerful digital archive system, but by default, Japanese full-text search barely functions. This article explains how to achieve Japanese full-text search by introducing the MroongaSearch module. Why the MroongaSearch Module is Essential Problems with Omeka-S Standard Search Omeka-S’s standard full-text search (FullTextSearch module) uses the InnoDB engine, which has the following critical issues: Example of Japanese word search: D S R a e e t a s a r u : c l h t " : 東 t 京 e ❌ 大 r 学 m N で : o 人 工 " h 知 人 i 能 工 t を 知 s 研 能 究 " す る " Since InnoDB’s full-text search assumes space-delimited languages like English, for Japanese: ...

October 2, 2025 · 22 min · Nakamura

Omeka S Module Update Information (2025-03-27)

Overview This article introduces modules that required updates during the operation of Omeka S. IIIF Server https://omeka.org/s/modules/IiifServer/ I had been using version 3.6.18, released in February 2024, but a bug was found where thumbnail images were rendered incorrectly during IIIF manifest file generation. After updating to the latest version 3.6.24 as of March 2025, this bug was resolved. Note that this update also required updating the Common module, so I hope this information is helpful. ...

March 27, 2025 · 1 min · Nakamura

Sharing Private Sites in Omeka S

Overview I had the opportunity to share a private site in Omeka S, so this is a personal note for future reference. Related Modules First, I checked the following module. https://omeka.org/s/modules/Guest/ The above also introduces the Guest Private module, and I asked ChatGPT about how to differentiate between them. Here is an explanation of the differences between the Guest module and the Guest Private module in Omeka S. 1. Guest Module Adds the guest role, allowing users to register as guest users. No access to the admin panel. Login, logout, registration, password update, etc. are possible via API. Only public sites are viewable (private sites and private pages cannot be seen). Use case: Register general users on a public site and provide login functionality. 2. Guest Private Module Adding this module provides two additional roles: ...

March 13, 2025 · 2 min · Nakamura

Specifying Viewing Direction in the Omeka S IIIF Server Module

Overview Here is how to specify the viewing direction in the IIIF Server module for Omeka S. In IIIF, you can use the viewingDirection property to specify the viewing direction of manifests and canvases. Module Configuration /admin/module/configure?id=IiifServer In the IIIF Server module settings page, find the “viewing direction” section. You can specify a property with Property to use for viewing direction, and you can also set a default viewing direction. ...

December 3, 2024 · 1 min · Nakamura

Linking to Other Items Using the Custom Vocab Module in Omeka S

Overview I had an opportunity to link to other items using the Custom Vocab module in Omeka S, so here are my notes. Background The following article explained how to use custom vocabularies. This time, instead of strings or URIs, I will try linking items. Creating an Item Set First, create an item set to store the items to be linked. In this case, I created an item set called “Reuse Condition Display.” ...

November 4, 2024 · 2 min · Nakamura

Exporting Only Specific Items and Selected Fields Using Omeka S BulkExport

Overview This article introduces how to export only specific items with selected fields using Omeka S BulkExport. Here, we will limit the export to items that have “Table Of Contents (dcterms:tableOfContents)” and export only “Title (dcterms:title)” and “Identifier (dcterms:identifier)”. Related The following article explains the overview of the Omeka S BulkExport module. This time, I will explain based on a specific use case. Method Navigate to the following path. ...

July 31, 2024 · 1 min · Nakamura

Retrieving the URL of Site Pages Where Items Are Published in the Omeka S OaiPmh Repository Module

Overview This is a personal note on how to retrieve the URL of site pages where items are published in the Omeka S OaiPmh Repository module. Background The following article introduces how to create custom vocabularies using OaiPmhRepository. https://nakamura196.hatenablog.com/entry/2021/07/25/222651 Please refer to it as well. Retrieving the URL of Site Pages Where Items Are Published Before Fix In a certain customization case, the site page URL was retrieved as follows. This does not work properly when something other than dcterms:identifier is configured in the Clean URL module. Additionally, hardcoded paths like /s/db/record/ can be seen. ...

July 14, 2024 · 3 min · Nakamura

Adding Classes and Properties Using the Omeka S CustomOntology Module

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. For basic usage of this module, please refer to the following. https://nakamura196.hatenablog.com/entry/2021/07/24/235050 For how to update vocabularies that have already been created using this module, please refer to the following. This article explains how to add classes and properties to an already created vocabulary. ...

June 17, 2024 · 2 min · Nakamura

Released v4.1.0 of Omeka-S-module-FixCjkSearch

Overview To address the issue where full-text search in Japanese does not work well with Omeka S’s standard functionality, I have created the following module. https://github.com/nakamura196/Omeka-S-module-FixCjkSearch This module had stopped working with the latest version of Omeka S at the time of writing (v4.1.0), so I released an updated version of the module. https://github.com/omeka-j/Omeka-S-module-FixCjkSearch/releases There may be some incomplete aspects, but I hope this serves as a helpful reference. References For information about full-text search issues with Japanese, please also refer to the following article. ...

June 17, 2024 · 1 min · Nakamura

Partial Match Search with the Advanced Search Module in Omeka S

Overview This article explains how to perform partial match searches using filters added through the Advanced Search module. In the example above, the query string “toru” matches items with the title “abc title”. Background The Advanced Search module allows you to flexibly configure search conditions and facets. https://omeka.org/s/modules/AdvancedSearch/ In particular, when combined with the “Reference” module, faceted search like the following can be achieved. You can also add filters. However, when performing partial match searches with filters, additional configuration is required. ...

April 17, 2024 · 2 min · Nakamura

Specifying Items to Display in Omeka S Search Results

Overview This article explains how to specify which items to display in search results, as shown below. Configuration In the default settings, the “Heading” displays the title (dcterms:title) and the “Body” displays the description (dcterms:description), as shown below. You can configure which items to display for “Heading” and “Body” respectively by changing the following section in the per-site settings screen. For Advanced Search Even when using the Advanced Search module, these settings are inherited. ...

April 17, 2024 · 6 min · Nakamura

Troubleshooting the CleanUrl Module Installation in Omeka S

Overview When attempting to install the Clean Url module on Omeka S built with the following environment: PHP Version: 8.3.2 Omeka S Version: 4.0.4 Clean Url Version: 3.17.7 The following message was displayed: D e p r e c a t e d : C r e a t i o n o f d y n a m i c p r o p e r t y C l e a n U r l \ R o u t e r \ H t t p \ C l e a n R o u t e : : $ p r i o r i t y i s d e p r e c a t e d i n v a r / w w w / h t m l / v e n d o r / l a m i n a s / l a m i n a s - r o u t e r / s r c / S i m p l e R o u t e S t a c k . p h p o n l i n e 2 8 5 To address this issue, the above message could be hidden by partially modifying the /modules/CleanUrl/src/Router/Http/CleanRoute.php file as described below. ...

March 19, 2024 · 2 min · Nakamura

File Sideload: Batch Uploading Images to Omeka S

Overview This article explains the “File Sideload” module for batch uploading images to Omeka S. https://omeka.org/s/modules/FileSideload/ The official manual is available at the following URL: https://omeka.org/s/docs/user-manual/modules/filesideload/ Module Installation It can be installed using the standard method. https://omeka.org/s/docs/user-manual/modules/#installing-modules Module Configuration After installation, you will be navigated to the following configuration screen. Here, specify the path to the folder for uploading images for batch registration. Depending on permissions, you should be able to specify any arbitrary path. ...

March 14, 2024 · 1 min · Nakamura

Omeka S Bulk Import Module: Usage Guide (February 2024 Edition)

Overview Bulk Import is a module for batch registration of items and media in Omeka S. https://github.com/Daniel-KM/Omeka-S-module-BulkImport It has been continuously updated and has become quite convenient, so this is a memo. Installation It can be installed in the usual way. However, the Log module must be installed beforehand. https://github.com/Daniel-KM/Omeka-S-module-Log Usage Here, I will introduce an example of registration using a CSV file. Configuration First, access the following and click the edit icon. ...

February 7, 2024 · 3 min · Nakamura

Workaround When Presentation API v2 Manifests Cannot Be Displayed in Mirador 3

Overview When loading a Presentation API v2 manifest file like the following into Mirador 3, a display error occurred. https://gist.githubusercontent.com/nakamura196/42fb6bca6a9fa137234c334cb313fc58/raw/4188ebccb7406ff5132331a4fecc4ace8bdd7ebc/ng.json Below is the display in Mirador 3. I investigated the cause and workaround, and am sharing the findings here. Cause The following error message was displayed. Despite providing IIIF v2 input, it appeared to be interpreted as v3. E r r o r a a a a a a a a a a : t t t t t t t t t t A P A t t c i h i h F r r . . a n n u I o r p g n d ( d ( n I p a a e v e d e d c I e y r t a x e x e t F r . s L s . f . f i t m e a e j a j a o v y a b s s u s u n 3 V p ( e . : l : l . a P l j 6 t 8 t m l l r s 7 M 1 M a o u < o ( : : e : e p c e a p M 1 2 m 4 m T a . n e a 6 5 o 0 o o l t o r n 2 i i P i s n t i : z z r z : y y f 1 e e o e 1 m V e 2 . . p d 2 o a s j j s 6 u l t s s p : s u R : : ( r 2 > e e 1 1 O o 0 ) . s 2 2 p p t o 3 3 e e s u : : n r : r 2 2 S t 1 c 0 0 e y 2 e ) ) a 3 . d v : t r a 2 s a l 9 : g u ) 3 o e 5 n : V m 2 i u 8 e s ) w t e r h . a j v s e : 3 a 9 n : 1 a 2 r ) r a y a s t h e v a l u e f o r a g i v e n l a n g u a g e . This appeared to occur when the canvas label was written in object format, as shown below: ...

February 6, 2024 · 5 min · Nakamura

Updating the IIIF Viewers Module for Omeka S

Overview IIIF Viewers is one of the modules for Omeka S. https://github.com/omeka-j/Omeka-S-module-IiifViewers The latest release is available here: https://github.com/omeka-j/Omeka-S-module-IiifViewers/releases/latest I made several updates this time, so this is a memorandum. Universal Viewer Version Update I updated Universal Viewer to v4.0.25. Additionally, I documented how to update Universal Viewer in the following section of README.md: https://github.com/omeka-j/Omeka-S-module-IiifViewers?tab=readme-ov-file#compilation-of-universal-viewer This was based on the documentation in the following module: https://github.com/Daniel-KM/Omeka-S-module-UniversalViewer I also documented how to update Mirador, but since the latest version was already installed, no update was performed. ...

February 5, 2024 · 6 min · Nakamura

[Omeka S Module Introduction] BulkExport: Adding Export Functionality to Item Detail Pages

Overview In the following article, I introduced how to bulk export data using the BulkExport module. This module also provides functionality to display an export button on item detail pages. I will introduce how to use this feature. Usage The installation method is the same as for general modules. It is also briefly explained in the article above. After activating the module, export links in various formats are displayed on item detail pages as shown below. ...

October 17, 2023 · 8 min · Nakamura

[Omeka S Module Introduction] Scripto: Performing Transcription and Translation

Overview This article introduces “Scripto,” an Omeka S module that enables transcription and translation of media (images, etc.) registered in Omeka S. https://omeka.org/s/modules/Scripto/ Installation The installation of this module itself is the same as for other standard modules. However, in addition to installing this module, you need to set up MediaWiki. If your environment already runs Omeka S, it should have the necessary components for setting up MediaWiki. Download and set up MediaWiki using commands like the following: ...

July 20, 2023 · 3 min · Nakamura

[Omeka S Module Introduction] IiifPresentation: Adding IIIF Presentation API

Overview I tried the IiifPresentation module that adds IIIF Presentation API support, so here are my notes. https://omeka.org/s/modules/IiifPresentation/ As far as I could tell from a brief trial, there did not seem to be a significant difference from the features provided by the IIIF Server module below. https://omeka.org/s/modules/IiifServer/ One difference is that this module was developed by the Omeka Team, and it has the advantage of being usable without detailed configuration. ...

July 20, 2023 · 2 min · Nakamura