Difference between revisions of "SMF1.1:Features and Options" From Online Manual

Jump to: navigation, search
Line 71: Line 71:
===Profile Fields===
===Profile Fields===
{{Needs work}}
In the ''Profile Fields'' section, administrators have the option of creating and modifying custom profile fields as well as modifying some basic settings to the already built-in profile fields.
In the ''Profile Fields'' section, administrators have the option of creating and modifying custom profile fields as well as modifying some basic settings to the already built-in profile fields.

Revision as of 18:21, 3 June 2011

The Features and Options section of the Administration Center is the section for editing core forum-related settings that help change the way you want your forum to behave. Many common features that are perhaps not specific enough to have their own section appear throughout the pages on this wiki.


  • Poll mode - This selects whether polls are enabled or not. If polls are disabled, any existing polls will be hidden from the topic listing. You can choose to continue to show the regular topic without their polls by selecting "Show Existing Polls as Topics".  To choose who can post polls, view polls, and similar abilities, you can change the permissions for those membergroups. If polls are not working on your forum, check to see if they are enabled.
  • Allow guests to browse the forum - If selected, guests will have the privilege of browsing your forum. Otherwise, only registered users will be allowed to browse your forum and when a guests tries to access the forum they will see a login screen and a note that the forum is only for registered members.
  • Enable buddy/ignore lists - If this is selected, users can choose to add certain other users to their buddy list, or if they don't want to talk to the user, they can add them to their ignore list. (The ignore list only ignores PMs from the selected users. This does not hide posts)
  • Allow users to edit their displayed name - SMF gives you the ability to use another name for a user. It is called the display name. So, in example, "John" could have his name displayed to others as "SMF lover" in various parts of the forum. The name is edited from a user's profile.
  • Allow non-administrators to hide their online status - With this option enabled, all members will be able to hide their online status from other users (except from administrators). If disabled, only users who can moderate the forum can hide their presence. Note that disabling this option will not change any existing member's status - it just stops them from hiding themselves in the future.
  • Enable custom titles - Enabling Custom Titles will allow members with the relevant permissions to create a special title for themselves. This will be shown underneath the display name in posts made by that member.
    For example:
    Cool Guy
  • Default personal text - Sets the default text a user will have as their "personal text." This will be shown underneath their avatar when posting
  • Search engine friendly URLs - This changes the format of forum-related URLs a little, so search engines will index them easier. They will look like index.php/topic,1.html.
  • Meta keywords associated with forum - These keywords are sent in the output of every page to indicate to search engines the key content of your site. They should be a comma separated list of words, and should not use HTML or BBCode. (Example of meta keywords and how they should be placed: forum,discussion,free,fun,social,all,ages)
  • Default time format - You have the power to adjust how the time and date are displayed on your forum. There are a lot of small characters, but it's quite simple to understand. The conventions follow PHP's strftime function and are described as below (more details can be found at PHP.net).
    The following characters are recognized in the format string:
      %a - abbreviated weekday name
      %A - full weekday name
      %b - abbreviated month name
      %B - full month name
      %d - day of the month (01 to 31)
      %D* - same as %m/%d/%y
      %e* - day of the month (1 to 31)
      %H - hour using a 24-hour clock (range 00 to 23)
      %I - hour using a 12-hour clock (range 01 to 12)
      %m - month as a number (01 to 12)
      %M - minute as a number
      %p - either "am" or "pm" according to the given time
      %R* - time in 24 hour notation
      %S - second as a decimal number
      %T* - current time, equal to %H:%M:%S
      %y - 2 digit year (00 to 99)
      %Y - 4 digit year
      %Z - time zone or name or abbreviation
      %% - a literal '%' character
    * Does not work on Windows-based servers.
  • Default number format - You can use this setting to format the way in which numbers on your forum will be displayed to the user. The format of this setting is 1,234.00.  Where , is the character used to split up groups of thousands, . is the character used as the decimal point and the number of zeros dictate the accuracy of rounding.
  • Overall time offset - Not all forum administrators want their forum to use the same time zone as the server upon which it is hosted. Use this option to specify a time difference (in hours) from which the forum should operate from the server time. Negative and decimal values are permitted.
  • Server timezone - The server timezone tells PHP where your server is located. You should ensure this is set correctly, preferably to the country/city in which the city is located. You can find out more information on the Official PHP Website.
  • Enable who's online list - This option allows you to turn on or off the ability for users to see who is browsing the forum and what they are doing.
  • User online time threshold - Set the number of minutes to show the people who are active in X number of minutes on the board index. The default is 15 minutes.
  • Track daily statistics - This will allow users to see the latest posts and the most popular topics on your forum. It will also show several statistics, like the most members online at a time, recent new members and recent new topics.
  • Track daily page views (must have stats enabled) - Adds another column to the stats page with the number of hits (viewers) on a page on your forum.
  • Allow users to disable announcements - This will allow users to disallow admins to send e-mail notification of posts sent out as announcements. (This can be overridden, but it is not advised. See the News and Newsletters page of this wiki.)
  • Don't allow post text in notifications? - This feature removes the option to receive the text of replies and posts in notification e-mails. Often, members will reply to the notification e-mail, which in most cases means the webmaster receives the reply.


