This article is for a specific plugin. Please be sure to read the
Introduction and Overview to jQuery Plugins which provides an introduction to the plugins.
userFileManager
The user file manager is a jQuery plugin which integrates with users "my folder" files i.e. the area where all valid site users can upload files to by default e.g. profile avatars, journal uploads etc. This plugin is used by the
dnnComposeMessage jQuery plugin when attachments are enabled, but it is also available for other core or 3rd party extensions.
To do so it's recommend that you use the
Client Resource Management API to ensure only a single copy of the script is included and that it is minimized and compacted (if your install has chosen those options) e.g.
<dnn:DnnJsInclude ID="DnnJsInclude2" runat="server" FilePath="~/Resources/Shared/Components/UserFileManager/UserFileManager.js" Priority="102" />
Whilst it's not mandatory, it is recommended to also include the css file that provides for a common look & feel.
<dnn:DnnCssInclude ID="DnnCssInclude2" runat="server" FilePath="~/Resources/Shared/Components/UserFileManager/UserFileManager.css" />
An example of the available options is below:
$.fn.userFileManager.defaultOptions = {
openTriggerScope: 'body', // defines parent scope for openTriggerSelector, allows for event delegation
openTriggerSelector: '#photoFromSite', // defined in template, opens dialog
dialogClass: 'dnnFormPopup fileManagerPopup',
width: '700px', // dialog width
minHeight: '400px', // dialog height
getItemsServiceUrl: '/DesktopModules/Journal/API/UserFile.ashx/GetItems',
attachCallback: function (file) {
// available properties .id, .modified, .name, .parentId, .size, .thumb_url, .type
alert(file.name + ' attached.');
},
templatePath: '/Resources/Shared/Components/UserFileManager/Templates/',
templateName: 'Default',
templateExtension: '.html',
/* localized text values: */
title: 'My Files', // dialog title
cancelText: 'Cancel', // dialog cancel button
attachText: 'Attach', // dialog attach button
nameHeaderText: 'Name',
typeHeaderText: 'Type',
lastModifiedHeaderText: 'Last Modified',
fileSizeText: 'File size: '
};