django-crispy-formset-modal

django-crispy-formset-modal

Reusable Django app that provides an easy way to manage and manipulate formsets using modals with Django Crispy Forms. It enables you to dynamically add, edit, and delete formsets on the frontend.

Features

• Dynamic formset operations: Add, edit, and delete formsets dynamically in a modal on the frontend.
• Generates an HTML table according to the layout definition, allowing you to determine which fields to display as columns.
• Provides the option to define which numeric fields will be used for a totalizer at the footer of the corresponding field's column.
• Enables mass deletion of records from the HTML table, thanks to the generation of a selection column with checkboxes that can be selected individually or collectively to delete multiple records at once.
• Offers support for various templates packs, including Bootstrap 4, Bootstrap 5, Tailwind, and Bulma.

Dependencies

• Django Crispy Forms: Django Crispy Formset Modal relies on Django Crispy Forms for form rendering
• Django Extra Views: For handling views with formsets.
• jQuery: Used to enable dynamic functionality.

Installation

• Install the package using pip:

pip install django-crispy-formset-modal

• Add crispy_formset_modal to your INSTALLED_APPS in settings.py:

INSTALLED_APPS = [
    ...
    'crispy_formset_modal',
    ...
]

Usage

For detailed instructions on how to use Django Crispy Formset Modal, please refer to the documentation and check out the demo for practical examples.

Examples

The demo provides various examples of how to use Django Crispy Formset Modal in different scenarios.

Running the Demo App Locally

If you'd like to run the demo application on your local machine. Please follow the steps below:

Instructions

First, you need to have uv installed. If you don't have it, you can install it following the official instructions.

• Clone this repository:

  git clone https://github.com/blasferna/django-crispy-formset-modal.git
  cd django-crispy-formset-modal
  

• Set up the project environment:

  uv sync --dev
  

  This single command will:

  • Create a virtual environment in .venv if one doesn't exist.
  • Install all project and development dependencies specified in pyproject.toml into the environment.

• Run development tasks with uv run:

  The uv run command executes scripts within the project's virtual environment, so you don't need to activate it manually.

  Apply database migrations:

  uv run python manage.py migrate
  

  Start the local development server:

  uv run python manage.py runserver
  

• Explore the demo:

  Visit http://localhost:8000 in your browser to see the application.

License

Django Crispy Formset Modal is released under the MIT License.