Skip to main content

Full control of form rendering in the templates

Project description

django-floppyforms
==================

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/gregmuellegger/django-floppyforms/contributors
.. _this: http://diveintohtml5.info/forms.html

********************************************
* THIS IS AN UNOFFICIAL FORK FROM django-floppyforms
* It fixes support of Django 1.11
* USE WITH CARE
********************************************


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


* ``pip install -U apidev_django-floppyforms``
* Add ``floppyforms`` to your ``INSTALLED_APPS``

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/gregmuellegger/django-floppyforms/tarball/master#egg=django-floppyforms"``.

.. _in-development version: https://github.com/gregmuellegger/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/ljean/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 git@github.com:ljean/django-floppyforms.git
cd django-floppyforms
virtualenv -p python2 env
source env/bin/activate
add2virtualenv .

Install the development requirements::

pip install "tox>=1.8"

Run the tests::

tox -e py27-16

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


Changelog
---------

1.8.0 (in development)
~~~~~~~~~~~~~~~~~~~~~~

* `#176`_: Fix HTML validation for hidden textarea used with GIS widgets.
* `#191`_: Support for Django 1.10. Thanks to MrJmad for the patch.
* `#194`_: Remove official support for Python 2.6 and Python 3.2.

.. _#176: https://github.com/gregmuellegger/django-floppyforms/issues/176
.. _#191: https://github.com/gregmuellegger/django-floppyforms/pull/191
.. _#194: https://github.com/gregmuellegger/django-floppyforms/pull/194

1.7.0
~~~~~

* `#171`_: Fix path to GIS widget images in ``openlayers.html`` template. The
files coming with Django admin where used, but the naming changed in 1.9. We
vendor these know to have better control over it.
* `#174`_: Support for setting your own Google Maps key in the
``BaseGMapWidget``. `See the documentation
<http://django-floppyforms.readthedocs.io/en/latest/geodjango.html>`_ for
details

.. _#171: https://github.com/gregmuellegger/django-floppyforms/issues/171
.. _#174: https://github.com/gregmuellegger/django-floppyforms/pull/174

1.6.2
~~~~~

* `#169`_: Use the attributes ``ClearableFileInput.initial_text``,
``ClearableFileInput.input_text``,
``ClearableFileInput.clear_checkbox_label`` to determine the used text in the
template. This was inconsistent so far with Django's behaviour.

.. _#169: https://github.com/gregmuellegger/django-floppyforms/issues/169

1.6.1
~~~~~

* `#167`_: Fix django-floppyforms' ``CheckboxInput.value_from_datadict`` which
was inconsistent with Django's behaviour.

.. _#167: https://github.com/gregmuellegger/django-floppyforms/issues/167

1.6.0
~~~~~

* `#160`_: Django 1.9 support! Thanks to Jonas Haag for the patch.

.. _#160: https://github.com/gregmuellegger/django-floppyforms/pull/160

1.5.2
~~~~~

* `#156`_: The ``min``, ``max``, ``step`` attributes for ``DecimalField`` and
``FloatField`` were localized which can result in invalid values (rendering
``0.01`` as ``0,01`` in respective locales). Those attributes won't get
localized anymore. Thanks to Yannick Chabbert for the fix.

.. _#156: https://github.com/gregmuellegger/django-floppyforms/pull/156

1.5.1
~~~~~

* `FloatField`` now fills in ``min``, ``max``, and ``step`` attributes to match
the behaviour of `DecimalField`. Leaving out the ``step`` attribute would
result in widgets that only allow integers to be filled in (HTML 5 default
for ``step`` is ``1``).

1.5.0
~~~~~

* `#148`_: Added support for custom ``label_suffix`` arguments in forms and fields.
* The contents in ``floppyforms/input.html`` is now wrapped in a ``{% block
content %}`` for easier extending.
* `#70`_: `DecimalField`` now fills in ``min``, ``max``, and ``step`` attributes for
better client side validation. Use the ``novalidate`` attribute on your
``<form>`` tag to disable HTML5 input validation in the browser. Thanks to
caacree for the patch.

.. _#148: https://github.com/gregmuellegger/django-floppyforms/issues/148
.. _#70: https://github.com/gregmuellegger/django-floppyforms/issues/70

1.4.1
~~~~~

* Fixed source distribution to include all files in
``floppyforms/static/floppyforms/openlayers``.

1.4.0
~~~~~

* Every widget is now using its own template. Previously all widgets that are
based on the HTML ``<input>`` tag used the generic ``floppyforms/input.html``
template. Now the widgets each have a custom element for easier
customisation. For example ``CheckboxInput`` now uses
``floppyforms/checkbox.html`` instead of ``floppyforms/input.html``. See
`Widgets reference
<http://django-floppyforms.readthedocs.org/en/latest/widgets-reference.html>`_
for a complete list of available widgets and which templates they use.

* Adjusting the SRIDs used in the GeoDjango widgets to conform with
Django 1.7. Thanks to Tyler Tipton for the patch.

