Metadata-Version: 1.1
Name: django-last-seen
Version: 0.3
Summary: Keep track of when a user has been last seen
Home-page: http://bitbucket.org/ferranp/django-last-seen
Author: Ferran Pegueroles
Author-email: ferran@pegueroles.com
License: GPL
Description: ================
        django-last-seen
        ================
        
        Keep trak of when a user has been last seen on a website.
        The last seen time is kept on the database
        
        The app is ready for django 1.5, it uses the AUTH_USER_MODEL setting to get
        the user model,
        
        Installation
        ============
        
        #. Install with ``pip install django-last-seen"`` or add ``"last_seen"``
           directory to your Python path.
        #. Add ``"last_seen"`` to the ``INSTALLED_APPS`` tuple found in your settings
           file.
        #. Add 'last_seen.middleware.LastSeenMiddleWare' to MIDDLEWARE_CLASSES tuple
           found in your settings file.
        #. Run ``manage.py syncdb`` to create the new tables
        
        Usage
        =====
        
        To get when a user has been last seen::
        
            from last_seen.model import LastSeen
        
            seen = LastSeen.object.when(user=user)
        
        
        To save a last seen user without the middleware::
        
            from last_seen.model import LastSeen
        
            # save with a special module
            LastSeen.object.when(user=user, module='forum')
        
        Middleware
        ==========
        
        The provided middleware keeps track of when an authenticated user has been
        last seen on the site,
        
        If you want to keep track of a user last seen on a part of a site, you can
        use a special module name and use::
        
            from last_seen.model import LastSeen
        
            # save with a special module
            LastSeen.object.when(user=user, module='forum')
        
        Then to get the data::
        
            from last_seen.model import LastSeen
        
            # user last seen on any part of the site
            seen = LastSeen.object.when(user=user)
        
            # user last seen on a module
            seen = LastSeen.object.when(user=user, module='forum')
        
        Settings
        ========
        
        LAST_SEEN_DEFAULT_MODULE
            The default module used on the middleware. The default value is ``default``.
        
        LAST_SEEN_INTERVAL
            How often is the last seen timestamp updated to the
            database. The default is 2 hours.
        
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
