Before you start to use Media Manager, it's best to set it up to suit your workflow. All the settings are available in the Settings dashboard. Click Settings on the menu to access this view. Please note that if you do not have a media-manager-settings permission, you will only be able to view the settings but not edit them.
The settings are grouped into sections and subsections each of which is collapsed/closed by default. Click on the section header to view and edit its settings. Below, we explain what each section does. Please note that some settings are for advanced users only.
Settings in this section affect if and how media is uploaded to your Media Manager Library. The section has several sub-sections as described below. Please note that all invalid files (for instance disallowed extension or files with wrong mimetypes are deleted on uploaded for the latter and not uploaded at all for the former.
Here the choices affect what happens after you have uploaded your media .The options are:
- Add uploads to your media Library and publish them.
- Add uploads to your media Library but keep them unpublished.
- Store uploads in a temporary folder for review. After review, editors can decide to either delete the media or transfer them to the media Library.
The settings here are:
- Overwrite filename: Determines whether to overwrite only a media with a particular filename.
- Minimum file size: The minimum file size that can be uploaded.
- Maximum file size: The maximum file size that can be uploaded.
- Maximum files: Maximum number of files that can be simultaneously uploaded.
- Overwrite: Whether or not to ovewrite files with identical names that may be present in the destination folder of uploads.
- Lowercase: Whether to enforce lowercase renaming of filenames.
The settings here are meant for users with advanced knowledge about how uploading files to webservers work.
- Single file uploads: Whether to send a single ajax request for all uploads or to send one request per file in the upload.
- Limit multi-file uploads: This can be used to set a maximum number of uploads to be sent to the server in one ajax request.
- Sequential uploads. Set to true to send ajax upload requests in a sequential order as opposed to simultaneous requests.
- Limit concurrent uploads: Use this to limit the number of concurrent uploads.
- Auto upload: Determines whether to automatically start uploads to the server as soon as files are added or to wait for the user to click the start button.
- Prepend files: Determines the order in which files are added to the uploads widget (and subsquently the order in which they are sent to the server). Newly added files can either be appended (default) or prepended.
These settings affect audio files only.
- Valid audio file extensions: Specify the audio extensions that editors are allowed to upload. For instance, mp3, ogg, etc.
- Load audio maximum file size: The maximum size of an audio file that can be loaded for previewing.
- Disable audio preview: Disable previewing of audio files when they have been added to the files upload widget.
These settings affect document flles only.
- Valid document file extensions: Use this to specify file extensions allowed for uploads. These can include pdf, docx, xlsx, etc.
The settings affect video files only.
- Valid video file extensions: Specify allowed video file extensions, for insance, mp4, avi, mkv, etc.
- Load video maximum file size: Maximum size of a video file that can be loaded for previewing prior to uploading.
- Disable video preview: Disables preview of video files in the uploads file widget.
These settings are for image files only.
- Valid image file extensions: Allowed image file extensions. The defaults are jpg, jpeg, svg, png and gif.
- Disable image header: Whether to disable parsing and storing the image header.
- Disable Exif: Disables parsing of Exif data.
- Disable Exif thumbnail: Disables parsing the Exif thumbnail.
- Disable Exif sub: Disable parsing the Exif Sub IFD (additional Exif info).
- Disable Exif GPS: Disable parsing Exif GPS data.
- Disable image meta-data load: Disable parsing image meta-data (image head and Exif data).
- Disable image meta-data save: Disable saving image meta-data into the resized images.
- Disable image load: Disable loading and therefore processing of images.
- Disable image resize: Disable the client-side image resize functionality.
- Disable image preview: Disable image previews.
- Load image maximum file size: Maximum file size of images to load.
- Image minimum width: Minimum width of resized images.
- Image minimum height: Minimum height of resized images.
- Image maximum width: Maximum width of resized images.
- Image maximum height: Maximum height of resized images.
- Image crop: If resized images should be cropped or scaled.
- Image orientation: Whether to define the image orientation or get it from Exif data if set to true.
- Image force resize: Whether to force writing to and saving images from canvas.
- Image quality: Sets the quality when saving resized images.
- Preview minimum width: Minimum width of preview images in the uploads files widget.
- Preview minimum height: Minimum height of preview images.
- Preview maximum width: Maximum width of the preview images.
- Preview maximum height: Maximum height of the preview images.
- Preview crop: If preview images should be cropped or only scaled.
- Preview Orientation: Preview orientation or take the orientation value from Exif data if set to true.
- Preview thumbnail: Create the preview using the Exif data thumbnail.
Media Title Format
This setting affects how the title applied to a media will be formatted. Media titles are derived from the filename so take care when naming files to upload.
- First letter of each word uppercase as well as no underscores or hyphens.
- First letter of first word uppercase, no unerscores or hyphens.
- Exactly as the processed filename but first letter of each word uppercase.
- Exactly as the processed filename but first letter of first word uppercase.
This setting specifies what to do if upon uploading media to the Library, media with duplicate names are found. The choices are:
- Skip the media being uploaded.
- Rename the media being uploaded and add it to the media Library.
- Replace the existing media with the newly uploaded one.
This section has the following settings.
Display User Media
This setting determines whether logged in users can view all media uploaded to the media Library or only view the media that they uploaded.
Sort Media By
This sets the default sort criteria for media displayed in the media view dashboards. The options are:
- Title: Sort by title.
- Tags; Sort by tags.
- Modified: Sort by media modified date.
- Created: Sort by the date the media was created.
- Published: Sort by when the media was published.
- Description. Sortusing description as the criteria.
Sort Media Order
This states whether sort (see above) should be ascending or descending.
This setting enables/disables viewing and setting up of filter profiles. Please see this section for more about filter profiles.
Allowed Media Types
Use this setting to specify the types of media that can uploaded. The four possible media types are audio, document, image and video. Please note that this is a global setting. It affects the media types that you will be allowed to add to any Media Manager fields that you create.
Disable All Media View
This setting enables/disables the All media view dashboard. If disabled, media will only be viewable under its own type, e.g. images under image dashboard, etc.
Enable Upload Anywhere
If enabled, editors will be able to upload media by simpy dragging and dropping files in any of the view media dashboards. On drop, the files will be automatically uploaded. Please note that other media upload settings still apply. For instance, if the After Upload setting is to store uploaded media in the temporary folder for review, you will not be able to immediately see the uploaded media in the view in which you dropped the file(s). The same case applies for media types. If the files were dropped in a view media dashboard other than their own or All, they will not be immediately visible to you. You will need to navigate to their dashboard (or the all dashboard) in order to see them (assuming the upload was successful).
Decompress Zip Files
If enabled, zip files will be recursively unzipped to extract the files within them for uploading to the media Library. The zip files are then deleted. If disabled, zip files will be treated as documents and will be uploaded as such in case zip is an allowed extension for documents. Otherwise, the zip file will be deleted.
Use these settings to specify which custom columns you would like to view for each media type when in table view. Custom columns here refer to extra fields that have been added to the respective media manager templates. Please refer to the Editing a Single Media Item section for more on custom columns. Please note that not all Fieldtypes are supported for viewing, for instance rich text fields, repeaters, etc. Hence, such fields will not be available for selection in the following settings. However, from your template files, you will still be able to access those fields using the API.
Select custom columns to be visible when viewing audio media in the audio dashboard.
Select custom columns to be visible when viewing document media in the documents dashboard.
Specify the custom columns to be visible when viewing image media in the images dashboard.
Specify the custom columns to be visible when viewing video media in the videos dashboard.