Usage Omeka S module

Choosing Images in Forms

Wherever Omeka S asks for an image, its Select button opens the Insert Asset window instead of Omeka's own list of assets. You get the same folders, search and upload as in the Asset Library, and nothing needs to be configured.

The window replaces Omeka's list for every image field in the admin, including:

  • a site's Thumbnail and Favicon, and the images in a theme's settings, such as a logo or a banner;
  • the Thumbnail of an item, an item set or a media;
  • in the page editor, the assets of an Asset block, a block's Background image under Configure layout, and the image fields of blocks from other modules;
  • the Favicon in the global settings;
  • the image fields of other modules, such as a blog post's Featured image, an announcement's Attachment, and module settings.

Choosing an image

  1. Click Select next to the field.
  2. Find the image: choose a folder on the left, or search by name.
  3. Click the image. The window closes and the field shows the image and its name.
  4. Save the form as usual.

Clear removes the image from the field, as before.

Uploading from the window

Click Upload to add a new image without leaving the form. It goes into the folder you are viewing and appears first in the grid, ready to choose. Upload appears for everyone Omeka S lets add assets.

An asset you may delete shows a × in its corner when you point at it. Authors and reviewers see it on their own assets, editors and above on every asset.

When Omeka's own list appears

If the window can't load the library, for example for someone whose role may not use the Asset Library, Select opens Omeka's own list of assets instead, so the field always works.

Usage tracking

Each choice is recorded against the asset with the context asset-field, as insertions in the editor are recorded with ckeditor. The usage list is available through the REST API, to help you find where an asset has been used before deleting or replacing it. It records choices only: an image chosen in a form that was never saved, or removed later, keeps its record.

Log in for Support