All about permission profiles

Permission profile is short for board permission profile. In SMF 2 and later, you use a board permission profile to control precisely who can post, add attachments, moderate, etc. on each and every board on your forum. If you use SMF 1.1.x, please read about local board permissions instead.

Permission profiles describe, for each member group, what that member group is allowed to do. Every board on your forum uses just one permission profile. If you don't pick a board permission profile for a board then SMF will use the default board permission profile for that board. Board permission profiles do not control who can see a board; for more on this, please read what members are allowed to see and do.

When you are setting up custom board permission profiles, you need to keep two things in mind.

1. For each board, pick the permission profile you want to use for that board (or stick with the default profile).
2. Make changes to a permission profile, or create a new one.

Before you change any board permissions, check which board permission profile you are working with, and which boards use that profile. Any time you change permissions on one board, you change permissions on any board that uses the same board permission profile.

See or change board permission profiles

To see which boards are using which profiles, go to Administration Center » Permissions » Board Permissions This is a list of all your boards, ordered by category, board, and child board. For each board, there is a profile name. Click on the Board Name to modify the board and choose a different board Permission Profile for the board.

Change a board permission profile or create a new one

See or edit permissions for a profile

Go to Administration Center » Permissions » Board Permissions and click on a Permission Profile name. You will see the profile name and a list of member group names, some statistics, a link to "modify permissions", and a check-box. Below this list, there is a set of Advanced Options.

Caution: remember that whenever you modify membergroup permissionss within a board permission profile, you will affect every board that uses this same profile.

See or change permissions for a member group in this board permission profile

Simply click on the member group name. Suppose you already chose the Default profile. Now choose the Guests member group. You will now see a page of information titled Permissions for group "Guests" in profile "Default". You see a bunch of check boxes. If a box is unchecked, that member group does not have that permission in this profile. If it is checked, the member does have permission in this profile.

What if a member belongs to more than one group

If you have permissions set up in the "regular" way, then permissions always "add up". If that permission is checked on one member group OR another to which a member belongs, that member will have that permission. Here is an example:

• Member SparklyPony belongs to "club members" and also "club officers".
• "club members" is not allowed to Announce topic in the Default profile (disallowed)
• "club officers" is allowed to Announce topic in the Default profile
• Therefore, member SparklyPony has the permission Announce topic in the Default profile

When you first install SMF 2.x, your forum will have "regular" permissions. If you need the ability to deny permissions to some members even if they belong to membergroups which are allowed those permissions, you can read about the difference between disallow and deny. Deny is a sometimes-tricky advanced topic.

Create a new profile

If you have had a good look at all the profiles you've already got, and don't see one you like for a particular board, you can create a new one. From Administration Center » Permissions » Edit Profiles , scroll down to the New Profile section, fill in a name for your new profile, choose a profile that is close to what you want to Copy Permissions From as a starting point, and hit the Create button. Then check and edit the permissions for each member group in this profile.

But what if I want one member to have very special permissions on this board

Create a special membergroup just for that user. Move that user into that membergroup. You might want to remove one or more other membergroups from that member. To change membergroups for a user, use that member's account settings. Go to Administration Center » Members » View All Members , choose a member name, and choose Account Settings from the member menu.

Every time you create a new membergroup, you need to go through all of your permission profiles to make certain that the new membergroup has the permissions you want in every single profile you want to use. If that sounds tedious, please read about the advanced option "Set permissions like this group" below.

Advanced options can make it easier to assign permissions within a profile

You do not need to use these advanced options. But if you have several permission profiles and want to make sweeping changes to several membergroups within those profiles, advanced options can speed things up.

First, click the checkbox at the end of the line for one or several of the member groups for this profile. Now scroll down to the Advanced Options section of the page. If you see only a title, click on the little triangle to show the details. You have three choices.

1. Apply pre-defined permission set -- click on the ? for a quick description of each of the 4 choices here.
2. Set permissions like this group: Select a membergroup from the list of member groups. The permissions for each of the member groups you checked in the list above will be changed to match the member group you choose from this list.
3. 'Add permission... Clear permission... Deny permission... This is a quick change. From the first drop-down list on this line, choose whether to add, clear, (or deny, if you have deny permissions set for your forum). From the second drop-down list, choose which permission to change. The permissions for each of the member groups you have checked above will have this one change made.

Now, click the Set Permissions button to make it so.