infinidat-django-bootstrap3

Bootstrap support for Django projects

These details have not been verified by PyPI

Development Status
- 4 - Beta
Environment
- Web Environment
Framework
- Django
Intended Audience
- Developers
License
- OSI Approved :: Apache Software License
Operating System
- OS Independent
Programming Language
Topic
- Software Development :: Libraries
- Utilities

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

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:

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