====== 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 {{https://www.dokuwiki.org/lib/images/toolbar/image.png?nolink}} button in the page editing [[toolbar]]. When you want 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 ===== {{ wiki:mediamanager.png?nolink&400|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 [[namespaces|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 you can drag-and-drop files into the pop-up window and upload [[multiuploader|multiple files]] 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: | {{http://www.dokuwiki.org/lib/images/magnifier.png?nolink}} | View or download the file | | {{http://www.dokuwiki.org/lib/images/trash.png?nolink}} | Delete the file | | {{http://www.dokuwiki.org/lib/images/pencil.png?nolink}} | Edit the [[exif|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?=== See [[faq:uploadsize|FAQ: Maximum Upload File 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 [[http://bugs.dokuwiki.org/index.php?do=details&task_id=2406|FS#2406]] is about implementing this as option. === How to move media files to another namespace === You may consider using the [[plugin:move|Move plugin]] === How to hide the media manager link when a user is not registered or only have view access (default template) === see [[http://stackoverflow.com/questions/15589912/dokuwiki-how-can-i-hide-media-manager-link-from-non-logged-in-users]]