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

Jump to: navigation, search
No edit summary
 
(48 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{versions|versions}}
{{TOCright}}
{{TOCright}}
===Manage and Install===
===Manage and Install===
The ''Manage and Install'' page is the default page loaded in the Themes and Layout section of the [[Administration Center]]. 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:
The ''Manage and Install'' page is the default page loaded in the Themes and Layout section of the [[SMF1.1:Administration Center|Administration Center]]. Here you can select whether the [[SMF default theme]] can be chosen, which [[Theme]] guests will use, as well as other options. The following are all the options shown on this page:


====Themes and Layout Settings====
====Themes and Layout Settings====
*'''Allow members to select their own [[Themes]]''' - You can enable or disable selecting [[Theme]]s 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 [[Administrator]]s.
*'''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 ''[[Theme]]s from the [http://custom.simplemachines.org/themes/ 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]]====
'''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.
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.


Before we go into the details of how to install a theme, please, be aware that installing a theme which is not designed for the version of SMF that you're using could be quite a small disaster. When you install a modification which is not for the version of SMF you're using, you're warned. Unfortunately, this check isn't performed, when you try to do the same with a theme. So, please check that the theme you're trying to install is designed to work with the version of SMF that you're using. There is, also, no way of installing a theme using emulation, as there is with modifications.
*'''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 reset 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.


Here's a step-by-step guide to installing a theme:
====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'' from the [http://custom.simplemachines.org/themes/ Simple Machines Theme Site]. However, it may not show up properly if your computer cannot connect to the Simple Machines server.
Firstly, go to Admin>Themes and Layout Settings>Manage and Install.
 
Scroll down the bottom section, labelled "Install a New Theme".
 
Where you see "From a file:", click "Choose", just to the right.
 
That will let you navigate to the theme file, on your hard disk. Please note, the theme MUST be still archived.
 
Select the file and hit "Install", at bottom-right.
 
You'll be asked if you want to install that theme, for some odd reason.
 
Click "OK", because you obviously do. Otherwise, you wouldn't have gone to all the trouble of getting as far as you have.
 
Wait a few seconds and, all being well, you'll get a message saying "''NAME OF THEME''...was installed successfully."
 
You can, now, go to your profile and select the theme, to check that's all is as it should be.
 
As a side note, of you have problems with the new theme, you can revert to the SMF default theme by adding "?theme=1" to the end of your forum's URL. As an example, to achieve that, on the SMF forum, you'd enter:


http://www.simplemachines.org/community/index.php?theme=1
====Install a New Theme====
This section provides three ways to install a new theme.
* '''From a file''' -- a theme archive file, such as can be found on the [http://custom.simplemachines.org/themes/ Simple Machines Theme Site]
*# Find a theme archive file in the [http://custom.simplemachines.org/themes/ Simple Machines Theme Site] and download the file to your desktop.  Be certain that this theme is compatible with your version of SMF. The version is also listed on the page where you downloaded the theme. Themes for 1.1.* will not work on 2.0.* and 2.0.* themes will not work on 1.1.*.
*# Click the "Browse" button to the right of the "from a file" label.
*# From the pop-up, navigate to the theme file (still compressed as a .zip or .tar.gz file) on your computer.
*# Click Install and confirm if you want to install the theme in the popup
*# Installation will take a few seconds. If all goes well, the installer will tell you that the theme "... was installed successfully."
*# From your profile, select the theme, to test it.
*# If you have any difficulties with the theme, switch back to the SMF default theme by using '''theme=1''' in your query string (example: <nowiki>http://www.simplemachines.org/community/index.php?theme=1</nowiki>)
<hr>
* '''From a directory on the server''' -- If the files are not packed into an archive
*# Make sure the files are already arranged in directories, just as SMF expects to find them. Keeping them in subdirectories of your forum's Themes/ directory will make them easiest to keep track of
*# Be certain that these theme files are compatible with your version of SMF, and that they include a file called theme_info.xml (for more on theme_info.xml, please read [[Packaging a Theme]]). The version is also listed on the page where you downloaded the theme. Themes for 1.1.* will not work on 2.0.* and 2.0.* themes will not work on 1.1.*.
*# Select the "Install" button.
<hr>
* '''Create a copy of Default named''' -- To create a new copy you can customize yourself
*# In the input box, enter a name for your new theme.
*# Select the "Install" button.


===Theme Settings===
===Theme Settings===


====Themes List====
====Themes List====
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 [[Theme]]s folder. To physically remove the theme from there, you need to do so using FTP or your CPanel's File Manager.
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's settings, exactly like current theme settings. If you want to remove a theme from your forum, then click on the red X, to the right of the theme's name. Doing this will only delete that theme reference from your forum settings. The actual theme contents will be left in your themes directory. To physically remove the theme from there, you need to do so using FTP.


At the bottom of this page is: '''Reset Theme URLs and Directories'''. This form allows you to reset the base url and base path to your Themes directory. This can come in handy when you recently moved your forums -- simply correct the '''Base path''' and '''Base URL''' to the Themes directory, and select the button labeled '''Attempt to rest all themes'''.
At the bottom of this page is: '''Reset Theme URLs and Directories'''. Here you can reset the base url and base path to your themes directory by selecting '''Attempt to reset all themes'''.


'''When selecting the link for any [[Theme]] listed on this page you will be lead to page with the following settings:'''
'''When selecting the link for any theme listed on this page, or selecting the "Current Theme" option in the menu, you will be lead to page with the following settings:'''


=====Theme URLs and Configuration=====
=====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 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 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 URL''' - This will be also filled automatically with the location of the theme main directory (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 [[Theme]]s will use images from different [[Theme]]s resulting in a different location.
*'''This Theme's images URL''' - This is similar to the above but must point to the images directory that the theme uses. It does not have to be the same location as the theme directory. Some themes will use images from a different theme 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.
*'''This Theme's directory''' - This one is different from the previous two. It will contain the exact location/path of the theme directory in your website. If you do not know where your theme directory 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=====
=====Theme Options and Preferences=====
This part contains various settings that will affect the look and functionality of a [[Theme]]. Note that some [[Theme]]s 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:
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 section:
*'''Logo image URL''' - Put in a url to a logo image you would like to use on the top of your forum.
*'''Logo image URL''' - Put in a url to a logo image you would like to use on the top of your forum.
*'''Site slogan''' - If supplied, this text will replace the simplemachines logo.
*'''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.
*'''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.
*'''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.
*'''Forum width''' - This sets the width of the pages of your forum. If it's set to less than 100%, you might see gaps at the edges of each page. This only, really, needs to be adjusted if your pages seem to wide, or two narrow, for your browser. Although, please remember that changing this setting will affect all of your members, not just you.
*'''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.
*'''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.
*'''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.
*'''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.
*'''Show members list bar on board index?''' - ''Has no discernible effect on the default theme''
*'''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).
*'''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 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. The news items can be configured in Admin>Main>News and newsletters.
*'''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 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.
*'''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.
*'''Enable inline links''' - Enabling this will cause your current location to be drawn in a single line, as opposed to in a tree-like manner.
*'''Enable SP1 style 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.
*'''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).
*'''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, and attach. You may either always show those options on or hide them and use an arrow to display them.
*'''Enable News?''' - If ticked a news item will be shown randomly each time you refresh the page or navigate through the forum. The news items can be configured in ''Admin > Main > News and newsletters''.
*'''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''' - This sets the amount of time that each news item is displayed, before the next item is shown, in the news fader.
*'''Fading delay between items for the news fader''' - This sets the amount of time that each news item is displayed, before the next item 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 user avatars in message view''' - Enable or disable showing of a member's [[Avatar]] in posts under his/her name.
*'''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 personal text in message view''' - Enable or disable showing personal text in posts under the Member avatar.
*'''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 latest [[Member]] on board index''' - This option will work with enable 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 buttons as images instead of text''' -  
*'''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 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.
*'''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.
*'''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 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.
 
[[Category:Customizing SMF]]


===Member Options===
===Reset Options===
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.


====Resetting the options====
====Resetting the options====
First you will be given the following options for each theme you have installed on your forum:
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.
*'''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. 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 &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't change&quot; to keep it as-is.
*'''Reset all members' current options for 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.
*'''Remove all members' options and use the defaults''' - This option will remove any altered options a user has selected from the default options set for the theme the member is using. Next to the link you can see the number of members that are using non-default options for that theme. '''Note:''' no confirmation will be asked before the reset to default the options.


