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:
- Accepts a zip file containing images and a CSV with image metadata.
- 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.
Before using this plugin ensure:
- Omeka-S is installed.
- The Any Cloud module is installed and configured.
- The CSV Import module is installed.
-
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 "ZipImporter" if it's not already named as such.
- Open a terminal, navigate to the "ZipImporter" folder, and run
composer install
.
-
Update php.ini:
- Find your php.ini file with
php -r "phpinfo();" | grep php.ini
. - 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.
- Find your php.ini file with
-
Check PHP Limits:
- In the Omeka-S Dashboard, click "System Information" in the lower right to ensure PHP limits are updated.
-
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.
- Click on "Zip Import" and upload your zip file containing images and CSV
-
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.
Thank you for considering contributing to the Fisk-Rosenwald-Zip-to-Bulk-Import! Contributions help improve and grow the functionality of the plugin.
Before May 2025: If you encounter any issues, have questions, or want to suggest enhancements, please open an issue on the GitHub Issues page. Provide detailed information about the problem, including steps to reproduce it.
After May 2025: If you encounter any issues, have questions, or want to suggest enhancements, unfortunatly this project will be closed and no further edits will be made on our end. We encourage you to take the reins with a clone or fork of your own.
Feel free to open an issue if you have a feature request. Describe the new functionality you're proposing and how it would benefit users.
We GREATLY welcome pull requests that address issues or bring new features to the Fisk-Rosenwald-Zip-to-Bulk-Import. To submit a pull request:
- Fork the repository to your GitHub account.
- Create a new branch for your changes.
- Make your changes and commit them with clear messages.
- Push your branch to your fork.
- Open a pull request on the GitHub Pull Requests page.
We have yet to set any standards/patterns, so just keep it clean and consistant. If your pull request is related to an existing issue, reference the issue number in your pull request description.
Kindness, respect, love.
Thank you for contributing!
This project is licensed under the GNU General Public License version 3.0 (GPL-3.0). See the LICENSE.md file for details.