https://github.com/jazzband/django-floppyforms

Full control of form rendering in the templates.
https://github.com/jazzband/django-floppyforms

Last synced: 13 days ago
JSON representation

Full control of form rendering in the templates.

• Host: GitHub
• URL: https://github.com/jazzband/django-floppyforms
• Owner: jazzband
• License: other
• Created: 2010-11-24T23:21:33.000Z (almost 14 years ago)
• Default Branch: master
• Last Pushed: 2024-02-02T11:41:30.000Z (9 months ago)
• Last Synced: 2024-07-31T06:11:32.830Z (3 months ago)
• Language: Python
• Homepage: http://django-floppyforms.readthedocs.org/
• Size: 1.89 MB
• Stars: 837
• Watchers: 31
• Forks: 148
• Open Issues: 45
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGES.rst
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

• -awesome-django - django-floppyforms - Full control of form rendering. (Third-Party Packages / Forms)
• awesome-django - django-floppyforms - Full control of form rendering. (Third-Party Packages / Forms)

README

        
django-floppyforms

==================

.. image:: https://jazzband.co/static/img/badge.svg

   :target: https://jazzband.co/

   :alt: Jazzband

.. image:: https://github.com/jazzband/django-floppyforms/workflows/Test/badge.svg

   :target: https://github.com/jazzband/django-floppyforms/actions

   :alt: GitHub Actions

.. image:: https://codecov.io/gh/jazzband/django-floppyforms/branch/master/graph/badge.svg

   :target: https://codecov.io/gh/jazzband/django-floppyforms

   :alt: Coverage

Full control of form rendering in the templates.

* Authors: Gregor Müllegger and many many `contributors`_

* Original creator: Bruno Renié started this project and kept it going for many years.

* Licence: BSD

* Requirements: homework -- read `this`_.

.. _contributors: https://github.com/jazzband/django-floppyforms/contributors

.. _this: http://diveintohtml5.info/forms.html

Installation

------------

* ``pip install -U django-floppyforms``

* Add ``floppyforms`` to your ``INSTALLED_APPS``

For those who want to mix and match with vanilla Django widgets, it is also recommended

to put Django's form template directory into your template directories::

    # in your template configuration

    TEMPLATES = [{

        ...,

        # inside the directories parameter

        'DIRS': [

            # include django's form templates

            os.path.join(

                os.path.dirname(django.__file__), "forms/templates/"

            ),

            ... # the rest of your template directories

    }]

For extensive documentation see the ``docs`` folder or `read it on

readthedocs`_

.. _read it on readthedocs: http://django-floppyforms.readthedocs.org/

To install the `in-development version`_ of django-floppyforms, run ``pip

install "https://github.com/jazzband/django-floppyforms/tarball/master#egg=django-floppyforms"``.

.. _in-development version: https://github.com/jazzband/django-floppyforms

Help

----

Create a ticket in the `issues section on github`_ or ask your questions on the

#django-floppyforms IRC channel on freenode.

You can get professional consulting regarding django-floppyforms or any other

Django related work from django-floppyforms' maintainer `Gregor Müllegger`_.

.. _issues section on github: https://github.com/jazzband/django-floppyforms/issues

.. _Gregor Müllegger: http://gremu.net/

Bugs

----

Really? Oh well... Please Report. Or better, fix :) We are happy to help you

through the process of fixing and testing a bug. Just get in touch.

Development

-----------

Thanks for asking!

Get the code::

    git clone [email protected]:jazzband/django-floppyforms.git

    cd django-floppyforms

    virtualenv env

    source env/bin/activate

    add2virtualenv .

Install the development requirements::

    pip install "tox>=1.8"

Currently, you'll need to `install the GeoDjango requirements`_ when running tests.

.. _install the GeoDjango requirements: https://docs.djangoproject.com/en/3.0/ref/contrib/gis/install/geolibs/

Run the tests::

    tox

    tox -e py36-22

You can see all the supported test configurations with ``tox -l``.