Support => cpg1.4 plugins => cpg1.4.x Support => Older/other versions => cpg1.4 JUpload by etienne_sf => Topic started by: etienne_sf on June 10, 2008, 01:27:49 pm

Title: JUpload presentation (and last version)
Post by: etienne_sf on June 10, 2008, 01:27:49 pm
Author: Etienne Gauthier
Account etienne_sf (on sourceforge and coppermine forums)

The easiest and quickest way to upload files !

Works for all navigators and all OS

Compatible with Coppermine 1.5 !

[li]Edit properties for all uploaded pictures on one unique page.


7 dec 2009 v4.1.0. compatibility with cpg 1.5.6, resume upload
7 dec 2009 v4.0.1. Edition of uploaded pictures properties was broken since 4.0.0rc1.
6 dec 2009 v4.0. EOF error with personnal firewall/antivirus corrected. Some bridge configuration would not work (see new cookieConfiguration parameter)
1 nov 2009 v4.0.0rc1. Compatibility with Coppermine 1.5, Compatibility with ImageMagick
18 July 2009 v3.6.2. One major corrections: the applet woule freeze again, when an error occurs during download.
5 July 2009 v3.6.1. One major corrections: the applet could generate during upload (SUCCESS string not found).
21 June 2009 v3.6.0. Two major corrections: applet freeze, and common upload attributes would be taken into account.
16 mar 2009 v3.5.0 (official). Also some minor corrections -> Avoid 3.5.x version, the applet may freeze
16 mar 2009 v3.5.0 (beta). Bridge mode rewritten. Upload quicker (on fast networks).
23 feb 2009 v3.4.0. Removed some blockin bugs (NullPointerException), in some particular cases. Arabic translation.
17 oct 2008 v3.3.0. Paste management, error mail to the admin corrected, Firefox on Mac correction, Hungarian translation finished.
22 sept 2008 v3.2.4. Security fix, mandatory to install when PHP magic_quot_gpc and non trusted users may upload pictures.
2 août 2008 v3.2.3. Memory exhausted corrected (while uploading). Partial Hungarian translation.
12 juillet 2008 v3.2.2. Jupload internal session management corrected. Chinese translation updated.
7 juillet 2008 v3.2.1. German translation updated.
6 juillet 2008 v3.2.0. Chunk mode corrected under Unix, Slovak translation.

The Coppermine plugin is available here: (
The java sources for the applet are available here: (
The last JUpload stable version is attached to this message.

You can test the plugin, by going to my test web site : (

What's next in this doc:



This pack is a plugin for the Coppermine Picture Gallery, which allows you:
This plugin is translated in the following languages: Chinese, Croatian, Czek, Danish, Dutch, English, Esperanto, French, German, Hebrew, Hungarian, Italian, Japanese, Norwegian, Polish, (Brazilian) Portugese, Russian, Slovak, Slovenian, Spanish, Swedish and Turkish.

In the default configuration, pictures are resized down to the gallery maximum size before upload: this make upload quicker, and allow easy upload of pictures from modern camera, even on ISP that has a too low maximum upload size.


Upload pictures

By using this applet, the main user improvements are:

The applet allows the user, before upload, to:


Java Part

All informations about the applet itself is available here: (


PHP Part

To access to the plugin, one of these conditions must be met:


Version prior to 2.1.0
should migrate to a most recent version to use JUpload as a Coppermine plugin.

With the plugin management page

This work since JUpload version 2.1.0.

To use this pack, you just have to go the plugin management page, from the first section of the Gallery configuration page. Just use the upload button on the plugin management page, to upload it, then click on the 'i' to install it.

A JUpload link will be available for use who may upload pictures.

Any existing JUpload configuration is keeped, when installing a new version: see below, the Configuration section.

With FTP upload

On some configuration, the previous way doesn't work. For instance, the web server need write access on the plugins directory, and the php zip extension must be activated.

In this case, you'll have to:

The resulting directory tree should look like this :


If it was not already before, you'll then have to go the plugin management page, from the first section of the Gallery configuration page and click on the 'i' (on the right of the JUpload line) to install it.


This plugin has configuration parameters. Before 2.6.0, these parameters are stored in the plugins/jupload/user/ file. This file is not packaged in JUpload releases. So ugrading JUpload plugin won't erase your current configuration.
Since 2.6.0, the JUpload configuration is saved in the Coppermine config table.

You can update the JUpload configuration this way:
1) Connect as an admin
2) Go to the Coppermine ''Configuration'' page
3) Click on 'General parameters'
4) Click on 'Plugin management'
5) If the Jupload plugin is not installed, install it
6) Click on ''JUpload configuration''.

