In order to upload images, install themes and plugins, and make them work properly, some setup is required after installing Omeka Classic. Below are some areas you will need to set up to get your site up and running.
ImageMagick
Omeka requires the ImageMagick library in order to resize and generate thumbnails for your images. The setting for this is located under the Settings > General tab and the path to ImageMagick is /usr/bin
Uploading Plugins/Modules and Themes
Omeka provides a variety of open source plugins, modules, and themes on their website available for download. It's worth noting that Omeka Classic refers to their extensions as "Plugins" while Omeka S refers to them as "Modules" but they're essentially the same thing. At this time, there also isn't an automated process for loading these extensions into your Omeka installation from the admin interface.
Here’s how to make them available on your installation:
- In cPanel you’ll be using the File Manager utility to navigate to the appropriate folder and upload the files. You’ll either find a plugins or a modules folder, in addition to a themes folder. Inside of those folders are the plugins/modules and themes for your installation.
- Adding a new one is as easy as uploading a zipped file and extracting it using the built-in tools of the File Manager. You can find a more detailed guide of this process here.
Fixing Background PHP Path
Some plugins for Omeka a, such as the CSV Import, Neatline and OHMS Import will require that you explicitly specify the background PHP path in order to work properly, as these plugins require PHP-CLI.
- Start by checking the MultiPHP Manager in your cPanel.
- In the PHP Version column, you’ll see something along the lines of
PHP 8.1 (ea-php81), which means you are using PHP 8.1. This is the PHP version you’ll need to specify as the background.php path in your Omeka config files. The paths for the PHP versions we offer are as follows:
- PHP 7.3 →
/usr/local/bin/ea-php73
- PHP 7.4 →
/usr/local/bin/ea-php74
- PHP 8.0 →
/usr/local/bin/ea-php80
- PHP 8.1 →
/usr/local/bin/ea-php81
- In the File Manager, find the setting named
background.php.path and you’ll find it in: $OMEKA_ROOT/application/config/config.ini
Questions?
If you have any questions or run into any issues, please use the Report Issue button (located at the top-right) and select Academic website request (CarlSites) under Website Request Type
Acknowledgement
Created by Em Palencia, 9/19/2023