Metadata-Version: 2.1
Name: fluentcms-file
Version: 2.0.0
Summary: A file plugin for django-fluent-pages
Home-page: https://github.com/bashu/fluentcms-file/
Author: Basil Shubin
Author-email: basil.shubin@gmail.com
License: Apache License, Version 2
Download-URL: https://github.com/bashu/fluentcms-file/zipball/master
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Framework :: Django
Classifier: Framework :: Django :: 2.2
Classifier: Framework :: Django :: 3.0
Classifier: Framework :: Django :: 3.1
Classifier: Framework :: Django :: 3.2
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Description-Content-Type: text/x-rst
Provides-Extra: develop
Provides-Extra: test
License-File: LICENSE
License-File: AUTHORS

fluentcms-file
==============

.. image:: https://img.shields.io/pypi/v/fluentcms-file.svg
    :target: https://pypi.python.org/pypi/fluentcms-file/

.. image:: https://img.shields.io/pypi/dm/fluentcms-file.svg
    :target: https://pypi.python.org/pypi/fluentcms-file/

.. image:: https://img.shields.io/github/license/bashu/fluentcms-file.svg
    :target: https://pypi.python.org/pypi/fluentcms-file/

.. image:: https://app.travis-ci.com/bashu/fluentcms-file.svg?branch=develop
    :target: https://app.travis-ci.com/bashu/fluentcms-file/

A file plugin for django-fluent-contents_

Installation
------------

First install the module, preferably in a virtual environment. It can be installed from PyPI:

.. code-block:: shell

    pip install fluentcms-file


Backend Configuration
~~~~~~~~~~~~~~~~~~~~~

First make sure the project is configured for django-fluent-contents_.

Then add the following settings:

.. code-block:: python

    INSTALLED_APPS += (
        'fluentcms_file',
    )

    # The upload folder for all files
    # Default: '.'
    FLUENTCMS_FILE_UPLOAD_TO = 'uploads/'

The database tables can be created afterwards:

.. code-block:: shell

    python ./manage.py migrate

Now, the ``FilePlugin`` can be added to your ``PlaceholderField`` and
``PlaceholderEditorAdmin`` admin screens.

Frontend Configuration
~~~~~~~~~~~~~~~~~~~~~~

If needed, the HTML code can be overwritten by redefining ``fluentcms_file/file.html``.

Contributing
------------

If you like this module, forked it, or would like to improve it, please let us know!
Pull requests are welcome too. :-)

.. _django-fluent-contents: https://github.com/edoburu/django-fluent-contents

Changes
-------

2.0.0 (2021-11-20)
~~~~~~~~~~~~~~~~~~

* Added Django 3+ support.
* Dropped Python 2.7 support.
* Dropped Django 1.10 / 1.11 support.


