This app attempts to provide a generic category system that multiple apps could use. It uses MPTT for the tree storage and provides a custom admin for better visualization (copied and modified from feinCMS).
Find a file
2024-05-22 16:21:50 +02:00
.github GitHub actions don't test in unsupported Python 3.6, update testing matrix 2024-01-23 11:06:30 +01:00
categories Bumped version for normal release. 2024-05-22 11:14:16 +02:00
doc_src add THUMBNAIL_STORAGE_ALIAS to docs 2024-01-23 16:38:30 +01:00
example fix migration ref in test and fix test run 2024-05-22 11:09:42 +02:00
requirements remove dependency on unicode-slugify, use Django builtin function 2024-04-19 10:46:39 +02:00
.changelog-config.yaml Changed changelog generation and version handling 2022-09-21 11:37:26 -05:00
.editorconfig Added a .editorconfig file. 2021-12-11 07:27:40 -06:00
.gitignore Debugging the doc generation process 2021-12-23 15:40:04 -06:00
.pre-commit-config.yaml [pre-commit.ci] pre-commit autoupdate 2024-05-22 11:12:05 +02:00
.readthedocs.yaml add ReadTheDocs configuration 2024-01-23 13:49:30 +01:00
CHANGELOG.md update changelog 2024-05-22 11:09:42 +02:00
CONTRIBUTING.md Added contributing documentation. #164 2021-12-04 08:58:51 -06:00
CREDITS.md Removed contributors from the README since that information is in CREDITS.md. No sense maintaining it two places. 2016-02-16 10:56:25 -06:00
LICENSE.txt [pre-commit.ci] auto fixes from pre-commit.com hooks 2021-12-05 14:34:46 +00:00
Makefile Fixed bug in the Makefile 2022-09-21 11:49:36 -05:00
MANIFEST.in Fixed the MANIFEST.in file. 2021-12-12 08:31:36 -06:00
NOTICES.txt Added in support materials 2009-07-07 07:31:34 -04:00
pyproject.toml Updated project configurations 2021-12-22 12:02:54 -06:00
README.md Update README.md - add PyPI badge 2024-05-22 16:21:50 +02:00
requirements.txt Changed the requirements to use chained files. 2021-12-11 07:27:40 -06:00
setup.cfg fix setup.cfg for zest.releaser 2024-04-17 12:42:46 +02:00
setup.py fix "Multiple top-level packages discovered" error with new setuptools 2022-09-21 12:13:46 +02:00
tox.ini remove support for Django 2.1 2024-05-22 11:09:42 +02:00

Django Categories

Jazzband codecov PyPI

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.