skip to navigation
skip to content

djangocms-file 2.0.1

Adds file plugin to django CMS

django CMS File

|pypi| |build| |coverage|

**django CMS File** is a set of plugins for `django CMS <http:"">`_
that allow you to add files to your site You can either choose a single file or
an entire folder.

It uses files managed by `Django Filer <https:"" divio="" django-filer="">`_.

This addon is compatible with `Aldryn <http:"">`_ and is also available on the
`django CMS Marketplace <https:"" en="" addons="" browse="" djangocms-file=""/>`_
for easy installation.

.. image:: preview.gif


This is a an open-source project. We'll be delighted to receive your
feedback in the form of issues and pull requests. Before submitting your
pull request, please review our `contribution guidelines
<http:"" en="" latest="" contributing="" index.html="">`_.

One of the easiest contributions you can make is helping to translate this addon on
`Transifex <https:"" projects="" p="" djangocms-file=""/>`_.


See ``REQUIREMENTS`` in the ` <https:"" divio="" djangocms-file="" blob="" master="""">`_
file for additional dependencies:

* Python 2.7, 3.3 or higher
* Django 1.8 or higher

Make sure `django Filer <http:"" en="" latest="" installation.html="">`_
is installed and configured appropriately.


For a manual install:

* run ``pip install djangocms-file``
* add ``djangocms_file`` to your ``INSTALLED_APPS``
* run ``python migrate djangocms_file``


Note that the provided templates are very minimal by design. You are encouraged
to adapt and override them to your project's requirements.

This addon provides a ``default`` template for all instances. You can provide
additional template choices by adding a ``DJANGOCMS_FILE_TEMPLATES``

('feature', _('Featured Version')),

You'll need to create the `feature` folder inside ``templates/djangocms_file/``
otherwise you will get a *template does not exist* error. You can do this by
copying the ``default`` folder inside that directory and renaming it to

Running Tests

You can run tests by executing::

virtualenv env
source env/bin/activate
pip install -r tests/requirements.txt
python test

.. |pypi| image::
.. |build| image::
.. |coverage| image::
File Type Py Version Uploaded on Size
djangocms-file-2.0.1.tar.gz (md5) Source 2016-09-20 19KB