Bootstrap support for Django projects
Project description
Use Bootstrap in your Django templates, the Django way.
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/.
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.
License
You can use this under Apache 2.0. See LICENSE file for details.
History
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
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.