skip to navigation
skip to content

Not Logged In

django-bootstrap3 6.2.2

Bootstrap support for Django projects

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

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:

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/.

Requirements

  • Python 2.6, 2.7, 3.2 or 3.3
  • Django >= 1.4

Contributions and pull requests for other Django and Python versions are welcome.

Bugs and requests

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

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
 
File Type Py Version Uploaded on Size
django-bootstrap3-6.2.2.tar.gz (md5) Source 2015-08-20 28KB
  • Downloads (All Versions):
  • 965 downloads in the last day
  • 5804 downloads in the last week
  • 33346 downloads in the last month