{"id":254,"date":"2010-07-15T04:00:18","date_gmt":"2010-07-15T04:00:18","guid":{"rendered":"http:\/\/poojanwagh.opalstacked.com\/techblog\/?p=254"},"modified":"2010-07-15T04:05:13","modified_gmt":"2010-07-15T04:05:13","slug":"setting-up-bags-recipes-and-users-in-tiddlywebwiki","status":"publish","type":"post","link":"https:\/\/tech.poojanblog.com\/blog\/hosted-web\/setting-up-bags-recipes-and-users-in-tiddlywebwiki\/","title":{"rendered":"Setting up bags, recipes, and users in TiddlyWeb(Wiki)"},"content":{"rendered":"

Up to now, I’ve been using TiddlyWeb<\/a> as a server-hosted version of TiddlyWiki. This is a fraction of what’s possible with TiddlyWeb. One can create bags which are self-contained stores of tiddlers. One can combine these bags using recipes. Different users can have access to different bags and to different recipes.
\nBy default, TiddlyWebWiki comes with a recipe aptly named default<\/code> which is owned by a user named administrator<\/code>. This recipe pulls in tiddlers from two bags: system<\/code> and common<\/code>.
\nBasically, system<\/code> has the innards that make TiddlyWiki work over TiddlyWeb (the combination of which is called TiddlyWebWiki). common<\/code> contains stuff that’s supposed to be common between all users.
\nTo customize permissions, one needs to do the following:<\/p>\n

    \n
  1. Create users<\/li>\n
  2. Set up a bag other than common<\/code> to house per-user (or group) tiddlers<\/li>\n
  3. Set up a recipe that exposes the bag to users (or groups thereof)<\/li>\n<\/ol>\n

    Setting up a new user is performed by running<\/p>\n
    \ntwanager adduser UserName UserssAwe$om3P@assw0rd USERROLE WORKROLE BLAHBLAROLE
    \n<\/code>\n

    A role is essentially a user group that one can use to set group permissions on bags\/recipes. To set up a new bag, etc. Here’s what you do:<\/p>\n


    \n(tiddlyweb)[username@host main_inst]$ twanager bag personal
    \n<\/code>
    \nNow, entere the following and terminate it with CTRL<\/em>–D<\/code> (^D<\/code>):
    \n{“policy”: {“read”: [“UserName”, “R:ADMIN”], “create”: [“UserName”, “R:ADMIN”], “manage”: [“R:ADMIN”], “accept”: [“UserName”, “R:ADMIN”], “write”: [“UserName”, “R:ADMIN”], “owner”: “UserName”, “delete”: [“UserName”, “R:ADMIN”]}, “desc”: “UserName’s personal bag”}
    \n^D
    \n<\/code>
    \nIf you make a mistake, you can edit the fields that define this bag manually with
    \n
    \nvi store\/bags\/personal\/policy
    \nvi store\/bags\/personal\/description
    \n<\/code>
    \nNow, for the recipe:
    \n
    \ntwanager recipe personal
    \n<\/code>
    \nAnd type in:
    \n
    \ndesc: UserName’s personal recipe
    \npolicy: {“read”: [“R:ADMIN”, “UserName”], “create”: [“UserName”, “R:ADMIN”], “manage”: [“R:ADMIN”], “accept”: [“UserName”, “R:ADMIN”], “write”: [“R:ADMIN”], “owner”: “UserName”, “delete”: [“R:ADMIN”]}<\/p>\n

    \/bags\/system\/tiddlers
    \n\/bags\/common\/tiddlers
    \n\/bags\/personal\/tiddlers
    \n^D
    \n<\/code>
    \nSince \/bags\/personal\/tiddlers<\/code> is specified last in the list, that’s the default bag that UserName<\/code>‘s tiddlers will go.<\/p>\n

    You can edit this recipe definition after the fact with:
    \n
    \nvi store\/recipes\/personal
    \n<\/code>
    \nI haven’t tried this, but another option is to use a template recipe such as:
    \n
    \ndesc: Any user’s personal recipe
    \npolicy: {“read”: [“R:ADMIN”, “R:USER”], “create”: [“R:USER”, “R:ADMIN”], “manage”: [“R:ADMIN”], “accept”: [“R:USER”, “R:ADMIN”], “write”: [“R:ADMIN”], “owner”: “”, “delete”: [“R:ADMIN”]}<\/p>\n

    \/bags\/system\/tiddlers
    \n\/bags\/common\/tiddlers
    \n\/bags\/{{ user }}\/tiddlers
    \n^D
    \n<\/code>
    \nwhere {{ user }}<\/code> will get replaced with the login of the current user. I’m not sure how the bag for each user gets created, though. Also, in the above, I specified the role USER<\/code> (specified with “R:USER”<\/code>), which is something you’d set up when you add a user.
    \nFinally, to access the newly-created TiddlyWiki described by the above storage scheme (recipe), one would visit http:\/\/TiddlyWikiURI\/recipes\/personal\/tiddlers.wiki<\/code>.<\/p>\n