This thread is about to be closed. Please use now the new thread, in the plugin forum:
http://forum.coppermine-gallery.net/index.php?topic=43432Hi,
I updated the 'Java Multiple File Upload Applet (JUpload)' sourceforge project (
http://jupload.sourceforge.net) : this is an applet, that allow multiple files uploads. The full java code is stored in this project.
I created a plugin to use this applet with coppermine. This plugin is translated in
Dutch, English, Esperanto, French, German, Italian, Japanese, Norwegian, Polish, (Bresilian) Portugese, Slovenian and Spanish. The applet is also translated in Chinese.
21 Apr 2007 2.4.0 version has been release. You can now upload any file allowed by your Coppermine configuration.
10 Mar 2007 2.3.0 version has been released : The upload may be speed up, by preventing the applet to resize pictures, and the admin album management is back.
14 Feb 2007 2.2.0 version has been released : It correct some bugs and regressions due to the plugin migration. It also adds the
Japanese and Norvegian translations. It can be managed through the standard Plugin management page.
01 Dec 2006 2.0.0 version has been released : It is now compatible with all themes (standard use of the plugin mangement, but
take care to the install: see below), and works with admin categories, where user may publish pictures. It also generate much better quality picture than 1.x versions.
The result is embedded in my coppermine test site. If you want to play with it, you can freely use :
http://etiennegauthier.free.fr/coppermine/index.php?jupload/jupload(my ISP seems to have some problems these days. If you're experiencing access difficulties, please try again later)
login/pass: coppermine / jupload (or copermine / jupload)
All releases are available here :
http://etienne.lesgauthier.fr/wiki/doku.php?id=jupload_coppermine_download_gb
The explanation is also available here
http://etienne.lesgauthier.fr/wiki/doku.php?id=jupload_coppermine_gb
COPY OF THE /plugins/jupload/jupload-readme.txt :
1) SUMMARY
2) USER GUIDE
3) TECHNICAL DESCRIPTION
4) INSTALLATION
5) CONFIGURATION
6) HOW TO SOLVE PROBLEM ?
7) SUPPORT
1) SUMMARY
This pack is an add-on (plugin) for the coppermine gallery, that allow you to batch upload pictures from an applet. This applet allows the user to preview and rotate pictures before upload.
The picture are resized to the gallery maximum size before upload: this make quicker upload, and allow easy upload of pictures from modern camera, even on ISP that has a too low maximum upload size.
After upload, the user can modify the picture properties (title, description, key words) on one unique page.
A sample coppermine gallery is available, if you want to take a look to it :
http://etiennegauthier.free.fr/coppermine/index.php?jupload/juploadlogin/pass:
copermine / jupload (oups!, I forgot one 'p' into my first message)
or
coppermine / jupload (so there is now two availables login to test the jupload plugin)
2) USER GUIDE
By using this applet, the main user improvements are:
- Uploading several pictures (no limit) in only _two_ web pages:
- Page1 (click on the JUpload menu item or open jupoad.php page): select album (or create/update album), select picture files, preview and/or rotate them, upload,
- Enter picture comments in the album properties page (for all pictures at once).
- Upload is quicker, as pictures are resized by the applet before upload,
- The user can enter comments for all uploaded pictures in one web page (instead of one by picture),
- The jupload.php script allows the user to both: manager albums and upload pictures,
- Upload pictures without having to manually resize them before upload (my Canon EOS20D pictures are bigger than the upload limit of my free ISP hosting).
The applet allows the user, before upload, to:
- Select multiple files on his hard drive,
- Preview pictures,
- Display a full screen picture (by clicking on the previewed picture),
- Rotate the picture right or left,
- Download pictures and select the upload album on the same web page (with the jupload.php script),
- Upload all pictures/files in one click,
- Not wait for each picture upload : if the session times out after upload, all pictures are correctly stored in the selected album,
- Edit all picture properties in one page (the album properties page is automatically opened after a successfull upload).
3) TECHNICAL DESCRIPTION
Within php, I added:
- The plugins/jupload directory. From this unique page, the user can: create, rename, and change desription of its albums. Each time he selects an album, the applet is updated to target this album.
- No special coppermine configuration is necessary. But, through the plugin management page, you can modify the behaviour of the plugin.
I updated the 'Java Multiple File Upload Applet (JUpload)' sourceforge project (
http://jupload.sourceforge.net) : this is an applet, that allow multiple files uploads.
This applet is now able to manage picture (see below, for the functionalities I added). I added a 'configuration' to use this applet with coppermine.
Technically, this applet:
- Is open source, and available here:
http://jupload.sourceforge.net- Is a stable version. It has been tested by a lot of other people, now.
- Is signed, to allow access to the user's hard drive (a user confirmation is asked by the JVM). You can sign it with your own certificate. See
http://jupload.sourceforge.net for all details.
- Is displayed in the current language. Currently available (2.0.0): english, french, dutch, german, esperanto, spanish.
- Retrieves the session from the navigator, to upload files within the same session (it get cookies from the navigtor, and the current server protocol back from the server, in an applet parameter: not nice, but I didn't find any other way),
- Resizes picture to the maximum coppermine size _before_ upload : the network traffic is smaller/quicker, and the load on the server is smaller. The resized pictures are now of good quality (since 2.0.0). This resizing functionnality is especially useful for pictures made by modern camera: their pictures are often too big for the maximum upload size allowed on servers.
4) INSTALLATION
With the plugin management pageThis work from JUpload version 2.1.0. To use this pack, you just have to unzip it in your coppermine root directory.
Just use the upload button on the plugin management page, to upload the zip file, then click on the ‘i’ to install it. A JUpload link will be available for use who may upload pictures.
With FTP uploadOn some configuration, the previous way doesn’t work. For instance, the web server need write access on the plugins directory. In this case, you’ll have to:
* Unzip the jupload package on your local computer,
* Transfer the jupload directory under the /plugins/ directory, with FTP for instance.
Until 2.0.0Until 2.0.0, you have to do this (after unzipping the jupload package in the coppermine root directory):
* Connect as an admin,
* Click on the ‘configuration’ button,
* Select the ‘general setting’ area,
* Check the ‘yes’ is selected for the ‘activate plugin’ choice (if ‘no’, select ‘yes’, and don’t forget to click on ‘Save configuration’, on the bottom of the page),
* Click on the ‘admin the plugins’ link.
* Find the jupload plugin in the list. If it is not installed, click on the beautifull little ‘i’, in the right column to activate it. The JUpload link should now be displayed on the left of the login/logout menu entry, whatever theme is selected.
With these old versions, you’ll also have to : 1- [Use a specific theme] (Useless, since version 2.0.0 : you should use the standard plugin manager, see above) Change the gallery theme to ‘jupload_rainy_day’. I just added a link to Jupload in the top menu.
2- Add the jupload link to your current theme. To do this, :
* Create a new theme (just copy all theme files to a new subdirectory of theme). This will prevent that you loose your modification when upgrading coppermine.
* Edit the jupload_rainy_day/theme.php, and search for jupload
* Copy the found line to your theme.php. The link for this new menu entry should be YourCoppermineRootInstallation/jupload.php
5) CONFIGURATION
This plugin now allows some configuration parameters. These parameters are stored in the
plugins/jupload/user/config.inc.php file. This file is not packaged in JUpload releases. So __updating JUpload plugin
won't erase your current configuration__.
You can update the user/config.inc.php file or go to the confirugation page. To go there:
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:
- 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.
- 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.
* 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.
6) HOW TO SOLVE PROBLEMS ?
Before asking for support, you should :
a) Check that standard upload works with the same login.
b) Put the debug on. To do this, you can set the applet debugLevel parameter to 100, in the plugins/jupload/upload_page.php script, or, while using the applet, do a CTRL + right-click on the status area of the applet, and select the 'debug on' entry in the popup menu that should appear.
Usually, problems occur during upload, so check the debug output, to see what the server answered. To do this:
- Debug must be on
- Select all in the status area (click into it, then CTRL-A to select the whole text)
- Copy it into a text editor, and try to read it.
- The server response is written between the lines containing '-------- Server Output Start --------' and '--------- Server Output End ---------'.
What you should see:
- First line MUST contain '200 OK' (e.g. full line should look like 'HTTP/1.1 200 OK'). If you get any other number, you have a problem that is local to your installation. Check this page to know what means this return code:
http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html- If you get 200 OK, that means that you get a 'normal' response from the server, that is from coppermine. But this response can be a message explaining an error to you. So, check the first empty line. The real response from coppermine comes after.
- This response should be a simple line containing 'SUCCESS'. If so, upload was Ok. Any problem you have is after.
- If not, the result can be a simple error message or a full HTML page.
- If it is a simple error message, see if you can correct it.
- If it is a full HTML page, you can copy the full server response (between the empty line and the line containing '--------- Server Output End ---------'), save it into a file named 'err.html', and open it with your navigator. You'll be able to see the coppermine response. You can then understand, and try to correct the problem.
7) SUPPORT
a) To get support about the coppermine plugin: the best way is to post a message into the coppermine upload mods forum, for this applet. I'll receive a notice in my personal mailbox.
b) To get support about the applet itself, the best way is to post a message into the sourceforge forums. Here again, I'll receive a notice in my personnal mailbox.
Regards
Etienne
Sourceforge account: etienne_sf
