Difference between revisions of "SMF1.1:Themes and Layout" From Online Manual

Jump to: navigation, search
(→‎Manage and Install: HTML cleanup)
(→‎Member Options: HTML cleanup)
Line 62: Line 62:
 
On the '''Reset Options''' page of your [[Administration Center]] you can control the default [[theme options]] for your members.
 
On the '''Reset Options''' page of your [[Administration Center]] you can control the default [[theme options]] for your members.
  
'''Understanding...'''
+
====Resetting the options====
<ul class="bbc_list"><li>'''[[#post_resetting|Resetting the options]]'''</li><li>'''[[#post_meanings|The Options and their meanings]]'''</li></ul>
+
First you will be given the following options for each theme you have installed on your forum:
<span id="post_resetting"><span style="font-size: 4;" class="bbc_size">'''Resetting the options'''</span></span>----First you will be given the following options for each theme you have installed on your forum:
+
*'''Configure guest and new user options for this theme''' - These are the default values for some [[Member]] specific settings. Changing these will only affect new members and guests. Check the box to make the statement next to it true, otherwise the option will not be used.
<ul class="bbc_list"><li>'''Reset default (guest) options for this theme''' - These are the default values for some [[Member]] specific settings. Changing these will only affect new members and guests.</li><li>'''Reset all member&#039;s current options for this theme''' - The options below will reset options for everyone. To change an option, select &quot;change&quot; in the box next to it, and then select a value for it. To use the default, select &quot;remove&quot;. Otherwise, use &quot;don&#039;t change&quot; to keep it as-is.</li><li>'''Remove all member&#039;s options and use the defaults''' - This option will remove any altered options a user is using from the default options set for the [[Theme]] the [[Member]] is viewing. Next to the link you can see how the number of members that are using non-default options for that theme.</li></ul>
+
*'''Change current options for all members using this theme''' - The options below will reset options for everyone. To change an option, select &quot;change&quot; in the box next to it, and then select a value for it. To use the default, select &quot;remove&quot;. Otherwise, use &quot;don&#039;t change&quot; to keep it as-is.
If you selected to edit the default options for guests, you will see just one checkbox next to each of these options. Check the box to make the statement next to it true, otherwise the option will not be used.
+
*'''Remove all member&#039;s options and use the defaults''' - This option will remove any altered options a user is using from the default options set for the [[Theme]] the [[Member]] is viewing. Next to the link you can see how the number of members that are using non-default options for that theme. '''Note:''' no confirmation will be asked before reset to default the options.
  
If you selected to reset all members options, you will see a checkbox along with a dropdown. The dropdown has three options. &quot;Remove&quot; will remove the option set by the members and make it the default setting of the option. &quot;Change&quot; allows you to check the next box to make the option to be enabled or disabled for all members. &quot;Don&#039;t Change&quot; is used when you don&#039;t want to reset a particular option for all members.
+
=====The options and their meanings=====
 +
{{Needs work|Expand: Use sidebar menus instead of dropdown menus when possible; Hide messages posted by members on my ignore list}}
  
If you click on the'' Remove all member&#039;s options and use the defaults'' '''all''' members options set for that theme will be removed and so members options will be be using the themes default options set.
+
Upon clicking on one of the above options you will be taken to a page that has the following theme options that you can manage:
 
+
*'''Show [[Board]] descriptions inside boards.''' - This will show the description you see next to each [[Board]] on the [[Board]] Index inside each [[Board]] as well.
<span id="post_meanings">'''<span style="font-size: 4;" class="bbc_size">The options and their meanings</span>'''</span>----Upon clicking on one of the above options you will be taken to a page that has the following theme options that you can manage:
+
*'''Show child boards on every page inside boards, not just the first.''' - If you select this, Child Boards will be listed on every page of a [[Board]] rather then just the first page of a board. A [[Board]] will have multiple-pages when there is more topics than the defined number of topics per-page on the [[Board]] has been reached.
 
