Code


Version 29 (modified by gamesbook, 11 months ago) (diff)

Removed AcmeIntranet1 from name of installed app (otherwise you get a "Error: No module named ...")

Django Cheat Sheet

The django tutorials are quite good. The goal of this cheat sheet is to create a quick start guide so that after reading the tuts over once or twice you have a more handy reference. Things in this guide are done the 'right' way with generic views and templates right off the bat. Please please add to this page.

(It would be great if some of the stuff from this page could later be rolled in to the startproject command and handled automatically - SimonWillison)

Starting a project…

django-admin.py startproject AcmeIntranet
cd AcmeIntranet
mkdir templates
mkdir media

settings.py

  • edit your database settings
  • set path to media dir ( e.g. /home/joe/AcmeIntranet/media )
    • media contains public files such as css and js files
  • set path to template dir ( e.g. /home/joe/AcmeIntranet/templates )
    • templates contains django html templates
    • your applications will likely have their own template dirs. Remember to add those as you create them ( e.g. /home/joe/AcmeIntranet/templates/invoices )
python manage.py syncdb

Creating an invoices application…

python manage.py startapp invoices

add 'AcmeIntranet.invoices', to INSTALLED_APPS list in settings.py

Create your data model

from django.db import models
from django.contrib.auth.models import User

class Ticket (models.Model):
    user = models.ForeignKey (User) 
    case_number = models.IntegerField()
    dollar_amount = models.DecimalField('Cost (in dollars)', max_digits=10, decimal_places=2)

    def __unicode__(self):
            return u"%s" % self.id

see: model api, model examples

add your app to INSTALLED_APPS in settings.py:

INSTALLED_APPS = (
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.sites',
    'django.contrib.messages',
    # Uncomment the next line to enable the admin:
    'django.contrib.admin',
    'invoices',
)

validate your model and commit to database:

python manage.py validate
python manage.py sql invoices
python manage.py syncdb

optionally register your model with the administrative interface (if you have the admin enabled under INSTALLED_APPS in settings.py), so you get a CRUD UI for free:

# In admin.py in the invoices directory...

import models
from django.contrib import admin

admin.site.register(models.Ticket)

Design your urls

in the project root directory, edit urls.py:

(r'^invoices/', include('AcmeIntranet.invoices.urls')),

in the invoices app directory create urls.py:

from django.conf.urls.defaults import *
from models import Ticket

info_dict = {
    'queryset': Ticket.objects.all()
}

urlpatterns = patterns('',
    (r'^$', 'django.views.generic.list_detail.object_list', info_dict),
    (r'^new/$', 'django.views.generic.create_update.create_object', { 'model': Ticket } ),
    (r'^(?P<object_id>\d+)/$', 'django.views.generic.list_detail.object_detail', info_dict),
)

see: generic views

Create your templates

First create Acme_base.html in templates

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
    <title>{% block title %}My amazing site{% endblock %}</title>
</head>

<body>
    <div id="content">
        {% block content %}{% endblock %}
    </div>
</body>
</html>

Next create ticket_list.html in templates/invoices

{% extends "Acme_base.html" %}

{% block title %} Listing Invoices {% endblock %}

{% block content %}
    {% for invoice in object_list %}
        <p>{{ invoice.dollar_amount }}</p>
    {% endfor %}
{% endblock %}

See also:

http://www.revsys.com/django/cheatsheet/

http://www.mercurytide.co.uk/news/article/django-cheat-sheet/

http://code.djangoproject.com/wiki/TemplateTagsCheatSheet

and if you are a mindmap fan: http://code.djangoproject.com/wiki/MindmapCheatsheetForGenericViewsAPI

see: template authoring guide