Skip to main content

Django reusable application for content categorization.

Project description

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

LBC Python 2
https://img.shields.io/pypi/v/django-sitecats.svg https://img.shields.io/pypi/l/django-sitecats.svg https://img.shields.io/coveralls/idlesign/django-sitecats/master.svg https://img.shields.io/travis/idlesign/django-sitecats/master.svg

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.

# 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:

<!-- 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

http://django-sitecats.readthedocs.org/

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-sitecats-1.2.0.tar.gz (37.7 kB view details)

Uploaded Source

Built Distribution

django_sitecats-1.2.0-py2.py3-none-any.whl (36.4 kB view details)

Uploaded Python 2Python 3

File details

Details for the file django-sitecats-1.2.0.tar.gz.

File metadata

  • Download URL: django-sitecats-1.2.0.tar.gz
  • Upload date:
  • Size: 37.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: Python-urllib/2.7

File hashes

Hashes for django-sitecats-1.2.0.tar.gz
Algorithm Hash digest
SHA256 8105dc35063bda23c1d5369ae62cac8efd1c62bf72e9f5957afd873e115290da
MD5 d6fcc68e566e4202d884f5a3b870c14c
BLAKE2b-256 a7713fa3fc594e6e5d33ce039fa3185f85ce5a4ee98f6ef3e937fc4496e16503

See more details on using hashes here.

File details

Details for the file django_sitecats-1.2.0-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for django_sitecats-1.2.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 ffc76df1b9c0d9194256aa06ceff0b5e2f6b6431bc4d1360a674db8ef38db925
MD5 36ab1e1ac5281803ca31c7373378ecc6
BLAKE2b-256 6be300fecbdef0c5bc790a3140ec8ca72228658039d8a00a1aeedba7d8d0d909

See more details on using hashes here.

Supported by

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