Quickstart
============

So you have set of data you want to display. You would like to django handle sorting and paging automatically. Let's face it: it ain't gonna happen.
However, with a little of your time and patience, we can make things easier.

In the following tutorial, we are going to create a grid of fails. Well, at least i'm going to.

Let's create a django model to display data from:
::

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


  class Fail(models.Model):
      name   = models.CharField(max_length=32)
      added  = models.DateTimeField(auto_now_add=True)
      author = models.ForeignKey(User)
      

Step 1: Create a grid
---------------------

::

  from grid import Grid
  from fail.models import Fail


  class FailsGrid(Grid):
    class Meta:
      model = Fail
      
Step 2: Display a grid
----------------------
In order to display a grid, you need to include it's template inside of yours. This would be an example of such action:
::

  from fail.grids import FailsGrid
  def my_view(request):   
    grid = FailsGrid(request)
    
    return render_to_response(
      request,
      {
	'grid': grid
      }
    )
      
Let's not forget the template part:
::

  {% include "grid/object_list.html" %}
  
That's it! You've completed the tutorial. You can now start to read deeper...

Pics or it didn't happen!
-------------------------

.. image:: images/grid.png