The Layout page has settings specific to the layout of your forum, such as whether to show the "Go Up" and "Go Down" links inside of topics and whether to show "Today" and "Yesterday" in replace of the actual date when those conditions are true.

  • Limit number of displayed page links - This will just show a selection of the number of pages.
    "3" to display: 1 ... 4 [5] 6 ... 9
    "5" to display: 1 ... 3 4 [5] 6 7 ... 9
  • Enable "Today" feature - This will show "Today", or "Yesterday", instead of the date.
  • Enable Go Up/Go Down buttons - This will add "Go Up" and "Go Down" buttons, so that member can go to the top and bottom of a page without scrolling.
  • Show online/offline in posts and PMs - This will show an image to indicate whether the member is online or offline.
  • Show a quick login on every page - This will show a more compact login menu on every page of the forum for guests. It works only if SP1 stats is off.
  • Members per page in member list - This shows how many members per page you would like to show in member list.
  • Display time taken to create every page - This will show the time (in seconds) SMF took to create that page at the bottom of the board.
  • Disable hostname lookups - This disables host name look-ups, which on some servers are very slow. Note that this will make banning less effective.
  • Enable who's online list - This option allows you to turn on or off the ability for users to see who is browsing the forum and what they are doing. You can reach it by clicking on the online icon found in the info center.


Karma is an optional feature that shows the popularity of a certain member. The administrator can enable this from core features. When members are allowed, they can Applaud or Smite a member to raise or lower that member's karma.

  • Karma mode - This option is to select how the karma feature will be used in the forum:
    • Disable Karma - disables the use of this feature
    • Enable Karma Total - makes SMF show only the total of points received
    • Enable Karma Positive/Negative - shows the positive points as well as the negative points for the user
  • Set the minimum posts needed to modify karma: admins can set a minimum posts that a user must have before raising or lowering someone's karma
  • Set wait time in hours: this is the time that an admin specifies, before a user can modify karma again
  • Restrict administrators to wait time: this specifies whether or not the forum administrators are restricted by the time limit
  • Karma label - here administrators can define the label that will be shown for the karma field in profile and posts (default karma:)
  • Karma applaud label - the text that will appear in the link for increase the karma of a user (default [applaud])
  • Karma smite label - the text that will appear in the link for decrease the karma of a user (default [smite])


The Signatures page allows you to configure restrictions to what to allow in signatures. Settings would include what BBCode can be used in signatures as well as what are the maximum allowed dimensions of various parts of the signature such as the maximum allowed width and height of images and the maximum number of characters that are allowed in the signature.

The following are all of the settings found on this page:

  • Enable signatures - This allows administrators to set whether signatures are allowed in the first placed.
  • Maximum allowed characters - The maximum number of characters that a user can have in their signature (0 for no max.).
  • Maximum amount of lines - The maximum number of lines that a user can have in their signature. A line is measured with the effect of hitting the "Return" key to start a new line (0 for no max.).
  • Maximum font size allowed in signatures - This allows you to specify how big the maximum font size can be in a signature, the number must be expressed in pixels (0 for no max.).
  • Allow smileys in signatures - This allows administrators to set whether smilies are allowed in signatures.
  • Maximum smiley count - The maximum number of smilies allowed in the signature (0 for no max.).
  • Maximum image count- The maximum number of images allowed in the signature, excluding smilies (0 for no max.).
  • Maximum width of signature images (pixels) - The maximum width allowed for any image in the signature (0 for no max.).
  • Maximum height of signature images (pixels)- The maximum height allowed for any image in the signature (0 for no max.).
  • Enabled BBC tags - Here administrators can decide which bbcode tags will be allowed to use in signatures.

Profile Fields

In the Profile Fields section, administrators have the option of creating and modifying custom profile fields as well as modifying some basic settings to the already built-in profile fields.

