objtrack 0.2

objtrack is a generic object view tracking model.<br /><br />This will store a "last viewed date" which says "everything that has changed" since this date, is unread. It also stores a list of primary keys, which has been read since that date.<br /><br />Installation:<br /><br />Download and install the package using distutils:<br /><br />pip install objtrack<br /><br />Update your settings.py and add the installed apps settings:<br /><br />INSTALLED_APPS = (<br /> 'django.contrib.admin',<br /> 'django.contrib.auth',<br /> 'django.contrib.contenttypes',<br /> 'django.contrib.sessions',<br /> 'objtrack',<br />)<br /><br />Finally, run python manage.py syncdb to create the database tables.<br /><br />Usage:<br /><br />Showing forums which have new posts in them:<br /><br />from objtrack.models import ObjectTracker<br /><br />def view_forum_list(request):<br /> categories = Category.objects.all()<br /><br /> tracking = ObjectTracker.objects.get_for_request(request, Thread)<br /><br /> # Don't forget you still need to update a date field when a new thread<br /> # is added to the forum.<br /> for category in categories:<br /> category.has_new_posts = tracking.has_viewed(category)<br /><br /> # Maybe we want to mark all forums as "i saw this" now?<br /> tracking.mark_all_as_viewed()<br /><br /> return render(...)<br /><br />Adding a has_viewed attribute to threads in the thread listing:<br /><br />def view_thread_list(request):<br /> threads = Thread.objects.all()<br /><br /> tracking = ObjectTracker.objects.get_for_request(request, Thread)<br /><br /> # This isn't the *best* approach to checking if it's been viewed, but it works<br /> for thread in threads:<br /> thread.has_viewed = tracking.has_viewed(thread)<br /><br /> return render(...)<br /><br />Marking the thread object as read when it's viewed:<br /><br />def view_thread(request, thread_id):<br /> thread = Thread.objects.get(pk=thread_id)<br /><br /> tracking = ObjectTracker.objects.get_for_request(request, Thread)<br /> tracking.mark_as_viewed(thread)<br /><br /> return render(...)<br /><br />You can also use it within Coffin or Django templates:<br /><br />{% load tracking %}<br /><br />{% for instance, has_viewed in queryset|with_tracking:"date_field" %}<br /> ...<br />{% endfor %}

Requirements:	No special requirements
Platforms:	*nix, Linux
Keyword:	Added,  Attribute,  Categories,  Forum,  Forums,  Generic,  Install,  It039s,  Object,  Objecttrackerobjectsget Requestrequest,  Objtrack,  Return,  Thread,  Threads,  Tracking,  View Thread Listrequest,  Viewed
Users rating:	0/10