Basic Installation

1. Install the FileBrowser

Install the FileBrowser anywhere on your python-path. I´m personally using the project-directory.

svn checkout http://django-filebrowser.googlecode.com/svn/trunk/filebrowser/ filebrowser

2. Copy/Symlink Media

Copy the folder /media somewhere to your media-directory and change URL_FILEBROWSER_MEDIA accordingly.
Alternatively, you may want to use a symlink from your media-directory.

3. Add filebrowser to your INSTALLED APPS.

Open your projects settings-file (settings.py) and add the filebrowser to your INSTALLED APPS.

4. Change filebrowser settings.py

Either change settings.py or overwrite the filebrowser settings in your project settings-file. See "Available Settings".

5. Change your urls.py

Add the following line BEFORE the admin-urls:

(r'^admin/filebrowser/', include('filebrowser.urls')),

6. Add the FileBrowser to your Admin Navigation

With using Grappelli, you can add the FileBrowser to your Admin Index Page by changing the Sidebar-Navigation (the FileBrowser is already part of the Grappelli fixtures).

7. That's it.

IMPORTANT: About 90% of the problems installing the filebrowser are related to wrong URLS and/or PATHS. So, please read through Available Settings and check everything with either URL or PATH carefully (especially when using TinyMCE).

Check yourself before you...create an issue

good way to do this (by alper.cugun):

$ python manage.py shell
>>> import django.conf.settings
>>> import filebrowser.settings

Now for all the relevant settings in filebrowser (and maybe also some in django), call them up in the prompt to see what they end up like:

>>> filebrowser.settings.DEFAULT_URL_TINYMCE
'/media/tinymce/jscripts/tiny_mce/'

And check for both URLs and paths if those are reachable existing locations and that they actually contain the things they are supposed to.