Standard Profile Fields

At the top of the page, are the standard fields where administrators can enable and disable them as desired by checking or unchecking the checkbox under the Active column. Right next to that column are additional checkboxes that allow to show the fields on the registration page. Once finished making the changes clicking the Save button the changes will be applied.

Custom Profile Fields

The above covers the standard profile fields, however some users may want to create their own profiles. These custom fields act in the same way as the standard fields do. Navigate down to the table with the heading of Custom Fields. Here you can view your existing custom fields as well as add a new one by selecting the New Field button at the bottom of the page.

The table that has the custom profile fields listed has the following information shown about the fields:

  • Field Name - The name that was given for the field. Used for identification.
  • Field Type - The type of field. For information on the different types of fields, see it explained later in this document.
  • Active - Shows the status of the field, whether it is active or not. If the field is not active, it will simply have no effect on your forum and will not be shown.
  • Placement - The position where the field will be shown.
  • Modify - Simply a link to modify the field.

Adding/Modifying Custom Fields

When creating a new custom field or modifying an existing one, you will come to a screen that has a few options for your new field:

  • Name - This is the name that will be displayed anywhere this field is used.
  • Description - This is a short description of what this field is for or what it does, and also tells the member what to put in the field. For example if it was for an instant messenger then you could put in some information that explains where to get this program and also what information from the program to put in to this field.
  • Profile Section - This is the section of the profile that it will be placed. Ever since SMF was born, a revolutionary step was taken and the user's profile has been divided in to three different categories: None, Account Settings, Forum Profile, and Look and Layout. The others are fairly obvious, but if None is selected this could be for a field in which the user enters the information upon registration but cannot change later.
  • Show on Registration - This option will show this field during the registration process and allow the user to fill it in while registering.
  • Show on Topic View - Checking this box will show this field in the user's posts. For example, if you are using Phone Number as the name of the field, and the member has this field filled in, it will show Phone Number: <phone number>. All fields that have this checked will show below the user's post count in their posts.
  • Choose Placement - This define where the field will be displayed: in the standard position (at the end of the "poster information" section), with the icons (Profile, email, PM, etc.) or above the user's signature.
  • Show Enclosed Within Text (Optional) - Encloses the user input between some text or html. This will allow you to add more instant message providers, images or an embed etc. For example:
    <a href="http://website.com/{INPUT}"><img src="{DEFAULT_IMAGES_URL}/icon.gif" alt="{INPUT}" /></a>
    The following variables can be used:
    • {INPUT} - The input specified by the user.
    • {SCRIPTURL} - Web address of forum.
    • {IMAGES_URL} - Url to images folder in the users current theme.
    • {DEFAULT_IMAGES_URL} - Url to the images folder in the default theme.
  • Field Type - This is probably the second most confusing part of setting up a new field. You will see the following options:
    • Text - This is a simple text field, similar to the one you use when you log in to your forum. You only have one option, the maximum length. The default is 255 but you can set your own or use 0 for no limit.
    • Large Text - This is what's known as a textarea, or the bigger text boxes. You have several different options here. Maximum length is the maximum amount of characters in this box. Dimensions, in rows and columns, is the height and width(in characters) of the box. Allow BBC is simply whether you want to allow the use of bulletin board code or not.
    • Select Box - With a select box you can add multiple options. They can only select one option. The page will display three fields you can fill in, with a link to add more. Don't worry, empty fields will not be added. Select boxes are good to use if you have many options to choose from, similar to the time zone select box.
    • Radio Button - With a radio button you can add selections similar to how a poll works. They can only select one option. The page will display three fields you can fill in, with a link to add more. Don't worry, empty fields will not be added. Radio buttons are good for 2-4 options, if you need to add more it is recommended to use a select box.
    • Checkbox - Checkboxes are just like the boxes you saw on the previous page, with the standard fields. Members may check multiple checkboxes.
  • Input Mask - The default option for input masks is No HTML. There are three other options: Valid Email, Numeric, and Regex (advanced). Valid Email will require an "at"(@) symbol and a period(.) or the member will get an error message. Numeric will only allow numbers.
  • Privacy - Selects who can see and edit this particular field.
  • Searchable - Determines if this fields contents can be searched for through the memberlist.
  • Active - This box must be checked or the field will not show anywhere and it will not be editable. If it's unchecked, the data will still remain in the database, but it will not show. It is recommended to just uncheck boxes to deactivate fields instead of just deleting them. That way, if you want to bring them back then the members will not have to reinsert their data.