Child pages
  • ESUP File Manager Portlet

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.

ESUP File Manager is a JSR286 Portlet. Like BriefCase, Esup File Manager allows users to perform file management on their HomeDirs.



  • full ajax (jquery)
  • WAI User Interface
  • mobile look for browsing files (JQuery Mobile)
  • copy/cut/past, rename, create folder, upload/download files
  • copy/cut/past inter-servers
  • use apache commons vfs -> file systems supported are here :  - uri like file:///home/bob works for example - ftp and sftp ok ...
  • CIFS support (with JCIFS)
  • Webdav support (with Sardine)
  • CMIS support (Apache Chemistry).
  • use spring v3, mvc, annotations, etc.
  • allow to configure servers access with a configuration file
  • 4 authentification mods : no authentification, authentification username/password given in config file, authentification username/password with user form, authentification proxy cas (tested with cassified sftp).


You can download esup-filemanager-3.1.2 here :


We're using GITHUB now for the development of esup-filemanager

So don't hesitate to fork it and to send us some "pull requests" to improve it !

  1. master branch
    That's the development branch for the releases of esup-filemanager - it uses "portlet 2.0" API (JSR 286).
  2. esup-filemanager-portlet_1_0 branch (deprecated)
    That's the development branch for "portlet 1.0" (JSR 168) compatible releases of esup-filemanager - esup-filemanager 2.x.x releases  come from this branch.
    [tip : use  mvn jetty:run to launch quickly a test of esup-filemanager]


You can test esup-filemanager on pluto. Do simply : 

Code Block
mvn clean portlet-prototyping:run

Next, point your browser on this url :


With default config file, Bob drive is mapped on  file:///.

Portlet - uPortal deployment

Files that you should modify for configurations :

  • src/main/webapp/WEB-INF/context/drives.xml
    That's the Main config files (Read it to see what kinds of configurations you can use !).
  • src/main/webapp/WEB-INF/portlet.xml
     user-attribute tags
  • src/main/webapp/WEB-INF/web.xml
    For ProxyCAS, setup your cas server.

To deploy esup-filemanager, here the usual command line :

Code Block
mvn clean package ; cd /opt/uPortal-runn/ ; ant deployPortletApp -DportletApp=/home/esup/esup-filemanager/target/esup-filemanager.war

Portlet preferences

Even if the most part of configurations is set on drives.xml, you can also define some portlet preferences when registering/publishing an "Esup File Manager" Portlet.

  • defaultPortletView : can be equals to standard, wai or mobile
  • defaultPath : that's the default path which is opened when the user displays the portlet (if defaultPath is multi-valued, the first available is choosed).
  • contextToken : it allows to show only some drives (that have the same contextToken set up on drives.xml)
  • showHiddenFiles : to hide/show 'hidden files'
  • useDoubleClick : use of double click when browsing
  • useCursorWaitDialog : display a waiting dialog when loading

Some of this preferences can also be edited by user himself with the "edit portlet mode".

uPortal supported versions

  • esup-filemanager 3.0.0 (and above) is no longer compatible with JSR168 portals ( like uPortal v2 and v3) : use uPortal 4.x !


includeesup-filemanager-diaporama.png, esup-filemanager-drag-n-drop.png, esup-filemanager-mobile.png, esup-filemanager-standard.png, esup-file-manager-wai2.png, esup-filemanager-edit.png


French page on

Credits & License

Copyright (C) 2017 2018 Esup Portail Portail
Copyright (C)  2017 UNR RUNN 2018 UNR RUNN
Copyright (C)  2017 RECIA 2018 RECIA
@Author (C)  2017 Vincent 2018 Vincent Bonamy <>fr>
@Contributor (C)  2017 Jean2018 Jean-Pierre Tran <>fr>
@Contributor (C)  2017 Julien 2018 Julien Marchal <>fr>
@Contributor (C)  2017 Julien 2018 Julien Gribonvald <>fr>
@Contributor (C)  2017 David 2018 David Clarke <>au>
@Contributor (C)  2017 BULL
@Contributor (C) 2017 Pierre 2018 Pierre Bouvret <>fr>
@Contributor (C)  2017 Franck 2018 Franck Bordinat <>fr>
@Contributor (C)  2017 Pascal 2018 Pascal Rigaux <pascal<>
@Contributor (C)  2017 Olivier 2018 Olivier Franco <olivier<>
@Contributor (C) 2017 2018 Maxime Bossard <maxime<>
@Contributor (C) 2017 2018 Guillaume Colson <guillaume<>
@Contributor (C) 2017 2018 Denis Elbaz <denis<>
@Contributor (C) 2018 Dominique Lalot <>

Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.


titleAdopters of This Portlet

Normandy Universities