Skip to main content

Simple integration between django-cacheback and django-hitcount

Project description

django-popularity-mixin

Simple integration between django-cacheback and django-hitcount

Authored by Basil Shubin

https://img.shields.io/pypi/v/django-popularity-mixin.svg https://img.shields.io/pypi/dm/django-popularity-mixin.svg https://img.shields.io/github/license/bashu/django-popularity-mixin.svg https://img.shields.io/travis/bashu/django-popularity-mixin.svg

Requirements

You must have django-cacheback and django-hitcount both installed and configured, see the django-cacheback and django-hitcount documentation for details and setup instructions.

Installation

First install the module, preferably in a virtual environment. It can be installed from PyPI:

pip install django-popularity-mixin

Setup

Make sure the project is configured for django-cacheback and django-hitcount.

Then add the following settings:

INSTALLED_APPS += (
    'popularity',
)

Usage

The popularity.views.PopularityMixin can be used to do the business-logic of counting the hits asynchronously by setting count_hit to True.

# views.py

from django.views.generic.detail import DetailView

from popularity.views import PopularityMixin


class CustomDetailView(PopularityMixin, DetailView):
    count_hit = True    # set to True if you want it to try and count the hit asynchronously
    template_name = "template.html"
    ...

The popularity.viwes.PopularityMixin extends Django’s generic django.views.generic.detail.DetailView and injects an additional context variable hitcount.

<!-- template.html -->

{# the primary key for the hitcount object #}
{{ hitcount.pk }}

{# the total hits for the object #}
{{ hitcount.total_hits }}

For a more granular approach to viewing the hits for a related object you can use the get_hit_count template tag.

{# remember to load the tags first #}
{% load popularity_tags %}

{# Return total hits for an object: #}
{% get_hit_count for [object] %}

{# Get total hits for an object as a specified variable: #}
{% get_hit_count for [object] as [var] %}

{# Get total hits for an object over a certain time period: #}
{% get_hit_count for [object] within ["days=1,minutes=30"] %}

{# Get total hits for an object over a certain time period as a variable: #}
{% get_hit_count for [object] within ["days=1,minutes=30"] as [var] %}

Please see example application. This application is used to manually test the functionalities of this package. This also serves as good example…

You need Django 1.8.1 or above to run that. It might run on older versions but that is not tested.

Contributing

If you like this module, forked it, or would like to improve it, please let us know! Pull requests are welcome too. :-)

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-popularity-mixin-0.1.8.tar.gz (8.6 kB view hashes)

Uploaded Source

Built Distribution

django_popularity_mixin-0.1.8-py3-none-any.whl (10.6 kB view hashes)

Uploaded Python 3

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