(r2) UploadPlugin < System

You are here: Foswiki>System Web>UploadPlugin~~EditAttach~~

---+!! !UploadPlugin
<!--
One line description, required for extensions repository catalog.
   * Set SHORTDESCRIPTION = Attach multiple files to a topic in one go
-->
%SHORTDESCRIPTION%

This plugin provides a more flexible interface to upload one or more files
to a topic. Using standard means, only one file can be uploaded at the same
time. In comparison this plugin allows to upload multiple files with one
transaction and optionally using an asynchronous request. 
the needed REST interface to 

%TOC%

---++ Examples
You type:
<verbatim>%UPLOADFORM%</verbatim>

You get (if installed):

%ATTACHURL%/UploadPluginSnap1.png

---++ Syntax
<verbatim>%UPLOADFORM{
  ajax="on|off"
  comment="on|off"
  target="on|off"
  multiple="on|off"
  embed="on|off"
}%</verbatim>

The =comment=, =target=, =multiple=  and =embed= parameters toggle different features
of the upload form:

   * =ajax= - switch on/off asynchronous operation mode; defaults to off
   * =comment= - switch on/off the comment field for uploads
   * =target= - switch on/off the target field; defaults to current topic
   * =multiple= - switch on/off multi-file upload
   * =embed= - switching this to =on= will omit the outer form markup; that's useful
     to _embed_ the upload form into a larger form, that the upload is part of
   * =onsuccess= - function to be called after a sucessful upload; aditionally, the javascript event =sucess.uploader= is fired on success
   * =onerror= - function to be called after a failed upload; the javascript event =error.uploader= is fired when an error occurs

---++ Installation Instructions
You do not need to install anything in the browser to use this extension. The following instructions are for the administrator who installs the extension on the server.

Open configure, and open the "Extensions" section. Use "Find More Extensions" to get a list of available extensions. Select "Install".

If you have any problems, or if the extension isn't available in =configure=, then you can still install manually from the command-line. See http://foswiki.org/Support/ManuallyInstallingExtensions for more help.


---++ Info

Many thanks to the following sponsors for supporting this work:
   * Acknowledge any sponsors here

|  Author(s): | Foswiki:MichaelDaum|
|  Copyright: | &copy; 2009 Michael Daum http://michaeldaumconsulting.com |
|  License: | [[http://www.gnu.org/licenses/gpl.html][GPL (Gnu General Public License)]] |
|  Release: | 1.11 |
|  Version: | 4414 (2009-07-03) |
|  Change History: | <!-- versions below in reverse order -->&nbsp; |
|  02 Jul 2009: | added =ajax= parameter; triggering sucess and error events jquery events |
|  30 Jun 2009: | added =onsuccess=, =onerror= |
|  23 Jun 2009: | initial release |
|  Dependencies: | <table class="foswikiTable" border="1"><tr><th>Name</th><th>Version</th><th>Description</th></tr><tr><td align="left">Foswiki::Plugins::JQueryPlugin</td><td align="left">&gt;=3740</td><td align="left">Required.</td></tr></table> |
|  Home: | Foswiki:Extensions/UploadPlugin |
|  Support: | Foswiki:Support/UploadPlugin |

<!-- Do _not_ attempt to edit this topic; it is auto-generated. -->

Topic attachments
I	Attachment	Action	Size	Date	Who
EXT	Makefile	manage	0.2 K	17 Nov 2009 - 18:06	AdminUser
png	UploadPluginSnap1.png	manage	9.6 K	17 Nov 2009 - 18:06	AdminUser
css	upload.css	manage	0.5 K	17 Nov 2009 - 18:06	AdminUser
gz	upload.css.gz	manage	0.3 K	17 Nov 2009 - 18:06	AdminUser
js	upload.js	manage	4.7 K	17 Nov 2009 - 18:06	AdminUser
gz	upload.js.gz	manage	1.5 K	17 Nov 2009 - 18:06	AdminUser

Topic revision: r2 - 12 Oct 2010, AdminUser

System

Copyright © by the contributing authors. All material on this site is the property of the contributing authors.
Ideas, requests, problems regarding Foswiki? Send feedback