* Python 3.2 is now officially supported.

* Django 1.8 is now officially supported. django-floppyforms no longers
triggers Django deprecation warnings.

* Adding `OpenLayers`_ distribution to django-floppyforms static files in order
to better support HTTPS setups when GIS widgets are used (See #15 for more
details).

* Fix: ``python setup.py bdist_rpm`` failed because of wrong string encodings
in setup.py. Thanks to Yuki Izumi for the fix.

* Fix: The ``CheckboxInput`` widget did detect different values in Python 2
when given ``'False'`` and ``u'False'`` as data. Thanks to @artscoop for the
patch.

* Fix: ``MultipleChoiceField`` can now correctly be rendered as hidden field by
using the ``as_hidden`` helper in the template. That was not working
previously as there was no value set for ``MultipleChoiceField.hidden_widget``.

.. _OpenLayers: http://openlayers.org/

1.3.0
~~~~~

* DateInput widget renders hardcoded "%Y-%m-%d" format. We don't allow custom
formats there since the "%Y-%m-%d" format is what browsers are submitting
with HTML5 date input fields. Thanks to Bojan Mihelac for the patch.

* Adding ``supports_microseconds`` attribute to all relevant widget classes.
Thanks to Stephen Burrows for the patch.

* Using a property for ``Widget.is_hidden`` attribute on widgets to be in
conformance with Django 1.7 default widget implementation.

* The docs mentioned that the current ``ModelForm`` behaviour in
``floppyforms.__future__`` will become the default in 1.3. This is postpone
for one release and will be part of 1.4.

1.2.0
~~~~~

* Subclasses of ``floppyforms.models.ModelForm`` did not convert widgets of
form fields that were automatically created for the existing model fields
into the floppyform variants. This is now changed, thanks to a patch by
Stephen Burrows.

Previously you had to set the widgets your self in a model form. For example
you would write::

import floppyforms as forms

class ProfileForm(forms.ModelForm):
class Meta:
model = Profile
widgets = {
'name': forms.TextInput,
'url': forms.URLInput,
...
}

Now this is done automatically. But since this is a kind-of
backwardsincompatible change, you need to use a special import::

import floppyforms.__future__ as forms

class ProfileForm(forms.ModelForm):
class Meta:
model = Profile

This feature will become the default behaviour in floppyforms 2.0.

See the documentation for more information:
http://django-floppyforms.readthedocs.org/en/latest/usage.html#modelforms

* If you added an attribute with value 1 to the attrs kwargs (e.g. ``{'value':
1}``, you would get no attribute value in the rendered html (e.g. ``value``
instead of ``value="1"``). That's fixed now, thanks to Viktor Ershov for the
report.

* All floppyform widget classes now take a ``template_name`` argument in the
``__init__`` and ``render`` method. Thanks to Carl Meyer for the patch.

1.1.1
~~~~~

* Fix for Django 1.6

* Fix for GIS widgets on Django 1.4 and some versions of GEOS.

1.1
~~~

* Added GenericIPAddressField.

* Django 1.5 and Python 3.3 support added.

* Django 1.3 support dropped.

* GIS widgets switched to stable OpenLayers release instead of a dev build.

* Fixed ``Textarea`` widget template to work with a non-empty
``TEMPLATE_STRING_IF_INVALID`` setting. Thanks to Leon Matthews for the
report.

* Fixed context handling in widget rendering. It didn't take care of popping
the context as often as it was pushed onto. This could cause strange
behaviour in the template by leaking variables into outer scopes. Thanks to
David Danier for the report.

* Added missing empty choice for selectboxes in ``SelectDateWidget``. Thanks
fsx999 for the report.

* ``IntegerField`` now automatically passes its ``min_value`` and
``max_value`` (if provided) to the ``NumberInput`` widget.

* Added basic support for ``<datalist>`` elements for suggestions in
``Input`` widgets.

* ``date``, ``datetime`` and ``time`` inputs are not localized anymore. The
HTML5 spec requires the rendered values to be RFC3339-compliant and the
browsers are in charge of localization. If you still want localized
date/time inputs, use those provided by Django or override the
``_format_value()`` method of the relevant widgets.

1.0
~~~

* cleaned up the behaviour of ``attrs``
* compatible with Django 1.3 and 1.4
* ``<optgroup>`` support in select widgets
* ``Select`` widgets: renamed ``choices`` context variable to ``optgroups``.
This is **backwards-incompatible**: if you have custom templates for
``Select`` widgets, they need to be updated.
* ``get_context()`` is more reliable
* Added ``form``, ``formrow``, ``formfield``, ``formconfig`` and ``widget``
template tags.
* Added template-based form layout system.
* Added ability to render widgets with the broader page context, for
instance for django-sekizai compatibility.

0.4
~~~

* All widgets from Django have their floppyforms equivalent
* Added widgets for GeoDjango

Download files

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

Source Distribution

apidev_django-floppyforms-1.7.2.tar.gz (1.4 MB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page