https://github.com/venkatnvs/nvs-bootstrap-forms

A Django app that provides enhanced form rendering with Bootstrap styles
https://github.com/venkatnvs/nvs-bootstrap-forms

bootstrap django django-package python-package

Last synced: 12 days ago
JSON representation

A Django app that provides enhanced form rendering with Bootstrap styles

• Host: GitHub
• URL: https://github.com/venkatnvs/nvs-bootstrap-forms
• Owner: Venkatnvs
• License: mit
• Created: 2023-12-14T18:48:46.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2023-12-14T19:05:29.000Z (about 1 year ago)
• Last Synced: 2024-01-28T08:09:58.067Z (about 1 year ago)
• Topics: bootstrap, django, django-package, python-package
• Language: Python
• Homepage: https://pypi.org/project/nvs-bootstrap-forms/
• Size: 27.3 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.md
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
=============================

Django Bootstrap Forms (NVS)

=============================

|Latest Version|  |Downloads|  |License|

Django Bootstrap Forms is a Django app that provides enhanced form rendering with Bootstrap styles.

Installation

------------

1. Install the package using pip:

    .. code-block:: bash

    

       pip install nvs-bootstrap-forms

2. Add 'bootstrap_forms' to your `INSTALLED_APPS` in the Django settings:

    .. code-block:: python

    

       INSTALLED_APPS = [

           # ...

           'bootstrap_forms',

           # ...

       ]

       

3. Include Bootstraps css and js links in your html:

    .. code-block:: html

    

        

        

          

            

            

          

          

            

            

          

        

Usage

-----

1. **Load Bootstrap Forms in your template:**

   .. code-block:: html+django

      {% load bootstrap_forms_tags %}

2. **Use the `bootstrap_form` template tag to render your form:**

   .. code-block:: html+django

      

        {% csrf_token %}

        {% bootstrap_form form %}

        Submit

      

   This will render the form with Bootstrap styles.

3. **Customization:**

   - You can customize the rendering of individual fields by using the `field_order` and other attributes in your form fields.

   - For advanced customization, you can extend the provided `BootstrapFormRendererNode` class in the `bootstrap_forms.templatetags.bootstrap_forms_tags` module.

Contributing

------------

Feel free to contribute by opening issues or submitting pull requests. Please read the `Contributing Guidelines `_ for more details.

License

-------

This project is licensed under the MIT License - see the `LICENSE `_ file for details.

.. |Latest Version| image:: https://img.shields.io/pypi/v/django-bootstrap-forms.svg

   :target: https://pypi.python.org/pypi/django-bootstrap-forms

   :alt: Latest Version

.. |Downloads| image:: https://img.shields.io/pypi/dm/django-bootstrap-forms.svg

   :target: https://pypi.python.org/pypi/django-bootstrap-forms

   :alt: Downloads

.. |License| image:: https://img.shields.io/badge/license-MIT-blue.svg

   :alt: License

   :target: https://opensource.org/licenses/MIT