# Media Manager ## Media Manager The Media manager is a WEB UI to be able to interact with your Media. You can access the Media Manager from the Admin Menu under Content, in addition to buttons within different Content Editors. ![Media Manager is listing under Content in the ContentBox CMS Admin](https://1193444366-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LA-UVvYQ9YKIVXFz01w%2F-LA-UcIjNIclM_mn00Gl%2F-LA-Urs-cV-YF--W-rc9%2Fcbcms_mediamanager_menu.jpg?generation=1523648005974754\&alt=media) The Media Manager has many options, but by default will look like the image below. ![Media Manager U View](https://1193444366-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LA-UVvYQ9YKIVXFz01w%2F-LA-UcIjNIclM_mn00Gl%2F-LA-Urs4v6E0LR8JiTX3%2Fcbcms_mediamanager_view1.jpg?generation=1523648005996462\&alt=media) ### Icons ![Media Manager Icon - Refresh Listing](https://1193444366-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LA-UVvYQ9YKIVXFz01w%2F-LA-UcIjNIclM_mn00Gl%2F-LA-UrsAmDoJ3yzQnhQT%2Fcbcms_mediamanager_icon_refresh.jpg?generation=1523648005850318\&alt=media) Refresh Listing - Refreshes the current folder location ![Media Manager Icon - Go Home](https://1193444366-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LA-UVvYQ9YKIVXFz01w%2F-LA-UcIjNIclM_mn00Gl%2F-LA-UrsGtYQokykDJ16n%2Fcbcms_mediamanager_icon_home.jpg?generation=1523648006014556\&alt=media) Go Home - Return to the Home ( Root ) directory of the current library ![Media Manager Icon - Create Folder](https://1193444366-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LA-UVvYQ9YKIVXFz01w%2F-LA-UcIjNIclM_mn00Gl%2F-LA-UrsKZjub0oD-FNPd%2Fcbcms_mediamanager_icon_create.jpg?generation=1523648005988995\&alt=media) Create Folder - Create a new folder in the current location ![Media Manager Icon - Rename](https://1193444366-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LA-UVvYQ9YKIVXFz01w%2F-LA-UcIjNIclM_mn00Gl%2F-LA-UrsP0cBytXy_pZ1c%2Fcbcms_mediamanager_icon_rename.jpg?generation=1523648005842943\&alt=media) Rename - Rename the currently selected File or Folder ![Media Manager Icon - Delete](https://1193444366-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LA-UVvYQ9YKIVXFz01w%2F-LA-UcIjNIclM_mn00Gl%2F-LA-UrsV1weGWnQJ-4f6%2Fcbcms_mediamanager_icon_delete.jpg?generation=1523648006472842\&alt=media) Delete - Delete the currently selected File or Folder ![Media Manager Icon - Upload](https://1193444366-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LA-UVvYQ9YKIVXFz01w%2F-LA-UcIjNIclM_mn00Gl%2F-LA-UrtDsewmEBP9ziup%2Fcbcms_mediamanager_icon_upload.jpg?generation=1523648005884763\&alt=media) Upload - Brings up the Upload form, to allow you to select a file to upload. Remember, Media Manager also allows HTML5 styled uploading, so you can drag file(s) into the media manager to upload them. Folder Uploading is not supported in this version, but will be added in an upcoming update. ![Media Manager Icon - Download](https://1193444366-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LA-UVvYQ9YKIVXFz01w%2F-LA-UcIjNIclM_mn00Gl%2F-LA-UrtMuHpPw2JVLvXf%2Fcbcms_mediamanager_icon_download.jpg?generation=1523648005830685\&alt=media) Download - Download the currently selected file. ![Media Manager Icon - Quick View](https://1193444366-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LA-UVvYQ9YKIVXFz01w%2F-LA-UcIjNIclM_mn00Gl%2F-LA-UrtVpIXFqFZzdM-A%2Fcbcms_mediamanager_icon_quickview.jpg?generation=1523648005907039\&alt=media) Quick View - Preview the currently selected image in a modal window. Only supports Images. ![Media Manager Icon - File Listing](https://1193444366-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LA-UVvYQ9YKIVXFz01w%2F-LA-UcIjNIclM_mn00Gl%2F-LA-UrteNFE43G_xKytH%2Fcbcms_mediamanager_icon_filelisting.jpg?generation=1523648005855161\&alt=media) File Listing - This shows the current folder in File Listing / Details view. This is the default listing style, shown in the screenshot above. ![Media Manager Icon - Grid Listing](https://1193444366-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LA-UVvYQ9YKIVXFz01w%2F-LA-UcIjNIclM_mn00Gl%2F-LA-UrtlFkTh_JQqIEvp%2Fcbcms_mediamanager_icon_gridlisting.jpg?generation=1523648005920101\&alt=media) Grid Listing - This shows the current folder in Grid Listing / Thumbnails view. This is a great way to preview directories of images. This view can seen in the screenshot below. ![Media Manager showing files in Grid Listing / Thumbnail style](https://1193444366-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LA-UVvYQ9YKIVXFz01w%2F-LA-UcIjNIclM_mn00Gl%2F-LA-UrtuiPWgG61aoi0q%2Fcbcms_mediamanager_view2.jpg?generation=1523648006632953\&alt=media) ### File / Folder Context Menus Context Menus ( otherwise known as right click menus ) are available for Files and Folders. Files have the following context menu items ![Media Manager - Context Menu for Files](https://1193444366-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LA-UVvYQ9YKIVXFz01w%2F-LA-UcIjNIclM_mn00Gl%2F-LA-Uru5rn4Ze-iLhtPs%2Fcbcms_mediamanager_file_contextmenu.jpg?generation=1523648005970343\&alt=media) Folders have the following context menu items ![Media Manager - Context Menu for Folders](https://1193444366-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LA-UVvYQ9YKIVXFz01w%2F-LA-UcIjNIclM_mn00Gl%2F-LA-UruFp-k5vv4oRxor%2Fcbcms_mediamanager_folder_contextmenu.jpg?generation=1523648146089872\&alt=media) ### Status Bar The Status Bar has useful quick view information. * Full file path breadcrumbs * Filename, File Size, and last modified date-time stamp. ![Media Manager Status Bar](https://1193444366-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LA-UVvYQ9YKIVXFz01w%2F-LA-UcIjNIclM_mn00Gl%2F-LA-Uruco8CPeDymI7O-%2Fcbcms_mediamanager_statusbar.jpg?generation=1523648005967724\&alt=media) ### Libraries Next to the Module Name - 'Media Manager' you will see `Content` in a yellow label. That is the current Library you are looking at. There are several Libraries available for you to choose. To switch library, click the drop down select labelled `Switch Library` in the top right like the image below. ![The drop down menu inside of the Media Manager to switch from one library to another](https://1193444366-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LA-UVvYQ9YKIVXFz01w%2F-LA-UcIjNIclM_mn00Gl%2F-LA-UruuWfIBb8C-misO%2Fcbcms_mediamanager_switch.jpg?generation=1523648005978903\&alt=media) Depending on your security settings, you will be able to directly browse, upload, rename and delete filtes from the Content, Modules, Updates and Widgets locations. ## Media Manager Settings There are a lot of configurable options for the Media Manager, to fit in with your use cases. Media Manager Settings are found in the administrator under `System > Settings > Media Manager` ### Directory Root: The relative path or ColdFusion mapping in your server that will be the expanded root of your media manager. The default is `modules/contentbox/content`. This is restricted to relative paths to ensure the user of the Media Manager cannot access content outside of the web root. If you would like to use a folder outside of the web root, please create a coldfusion mapping ( and web accessible mapping if required by the Media Provider ) to ensure the folder is relative to the web root. ### Media Providers Media providers are used to deliver your media files securely and with greater flexibility as you can place your entire media root outside of the webroot. #### CF Content Media Provider ( default ) This provider uses the ColdFusion cfcontent tag to deliver and stream files securely to the user. This uses a ContentBox route `__media`, that translates the path into a cfcontent call and delivers the content. #### Forward Media Provider This provider will forward to the real physical location in the server for the media path requested via the internal servlet page context, so no real media path URL will be shown to the user. Use only if the media root is web accessible and a relative web root path, so double check your media root. #### Relocation Media Provider This provider will relocate to the real physical location in the server for the media path requested. Use only if the media root is web accessible, so double check your media root. ### Provider Caching Headers: If enabled, the media provider system will issue caching headers for all assets. You can use the `cbcache=true` URL param to issue no caching headers on any asset. Default: `true` ### FileBrowser Options ![Media Manager Settings - FileBrowser Options](https://1193444366-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LA-UVvYQ9YKIVXFz01w%2F-LA-UcIjNIclM_mn00Gl%2F-LA-Urw44V5xlrjUeEtI%2Fcbcms_mediamanager_settings_bottom.jpg?generation=1523648005888899\&alt=media) File Browser options includes a series of user options ( Yes / No ): * Allow Creation * Allow Deletes * Allow Downloads * Allow Uploads #### Accepted Upload File Mime Types #### HTML5 Uploads **Size Limit** - Maximum size of the file upload in mb - defaults to 100mb **Max Similtaneous Uploads** - Number of uploads allowed at the same time - defaults to 25 #### Quick View Image Width ( Pixels ) When using the Quick View for images, images are shown in a modal window, with a maximum width defined by this setting.