Metadata-Version: 2.5
Name: django-sitecats
Version: 1.2.3
Summary: Django reusable application for content categorization
Project-URL: Homepage, https://github.com/idlesign/django-sitecats
Project-URL: Documentation, https://django-sitecats.readthedocs.io/
Author-email: Igor Starikov <idlesign@yandex.ru>
License-Expression: BSD-3-Clause
License-File: LICENSE
Keywords: Django,categories,tags
Classifier: Development Status :: 5 - Production/Stable
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: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.10
Requires-Dist: django-etc>=1.2.0
Description-Content-Type: text/markdown

# django-sitecats

<https://github.com/idlesign/django-sitecats>

[![release](https://img.shields.io/pypi/v/django-sitecats.svg)](https://pypi.python.org/pypi/django-sitecats)
[![lic](https://img.shields.io/pypi/l/django-sitecats.svg)](https://pypi.python.org/pypi/django-sitecats)
[![coverage](https://img.shields.io/coveralls/idlesign/django-sitecats/master.svg)](https://coveralls.io/r/idlesign/django-sitecats)

## Description

*Django reusable application for content categorization.*

Nay, — you say, — all that tags business lacks structuring.

This application is just about structuring your data: build categories hierarchy and link your site entities to those categories.

```python
# Somewhere in views.py
from django.shortcuts import render, get_object_or_404

# Suppose Article model has sitecats.models.ModelWithCategory class mixed in.
from .models import Article


def article_details(self, request, article_id):
    """See, there is nothing special in this view, yet it'll render a page with categories for the article."""
    return self.render(request, 'article.html', {'article': get_object_or_404(Article, pk=article_id)})

def article_edit(self, request, article_id):
    """Let's allow this view to render and handle categories editor."""
    article = get_object_or_404(Article, pk=article_id)

    # Now we enable category editor for an article, and allow users
    # to add subcategories to `language`, and `os` categories
    # (suppose we created them beforehand with Admin contrib),
    # and link this article to them.
    article.enable_category_lists_editor(
        request,
        editor_init_kwargs={'allow_new': True},
        additional_parents_aliases=['language', 'os']
    )

    form = ... # Your usual Article edit handling code will be here.

    return render(request, 'article.html', {'article': article, 'form': form})
```

Template coding basically boils down to `sitecats_categories` template tags usage:

```html
<!-- The same html is just fine for demonstration purposes for both our views.
     Do not forget to load `sitecats` template tags library. -->
{% extends "base.html" %}
{% load sitecats %}

{% block contents %}
    <!-- Some additional functionality (e.g. categories cloud rendering,
         editor enhancements) will require JS. -->
    <script src="{{ STATIC_URL }}js/sitecats/sitecats.min.js"></script>

    <h1>{{ article.title }}</h1>
    <div id="article_categories">
        {% sitecats_categories from article %} <!-- And that's it. -->
    </div>
    <!-- Form code goes somewhere here. -->
{% endblock %}
```

Read the docs, `sitecats` can do more.

## Documentation

<https://django-sitecats.readthedocs.io/>
