Skip to main content

django-fileman handles user-uploaded static files (images, media, documents) and integrates with tinymce

Project description

django-fileman adds user-uploaded static files to the django admin (i.e. images, media, documents) and integrates with tinymce

Circle CI codecov Latest Version

Requirements

  • Python 2.7, 3.4 or 3.5
  • Django 1.8+

Installation

  1. Download the source from https://pypi.python.org/pypi/django-fileman/ and run python setup.py install, or:

    > pip install django-fileman
    
  2. Add fileman to INSTALLED_APPS

  3. Set FILEMAN_DIRECTORY to a subdirectory of your MEDIA_ROOT (make sure it exists, it won’t be created). Defaults to 'user'

  4. Make sure the django admin is installed correctly

Usage

You should now have an “Uploads” section in your django admin which allows you to manage/upload files under your FILEMAN_DIRECTORY.

TinyMCE

There are two options for TinyMCE integration. The simplest is to set TinyMCE’s link_list parameter to the url for ‘admin:fileman_link_list’, i.e.

tinymce.init({
  selector: 'textarea',
  plugins : 'link',
  link_list: '{% url "admin:fileman_link_list" %}',
  toolbar: 'link'
});

this should work with any modern TinyMCE version (from 3 onwards)

Alternately, set TinyMCE’s file_picker_callback option to integrate with the image, media and link dialogs. For example, in your admin/base_site.html template:

<script type="text/javascript"
        src="{% static 'tinymce/tinymce.min.js' %}"></script>
{% include 'fileman/static.html' %}
<script type="text/javascript" charset="utf-8">
  tinymce.init({
    selector: 'textarea',
    plugins : 'link media image',
    file_picker_callback: window.fileman.tinymceFilePickerCallback,
    toolbar: 'link media image'
  });
</script>

TinyMCE 4.x is required.

Running tests

Use tox (https://pypi.python.org/pypi/tox):

> pip install tox
> cd path-to/django-fileman
> tox

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for django-fileman, version 1.0.3
Filename, size File type Python version Upload date Hashes
Filename, size django-fileman-1.0.3.tar.gz (12.6 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page