Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

Bootstrap support for Django projects

Project description

https://travis-ci.org/Polyconseil/django-bootstrap4.svg?branch=master Latest PyPI version https://img.shields.io/badge/code%20style-black-000000.svg

Bootstrap 4 integration for Django.

Goal

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

Requirements

Documentation

The full documentation is at https://django-bootstrap4.readthedocs.io/

Installation

  1. Install using pip:

    pip install django-bootstrap4

    Alternatively, you can install download or clone this repo and call pip install -e ..

  2. Add to INSTALLED_APPS in your settings.py:

    'bootstrap4',

  3. In your templates, load the bootstrap4 library and use the bootstrap_* tags:

Example template

{% load bootstrap4 %}

{# 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">Submit</button>
    {% endbuttons %}
</form>

Demo

A demo app is provided in demo. You can run it from your virtualenv with python manage.py runserver.

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/zostera/django-bootstrap4/issues

License

You can use this under BSD-3-Clause. 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

Development

0.0.11 (2019-06-10)

  • Allow to display radio and checkbox elements inline using the form-check classes.

0.0.10 (2019-06-05)

  • Fix form-check-{label,input} classes applied too broadly. These should only be applied to labels and inputs found underneath the enclosing widget div for radio and checkbox select, not on the whole document.

0.0.9 (2019-06-03)

  • Allow to choose which errors are displayed in form alert block
  • Template tag bootstrap_field now allows 3 values for show_label: True, False / ‘sr-only’ and ‘skip’. In the case of False / ‘sr-only’ the label is hidden but present for screen readers. When show_label is set to ‘skip’, the label is not generated at all.
  • Fix validation on input groups (#122)
  • Apply form-check, form-check-label and form-check-input classes to appropriate tags for RadioSelect and CheckboxSelectMultiple widgets

0.0.8 (2019-03-12)

  • Drop support for the base_url setting (#105)
  • Remove use of “falsy” as a string literal (#111)
  • Fix javascript inclusion bugs (#71)
  • Allow email to have addons (#131)
  • Do not mark placeholder text as safe (#135)
  • Adopt black

0.0.7 (2018-08-22)

  • Improve alert accessibility (#93)
  • Add a new widget: RadioSelectButtonGroup (#103)
  • Several fixes and improvements to HTML rendering
  • Switch to explicit Travis tests
  • Upgrade Bootstrap to 4.1.1
  • Upgrade jQuery to 3.3.1
  • Upgrade Popper to 1.14.3
  • Fixed bootstrap4.html to add jQuery per setting ‘include_jquery’ [False|True|’full’|’slim’]
  • Adopt Black formatting, see https://github.com/ambv/black

0.0.6 (2018-02-14)

  • Change form help text element from div to small (#60)
  • Upgrade Bootstrap to 4.0.0 (#66)

0.0.5 (2018-01-03)

  • Drop develop branch, work with master and feature branches
  • Clean up history file
  • Upgrade Bootstrap to 4.0.0-beta.3
  • Use col-4 rather than col-xs-4 (#54)
  • Added pagination alignment options (#56)
  • Fixed form field errors and help texts (#39)
  • Use django language if USE_I18N=True (#53)

0.0.4 (2017-10-26)

  • Upgrade Bootstrap to 4.0.0-beta.2
  • Fix settings, tags and tests for remote JS and CSS

0.0.3 (2017-09-24)

  • Upgraded bootstrap4 to the beta version

0.0.2 (2017-09-06, not released on PyPI)

  • Upgraded jQuery version from CDN to 3.2.1 (#17)
  • Added proper pagination layout classes (#19)

0.0.1 (2017-06-04)

  • First release

Unreleased (2017-04-25)

  • Remove bootstrap_icon, BS4 no longer has default icons.
  • Various changes to get from 3 to 4, started MIGRATE.rst.
  • Started django-bootstrap4 based on django-bootstrap3.
  • Thanks everybody that contributed to django-bootstrap3!

Project details


Download files

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

Files for polyconseil-django-bootstrap4, version 0.0.11
Filename, size File type Python version Upload date Hashes
Filename, size polyconseil-django-bootstrap4-0.0.11.tar.gz (32.7 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page