Installation

This text was copied from the django-filebrowser project on Google Code and updated for this wiki markup and the no-grappelli version.

Basic Installation

Install the FileBrowser

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

git clone git://github.com/wardi/django-filebrowser-no-grappelli.git

Copy media

Copy the folder /media either to your admin media directory or to your preferred media directory (in this case, you have to edit URL_FILEBROWSER_MEDIA in fb_settings).

Add filebrowser to INSTALLED_APPS.

Open your projects settings file (settings.py) and add the filebrowser to INSTALLED_APPS.

Change fb_settings.py

Either change fb_settings.py or overwrite the filebrowser settings in your project settings file (settings.py). See Available Settings.

Note: You do need an upload directory. The default one is “uploads” inside your MEDIA_ROOT. Check URL_WWW and PATH_SERVER if you change this directory.

Change your urls.py

Add the following line before the admin URLs:

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

Add the FileBrowser to your Admin Index page

Edit /templates/admin/index.html and add this code before {% for app in app_list %}:

{% include 'filebrowser/append.html' %}

That’s it!

Troubleshooting

There are problems with the upload using wsgi version less than 2.4. Make sure you have a more updated version.

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).