https://wiki.simplemachines.org/w/api.php?action=feedcontributions&user=Yoshi2889&feedformat=atomOnline Manual - User contributions [en]2024-03-29T15:17:11ZUser contributionsMediaWiki 1.39.6https://wiki.simplemachines.org/w/index.php?title=SMF2.1:Features&diff=31139SMF2.1:Features2018-07-11T23:47:29Z<p>Yoshi2889: Update minimum PHP version number according to current development</p>
<hr />
<div>{{Other languages}}<br />
{{TOCright}}<br />
<br />
<translate><br />
SMF 2.1.x is a very versatile forum software. It has many features, including the following:<br />
<br />
===Minimum requirements=== <br />
*PHP 5.4.0+<br />
*MySQL 5.0.3+ or PostgreSQL 8.3+<br />
<br />
===General===<br />
*Automated Installation of mods on non-default themes<br />
*"Smart emulation" to automatically detect a mod's version and to automatically emulate this mod when it is installed<br />
*Improved attachment security<br />
*Improved attachment error handling<br />
*SCEditor (New WYSIWYG editor)<br />
*Drafts<br />
*Enhanced admin panel<br />
*IPv6 Support<br />
*Built in support for jQuery<br />
*Full SSL Support<br />
*Verification questions support for multiple answers and multiple languages<br />
*Deny access to boards<br />
*Moved topics placeholders can be set to auto expire/delete<br />
*Topic preview when hovering over subject on message index<br />
*Likes System<br />
*Mentions System<br />
*Alerts systems for Notifications, Likes, and Mentions<br />
*Topic notifications can be set to Not Following, No Alerts or Email, Receive Alerts and Receive Emails and Alerts<br />
*Personal Messages automatically saved in sent box<br />
*Default theme is responsive<br />
*Ical calendar event export support<br />
*Gravatar support<br />
</translate><br />
<br />
[[Category:FAQ{{Langcat|{{BASEPAGENAME}}}}]]</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=SMF2.0:Requirements_and_recommendations&diff=28401SMF2.0:Requirements and recommendations2015-03-29T08:49:26Z<p>Yoshi2889: /* Basic Server Requirements */ typo</p>
<hr />
<div>In order to run an SMF forum, the server must meet the following requirements, and will run best on servers that also meet the recommendations below. This software has been tested and verified to work with the clients listed below, which are all internet browsers. <br />
<br />
==Basic Server Requirements==<br />
<br />
The following are required on any server intending to run SMF 2.0.<br />
<br />
* A webserver with approximately 20MB of available disk space. Much more is recommended so that other content can be uploaded over time.<br />
* A webserver that supports PHP, such as Apache or Internet Information Server (IIS).<br />
* [http://www.php.net PHP] 4.1.0 or higher<br />
** Versions of SMF below 2.0.7 will not work on PHP 5.5. If you use PHP 5.5 it is required to use SMF 2.0.7 or greater. <br />
* The following must be changed in the php.ini file:<br />
** The <code>engine</code> directive must be set to On.<br />
** The <code>magic_quotes_sybase</code> directive must be set to Off.<br />
** The <code>session.save_path</code> directive must be set to a valid directory or empty.<br />
** The <code>file_uploads</code> directive must be set to On.<br />
** The <code>upload_tmp_dir</code> directive must be set to a valid directory or empty. <br />
* One of the following databases must be installed:<br />
** [http://www.mysql.com MySQL] 4.0.18 or higher (at least 4.1.0 would be better) and PHP MySQL client API 4.0.18 or higher.<br />
**[http://www.postgresql.org PostgreSQL] 8.0 or higher (<code>standard_conforming_strings</code> must be set to off, starting from PostgreSQL 9.1 default is on)<br />
** [http://www.sqlite.org SQLite] SQLite 2.x (SMF is not compatible with SQLite 3.x)<br />
* The following are requirements for the database:<br />
** For a clean SMF installation, at least 2 MB of storage space in the database. Please note that this is only enough for the installation.<br />
** The database user must have ''at least'' the following privileges: <code>SELECT</code>, <code>INSERT</code>, <code>UPDATE</code>, <code>DELETE</code>, <code>ALTER</code>, and <code>INDEX</code>.<br />
** The database user must have the <code>CREATE</code> and <code>DROP</code> privileges during installation, conversion and some package installs.<br />
<br />
==Server Recommendations==<br />
''These are not required, but may be beneficial to your SMF install and enable you to use more functions.''<br />
<br />
* '''GNU Aspell 0.50 or higher''' (with appropriate dictionaries) for spell checking functionality.<br />
* '''Apache 2.0.x or above''' with '''AcceptPathInfo''' set to On for queryless URL support.<br />
<br />
* PHP with the following set in your '''''php.ini''''' file:<br />
** <code>max_input_time</code> set to a value of at least 30.<br />
** <code>post_max_size</code> and <code>upload_max_filesize</code> set to the size of the largest attachments you wish to be able to upload.<br />
** <code>memory_limit</code> set to at least 32M.<br />
** <code>max_execution_time</code> set to at least 15.<br />
** <code>register_globals</code> set to Off.<br />
** <code>session.use_trans_sid</code> set to Off.<br />
** safe mode disabled, or PHP suExec enabled.<br />
** [http://www.php.net/manual/en/book.bc.php BCMath] library enabled for using the [[Registration#Settings|OpenID]] registration method.<br />
** <code>mod_security</code> disabled (please see [[Mod security - Having problems with mod security|Mod security]] for more information).<br />
<br />
* '''GD Graphics Library 2.0 or higher.'''<br />
<br />
==Basic Client Requirements==<br />
<br />
* Microsoft Internet Explorer 6.0 or higher (7.0 or higher recommended).<br />
* Opera 7.0 or higher (9.5 or higher recommended).<br />
* Netscape 6.0 or higher.<br />
* Mozilla Suite 1.0.2 or higher.<br />
* Konqueror or Galeon.<br />
* Apple Safari 1.0 or higher (3.0 or higher recommended).<br />
* Mozilla Firefox 3.0 or higher (3.5 or higher recommended).<br />
<br />
{{Installing SMF}}</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=SMF2.1:Paid_subscriptions&diff=31340SMF2.1:Paid subscriptions2014-08-12T19:55:34Z<p>Yoshi2889: Note about paypal recurring payments</p>
<hr />
<div>{{TOCright}}<br />
<br />
Paid subscriptions is a method to give forum benefits to your users in exchange for a monetary donation or payment. With this function, you can choose the name of the donation, amount, and a membergroup that will be automatically assigned to the subscribed user, as well as other options.<br />
<br />
Once you have set up subscriptions, your forum members will be able to buy the subscriptions from ''[[Profile]] > Actions > Paid Subscriptions''.<br />
<br />
==Enabling the Paid Subscriptions==<br />
The subscriptions must be enabled first. This can be done by going to to ''[[SMF2.1:Administration Center|Administration Center]] > Configuration > [[SMF2.1:Core Features|Core Features]]'' and selecting the '''Paid Subscriptions''' option. For each subscription you plan to create, you will also need to create a [[SMF2.1:Membergroups|membergroup]], and set that membergroup's permissions accordingly.<br />
<br />
'''To provide recurring subscriptions to your users with PayPal, you need to have a PayPal business or Premier account. PayPal will return an error otherwise.'''<br />
<br />
==Settings==<br />
PayPal is currently the only payment service supported by SMF 2.1.x. <br />
<br />
It is not necessary to enable '''Instant Payment Notification (IPN)''' in your PayPal account for paid subscriptions to work. Your forum sends a '''notify_url''', which contains the return url, when it posts a payment to PayPal. This overrides the account IPN settings, and PayPal will send an IPN to your forum regardless of the account settings. If you enable IPN, you will receive an IPN when ''any payment'' is made to the account for ''any reason''. If the forum receives an IPN for a payment unrelated to paid subsciptions, it will generate an error, and send an error email to admins if notification is enabled.<br />
<br />
*'''Send Notification Emails''' - Inform the admin when a subscription automatically is paid or changes.<br />
*'''Email for Correspondence''' - Comma separated list of addresses to which email notifications are sent in addition to other forum admins.<br />
<br />
*'''Select Currency''' - Selects the currency (USD, EUR, GBP, etc.) [https://www.paypal.com/cgi-bin/webscr?cmd=p/sell/mc/mc_wa-outside (See More)].<br />
*'''Enable test mode''' - This puts the paid subscriptions into "test" mode, which will, wherever possible, use sandbox payment methods in PayPal, Authorize.net etc. Note: The "test" mode must be disabled to make real payments.<br />
<br />
*'''Paypal email address''' - The email address which that links the PayPal account. Leave blank if you do not wish to use paypal.<br />
<br />
==View Subscriptions==<br />
Once you have set things up in [[#Settings|Settings]], you will see a list of all the subscriptions you have created. You may use the '''Add Subscription''' button to create a subscription. <br />
<br />
===Add Subscription===<br />
From '''View Subscriptions''', click the '''Add Subscription''' button, fill in the settings, and click the '''Save''' button to save it.<br />
<br />
*'''Subscription Name''' - The name of the subscription.<br />
*'''Description''' - A description of the subscription.<br />
*'''Allow user to auto-renew this subscription''' - Allow users to renew automatically the subscription before this finished.<br />
*'''Active''' - The members must be active to join a subscription.<br />
<br />
*'''Primary Group upon Subscription''' - Giving a primary group for users who pay the subscription.<br />
*'''Additional Groups upon Subscription''' - Giving an additional group for users who pay the subscription.<br />
*'''Send Reminder Email''' - Send a reminder email before the subscription is finished.<br />
*'''Email to Send upon Completion''' - Send a email notification once the payment is finished.<br />
**'''<nowiki>{NAME}</nowiki>''' - Name of the user who pay for the notification email (Example: John Doe).<br />
**'''<nowiki>{FORUM}</nowiki>''' - Name of the forum for the notification email (Example: My Community).<br />
<br />
<br />
*'''Subscription for fixed price and period''' - A fixed price for the subscription in a fixed amount.<br />
**'''Cost ($):''' - The price of the subscription.<br />
**'''Length of Subscription''' - The amount of time the subscription will last.<br />
*'''Subscription price varies on duration ordered''' - You can supply different prices, depending on the duration the user selects. This will allow you to offer a discount to users who subscribe to a full year of your service.<br />
<br />
{{ {{Localized|As an administrator 2.1}}}}</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=SMF2.0:Paid_subscriptions&diff=27184SMF2.0:Paid subscriptions2014-08-12T19:55:34Z<p>Yoshi2889: Note about paypal recurring payments</p>
<hr />
<div>{{TOCright}}<br />
<br />
Paid subscriptions is a method to give forum benefits to your users in exchange for a monetary donation or payment. With this function, you can choose the name of the donation, amount, and a membergroup that will be automatically assigned to the subscribed user, as well as other options.<br />
<br />
Once you have set up subscriptions, your forum members will be able to buy the subscriptions from ''[[Profile]] > Actions > Paid Subscriptions''.<br />
<br />
==Enabling the Paid Subscriptions==<br />
The subscriptions must be enabled first. This can be done by going to to ''[[SMF2.0:Administration Center|Administration Center]] > Configuration > [[SMF2.0:Core Features|Core Features]]'' and selecting the '''Paid Subscriptions''' option. For each subscription you plan to create, you will also need to create a [[SMF2.0:Membergroups|membergroup]], and set that membergroup's permissions accordingly.<br />
<br />
'''To provide recurring subscriptions to your users with PayPal, you need to have a PayPal business or Premier account. PayPal will return an error otherwise.'''<br />
<br />
==Settings==<br />
PayPal is currently the only payment service supported by SMF 2.0.x. <br />
<br />
It is not necessary to enable '''Instant Payment Notification (IPN)''' in your PayPal account for paid subscriptions to work. Your forum sends a '''notify_url''', which contains the return url, when it posts a payment to PayPal. This overrides the account IPN settings, and PayPal will send an IPN to your forum regardless of the account settings. If you enable IPN, you will receive an IPN when ''any payment'' is made to the account for ''any reason''. If the forum receives an IPN for a payment unrelated to paid subsciptions, it will generate an error, and send an error email to admins if notification is enabled.<br />
<br />
*'''Send Notification Emails''' - Inform the admin when a subscription automatically is paid or changes.<br />
*'''Email for Correspondence''' - Comma separated list of addresses to which email notifications are sent in addition to other forum admins.<br />
<br />
*'''Select Currency''' - Selects the currency (USD, EUR, GBP, etc.) [https://www.paypal.com/cgi-bin/webscr?cmd=p/sell/mc/mc_wa-outside (See More)].<br />
*'''Enable test mode''' - This puts the paid subscriptions into "test" mode, which will, wherever possible, use sandbox payment methods in PayPal, Authorize.net etc. Note: The "test" mode must be disabled to make real payments.<br />
<br />
*'''Paypal email address''' - The email address which that links the PayPal account. Leave blank if you do not wish to use paypal.<br />
<br />
==View Subscriptions==<br />
Once you have set things up in [[#Settings|Settings]], you will see a list of all the subscriptions you have created. You may use the '''Add Subscription''' button to create a subscription. <br />
<br />
===Add Subscription===<br />
From '''View Subscriptions''', click the '''Add Subscription''' button, fill in the settings, and click the '''Save''' button to save it.<br />
<br />
*'''Subscription Name''' - The name of the subscription.<br />
*'''Description''' - A description of the subscription.<br />
*'''Allow user to auto-renew this subscription''' - Allow users to renew automatically the subscription before this finished.<br />
*'''Active''' - The members must be active to join a subscription.<br />
<br />
*'''Primary Group upon Subscription''' - Giving a primary group for users who pay the subscription.<br />
*'''Additional Groups upon Subscription''' - Giving an additional group for users who pay the subscription.<br />
*'''Send Reminder Email''' - Send a reminder email before the subscription is finished.<br />
*'''Email to Send upon Completion''' - Send a email notification once the payment is finished.<br />
**'''<nowiki>{NAME}</nowiki>''' - Name of the user who pay for the notification email (Example: John Doe).<br />
**'''<nowiki>{FORUM}</nowiki>''' - Name of the forum for the notification email (Example: My Community).<br />
<br />
<br />
*'''Subscription for fixed price and period''' - A fixed price for the subscription in a fixed amount.<br />
**'''Cost ($):''' - The price of the subscription.<br />
**'''Length of Subscription''' - The amount of time the subscription will last.<br />
*'''Subscription price varies on duration ordered''' - You can supply different prices, depending on the duration the user selects. This will allow you to offer a discount to users who subscribe to a full year of your service.<br />
<br />
{{ {{Localized|As an administrator2.0}}}}</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=Sub_templates&diff=26751Sub templates2014-07-21T16:37:45Z<p>Yoshi2889: Overhaul</p>
<hr />
<div>The template system in SMF consists of several components. One of them is the sub-template system.<br />
<br />
== What are Sub templates? ==<br />
A sub-template is what the HTML shown to users is in. For example, the board index is a sub template, found in BoardIndex.template.php. Sub templates consist of a function which gets called after the header, and before the footer. Therefore they make up the main content of the page.<br />
<br />
Sub templates contain HTML code and small bits of logic. You should not place full blocks of PHP code in the templates.<br />
<br />
== Example of a sub template ==<br />
The following code is called as a sub template.<br />
{{code|1=<nowiki>// Show an error message...<br />
function template_fatal_error()<br />
{<br />
global $context, $settings, $options, $txt;<br />
<br />
echo '<br />
<table border="0" width="80%" cellspacing="0" align="center" cellpadding="4" class="tborder"><br />
<tr class="titlebg"><br />
<td>', $context['error_title'], '</td><br />
</tr><br />
<tr class="windowbg"><br />
<td style="padding-top: 3ex; padding-bottom: 3ex;"><br />
', $context['error_message'], '<br />
</td><br />
</tr><br />
</table>';<br />
<br />
// Show a back button (using javascript.)<br />
echo '<br />
<div align="center" style="margin-top: 2ex;"><br />
<a href="javascript:history.go(-1)">', $txt[250], '</a><br />
</div>';<br />
}<br />
</nowiki>}}<br />
<br />
== Creating and implementing a sub template ==<br />
=== Step 0: Make sure your template is loaded ===<br />
Please use loadTemplate() to load your template in the source files.<br />
<br />
=== Step 1: Choose a name ===<br />
Name your sub template appropriately. For example, a media player showing a video could have its template called ''media_play_video''.<br />
<br />
=== Step 2: Tell with source files what template you want ===<br />
In your source file, add the following code in the function that shows the video. Note that we are using the example name as set above.<br />
<pre>$context['sub_template'] = 'media_play_video';</pre><br />
<br />
=== Step 3: Name your template function ===<br />
Assuming you are still using the example name above, you have to name the function.<br />
<br />
Sub templates are always prefixed with the ''template_'' prefix. So, for the example name,<br />
<pre>function template_media_play_video()<br />
{<br />
// Your code here...<br />
}</pre><br />
<br />
== Common issues ==<br />
=== Unable to load the 'main' template ===<br />
This error can have two reasons:<br />
* You have not told the sources what template to load. Please refer to step 2 in the guide.<br />
* You have not loaded your template. Please refer to step 0 in the guide.<br />
<br />
<br />
[[category:Developing SMF]]<br />
[[Category:Customizing SMF]]</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=Sub_templates&diff=26725Sub templates2014-07-21T10:58:00Z<p>Yoshi2889: Yoshi2889 moved page Okay, I'll bite... What's a sub template to Sub templates: Better title</p>
<hr />
<div>A sub-template is what the HTML is in. For example, admins can change the admin_login sub-template to make the administrative password prompt look different. They could change the error sub-template to change what is displayed upon an error.<br />
<br />
It's important to note that sub-templates are grouped within templates. The error sub-template "template_fatal_error()" can be found in the Errors.template.php, just as shown below.<br />
<br />
{{code|1=<nowiki>// Show an error message...<br />
function template_fatal_error()<br />
{<br />
global $context, $settings, $options, $txt;<br />
<br />
echo '<br />
<table border="0" width="80%" cellspacing="0" align="center"<br />
cellpadding="4" class="tborder"><br />
<tr class="titlebg"><br />
<td>', $context['error_title'], '</td><br />
</tr><br />
<tr class="windowbg"><br />
<td style="padding-top: 3ex; padding-bottom: 3ex;"><br />
', $context['error_message'], '<br />
</td><br />
</tr><br />
</table>';<br />
<br />
// Show a back button (using javascript.)<br />
echo '<br />
<div align="center" style="margin-top: 2ex;"><br />
<a href="javascript:history.go(-1)">', $txt[250], '</a><br />
</div>';<br />
}<br />
</nowiki>}}<br />
<br />
'''Breaking it down:'''<br />
<br />
Code:<br />
{{code|1=// Show an error message...}}<br />
<br />
This is used for comments to guide and tell the admin what the following block of code is.<br />
<br />
Code:<br />
{{code|1=function template_fatal_error()<br />
{<br />
<br />
}<br />
}}<br />
<br />
In JavaScript, this is the sub-template that will be executed upon encountering an error.<br />
<br />
Code:<br />
{{code|1=global $context, $settings, $options, $txt;}}<br />
<br />
This is a PHP declaration of some variables.<br />
<br />
Code:<br />
{{code|1=<nowiki>echo '<br />
<table border="0" width="80%" cellspacing="0" align="center"<br />
cellpadding="4" class="tborder"><br />
<tr class="titlebg"><br />
<td>', $context['error_title'], '</td><br />
</tr><br />
<tr class="windowbg"><br />
<td style="padding-top: 3ex; padding-bottom: 3ex;"><br />
', $context['error_message'], '<br />
</td><br />
</tr><br />
</table>';</nowiki>}}<br />
<br />
This is the actual HTML that will be sent to the browser. Note the use of the previously declared variable, $context.<br />
<br />
Code:<br />
<br />
{{code|1=// Show a back button (using JavaScript.)}}<br />
<br />
This is another comment.<br />
<br />
Code:<br />
{{code|1= <nowiki>echo '<br />
<div align="center" style="margin-top: 2ex;"><br />
<a href="javascript:history.go(-1)">', $txt[250], '</a><br />
</div>';</nowiki>}}<br />
<br />
This is some more HTML code that will be sent to the browser.<br />
<br />
[[category:Developing SMF]]<br />
[[Category:Customizing SMF]]</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=Upgrading&diff=24889Upgrading2014-05-12T14:11:10Z<p>Yoshi2889: Add image</p>
<hr />
<div>{{:Upgrade (term)}} <br />
<br />
If you are moving from an older version of SMF (for example 1.1.1) to a newer version in the same series (for example 1.1.2) and you want to avoid uninstalling your mods, you may consider [[Patching]]. If you want to install a Forum from scratch, please see the instructions on [[Installing]] SMF. If you want to convert to SMF from another Forum software, please see the instructions for [[Converting]] to SMF. <br />
<br />
{{ambox|type=notice<br />
|text=Please note that, using the large upgrade, all the [[mods]] that you have installed will have their edits to files removed.}}<br />
<br />
Upgrading an SMF forum is easy! It can be done in six quick and simple steps:<br />
<br />
==Download the Upgrade Archive==<br />
[[File:DownloadUpgrade.png|frame|300px]]<br />
The latest SMF large upgrade package can be found on the "[http://download.simplemachines.org/ Download]" page of our website.<br />
<br />
Firstly, you should download the appropriate package. The '''Large upgrade''' is the one required for upgrading. Most of the time, .zip files are the filetype that most forum administrators find the easiest to use. Most operating systems have tools to extract .zip archives already installed. <br />
<br />
{{Back up|upgrade}}<br />
<br />
{{Extract and Upload|upgrade}}<br />
<br />
{{Set file permissions|upgrade}}<br />
<br />
{{Upgrading_common_operations|update}}<br />
<br />
{{Upgrade FAQ}}<br />
<br />
{{Installing SMF}}</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=File:InstallSMF.png&diff=24886File:InstallSMF.png2014-05-12T13:18:14Z<p>Yoshi2889: </p>
<hr />
<div>== Licensing ==<br />
{{Non-free software screenshot}}</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=File:DownloadSMF.png&diff=24882File:DownloadSMF.png2014-05-12T12:46:25Z<p>Yoshi2889: </p>
<hr />
<div></div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=SMF2.0:Languages&diff=23040SMF2.0:Languages2013-12-24T11:40:00Z<p>Yoshi2889: </p>
<hr />
<div>{{TOCright}}<br />
<br />
== Edit Languages ==<br />
<br />
A table lists all the installed languages along with additional information. The table consists of the following columns:<br />
*'''Default''' - Allows you to define the language used by default, for example for guests or members who have not changed the language in their [[profile]].<br />
*'''Language Name''' - The name of the language<br />
*'''Character Set''' - The character codification of the language installed.<br />
*'''Users''' - The number of members using that particular language.<br />
*'''Locale''' - The code that defines the language. Please see [[Wikipedia:Locale]] for details<br />
<br />
If more than one language is installed, you can select which language you want to be the default. Clicking ''Save'' will then change the default language.<br />
<br />
===Edit a Language===<br />
<br />
The settings for each language are edited by clicking on the name of the language in the list. The following settings are available:<br />
<br />
*Character Set<br />
*Locale<br />
*Dictionary<br />
*Spelling<br />
*Enable "Right to Left" Mode<br />
<br />
====Edit Language Entries====<br />
<br />
From the drop-down list, select ''General Strings'' (which covers most of the strings in SMF), or one of the other choices to see all of the language entries (also referred to as language strings). These contain words like 'hello' and 'password incorrect', which are used throughout your forum. If you change these entries, and select the ''save'' button at the bottom of the page, you can change how information is displayed on your forum. Where you find strange formatting ($1$s, or {USER_NAME}), keep the strange formatting in order to continue to provide the correct information to you and your forum's users.<br />
<br />
== Add Language ==<br />
<br />
Here you can download directly new languages from the Simple Machines website. There is a box where the English name of the language can be inserted to search for it on the Simple Machines website.<br />
<br />
The results are presented in a list with details of the languages available based on the search terms. To start the installation procedure of a new language, click ''Install'' next to the relevant language.<br />
<br />
In the first step, all the language files are checked against the already installed files for that language and the page reports if the files are writable. The results of this check are displayed in a table, where you can see the version numbers of the language files; whether they are already installed; and if so, whether there are any updates available. A checkbox allows you to select which files to copy to the local forum. If no files are checked, all files are automatically installed.<br />
<br />
== Settings ==<br />
<br />
In this page it is possible to set the ''Default Forum Language'' from a drop-down menu and define if the users are allowed to select the language in which they want to view the forum by checking the ''Enable user-selectable language support'' checkbox.<br />
<br />
==Additional Information==<br />
<br />
*[[Languages_--_How_to_add_or_change_phrases_used_by_the_forum_software|How to add or change phrases used by the forum software]]<br />
<br />
{{ {{Localized|As an administrator2.0}}}}</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=SMF2.0:Languages&diff=23039SMF2.0:Languages2013-12-24T11:39:41Z<p>Yoshi2889: Fix category</p>
<hr />
<div>{{TOCright}}<br />
<br />
== Edit Languages ==<br />
<br />
A table lists all the installed languages along with additional information. The table consists of the following columns:<br />
*'''Default''' - Allows you to define the language used by default, for example for guests or members who have not changed the language in their [[profile]].<br />
*'''Language Name''' - The name of the language<br />
*'''Character Set''' - The character codification of the language installed.<br />
*'''Users''' - The number of members using that particular language.<br />
*'''Locale''' - The code that defines the language. Please see [[Wikipedia:Locale]] for details<br />
<br />
If more than one language is installed, you can select which language you want to be the default. Clicking ''Save'' will then change the default language.<br />
<br />
===Edit a Language===<br />
<br />
The settings for each language are edited by clicking on the name of the language in the list. The following settings are available:<br />
<br />
*Character Set<br />
*Locale<br />
*Dictionary<br />
*Spelling<br />
*Enable "Right to Left" Mode<br />
<br />
====Edit Language Entries====<br />
<br />
From the drop-down list, select ''General Strings'' (which covers most of the strings in SMF), or one of the other choices to see all of the language entries (also referred to as language strings). These contain words like 'hello' and 'password incorrect', which are used throughout your forum. If you change these entries, and select the ''save'' button at the bottom of the page, you can change how information is displayed on your forum. Where you find strange formatting ($1$s, or {USER_NAME}), keep the strange formatting in order to continue to provide the correct information to you and your forum's users.<br />
<br />
== Add Language ==<br />
<br />
Here you can download directly new languages from the Simple Machines website. There is a box where the English name of the language can be inserted to search for it on the Simple Machines website.<br />
<br />
The results are presented in a list with details of the languages available based on the search terms. To start the installation procedure of a new language, click ''Install'' next to the relevant language.<br />
<br />
In the first step, all the language files are checked against the already installed files for that language and the page reports if the files are writable. The results of this check are displayed in a table, where you can see the version numbers of the language files; whether they are already installed; and if so, whether there are any updates available. A checkbox allows you to select which files to copy to the local forum. If no files are checked, all files are automatically installed.<br />
<br />
== Settings ==<br />
<br />
In this page it is possible to set the ''Default Forum Language'' from a drop-down menu and define if the users are allowed to select the language in which they want to view the forum by checking the ''Enable user-selectable language support'' checkbox.<br />
<br />
==Additional Information==<br />
<br />
*[[Languages_--_How_to_add_or_change_phrases_used_by_the_forum_software|How to add or change phrases used by the forum software]]<br />
<br />
{{ {{Locallized|As an administrator2.0}}}}</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=Languages&diff=23038Languages2013-12-24T11:38:56Z<p>Yoshi2889: </p>
<hr />
<div>{{versions|2.0=yes}}<br />
<br />
{{ {{Localized|As an administrator}}}}</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=Languages&diff=23035Languages2013-12-24T11:38:38Z<p>Yoshi2889: moved Languages to SMF2.0:Languages</p>
<hr />
<div>#REDIRECT [[SMF2.0:Languages]]</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=SMF2.0:Languages&diff=23034SMF2.0:Languages2013-12-24T11:38:38Z<p>Yoshi2889: moved Languages to SMF2.0:Languages</p>
<hr />
<div>{{TOCright}}<br />
<br />
== Edit Languages ==<br />
<br />
A table lists all the installed languages along with additional information. The table consists of the following columns:<br />
*'''Default''' - Allows you to define the language used by default, for example for guests or members who have not changed the language in their [[profile]].<br />
*'''Language Name''' - The name of the language<br />
*'''Character Set''' - The character codification of the language installed.<br />
*'''Users''' - The number of members using that particular language.<br />
*'''Locale''' - The code that defines the language. Please see [[Wikipedia:Locale]] for details<br />
<br />
If more than one language is installed, you can select which language you want to be the default. Clicking ''Save'' will then change the default language.<br />
<br />
===Edit a Language===<br />
<br />
The settings for each language are edited by clicking on the name of the language in the list. The following settings are available:<br />
<br />
*Character Set<br />
*Locale<br />
*Dictionary<br />
*Spelling<br />
*Enable "Right to Left" Mode<br />
<br />
====Edit Language Entries====<br />
<br />
From the drop-down list, select ''General Strings'' (which covers most of the strings in SMF), or one of the other choices to see all of the language entries (also referred to as language strings). These contain words like 'hello' and 'password incorrect', which are used throughout your forum. If you change these entries, and select the ''save'' button at the bottom of the page, you can change how information is displayed on your forum. Where you find strange formatting ($1$s, or {USER_NAME}), keep the strange formatting in order to continue to provide the correct information to you and your forum's users.<br />
<br />
== Add Language ==<br />
<br />
Here you can download directly new languages from the Simple Machines website. There is a box where the English name of the language can be inserted to search for it on the Simple Machines website.<br />
<br />
The results are presented in a list with details of the languages available based on the search terms. To start the installation procedure of a new language, click ''Install'' next to the relevant language.<br />
<br />
In the first step, all the language files are checked against the already installed files for that language and the page reports if the files are writable. The results of this check are displayed in a table, where you can see the version numbers of the language files; whether they are already installed; and if so, whether there are any updates available. A checkbox allows you to select which files to copy to the local forum. If no files are checked, all files are automatically installed.<br />
<br />
== Settings ==<br />
<br />
In this page it is possible to set the ''Default Forum Language'' from a drop-down menu and define if the users are allowed to select the language in which they want to view the forum by checking the ''Enable user-selectable language support'' checkbox.<br />
<br />
==Additional Information==<br />
<br />
*[[Languages_--_How_to_add_or_change_phrases_used_by_the_forum_software|How to add or change phrases used by the forum software]]<br />
<br />
{{As an administrator}}</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=SMF2.0:Languages&diff=23033SMF2.0:Languages2013-12-24T11:38:20Z<p>Yoshi2889: Prepare 2.0 page</p>
<hr />
<div>{{TOCright}}<br />
<br />
== Edit Languages ==<br />
<br />
A table lists all the installed languages along with additional information. The table consists of the following columns:<br />
*'''Default''' - Allows you to define the language used by default, for example for guests or members who have not changed the language in their [[profile]].<br />
*'''Language Name''' - The name of the language<br />
*'''Character Set''' - The character codification of the language installed.<br />
*'''Users''' - The number of members using that particular language.<br />
*'''Locale''' - The code that defines the language. Please see [[Wikipedia:Locale]] for details<br />
<br />
If more than one language is installed, you can select which language you want to be the default. Clicking ''Save'' will then change the default language.<br />
<br />
===Edit a Language===<br />
<br />
The settings for each language are edited by clicking on the name of the language in the list. The following settings are available:<br />
<br />
*Character Set<br />
*Locale<br />
*Dictionary<br />
*Spelling<br />
*Enable "Right to Left" Mode<br />
<br />
====Edit Language Entries====<br />
<br />
From the drop-down list, select ''General Strings'' (which covers most of the strings in SMF), or one of the other choices to see all of the language entries (also referred to as language strings). These contain words like 'hello' and 'password incorrect', which are used throughout your forum. If you change these entries, and select the ''save'' button at the bottom of the page, you can change how information is displayed on your forum. Where you find strange formatting ($1$s, or {USER_NAME}), keep the strange formatting in order to continue to provide the correct information to you and your forum's users.<br />
<br />
== Add Language ==<br />
<br />
Here you can download directly new languages from the Simple Machines website. There is a box where the English name of the language can be inserted to search for it on the Simple Machines website.<br />
<br />
The results are presented in a list with details of the languages available based on the search terms. To start the installation procedure of a new language, click ''Install'' next to the relevant language.<br />
<br />
In the first step, all the language files are checked against the already installed files for that language and the page reports if the files are writable. The results of this check are displayed in a table, where you can see the version numbers of the language files; whether they are already installed; and if so, whether there are any updates available. A checkbox allows you to select which files to copy to the local forum. If no files are checked, all files are automatically installed.<br />
<br />
== Settings ==<br />
<br />
In this page it is possible to set the ''Default Forum Language'' from a drop-down menu and define if the users are allowed to select the language in which they want to view the forum by checking the ''Enable user-selectable language support'' checkbox.<br />
<br />
==Additional Information==<br />
<br />
*[[Languages_--_How_to_add_or_change_phrases_used_by_the_forum_software|How to add or change phrases used by the forum software]]<br />
<br />
{{As an administrator}}</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=Security_and_Moderation&diff=23032Security and Moderation2013-12-24T11:35:40Z<p>Yoshi2889: </p>
<hr />
<div>{{versions|2.0=yes}}<br />
<br />
{{ {{Localized|As an administrator}}}}</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=Security_and_Moderation&diff=23031Security and Moderation2013-12-24T11:34:46Z<p>Yoshi2889: moved Security and Moderation to SMF2.0:Security and Moderation</p>
<hr />
<div>#REDIRECT [[SMF2.0:Security and Moderation]]</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=SMF2.0:Security_and_Moderation&diff=23030SMF2.0:Security and Moderation2013-12-24T11:34:46Z<p>Yoshi2889: moved Security and Moderation to SMF2.0:Security and Moderation</p>
<hr />
<div>{{TOCright}}The ''Security'' page of your [[Administration Center]] offers several security related settings that you can configure to meet your needs. Pay close attention to these settings, as a properly secured forum generally should take measures to ensure the safety of itself and its members. <br />
<br />
== General ==<br />
The following are the settings included on this page:<br />
<br />
* '''Do not reveal contact details of members to guests''' - If selected, this option will hide the e-mail addresses and messenger contact details of all members from any guests on your forum<br />
* '''Allow viewable email addresses''' - If this option is enabled instead of users e-mail addresses being hidden to normal members and guests they will be publicly viewable on the forum. Enabling this will put your users at greater risk of being victims of spam as a result of e-mail harvesters visiting your forum. '''Note:''' this setting does not override the user setting for hiding their email address from users. Enabling this setting is not recommended.<br />
* '''Failed login threshold''' - Set the number of failed login attempts before directing the user to the password reminder screen.<br />
* '''Enable error logging''' - This will log any errors, like a failed login, so that you can see what went wrong.<br />
* '''Include database query in the error log''' - This will include the full query sent to the database in with any database error. Requires error logging to be turned on. '''Note:''' this will affect the ability to filter the error log by the error message.<br />
* '''Disable administration security''' - This disables the additional password check for the administration section. This is not recommended!<br />
* '''Require reactivation after email change''' - When this option is checked all members who change their email address in their profile will have to reactivate their account from an email sent to that address<br />
* '''Require admin approval when member deletes account''' - This will make it so that when a member deletes their account, an administrator must approve the deletion request before the account is actually deleted.<br />
* '''Enable reporting of personal messages''' - This option allows your users to report personal messages they receive to the administration team. This may be useful in helping to track down any abuse of the personal messaging system.<br />
* '''Maximum number of recipients allowed in a personal message''' - This option allows you to set the maximum amount of recipients allowed in a single personal message sent by a forum member. This may be used to help stop spam abuse of the PM system. '''Note:''' users with permission to send newsletters are exempt from this restriction. Set to zero for no limit.<br />
* '''Post count under which users must enter code when sending personal messages.''' - This setting will force users to enter a code shown on a verification image each time they are sending a personal message. Only users with a post count below the number set will need to enter the code - this should help combat automated spamming scripts.<br />
* '''Number of personal messages a user may send in an hour''' - This will limit the number of personal messages which may be sent by a user in a one hour period. This does not affect admins or moderators.<br />
<br />
== Anti-Spam ==<br />
This section allows you to setup verification checks to ensure the user is a human (and not a bot), and tweak how and where these apply.<br />
<br />
=== Anti-Spam Verification ===<br />
*'''Require verification on registration page''' - Select to enable this function.<br />
*'''Require verification on all guest searches''' - Select to enable this function.<br />
*'''Guests must pass verification when making a post''' - <small>(Automatically set if you specify a minimum post count below)</small><br />
*'''Post count under which users must pass verification to make a post''' - This setting will force users to pass anti-spam bot verification each time they make a post to a board. Only users with a post count below the number set will need to enter the code - this should help combat automated spamming scripts.<br />
*'''Guests must pass verification when reporting a post''' - Select to enable this function.<br />
*'''Maximum number of recipients allowed in a personal message''' - <small>(0 for no limit, admins are exempt)</small> This option allows you to set the maximum amount of recipients allowed in a single personal message sent by a forum member. This may be used to help stop spam abuse of the PM system. Note that users with permission to send newsletters are exempt from this restriction. Set to zero for no limit.<br />
*'''Post count under which users must pass verification when sending personal messages''' - <small>(0 for no limit, admins are exempt)</small> This setting will force users to enter a code shown on a verification image each time they are sending a personal message. Only users with a post count below the number set will need to enter the code - this should help combat automated spamming scripts.<br />
*'''Number of personal messages a user may send in an hour''' - This will limit the number of personal messages which may be sent by a user in a one hour period. This does not affect admins or moderators.<br />
<br />
<br />
===Configure Verification Methods===<br />
Below you can set which anti-spam features you wish to have enabled whenever a user needs to verify they are a human. Note that the user will have to pass all verification so if you enable both a verification image and a question/answer test they need to complete both to proceed.<br />
<br />
===Verification Questions===<br />
If you want users to answer verification questions in order to stop spam bots you should setup a number of questions in the table below. You should pick relatively simple questions; answers are not case sensitive, though you should not use a 0 (zero) or a space as an answer to a question. You may use BBC in the questions for formatting, to remove a question simply delete the contents of that line.<br />
<br />
*'''Visual verification image to display''' - This allows you to choose whether to add a verification image and to change its difficulty.<br />
*'''Number of verification questions a user must answer''' - Select any number above zero to set the number of verification questions which need to be answered.<br />
<br />
==Moderation==<br />
The ''Moderation'' page has settings that administrators can configure that deal with moderation related tasks of SMF. Most of these settings directly deal with the warning system of SMF. The warning system can be activated through [[Core Features]] page.<br />
<br />
The following options are listed on this page that involve warning levels. Warnings come into effect when one with proper permissions goes to a member's profile and selects the "Issue Warning" link on the profile sidebar menu. Here is where you can configure the percentages that are needed for having certain penalties dealt to the member, which include the following:<br />
*'''Warning level for user watch''' - The warning percentage that adds the user to the moderator watch list. A user put on watch is listed on the watch list in the [[Moderation log#Watched_Members|Watched Members]] section of the [[Moderation center]] and you can view all posts made by all watched users in that section as well.<br />
*'''Warning level for post moderation''' - The warning percentage that will force a moderator to approve each post made by the offender. '''Note:''' to see this option, [[Core Features#Post_Moderation|Post Moderation]] must be activated first.<br />
*'''Warning level for for user muting''' - The warning percentage that will not allow the member to post any further until their warning level decreases.<br />
*'''Maximum user warning points per day''' - This sets the maximum amount of points a member can acquire in one day from being warned by any single moderator. ''Administrators are excluded from this restriction''.<br />
*'''Warning points to decrement from users every 24 hours''' - If enabled, this will cause a member's points to decrease by the amount set per every 24 hours.<br />
*'''Users who can see warning status''' - This option defines which group of users can see a member's warning level: Moderators Only, Moderators and Warned Users, All Users.<br />
<br />
{{ {{Localized|As an administrator2.0}}}}</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=SMF2.0:Security_and_Moderation&diff=23029SMF2.0:Security and Moderation2013-12-24T11:33:53Z<p>Yoshi2889: Prepare 2.0 page</p>
<hr />
<div>{{TOCright}}The ''Security'' page of your [[Administration Center]] offers several security related settings that you can configure to meet your needs. Pay close attention to these settings, as a properly secured forum generally should take measures to ensure the safety of itself and its members. <br />
<br />
== General ==<br />
The following are the settings included on this page:<br />
<br />
* '''Do not reveal contact details of members to guests''' - If selected, this option will hide the e-mail addresses and messenger contact details of all members from any guests on your forum<br />
* '''Allow viewable email addresses''' - If this option is enabled instead of users e-mail addresses being hidden to normal members and guests they will be publicly viewable on the forum. Enabling this will put your users at greater risk of being victims of spam as a result of e-mail harvesters visiting your forum. '''Note:''' this setting does not override the user setting for hiding their email address from users. Enabling this setting is not recommended.<br />
* '''Failed login threshold''' - Set the number of failed login attempts before directing the user to the password reminder screen.<br />
* '''Enable error logging''' - This will log any errors, like a failed login, so that you can see what went wrong.<br />
* '''Include database query in the error log''' - This will include the full query sent to the database in with any database error. Requires error logging to be turned on. '''Note:''' this will affect the ability to filter the error log by the error message.<br />
* '''Disable administration security''' - This disables the additional password check for the administration section. This is not recommended!<br />
* '''Require reactivation after email change''' - When this option is checked all members who change their email address in their profile will have to reactivate their account from an email sent to that address<br />
* '''Require admin approval when member deletes account''' - This will make it so that when a member deletes their account, an administrator must approve the deletion request before the account is actually deleted.<br />
* '''Enable reporting of personal messages''' - This option allows your users to report personal messages they receive to the administration team. This may be useful in helping to track down any abuse of the personal messaging system.<br />
* '''Maximum number of recipients allowed in a personal message''' - This option allows you to set the maximum amount of recipients allowed in a single personal message sent by a forum member. This may be used to help stop spam abuse of the PM system. '''Note:''' users with permission to send newsletters are exempt from this restriction. Set to zero for no limit.<br />
* '''Post count under which users must enter code when sending personal messages.''' - This setting will force users to enter a code shown on a verification image each time they are sending a personal message. Only users with a post count below the number set will need to enter the code - this should help combat automated spamming scripts.<br />
* '''Number of personal messages a user may send in an hour''' - This will limit the number of personal messages which may be sent by a user in a one hour period. This does not affect admins or moderators.<br />
<br />
== Anti-Spam ==<br />
This section allows you to setup verification checks to ensure the user is a human (and not a bot), and tweak how and where these apply.<br />
<br />
=== Anti-Spam Verification ===<br />
*'''Require verification on registration page''' - Select to enable this function.<br />
*'''Require verification on all guest searches''' - Select to enable this function.<br />
*'''Guests must pass verification when making a post''' - <small>(Automatically set if you specify a minimum post count below)</small><br />
*'''Post count under which users must pass verification to make a post''' - This setting will force users to pass anti-spam bot verification each time they make a post to a board. Only users with a post count below the number set will need to enter the code - this should help combat automated spamming scripts.<br />
*'''Guests must pass verification when reporting a post''' - Select to enable this function.<br />
*'''Maximum number of recipients allowed in a personal message''' - <small>(0 for no limit, admins are exempt)</small> This option allows you to set the maximum amount of recipients allowed in a single personal message sent by a forum member. This may be used to help stop spam abuse of the PM system. Note that users with permission to send newsletters are exempt from this restriction. Set to zero for no limit.<br />
*'''Post count under which users must pass verification when sending personal messages''' - <small>(0 for no limit, admins are exempt)</small> This setting will force users to enter a code shown on a verification image each time they are sending a personal message. Only users with a post count below the number set will need to enter the code - this should help combat automated spamming scripts.<br />
*'''Number of personal messages a user may send in an hour''' - This will limit the number of personal messages which may be sent by a user in a one hour period. This does not affect admins or moderators.<br />
<br />
<br />
===Configure Verification Methods===<br />
Below you can set which anti-spam features you wish to have enabled whenever a user needs to verify they are a human. Note that the user will have to pass all verification so if you enable both a verification image and a question/answer test they need to complete both to proceed.<br />
<br />
===Verification Questions===<br />
If you want users to answer verification questions in order to stop spam bots you should setup a number of questions in the table below. You should pick relatively simple questions; answers are not case sensitive, though you should not use a 0 (zero) or a space as an answer to a question. You may use BBC in the questions for formatting, to remove a question simply delete the contents of that line.<br />
<br />
*'''Visual verification image to display''' - This allows you to choose whether to add a verification image and to change its difficulty.<br />
*'''Number of verification questions a user must answer''' - Select any number above zero to set the number of verification questions which need to be answered.<br />
<br />
==Moderation==<br />
The ''Moderation'' page has settings that administrators can configure that deal with moderation related tasks of SMF. Most of these settings directly deal with the warning system of SMF. The warning system can be activated through [[Core Features]] page.<br />
<br />
The following options are listed on this page that involve warning levels. Warnings come into effect when one with proper permissions goes to a member's profile and selects the "Issue Warning" link on the profile sidebar menu. Here is where you can configure the percentages that are needed for having certain penalties dealt to the member, which include the following:<br />
*'''Warning level for user watch''' - The warning percentage that adds the user to the moderator watch list. A user put on watch is listed on the watch list in the [[Moderation log#Watched_Members|Watched Members]] section of the [[Moderation center]] and you can view all posts made by all watched users in that section as well.<br />
*'''Warning level for post moderation''' - The warning percentage that will force a moderator to approve each post made by the offender. '''Note:''' to see this option, [[Core Features#Post_Moderation|Post Moderation]] must be activated first.<br />
*'''Warning level for for user muting''' - The warning percentage that will not allow the member to post any further until their warning level decreases.<br />
*'''Maximum user warning points per day''' - This sets the maximum amount of points a member can acquire in one day from being warned by any single moderator. ''Administrators are excluded from this restriction''.<br />
*'''Warning points to decrement from users every 24 hours''' - If enabled, this will cause a member's points to decrease by the amount set per every 24 hours.<br />
*'''Users who can see warning status''' - This option defines which group of users can see a member's warning level: Moderators Only, Moderators and Warned Users, All Users.<br />
<br />
{{ {{Localized|As an administrator2.0}}}}</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=Package_manager&diff=23028Package manager2013-12-24T11:22:58Z<p>Yoshi2889: </p>
<hr />
<div>{{versions|versions=yes}}<br />
<br />
{{ {{Localized|As an administrator}}}}</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=SMF2.0:Package_manager&diff=23027SMF2.0:Package manager2013-12-24T11:21:50Z<p>Yoshi2889: Category update</p>
<hr />
<div>{{TOCright}}The package manager is a default feature of SMF that allows you to install packages for your forum. Packages consist of customizations and updates to your forum. Customizations can be a number of things: a new feature, a theme, avatar set, smiley set, a feature enhancement, or anything you can think of and program for SMF to do. Note, however, that theme installs are not handled by the Package Manager. Before we go any further, it cannot be emphasised enough, here, that you '''really''' should backup your forum, before installing any packages (mods). It is '''very''' important that you back up both your forum '''and''' the database. Detailed information on backing-up can be found here: [[Backup]] <br />
<br />
(Please note that modifications have their own dedicated support topics. If you have any problems with a mod, whether it be with its installation or use, please post in the mod's support topic, rather than in the general support boards, as you are more likely to get a speedy and accurate response there. The topic can be accessed by clicking on the ''Support and comments for this mod'' link, on the mod's download page).<br />
<br />
== Browse Packages ==<br />
In the ''Browse Packages'' section of the package manager, you will see all of the packages that are currently downloaded on to your forum. You can install/uninstall them, view details of a package, and delete packages. Applying the package to your forum is as easy as clicking 'Proceed' next to the package you want to install, most of the time. However, you may be asked to fill in FTP information whenever the files needed are not writeable.<br />
<br />
===Latest Packages / Package of the Moment===<br />
Located at the top of the 'Browse Packages' section is a box that includes the ''Latest Packages'' that have been added to the [http://custom.simplemachines.org/ SMF Customizations Site]. Clicking on the name of any of the packages will expand information about the package taken from the mod's download/description page from the mod site. <br />
<br />
You can select ''Install Now!'' underneath the name of the mod after it is expanded and then the package will be downloaded to your forum and the install screen will appear showing which files could be edited successfully, and which ones (if any) could not be. To go back to the list of the latest packages, you can select ''(go back)'', located at the bottom of the information about the mod.<br />
<br />
These packages are grabbed from a javascript file on the SMF server which is automatically updated with the latest mods that have been added to the mod site.<br />
<br />
At the bottom of the ''Latest Packages'' box is the ''Package of the Moment'', which is chosen by selecting a random mod package from the SMF mod site. The package listed here works in the same way as the latest packages above it, and will expand, allowing you to install it.<br />
<br />
===Browse Packages===<br />
Underneath the ''Latest Packages'' box you will see the list of all the mod packages you have downloaded on to your forum. There are three options listed next to each mod:<br />
<br />
*'''Apply Mod'''/'''Install Mod''' or '''Uninstall'''<br />
*'''List Files'''<br />
*'''Delete'''<br />
<br />
When installing a package, you must select '''Apply Mod/Install Mod''' next to the package you want to install. If you see failure instead of success on the pre-install, this means that there is an issue with the editing a file the package is suppose to edit or the package does not work with your version of SMF. You might want to contact the developer of the package for further information. If there are [[Error in mod installation|test failures]], it generally not advised to proceed with the installation unless you are prepared to [[Manual installation of mods|manually install the mod]].<br />
<br />
When '''uninstalling''' a package, you must click '''''Uninstall''''' next to the package you want to uninstall. If you get any failure notices for any files, that means the mod cannot be uninstalled completely. If there are [[Error in mod installation|test failures]], it is generally advised to proceed only when you are prepared to [[Manual installation of mods|manually uninstall the mod]].<br />
<br />
===Advanced===<br />
At the bottom of the ''Browse packages'' section is a link located on the right side of the page. Clicking this will add an additional box to the page which allows you to emulate your version of SMF to another version temporarily. Just type exactly the version you want to emulate in the input box next to ''Emulate Version''. This is useful if a mod is set to only install for specific versions of SMF, however the mod may still work on your version. To revert the text entered in the input to your version of SMF, click the ''Revert'' link.<br />
<br />
For more information on using this feature, please see [[How can I install a mod that doesn't work in my SMF version]]<br />
<br />
== Download Packages ==<br />
The download packages section of the package manager provides tools for loading and installing a package and for using the package server browser. To download a package is to obtain it from some place it is stored. In some cases, the package may be downloaded directly to your forum. In other cases, it must be first downloaded to your desktop, then uploaded from your desktop to your forum. Download packages is accessed by selecting the download packages tab from the package manager. Required FTP settings are found in the installation options section.<br />
<br />
===Package servers===<br />
An SMF package server is a repository stocked with modification packages for SMF forums.<br />
<br />
The package server's ''browse'' feature can be used in either of the following ways:<br />
*To obtain packages from a local SMF package server, if one is located on the forum host<br />
*To obtain packages from a remote SMF package server (such as the Simple Machines third party mod site), if the forum host permits downloading SMF packages directly from a remote SMF package server<br />
<br />
Selecting the ''browse'' button next to a server in the package servers list allows viewing of the packages available on that package server. If this feature does not work, uploading a package may be used instead, in order to upload a package that has already been manually downloaded to the desktop. The ''delete'' button is used to remove a package server listing.<br />
<br />
===Add server===<br />
To add a package server to the list, the administrator may type in a server name (e.g. Simple Machines Third-party Mod Site) and a URL (e.g. http://custom.simplemachines.org/mods/), then select the add server button.<br />
<br />
===Download a package by URL===<br />
Download a package by URL is a quick way to download a package from the web to a forum.<br />
<br />
*URL - The exact URL of the desired modification package.<br />
*Name of the file - Required if the download URL does not include the file name of the package. If left blank, the base name of the file from the URL will be used. For example, the default name of the file for a package mod_name.zip would be mod_name.<br />
<br />
''For example the URL format will be: http://custom.simplemachines.org/mods/index.php?action=download;mod=1519;id=179488''<br />
<br />
===Upload a Package===<br />
Upload a Package is used to upload a package from the desktop to the forum. The browse button is used to locate the package file, and the upload button is used to upload it to the forum. After an upload, the administrator is given the option to immediately apply the package, or to use browse packages to install it at a later time.<br />
<br />
If you prefer, you may upload the package, or a directory full of package files, to your "Packages" directory, using FTP. {{For more information|about=Uploading packages using FTP|Packages - How to upload packages using FTP}}.<br />
<br />
==Installing a Package==<br />
Once you have uploaded a package, you can install it -- either immediately, or later, from the Browse Packages list.<br />
<br />
Under the heading '''Apply Mod/Install Mod''', you'll see the warning ''Please remember to always make regular backups of your sources and database before installing mods, especially beta versions.'' Heeding this advice can save you from trouble later.<br />
<br />
Below this, the '''Installation Readme''' will display any ''readme'' text supplied by the mod's author.<br />
<br />
Under the heading of '''Installations actions''', you will see a list of all the actions the package manager will take to install this mod. You will see actions of the following types.<br />
*Execute Modification: Changes made to existing files. Select the [[File:selected.gif|alt=selected]] icon to reveal a list of exactly what is being done to this file, complete with an [[File:Package_ops.gif|alt=Package ops]] icon to show the search and/or replace strings used in this operation.<br />
*Extract file: A file will be copied from the package, to the given path and file name.<br />
*Extract Tree: An entire directory full of files will be copied from the package to the given path<br />
*Adapt Database: The named script from the package will be executed. Generally, this script will get the database ready for the mod to run.<br />
Modification packages often make changes to the default theme. These will be listed under '''Installation actions'''. Often, it is possible for the package to make changes to all of your themes. These changes are optional, and won't be done unless you check the box next to the modification's name.<br />
<br />
As the Package Manager prepares this list, it has made a backup of php files for the forum (please see the [[A mod broke my forum what should I do|FAQ on using package backups]] for more on this file). At the same time, it tests each action it is preparing to take on your forum, and reports the results in the list. The Package manager will report whether the installation test was a success or a failure. If the test failed, it is recommended that you resolve the problem before proceeding with the installation. Checking out the parser, on the mod's download page, will tell you which edits are made to which files. If you can match up the file edited, there with the edit that is failing, you can often make the failed edit, yourself, manually. If you do that, we have to stress, again, the importance of backing-up, before you do this. You can read more about [[Manual_installation_of_mods|installing mods by hand]] if you plan to make such edits.<br />
<br />
Installation will begin when you select the '''Install Now''' button at the bottom of the page. After a successful installation, the Package Manager may redirect you to the new mod's configuration page, or return you to the Package Manager.<br />
<br />
== Installed Packages ==<br />
This page allows you to view your installed mods, the files included in each mod, and gives you the ability to uninstall any mods that you no longer want at the moment. It is similar to the [[Browse Packages]] section.<br />
<br />
You can select the ''Delete Mod List'' button at the bottom of the page to clear the list of mods you have installed, but this is generally not recommended.<br />
<br />
== File Permissions ==<br />
You can use this section to review the writeable status of critical files and directories within your forum directory. Note this only considers key forum directories and files - use an FTP client for additional options.<br />
<br />
Please Note:<br />
#Be careful when changing file permissions from this section - incorrect permissions can adversely affect the operation of your forum!<br />
#On some server configurations selecting the wrong permissions may stop SMF from operating.<br />
#Certain directories such as attachments need to be writeable to use that functionality.<br />
#This functionality is mainly applicable on non-Windows based servers - it will not work as expected on Windows with respect to permission flags.<br />
#Before proceeding make sure you have an FTP client installed in case you do make an error and you need to FTP into the server to remedy it.<br />
#If you make changes to your file permissions and they do not seem to be having the effect that you expected, you will need to contact your host, asking them if you have '''full ownership''' of all of the files on your site. Do not worry, if you do not know what that means, exactly, because your host certainly will.<br />
<br />
===Change File Permissions===<br />
'''Apply individual file permissions settings selected above''': <br />
:''If "Custom" has been selected use chmod value of: You can manually set the permissions you wish to set the selected files to. To do this enter the chmod value as a numeric (octet) value. Note - these flags will have no effect on Microsoft Windows operating systems.''<br />
<br />
'''Use predefined permission profile''': this only applies the predefined profile to key SMF directories and files.<br />
<br />
== Options ==<br />
The installation Options section of the package manager, accessed via package manager's options tab, is for information that is sometimes required during installation. Some package installations may require FTP login information or changes to file permissions.<br />
<br />
*Installation Options<br />
*Cleanup Permissions<br />
*FTP Information Required<br />
<br />
===Installation Options===<br />
Settings for FTP Server, Username and Port are used by SMF to make an FTP connection in order to complete certain package installations. The Create Backup versions of replaced files with a tilde (~) on the end of their names checkbox instructs SMF to save a backup version of any file that is changed or replaced during installation.<br />
<br />
{{ {{Localized|As an administrator2.0}}}}</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=SMF2.0:Package_manager&diff=23026SMF2.0:Package manager2013-12-24T11:21:22Z<p>Yoshi2889: Forgot to remove a 2.0-specific mention</p>
<hr />
<div>{{TOCright}}The package manager is a default feature of SMF that allows you to install packages for your forum. Packages consist of customizations and updates to your forum. Customizations can be a number of things: a new feature, a theme, avatar set, smiley set, a feature enhancement, or anything you can think of and program for SMF to do. Note, however, that theme installs are not handled by the Package Manager. Before we go any further, it cannot be emphasised enough, here, that you '''really''' should backup your forum, before installing any packages (mods). It is '''very''' important that you back up both your forum '''and''' the database. Detailed information on backing-up can be found here: [[Backup]] <br />
<br />
(Please note that modifications have their own dedicated support topics. If you have any problems with a mod, whether it be with its installation or use, please post in the mod's support topic, rather than in the general support boards, as you are more likely to get a speedy and accurate response there. The topic can be accessed by clicking on the ''Support and comments for this mod'' link, on the mod's download page).<br />
<br />
== Browse Packages ==<br />
In the ''Browse Packages'' section of the package manager, you will see all of the packages that are currently downloaded on to your forum. You can install/uninstall them, view details of a package, and delete packages. Applying the package to your forum is as easy as clicking 'Proceed' next to the package you want to install, most of the time. However, you may be asked to fill in FTP information whenever the files needed are not writeable.<br />
<br />
===Latest Packages / Package of the Moment===<br />
Located at the top of the 'Browse Packages' section is a box that includes the ''Latest Packages'' that have been added to the [http://custom.simplemachines.org/ SMF Customizations Site]. Clicking on the name of any of the packages will expand information about the package taken from the mod's download/description page from the mod site. <br />
<br />
You can select ''Install Now!'' underneath the name of the mod after it is expanded and then the package will be downloaded to your forum and the install screen will appear showing which files could be edited successfully, and which ones (if any) could not be. To go back to the list of the latest packages, you can select ''(go back)'', located at the bottom of the information about the mod.<br />
<br />
These packages are grabbed from a javascript file on the SMF server which is automatically updated with the latest mods that have been added to the mod site.<br />
<br />
At the bottom of the ''Latest Packages'' box is the ''Package of the Moment'', which is chosen by selecting a random mod package from the SMF mod site. The package listed here works in the same way as the latest packages above it, and will expand, allowing you to install it.<br />
<br />
===Browse Packages===<br />
Underneath the ''Latest Packages'' box you will see the list of all the mod packages you have downloaded on to your forum. There are three options listed next to each mod:<br />
<br />
*'''Apply Mod'''/'''Install Mod''' or '''Uninstall'''<br />
*'''List Files'''<br />
*'''Delete'''<br />
<br />
When installing a package, you must select '''Apply Mod/Install Mod''' next to the package you want to install. If you see failure instead of success on the pre-install, this means that there is an issue with the editing a file the package is suppose to edit or the package does not work with your version of SMF. You might want to contact the developer of the package for further information. If there are [[Error in mod installation|test failures]], it generally not advised to proceed with the installation unless you are prepared to [[Manual installation of mods|manually install the mod]].<br />
<br />
When '''uninstalling''' a package, you must click '''''Uninstall''''' next to the package you want to uninstall. If you get any failure notices for any files, that means the mod cannot be uninstalled completely. If there are [[Error in mod installation|test failures]], it is generally advised to proceed only when you are prepared to [[Manual installation of mods|manually uninstall the mod]].<br />
<br />
===Advanced===<br />
At the bottom of the ''Browse packages'' section is a link located on the right side of the page. Clicking this will add an additional box to the page which allows you to emulate your version of SMF to another version temporarily. Just type exactly the version you want to emulate in the input box next to ''Emulate Version''. This is useful if a mod is set to only install for specific versions of SMF, however the mod may still work on your version. To revert the text entered in the input to your version of SMF, click the ''Revert'' link.<br />
<br />
For more information on using this feature, please see [[How can I install a mod that doesn't work in my SMF version]]<br />
<br />
== Download Packages ==<br />
The download packages section of the package manager provides tools for loading and installing a package and for using the package server browser. To download a package is to obtain it from some place it is stored. In some cases, the package may be downloaded directly to your forum. In other cases, it must be first downloaded to your desktop, then uploaded from your desktop to your forum. Download packages is accessed by selecting the download packages tab from the package manager. Required FTP settings are found in the installation options section.<br />
<br />
===Package servers===<br />
An SMF package server is a repository stocked with modification packages for SMF forums.<br />
<br />
The package server's ''browse'' feature can be used in either of the following ways:<br />
*To obtain packages from a local SMF package server, if one is located on the forum host<br />
*To obtain packages from a remote SMF package server (such as the Simple Machines third party mod site), if the forum host permits downloading SMF packages directly from a remote SMF package server<br />
<br />
Selecting the ''browse'' button next to a server in the package servers list allows viewing of the packages available on that package server. If this feature does not work, uploading a package may be used instead, in order to upload a package that has already been manually downloaded to the desktop. The ''delete'' button is used to remove a package server listing.<br />
<br />
===Add server===<br />
To add a package server to the list, the administrator may type in a server name (e.g. Simple Machines Third-party Mod Site) and a URL (e.g. http://custom.simplemachines.org/mods/), then select the add server button.<br />
<br />
===Download a package by URL===<br />
Download a package by URL is a quick way to download a package from the web to a forum.<br />
<br />
*URL - The exact URL of the desired modification package.<br />
*Name of the file - Required if the download URL does not include the file name of the package. If left blank, the base name of the file from the URL will be used. For example, the default name of the file for a package mod_name.zip would be mod_name.<br />
<br />
''For example the URL format will be: http://custom.simplemachines.org/mods/index.php?action=download;mod=1519;id=179488''<br />
<br />
===Upload a Package===<br />
Upload a Package is used to upload a package from the desktop to the forum. The browse button is used to locate the package file, and the upload button is used to upload it to the forum. After an upload, the administrator is given the option to immediately apply the package, or to use browse packages to install it at a later time.<br />
<br />
If you prefer, you may upload the package, or a directory full of package files, to your "Packages" directory, using FTP. {{For more information|about=Uploading packages using FTP|Packages - How to upload packages using FTP}}.<br />
<br />
==Installing a Package==<br />
Once you have uploaded a package, you can install it -- either immediately, or later, from the Browse Packages list.<br />
<br />
Under the heading '''Apply Mod/Install Mod''', you'll see the warning ''Please remember to always make regular backups of your sources and database before installing mods, especially beta versions.'' Heeding this advice can save you from trouble later.<br />
<br />
Below this, the '''Installation Readme''' will display any ''readme'' text supplied by the mod's author.<br />
<br />
Under the heading of '''Installations actions''', you will see a list of all the actions the package manager will take to install this mod. You will see actions of the following types.<br />
*Execute Modification: Changes made to existing files. Select the [[File:selected.gif|alt=selected]] icon to reveal a list of exactly what is being done to this file, complete with an [[File:Package_ops.gif|alt=Package ops]] icon to show the search and/or replace strings used in this operation.<br />
*Extract file: A file will be copied from the package, to the given path and file name.<br />
*Extract Tree: An entire directory full of files will be copied from the package to the given path<br />
*Adapt Database: The named script from the package will be executed. Generally, this script will get the database ready for the mod to run.<br />
Modification packages often make changes to the default theme. These will be listed under '''Installation actions'''. Often, it is possible for the package to make changes to all of your themes. These changes are optional, and won't be done unless you check the box next to the modification's name.<br />
<br />
As the Package Manager prepares this list, it has made a backup of php files for the forum (please see the [[A mod broke my forum what should I do|FAQ on using package backups]] for more on this file). At the same time, it tests each action it is preparing to take on your forum, and reports the results in the list. The Package manager will report whether the installation test was a success or a failure. If the test failed, it is recommended that you resolve the problem before proceeding with the installation. Checking out the parser, on the mod's download page, will tell you which edits are made to which files. If you can match up the file edited, there with the edit that is failing, you can often make the failed edit, yourself, manually. If you do that, we have to stress, again, the importance of backing-up, before you do this. You can read more about [[Manual_installation_of_mods|installing mods by hand]] if you plan to make such edits.<br />
<br />
Installation will begin when you select the '''Install Now''' button at the bottom of the page. After a successful installation, the Package Manager may redirect you to the new mod's configuration page, or return you to the Package Manager.<br />
<br />
== Installed Packages ==<br />
This page allows you to view your installed mods, the files included in each mod, and gives you the ability to uninstall any mods that you no longer want at the moment. It is similar to the [[Browse Packages]] section.<br />
<br />
You can select the ''Delete Mod List'' button at the bottom of the page to clear the list of mods you have installed, but this is generally not recommended.<br />
<br />
== File Permissions ==<br />
You can use this section to review the writeable status of critical files and directories within your forum directory. Note this only considers key forum directories and files - use an FTP client for additional options.<br />
<br />
Please Note:<br />
#Be careful when changing file permissions from this section - incorrect permissions can adversely affect the operation of your forum!<br />
#On some server configurations selecting the wrong permissions may stop SMF from operating.<br />
#Certain directories such as attachments need to be writeable to use that functionality.<br />
#This functionality is mainly applicable on non-Windows based servers - it will not work as expected on Windows with respect to permission flags.<br />
#Before proceeding make sure you have an FTP client installed in case you do make an error and you need to FTP into the server to remedy it.<br />
#If you make changes to your file permissions and they do not seem to be having the effect that you expected, you will need to contact your host, asking them if you have '''full ownership''' of all of the files on your site. Do not worry, if you do not know what that means, exactly, because your host certainly will.<br />
<br />
===Change File Permissions===<br />
'''Apply individual file permissions settings selected above''': <br />
:''If "Custom" has been selected use chmod value of: You can manually set the permissions you wish to set the selected files to. To do this enter the chmod value as a numeric (octet) value. Note - these flags will have no effect on Microsoft Windows operating systems.''<br />
<br />
'''Use predefined permission profile''': this only applies the predefined profile to key SMF directories and files.<br />
<br />
== Options ==<br />
The installation Options section of the package manager, accessed via package manager's options tab, is for information that is sometimes required during installation. Some package installations may require FTP login information or changes to file permissions.<br />
<br />
*Installation Options<br />
*Cleanup Permissions<br />
*FTP Information Required<br />
<br />
===Installation Options===<br />
Settings for FTP Server, Username and Port are used by SMF to make an FTP connection in order to complete certain package installations. The Create Backup versions of replaced files with a tilde (~) on the end of their names checkbox instructs SMF to save a backup version of any file that is changed or replaced during installation.<br />
<br />
{{ {{Localized|As an administrator}}}}</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=SMF2.0:Package_manager&diff=23025SMF2.0:Package manager2013-12-24T11:20:41Z<p>Yoshi2889: Create 2.0 page</p>
<hr />
<div>{{TOCright}}The package manager is a default feature of SMF that allows you to install packages for your forum. Packages consist of customizations and updates to your forum. Customizations can be a number of things: a new feature, a theme, avatar set, smiley set, a feature enhancement, or anything you can think of and program for SMF to do. Note, however, that theme installs are not handled by the Package Manager. Before we go any further, it cannot be emphasised enough, here, that you '''really''' should backup your forum, before installing any packages (mods). It is '''very''' important that you back up both your forum '''and''' the database. Detailed information on backing-up can be found here: [[Backup]] <br />
<br />
(Please note that modifications have their own dedicated support topics. If you have any problems with a mod, whether it be with its installation or use, please post in the mod's support topic, rather than in the general support boards, as you are more likely to get a speedy and accurate response there. The topic can be accessed by clicking on the ''Support and comments for this mod'' link, on the mod's download page).<br />
<br />
== Browse Packages ==<br />
In the ''Browse Packages'' section of the package manager, you will see all of the packages that are currently downloaded on to your forum. You can install/uninstall them, view details of a package, and delete packages. Applying the package to your forum is as easy as clicking 'Proceed' next to the package you want to install, most of the time. However, you may be asked to fill in FTP information whenever the files needed are not writeable.<br />
<br />
===Latest Packages / Package of the Moment===<br />
Located at the top of the 'Browse Packages' section is a box that includes the ''Latest Packages'' that have been added to the [http://custom.simplemachines.org/ SMF Customizations Site]. Clicking on the name of any of the packages will expand information about the package taken from the mod's download/description page from the mod site. <br />
<br />
You can select ''Install Now!'' underneath the name of the mod after it is expanded and then the package will be downloaded to your forum and the install screen will appear showing which files could be edited successfully, and which ones (if any) could not be. To go back to the list of the latest packages, you can select ''(go back)'', located at the bottom of the information about the mod.<br />
<br />
These packages are grabbed from a javascript file on the SMF server which is automatically updated with the latest mods that have been added to the mod site.<br />
<br />
At the bottom of the ''Latest Packages'' box is the ''Package of the Moment'', which is chosen by selecting a random mod package from the SMF mod site. The package listed here works in the same way as the latest packages above it, and will expand, allowing you to install it.<br />
<br />
===Browse Packages===<br />
Underneath the ''Latest Packages'' box you will see the list of all the mod packages you have downloaded on to your forum. There are three options listed next to each mod:<br />
<br />
*'''Apply Mod'''/'''Install Mod''' or '''Uninstall'''<br />
*'''List Files'''<br />
*'''Delete'''<br />
<br />
When installing a package, you must select '''Apply Mod/Install Mod''' next to the package you want to install. If you see failure instead of success on the pre-install, this means that there is an issue with the editing a file the package is suppose to edit or the package does not work with your version of SMF. You might want to contact the developer of the package for further information. If there are [[Error in mod installation|test failures]], it generally not advised to proceed with the installation unless you are prepared to [[Manual installation of mods|manually install the mod]].<br />
<br />
When '''uninstalling''' a package, you must click '''''Uninstall''''' next to the package you want to uninstall. If you get any failure notices for any files, that means the mod cannot be uninstalled completely. If there are [[Error in mod installation|test failures]], it is generally advised to proceed only when you are prepared to [[Manual installation of mods|manually uninstall the mod]].<br />
<br />
{{Version Specific|small=yes<br />
|version=2<br />
|content= ===Advanced===<br />
At the bottom of the ''Browse packages'' section is a link located on the right side of the page. Clicking this will add an additional box to the page which allows you to emulate your version of SMF to another version temporarily. Just type exactly the version you want to emulate in the input box next to ''Emulate Version''. This is useful if a mod is set to only install for specific versions of SMF, however the mod may still work on your version. To revert the text entered in the input to your version of SMF, click the ''Revert'' link.<br />
<br />
For more information on using this feature, please see [[How can I install a mod that doesn't work in my SMF version]]<br />
}}<br />
<br />
== Download Packages ==<br />
The download packages section of the package manager provides tools for loading and installing a package and for using the package server browser. To download a package is to obtain it from some place it is stored. In some cases, the package may be downloaded directly to your forum. In other cases, it must be first downloaded to your desktop, then uploaded from your desktop to your forum. Download packages is accessed by selecting the download packages tab from the package manager. Required FTP settings are found in the installation options section.<br />
<br />
===Package servers===<br />
An SMF package server is a repository stocked with modification packages for SMF forums.<br />
<br />
The package server's ''browse'' feature can be used in either of the following ways:<br />
*To obtain packages from a local SMF package server, if one is located on the forum host<br />
*To obtain packages from a remote SMF package server (such as the Simple Machines third party mod site), if the forum host permits downloading SMF packages directly from a remote SMF package server<br />
<br />
Selecting the ''browse'' button next to a server in the package servers list allows viewing of the packages available on that package server. If this feature does not work, uploading a package may be used instead, in order to upload a package that has already been manually downloaded to the desktop. The ''delete'' button is used to remove a package server listing.<br />
<br />
===Add server===<br />
To add a package server to the list, the administrator may type in a server name (e.g. Simple Machines Third-party Mod Site) and a URL (e.g. http://custom.simplemachines.org/mods/), then select the add server button.<br />
<br />
===Download a package by URL===<br />
Download a package by URL is a quick way to download a package from the web to a forum.<br />
<br />
*URL - The exact URL of the desired modification package.<br />
*Name of the file - Required if the download URL does not include the file name of the package. If left blank, the base name of the file from the URL will be used. For example, the default name of the file for a package mod_name.zip would be mod_name.<br />
<br />
''For example the URL format will be: http://custom.simplemachines.org/mods/index.php?action=download;mod=1519;id=179488''<br />
<br />
===Upload a Package===<br />
Upload a Package is used to upload a package from the desktop to the forum. The browse button is used to locate the package file, and the upload button is used to upload it to the forum. After an upload, the administrator is given the option to immediately apply the package, or to use browse packages to install it at a later time.<br />
<br />
If you prefer, you may upload the package, or a directory full of package files, to your "Packages" directory, using FTP. {{For more information|about=Uploading packages using FTP|Packages - How to upload packages using FTP}}.<br />
<br />
==Installing a Package==<br />
Once you have uploaded a package, you can install it -- either immediately, or later, from the Browse Packages list.<br />
<br />
Under the heading '''Apply Mod/Install Mod''', you'll see the warning ''Please remember to always make regular backups of your sources and database before installing mods, especially beta versions.'' Heeding this advice can save you from trouble later.<br />
<br />
Below this, the '''Installation Readme''' will display any ''readme'' text supplied by the mod's author.<br />
<br />
Under the heading of '''Installations actions''', you will see a list of all the actions the package manager will take to install this mod. You will see actions of the following types.<br />
*Execute Modification: Changes made to existing files. Select the [[File:selected.gif|alt=selected]] icon to reveal a list of exactly what is being done to this file, complete with an [[File:Package_ops.gif|alt=Package ops]] icon to show the search and/or replace strings used in this operation.<br />
*Extract file: A file will be copied from the package, to the given path and file name.<br />
*Extract Tree: An entire directory full of files will be copied from the package to the given path<br />
*Adapt Database: The named script from the package will be executed. Generally, this script will get the database ready for the mod to run.<br />
Modification packages often make changes to the default theme. These will be listed under '''Installation actions'''. Often, it is possible for the package to make changes to all of your themes. These changes are optional, and won't be done unless you check the box next to the modification's name.<br />
<br />
As the Package Manager prepares this list, it has made a backup of php files for the forum (please see the [[A mod broke my forum what should I do|FAQ on using package backups]] for more on this file). At the same time, it tests each action it is preparing to take on your forum, and reports the results in the list. The Package manager will report whether the installation test was a success or a failure. If the test failed, it is recommended that you resolve the problem before proceeding with the installation. Checking out the parser, on the mod's download page, will tell you which edits are made to which files. If you can match up the file edited, there with the edit that is failing, you can often make the failed edit, yourself, manually. If you do that, we have to stress, again, the importance of backing-up, before you do this. You can read more about [[Manual_installation_of_mods|installing mods by hand]] if you plan to make such edits.<br />
<br />
Installation will begin when you select the '''Install Now''' button at the bottom of the page. After a successful installation, the Package Manager may redirect you to the new mod's configuration page, or return you to the Package Manager.<br />
<br />
== Installed Packages ==<br />
This page allows you to view your installed mods, the files included in each mod, and gives you the ability to uninstall any mods that you no longer want at the moment. It is similar to the [[Browse Packages]] section.<br />
<br />
You can select the ''Delete Mod List'' button at the bottom of the page to clear the list of mods you have installed, but this is generally not recommended.<br />
<br />
== File Permissions ==<br />
You can use this section to review the writeable status of critical files and directories within your forum directory. Note this only considers key forum directories and files - use an FTP client for additional options.<br />
<br />
Please Note:<br />
#Be careful when changing file permissions from this section - incorrect permissions can adversely affect the operation of your forum!<br />
#On some server configurations selecting the wrong permissions may stop SMF from operating.<br />
#Certain directories such as attachments need to be writeable to use that functionality.<br />
#This functionality is mainly applicable on non-Windows based servers - it will not work as expected on Windows with respect to permission flags.<br />
#Before proceeding make sure you have an FTP client installed in case you do make an error and you need to FTP into the server to remedy it.<br />
#If you make changes to your file permissions and they do not seem to be having the effect that you expected, you will need to contact your host, asking them if you have '''full ownership''' of all of the files on your site. Do not worry, if you do not know what that means, exactly, because your host certainly will.<br />
<br />
===Change File Permissions===<br />
'''Apply individual file permissions settings selected above''': <br />
:''If "Custom" has been selected use chmod value of: You can manually set the permissions you wish to set the selected files to. To do this enter the chmod value as a numeric (octet) value. Note - these flags will have no effect on Microsoft Windows operating systems.''<br />
<br />
'''Use predefined permission profile''': this only applies the predefined profile to key SMF directories and files.<br />
<br />
== Options ==<br />
The installation Options section of the package manager, accessed via package manager's options tab, is for information that is sometimes required during installation. Some package installations may require FTP login information or changes to file permissions.<br />
<br />
*Installation Options<br />
*Cleanup Permissions<br />
*FTP Information Required<br />
<br />
===Installation Options===<br />
Settings for FTP Server, Username and Port are used by SMF to make an FTP connection in order to complete certain package installations. The Create Backup versions of replaced files with a tilde (~) on the end of their names checkbox instructs SMF to save a backup version of any file that is changed or replaced during installation.<br />
<br />
{{ {{Localized|As an administrator}}}}</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=SMF1.1:Package_manager&diff=23024SMF1.1:Package manager2013-12-24T11:18:03Z<p>Yoshi2889: Prepare 1.1 page</p>
<hr />
<div>{{TOCright}}The package manager is a default feature of SMF that allows you to install packages for your forum. Packages consist of customizations and updates to your forum. Customizations can be a number of things: a new feature, a theme, avatar set, smiley set, a feature enhancement, or anything you can think of and program for SMF to do. Note, however, that theme installs are not handled by the Package Manager. Before we go any further, it cannot be emphasised enough, here, that you '''really''' should backup your forum, before installing any packages (mods). It is '''very''' important that you back up both your forum '''and''' the database. Detailed information on backing-up can be found here: [[Backup]] <br />
<br />
(Please note that modifications have their own dedicated support topics. If you have any problems with a mod, whether it be with its installation or use, please post in the mod's support topic, rather than in the general support boards, as you are more likely to get a speedy and accurate response there. The topic can be accessed by clicking on the ''Support and comments for this mod'' link, on the mod's download page).<br />
<br />
== Browse Packages ==<br />
In the ''Browse Packages'' section of the package manager, you will see all of the packages that are currently downloaded on to your forum. You can install/uninstall them, view details of a package, and delete packages. Applying the package to your forum is as easy as clicking 'Proceed' next to the package you want to install, most of the time. However, you may be asked to fill in FTP information whenever the files needed are not writeable.<br />
<br />
===Latest Packages / Package of the Moment===<br />
Located at the top of the 'Browse Packages' section is a box that includes the ''Latest Packages'' that have been added to the [http://custom.simplemachines.org/ SMF Customizations Site]. Clicking on the name of any of the packages will expand information about the package taken from the mod's download/description page from the mod site. <br />
<br />
You can select ''Install Now!'' underneath the name of the mod after it is expanded and then the package will be downloaded to your forum and the install screen will appear showing which files could be edited successfully, and which ones (if any) could not be. To go back to the list of the latest packages, you can select ''(go back)'', located at the bottom of the information about the mod.<br />
<br />
These packages are grabbed from a javascript file on the SMF server which is automatically updated with the latest mods that have been added to the mod site.<br />
<br />
At the bottom of the ''Latest Packages'' box is the ''Package of the Moment'', which is chosen by selecting a random mod package from the SMF mod site. The package listed here works in the same way as the latest packages above it, and will expand, allowing you to install it.<br />
<br />
===Browse Packages===<br />
Underneath the ''Latest Packages'' box you will see the list of all the mod packages you have downloaded on to your forum. There are three options listed next to each mod:<br />
<br />
*'''Apply Mod'''/'''Install Mod''' or '''Uninstall'''<br />
*'''List Files'''<br />
*'''Delete'''<br />
<br />
When installing a package, you must select '''Apply Mod/Install Mod''' next to the package you want to install. If you see failure instead of success on the pre-install, this means that there is an issue with the editing a file the package is suppose to edit or the package does not work with your version of SMF. You might want to contact the developer of the package for further information. If there are [[Error in mod installation|test failures]], it generally not advised to proceed with the installation unless you are prepared to [[Manual installation of mods|manually install the mod]].<br />
<br />
When '''uninstalling''' a package, you must click '''''Uninstall''''' next to the package you want to uninstall. If you get any failure notices for any files, that means the mod cannot be uninstalled completely. If there are [[Error in mod installation|test failures]], it is generally advised to proceed only when you are prepared to [[Manual installation of mods|manually uninstall the mod]].<br />
<br />
== Download Packages ==<br />
The download packages section of the package manager provides tools for loading and installing a package and for using the package server browser. To download a package is to obtain it from some place it is stored. In some cases, the package may be downloaded directly to your forum. In other cases, it must be first downloaded to your desktop, then uploaded from your desktop to your forum. Download packages is accessed by selecting the download packages tab from the package manager. Required FTP settings are found in the installation options section.<br />
<br />
===Package servers===<br />
An SMF package server is a repository stocked with modification packages for SMF forums.<br />
<br />
The package server's ''browse'' feature can be used in either of the following ways:<br />
*To obtain packages from a local SMF package server, if one is located on the forum host<br />
*To obtain packages from a remote SMF package server (such as the Simple Machines third party mod site), if the forum host permits downloading SMF packages directly from a remote SMF package server<br />
<br />
Selecting the ''browse'' button next to a server in the package servers list allows viewing of the packages available on that package server. If this feature does not work, uploading a package may be used instead, in order to upload a package that has already been manually downloaded to the desktop. The ''delete'' button is used to remove a package server listing.<br />
<br />
===Add server===<br />
To add a package server to the list, the administrator may type in a server name (e.g. Simple Machines Third-party Mod Site) and a URL (e.g. http://custom.simplemachines.org/mods/), then select the add server button.<br />
<br />
===Upload a Package===<br />
Upload a Package is used to upload a package from the desktop to the forum. The browse button is used to locate the package file, and the upload button is used to upload it to the forum. After an upload, the administrator is given the option to immediately apply the package, or to use browse packages to install it at a later time.<br />
<br />
If you prefer, you may upload the package, or a directory full of package files, to your "Packages" directory, using FTP. {{For more information|about=Uploading packages using FTP|Packages - How to upload packages using FTP}}.<br />
<br />
==Installing a Package==<br />
Once you have uploaded a package, you can install it -- either immediately, or later, from the Browse Packages list.<br />
<br />
Under the heading '''Apply Mod/Install Mod''', you'll see the warning ''Please remember to always make regular backups of your sources and database before installing mods, especially beta versions.'' Heeding this advice can save you from trouble later.<br />
<br />
Below this, the '''Installation Readme''' will display any ''readme'' text supplied by the mod's author.<br />
<br />
Under the heading of '''Installations actions''', you will see a list of all the actions the package manager will take to install this mod. You will see actions of the following types.<br />
*Extract file: A file will be copied from the package, to the given path and file name.<br />
*Extract Tree: An entire directory full of files will be copied from the package to the given path<br />
*Adapt Database: The named script from the package will be executed. Generally, this script will get the database ready for the mod to run.<br />
<br />
As the Package Manager prepares this list, it has made a backup of php files for the forum (please see the [[A mod broke my forum what should I do|FAQ on using package backups]] for more on this file). At the same time, it tests each action it is preparing to take on your forum, and reports the results in the list. The Package manager will report whether the installation test was a success or a failure. If the test failed, it is recommended that you resolve the problem before proceeding with the installation. Checking out the parser, on the mod's download page, will tell you which edits are made to which files. If you can match up the file edited, there with the edit that is failing, you can often make the failed edit, yourself, manually. If you do that, we have to stress, again, the importance of backing-up, before you do this. You can read more about [[Manual_installation_of_mods|installing mods by hand]] if you plan to make such edits.<br />
<br />
Installation will begin when you select the '''Install Now''' button at the bottom of the page. After a successful installation, the Package Manager may redirect you to the new mod's configuration page, or return you to the Package Manager.<br />
<br />
== Installed Packages ==<br />
This page allows you to view your installed mods, the files included in each mod, and gives you the ability to uninstall any mods that you no longer want at the moment. It is similar to the [[Browse Packages]] section.<br />
<br />
Note that the list of mods shown on this section are taken directly from the ''Packages/installed.list'' file of your forum. When mods are added or removed, the file is updated and thus the list on this page will also be updated.<br />
<br />
You can select the ''Delete Mod List'' button at the bottom of the page to clear the list of mods you have installed, but this is generally not recommended.<br />
<br />
== Options ==<br />
The installation Options section of the package manager, accessed via package manager's options tab, is for information that is sometimes required during installation. Some package installations may require FTP login information or changes to file permissions.<br />
<br />
*Installation Options<br />
*Cleanup Permissions<br />
*FTP Information Required<br />
<br />
===Installation Options===<br />
Settings for FTP Server, Username and Port are used by SMF to make an FTP connection in order to complete certain package installations. The Create Backup versions of replaced files with a tilde (~) on the end of their names checkbox instructs SMF to save a backup version of any file that is changed or replaced during installation.<br />
<br />
===Cleanup Permissions===<br />
Because it is generally more secure to keep as few files writeable as possible, and because some package installations involve more files than others, this section provides a quick way to change file permissions in the SMF directories. In order of increasing permission and decreasing security, the options under this heading are: ''The minimum files are writeable''; ''All files are writeable''; and ''Only the standard files are writeable''. Choose one of these options and then selecting the Change file permissions button below makes the change.<br />
<br />
===FTP Information Required===<br />
After the change file permissions button is selected, SMF will display a new page prompting for additional FTP information.<br />
<br />
*FTP Server - The internet address of the forum ftp server (e.g. ftp.forumname.org) <br />
*Port - FTP port, supplied by the site host if other than 21<br />
*Username - The FTP username used to login to the FTP server.<br />
*Password - The password for the FTP username given above.<br />
*Local path to SMF - FTP Path to the SMF root. This may differ from the SMF path given in the core configuration section of server settings. <br />
<br />
The [[Local Path - What is the local path to SMF|What is the local path to SMF?]] FAQ has more information.<br />
<br />
Following selection of the Proceed button, SMF should make the requested file permission changes at the Local path to SMF and return to the Installation Options section. If this does not happen: 1) The FTP Server does not exist, the page will be refreshed -- no error message will be displayed; 2) The FTP Server exists, but FTP login fails (incorrect username/password), a browser Error 500 message will be displayed; 3) The FTP login is successful, but the local path to SMF does not exist, a small FTP error message will be displayed.<br />
<br />
{{ {{Localized|As an administrator1.1}}}}</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=Package_manager&diff=23023Package manager2013-12-24T11:15:08Z<p>Yoshi2889: moved Package manager to SMF1.1:Package manager: Split</p>
<hr />
<div>#REDIRECT [[SMF1.1:Package manager]]</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=SMF1.1:Package_manager&diff=23022SMF1.1:Package manager2013-12-24T11:15:08Z<p>Yoshi2889: moved Package manager to SMF1.1:Package manager: Split</p>
<hr />
<div>{{TOCright}}The package manager is a default feature of SMF that allows you to install packages for your forum. Packages consist of customizations and updates to your forum. Customizations can be a number of things: a new feature, a theme, avatar set, smiley set, a feature enhancement, or anything you can think of and program for SMF to do. Note, however, that theme installs are not handled by the Package Manager. Before we go any further, it cannot be emphasised enough, here, that you '''really''' should backup your forum, before installing any packages (mods). It is '''very''' important that you back up both your forum '''and''' the database. Detailed information on backing-up can be found here: [[Backup]] <br />
<br />
(Please note that modifications have their own dedicated support topics. If you have any problems with a mod, whether it be with its installation or use, please post in the mod's support topic, rather than in the general support boards, as you are more likely to get a speedy and accurate response there. The topic can be accessed by clicking on the ''Support and comments for this mod'' link, on the mod's download page).<br />
<br />
== Browse Packages ==<br />
In the ''Browse Packages'' section of the package manager, you will see all of the packages that are currently downloaded on to your forum. You can install/uninstall them, view details of a package, and delete packages. Applying the package to your forum is as easy as clicking 'Proceed' next to the package you want to install, most of the time. However, you may be asked to fill in FTP information whenever the files needed are not writeable.<br />
<br />
===Latest Packages / Package of the Moment===<br />
Located at the top of the 'Browse Packages' section is a box that includes the ''Latest Packages'' that have been added to the [http://custom.simplemachines.org/ SMF Customizations Site]. Clicking on the name of any of the packages will expand information about the package taken from the mod's download/description page from the mod site. <br />
<br />
You can select ''Install Now!'' underneath the name of the mod after it is expanded and then the package will be downloaded to your forum and the install screen will appear showing which files could be edited successfully, and which ones (if any) could not be. To go back to the list of the latest packages, you can select ''(go back)'', located at the bottom of the information about the mod.<br />
<br />
These packages are grabbed from a javascript file on the SMF server which is automatically updated with the latest mods that have been added to the mod site.<br />
<br />
At the bottom of the ''Latest Packages'' box is the ''Package of the Moment'', which is chosen by selecting a random mod package from the SMF mod site. The package listed here works in the same way as the latest packages above it, and will expand, allowing you to install it.<br />
<br />
===Browse Packages===<br />
Underneath the ''Latest Packages'' box you will see the list of all the mod packages you have downloaded on to your forum. There are three options listed next to each mod:<br />
<br />
*'''Apply Mod'''/'''Install Mod''' or '''Uninstall'''<br />
*'''List Files'''<br />
*'''Delete'''<br />
<br />
When installing a package, you must select '''Apply Mod/Install Mod''' next to the package you want to install. If you see failure instead of success on the pre-install, this means that there is an issue with the editing a file the package is suppose to edit or the package does not work with your version of SMF. You might want to contact the developer of the package for further information. If there are [[Error in mod installation|test failures]], it generally not advised to proceed with the installation unless you are prepared to [[Manual installation of mods|manually install the mod]].<br />
<br />
When '''uninstalling''' a package, you must click '''''Uninstall''''' next to the package you want to uninstall. If you get any failure notices for any files, that means the mod cannot be uninstalled completely. If there are [[Error in mod installation|test failures]], it is generally advised to proceed only when you are prepared to [[Manual installation of mods|manually uninstall the mod]].<br />
<br />
{{Version Specific|small=yes<br />
|version=2<br />
|content= ===Advanced===<br />
At the bottom of the ''Browse packages'' section is a link located on the right side of the page. Clicking this will add an additional box to the page which allows you to emulate your version of SMF to another version temporarily. Just type exactly the version you want to emulate in the input box next to ''Emulate Version''. This is useful if a mod is set to only install for specific versions of SMF, however the mod may still work on your version. To revert the text entered in the input to your version of SMF, click the ''Revert'' link.<br />
<br />
For more information on using this feature, please see [[How can I install a mod that doesn't work in my SMF version]]<br />
}}<br />
<br />
== Download Packages ==<br />
The download packages section of the package manager provides tools for loading and installing a package and for using the package server browser. To download a package is to obtain it from some place it is stored. In some cases, the package may be downloaded directly to your forum. In other cases, it must be first downloaded to your desktop, then uploaded from your desktop to your forum. Download packages is accessed by selecting the download packages tab from the package manager. Required FTP settings are found in the installation options section.<br />
<br />
===Package servers===<br />
An SMF package server is a repository stocked with modification packages for SMF forums.<br />
<br />
The package server's ''browse'' feature can be used in either of the following ways:<br />
*To obtain packages from a local SMF package server, if one is located on the forum host<br />
*To obtain packages from a remote SMF package server (such as the Simple Machines third party mod site), if the forum host permits downloading SMF packages directly from a remote SMF package server<br />
<br />
Selecting the ''browse'' button next to a server in the package servers list allows viewing of the packages available on that package server. If this feature does not work, uploading a package may be used instead, in order to upload a package that has already been manually downloaded to the desktop. The ''delete'' button is used to remove a package server listing.<br />
<br />
===Add server===<br />
To add a package server to the list, the administrator may type in a server name (e.g. Simple Machines Third-party Mod Site) and a URL (e.g. http://custom.simplemachines.org/mods/), then select the add server button.<br />
<br />
{{Version Specific|small=yes<br />
|version=2<br />
|content= ===Download a package by URL===<br />
Download a package by URL is a quick way to download a package from the web to a forum.<br />
<br />
*URL - The exact URL of the desired modification package.<br />
*Name of the file - Required if the download URL does not include the file name of the package. If left blank, the base name of the file from the URL will be used. For example, the default name of the file for a package mod_name.zip would be mod_name.<br />
<br />
''For example the URL format will be: http://custom.simplemachines.org/mods/index.php?action=download;mod=1519;id=179488''<br />
}}<br />
<br />
===Upload a Package===<br />
Upload a Package is used to upload a package from the desktop to the forum. The browse button is used to locate the package file, and the upload button is used to upload it to the forum. After an upload, the administrator is given the option to immediately apply the package, or to use browse packages to install it at a later time.<br />
<br />
If you prefer, you may upload the package, or a directory full of package files, to your "Packages" directory, using FTP. {{For more information|about=Uploading packages using FTP|Packages - How to upload packages using FTP}}.<br />
<br />
==Installing a Package==<br />
Once you have uploaded a package, you can install it -- either immediately, or later, from the Browse Packages list.<br />
<br />
Under the heading '''Apply Mod/Install Mod''', you'll see the warning ''Please remember to always make regular backups of your sources and database before installing mods, especially beta versions.'' Heeding this advice can save you from trouble later.<br />
<br />
Below this, the '''Installation Readme''' will display any ''readme'' text supplied by the mod's author.<br />
<br />
Under the heading of '''Installations actions''', you will see a list of all the actions the package manager will take to install this mod. You will see actions of the following types.<br />
{{ {{Localized|Version specific}}|small=yes|version=2|content=<br />
*Execute Modification: Changes made to existing files. Select the [[File:selected.gif|alt=selected]] icon to reveal a list of exactly what is being done to this file, complete with an [[File:Package_ops.gif|alt=Package ops]] icon to show the search and/or replace strings used in this operation.}}<br />
*Extract file: A file will be copied from the package, to the given path and file name.<br />
*Extract Tree: An entire directory full of files will be copied from the package to the given path<br />
*Adapt Database: The named script from the package will be executed. Generally, this script will get the database ready for the mod to run.<br />
{{ {{Localized|Version specific}}|small=yes|version=2|content=<br />
Modification packages often make changes to the default theme. These will be listed under '''Installation actions'''. Often, it is possible for the package to make changes to all of your themes. These changes are optional, and won't be done unless you check the box next to the modification's name.}}<br />
<br />
As the Package Manager prepares this list, it has made a backup of php files for the forum (please see the [[A mod broke my forum what should I do|FAQ on using package backups]] for more on this file). At the same time, it tests each action it is preparing to take on your forum, and reports the results in the list. The Package manager will report whether the installation test was a success or a failure. If the test failed, it is recommended that you resolve the problem before proceeding with the installation. Checking out the parser, on the mod's download page, will tell you which edits are made to which files. If you can match up the file edited, there with the edit that is failing, you can often make the failed edit, yourself, manually. If you do that, we have to stress, again, the importance of backing-up, before you do this. You can read more about [[Manual_installation_of_mods|installing mods by hand]] if you plan to make such edits.<br />
<br />
Installation will begin when you select the '''Install Now''' button at the bottom of the page. After a successful installation, the Package Manager may redirect you to the new mod's configuration page, or return you to the Package Manager.<br />
<br />
== Installed Packages ==<br />
This page allows you to view your installed mods, the files included in each mod, and gives you the ability to uninstall any mods that you no longer want at the moment. It is similar to the [[Browse Packages]] section.<br />
<br />
{{ {{Localized|Version specific}}|small=yes|version=1|content=<br />
Note that the list of mods shown on this section are taken directly from the ''Packages/installed.list'' file of your forum. When mods are added or removed, the file is updated and thus the list on this page will also be updated.}}<br />
<br />
You can select the ''Delete Mod List'' button at the bottom of the page to clear the list of mods you have installed, but this is generally not recommended.<br />
<br />
{{ {{Localized|Version specific}}|small=yes|version=2|content=<br />
== File Permissions ==<br />
You can use this section to review the writeable status of critical files and directories within your forum directory. Note this only considers key forum directories and files - use an FTP client for additional options.<br />
<br />
Please Note:<br />
#Be careful when changing file permissions from this section - incorrect permissions can adversely affect the operation of your forum!<br />
#On some server configurations selecting the wrong permissions may stop SMF from operating.<br />
#Certain directories such as attachments need to be writeable to use that functionality.<br />
#This functionality is mainly applicable on non-Windows based servers - it will not work as expected on Windows with respect to permission flags.<br />
#Before proceeding make sure you have an FTP client installed in case you do make an error and you need to FTP into the server to remedy it.<br />
#If you make changes to your file permissions and they do not seem to be having the effect that you expected, you will need to contact your host, asking them if you have '''full ownership''' of all of the files on your site. Do not worry, if you do not know what that means, exactly, because your host certainly will.<br />
<br />
===Change File Permissions===<br />
'''Apply individual file permissions settings selected above''': <br />
:''If "Custom" has been selected use chmod value of: You can manually set the permissions you wish to set the selected files to. To do this enter the chmod value as a numeric (octet) value. Note - these flags will have no effect on Microsoft Windows operating systems.''<br />
<br />
'''Use predefined permission profile''': this only applies the predefined profile to key SMF directories and files.}}<br />
<br />
== Options ==<br />
The installation Options section of the package manager, accessed via package manager's options tab, is for information that is sometimes required during installation. Some package installations may require FTP login information or changes to file permissions.<br />
<br />
*Installation Options<br />
*Cleanup Permissions<br />
*FTP Information Required<br />
<br />
===Installation Options===<br />
Settings for FTP Server, Username and Port are used by SMF to make an FTP connection in order to complete certain package installations. The Create Backup versions of replaced files with a tilde (~) on the end of their names checkbox instructs SMF to save a backup version of any file that is changed or replaced during installation.<br />
<br />
{{ {{Localized|Version specific}}|small=yes|version=1|content=<br />
===Cleanup Permissions===<br />
Because it is generally more secure to keep as few files writeable as possible, and because some package installations involve more files than others, this section provides a quick way to change file permissions in the SMF directories. In order of increasing permission and decreasing security, the options under this heading are: ''The minimum files are writeable''; ''All files are writeable''; and ''Only the standard files are writeable''. Choose one of these options and then selecting the Change file permissions button below makes the change.<br />
<br />
===FTP Information Required===<br />
After the change file permissions button is selected, SMF will display a new page prompting for additional FTP information.<br />
<br />
*FTP Server - The internet address of the forum ftp server (e.g. ftp.forumname.org) <br />
*Port - FTP port, supplied by the site host if other than 21<br />
*Username - The FTP username used to login to the FTP server.<br />
*Password - The password for the FTP username given above.<br />
*Local path to SMF - FTP Path to the SMF root. This may differ from the SMF path given in the core configuration section of server settings. <br />
<br />
The [[Local Path - What is the local path to SMF|What is the local path to SMF?]] FAQ has more information.<br />
<br />
Following selection of the Proceed button, SMF should make the requested file permission changes at the Local path to SMF and return to the Installation Options section. If this does not happen: 1) The FTP Server does not exist, the page will be refreshed -- no error message will be displayed; 2) The FTP Server exists, but FTP login fails (incorrect username/password), a browser Error 500 message will be displayed; 3) The FTP login is successful, but the local path to SMF does not exist, a small FTP error message will be displayed.}}<br />
<br />
{{ {{Localized|As an administrator}}}}</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=SMF2.0:News_and_newsletters&diff=23020SMF2.0:News and newsletters2013-12-24T11:13:40Z<p>Yoshi2889: moved SMF2.0:News and Newsletters to SMF2.0:News and newsletters: Fix capital</p>
<hr />
<div>==News==<br />
<br />
If there is a bit of recent news, the forum administrators may decide to tell other users about it. BBcode and the HTML BBcode tag may be used in these messages. The messages will be displayed in the header. <br />
<br />
==Newsletters==<br />
If an administrator needs to contact some, or all, members of the forum this feature can be used to send a simple e-mail or newsletters.<br />
<br />
===Membergroups===<br />
====Group Selection====<br />
The first thing the administrator will do when visiting the newsletter page is to select which membergroups they would like to e-mail. They may just select the boxes for each membergroup they want to e-mail. If an administrator wishes to send a newsletter to users by post count group, they need to enable permissions for post count groups in ''admin > permissions > settings > enable permissions for post count based groups".<br />
<br />
===Advanced===<br />
Upon selecting the ''Advanced'' link underneath the membergroup listing, there will be a number of different options which include all of the following:<br />
*''E-mail Addresses'' - In this box, the administrators can add any additional e-mail addresses they would like the newsletter to be sent to.<br />
*''Members'' - The administrators can add the usernames of any additional members that they would like to receive the newsletter.<br />
*''Excluded Groups'' - Here, the administrator can select groups that absolutely cannot receive the newsletter under any condition, even if they have the same group selected under the included membergroups at the top of the page, or a member belongs to one of the included groups. As long as the member belongs to any groups checked here, they will not receive the newsletter. This includes primary and secondary membergroups.<br />
*''Excluded Members'' - This works similarly to the above option, except the administrators can add the usernames of members that they do not want to receive the newsletter no matter which membergroup(s) they belong to.<br />
*''Override Notification Settings'' - The administrators can select this to send the e-mail to the members who have selected the option to not receive announcements by e-mail in their profile. It is not recommended to force members to receive announcements, unless it is really important.<br />
<br />
===Composing e-mail===<br />
*''Subject'' - The default subject will be the Site name: Subject.<br />
*''Message'' - Members can put almost anything they want into the message box, including HTML if they wish. Most e-mail clients support HTML, but not all of them do. If a member wishes to use HTML in the message, they must select this option: Send in HTML format. (This allows them to put normal HTML in the e-mail.)<br />
*''Variables'' - In the message, members can also use some variables. Below are the variables that can be used:<br />
**<code>{$board_url}</code> - The URL to your forum.<br />
**<code>{$current_time}</code> - The current time.<br />
**<code>{$member.email}</code> - The current member's email.<br />
**<code>{$member.link}</code> - The current member's link.<br />
**<code>{$member.id}</code> - The current member's ID.<br />
**<code>{$member.name}</code> - The current member's name.<br />
**<code>{$latest_member.link}</code> - The most recently registered member's link.<br />
**<code>{$latest_member.id}</code> - The most recently registered member's id.<br />
**<code>{$latest_member.name}</code> - The most recently registered member's name.<br />
<br />
==Settings==<br />
The ''Settings'' page of the ''News and newsletters section'' of the Administration Center allows an administrator to configure a few settings pertaining to forum news items.<br />
<br />
*''Groups allowed to edit news items'': Select the groups that you wish to allow the ability to add and edit news items.<br />
*''Groups allowed to send out forum newsletters'': Select the groups that you wish to allow the ability to send newsletters.<br />
*''Enable XML/RSS news'': Allows people to link to the RSS feeds of recent posts made on your forum and other similar data. For details see the [[XML feeds]] page.<br />
*''Maximum post length'': Here you can specify the maximum amount of characters to show for each RSS feed item. It is also recommended that you limit the size of recent posts and news because in some clients the amount of RSS data that is displayed is expected to be truncated.<br />
*''Maximum message length'': See maximum post length.<br />
<br />
{{ {{Localized|As an administrator2.0}}}}</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=News_and_newsletters&diff=23019News and newsletters2013-12-24T11:12:53Z<p>Yoshi2889: </p>
<hr />
<div>{{versions|versions=yes}}<br />
<br />
{{ {{Localized|As an administrator}}}}</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=SMF2.0:News_and_newsletters&diff=23018SMF2.0:News and newsletters2013-12-24T11:12:17Z<p>Yoshi2889: Create 2.0 page</p>
<hr />
<div>==News==<br />
<br />
If there is a bit of recent news, the forum administrators may decide to tell other users about it. BBcode and the HTML BBcode tag may be used in these messages. The messages will be displayed in the header. <br />
<br />
==Newsletters==<br />
If an administrator needs to contact some, or all, members of the forum this feature can be used to send a simple e-mail or newsletters.<br />
<br />
===Membergroups===<br />
====Group Selection====<br />
The first thing the administrator will do when visiting the newsletter page is to select which membergroups they would like to e-mail. They may just select the boxes for each membergroup they want to e-mail. If an administrator wishes to send a newsletter to users by post count group, they need to enable permissions for post count groups in ''admin > permissions > settings > enable permissions for post count based groups".<br />
<br />
===Advanced===<br />
Upon selecting the ''Advanced'' link underneath the membergroup listing, there will be a number of different options which include all of the following:<br />
*''E-mail Addresses'' - In this box, the administrators can add any additional e-mail addresses they would like the newsletter to be sent to.<br />
*''Members'' - The administrators can add the usernames of any additional members that they would like to receive the newsletter.<br />
*''Excluded Groups'' - Here, the administrator can select groups that absolutely cannot receive the newsletter under any condition, even if they have the same group selected under the included membergroups at the top of the page, or a member belongs to one of the included groups. As long as the member belongs to any groups checked here, they will not receive the newsletter. This includes primary and secondary membergroups.<br />
*''Excluded Members'' - This works similarly to the above option, except the administrators can add the usernames of members that they do not want to receive the newsletter no matter which membergroup(s) they belong to.<br />
*''Override Notification Settings'' - The administrators can select this to send the e-mail to the members who have selected the option to not receive announcements by e-mail in their profile. It is not recommended to force members to receive announcements, unless it is really important.<br />
<br />
===Composing e-mail===<br />
*''Subject'' - The default subject will be the Site name: Subject.<br />
*''Message'' - Members can put almost anything they want into the message box, including HTML if they wish. Most e-mail clients support HTML, but not all of them do. If a member wishes to use HTML in the message, they must select this option: Send in HTML format. (This allows them to put normal HTML in the e-mail.)<br />
*''Variables'' - In the message, members can also use some variables. Below are the variables that can be used:<br />
**<code>{$board_url}</code> - The URL to your forum.<br />
**<code>{$current_time}</code> - The current time.<br />
**<code>{$member.email}</code> - The current member's email.<br />
**<code>{$member.link}</code> - The current member's link.<br />
**<code>{$member.id}</code> - The current member's ID.<br />
**<code>{$member.name}</code> - The current member's name.<br />
**<code>{$latest_member.link}</code> - The most recently registered member's link.<br />
**<code>{$latest_member.id}</code> - The most recently registered member's id.<br />
**<code>{$latest_member.name}</code> - The most recently registered member's name.<br />
<br />
==Settings==<br />
The ''Settings'' page of the ''News and newsletters section'' of the Administration Center allows an administrator to configure a few settings pertaining to forum news items.<br />
<br />
*''Groups allowed to edit news items'': Select the groups that you wish to allow the ability to add and edit news items.<br />
*''Groups allowed to send out forum newsletters'': Select the groups that you wish to allow the ability to send newsletters.<br />
*''Enable XML/RSS news'': Allows people to link to the RSS feeds of recent posts made on your forum and other similar data. For details see the [[XML feeds]] page.<br />
*''Maximum post length'': Here you can specify the maximum amount of characters to show for each RSS feed item. It is also recommended that you limit the size of recent posts and news because in some clients the amount of RSS data that is displayed is expected to be truncated.<br />
*''Maximum message length'': See maximum post length.<br />
<br />
{{ {{Localized|As an administrator2.0}}}}</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=SMF1.1:News_and_newsletters&diff=23017SMF1.1:News and newsletters2013-12-24T11:10:34Z<p>Yoshi2889: Fix extra =</p>
<hr />
<div>==News==<br />
<br />
If there is a bit of recent news, the forum administrators may decide to tell other users about it. BBcode and the HTML BBcode tag may be used in these messages. The messages will be displayed in the header. <br />
<br />
==Newsletters==<br />
If an administrator needs to contact some, or all, members of the forum this feature can be used to send a simple e-mail or newsletters.<br />
<br />
===Membergroups===<br />
====Group Selection====<br />
The first thing the administrator will do when visiting the newsletter page is to select which membergroups they would like to e-mail. They may just select the boxes for each membergroup they want to e-mail. If an administrator wishes to send a newsletter to users by post count group, they need to enable permissions for post count groups in ''admin > permissions > settings > enable permissions for post count based groups".<br />
<br />
====E-mail Options====<br />
When they want to use the newsletter feature on the forum, forum administrators may configure a few options to meet their needs for sending out e-mails to the members:<br />
*''Send the messages using personal messages'' - With this option checked, members will receive the newsletter as a personal message rather than by e-mail.<br />
*''Send this to members even if they have chosen not to receive announcements'' - Administrators can choose this option to send the e-mail to members who have selected the option to not receive announcements by e-mail in their profile. It is not recommended to force the users to receive the announcement unless the piece of news is really important.<br />
<br />
===Composing e-mail===<br />
*''Subject'' - The default subject will be the Site name: Subject.<br />
*''Message'' - Members can put almost anything they want into the message box, including HTML if they wish. Most e-mail clients support HTML, but not all of them do. If a member wishes to use HTML in the message, they must select this option: Send in HTML format. (This allows them to put normal HTML in the e-mail.)<br />
*''Variables'' - In the message, members can also use some variables. Below are the variables that can be used:<br />
**<code>{$board_url}</code> - The URL to your forum.<br />
**<code>{$current_time}</code> - The current time.<br />
**<code>{$member.email}</code> - The current member's email.<br />
**<code>{$member.link}</code> - The current member's link.<br />
**<code>{$member.id}</code> - The current member's ID.<br />
**<code>{$member.name}</code> - The current member's name.<br />
**<code>{$latest_member.link}</code> - The most recently registered member's link.<br />
**<code>{$latest_member.id}</code> - The most recently registered member's id.<br />
**<code>{$latest_member.name}</code> - The most recently registered member's name.<br />
<br />
==Settings==<br />
The ''Settings'' page of the ''News and newsletters section'' of the Administration Center allows an administrator to configure a few settings pertaining to forum news items.<br />
<br />
*''Groups allowed to edit news items'': Select the groups that you wish to allow the ability to add and edit news items.<br />
*''Groups allowed to send out forum newsletters'': Select the groups that you wish to allow the ability to send newsletters.<br />
*''Enable XML/RSS news'': Allows people to link to the RSS feeds of recent posts made on your forum and other similar data. For details see the [[XML feeds]] page.<br />
*''Maximum post length'': Here you can specify the maximum amount of characters to show for each RSS feed item. It is also recommended that you limit the size of recent posts and news because in some clients the amount of RSS data that is displayed is expected to be truncated.<br />
<br />
{{ {{Localized|As an administrator1.1}}}}</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=SMF1.1:News_and_newsletters&diff=23016SMF1.1:News and newsletters2013-12-24T11:10:14Z<p>Yoshi2889: Prepare 1.1 page</p>
<hr />
<div>==News==<br />
<br />
If there is a bit of recent news, the forum administrators may decide to tell other users about it. BBcode and the HTML BBcode tag may be used in these messages. The messages will be displayed in the header. <br />
<br />
==Newsletters==<br />
If an administrator needs to contact some, or all, members of the forum this feature can be used to send a simple e-mail or newsletters.<br />
<br />
===Membergroups===<br />
====Group Selection====<br />
The first thing the administrator will do when visiting the newsletter page is to select which membergroups they would like to e-mail. They may just select the boxes for each membergroup they want to e-mail. If an administrator wishes to send a newsletter to users by post count group, they need to enable permissions for post count groups in ''admin > permissions > settings > enable permissions for post count based groups".<br />
<br />
=====E-mail Options====<br />
When they want to use the newsletter feature on the forum, forum administrators may configure a few options to meet their needs for sending out e-mails to the members:<br />
*''Send the messages using personal messages'' - With this option checked, members will receive the newsletter as a personal message rather than by e-mail.<br />
*''Send this to members even if they have chosen not to receive announcements'' - Administrators can choose this option to send the e-mail to members who have selected the option to not receive announcements by e-mail in their profile. It is not recommended to force the users to receive the announcement unless the piece of news is really important.<br />
<br />
===Composing e-mail===<br />
*''Subject'' - The default subject will be the Site name: Subject.<br />
*''Message'' - Members can put almost anything they want into the message box, including HTML if they wish. Most e-mail clients support HTML, but not all of them do. If a member wishes to use HTML in the message, they must select this option: Send in HTML format. (This allows them to put normal HTML in the e-mail.)<br />
*''Variables'' - In the message, members can also use some variables. Below are the variables that can be used:<br />
**<code>{$board_url}</code> - The URL to your forum.<br />
**<code>{$current_time}</code> - The current time.<br />
**<code>{$member.email}</code> - The current member's email.<br />
**<code>{$member.link}</code> - The current member's link.<br />
**<code>{$member.id}</code> - The current member's ID.<br />
**<code>{$member.name}</code> - The current member's name.<br />
**<code>{$latest_member.link}</code> - The most recently registered member's link.<br />
**<code>{$latest_member.id}</code> - The most recently registered member's id.<br />
**<code>{$latest_member.name}</code> - The most recently registered member's name.<br />
<br />
==Settings==<br />
The ''Settings'' page of the ''News and newsletters section'' of the Administration Center allows an administrator to configure a few settings pertaining to forum news items.<br />
<br />
*''Groups allowed to edit news items'': Select the groups that you wish to allow the ability to add and edit news items.<br />
*''Groups allowed to send out forum newsletters'': Select the groups that you wish to allow the ability to send newsletters.<br />
*''Enable XML/RSS news'': Allows people to link to the RSS feeds of recent posts made on your forum and other similar data. For details see the [[XML feeds]] page.<br />
*''Maximum post length'': Here you can specify the maximum amount of characters to show for each RSS feed item. It is also recommended that you limit the size of recent posts and news because in some clients the amount of RSS data that is displayed is expected to be truncated.<br />
<br />
{{ {{Localized|As an administrator1.1}}}}</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=News_and_newsletters&diff=23015News and newsletters2013-12-24T11:09:06Z<p>Yoshi2889: moved News and newsletters to SMF1.1:News and newsletters: Split</p>
<hr />
<div>#REDIRECT [[SMF1.1:News and newsletters]]</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=SMF1.1:News_and_newsletters&diff=23014SMF1.1:News and newsletters2013-12-24T11:09:06Z<p>Yoshi2889: moved News and newsletters to SMF1.1:News and newsletters: Split</p>
<hr />
<div>==News==<br />
<br />
If there is a bit of recent news, the forum administrators may decide to tell other users about it. BBcode and the HTML BBcode tag may be used in these messages. The messages will be displayed in the header. <br />
<br />
==Newsletters==<br />
If an administrator needs to contact some, or all, members of the forum this feature can be used to send a simple e-mail or newsletters.<br />
<br />
===Membergroups===<br />
====Group Selection====<br />
The first thing the administrator will do when visiting the newsletter page is to select which membergroups they would like to e-mail. They may just select the boxes for each membergroup they want to e-mail. If an administrator wishes to send a newsletter to users by post count group, they need to enable permissions for post count groups in ''admin > permissions > settings > enable permissions for post count based groups".<br />
<br />
<br />
{{Version Specific <br />
|version=1.1<br />
|content=====E-mail Options====<br />
When they want to use the newsletter feature on the forum, forum administrators may configure a few options to meet their needs for sending out e-mails to the members:<br />
*''Send the messages using personal messages'' - With this option checked, members will receive the newsletter as a personal message rather than by e-mail.<br />
*''Send this to members even if they have chosen not to receive announcements'' - Administrators can choose this option to send the e-mail to members who have selected the option to not receive announcements by e-mail in their profile. It is not recommended to force the users to receive the announcement unless the piece of news is really important.}}<br />
<br />
<br />
{{Version Specific <br />
|version=2<br />
|content====Advanced===<br />
Upon selecting the ''Advanced'' link underneath the membergroup listing, there will be a number of different options which include all of the following:<br />
*''E-mail Addresses'' - In this box, the administrators can add any additional e-mail addresses they would like the newsletter to be sent to.<br />
*''Members'' - The administrators can add the usernames of any additional members that they would like to receive the newsletter.<br />
*''Excluded Groups'' - Here, the administrator can select groups that absolutely cannot receive the newsletter under any condition, even if they have the same group selected under the included membergroups at the top of the page, or a member belongs to one of the included groups. As long as the member belongs to any groups checked here, they will not receive the newsletter. This includes primary and secondary membergroups.<br />
*''Excluded Members'' - This works similarly to the above option, except the administrators can add the usernames of members that they do not want to receive the newsletter no matter which membergroup(s) they belong to.<br />
*''Override Notification Settings'' - The administrators can select this to send the e-mail to the members who have selected the option to not receive announcements by e-mail in their profile. It is not recommended to force members to receive announcements, unless it is really important.}}<br />
<br />
===Composing e-mail===<br />
*''Subject'' - The default subject will be the Site name: Subject.<br />
*''Message'' - Members can put almost anything they want into the message box, including HTML if they wish. Most e-mail clients support HTML, but not all of them do. If a member wishes to use HTML in the message, they must select this option: Send in HTML format. (This allows them to put normal HTML in the e-mail.)<br />
*''Variables'' - In the message, members can also use some variables. Below are the variables that can be used:<br />
**<code>{$board_url}</code> - The URL to your forum.<br />
**<code>{$current_time}</code> - The current time.<br />
**<code>{$member.email}</code> - The current member's email.<br />
**<code>{$member.link}</code> - The current member's link.<br />
**<code>{$member.id}</code> - The current member's ID.<br />
**<code>{$member.name}</code> - The current member's name.<br />
**<code>{$latest_member.link}</code> - The most recently registered member's link.<br />
**<code>{$latest_member.id}</code> - The most recently registered member's id.<br />
**<code>{$latest_member.name}</code> - The most recently registered member's name.<br />
<br />
==Settings==<br />
The ''Settings'' page of the ''News and newsletters section'' of the Administration Center allows an administrator to configure a few settings pertaining to forum news items.<br />
<br />
*''Groups allowed to edit news items'': Select the groups that you wish to allow the ability to add and edit news items.<br />
*''Groups allowed to send out forum newsletters'': Select the groups that you wish to allow the ability to send newsletters.<br />
*''Enable XML/RSS news'': Allows people to link to the RSS feeds of recent posts made on your forum and other similar data. For details see the [[XML feeds]] page.<br />
*''Maximum post length'': Here you can specify the maximum amount of characters to show for each RSS feed item. It is also recommended that you limit the size of recent posts and news because in some clients the amount of RSS data that is displayed is expected to be truncated.<br />
{{Version Specific|small=yes|version=2|content=<br />
*''Maximum message length'': See maximum post length.}}<br />
<br />
{{ {{Localized|As an administrator}}}}</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=Support_and_Credits&diff=23013Support and Credits2013-12-24T11:07:18Z<p>Yoshi2889: </p>
<hr />
<div>{{versions|versions=yes}}<br />
<br />
{{ {{Localized|As an administrator}}}}</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=SMF2.0:Support_and_Credits&diff=23012SMF2.0:Support and Credits2013-12-24T11:03:55Z<p>Yoshi2889: Create 2.0 page</p>
<hr />
<div>Support and Credits is accessed through the Administration Center of the forum under the ''Main'' category. The page is split into different sections to display information about different features and functions on the forum. <br />
<br />
''Support Information'' is the first section displayed. It analyses the server/environment to see if it is running the current installation of SMF for the versions and values of installed components, such as SMF, PHP, database, graphics library, and webserver versions. The information displayed will allow easy copying of data into support threads at the Simple Machines Community Forum.<br />
<br />
''Support Resources'' includes links to the Simple Machines Community Forum wiki and a range of support boards to assist you with finding any information you may need to help you with any aspect of your forum.<br />
<br />
''Common Support Issues'' is a live feed from the Simple Machines site, with regularly updated information about common issues and their fixes. This section contains links and information about running an SMF forum when there are no common issues to be displayed. If the live file cannot be reached for any reason, it will display a message alerting you that it cannot reach the Simple Machines site.<br />
<br />
The ''Credits'' section serves as a thank you notice to all the volunteers who have dedicated their time and effort into improving SMF and its outlying community. Each member and their role is stated on this list.<br />
{{ {{Localized|As an administrator2.0}}}}</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=SMF1.1:Support_and_Credits&diff=23011SMF1.1:Support and Credits2013-12-24T11:03:08Z<p>Yoshi2889: Prepare for split to 2.0</p>
<hr />
<div>Support and Credits is accessed through the Administration Center of the forum under the ''Main'' category. The page is split into different sections to display information about different features and functions on the forum. <br />
<br />
''Support Information'' is the first section displayed. It analyses the server/environment to see if it is running the current installation of SMF for the versions and values of installed components, such as SMF, PHP, database, graphics library, and webserver versions. The information displayed will allow easy copying of data into support threads at the Simple Machines Community Forum.<br />
<br />
''Common Support Issues'' is a live feed from the Simple Machines site, with regularly updated information about common issues and their fixes. This section contains links and information about running an SMF forum when there are no common issues to be displayed. If the live file cannot be reached for any reason, it will display a message alerting you that it cannot reach the Simple Machines site.<br />
<br />
The ''Credits'' section serves as a thank you notice to all the volunteers who have dedicated their time and effort into improving SMF and its outlying community. Each member and their role is stated on this list.<br />
{{ {{Localized|As an administrator1.1}}}}</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=Support_and_Credits&diff=23010Support and Credits2013-12-24T11:01:44Z<p>Yoshi2889: moved Support and Credits to SMF1.1:Support and Credits: Split</p>
<hr />
<div>#REDIRECT [[SMF1.1:Support and Credits]]</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=SMF1.1:Support_and_Credits&diff=23009SMF1.1:Support and Credits2013-12-24T11:01:44Z<p>Yoshi2889: moved Support and Credits to SMF1.1:Support and Credits: Split</p>
<hr />
<div>Support and Credits is accessed through the Administration Center of the forum under the ''Main'' category. The page is split into different sections to display information about different features and functions on the forum. <br />
<br />
''Support Information'' is the first section displayed. It analyses the server/environment to see if it is running the current installation of SMF for the versions and values of installed components, such as SMF, PHP, database, graphics library, and webserver versions. The information displayed will allow easy copying of data into support threads at the Simple Machines Community Forum.<br />
<br />
{{ {{Localized|Version specific}}|small=yes|version=2|content=<br />
''Support Resources'' includes links to the Simple Machines Community Forum wiki and a range of support boards to assist you with finding any information you may need to help you with any aspect of your forum.}} <br />
<br />
''Common Support Issues'' is a live feed from the Simple Machines site, with regularly updated information about common issues and their fixes. This section contains links and information about running an SMF forum when there are no common issues to be displayed. If the live file cannot be reached for any reason, it will display a message alerting you that it cannot reach the Simple Machines site.<br />
<br />
The ''Credits'' section serves as a thank you notice to all the volunteers who have dedicated their time and effort into improving SMF and its outlying community. Each member and their role is stated on this list.<br />
{{ {{Localized|As an administrator}}}}</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=SMF1.1:Administration_Center&diff=23008SMF1.1:Administration Center2013-12-24T10:55:37Z<p>Yoshi2889: Undo :D Sorry</p>
<hr />
<div>{{versions|versions=yes}}<br />
<br />
{{:Administration Center (term)}}<br />
<br />
The Administration Center is the home page of your admin panel. From here, you can change any settings on your forum, ranging from membergroups to board customisation.<br />
<br />
The first two sections on this page are the "Live information from Simple Machines" and "Support Information" panels. <br />
<br />
The "Live from Simple Machines" panel is used to allow administrators of the forum to keep up-to-date with important information regarding updates, bug fixes, and security issues. The news here is loaded daily onto this page. <br />
<br />
"Support Information" is used to collect data, files, and the version from the forum. This information can be useful in diagnosing issues in a support thread at the Simple Machines Community Forum. Selecting the more detailed listing will present a list of files and their exact version.<br />
<br />
Below the live information panels in the Administration Center, forum management is broken down into separate sections, allowing easier administration of the forum. There is a more detailed menu located either above, or to the side of, the live panels (depending on the forum's configuration).<br />
<br />
{{ {{Localized|As an administrator1.1}}}}</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=SMF1.1:Administration_Center&diff=23007SMF1.1:Administration Center2013-12-24T10:54:30Z<p>Yoshi2889: Add page to 1.1 and 2.0 categories</p>
<hr />
<div>{{versions|versions=yes}}<br />
<br />
{{:Administration Center (term)}}<br />
<br />
The Administration Center is the home page of your admin panel. From here, you can change any settings on your forum, ranging from membergroups to board customisation.<br />
<br />
The first two sections on this page are the "Live information from Simple Machines" and "Support Information" panels. <br />
<br />
The "Live from Simple Machines" panel is used to allow administrators of the forum to keep up-to-date with important information regarding updates, bug fixes, and security issues. The news here is loaded daily onto this page. <br />
<br />
"Support Information" is used to collect data, files, and the version from the forum. This information can be useful in diagnosing issues in a support thread at the Simple Machines Community Forum. Selecting the more detailed listing will present a list of files and their exact version.<br />
<br />
Below the live information panels in the Administration Center, forum management is broken down into separate sections, allowing easier administration of the forum. There is a more detailed menu located either above, or to the side of, the live panels (depending on the forum's configuration).<br />
<br />
{{ {{Localized|As an administrator}}}}<br />
{{ {{Localized|As an administrator1.1}}}}<br />
{{ {{Localized|As an administrator2.0}}}}</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=Forum_header&diff=19328Forum header2013-10-27T17:36:28Z<p>Yoshi2889: Move noinclude</p>
<hr />
<div>{{TOCright}}<br />
{{DISPLAYTITLE:Forum Header}}<br />
The forum header is the section at the top, which appears on every page when browsing the forum. Generally, the forum header refers to the part from the forum title down to the [[Main menu|Main Menu]].<br />
<br />
The forum header can be collapsed (hidden) or expanded (shown) using the icon <span style="background-color: rgb(215, 218, 236);">[[File:Upshrink2.png|x20px]]</span> in the top right hand corner. <br />
<br />
<!-- Moved noinclude to here so the following is not shown on the Terminology page. --><br />
<noinclude>== Forum Header Features ==<br />
<br />
=== As a Guest ===<br />
<br />
[[image:Guest_Header.png|thumb|300px|alt=A picture of what the forum header looks like for guests (SMF 2.0)|Viewing the forum header as a guest (SMF 2.0)]]<br />
<br />
* Quick login (if enabled): Members can quickly login from within the header.<br />
* Quick search: Users can search from anywhere within the forum using the search bar available in the header.<br />
* [[News]] (if enabled): SMF will display news in the header. If multiple news items are entered, SMF will randomly choose one from the available items and display it to the user.<br />
<br />
=== As a Member ===<br />
<br />
[[image:Member_Header.png|thumb|300px|alt=A picture of what the forum header looks like for signed in members (SMF 2.0)|Viewing the forum header as a regular member (SMF 2.0)]]<br />
<br />
Members will benefit from all the features that a guest can access, along with the following features:<br />
*Quick links to [[How to view unread posts and replies|Unread replies and Unread posts]]<br />
*The header will show information about the currently logged in member, and if available also the member's avatar<br />
*Some [[themes]] will also show the number of unread [[personal messages]] in the header.<br />
<br />
=== As an Administrator/Moderator ===<br />
<br />
[[image:Admin_Header.png|thumb|300px|alt=A picture of what the forum header looks like for administrators when maintenance mode is enabled (SMF 2.0)|Viewing the forum header as an administrator with maintenance mode enabled (SMF 2.0)]]<br />
<br />
Administrators and moderators will find every feature members can also find in the header, plus a few additional features:<br />
* If maintenance mode is enabled, a message will be displayed along with the links for unread posts and replies.<br />
* If there are any [[Members#Awaiting_Approval|members awaiting approval]], the header will show the number of members along with a quick link to the moderation center.<br />
<br />
[[Category:SMF terminology]]<br />
</noinclude></div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=SMF2.0:Languages&diff=19326SMF2.0:Languages2013-10-27T17:03:51Z<p>Yoshi2889: Don't make the entire page yellow... Hurts my eyes</p>
<hr />
<div>{{ {{Localized|Version specific}}|version=2.0}}<br />
{{TOCright}}<br />
<br />
== Edit Languages ==<br />
<br />
A table lists all the installed languages along with additional information. The table consists of the following columns:<br />
*'''Default''' - Allows you to define the language used by default, for example for guests or members who have not changed the language in their [[profile]].<br />
*'''Language Name''' - The name of the language<br />
*'''Character Set''' - The character codification of the language installed.<br />
*'''Users''' - The number of members using that particular language.<br />
*'''Locale''' - The code that defines the language. Please see [[Wikipedia:Locale]] for details<br />
<br />
If more than one language is installed, you can select which language you want to be the default. Clicking ''Save'' will then change the default language.<br />
<br />
===Edit a Language===<br />
<br />
The settings for each language are edited by clicking on the name of the language in the list. The following settings are available:<br />
<br />
*Character Set<br />
*Locale<br />
*Dictionary<br />
*Spelling<br />
*Enable "Right to Left" Mode<br />
<br />
====Edit Language Entries====<br />
<br />
From the drop-down list, select ''General Strings'' (which covers most of the strings in SMF), or one of the other choices to see all of the language entries (also referred to as language strings). These contain words like 'hello' and 'password incorrect', which are used throughout your forum. If you change these entries, and select the ''save'' button at the bottom of the page, you can change how information is displayed on your forum. Where you find strange formatting ($1$s, or {USER_NAME}), keep the strange formatting in order to continue to provide the correct information to you and your forum's users.<br />
<br />
== Add Language ==<br />
<br />
Here you can download directly new languages from the Simple Machines website. There is a box where the English name of the language can be inserted to search for it on the Simple Machines website.<br />
<br />
The results are presented in a list with details of the languages available based on the search terms. To start the installation procedure of a new language, click ''Install'' next to the relevant language.<br />
<br />
In the first step, all the language files are checked against the already installed files for that language and the page reports if the files are writable. The results of this check are displayed in a table, where you can see the version numbers of the language files; whether they are already installed; and if so, whether there are any updates available. A checkbox allows you to select which files to copy to the local forum. If no files are checked, all files are automatically installed.<br />
<br />
== Settings ==<br />
<br />
In this page it is possible to set the ''Default Forum Language'' from a drop-down menu and define if the users are allowed to select the language in which they want to view the forum by checking the ''Enable user-selectable language support'' checkbox.<br />
<br />
==Additional Information==<br />
<br />
[[Languages_--_How_to_add_or_change_phrases_used_by_the_forum_software|How to add or change phrases used by the forum software]]<br />
<br />
{{As an administrator}}</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=Topic&diff=19312Topic2013-10-27T15:40:51Z<p>Yoshi2889: </p>
<hr />
<div>Topics (often called threads) are collections of messages grouped together under a common title, intended to reflect a single topic of discussion. Topics may have [[poll]]s and/or [[calendar]] events attached to them.<br />
<br />
The original poster (also known as the OP), is the [[member]] who opened the topic, making the first post in the topic. Sometimes, an [[Administrator]] may give elevated permissions to the member who started the topic.<br />
<br />
Topics can have the following states:<br />
*'''[[Sticky]]''': This state indicates that a topic contains important information, or information that may be useful to the subject of the board.<br />
*'''[[Locked topic|Locked]]''': This state locks the topic down so only privileged people can reply to it. Common uses for this state are indicating that a discussion is unwanted, or that a conclusion has been made out of a discussion.<br />
<br />
The default cap of topics in SMF is 16,777,216 topics.<br />
<br />
<noinclude><br />
[[Category:SMF terminology]]<br />
</noinclude></div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=Topic&diff=19310Topic2013-10-27T15:25:11Z<p>Yoshi2889: Spice up the page</p>
<hr />
<div>Topics (often called threads) are collections of messages grouped together under a common title, intended to reflect a single topic of discussion. Topics may have [[poll]s and/or [[calendar]] events attached to them.<br />
<br />
The original poster, is the [[member]]s who opened the topic, making the first post in the topic. Sometimes, an [[Administrator]] may give elevated permissions to the member who started the topic.<br />
<br />
Topics can have the following states:<br />
*'''[[Sticky]]''': This state indicates that a topic contains important information, or information that may be useful to the subject of the board.<br />
*'''[[Locked topic|Locked]]''': This state locks the topic down so only privileged people can reply to it. Common uses for this state are indicating that a discussion is unwanted, or that a conclusion has been made out of a discussion.<br />
<br />
The default cap of topics in SMF is 16,777,216 topics.<br />
<br />
<noinclude><br />
[[Category:SMF terminology]]<br />
</noinclude></div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=Notifications&diff=19309Notifications2013-10-27T14:50:36Z<p>Yoshi2889: Remove duplicate header</p>
<hr />
<div>Notifications are a way to keep up with interesting [[Topic]]s and [[Board]]s. This may be a topic which you have posted in, or a topic which you are interested in keeping up with.<br />
<br />
== Using Notifications ==<br />
=== Subscribing to a Topic ===<br />
There are two ways you can use to subscribe to a topic:<br />
# When you are [[Posting#Replying_to_a_Topic_or_Poll|posting a Reply]], under [[Posting#Additional_Options|Attachments and other options]], you may check the "Notify me of replies" box.<br />
# When you are viewing the topic, you may select the Notify button at the top or the bottom of the page. You will be asked if you are sure, select OK to confirm the subscription.<br />
<br />
=== Subscribing to a Board ===<br />
To subscribe to a board, you may select the Notify button at the top or the bottom of the [[Message index]] of the respective board.<br />
<br />
=== Unsubscribing from a Topic or Board ===<br />
Once you have subscribed to a topic or a board, you may manage your subscriptions in your [[profile]], under Modify Profile > Notifications.<br />
<br />
On the Notifications page, you will be presented with a list of every topic and board you have subscribed to. To unsubscribe from topics or boards, check the boxes for the respective topics and boards and then select Unsubscribe.<br />
<br />
To quickly unsubscribe from a topic or a board, you may select the Unnotify button while you are in the message index of the topic or board that you wish to unsubscribe from.<br />
<br />
== Notification Settings ==<br />
SMF is capable of sending e-mails for subscriptions. You can change the settings for this feature in your [[profile]], under Modify Profile > Notifications. The following settings are available:<br />
*'''Receive forum newsletters, announcements and important notifications by email.''' If the [[Administrator]] has enabled [[News_and_newsletters#Newsletters|Newsletters]] in the News and Newsletters section, any Newsletters sent out by the forum will be sent to your e-mail inbox. Any Announcements will also be sent to your inbox.<br />
*'''Enable notification when I post or reply to a topic.''' If this setting is enabled, you will automatically be subscribed to any topic you reply to or post yourself.<br />
*'''When sending notification of a reply to a topic, send the post in the email (but please do not reply to these emails).''' If this setting is enabled and you subscribe to a topic, SMF will copy the contents of the new reply into the e-mail.<br />
*'''For topics and boards from which I have requested notification, notify me:''' This setting changes the timespan of when e-mails will be sent out by the forum. Possible options are:<br />
** Instantly<br />
** Instantly (but only for the first unread reply)<br />
** Daily<br />
** Weekly<br />
*'''For topics and boards from which I have requested notification, notify me of:''' This setting changes when SMF will send e-mail notifications to you. Possible options are:<br />
** Replies and Moderation<br />
** Moderation (only if I started the topic)<br />
** Only replies<br />
** Nothing at all<br />
<br />
{{ {{Localized|As a regular user}}}}</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=Notifications&diff=19308Notifications2013-10-27T14:47:10Z<p>Yoshi2889: Spice up the page</p>
<hr />
<div>Notifications are a way to keep up with interesting [[Topic]]s and [[Board]]s. This may be a topic which you have posted in, or a topic which you are interested in keeping up with.<br />
<br />
== Using Notifications ==<br />
=== Subscribing to a Topic ===<br />
There are two ways you can use to subscribe to a topic:<br />
# When you are [[Posting#Replying_to_a_Topic_or_Poll|posting a Reply]], under [[Posting#Additional_Options|Attachments and other options]], you may check the "Notify me of replies" box.<br />
# When you are viewing the topic, you may select the Notify button at the top or the bottom of the page. You will be asked if you are sure, select OK to confirm the subscription.<br />
<br />
=== Unsubscribing from a Topic or Board ===<br />
<br />
=== Subscribing to a Board ===<br />
To subscribe to a board, you may select the Notify button at the top or the bottom of the [[Message index]] of the respective board.<br />
<br />
=== Unsubscribing from a Topic or Board ===<br />
Once you have subscribed to a topic or a board, you may manage your subscriptions in your [[profile]], under Modify Profile > Notifications.<br />
<br />
On the Notifications page, you will be presented with a list of every topic and board you have subscribed to. To unsubscribe from topics or boards, check the boxes for the respective topics and boards and then select Unsubscribe.<br />
<br />
To quickly unsubscribe from a topic or a board, you may select the Unnotify button while you are in the message index of the topic or board that you wish to unsubscribe from.<br />
<br />
== Notification Settings ==<br />
SMF is capable of sending e-mails for subscriptions. You can change the settings for this feature in your [[profile]], under Modify Profile > Notifications. The following settings are available:<br />
*'''Receive forum newsletters, announcements and important notifications by email.''' If the [[Administrator]] has enabled [[News_and_newsletters#Newsletters|Newsletters]] in the News and Newsletters section, any Newsletters sent out by the forum will be sent to your e-mail inbox. Any Announcements will also be sent to your inbox.<br />
*'''Enable notification when I post or reply to a topic.''' If this setting is enabled, you will automatically be subscribed to any topic you reply to or post yourself.<br />
*'''When sending notification of a reply to a topic, send the post in the email (but please do not reply to these emails).''' If this setting is enabled and you subscribe to a topic, SMF will copy the contents of the new reply into the e-mail.<br />
*'''For topics and boards from which I have requested notification, notify me:''' This setting changes the timespan of when e-mails will be sent out by the forum. Possible options are:<br />
** Instantly<br />
** Instantly (but only for the first unread reply)<br />
** Daily<br />
** Weekly<br />
*'''For topics and boards from which I have requested notification, notify me of:''' This setting changes when SMF will send e-mail notifications to you. Possible options are:<br />
** Replies and Moderation<br />
** Moderation (only if I started the topic)<br />
** Only replies<br />
** Nothing at all<br />
<br />
{{ {{Localized|As a regular user}}}}</div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=Forum_header&diff=19286Forum header2013-10-25T23:58:03Z<p>Yoshi2889: put back image</p>
<hr />
<div>{{TOCright}}The forum header is the section at the top, which appears on every page when browsing the forum. Generally, the forum header refers to the part from the forum title down to the [[Main menu|Main Menu]]. In the default SMF 2.0 theme it looks like this:<br />
<br />
[[image:Forum_header_2.0.png|800px]]<br />
<br />
The forum header can be collapsed (hidden) or expanded (shown) using the icon <span style="background-color: rgb(215, 218, 236);">[[File:Upshrink2.png|x20px]]</span> in the top right hand corner. <br />
<br />
== Features found in the header ==<br />
=== As a guest ===<br />
[[image:Guest_Header.png|thumb|Viewing the forum header as a guest]]<br />
* Quick login (if enabled): Members can quickly login from within the header.<br />
* Quick search: Users can search from anywhere within the forum using the search bar available in the header.<br />
* [[News]] (if enabled): SMF will display news in the header. If multiple news items are entered, SMF will randomly choose one from the available items and display it to the user.<br />
<br />
=== As a member ===<br />
[[image:Member_Header.png|thumb|Viewing the forum header as a regular member]]<br />
Members will benefit from all the features that a guest can access, along with the following features:<br />
*Quick links to [[How to view unread posts and replies|Unread replies and Unread posts]]<br />
*The header will show information about the currently logged in member, and if available also the member's avatar<br />
*Some [[themes]] will also show the number of unread [[personal messages]] in the header.<br />
<br />
=== As an administrator/moderator ===<br />
[[image:Admin_Header.png|thumb|Viewing the forum header as an administrator with maintenance mode enabled]]<br />
Administrators and moderators will find every feature members can also find in the header, plus a few additional features:<br />
* If maintenance mode is enabled, a message will be displayed along with the links for unread posts and replies.<br />
* If there are any [[Members#Awaiting_Approval|members awaiting approval]], the header will show the number of members along with a quick link to the moderation center.<br />
<br />
<noinclude><br />
[[Category:SMF terminology]]<br />
</noinclude></div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=Forum_header&diff=19285Forum header2013-10-25T23:56:40Z<p>Yoshi2889: </p>
<hr />
<div>{{TOCright}}The forum header is the section at the top, which appears on every page when browsing the forum. Generally, the forum header refers to the part from the forum title down to the [[Main menu|Main Menu]].<br />
<br />
The forum header can be collapsed (hidden) or expanded (shown) using the icon <span style="background-color: rgb(215, 218, 236);">[[File:Upshrink2.png|x20px]]</span> in the top right hand corner. <br />
<br />
== Features found in the header ==<br />
=== As a guest ===<br />
[[image:Guest_Header.png|thumb|Viewing the forum header as a guest]]<br />
* Quick login (if enabled): Members can quickly login from within the header.<br />
* Quick search: Users can search from anywhere within the forum using the search bar available in the header.<br />
* [[News]] (if enabled): SMF will display news in the header. If multiple news items are entered, SMF will randomly choose one from the available items and display it to the user.<br />
<br />
=== As a member ===<br />
[[image:Member_Header.png|thumb|Viewing the forum header as a regular member]]<br />
Members will benefit from all the features that a guest can access, along with the following features:<br />
*Quick links to [[How to view unread posts and replies|Unread replies and Unread posts]]<br />
*The header will show information about the currently logged in member, and if available also the member's avatar<br />
*Some [[themes]] will also show the number of unread [[personal messages]] in the header.<br />
<br />
=== As an administrator/moderator ===<br />
[[image:Admin_Header.png|thumb|Viewing the forum header as an administrator with maintenance mode enabled]]<br />
Administrators and moderators will find every feature members can also find in the header, plus a few additional features:<br />
* If maintenance mode is enabled, a message will be displayed along with the links for unread posts and replies.<br />
* If there are any [[Members#Awaiting_Approval|members awaiting approval]], the header will show the number of members along with a quick link to the moderation center.<br />
<br />
<noinclude><br />
[[Category:SMF terminology]]<br />
</noinclude></div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=Forum_header&diff=19284Forum header2013-10-25T23:52:17Z<p>Yoshi2889: </p>
<hr />
<div>{{TOCright}}The forum header is the section at the top, which appears on every page when browsing the forum. Generally, the forum header refers to the part from the forum title down to the [[Main menu|Main Menu]]. In the default SMF 2.0 theme it looks like this:<br />
<br />
[[image:Forum_header_2.0.png|800px]]<br />
<br />
The forum header can be collapsed (hidden) or expanded (shown) using the icon <span style="background-color: rgb(215, 218, 236);">[[File:Upshrink2.png|x20px]]</span> in the top right hand corner. <br />
<br />
== Features found in the header ==<br />
=== As a guest ===<br />
[[image:Guest_Header.png|frame|Viewing the forum header as a guest|left]]<br />
* Quick login (if enabled): Members can quickly login from within the header.<br />
* Quick search: Users can search from anywhere within the forum using the search bar available in the header.<br />
* [[News]] (if enabled): SMF will display news in the header. If multiple news items are entered, SMF will randomly choose one from the available items and display it to the user.<br />
<br />
=== As a member ===<br />
[[image:Member_Header.png|frame|Viewing the forum header as a regular member|left]]<br />
Members will benefit from all the features that a guest can access, along with the following features:<br />
*Quick links to [[How to view unread posts and replies|Unread replies and Unread posts]]<br />
*The header will show information about the currently logged in member, and if available also the member's avatar<br />
*Some [[themes]] will also show the number of unread [[personal messages]] in the header.<br />
<br />
=== As an administrator/moderator ===<br />
[[image:Admin_Header.png|frame|Viewing the forum header as an administrator with maintenance mode enabled|left]]<br />
Administrators and moderators will find every feature members can also find in the header, plus a few additional features:<br />
* If maintenance mode is enabled, a message will be displayed along with the links for unread posts and replies.<br />
* If there are any [[Members#Awaiting_Approval|members awaiting approval]], the header will show the number of members along with a quick link to the moderation center.<br />
<br />
<noinclude><br />
[[Category:SMF terminology]]<br />
</noinclude></div>Yoshi2889https://wiki.simplemachines.org/w/index.php?title=Forum_header&diff=19280Forum header2013-10-25T22:35:47Z<p>Yoshi2889: boxes for images</p>
<hr />
<div>{{TOCright}}The forum header is the section at the top, which appears on every page when browsing the forum. Generally, the forum header refers to the part from the forum title down to the [[Main menu|Main Menu]]. In the default SMF 2.0 theme it looks like this:<br />
<br />
[[image:Forum_header_2.0.png|800px]]<br />
<br />
The forum header can be collapsed (hidden) or expanded (shown) using the icon <span style="background-color: rgb(215, 218, 236);">[[File:Upshrink2.png|x20px]]</span> in the top right hand corner. <br />
<br />
== Features found in the header ==<br />
=== As a guest ===<br />
[[image:Guest_Header.png|frame|Viewing the forum header as a guest]]<br />
* Quick login (if enabled): Members can quickly login from within the header.<br />
* Quick search: Users can search from anywhere within the forum using the search bar available in the header.<br />
* [[News]] (if enabled): SMF will display news in the header. If multiple news items are entered, SMF will randomly choose one from the available items and display it to the user.<br />
<br />
=== As a member ===<br />
[[image:Member_Header.png|frame|Viewing the forum header as a regular member]]<br />
Members will benefit from all the features that a guest can access, along with the following features:<br />
*Quick links to [[How to view unread posts and replies|Unread replies and Unread posts]]<br />
*The header will show information about the currently logged in member, and if available also the member's avatar<br />
*Some [[themes]] will also show the number of unread [[personal messages]] in the header.<br />
<br />
=== As an administrator/moderator ===<br />
[[image:Admin_Header.png|frame|Viewing the forum header as an administrator with maintenance mode enabled]]<br />
Administrators and moderators will find every feature members can also find in the header, plus a few additional features:<br />
* If maintenance mode is enabled, a message will be displayed along with the links for unread posts and replies.<br />
* If there are any [[Members#Awaiting_Approval|members awaiting approval]], the header will show the number of members along with a quick link to the moderation center.<br />
<br />
<noinclude><br />
[[Category:SMF terminology]]<br />
</noinclude></div>Yoshi2889