Skip to content

Adding Media to an Item

Example

media-example.png

Naming

When naming media files, prefix the the title with the name of the item it belongs to, followed by a dash, then an optional description.

Warning

If you title media during the upload process, and you are uploading multiple files, it will name each of those files that same title name. Not titling the media during upload, will default to the name of the file. You can always come back to the media afterwards and rename it if you wish.

Uploading from a browser

broswer-upload.webp

For most cases, you'll select "Upload" from the right hand side, and upload the file from your computer.

Sideloading

This is for Organizers

If you're using the bulk upload process to mass dump files and intend for them to be sorted later, we want to indicate to others that each media file is not sorted and set the item to private (little gray eye icon at the top right) so it cannot be viewed by the public.

## Directory Structure
├── COLLECTION- Government
│   ├── Big Brother
│   │   ├── Censorship
│   │   ├── ICE Raids and Detention
│   │   ├── Intrusive Surveilance
│   │   ├── Liz Oyer case
│   │   ├── Loyalty and Retaliation
│   │   ├── Naval Academy Removes Books
│   │   └── Travel and Borders
│   ├── CBP
│   ├── CIA
│   │   ├── Declassified President Daily Briefs and Press Releases
│   │   └── Former Detention and Interrogation Program
. . .

Scenario 1: Folder as an Item with no sub-directories

Intent

dropbox/COLLECTION- Government/Big Brother/Liz Oyer case will be an item. There are no subdirectories in the Liz Oyer case directory.

Requirements

  1. The item set COLLECTION - Government exists.
  2. The item set COLLECTION - Government - Big Brother exists.

Action to Take

  1. Create the New Item.

  2. Sideload directory:

    Field Value
    Title Liz Oyer case
    Directory dropbox/COLLECTION- Government/Big Brother/Liz Oyer case
    Ingest recursively unchecked

Result

An item will be created with the title Liz Oyer case and all files in the Liz Oyer case directory will be added to the item.

If a title is set, all media will be named that title, otherwise the media will be named like dropbox/COLLECTION- Government/Big Brother/Liz Oyer case/Liz-Oyer-Hearing-Statement-4.7.25.pdf

In the backend, the media will be located at /srv/omeka-s/files/original/gov_bigbrother/Liz_Oyer_case

Risk

This will create an item that contains all files in the Liz Oyer case. No risk of loosing files.

Scenario 2: Folder as an Item with sub-directories

Intent

dropbox/COLLECTION- Government/Big Brother/Naval Academy Removes Books will be an item. There are subdirectories in the Naval Academy Removes Books directory.

Requirements

  1. The item set COLLECTION - Government exists.
  2. The item set COLLECTION - Government - Big Brother exists.

Action to Take

  1. Create the New Item.

  2. Sideload directory:

    Field Value
    Title Naval Academy Removes Books
    Directory dropbox/COLLECTION- Government/Naval Academy Removes Books
    Ingest recursively Checked

Result

An item will be created with the title Naval Academy Removes Books and all files in the Naval Academy Removes Books directory and all subdirectories will be added to the item.

If a title is set, all media will be named that title, otherwise the media will be named like dropbox/COLLECTION- Government/Big Brother/Naval Academy Removes Books/250404-List of Removed Books from Nimitz Library.xlsx.pdf in addition, the files in subdirectories will have that subdirectory name in it's title, like dropbox/COLLECTION- Government/Big Brother/Naval Academy Removes Books/subfolder/item.pdf.

In the backend, the media will be located at /srv/omeka-s/files/original/gov_bigbrother/Naval_Academy_Removes_Books

Risk

If you do not check "Ingest recursively", it will only add the files in the Naval Academy Removes Books directory, and not the files in any subdirectories. This is potentially dangerous. The subdirectories and their files risk being deleted.

Scenario 3: Folder as a Nested Sub-Collection - to be segmented later

Intent

dropbox/COLLECTION- Government/Big Brother/Censorship will be an item-set. You do not want to create the sub-collection yet, but intent is to create it later.

Requirements

  1. The item set COLLECTION - Government exists.
  2. The item set COLLECTION - Government - Big Brother exists.

Action to Take

  1. Create the New Item.

  2. Sideload directory:

    Field Value
    Title Censorship
    Directory dropbox/COLLECTION- Government/Censorship
    Ingest recursively Checked

Result

An item will be created with the title Censorship and all files in the Censorship directory and all subdirectories will be added to the item.

The same title convents apply.

In the future, you can create a new item set called COLLECTION - Government - Big Brother - Censorship and have somone process each media file in the temporary item migrated to their own items in the new item set.

In the backend, the media will be located at /srv/omeka-s/files/original/gov_bigbrother/Censorship

Risk

Same as before. If you do not check "Ingest recursively", the subdirectories and their files risk being deleted.

Scenario 4: Folder as a Nested Sub-Collection - With contents as an Item

Intent

dropbox/COLLECTION- Government/Big Brother/Intrusive Surveilance will be an item-set. You want to create a new item set, and add the folder's contents to it.

Requirements

  1. The item set COLLECTION - Government exists.
  2. The item set COLLECTION - Government - Big Brother exists.

Action to Take

  1. Create the new item set per the Sub-Collection tutorial.
  2. Create the New Item.

  3. Sideload directory:

    Field Value
    Title Intrusive Surveilance
    Directory dropbox/COLLECTION- Government/Intrusive Surveilance
    Ingest recursively Checked

Result

A new item set name COLLECTION - Government - Big Brother - Intrusive Surveilance was created. A new item in said item set was created with the title Intrusive Surveilance and all files in the Intrusive Surveilance directory and all subdirectories will be added to the item.

The same title convents apply.

In the future, someone will process each media file in the temporary item to be their own items in the presently created item set.

In the backend, the media will be located at /srv/omeka-s/files/original/gov_bigbrother_IntrusiveSurveilance/Intrusive Surveilance

Risk

Same as before. If you do not check "Ingest recursively", the subdirectories and their files risk being deleted.