=====The options and their meanings=====
=====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:
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 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.
*'''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. A board will have multiple pages when more topics than the defined number of topics per page has been reached.
*'''Use sidebar menus instead of dropdown menus when possible''' - This option allows to set as default to use a sidebar with all the navigation menus whenever possible in SMF's interface (e.g. in the [[Administration Center|admin panel]]) instead of the dropdown menus.
*'''Don't show users' avatars.''' - Select this to hide the display of members' avatars. This may speed page viewing for those who have dial-up internet connection.
*'''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.
*'''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.
*'''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.
*'''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.
*'''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 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.
*'''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''' - If activated the messages posted by members present in the user's [[Profile#Buddies.2FIgnore_List|ignore list]] will not be displayed.
*'''Show a pop-up when I receive new messages?''' - Set this to have a pop-up shown to the user after they receive a new personal message.
*'''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.
*'''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 directory will be initially checked.
*'''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.
*'''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.
*'''First day of the week on the calendar''' - Choose which day starts the week on the forum calendar.
*'''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''' - Choose whether you wish not to show [[quick reply]] at all, or show it, but collapsed, or just show it at full height.
*'''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 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.
*'''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===


Every non-default [[Theme]] you have installed on your [[Forum]] is listed here. Underneath is [[Theme]] is the following:
Every theme you have installed on your Forum is listed here. Underneath every theme the following are listed:
 
