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.

Filename, size & hash SHA256 hash help File type Python version Upload date
django-fileman-1.0.3.tar.gz (12.6 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page