+
*'''Use sidebar menus instead of dropdown menus when possible''' -
<ul class="bbc_list"><li>'''Show [[Board]] descriptions inside boards.''' - This will show the description you see next to each [[Board]] on the [[Board]] Index inside each [[Board]] as well.</li><li>'''Show child boards on every page inside boards, not just the first.''' - If you select this, Child Boards will be listed on every page of a [[Board]] rather then just the first page of a board. A [[Board]] will have multiple-pages when there is more topics than the defined number of topics per-page on the [[Board]] has been reached.</li><li>'''Don&#039;t show other users&#039; avatars.''' - Select this to hide the display of member&#039;s avatars. This may speed page viewing for those who have dial-up internet connection.</li><li>'''Don&#039;t show other users&#039; signatures.''' - To disable the showing of signatures underneath each [[Post]] made by a member, check this.</li><li>'''Leave words uncensored.''' - With this setting checked, words that normally would be replaced with the censor filter will be left untouched.</li><li>'''Return to topics after posting by default.''' - Check this box if you wish to return to the [[Post]] you just submitted instead of returning to the index of the [[Board]] you posted the [[Topic]] in.</li><li>'''Don&#039;t warn on new replies made while posting.''' - While posting a topic, another [[Member]] could have posted a [[Reply]] since you started posting a reply, with this unchecked, a warning will be shown before the [[Post]] is submitted telling you a [[Reply]] was made to the topic. Check this if you wish to not show the warning and just submit the reply.</li><li>'''Show most recent posts at the top.''' - Having this checked will show the newest posts first in a [[Topic]] and the replies will get older and older as they go along instead of showing the oldest posts first.</li><li>'''Show most recent personal messages at top.''' - Checking this will show the most recent personal messages on the top, and they will go down as they get older and older.</li></ul>[vers=2]
+
*'''Don&#039;t show users&#039; avatars.''' - Select this to hide the display of member&#039;s avatars. This may speed page viewing for those who have dial-up internet connection.
<ul class="bbc_list"><li>'''Show WYSIWYG editor on post page by default?''' - Checking this will have the ''What You See Is What You Get'' style postbox shown as the default editor each time the posting page is loaded. You can always switch back and forth to the editor you want however by clicking the ''Toggle'' icon next the bbcode buttons.</li><li>'''Show a popup when you receive new messages?''' - Set this to have a popup box shown to the user after they receive a new personal message.</li><li>'''Save a copy of each Personal Message in my outbox by default.''' - With this selected, the checkbox when sending a a personal message to save a copy of the message into your outbox will be initally checked.</li><li>'''Remove the inbox label when applying another label'''. - With this checked, when a personal message is applied a label, the inbox label of the personal message will be removed.</li><li>'''Turn notification on when you post or reply to a topic.''' - With this checked, the checkbox to send out notification of replies to a topic you post in will by default be checked.</li><li>'''Topics to display per page''' - Determines how many topics (topic subject with link to topic, as well as View and Reply count and last post information) should be shown per page on the topic listing when inside of a board.</li><li>'''Messages to display per page''' - Determines how many posts should be shown per page when inside of a topic.</li></ul>[/vers]
+
*'''Don&#039;t show users&#039; signatures.''' - To disable the showing of signatures underneath each [[Post]] made by a member, check this.
<ul class="bbc_list"><li>'''First day of the week on the calendar.''' - Pick the day you wish the calendar to show as the first day of the week. You can pick Saturday, Sunday and Monday.</li><li>'''Use [[Quick Reply]] on [[Topic]] display.''' - Select if you wish to not show [[Quick Reply]] at all, or show it but collapsed, or just show it at full height.</li><li>'''Show quick-moderation on [[Message index]] as.''' - Select whether you wish to show quick moderation boxes on the [[Message index]] next to each [[Topic]] of a [[Board]] as icons (which would disable the use of mass-moderation), checkboxes or not show them at all.</li></ul>
+
*'''Leave words uncensored.''' - With this setting checked, words that normally would be replaced with the censor filter will be left untouched.
 +
*'''Return to topics after posting by default.''' - Check this box if you wish to return to the [[Post]] you just submitted instead of returning to the index of the [[Board]] you posted the [[Topic]] in.
 +
*'''Don&#039;t warn on new replies made while posting.''' - While posting a topic, another [[Member]] could have posted a [[Reply]] since you started posting a reply, with this unchecked, a warning will be shown before the [[Post]] is submitted telling you a [[Reply]] was made to the topic. Check this if you wish to not show the warning and just submit the reply.
 +
