Skip to content
Offerel edited this page May 2, 2024 · 7 revisions

About

Directly integrate elFinder as App in to Roundcube with SSO. You can find elFinder at GitHub (https://github.com/Studio-42/elFinder).

Installation

  • Extract the downloaded archive into Roundcube’s plugin directory <roundcube>/plugins/ and rename it to storage.
  • Copy config.inc.php.dist to config.inc.php
  • Change $config['storage_basepath'] in this config.inc.php to the root path for elFinder. This defines, where the root for the filemanager starts. Use the variable %u for the Roundcube username.
  • Activate the plugin in /config/config.inc.php in the way that you add it to the active plugins array, like $config['plugins'] = array('storage');

Issues

For issue reporting, please use the issue tracker at Codeberg.org. I have disabled the issue tracker on GitHub.com

How to report bugs

If the plugin does not work as expected, the error should be reported here as a issue. I will then try to fix the problem. However, I need your help to find the cause of the problem. Important are especially the different log files.

  • Mainly I need the output of the browser's webconsole. In most browsers under Windows, you can access it by pressing the F12 key, please tell me all listed errors and warnings.
  • The output of the Roundcube error log file is also useful. Please attach this to the issue. Remove any confidential text
  • Sometimes the issue depends more at the server configuration. Helpful in these cases are the two logfiles of the webserver: error.log and access.log
  • There is also a separate PHP Logfile. Please attach this file also to the issue

Please also note that I can only give very limited tips and advice on server configuration.

FAQ

How is the path to the folder displayed by the plugin in the GUI calculated?

The absolute path to the elFinder root is defined in: `$config[' storage_basepath']. This is an absolute path. Every user can hav its own folder. Use the variable %u for the username in the path.

How can I update elFinder?

elFinder is located in the separate subfolder "elfinder" of the plugin. In principle, this folder can be overwritten with a newer elFinder version. However, since several files have been modified, some files will not be found after such an update.

Why were elFinder files modified?

The only reason for the changes is the request that all requests come from your own server. In the original elFinder, however, several files are loaded from external Cloudflare servers. This has advantages, especially in terms of performance and possible updates. But there are also disadvantages, especially in terms of security and privacy.

Which files have been changed and in what way?

Roughly speaking, the references to all files on //cdnjs.cloudflare.com//.* have been replaced in such a way that the files in question have been downloaded and the path has been changed to local versions of these files. These changes must be made manually during a manual update. For example: //cdnjs.cloudflare.com/ajax/libs/require.js/2.3.5/require.min.js has been changed to js/require.min.js.