ocPortal Tutorial: ocPortal member system

Written by Chris Graham, ocProducts

ocPortal can provide a highly interactive website, and hence has powerful support for members.

If you are using ocPortal's own forum, OCF, then you will also be using ocPortal's own member system. If you are using a third-party forum, you will be using the member system from that, and you will need to consult it's own documentation.

This tutorial explains aspects of the member system.

Table of contents

ocPortal Tutorial: ocPortal member system

After installation

During installing ocPortal, there will be two user-names provided by default:

admin (or whatever you changed it to during installation)
test

The test username is intended for testing permissions for non-administrators, which is a very important task, as it is easy to make mistakes during configuration. There is a 'su' feature that allows an administrator to become any user by typing in their username (and not needing to type in their password, or logout): this is a perfect way to use the 'test' username.

For others

Joining an ocPortal powered site

Users that were not created during installation will need to join your site before they may login, and by default, to actually access most of the website. This is made very easy, with join links placed in various positions, such as (by default) the front page, and the forum-view.

To join, users will have to agree to your rules, which are actually the same as those defined in your ':rules' Comcode page. In other words, to edit your rules, you need to edit this page. Once the rules are agreed to, they get a form to fill in with various details; for information on how to require additional details at joining, see the 'Advanced ocPortal member system' tutorial. The form includes, if enabled in the configuration, a security image that they must enter a numeric code from; users with special needs might have difficulty with this: therefore you may, on occasion, need to add a member manually from the Admin Zone, and give them the details personally. The purpose of the security code is to prevent 'bots' (computer programs usually designed to wreak some form of havoc) from joining your site and abusing it.

The login block (which turns into a 'personal stats' block after logging in)

The detailed logging in page

There are a number of constraints on how fields may be filled in, and some of these are configurable from the main Admin Zone Configuration. For example, special characters are not allowed in user-names, and by default, any e-mail address may only be used for one account.

Once the form is filled in successfully, an e-mail will be sent to the given e-mail address containing a link to activate the account. The purpose of this is to ensure that they are giving a real working e-mail address, and hence are contactable. If the e-mail never arrives for any joining user, the most likely situation is a fault with e-mail sending on the server: it is essential that ocPortal is connected to a working e-mail server, either by directly residing on it, or by setting up SMTP settings in the main Admin Zone Configuration. Joining users must be patient for a few minutes, as e-mails can sometimes take a while to arrive.

Once the account is activated, the user may log in from numerous areas, including the login block available on most zones, the forums, and the full login page. If they have forgotten their password, there is a link to have it reset available from the full login page (available by clicking 'more' in the login block); this will send an e-mail to the address of the account that provides a link that when clicked, causes ocPortal to send out a new password by e-mail: this sequence is designed to reduce the risk of abuse.

Profiles

The member directory, where profiles may be accessed from

In ocPortal, the term 'profile' is used almost as a synonym for 'account'. Each member has a profile, which stores the settings for their account. There are countless areas in ocPortal that link to view a member profile, generally where a user-name is displayed in some form of context (for example, as the user who made a shout-box comment).

An alternative way to view a member profile is to select/search using the member directory.

Member profiles contain information on the member, including:

Statistics: Posts, Points, last submission time, and most active forum
Their time
Their on-line status
Custom profile fields
Their IP address when they joined (only viewable by those with permission)
Their date of birth
Whether they are banned
Their join date
Their primary user-group

Viewing a member profile

Member profiles contain many links to other ocPortal pages that relate to that member, with additional links presented to staff, or the member them-self. As ocPortal can be a very user-centric system, there are a lot of links presented here and this makes member profile pages a very convenient convergence of features.
Links include:

Member blog and blog archive, if they have a blog
Personal galleries the member has
E-mailing them, if they allow it
Points profile
Starting a personal topic
Author profile
Authored/submitted search
Warning creation
Post history
Investigation
Personal Zone
Personal Calendar view
Edit links for account features
ocWorld profile, if the ocWorld add-on is installed and they have used it

Member observation

Viewing the list of on-line members

There is a link to view the current 'Users On-line' in the site zone (by default). There is also a block, 'side_users_online' that shows:

a list of on-line users
how many guests are on-line
the newest member
member birthdays

Member birthdays are also shown on the forum-view. Note that birthdays for members who have chosen to reveal their age will include the display of their age.

The Personal Zone

