How sessions work in MoinMoin

Sessions in MoinMoin are implemented using a special session service that can be configured in cfg.session_service.

Code using the session framework currently includes:

• the superuser "change user" functionality, see HelpOnSuperUser

• the visited pages trail

Session related configuration

Single wiki

Likely the only interesting item is cookie_lifetime.

Multiple separate wikis under same domain, all using wikiconfig (not farmconfig)

The default cookie_name = None creates a different cookie name and separate sessions for each wiki.

If you want separate sessions for your wikis, you can't use cookie_name = 'siteidmagic' because that always would set the name to MOIN_SESSION_wikiconfig. So either explicitly set a unique cookie_name for each wiki or use cookie_name = None.

Wiki farm, host based farming

E.g. wiki1.example.org and wiki2.example.org.

If you like shared sessions, shared user profiles, use this in your farmconfig:

   1     cookie_domain = '.example.org' # cookie domain matches for all wikis
   2     cookie_name = 'myfarm' # cookie name is same for all wikis
   3     session_dir = '/same_session_dir' # use same storage for session files
   4     user_dir = '/same_user_dir' # use same storage for user profiles

Wiki farm, path based farming

E.g. example.org/wiki1 and example.org/wiki2.

If you like shared sessions, shared user profiles, use this in your farmconfig:

   1     cookie_name = 'myfarm' # cookie name is same for all wikis
   2     session_dir = '/same_session_dir' # use same storage for session files
   3     user_dir = '/same_user_dir' # use same storage for user profiles

Wiki farm, port based farming

E.g. example.org:8000 and example.org:8001.

If you like shared sessions, shared user profiles, use this in your farmconfig:

   1     cookie_name = 'myfarm' # cookie name is same for all wikis
   2     session_dir = '/same_session_dir' # use same storage for session files
   3     user_dir = '/same_user_dir' # use same storage for user profiles

Session example code

As an extension programmer, in order to use session variables, you can use request.session like a dict, values stored there are automatically saved and restored if a session is available.

Here's an example macro using the session code:

   1 # -*- coding: iso-8859-1 -*-
   2 
   3 """
   4     Tests session state.
   5 """
   6 
   7 Dependencies = ['time']
   8 
   9 def execute(macro, args):
  10     if macro.request.session.is_new:
  11         return macro.formatter.text('Not storing any state until you send a cookie.')
  12     if 'test' in macro.request.session:
  13         return macro.formatter.text("Loaded value %d" % macro.request.session['test'])
  14     import random
  15     value = random.randint(1, 100000)
  16     macro.request.session['test'] = value
  17     return macro.formatter.text("Set to value %d" % value)