'''Browse the templates and files in this theme''' - Lists all of the templates/files that a theme has, along with their last modification date and size. You may click on any template file and edit it straight from there, except for any backup files (ending with ~) or image files, which cannot be edited in the admin panel.


'''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 style sheet''' - Shows the theme's style sheet. 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.


'''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.


'''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.
''It is not recommended to edit a theme in this way as no [[backup]] is created if an improper edit is made so there is nothing to restore which can not be done if the forum is in a crashed state.''


{{As an administrator}}
{{ {{Localized|As an administrator1.1}}}}

Latest revision as of 16:10, 8 April 2015

Please see SMF1.1:Themes and Layout or SMF2.0:Themes and Layout depending on the version of SMF you are using.

Manage and Install

The Manage and Install page is the default page loaded in the Themes and Layout section of the Administration Center. Here you can select whether the SMF default theme can be chosen, which 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.

  • 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 reset 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 from the Simple Machines Theme Site. However, it may not show up properly if your computer cannot connect to the Simple Machines server.

Install a New Theme

This section provides three ways to install a new theme.

  • From a file -- a theme archive file, such as can be found on the Simple Machines Theme Site
    1. Find a theme archive file in the Simple Machines Theme Site and download the file to your desktop. Be certain that this theme is compatible with your version of SMF. The version is also listed on the page where you downloaded the theme. Themes for 1.1.* will not work on 2.0.* and 2.0.* themes will not work on 1.1.*.
    2. Click the "Browse" button to the right of the "from a file" label.
    3. From the pop-up, navigate to the theme file (still compressed as a .zip or .tar.gz file) on your computer.
    4. Click Install and confirm if you want to install the theme in the popup
    5. Installation will take a few seconds. If all goes well, the installer will tell you that the theme "... was installed successfully."
    6. From your profile, select the theme, to test it.
    7. If you have any difficulties with the theme, switch back to the SMF default theme by using theme=1 in your query string (example: http://www.simplemachines.org/community/index.php?theme=1)

  • From a directory on the server -- If the files are not packed into an archive
    1. Make sure the files are already arranged in directories, just as SMF expects to find them. Keeping them in subdirectories of your forum's Themes/ directory will make them easiest to keep track of
    2. Be certain that these theme files are compatible with your version of SMF, and that they include a file called theme_info.xml (for more on theme_info.xml, please read Packaging a Theme). The version is also listed on the page where you downloaded the theme. Themes for 1.1.* will not work on 2.0.* and 2.0.* themes will not work on 1.1.*.
    3. Select the "Install" button.

  • Create a copy of Default named -- To create a new copy you can customize yourself
    1. In the input box, enter a name for your new theme.
    2. Select the "Install" button.

Theme Settings

Themes List

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's settings, exactly like current theme settings. If you want to remove a theme from your forum, then click on the red X, to the right of the theme's name. Doing this will only delete that theme reference from your forum settings. The actual theme contents will be left in your themes directory. To physically remove the theme from there, you need to do so using FTP.

At the bottom of this page is: Reset Theme URLs and Directories. Here you can reset the base url and base path to your themes directory by selecting Attempt to reset all themes.

When selecting the link for any theme listed on this page, or selecting the "Current Theme" option in the menu, 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 directory (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 directory that the theme uses. It does not have to be the same location as the theme directory. Some themes will use images from a different theme 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 directory in your website. If you do not know where your theme directory 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 section:

  • Logo image URL - Put in a url to a logo image you would like to use on the top of your forum.
  • 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 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.
  • 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.
  • 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 members list bar on board index? - Has no discernible effect on the default theme
  • 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.
  • 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.
  • 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.
  • Enable inline links - Enabling this will cause your current location to be drawn in a single line, as opposed to in a tree-like manner.
  • Enable SP1 style 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.
  • 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).
  • 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, and attach. You may either always show those options on or hide them and use an arrow to display them.
  • Enable News? - If ticked a news item will be shown randomly each time you refresh the page or navigate through the forum. The news items can be configured in Admin > Main > News and newsletters.
  • 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 - This sets the amount of time that each news item is displayed, before the next item is shown, in the news fader.
  • Show user avatars in message view - Enable or disable showing of a member's 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 latest Member on board index - This option will work with enable statistics on board index unchecked. It will add a welcome note and link to the latest member.
  • Show buttons as images instead of text -
  • 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.

Reset 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:

  • 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. Check the box to make the statement next to it true, otherwise the option will not be used.
  • Reset all members' current options for 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 members' options and use the defaults - This option will remove any altered options a user has selected from the default options set for the theme the member is using. Next to the link you can see the number of members that are using non-default options for that theme. Note: no confirmation will be asked before the 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. A board will have multiple pages when more topics than the defined number of topics per page has been reached.
  • Don't show users' avatars. - Select this to hide the display of members' 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.
  • Show a pop-up when I receive new messages? - Set this to have a pop-up 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 directory will be initially checked.
  • 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.
  • First day of the week on the calendar - Choose which day starts the week on the forum calendar.
  • Use quick reply on topic display - Choose whether you wish not to show quick reply at all, or show it, but collapsed, or just show it at full height.
  • 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.

Modify Themes

Every theme you have installed on your Forum is listed here. Underneath every theme the following are listed:

Browse the templates and files in this theme - Lists all of the templates/files that a theme has, along with their last modification date and size. You may click on any template file and edit it straight from there, except for any backup files (ending with ~) or image files, which cannot be edited in the admin panel.

Edit this theme's style sheet - Shows the theme's style sheet. 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.

It is not recommended to edit a theme in this way as no backup is created if an improper edit is made so there is nothing to restore which can not be done if the forum is in a crashed state.

Main

Configuration

Forum

Members

Maintenance

Miscellaneous




Advertisement: