From Online Manual

Revision as of 07:35, 30 November 2010 by Trekkie101 (talk | contribs) (DIRTY.... needs a cleanup but initial import.)
Jump to: navigation, search

A membergroup is a customizable setting in SMF, that administrators can set permissions for. They can set what boards that members from that certain membergroup can see, whether or not those members could manage members, etcetera. To assign membergroups, the administrator would go into the user's profile, into Account Related Settings, and they may set that user to a membergroup by selecting one from the drop-down list called Primary Membergroup.

Edit Membergroups

On the Edit Membergroups section, you will see two separate tables. The table on the top, lists the regular Membergroups on your forum (In other words, the non post-count based groups). The bottom table lists all of the post-count based groups of your forum.

The Membergroup names are colored differently depending on what color is assigned to the group. Next to each of the group names is the star images used for the group, the number of Members the group currently has, and a link to modify the group. On post-count based groups you will also see the required posts needed for a member to be in that post-count based group.

When viewing the Membergroups section, you have three options of what you can do.

  • Add a new membergroup
  • Edit an existing membergroup
  • Select the membergroups that can modify membergroups

The add membergroup page is almost the same as the edit membergroup page, so both are combined into one document, and both links above go to the same document.

Add Membergroup

On the Add Membergroup page you will be able to create new membergroups with the desired settings. This page can be accessed by selecting the Add Membergroup tab when viewing the Membergroups section of the


Unless otherwise stated, each setting listed below is available when creating a new membergroup and editing an existing one.

Membergroup name - The name you want to call the group. This name will be publically shown next to the member's details on each post and will help you know what group is what.[vers=2]

Group Type - Here you can select the type of group you want this membergroup to be. You have the following options:

  • Private - Membership to a group has to be manually assigned for a member
  • Requestable - Membership to the group can be requested by having a user go to their profile and selecting the Group Membership link
  • Free - Like above, except membership can be automatically given to member when requested
  • Post Based - Membership to group only granted when member meets specified post count

Moderators - Here you can enter a comma separate list of usernames of those you want to be a group moderator. A group moderator's main privilege is the ability to add new members to the membergroup. This field is only available when modifying an existing group. [/vers]

[vers=1.1]This group is based off posts - Check this to make the group a post-count based group.[/vers]

Required Posts - When making the membergroup based on the number of posts, you are required to choose the number of posts required for a member to be in that group. This can be any number you like. Note, keep track of any existing membergroups that are based off of post count. While you can have multiple membergroups require the same number of posts to be a part of the group, the newer group will be the only one members will actually be put in when they have the specified posts.

Color in online list - Select the HEX color value to represent the group. This color will come in effect when viewing the overall online list or a list of members viewing a topic or board. The member's username links will appear in this color. This can be useful in denoting a member is in a special group. Note, this only comes into effect for primary membergroups. Members who have a group as a secondary group will not appear in this color at any point. This field is only shown when modifying an existing membergroup.

Number of star images - Membergroups can have small images to appear next to the group inside of posts made by members of the group (in the group as a primary group) and on a member's profile page. Here you can configure how many of these images you want to show for the group. This option is only shown when modifying an existing group

Star image filename - Here you can select the filename of where the image you want to use should be taken from. Like the option above it, this option is only shown when modifying an existing group. As indicated next to this field, the image to be called should be uploaded to {theme URL}/images/. So each theme of yours should have an image with the specified filename available.

Permissions - When creating a membergroup, you must select the initial permission settings the membergroup will use. Please note on group creation you are limited in what permissions you can give the group and that this section only appears when creating a new group, but you can always go to Permissions / Permissions by Membergroup to adjust the permissions for the membergroup.

There are a few types of settings you can use for permissions.

  • inherit from - This allows you to pick a group to inherit the permissions from. Only pick this option if you want all permissions to be taken directly from another membergroup and you  do not wish to configure any unique permissions for this group.
  • by type - There are four basic types of Member groups: Restrictive, Standard, Moderator, and Maintenance.
    • Restrictive - This is the permission settings that guests get by default.
    • Standard - This is the permission setting that a standard Register user would receive by default.
    • Moderator - Any group with this permission setting would be able to moderate boards that they can see.
    • Maintenance - This is the permission settings that is very similar to that of the administrator.
  • based off of - You can choose the permissions of another membergroup to base this new one on. This will copy the permissions for the other group, you just choose the group, then alter permissions accordingly.

Visible Boards - This allows you to choose which boards this new group will have access to; this is useful so that you don't have to do it later. You may change these at anytime by going to Membergroups / Edit Membergroups and clicking the link [ Show boards ] at the bottom next to Visible Boards.