The module has no settings page of its own. It follows the configuration Omeka S already has for assets.
| Behaviour | Where it is controlled |
|---|---|
| Allowed file types | Omeka's global Settings > Security media upload settings. The library itself offers JPEG, PNG, GIF and WebP. |
| Maximum upload size | Your PHP upload_max_filesize and post_max_size values. |
| Where files are stored | Omeka's configured file store (local files/asset/ by default, or S3 and similar). |
| Thumbnails | Not generated by this module. Assets are served at their original size, as in core Omeka S. |
Permissions
Assets follow Omeka S's own rules, so people can do in the library what Omeka's Assets pages let them do. Authors upload and change or delete the assets they own (the ones they uploaded). Reviewers can also change anyone's assets, but delete only their own. Editors and above can do everything. Folders belong to the module, and only editors and above create, rename and delete them.
| Role | Browse and search | Upload | Edit, move and replace an asset | Delete an asset | Manage folders | View usage |
|---|---|---|---|---|---|---|
| Author | ✓ | ✓ | Own | Own | — | ✓ |
| Reviewer | ✓ | ✓ | Any | Own | — | ✓ |
| Editor | ✓ | ✓ | Any | Any | ✓ | ✓ |
| Site Admin | ✓ | ✓ | Any | Any | ✓ | ✓ |
| Global Admin | ✓ | ✓ | Any | Any | ✓ | ✓ |
Each person sees only the buttons they can use. An asset they may not change opens read-only, and its Delete Asset button appears only if they may delete it. In the grid, the selection checkbox appears on assets they may change or delete. The bulk Edit and Move to folder buttons appear when they may change every selected asset, and Delete when they may delete every one.
Researchers do not see the Asset Library menu entry, and opening the page shows them Omeka's Forbidden page (HTTP 403). The same rules apply to the JSON API, so a script authenticated as an author cannot create folders or change someone else's asset: refused requests get HTTP 403 with {"status": "error", "message": "Access denied."}.
CKEditor and image fields
The Insert Asset button is added automatically to every CKEditor 4 instance on admin pages, including page blocks, site settings and any module that uses Omeka's CKEditor helper. No theme or configuration changes are needed.
The Select button of Omeka's image fields opens the same window instead of Omeka's own list of assets, on every admin page. See Choosing Images in Forms.
The module also enables CKEditor's image2 plugin so that inserted images become widgets with resize handles and alignment controls. If you have customised the CKEditor toolbar elsewhere, the Insert Asset button is appended as its own toolbar group.