Skip to main content

Bootstrap support for Django projects

Project description

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

{% 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

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

infinidat-django-bootstrap3-7.0.9.tar.gz (857.9 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page