Bootstrap 3 for Django

Bootstrap 3 integration for Django.

Goal

The goal of this project is to seamlessly blend Django and Bootstrap 3.

Want to use Bootstrap 4 in Django?

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

Requirements

• Django 1.11 or Django >= 2.0 with a matching Python version.
• 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 6.x.x.
• The latest version supporting Django < 1.11 is 9.x.x.

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