Working with Omeka(.org) and the IIIF Toolkit Plugin

After dabbling with setting up an install of Omeka.org on localhost, we decided that setting it up with a hosting service was a faster and more efficient way to go. We used reclaim hosting, which provides an easy install feature for Omeka Classic already built-in. After a little bit of initial setup we were ready to get started working with Omeka Classic with all the unrestricted functionality.

We knew we needed Plugins to make our Omeka look and behave the way we wanted so we checked out the Omeka documentation for Plugins (https://omeka.org/classic/plugins/) to search for some that might be good. When we had a list of the plugins we wanted and had them downloaded, we had to send them to our file manager on reclaim hosting through our FTP software (I was using FileZilla on Ubuntu, Marc went with Cyberduck for Mac). How to download, install, transfer, and use Plugins is all well documented on the Omeka Classic User Manual and is what we used to get them up and running.

We ran into an issue when attempting to install the IIIF toolkit, one of the tools we were most eager to use. We transferred the plugin over, and when it appeared on the plugin page, clicked “install”. But we received this error message:

Omeka has encountered an error
To learn how to see more detailed information about this error, see the Omeka Codex page on retrieving error messages.

There was a link provided leading us to a page on how to send error messages, but gave no clues as to why the toolkit wasn’t installing properly.

So the first thing to do was find out what there error was, but Omeka disables error reports automatically. To enable error reports, I had to find the .htaccess file in the root directory of our Omeka install and edit the line:

#SetEnv APPLICATION_ENV development

By changing it from a comment (by removing the #) to a line.

I attempted the IIIF toolkit install again and received this error message:

RuntimeException

The configured PHP path (/bin/php) does not point to a PHP-CLI binary.

Now it was just a matter of fixing the problem, which is that our plugin needs to execute code using the command-line version of PHP. I followed the instructions on this forum to fix this problem. 

Leave a Reply

Your e-mail address will not be published. Required fields are marked *.