*'''Show most recent posts at the top.''' - Having this checked will show the newest posts first in a [[Topic]] and the replies will get older and older as they go along instead of showing the oldest posts first.
 +
*'''Show most recent personal messages at top.''' - Checking this will show the most recent personal messages on the top, and they will go down as they get older and older.
 +
*'''Hide messages posted by members on my ignore list''' -
 +
*'''Show WYSIWYG editor on post page by default''' - Checking this will have the ''What You See Is What You Get'' style postbox shown as the default editor each time the posting page is loaded. You can always switch back and forth to the editor you want however by clicking the ''Toggle'' icon next the bbcode buttons.
 +
*'''Show a popup when I receive new messages''' - Set this to have a popup box shown to the user after they receive a new personal message.
 +
*'''Save a copy of each Personal Message in my sent items by default.''' - With this selected, the checkbox when sending a a personal message to save a copy of the message into your sent items folder will be initially checked.
 +
*'''Remove the inbox label when applying another label'''. - With this checked, when a personal message is applied a label, the inbox label of the personal message will be removed.
 +
*'''Turn notification on when you post or reply to a topic.''' - With this checked, the checkbox to send out notification of replies to a topic you post in will by default be checked.
 +
*'''Topics to display per page''' - Determines how many topics (topic subject with link to topic, as well as View and Reply count and last post information) should be shown per page on the topic listing when inside of a board.
 +
*'''Messages to display per page''' - Determines how many posts should be shown per page when inside of a topic.
 +
*'''Use [[Quick Reply]] on [[Topic]] display''' - Select if you wish to not show [[Quick Reply]] at all, or show it but collapsed, or just show it at full height.
 +
*'''Show quick-moderation as.''' - Select whether you wish to show quick moderation boxes on the [[Message index]] next to each [[Topic]] of a [[Board]] as icons (which would disable the use of mass-moderation), checkboxes or not show them at all.
  
 
===Modify Themes===
 
===Modify Themes===

Revision as of 08:26, 17 March 2011

Manage and Install

The Manage and Install page is the default page loaded in the Category:Themes and Layout section of the Category:Administration Panel. Here you can select whether the Default theme can be chosen, what Theme guests will use, as well as other options. The following are all the options shown on this page:

Themes and Layout Settings

  • Allow members to select their own Themes - You can enable or disable selecting Themes for members. If this option is disabled, members will not have the option in their Profile to choose different Themes.
  • Themes that the user is able to select - When clicking [ Show the list of Themes] a list of all the Themes currently installed on your forum will appear with a checkbox right before their name. Checking the box will allow users to select the theme, otherwise if it is unchecked the Theme can only be used by Administrators.
  • Overall Forum default - Specify the overall Forum default Theme. This Theme will be used for guests, new members and members who did not specify any Theme.
  • Reset everyone to - You can rest all members to a specific Theme, regardless of their Theme preference. Note that even when this setting is set to No change, all users that have Forum or Board Default set as their Theme in their profile will still have their Theme changed when the setting Overall forum default is changed.

Latest and Greatest Themes

This area shows a few of the latest Themes, as well as one featured Theme and one randomly selected Theme of the Moment Themes from the Customize Theme Site. However, it may not show up properly if your computer can't connect to the Simple Machines server.

Install a New Theme

This allows you to install new Themes. You can do this from an already created directory, by uploading an archive for the Theme, or by copying the default Theme. Note that the archive or directory must have a theme_info.xml definition file contained inside of it.

Theme Settings

The Front Page Theme Listing

The Themes Settings section of the Administration Center shows a list of all Themes currently installed on the forum. Clicking on any Theme's name will take you to that Theme Settings, exactly like Current Theme settings. If you want to remove a Theme from your forum, then click on the red X. Doing so will only delete that Theme reference from your Forum settings. The actual Theme contents will be left in your Themes folder. At the bottom of this page is: Reset Theme URLs and Directories which allow you to reset the base url and base path to your Theme directory. This can come in handy when you recently moved your forums.

When selecting the link for any Theme listed on this page you will be lead to page with the following settings:

