Installation:
This plugin is designed for Joomla 3.9+. To install go to the install/uninstall extensions page of Joomla Administrator and upload the package file. Then go to the Plugin Manager page and activate the plugin.
Changes & Backward Compatibility:
For version 4.0, several changes had to be made that affect backward compatibility. For new users, this is not a problem, but for existing users, you make have to make minor changes to your shortcode to get everything working as normal. We apologize for any inconvenience these changes may cause. Here are the changes:
- Use of Spaces:
The use of pipes '|' to separate shortcode properties/attributes was removed. Shortcode attributes are now separated by a space. So, you will have to change your shorcodes and use spaces instead. For example:
{easyflashuploader destination='some_folder/subfolder'|caption='My Images'|disappear='1'}Shold be changed to...
{easyflashuploader destination='some_folder/subfolder' caption='My Images' disappear='1'} - Deprecated SWFUpload Engine:
Easy Flash Uploader's default upload engine is now purely Javascript. It is an AJAX-based uploader that uses the XMLHttpRequest object to handle uploads and progress management. Although the previous SWFUpload engine is available, its use is discouraged. The AJAX engine works almost identically, except for the lack of a queue limit (number of files in the queue) and maximum upload limit (total size uploaded from all files in queue).
According to Adobe, Flash Player will reach End-of-Life on December 31, 2020. After this date, there will be no support for Flash in web applications or browsers. Originally, Easy Flash Uploader was created uwing SWFUpload 2.2.0.1, which is a Flash-based uploap progress manager. As of version 4.0 of Easy Flash Uploader, SWFUpload will no longer be the main upload engine. And upon the release of version 5.0, SWFUpload will be completely removed.
- Multiple Email Recipients:
You can now, from version 4.0, send an email notification to more than just one email address. Separate each email address by a comma or semicolon.
Usage:
To use this plugin as content in an article, first enable the plugin and configure the default parameters in the Plugin Manager. To control which types of users have access to this plugin, set the Access Level in the plugin.
Secondly, in the article, type '{easyflashuploader}'. It will work based on the default parameters if typed with no custom parameters.
To have multiple uploaders on the same page, just add a custom shortcode for each instance you want. Please note that each instance must have something different about their listed parameters:
{easyflashuploader parameter1='value1' parameter2="value2" ... parameterN='valueN'}
Please note that parameter values can be enclosed in either single quotes or double quotes. Number values need not be enclosed in quotes. Example of a custom shortcode:
{easyflashuploader destination="folder_in_joomla_root/optional_subfolder" replace='1' simultaneous=1 filesize=10240 caption='My Uploader'}
Parameters
| Name | Keyword | Default Value | Description |
|---|---|---|---|
| Upload Engine | engine | ajax | Choose the upload engine used to upload the files and show its progress. Options are ajax or flash. |
| Default Upload Folder | destination | images | This is the folder that the uploaded file will be saved to. |
| Default Caption Text | caption | Easy Flash Uploader Queue | This is the default text that captions the upload file form. |
| Show Caption | showcaption | Yes (1) | This specifies whether to show the caption above or not. |
| Heading Type | heading | Heading 3 (h3) | This specifies the heading type of the Default Caption text. |
| AJAX Details | |||
| Input Method | input | dnd | Choose the appropriate input method to add files. You can choose between Drag and Drop (dnd), Drag and Drop with Link (dndlink), Default File Input (fileinput), or Text Link (link). |
| Select Multiple | multiple | Yes (1) | Allows selecting multiple files in the Browse dialog. |
| Auto Start | autostart | Yes (1) | Autpmatically start uploading files once queued. |
| Show Controls | showcontrols | Yes (1) | Display or hide the queue management controls. |
| Simultaneous Uploads | simultaneous | Yes (1) | When selecting multiple files to upload, all will simultaneously start instead of manually starting one at a time. |
| Autohide DnD | autohide | Yes (1) | Autohides the Drag and Drop area when uploading starts. |
| Uploads Position | uploadsposition | above | Select the position of the uploads queue relative to the input method area. Options are above or below. |
| SWFUpload Settings | |||
| Browse Button Text | button | Browse | This is the text that is on the button to browse for the file to upoad. |
| Browse Button Sprite | sprite | buttonSprite_blue.png | This allows you to choose which button sprite to select. You can add custom button sprites in the buttons folder. |
| Button Render Mode | buttonmode | WINDOW | This allows the administrator to specify how the Flash-based browse button will be rendered. The value must be ALL UPPERCASE. Other values include: OPAQUE and TRANSPARENT |
| Browse Button Width | buttonwidth | 100 | This is the width (in pixels) of the browse button. |
| Browse Button Height | buttonheight | 23 | This is the height (in pixels) of the browse button. |
| Browse Button Font Family | fontfamily | Arial | This is the font family of the browse button text. |
| Browse Button Font Size | fontsize | 12 | This is the font size of the browse button text. |
| Browse Button Font Color | fontcolor | #FFFFFF | This is the color of the browse button text. |
| Browse Button Top Padding | toppadding | 3 | This is the padding of the browse button text from the top of the button image. |
| Show Status | showstatus | Yes (1) | This specifies whether the status information is shown in the widget. |
| File Upload Limit | uploadlimit | 10 | This is the number of files allowed to be uploaded. The value of 0 (zero) is interpreted as unlimited. |
| File Queue Limit | queuelimit | 10 | This is the number of unprocessed files allowed to be simultaneously queued. |
| Description of File Types | filedescription | Image Files | This is the description label shown in the dialog box when selecting the file. |
| Upload Settings | |||
| Maximum File Size (KB) | filesize | 2048 | This is the maximum allowable file size, in kilobytes, that can be uploaded. |
| Default Permitted file types (separate by semi-colon) | filetypes | *.gif;*.jpg;*.png;*.pdf | This is a list of the file types that are permitted to be uploaded (separated by semi-colon. no spaces between). To specify all file types, enter *.* in the textarea. |
| Permitted MIME types (separate by semi-colon) | mimetypes | application/octet-stream; image/gif; image/jpeg; image/pjpeg; image/png; application/pdf; application/msword; application/zip; application/x-compressed; application/x-zip-compressed; multipart/x-zip; application/excel; application/vnd.ms-excel; application/x-excel; application/x-msexcel | This is a list of the MIME types that are permitted to be uploaded (separated by semi-colon. spaces between allowed). Type asterisk (*) to allow any type. |
| Replace existing files allowed? | replace | No (0) | This allows the administrator to decide whether to allow the user to replace en existing file with the same file name as the file to be uploaded. |
| Display Details | |||
| CSS Layout Theme | ** NO KEYWORD ** | compact.css | Select a CSS layout theme from the list of files located in the themes media folder. |
| Width of Containing Div | divwidth | 500px | The Width of the Containing DIV element. This value must specify the unit. For example, 100% or 300px or 13em. |
| Progress Bar Height (in pixels) | barheight | 10 | The height, in pixels, of the progress bar (Do not specify the unit. Only the enter the number.). |
| Override Theme | overridecolors | No (0) | Choose whether to override the theme colours for the progress bar. |
| Progress Bar Color (loading) | colorloading | #629bfc | The background color of the progress bar while it is loading. |
| Progress Bar Color (complete) | colorcomplete | #83f781 | The background color of the progress bar when upload is complete. |
| Progress Bar Color (error) | colorerror | #fa5a5a | The background color of the progress bar when an error occurs. |
| Disappear bar when complete? | disappear | No (0) | This specifies that the progress bar disappears a few seconds after the upload is complete. |
| Notification Details | |||
| Send an Email Notification? | notify | No (0) | This specifies whether an email notification should be sent to the email address below after the successful upload is complete. |
| Recipient Email Addresses | recipient | EMPTY | One or more email addresses that receive the upload notification. Separate multiple emails using a comma or semi-colon. |
| Enable Username Subfolders | userfolders | No (0) | When enabled, files are uploaded to username folders inside the upload folder. |
| Guest Folder Name | guestfolder | __guest | This is the name of the folder where the files for guest users are kept. |