infinidat-django-bootstrap3 7.0.9
Bootstrap support for Django projects
License: Apache License 2.0
Keywords: infinidat-django-bootstrap3

======
Notice
======

This is a fork of django-bootstrap3, which includes modifications for INFINIDAT's look and feel.
There are small changes in form rendering, as well as three CSS files which should be
included after Bootstrap itself:

- infiniboot.css
- infinidat.css
- opensans.css

Themed components include:

- Buttons
- Labels
- Forms
- Custom checkboxes and radio buttons
- Wells
- Navbars (inverse only)
- Tables
- Tabs
- Pills
- Modals


Themed Checkboxes
-----------------

Here's the markup required for a themed checkbox::

    <div class="themed-checkbox">
        <label>
            <input type="checkbox" name="agree">
            <span></span>
            I agree to the terms and conditions
        </label>
    </div>


Releasing a new version
-----------------------

- Edit the version number in bootstrap3/__init__.py
- Run ``python setup.py sdist upload -r local``


======================
Bootstrap 3 for Django
======================

Write Django as usual, and let ``django-bootstrap3`` make template output into Bootstrap 3 code.


Requirements
------------

- Python 2.7, 3.2, 3.3, 3.4, or 3.5
- Django >= 1.8

*The latest version supporting Python 2.6 and Django < 1.8 is the 6.x.x branch.*


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

1. Install using pip:

   ``pip install django-bootstrap3``

   Alternatively, you can install download or clone this repo and call ``pip install -e .``.

2. Add to INSTALLED_APPS in your ``settings.py``:

   ``'bootstrap3',``

3. In your templates, load the ``bootstrap3`` library and use the ``bootstrap_*`` tags:

This app will soon require Django 1.8+, python 2.7+. Thanks for understanding.


