Omeka-S Zip Import / Batch Upload Plugin

The Omeka-S Bulk Upload Plugin streamlines the process of bulk uploading digital objects and metadata to Omeka-S. Follow these steps to use the plugin after installation:

Features

Accepts a zip file containing images and a CSV with image metadata.
Accepts nested files for items with multiple images/PDFs (see [GitHub Sample Upload Structure.zip] (https://github.com/Fisk-University/ZipImport/blob/main/GitHub%20Sample%20Upload%20Structure.zip) )
Automates the creation of digital objects in Omeka-S.
Supports uploading digital objects to local or cloud storage.
Returns original CSV with each object upload location populated in a new column.

Prerequisites

Before using this plugin ensure: - Omeka-S is installed. - The Any Cloud module is installed and configured. - The CSV Import module is installed.

Installation

Download: Obtain the plugin by downloading the zip file here.
Installation:
Add the zip to the Omeka-S modules folder and unzip it.
Rename the unzipped folder to "ZipImport" if it's not already named as such.
Open a terminal, navigate to the "ZipImport" folder, and run composer install.
- Sudo or appropriate permissions may be necessary
Update php.ini:
Find your php.ini file. Make a phpinfo page Apache can serve echo "<?php phpinfo();" | sudo tee /var/www/html/info.php
Ask Apache for it and grep the two lines we need curl -s http://127.0.0.1/info.php | grep -E "Server API|Loaded Configuration File|Additional .ini files parsed"
Adjust the following fields: upload_max_filesize = 1000M max_file_uploads = 100 post_max_size = 1000M
Restart your server with service apache2 restart or the relevant command.
Restart php with systemctl restart php or the relevant command.
Check PHP Limits:
In the Omeka-S Dashboard, click "System Information" in the lower right to ensure PHP limits are updated.

Usage

Navigate to "Zip Import" in the Dashboard.
Find the "Zip Import" option in the lower left of the Omeka-S Admin Dashboard.
Upload your zip file.
Click on "Zip Import" and upload your zip file containing images and CSV
- Sample of zip
- Note: CSV must be UTF-8 encoded when saved
Recommended: Tick the "Automap with simple labels" box.
Verify your mapping and click Import.
Confirm that your mapping is correct.
Click the "Import" button to start the bulk upload process.
Upload and Populate:
Relax as the plugin populates your Omeka-S instance and storage.
Verification:
Confirm that the items are successfully uploaded by checking RESOURCES > Items, and by checking your chosen storage location.
OPTIONAL: Download the updated CSV
Go to MODULES > CSV Import > Past Imports to locate the CSV file updated with storage locations.

License

This module is published under the Server Side Public License (SSPL-1.0).

Built with ❤️ by Archatomic, LaTaevia Berry, & Sai Kiran Boppana for Fisk University and HBCUs nationwide