The module adds an Insert Asset button to every CKEditor 4 toolbar in the Omeka S admin interface: HTML page blocks, site settings, and any module that uses Omeka's editor. Nothing needs to be configured.
Inserting an image
- Place the cursor where the image should go.
- Click the Insert Asset toolbar button.
- A modal opens with the same library you see on the Asset Library page: the folder tree on the left, search at the top, and a grid of assets.
- Click an asset to insert it and close the modal.
Images are inserted as <img> tags with the asset's alt text. Because the image2 plugin is enabled, the inserted image is a widget: drag its corner handles to resize it, or use the image dialog to set alignment and a caption.
Non-image assets are inserted as a link to the file using the asset's name.
Link to Image
Tick Link to Image at the bottom of the modal before choosing an asset to insert a text link to the image file instead of the image itself. This is useful for offering a full-size download.
Uploading from the editor
Click Upload inside the modal to add a new file without leaving the page. It is uploaded into the folder currently selected in the modal and appears in the grid ready to insert.
Editors and above can also delete an asset from the modal.
Usage tracking
Each insertion is recorded against the asset with the context ckeditor. The usage list is available through the REST API and is intended to help you find where an asset has been used before deleting or replacing it. It records insertions only; removing an image from a page does not remove the record.