Example template
----------------

   .. code:: Django

    {% load bootstrap3 %}

    {# Display a form #}

    <form action="/url/to/submit/" method="post" class="form">
        {% csrf_token %}
        {% bootstrap_form form %}
        {% buttons %}
            <button type="submit" class="btn btn-primary">
                {% bootstrap_icon "star" %} Submit
            </button>
        {% endbuttons %}
    </form>


Documentation
-------------

The full documentation is at http://django-bootstrap3.readthedocs.org/.


Bugs and suggestions
--------------------

If you have found a bug or if you have a request for additional functionality, please use the issue tracker on GitHub.

https://github.com/dyve/django-bootstrap3/issues


License
-------

You can use this under Apache 2.0. See `LICENSE
<LICENSE>`_ file for details.


Author
------

Developed and maintained by `Zostera <https://zostera.nl/>`_.

Original author & Development lead: `Dylan Verheul <https://github.com/dyve>`_.

Thanks to everybody that has contributed pull requests, ideas, issues, comments and kind words.

Please see AUTHORS.rst for a list of contributors.



History
-------

7.0.1 (2016-03-23)
++++++++++++++++++

* Fixed bug with widget attrs consistency (@onysos)


7.0.0 (2016-02-24)
++++++++++++++++++

* Dropped support for Django < 1.8
* Dropped support for Python < 2.7
* Fix page number bug (thanks @frewsxcv)
* Fix template context warning (thanks @jieter and @jonashaag)
* Update to Bootstrap 3.3.6 (@nikolas)
* Show links and newlines in messages (@jakub3279)
* CSS classes arguments passed to the bootstrap_form are now working (@gordon)
* Support for Django 1.9/Python 3.5 (@jieter and @jonashaag)
* Better Travis CI Django versions (thanks @jonashaag)
* Improved handling of messages in `bootstrap_messages` (thanks @frewsxcv and @rjsparks)


6.2.2 (2015-08-20)
++++++++++++++++++

* Bug fix for escaped icons in buttons (reported by @jlec)


6.2.1 (2015-08-19)
++++++++++++++++++

* Bug fix for whitespace in label placeholders (@Grelek)


6.2.0 (2015-08-15)
++++++++++++++++++

* Improved tests
* Make simple_tag output safe in Django 1.9
* Better support for MultiWidgets (@xrmx)
* Better documentation (@Moustacha)


6.1.0 (2015-06-25)
++++++++++++++++++

* Upgrade to Bootstrap 3.3.5
* Properly quote help text (@joshkel)


6.0.0 (2015-04-21)
++++++++++++++++++

* No more media="screen" in CSS tags, complying to Bootstraps examples


5.4.0 (2015-04-21)
++++++++++++++++++

* No more forcing btn-primary when another button class is specified (@takuchanno2)
* Added value option to buttons (@TyVik)
* Switched CDN to //maxcdn.bootstrapcdn.com/bootstrap/3.3.4/ (@djangoic)


5.3.1 (2015-04-08)
++++++++++++++++++

* Fix Django 1.8 importlib warnings
* Set defaults for horizontal-form to col-md-3 for label, col-md-9 for field
* Various bug fixes
* Fix version number typo


5.2.0 (2015-03-25)
++++++++++++++++++

* Upgrade to Bootstrap 3.3.4
* Fix required bug for checkboxes
* Various bug fixes


5.1.1 (2015-01-22)
++++++++++++++++++

* Fix checkbox display bug


5.1.0 (2015-01-22)
++++++++++++++++++

* Make Bootstrap 3.3.2 default
* Fix issue #140 (bad behaviour in Python 3)


5.0.3 (2014-12-02)
++++++++++++++++++

* Fixing tests for older Django and Python versions


5.0.2 (2014-11-24)
++++++++++++++++++

* Cleaning up some mess in 5.0.1 created by PyPI malfunction


5.0.1 (2014-11-21)
++++++++++++++++++

* Bug fixes and update to Bootstrap 3.3.1


4.11.0 (2014-08-19)
+++++++++++++++++++

* Improved handling and control of form classes for error and success


4.10.1 (2014-08-18)
+++++++++++++++++++

* Bug fixes, test fixes, documentation fixes


4.10.0 (2014-08-12)
+++++++++++++++++++

* Template tag `bootstrap_icon` now supports a `title` parameter


4.9.2 (2014-08-11)
++++++++++++++++++

* Fixed bug causing problems with setting classes for horizontal forms


4.9.1 (2014-08-10)
++++++++++++++++++

* Fixed test for Django 1.4


4.9.0 (2014-08-09)
++++++++++++++++++

* New parameter `href` for `bootstrap_button`, if provided will render `a` tag instead of `button` tag


4.8.2 (2014-07-10)
++++++++++++++++++

* Internal fixes to master branch


4.8.1 (2014-07-10)
++++++++++++++++++

* Make extra classes override bootstrap defaults


4.8.0 (2014-07-10)
++++++++++++++++++

* Introduced new setting `set_placeholder`, default True


4.7.1 (2014-07-07)
++++++++++++++++++

* Fixed rendering of various sizes (as introduced in 4.7.0)
* Upgrade to Bootstrap 3.2.0 as default version


4.7.0 (2014-06-04)
++++++++++++++++++

* `size` option added to formsets, forms, fields and buttons


4.6.0 (2014-05-22)
++++++++++++++++++

* new `bootstrap_formset_errors` tag


4.5.0 (2014-05-21)
++++++++++++++++++

* bug fixes in formsets
* new formset renderer
* new `bootstrap_form_errors` tag


4.4.2 (2014-05-20)
++++++++++++++++++

* documentation now mentions templates


4.4.1 (2014-05-08)
++++++++++++++++++

* bug fixes
* documentation fixes
* test coverage on coveralls.io


4.4.0 (2014-05-01)
++++++++++++++++++

* added `bootstrap_alert` template tag


4.3.0 (2014-04-25)
++++++++++++++++++

* added `required_css_class` and `error_css_class` as optional settings (global) and parameters (form and field rendering)


4.2.0 (2014-04-06)
++++++++++++++++++

* moved styling of form level errors to template
* bug fixes


4.1.1 (2014-04-06)
++++++++++++++++++

* moved all text conversions to text_value


4.1.0 (2014-04-05)
++++++++++++++++++

* typo fix and internal branching changes


4.0.3 (2014-04-03)
++++++++++++++++++

* fixed checkbox label bug in vertical and inline forms


4.0.2 (2014-04-02)
++++++++++++++++++

* fixed bug in vertical form rendering


4.0.1 (2014-03-29)
++++++++++++++++++

* fixed unicode bug and added unicode label to tests


4.0.0 (2014-03-28)
++++++++++++++++++

* use renderer classes for generating HTML
* several bug fixes


3.3.0 (2014-03-19)
++++++++++++++++++

* use Django forms css classes for indicating required and error on fields


3.2.1 (2014-03-16)
++++++++++++++++++

* improved form rendering


3.2.0 (2014-03-11)
++++++++++++++++++

* support for addons


3.1.0 (2014-03-03)
++++++++++++++++++

* improve compatibility with Django < 1.5


3.0.0 (2014-02-28)
++++++++++++++++++

* added support for themes (fix issue #74)
* show inline form errors in field title (fix issue #81)
* fixed bugs in demo application
* update to newest Bootstrap (fix issue #83)


2.6.0 (2014-02-20)
++++++++++++++++++

* new setting `set_required` to control setting of HTML `required` attribute (fix issue #76)


2.5.6 (2014-01-23)
++++++++++++++++++

* project refactored
* added skeleton for creating documentation (fix issue #30)
* fixed `FileField` issues