Skip to main content

Heirarchical categories/taxonomies for your Django project

Project description

# Aldryn Categories

Aldryn Categories is a simple project that provides hierarchical categories as an independent model in your project. Categories are similar to tags, but are structured into a taxonomy. The project is suitable for I18N projects as Categories are fully translatable.

### Dependencies/Support

  1. Python v2.7+
  2. Django v1.6.x + South v1.0.2 or Django v1.7+
  3. django-treebeard v2.0+
  4. django-parler v1.2.1+

## Installation & Usage

To use Aldryn Categories, install the package with either:

pip install aldryn-categories

Or directly from the GitHub repository with:

pip install https://github.com/aldryn/aldryn-categories/archive/master.zip

Next, add aldryn_categories to your INSTALLED_APPS.

Now, add a CategoryManyToManyField to aldryn_categories.Category on any models you wish to categorize, like so:

# -- coding: utf-8 --

from django.db import models from aldryn_categories.fields import CategoryManyToManyField

class Thing(models.Model):
my_field = models.CharField(…) … categories = CategoryManyToManyField(‘aldryn_categories.Category’)

This usage of the CategoryManyToManyField simply allows your categories to be displayed heirarchically in the otherwise normal MultipleSelectWidget like so:

![](diagrams/category-widget-preview.png?raw=true)

Project details


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
aldryn-categories-0.1.0.tar.gz (6.2 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page