Custom Maps (module for Omeka S)

Description

Custom Maps is an Omeka-S module for creating, georeferencing, and managing IIIF-powered maps directly within Omeka-S. Transform image media from Omeka items into interactive, annotatable maps using the AllMaps online editor, with future support for a local editor.

Features

• 🗺️ Georeference IIIF images as maps with AllMaps' web-based tools.
• 📦 Curate map collections from Omeka items (supports image media).
• 🌍 Export as layers for Leaflet, OpenLayers, or other web map viewers.
• 🔍 Explore maps with zoom/pan controls and annotation support.
• ⚙️ Future-ready: Planned integration for a self-hosted editor.

Use Cases

• Digital humanities projects needing historical map overlays.
• Exhibitions combining IIIF art and cartography.
• Libraries/archives geolocating scanned maps with IIIF.

Designed for Omeka-S, built for interoperability

Installation

See general end user documentation for installing a module.

This module requires the module Common, that should be installed first.

• From the zip

Download the last release CustomMaps.zip from the list of releases, and uncompress it in the modules directory.

• From the source

If the module was installed from the source, rename the name of the folder of the module to CustomMaps. Execute, at Omeka-S root, the following shell commands:

php application/data/scripts/update-db-data-module.php CustomMaps

cd modules/CustomMaps/asset
npm i

Access to server's php command line utility is required (if the server already runs Omeka-S, it should be already installed), as well as npm (node.js package manager).

Config

Any online web editor compliant with AllMaps could be used as internal editor, if wanted; just set the editor URL in the configuration.

Warning

Use it at your own risk.

It’s always recommended to backup your files and your databases and to check your archives regularly so you can roll back if needed.

Troubleshooting

See online issues on the module issues page on GitHub.

License

Module

Omeka-s/CustomMaps is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

Omeka-s/CustomMaps is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with Omeka-s/CustomMaps. If not, see http://www.gnu.org/licenses/.

Copyright

See commits for full list of contributors.

• Copyright(c) 2025 MarcosHCK

This Omeka-S module draw inspiration of Custom Vocab and Mapping modules, even extending Mapping module functionality.