DokuWiki

It's better when it's simple

User Tools

Site Tools


Sidebar

Translations of this page?:

Learn about DokuWiki

Advanced Use

Corporate Use

Our Community


Follow us on Facebook, Twitter and other social networks.

media_manager

The Media Manager

Images and other media files can be uploaded and inserted through a simple media manager. To open the media manager click the button in the page editing toolbar. When you like to manage media, but have no need for inserting media links, you can use the fullscreen mediamanager too.

Browse the available namespace by clicking their name in the left pane. Namespaces can be expanded by a click on the + button right next to the namespace name.

To insert an image at the current cursor position in the edit window, just click the file name or image thumbnail in the right pane.

Just use the upload form at the top right to upload a file. Optionally you can give a new name for the file. Be sure to keep the file extension correct! If you use new namespaces in the name these will be created automatically.

Please note: If the administrator enabled ACL support, upload may be restricted to certain users. Users without the proper permission will not see the upload form

Configuration

First you need to check “file_uploads” on php.ini and verify it is positioned at On.

If you want to upload a file and get a “Upload denied. This file extension is forbidden!” message, you should change the mime configuration.

If /tmp folder on your server is mounted with the “noexec” option mediamanager fails to upload files. You need to modify the “upload_tmp_dir” on php.ini (globally) or in .htaccess

Layout

The Media Manager

The screenshot on the right shows the media manager.

The left part has the name space tree (1) where you can navigate through the existing media namespaces. Media namespaces are separated from the page namespaces but usually follow their structure. You can use the + and - icons to collapse and expand deeper hierarchies. Clicking the namespace name will open it in the right side.

Above the tree are some option checkboxes (2) which influence the behavior of the manager. By default the manager will close when an image was selected. Sometimes this is not wanted, eg. if you like to insert multiple images, you can disable the automatic closing here. If you need a better overview in the right pane, you can hide the details for the media listing. Both options are stored in a cookie and will be remembered by your browser.

The top headline of the right pane always shows the currently selected namespace (3). All uploads you do will be put into this namespace.

Below the headline is the upload form (4). Note that this form will only be displayed if you have the needed permissions to upload in the current namespace. You can rename the file you are about to upload with the second text field. To create subnamespaces just prepend them to the name here. Which file extensions may be uploaded is configured through the mime settings. On compatible browsers an icon to activate the multiuploader is shown here as well.

Below the uploadform comes a listing with available mediafiles. For each file there is a line with a file type icon, the file name, and some toolbar buttons (5). The following buttons may be available depending on the file type and your permissions:

View or download the file
Delete the file
Edit the metadata of the file (JPEG only)

The file may be followed by a thumbnail (6) and a preview of the metadata (7). EXIF metadata editing is currently only supported for JPEG files.

Problems

My users don't seem to be able to upload files

When they haven't the UI for adding media, it's probably a permission problem. See the ACL manager please, here you set upload and remove permissions, for media you need to set them for the wanted namespaces.

How to enlarge Maximum upload size?

How to create media namespaces?

Creating a new namespace is easy, just prepend your new namespace name to the filename. e.g. :documents:yourfilenamehere.doc creates new namespace documents.

When you want to create the namespace in your filesystem look for the directory data/media/.

How to remove media namespaces?

Remove all content within it and it will be removed for you.

Can i give users overwrite option without delete permissions?

No. By using overwriting you can do the same as by deleting.

How do i manage hundreds and more of images?

When a flat organisation is not enough you can introduce extra namespaces in your current media namespace. It's fine to have media namespaces that don't exist as page namespaces.

My server settings are too restrictive, can i use a traditional uploader?

At the moment this isn't possible.
Either there is a no-javascript failback and FS#2406 is about implementing this as option.

media_manager.txt · Last modified: 2014/02/06 17:44 by 72.237.48.100