Skip to main content

A way to handle one or more hierarchical category trees in django.

Project description

Django Categories

Jazzband codecov

Django Categories grew out of our need to provide a basic hierarchical taxonomy management system that multiple applications could use independently or in concert.

As a news site, our stories, photos, and other content get divided into "sections" and we wanted all the apps to use the same set of sections. As our needs grew, the Django Categories grew in the functionality it gave to category handling within web pages.

Features of the project

Multiple trees, or a single tree. You can treat all the records as a single tree, shared by all the applications. You can also treat each of the top level records as individual trees, for different apps or uses.

Easy handling of hierarchical data. We use Django MPTT to manage the data efficiently and provide the extra access functions.

Easy importation of data. Import a tree or trees of space- or tab-indented data with a Django management command.

Metadata for better SEO on web pages Include all the metadata you want for easy inclusion on web pages.

Link uncategorized objects to a category Attach any number of objects to a category, even if the objects themselves aren't categorized.

Hierarchical Admin Shows the data in typical tree form with disclosure triangles

Template Helpers Easy ways for displaying the tree data in templates:

  • Show one level of a tree. All root categories or just children of a specified category

  • Show multiple levels. Ancestors of category, category and all children of category or a category and its children

Categories API

Support for categories API can be added by third party application django-categories-api.

Optional Thumbnail field. Have a thumbnail for each category!

"Categorize" models in settings. Now you don't have to modify the model to add a Category relationship. Use the new settings to "wire" categories to different models.

Project details


Download files

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

Source Distribution

django-categories-2.0.0.tar.gz (126.2 kB view details)

Uploaded Source

Built Distribution

django_categories-2.0.0-py2.py3-none-any.whl (97.8 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file django-categories-2.0.0.tar.gz.

File metadata

  • Download URL: django-categories-2.0.0.tar.gz
  • Upload date:
  • Size: 126.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.11.6

File hashes

Hashes for django-categories-2.0.0.tar.gz
Algorithm Hash digest
SHA256 8c719e89ed5f19c109ae2592aa52fad9593e56ee04d013f2bf91a8011a1cfc28
MD5 ec6249410bab4634b18a43fef35b21f1
BLAKE2b-256 2dd3ee479d468a6f7dc5901cbc76ac459912bb90999e350984951dd7463fa18f

See more details on using hashes here.

File details

Details for the file django_categories-2.0.0-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for django_categories-2.0.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 0cb2d366b25f200084015a9f8bf1096d8939fcac881144c50dc361b2f2b7b307
MD5 5acfe74766630bbbbed230b420b39b3e
BLAKE2b-256 547b8e8fc75fb54ad4edb825d416f8b5b3d57bf940a28f44e6bd73eb47f88b78

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page