Skip to main content

A repository of Bootstrap CRUD templates for Django.

Project description

Django has freed the developer from the toil of writing boilerplate view logic via its class-based view; and Bootstrap, the toil of designing aesthetic CSS+HTML components.

Django Bootstrap CRUD Templates seeks to unite the two, thus allowing developers to simply write class-based views and then select, or extend a chosen Bootstrap template.

Demo

Installation

  1. pip install django-bootstrap-crud-templates

  2. Add 'bsct' in the INSTALLED_APPS list in your project’s settings module.

Usage

Django Bootstrap CRUD Templates provides a repository of Bootstrap-integrated Django templates. These templates are designed to work directly with the context variables provided by the Django Class-Based View and the attributes provided by the Django model.

Model Requirements

In order to make the most use of the features, the Model should have a few attributes defined:

  • Instance methods:
    • get_absolute_url: Returns the url to view the instance. ( Minimum requirement )

    • get_delete_url: Returns the url to delete the instance.

    • get_update_url: Returns the url to update the instance.

    • get_list_url: Returns the url to list all instances.

  • Class methods:
    • get_create_url: Returns the url to create an instance.

For example, with a delete url named ‘widget_delete’, get_delete_url may be defined as:

def get_delete_url( self ):
    return reverse( 'widget_delete', kwargs = {'pk' : self.pk } )

You can skip defining these methods by adding the BSCTModelMixin to your model and simply naming the corresponding URLs in the following way:

  • lowercasemodelname_detail: For the DetailView.

  • lowercasemodelname_create: For the CreateView.

  • lowercasemodelname_list: For the ListView.

  • lowercasemodelname_update: For the UpdateView.

  • lowercasemodelname_delete: For the DeleteView.

Customizing display of model fields

The default detail views simply print the value of each field. If you desire something more than the printed value for any field, simply define a detail method (‘_detail’) for that field:

class Widget( models.Model )
    sku = models.IntegerField()

    def sku_detail( self ):
        return 'SKU_%d' % ( self.sku )

View Requirements

To use a template directly, simply assign its name to the template_name attribute of the class-based view.

# in views.py
class CreateWidget( generic.CreateView ):
    model = models.Widget
    template_name = 'bsct/plain/form.html'

Template Requirements

By default, the template extends from ‘base.html’ and populates the block BSCT_MAIN. Therefore, you will need to have a template named ‘base.html’ and it must contain the block BSCT_MAIN

# base.html
{% block BSCT_MAIN %}
{% endblock %}

If you want to use the CDN-delivered version of Bootstrap included in the package make sure your base template also defined the block BSCT_CSS

# base.html
{% block BSCT_CSS %}
{% endblock %}

</head>
<body>

{% block BSCT_MAIN %}
{% endblock %}

If you wish to have the template extend from a template other than ‘base.html’, simply provide its name as the value for the context variable ‘bsct_base’.

#in views.py
class CreateWidget( generic.CreateView ):
    model = models.Widget,
    template_name = 'bsct/plain/form.html'

    def get_context_data(self, **kwargs):
        context = super(CreateWidget, self).get_context_data(**kwargs)

        context[ 'bsct_base' ] = 'my_special_widget_base.html'
        return context

Automatic Generation of Views and URLs

You can skip the manual definition of both views and their URLs by using bsct.urls.URLGenerator to generate a set of URLs (and views) and including them in your applications urlpatterns:

   from bsct.urls import URLGenerator
   from crud import models

   bsct_patterns = URLGenerator( models.Widget ).get_urlpatterns()

   urlpatterns = patterns( '',
       url( '', include( bsct_patterns ) )
   )

You may also choose to have only a select few of the URLs automatically generated::

   urlpatterns = patterns( '',

           url( '',

               # Automatically generate the list and delete url+view.
               URLGenerator( models.Widget ).get_delete_url(),
               # Pass parameters to the generic ListView.
               URLGenerator( models.Widget ).get_list_url( paginate_by = 3 ),

               # Use our custom create view.
               url(
                   r'^widget/create/(?P<id>\d+)/$',
                   MyWidgetCreateView.as_view(),
                   name = 'widget_create'
               ),
           )
       )

Template Customization

Customizing these templates is as simple as creating your own template and including the desired Django Bootstrap CRUD Templates template.

# widget_list.html
{% extends 'bsct/plain/list.html' %}

{% block BSCT_LIST_ACTIONS %}
    <a href='{% object.use_widget %}'> Use Widget </a>
{% endblock %}

The default ‘bsct/base.html’ links to a CDN-hosted minified Bootstrap CSS file. If you prefer to use your own version, simply override the block BSCT_BOOTSTRAP_CDN.

{% block BSCT_BOOTSTRAP_CDN %}
{% endblock %}

Built for developers, by developers

Django Bootstrap CRUD Templates is an open source project that ultimately aims to host a collection of user-submitted Bootstrap template-sets for Django.

If you have a set of Bootstrap templates you wish to include, simply follow the five steps below (assuming you have a GitHub account):

  1. Fork and clone https://github.com/Alem/django-bootstrap-crud-templates.

  2. Ensure your set has at least two of the following templates:

    • form.html

    • list.html

    • detail.html

    • confirm_delete.html

  3. (optional) Create a README.rst with a brief description of the template set and any other pertinent information ( external dependencies, author, homepage ).

  4. Place all the files in “bsct/templates/yourthemename/”.

  5. Pull.

All contributed templates inherit the license of the encompassing project.

Project details


Download files

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

Source Distribution

django-bootstrap-crud-templates-1.0.15.tar.gz (17.1 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page