Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A token field for Django
JavaScript Python Shell
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
django_tokenfield
docs
example
tests
.gitignore
LICENSE
MANIFEST.in
README.rst
setup.py

README.rst

django-tokenfield - A token based form field+widget for Django

django-tokenfield provides a token based form field for Django. Its interface is very similar to the message recipient input on Facebook or iOS. It behaves as a normal text field but allows custom placeholders to be inserted at any position.

It allows normal string data that may contain predefined placeholder tokens.

One use-case is when you want to collect a "destination filename" for a set of records

It's original use was in a tool that allowed database records to be dumped to individual files.

Its features include:

Dependencies

  • knockout.js
  • jQuery

Using the field is as simple as:

from django_tokenfield import TokenField

class ArticleTemplate(forms.Form):
    title = TokenField()

import django_tables2 as tables

class SimpleTable(tables.Table):
    class Meta:
        model = Simple

This would then be used in a view:

def simple_list(request):
    queryset = Simple.objects.all()
    table = SimpleTable(queryset)
    return render_to_response("simple_list.html", {"table": table},
                              context_instance=RequestContext(request))

And finally in the template:

{% load django_tables2 %}
{% render_table table %}

This example shows one of the simplest cases, but django-tables2 can do a lot more! Check out the documentation for more details.

Building the documentation

If you want to build the docs from within a virtualenv, use:

make html SPHINXBUILD="python $(which sphinx-build)"
Something went wrong with that request. Please try again.