issue #11. Upd readme.rst

Author: bugov

README.rst

@@ -50,6 +50,63 @@ or the same, but with `datetime.timedelta` (more semantically):
 
     AUTO_LOGOUT = {'IDLE_TIME': timedelta(minutes=10)}
 
+The user will log out the next time the page is requested.
+See `REDIRECT_TO_LOGIN_IMMEDIATELY` to log out right after the idle-time has expired
+(and redirect to login page).
+
+REDIRECT_TO_LOGIN_IMMEDIATELY after the idle-time has expired
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Use the `REDIRECT_TO_LOGIN_IMMEDIATELY` option
+if you want to redirect the user to the login page
+immediately after the idle-time expires:
+
+.. code:: python
+
+    from datetime import timedelta
+    AUTO_LOGOUT = {
+        'IDLE_TIME': timedelta(minutes=10),
+        'REDIRECT_TO_LOGIN_IMMEDIATELY': True,
+    }
+
+This requires a client-side script, so you should
+modify your `context_processors` in `settings.py`:
+
+.. code:: python
+
+    TEMPLATES = [
+        {
+            'BACKEND': 'django.template.backends.django.DjangoTemplates',
+            'DIRS': [],
+            'APP_DIRS': True,
+            'OPTIONS': {
+                'context_processors': [
+                    'django.template.context_processors.debug',
+                    'django.template.context_processors.request',
+                    'django.contrib.auth.context_processors.auth',
+                    'django.contrib.messages.context_processors.messages',
+                    # !!! Add this !!!
+                    'django_auto_logout.context_processors.auto_logout_client',
+                ],
+            },
+        },
+    ]
+
+And add this to your templates (will add a redirect script to your html):
+
+.. code:: bash
+
+    {{ redirect_to_login_immediately }}
+
+If you want to use this in your JavaScript code, following template variables may be useful:
+
+.. code:: javascript
+
+    var sessionEnd = {{ seconds_until_session_end }};
+    var idleEnd = {{ seconds_until_idle_end }};
+
+`REDIRECT_TO_LOGIN_IMMEDIATELY` works with `SESSION_TIME` too.
+
 Limit session time
 ------------------
 
@@ -67,6 +124,13 @@ or the same, but with `datetime.timedelta` (more semantically):
 
     AUTO_LOGOUT = {'SESSION_TIME': timedelta(hours=1)}
 
+.. note::
+
+    See `REDIRECT_TO_LOGIN_IMMEDIATELY` option
+    if you want to redirect user to the login page
+    right after the idle-time has expired.
+
+
 Show messages when logging out automatically
 --------------------------------------------
 
@@ -112,4 +176,5 @@ for more than half an hour:
         'IDLE_TIME': timedelta(minutes=5),
         'SESSION_TIME': timedelta(minutes=30),
         'MESSAGE': 'The session has expired. Please login again to continue.',
+        'REDIRECT_TO_LOGIN_IMMEDIATELY': True,
     }