django-bootstrap3

Bootstrap support for Django projects

Project Description

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

Looking for Bootstrap 4?

See https://github.com/zostera/django-bootstrap4.

Requirements

Python 2.7, 3.3, 3.4, or 3.5
Django >= 1.8
For details, see https://docs.djangoproject.com/en/dev/faq/install/#faq-python-version-support

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

Installation

Install using pip:

pip install django-bootstrap3

Alternatively, you can install download or clone this repo and call pip install -e ..
Add to INSTALLED_APPS in your settings.py:

'bootstrap3',
In your templates, load the bootstrap3 library and use the bootstrap_* tags:

Example template

{% 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 file for details.

Author

Developed and maintained by Zostera.

Original author & Development lead: Dylan Verheul.

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

Please see AUTHORS.rst for a list of contributors.

History

9.1.0

Mention django-bootstrap4 in README
Rewrite tox test matrix to focus on Django releases rather than Python versions
Add tests for Django master branch (>= 2)
Add label override for {% bootstrap_field %}

9.0.0 (2017-07-11)

Renamed requirements-dev.txt back to requirements.txt because that suits ReadTheDocs better
Added error_types support on bootstrap3_form (thanks @mkoistinen and @ickam)
BREAKING Default setting of error_types to non_field_errors is different fro behavior in versions < 9

8.2.3 (2017-05-05)

Renamed requirements.txt to requirements-dev.txt
Tweaks to tests and CI (see #400)
Prepared test for geometry fields (disabled, blocked by Django update, see #392)
Bug fixes for add ons and placeholders (thanks @jaimesanz, @cybojenix and @marc-gist)
Improve documentation for pagination with GET parameters (thanks @nspo)
Add unicode test for help_text
Removed tests for Python 3.2 from tox and Travis CI (no longer supported by Django 1.8)

8.2.2 (2017-04-03)

Fix invalid HTML in help texts (thanks @luksen)
Added mark_safe to placeholder (thanks @ppo)
Fix DateWidget import for newer Django versions (thanks @clokep)

8.2.1 (2017-02-23)

Support for local languages in url_replace_param on Python 2 (#362, thanks @aamalev)
Correct checking Mapping instance (#363, thanks @aamalev)
Fix Django 1.11 import bug (see #369)
Add Django 1.11 and Python 3.6 to tests
Fix sdist issue with .pyc files

8.1.0 (2017-01-12)

Rolled back subresource integrity (see #353)
Documentation fix (thanks @clokep)

8.0.0 (2017-01-06)

BREAKING For Django >= 1.10 Remove everything to do with setting HTML attributes required (#337) and disabled (#345)
Add id parameter to bootstrap_button (#214)
Add set_placeholder to field and form renderers (#339, thanks @predatell)
Default button type to btn-default
Add addon_before_class and addon_after_class (#295, thanks @DanWright91 and others)
Fix handling of error class (#170)
No size class for checkboxes (#318, thanks @cybojenix)
Fix warnings during install (thanks @mfcovington)
Fix rare RunTimeError when working without database (#346, thanks @Mactory)
Add subresource integrity to external components (thanks @mfcovington and @Alex131089)
Several improvements to documentation, tests, and comments. Thanks all!

7.1.0 (2016-09-16)

Print help text and errors in their own block (#329, thanks @Matoking)
Improved page urls in pagination (fixes #323)
Changed setup.py to allow setup.py test run tests
Removed link target from active page in pagination (fixes #328)
Fixed example for bootstrap_label (fixed #332)
Fixed tests to support Django 1.10 handling of required attribute, see #337 (needs fixing)
Added tests for Django 1.10
Bootstrap to 3.3.7

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)