1/ Licenses, and embedded libraries that were removed
-----------------------------------------------------

eXtplorer had many embedded libraries, so I have worked with the upstream
author to remove, and/or package them all separately. This version of the
source package have the following embedded libraries removed:

- editarea
- extjs3
- yui
- SWFUpload (swf binary file only, the rest of is still in the upstream
tarball in Debian main).

The above may be found in upstream scripts.tar.gz (which is shipped already
extracted in this Debian package).

plus some PHP pear packages in the "libraries" folder:
- php/System
- php-service-json
- php-geshi
- php/Net/FTP
- php/Archive/Tar
- php/Console
- php/Auth/Auth.php
- php/Auth/HTTP
- php/MIME

These php library are packaged separately in Debian (some of the packages are
maintained by the maintainer of this package, some were already present in the
Debian archives).

The files libraries/inputfilter.php, libraries/lib_zip.php, include/* and
many others are forks of other projects, so I had to leave the modified
versions in. See the copyright file for the list and more details about
their respective licenses.

If I have missed some libraries that should be packaged separately (which I
don't think happened, as I have read all file headers), let me know, and I
will separate them from the binary packages.

Also, as I wanted to address the potential wrong unix access right issue, and
because some symlinks had to be created to replace the removed library files,
I have created a Makefile that does the installation of all the PHP scripts
in $(DESTDIR), to ease my maintainer work.

As all the source code of separate libraries was creating an unnecessary mess
in my debian/copyright file, I have decided to create a +dfsg orig.tar.gz.
I don't think it's a good idea as well to have upstream's embedded code in
the orig.tar.gz, as it can get outdated anyway. To remove all these libraries,
and rebuild a new updated orig.tar.gz, you can run the very trivial maintainer
script debian/create_dfsg_from_upstream.

2/ Setting-up
-------------
Once the extplorer Debian package is installed, you need to add an Alias
directive to your web server configuration. Under Apache, it's done this
way:

Alias /extplorer /usr/share/extplorer

Once you have the extplorer package installed in your server, you need to
initialise the password authentication system. As I found having admin/admin
by default quite insecure, I have moved away the /etc/extplorer/.htusers.php.
If you want, you can do:

cat /usr/share/doc/extplorer/example.dot.htusers.php >/etc/extplorer/.htusers.php

Then login into eXtplorer's interface. For most it will be through an URL like
this one:

http://1.2.3.4/extplorer/

Then login as admin / admin. You will then be prompted to change this
default password.

3/ SWFUpload removal
--------------------
As the original tarball included a SWF binary, and that I know absolutely
nothing about Flash action scripts, I have for the moment remove the
swfupload.swf file from the upstream tarball (otherwise, this is a serious
violation of the Debian policy, which forces everyone to build from source, and
to not just include binaries, which is a very good thing that forces people to
make sure any software in the Debian archive can be modified).

So, of course, the final result is that upload will NOT work in extplorer,
unless you manually add this file in the following path:

/usr/share/extplorer/scripts/extjs3-ext/ux.swfupload/swfupload.swf

This file can be found at:

http://code.google.com/p/swfupload/

If you don't manually add the swfupload.swf file, then everything else will
continue to work, only upload will be broken, which may not be an issue if you
have a server that does scp / ftp. It's still nicer to add it in your server
if you can. Volunteers to package the Adobe swf build tools in Debian would be
of course warmly welcome (according to pabs, these are under the MPL, which
makes it a valid candidate for main). That would be the only way, as the swf
upload library is using action script 3, which doesn't build with mtasc.

The maintainer,

Thomas Goirand <zigo@debian.org>