Theme URLs and Configuration

This part contains the paths needed for the Theme as well as its name. The following fields are used in this part:

  • This Theme's name - Although this field will be filled with a Theme name, you can change it if you like. This will only affect the name that will be shown to members when they choose a Theme from their profiles.
  • This Theme's URL - This will be also filled automatically with the location of the Theme main folder (the address you use in a browser's bar).
  • This Theme's images URL - This is similar to the above but must point to the images folder that the Theme uses. It does not have to be the same location as the Theme folder. Some Themes will use images from different Themes resulting in a different location.
  • This Theme's directory - This one is different from the previous two. It will contain the exact location/path of the Theme folder in your website. If you do not know where your Theme folder is, you can try clicking the Edit Server Settings and looking at the content of SMF Directory, adding /Themes/your_theme to that will be your Theme current location.
Theme Options and Preferences

This part contains various settings that will affect the look and functionality of a Theme. Note that some Themes may add some new options here. Also from here, you can set or reset options for members. The following is a description of each element found in this part:

  • Logo image URL - Put in a url to a logo image you would like to use on the top of your forum.
  • Site slogan -
  • Select default smiley set for this Theme - Here you can choose which smiley set the Theme will be using. You can choose the global smiley set used by the Forum or one from the available sets or none.
  • Forum width -
  • Show current position in Forum as link instead of text - When you browse the forum, your current location is displayed on top. This location can be shown as just text; or as links, to simplify navigation.
  • Enable and show 'Mark as Read' buttons - This will give you the option to show or disable viewing 'Mark as Read' button that can be found in Board index and message index.
  • Allow users to turn off word censoring - If ticked, members can choose whether or not to censor words. For this to work a list of words must be entered first in (Edit Censored Words).
  • Enable random news line in the forum header - If ticked a news item will be shown randomly each time you refresh the page or navigate through the forum.
  • Show news fader on Board index - This will cause a news box to be shown in the Board index that will display all news items with a fading effect between them. You can control how long a news item is shown by setting the Time in milliseconds to display each item in the news fader field.
  • Fading delay between items for the news fader - The time that last between another news is shown in the news fader.
  • Number of recent posts to display on Board index - Here you can set the numbers of recent posts that will be displayed in the forum's main index. Set it to zero to disable showing any posts.
  • Show statistics on board index - Enabling this will display detailed stats on the info center such as total topics, total posts, total members, etc. Disabling it will hide the stats in the info center and show basic stats above the first Category in Board index. Also, a Personal Message bar will be shown at the end of the info center if the user is logged in, and a Login bar if the user is logged out.
  • Show latest Member on Board index - This option will work with Enable SP1 style statistics on Board index unchecked. It will add a welcome note and link to the latest member.
  • Show group key on board index - Enable or disable showing a membergroup color legend in the Who's Online block in the Info Center section of the Board Index.
  • Show who is viewing the Board index and posts - Three options are available to choose from. If you do not like this feature, simply choose Don't show. Otherwise either choose Show only numbers or Show Member names, to show how many members in numbers/names are looking at a Board Message index or a post.
  • Show last modification date on modified posts - If ticked, this will cause a note to be written in each modified post, which will state the name of the Member who modified it and the time of modification.
  • Show view Profile button under post - If ticked, this will display a small icon below the member's name in their posts that will take you to that member's profile.
  • Show user avatars in message view - Enable or disable showing of Member Avatar in posts under his/her name.
  • Show personal text in message view - Enable or disable showing personal text in posts under the Member avatar.
  • Show gender images in message view - Enable or disable showing a gender image in posts under the member's name. The gender image is a small icon that indicates if the Member is male or female. This is only useful if members select their gender in their profiles.
  • Hide Post group titles for grouped members - Enabling this will hide a member's Post group title on the message view if they are assigned to a non-post based group.
  • Show BBC Buttons on Posting and PM Send Pages - This will either show or hide Bulletin Board Code buttons. The BBC will be not affected, only the buttons will be hidden if this option is ticked.
  • Enable collapsible additional Post options - This option controls showing extra options when posting such as Notify me of replies, Attach, etc. You may either always show those options on or hide them and use an arrow to display them.

Member Options

