Metadata-Version: 1.1
Name: aldryn-categories
Version: 0.1.0
Summary: Heirarchical categories/taxonomies for your Django project
Home-page: https://github.com/aldryn/aldryn-categories
Author: Divio AG
Author-email: info@divio.ch
License: LICENSE.txt
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)
Platform: OS Independent
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries
