Metadata-Version: 2.1
Name: django-bootstrap-fields
Version: 0.1.5
Summary: render Django form fields with complete Bootstrap HTML markup
Home-page: https://github.com/mtokoly/django-bootstrap-fields
Author: Matthew Tokoly
Author-email: tokoly@gmail.com
License: MIT
Keywords: fields,forms,bootstrap,django
Platform: UNKNOWN
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: JavaScript
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Description-Content-Type: text/markdown

# Django Bootstrap Fields

`django-bootstrap-fields` provides you with a `{% dbs_field %}` tag that allows you to easily render Django form fields with complete Bootstrap html markup. Works with Bootstrap 3 and 4.

## Installation

Install latest stable version into your python path using `pip`:

~~~~
pip install -U django-bootstrap-fields
~~~~

Add `dbs_fields` to your `INSTALLED_APPS` in `settings.py`:

~~~~
INSTALLED_APPS = (
    ...
    'dbs_fields',
)
~~~~

## Templates

You can set your default template pack for your project using the `DBS_TEMPLATES` Django settings variable:

~~~~
DBS_TEMPLATES = 'bootstrap4'  # Options: 'bootstrap3', 'bootstrap4', 'bootstrap4custom'
~~~~

## Usage

One tag to rule them all! `django-bootstrap-fields` only comes with one easy to use tag that will detect which field is being rendered and style it accordingly.

~~~~
{% dbs_field field inline=True sr_label=True prepend="$" append=".00" %}
~~~~

## Example

~~~~
{% extends "base.html" %}
{% load dbs_tags %}

{% block content %}

<form action="." method="post">
    {% csrf_token %}
    {% for field in form %}
        {% dbs_field field %}
    {% endfor %}
</form>

{% endblock content %}
~~~~