The Personal Zone is an ocPortal zone that allows configuring of member accounts, as well as display of personal-related details such as recent forum topic participation. When one enters the Personal Zone directly, one is choosing to configure one's own member profile; however, staff may configure any member profile by clicking the 'Personal Zone' link when viewing the profile of the member they wish to edit.

Edit profile

Editing your/a member profile

The 'edit profile' screen allows you to edit most details associated with an account, including options and what would literally be called 'profile'.
Staff see much more to edit than ordinary members, including all the hidden custom fields that ocPortal uses to keep track of point and staff details.

When editing the default accounts, you will need to specify e-mail addresses before it will allow you to complete the edit. The reason for this is that e-mail addresses are basically required for all accounts, but could not be provided by the installer.

Interesting editable fields for profiles include:

changing the account password. If the password fields are left blank, the password is not changed.
changing primary user-group. Obviously the member can not do this themselves.
(de)validating the account. There is an option for staff to require in the Forum section of the main Admin Zone Configuration to set new members as unvalidated upon joining, so as to require staff validation before they may login; this can be used to perform this validation, or reverse it.
banning of the member. Note that ocPortal will not let you ban yourself, for obvious reasons.

Edit photo

Editing your/a member photo

Members may choose a photo of themselves (or staff can) for display in their profile.

There is a permission to specify whether members may view the photos of other members, as there is an obvious 'stalking'/'paedophile' issue that must be considered for forums with young members.
You may wish to deny members access to this page (by removing page access permissions to the 'editphoto' page in the 'personalzone' zone), in order to protect yourself and your members from these issues.

Edit signature

Editing your/a member signature

Members may have a signature which is displayed beneath their forum posts. This is not a signature in terms of verifying identity, as it may be copied by other members: rather, it allows members to broadcast their identity and other details in a prominent position. Signatures often include things such as:

their name
a personal banner
quotes
a link to a personal website
background information on themselves

It is common for websites to impose restrictions and rules with regard to signatures, as long or complex can be an annoying distraction from the flow of reading forum posts, and a 'bandwidth hog'. Members may decide not to view other members' signatures by editing their profile to preclude their display, but forcing members to disable all signatures to avoid problems associated with problem users is a rather extreme situation.

Edit avatar

Editing your/a member avatar

In computer parlance, an avatar is a representation of self. On the Internet, this is almost always a square image showing a picture that is, preferably, unique to that person. Avatars are displayed on profile pages, and next to forum posts.

ocPortal provides two sets of default avatars for inartistic/uninspired members to choose from (or possibly, if they just love our default avatars!). However, members may also upload their own avatars, or link to an avatar elsewhere.

Avatar size is limited by the maximum size determined by any of their user-groups. 80x80 pixels is the limit ocPortal uses by default.

It is beyond the scope of this tutorial how to create avatars. However, avatars are images no different than the theme images in ocPortal (and the default avatars are theme images), so whatever applies to editing theme images also applies to avatars.

Certain types of website may not consider our default avatars appropriate and wish to change them. This can be done using the theme image manager. To actual get rid of the existing default avatars, you will need to delete the files from your web-space using an FTP program, and then to clear the theme image cache using the ocPortal Caches module in the Admin Zone.

Edit title

Editing your/a member title

If members are in a group with permission, they may give themselves a personal title. This overrides the title of their primary group for the member.

Titles are displayed alongside forum posts, in the section that is accessed by 'hovering over' their user-name.

Deleting a member

The user-group directory

If they have permission, members may delete themselves. This is provided for those (arguably paranoid) members concerned about privacy or spam, who prefer not to leave old accounts around. You may choose to disallow permission because often members will quickly return after 'getting over' some 'event' that caused them to 'leave', and cause administrative trouble when they start demanding control over their old content, as well as their old points.

User-groups

Managing a user-group

{!DOC_GROUPS}

Bookmarks

The bookmarks popup

Managing bookmarks

If members are logged in then they may bookmark pages of your website within the site itself. The icon to do this is at the bottom of every ocPortal page.

The bookmark feature is particularly useful for:

members who want to keep bookmarks for different websites separate
members who move between computers

Concepts

profile: Member profiles define details, including options, relating to members
Personal Zone: The zone that a member manages and accesses settings and content related to themselves
avatar: A pictorial representation of self
user-group: User-groups allow common representation of properties (especially permissions) relating to a group of users in similar situations. Also known as just a group.