How to use the audio plugin

This plugin is your audio player on OMA. You can use it to insert audio files from different sources (including YouTube) or for uploading a file yourself, provided there is a Creative Commons licence attached to it.

The player will look like this:

How it works: quick help

This is what the plugin looks like in edit mode:

This is what you can enter / choose:

URL: This is where the address of your audio file goes. Go on Select to pick a file from the OMA media centre or upload one yourself, or copy and paste the URL of another website's audio file.

Playback range: Per default, the file will be played from beginning to end. If it's only about a certain part, you have the option to choose the start and end time of the playback.

Copyright: It is important to make note of the author(s) and/or the source of the file here.

Initial volume: If the audio seems generally to loud, you can tone it down here.

How it works in detail

Link to the audio track of a video, e.g. from YouTube (URL)

If you have the URL of the video already at hand, you can paste it directly to the URL input field. For YouTube videos, copy the URL from the address bar of your browser or click share and copy link below the video. The video URL will automatically be shown in the copyright field.

For example, the following link and information...

... will turn into the follwing player:

Pick a file from OMA media centre or Wikimedia (URL)

Click on Select (next to the URL input).

A dialogue will open. At the top, you'll find the tabs Media centre (this is OMA's storage) and Wikimedia. In both, you can search by typing in tags, and you'll have the option to narrow it down to audio files.

Upload a file to a public document (URL)

In order to upload a file, click the Select button next to the URL input field.

If you're uploading a file while working on a public document, your file will automatically go to the public media center. Please only add files that have a creative commons licence or that you can attach such a licence to yourself.

In the uploading process, the following information will be asked from you:

• Short description (optional): Indicate what the file contains.
• Languages (optional): It may be useful to specify what languages are used if, for example, there is audio description.
• Licences: Specify the licence of the file. (CC0 is equal to the Public Domain. The licence for OMA documents is CC BY-SA: Attribution-ShareAlike.)
• Tags: Insert keywords that will allow users to find the file.

Upload a file to a private room (URL)

When creating a document in a room, you can pick files from the media center or from other websites just as in public documents. Additionally, you can upload files to a room that only room members will be able to see. When you click Select in your plugin, you'll find a third tab for Room media. This is where your files will be stored.

Once you want to publish documents that were private so far (= duplicate in the public area), you'll have to upload these files once more. This may seem cumbersome but will protect you from accidentally publishing material that is protected by copyright.

Determine the playback range

Should only part of an audio track be relevant in your document, or should you want to cut the applaus at the beginning of a concert, you can determine when exactly the playback starts and ends.
It looks like this:

Pick a position on your timeline

• via playing the track and hitting pause at right time
• or by clicking directly onto the timeline.

You can define this position as Start time or as End time. For fine tuning, use the minus and plus buttons to move the position by 100 or 500 milliseconds.

Copyright

Use this input field to provide metadata such as author, image title, source and licence.
To the bottom right you'll find the M↓ symbol that opens a quick help on formatting your text with Markdown.