You'll find below the list of available paramaters. All details about the JUpload configuration, and each parameter are given in the config file and on the config page:
Parameter that has no link with upload:
  - albumShowEditFields: allows to hide the album name and description on the upload page. Useful if standard users may only upload to existing albums (not create or update albums).
  - alwaysVisible: 1 if the JUpload link is always visible. If 0, the JUpload link is only visible to users that may upload pictures. If the link is visible, a user who may not upload pictures (or is not logged in) will be redirected to a connection page. [Since 3.0.0] This parameter also allows you to restrict access to the plugin to both administrators and a given user group.
  - appletHeight and appletWidth (since 2.6.0): allows control on the size of the applet on the upload page.
  - basicHttpAuthentication (since 2.5.3): allows upload to an URL protected by a basic authentication.
  - fileChooserIconFromFileContent (since 2.6.0): if set to true, the icon of the files in the file chooser are calculated from the image content. Otherwise: system default.
  - fileChooserIconSize (since 2.6.0): Size of the icon described here above.
  - generateDefaultPictureTitle: Controls whether the plugin will define a default picture title for the uploaded file. This default title will be based on the filename. 
  - highQualityPreview: Indicate whether the pictures displayed on the applet are high or low (less CPU) quality. Of course, all uploaded pictures are treated in high quality.
  - jarPath: allows the applet to be integrated in Coppermine, even when Coppermine is itself a plugin of another tool. It controls the path where the jupload.jar file is.
  - linkComment (since 2.5.5): Allows the admin to change the explanation that is displayed, when the user put his mouse over the JUpload link.
  - linkKeepStandardUpload (since 2.5.6): Allows the admin to change the explanation that is displayed, when the user put his mouse over the JUpload link.
  - linkTitle (since 2.5.5): allows the admin to change the text of the JUpload link.
  - sessionManagement (since 3.0.0): allows to use internal JUpload session management. Make the plugin work with some specific bridge configuration, where standard session management lead to a 'no permission' error.

Parameters to control the upload itself:
  - maxChunkSize: Define the maximum number of bytes that may be uploaded at once. A file bigger will bu splitted in chunks. The whole file will be re-created on the serve, once all chunks have been sent.
  - maxFileSize. Maximum file size for an uploaded file. It can be bigger than the maxChunkSize. This parameter overrides your Coppermine configuration for JUpload.
  - maxNonTransformedPictureSize. This parameter is important to control who of the applet or the server resizes pictures bigger than the maximum picture size (in pixels) you've defined in your Coppermine configuration.
  - pictureCompressionQuality: controls the jpeg compression. Default is 0.8. It creates pictures of the same weight as the native Coppermine.
  - pictureTransmitMetadata (since 2.6.3): Controls whether the applet transmit metadata (IPTC, EXIF) to the server or not. Caution: this currently controls only metadata for picture resized or rotated by the applet. Picture transmitted as is (small enough, and not rotated) remain unchanged.


A little FAQ

  * You're using Firefox on mac
    * Seems like the bridge between Firefox and Java doesn't exit on mac! This bridge is mandatory for the applet.
    * This tool should allow you to use the applet (please confirm it to me):
  * You're using IE7 on Vista
    *  Crash was reported. To be confirmed.
  * You get a PHP error
    * Check your PHP version. The plugin can't work for PHP earlier than 4.3.0.
  * You don't see the whole applet.
    * Take a look to the configuration parmeters appletWidth and appletHeight.
  * Your Coppermine installation is a plugin (bridge ?) in another tool, and the applet i not displayed
    * Take a look to the jarPath plugin.
  * When uploading through the applet, ou get a 'no permission error', or any other message indicating that you're not connected.  Seems to occur sometimes, when your Coppermine installation is a plugin (bridge mode).
    * Take a look at the sessionManagement configuration parameter, since 3.0.0.
  * You want to restrict access to the plugin.
    * Take a look at the alwaysVisible configuration parameter, especially since 3.0.0.
  * Picture is transformed (picture file is smaller, for instance), but I don't want it !
    * Take a look at the explanation going with the pictureTransmitMetadata configuration parameter.
  * What else ?
    * Get the debug output (see below)

How to get the debug output ?

Before asking for support, you should :

Usually, problems occur during upload, so check the debug output, to see what the server answered. To do this:[/li][/list]

What you should see:


The last version is attached just below.

The full history of JUpload versions is availableon my wiki: (