On the Reset Options page of your Administration Center you can control the default theme options for your members.

Resetting the options

First you will be given the following options for each theme you have installed on your forum:

  • Configure guest and new user options for this theme - These are the default values for some Member specific settings. Changing these will only affect new members and guests. Check the box to make the statement next to it true, otherwise the option will not be used.
  • Change current options for all members using this theme - The options below will reset options for everyone. To change an option, select "change" in the box next to it, and then select a value for it. To use the default, select "remove". Otherwise, use "don't change" to keep it as-is.
  • Remove all member's options and use the defaults - This option will remove any altered options a user is using from the default options set for the Theme the Member is viewing. Next to the link you can see how the number of members that are using non-default options for that theme. Note: no confirmation will be asked before reset to default the options.
The options and their meanings

Upon clicking on one of the above options you will be taken to a page that has the following theme options that you can manage:

  • Show Board descriptions inside boards. - This will show the description you see next to each Board on the Board Index inside each Board as well.
  • Show child boards on every page inside boards, not just the first. - If you select this, Child Boards will be listed on every page of a Board rather then just the first page of a board. A Board will have multiple-pages when there is more topics than the defined number of topics per-page on the Board has been reached.
  • Use sidebar menus instead of dropdown menus when possible -
  • Don't show users' avatars. - Select this to hide the display of member's avatars. This may speed page viewing for those who have dial-up internet connection.
  • Don't show users' signatures. - To disable the showing of signatures underneath each Post made by a member, check this.
  • Leave words uncensored. - With this setting checked, words that normally would be replaced with the censor filter will be left untouched.
  • Return to topics after posting by default. - Check this box if you wish to return to the Post you just submitted instead of returning to the index of the Board you posted the Topic in.
  • Don't warn on new replies made while posting. - While posting a topic, another Member could have posted a Reply since you started posting a reply, with this unchecked, a warning will be shown before the Post is submitted telling you a Reply was made to the topic. Check this if you wish to not show the warning and just submit the reply.
  • Show most recent posts at the top. - Having this checked will show the newest posts first in a Topic and the replies will get older and older as they go along instead of showing the oldest posts first.
  • Show most recent personal messages at top. - Checking this will show the most recent personal messages on the top, and they will go down as they get older and older.
  • Hide messages posted by members on my ignore list -
  • Show WYSIWYG editor on post page by default - Checking this will have the What You See Is What You Get style postbox shown as the default editor each time the posting page is loaded. You can always switch back and forth to the editor you want however by clicking the Toggle icon next the bbcode buttons.
  • Show a popup when I receive new messages - Set this to have a popup box shown to the user after they receive a new personal message.
  • Save a copy of each Personal Message in my sent items by default. - With this selected, the checkbox when sending a a personal message to save a copy of the message into your sent items folder will be initially checked.
  • Remove the inbox label when applying another label. - With this checked, when a personal message is applied a label, the inbox label of the personal message will be removed.
  • Turn notification on when you post or reply to a topic. - With this checked, the checkbox to send out notification of replies to a topic you post in will by default be checked.
  • Topics to display per page - Determines how many topics (topic subject with link to topic, as well as View and Reply count and last post information) should be shown per page on the topic listing when inside of a board.
  • Messages to display per page - Determines how many posts should be shown per page when inside of a topic.
  • Use Quick Reply on Topic display - Select if you wish to not show Quick Reply at all, or show it but collapsed, or just show it at full height.
  • Show quick-moderation as. - Select whether you wish to show quick moderation boxes on the Message index next to each Topic of a Board as icons (which would disable the use of mass-moderation), checkboxes or not show them at all.

Modify Themes

Every non-default Theme you have installed on your Forum is listed here. Underneath is Theme is the following:

Browse the templates and files in this theme - Lists all template files a Theme has. You may click on any template file and edit it straight from there.

Edit this theme's stylesheet - Shows the theme's stylesheet. There is a built in preview of the Theme you are editing and you can see what the changes would look like before you even save the changes.

Copy a template from the Theme this is based on - Here you can select a template file that the Theme is based on (Usually the default SMF theme) and copy it over to the theme.

Main

Configuration

Forum

Members

Maintenance

Miscellaneous