Member Management
Documentation > Concepts > Member Management
BoltWire can be used to create a powerful membership driven website. Below is a brief tutorial to introduce some of the key features and help you get started.
New Member Registration
As soon as BoltWire is installed, you should see a register link at the top and bottom of the page. Just click it to create an account. If you are an admin you can create additional accounts once you are logged in.
If you wish to collect additional information, such as email addresses, simply edit action.register to ask for the additional data. If you are collecting email addresses, use field "email" (lower case) and it will be handled automatically in several special ways. Let's say you wanted to collect gender and age. Your register form might look something like the following
<code> [form]| Member: | |
| Password: | |
| Age: | |
| Gender: |
When the form is submitted various checks are made and if all pass, a member page is created in group "login" (configurable). The password is encrypted. These pages do not need to be read protected, but can be restricted so users only see their own profile information if desired. See the Fancy Auth and Virtual Wiki solution pages for an example of some of the possibilities
Note: there are also many capabilities within BoltWire for form validation, including required fields, and regex checks, etc. It is also possible to do email confirmation and many other things. The above form is just a sample to get you started.
If you do not want to allow visitors to self register, simply view protect the action.register page at site.auth.view.
Login
Once a person is registered, they can login by clicking the login link and entering their member name (or their email, if available) and password. The login form can be modified, of course, by editing action.login. For example, if you wish to track member logins, simply add a log command. Or you could have new members forwarded to a specific welcome page, etc, using the nextpage command.
Once a person is logged in, you can access their profile information by using the following notation:
{~field}
To access a specific members info, rather than the current members info use
{~id:field}
Member Profiles
To give members the ability to update their profile information, create a BoltWire action that updates the various data fields you wish and put it in login.footer. See the data management tutorial for details on how to setup a form that updates data fields.
<code>
[if equal "{id}" "{p2}"][[{p}&action=profile|Update Profile]][if]
</code>
To protect view action.profile page in order to prevent people from calling the action directly in a browser you may add following to site.auth.view:
<code>action.profile: @owners</code>
Memberships
BoltWire also allows you to easily create group Memberships, and edit them. First, to create a group, like ChessClub, simply create a page called group.chessclub. Then add a list of member id's, one to a line, to add members. Or go to action.join. The new group should automatically appear in the dropdown list, ready to use.
To allow members to self-subscribe to a group, use a form like the following. To drop them from the group, create another form with the members field set to -{id}. You can always, of course, add and remove names manually by editing the group.chessclub page.
<code> [form] [session members "+"] [session join chessclub] [form] </code>These group pages are automatically scanned when a person logs in, and memberships are assigned. You can update the memberships of a person who has already logged in by adding [(memberships)] to a page. To show the current memberships, use the {memberships} system variable. BoltWire has many built in capabilities for handling groups, including view and write protections, and an ingroup conditional. The more you know about BoltWire, the more you can do.
Site Customization
Once your member accounts are set up, it is easy to customize your site based on any profile information you have (or groups). Suppose you asked their favorite color when they registered. You could put something like this anywhere in your wiki:
<code> | Copyright © 2013, all rights reserved. |