Help:MTA Wiki Specific Templates: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
m (Added note box)
(Remove Requirements that are actually barely used, it's useless due to New feature/item)
 
(32 intermediate revisions by 5 users not shown)
Line 1: Line 1:
Information about the specific MTA wiki page templates for this wiki. (They do probably not exists on other Mediawiki wiki's)
Information about the specific MTA wiki page templates for this wiki. (They do probably not exists on other Mediawiki wiki's)
__TOC__
{{Tip|If you want to avoid spacing between the page title and the template itself, you should include the template before <nowiki>__NOTOC__</nowiki> other templates and/or [http://www.mediawiki.org/wiki/Help:Magic_words magic words].}}


== Article Needs Checking ==
== Funtion / event templates ==
=== Deprecated function/event ===
Use this template to indicate functions or events that are being deleted from MTA because there is a more generic way to perform what they do (and they are necessary no longer). The last two arguments of this template aren't mandatory, and can be ignored if there isn't an alternative function or aditional text.
 
'''Format:''' <nowiki>{{Deprecated|alternativeFunction|more text}}</nowiki>
<noinclude>{{Deprecated}}
{{Deprecated|alternativeFunction|more text}}</noinclude>
 
Wiki pages containing this template will be added to the [[:Category:Deprecated]] for reference.
 
=== Function/event needs example ===
Use this template to indicate when a function or event needs a scripting example.
 
'''Format:''' <nowiki>{{Needs Example}}</nowiki>
<noinclude>{{Needs Example}}</noinclude>
Wiki pages containing this template will be added to the [[:Category:Needs Example]] for reference.
 
=== Disabled function/event ===
Use this template to indicate when a function or event has been disabled in the MTA: SA source code. Normally there's an important reason for this. The last two parameters aren't mandatory and can be ignored.
 
'''Format:''' <nowiki>{{Disabled|reason|bugTrackerIssueNumber}}</nowiki>
<noinclude>{{Disabled}}
{{Disabled|reason|bugTrackerIssueNumber}}</noinclude>
 
Wiki pages containing this template will be added to the [[:Category:Needs Checking]] and [[:Category:Disabled Functions and Events]] for reference.
 
=== Module only function/event ===
Use this template to indicate a module only function/event template. That will inform readers that this function is module specific and not build-in to MTA itself.
Note: You only have to add the module name not the 'Modules/' prefix.
 
'''Format:''' <nowiki>{{ModuleFunction|Module Name}}</nowiki>
<noinclude>{{ModuleFunction|ModuleName}}</noinclude>
 
=== New function/event/change ===
Use this template to indicate a function, event or change that will be applied in a future version of MTA. This template is best used when it contains the function/event/change description, because it removes itself when MTA gets updated (MTA version is greater than the ''targetVersion'' specified in this template parameters). All arguments of this template are mandatory.
Notes: ''targetVersion'' parameter must be a number in the format 3.0XXX, where XXX is the version when the function/event/change will be applied. For example, if a function will be added in MTA version ''2.0.1'', put 3.0''201'' in ''targetVersion''. ''showVersion'' parameter is only visual and specifies the text contained in "From version ... onwards".
 
'''Format:''' <nowiki>{{New feature/item|targetVersion|showVersion|Revision}}</nowiki>
<noinclude>{{New feature/item|3.0312|2.9|19999|
This template has ''3.0157'' and ''2.9'' and ''19999'' as parameters, so it'll be removed and only this text will be shown when MTA version is 3.1.2 or higher.
}}</noinclude>
 
 
If you want to display a change from a previous version in the format of "Before version x.x", use the following code:
 
'''Format:''' <nowiki>{{Deprecated feature|untilVersion|showVersion}}</nowiki>
<noinclude>{{Deprecated feature|3.0300|3.0|
This template has ''3.0300'' and ''3.0'' versions as parameters, so this box will only be displayed until MTA's version is 3.0 or higher.  After that, it'll disappear completely.
}}</noinclude>
 
== Article/Page/Category Maintenance ==
=== Article Needs Checking ===
These are functions that need to be checked to ensure they do work as specified. If there are any problems with a function, example or the wiki page itself, attach a note to the top of the page and describe the problems.
These are functions that need to be checked to ensure they do work as specified. If there are any problems with a function, example or the wiki page itself, attach a note to the top of the page and describe the problems.


'''Format:''' <nowiki>{{Needs Checking|STATE_PROBLEM_HERE}}</nowiki>
'''Format:''' <nowiki>{{Needs Checking|STATE_PROBLEM_HERE}}</nowiki>
<div style="border: 1px dotted blue; background: #AAAAFF;padding:4px;margin-bottom:2px;">[[file:Dialog-information.png]]'''This article needs checking for the following reason:''' STATE_PROBLEM_HERE</div>
{{MessageBox|
 
  bordercolorhex = 0026FF |
  bordertype = dotted |
  bgcolorhex = CCCCFF |
  image = File:Dialog-information.png |
  title = This article needs checking. |
  subtext = '''Reason:''' STATE_PROBLEM_HERE |
}}
Wiki pages attached to this template will be added to the [[:Category:Needs_Checking]]
Wiki pages attached to this template will be added to the [[:Category:Needs_Checking]]


== Article Outdated ==
=== Article Outdated ===
If the information in the article no longer applies and/or an alternative article exists you can use this template and link to the alternative article. If it is still useful and/or (partially) valid and needs to be updated or no alternative article exists use the 'Article Needs Checking' template.
If the information in the article no longer applies and/or an alternative article exists you can use this template and link to the alternative article. If it is still useful and/or (partially) valid and needs to be updated or no alternative article exists use the 'Article Needs Checking' template.


'''Format without reason:''' <nowiki>{{Outdated|}}</nowiki>
'''Format without reason:''' <nowiki>{{Outdated}}</nowiki>
<div style="border: 1px dotted #C0C0C0; background: #C9F9FF;padding:4px;margin-bottom:2px;">[[file:Dialog-information.png]]'''This article is (partially) outdated and the information may no longer apply.'''</div>
{{MessageBox|
  bordercolorhex = C0C0C0 |
  bgcolorhex = C9F9FF |
  bordertype = dotted |
  image = File:Dialog-information.png |
  title = This article is (partially) outdated and the information may no longer apply. |
}}


'''Format with reason:''' <nowiki>{{Outdated|The Reason HERE}}</nowiki>
'''Format with reason:''' <nowiki>{{Outdated|The Reason HERE}}</nowiki>
<div style="border: 1px dotted #C0C0C0; background: #C9F9FF;padding:4px;margin-bottom:2px;">[[file:Dialog-information.png]]'''This article is (partially) outdated and the information may no longer apply.'''  
{{MessageBox|
<br>Reason: The Reason HERE</div>
  bordercolorhex = C0C0C0 |
  bgcolorhex = C9F9FF |
  bordertype = dotted |
  image = File:Dialog-information.png |
  title = This article is (partially) outdated and the information may no longer apply. |
  subtext = '''Reason:''' The Reason HERE |
}}
Wiki pages attached to this template will be added to the [[:Category:Outdated Pages]]
 
=== Article translation Outdated ===
If the article translation is outdated use this template.
 
'''Format without subtext:''' <nowiki>{{Outdatedtr}}</nowiki>
{{MessageBox|
  bordercolorhex = C0C0C0 |
  bgcolorhex = C9F9FF |
  bordertype = dotted |
  image = File:Preferences-desktop-locale.png |
  title = This translated article is (partially) outdated and the information may no longer apply. |
}}
 
'''Format with subtext:''' <nowiki>{{Outdatedtr|The subtext here}}</nowiki>
{{MessageBox|
  bordercolorhex = C0C0C0 |
  bgcolorhex = C9F9FF |
  bordertype = dotted |
  image = File:Preferences-desktop-locale.png |
  title = This translated article is (partially) outdated and the information may no longer apply. |
  subtext = The subtext here |
}}
Wiki pages attached to this template will be added to the Category:Outdated Pages
 
== General Templates ==
=== Warning ===
Warning template for in-line warnings.
 
'''Format:''' <nowiki>{{Warning|Warning info here}}</nowiki>
{{MessageBox|
  bordercolorhex = FFB2B2 |
  bgcolorhex = FFE5E5 |
  title = Warning: |
  message = Warning info here
}}
Warning template for article warnings.


Wiki pages attached to this template will be added to the [[:Category:Outdated Articles]]
'''Format:''' <nowiki>{{Warning|Warning info here|true}}</nowiki>
{{MessageBox|
  bordercolorhex = FFB2B2 |
  bgcolorhex = FFE5E5 |
  image = File:Dialog-warning.png |
  title = Warning: |
  message = Warning info here
}}


== Function Deprecated ==
=== Note ===
Functions that are being deleted from MTA because there is a more generic way.
<div style="border: 1px solid black; background: #FFFF99; float: right; width: 200px; padding: 5px; margin: 5px; margin-right: 0px;">'''Note:''' Note info here</div>


'''Format:''' <nowiki>{{Deprecated}}</nowiki>
The note box floats always right in the page/article.
<div style="border:3px solid red;background:#FF7777;padding:5px;">[[File:Emblem-important.png]] This function is deprecated. This means that its use is discouraged and that it might not exist in future versions, but there should be an alternative (usually more generic) way of performing what it once did.</div>


Wiki pages attached to this template will be added to the [[:Category:Deprecated]]
'''Format:''' <nowiki>{{Note box|Note info here}}</nowiki>


== Function Deprecated With Alternative ==
Template for in-line note:
Same as above but now with a linked alternative function.


'''Format:''' <nowiki>{{DeprecatedWithAlt|functionAlternative|More Text}}</nowiki>
'''Format:''' <nowiki>{{Note|Note info here}}</nowiki>
{{MessageBox|
  bordercolorhex = BFBFFF |
  bgcolorhex = E0E0FF |
  message = '''Note:''' Note info here |
}}


<div style="border:3px solid red;background:#FF7777;padding:5px;">[[file:Emblem-important.png‎]] This function is deprecated. This means that its use is discouraged and that it might not exist in future versions.<br><br>
Alternative in-line note:
Please use [[functionAlternative]] instead. More Text</div>
Wiki pages attached to this template will be added to the [[:Category:Deprecated]]


== Function Needs Example ==
'''Format:''' <nowiki>{{Important Note|Note info here}}</nowiki>
Use this template when a function or event needs an example.
{{MessageBox|
  bordercolorhex = FFB2B2 |
  bgcolorhex = FFE5E5 |
  message = '''Important Note:''' Note info here |
}}


'''Format:''' <nowiki>{{Needs Example}}</nowiki>
=== Tip ===
 
'''Format:''' <nowiki>{{Tip|Text here}}</nowiki>
 
{{MessageBox|
  bordercolorhex = 81C687 |
  bgcolorhex = E2FFE5 |
  message = '''Tip:''' Text here |
}}
 
== Localization ==
=== Localized article ===
Adds a link to a localized article in this wiki, with a flag which represents the language the article is written in.
 
'''Format:''' <nowiki>{{Localized article|Main Page|Wiki's main page|us|en}}</nowiki>


<div style="border: 1px dotted black; background: #EFEFEF;padding:4px;margin-bottom:2px;">[[File:Accessories-text-editor.png]] '''Script Example Missing''' - Function <nowiki>{{FULLPAGENAME}}</nowiki> needs a script example, help out by writing one.</div>
{{Localized article|Main Page|Wiki's main page|us|en}}
Wiki pages attached to this template will also be added to the [[:Category:Needs Example]]
For more information about the use of the template, please refer to [[Template:Localized article|its page]].


== Warning ==
== Special ==
=== Delete ===
Mark a page for deletion, so administrators can decide if they remove the page.


'''Format:''' <nowiki>{{Warning|Warning info here}}</nowiki>
'''Format:''' <nowiki>{{Delete|Reason here}}</nowiki>


<div style="border:3px solid red;background:#FF7777;padding:5px;">[[File:Process-stop.png]] '''Warning:''' Warning info here</div>
{{MessageBox|
  bordercolorhex = FF0000 |
  bgcolorhex = FFADAD |
  image = File:Edit-delete.png |
  title = This page is marked for deletion. |
  subtext = '''Reason:''' Reason Here <div><span style="font-size: 85%; margin-left: 2px;">'''Actions:''' <span class="plainlinks">[[#Delete |'''Delete''']] (Administrators)</span> - [[{{TALKPAGENAME}}|Discuss]] - [[Special:Whatlinkshere/{{FULLPAGENAME}}|What links here]] - [[:Category:MTA Wiki:Delete|Category]]</span></div> |
}}


== Note ==
Wiki pages attached to this template will be added to the [[:Category:MTA Wiki:Delete]]
<div style="border: 1px solid black; background: #FFFF7F; float: right; width: 200px; padding: 5px; margin: 5px; margin-right: 0px;">'''Note:''' Note info here</div>
Note box is used for notes. The note box floats always right in the page/article.


'''Format:''' <nowiki>{{Note box|Note info here}}</nowiki>
[[Category:MTA Wiki:Editing]]
__HIDDENCAT__

Latest revision as of 15:38, 7 November 2024

Information about the specific MTA wiki page templates for this wiki. (They do probably not exists on other Mediawiki wiki's)

[[{{{image}}}|link=|]] Tip: If you want to avoid spacing between the page title and the template itself, you should include the template before __NOTOC__ other templates and/or magic words.

Funtion / event templates

Deprecated function/event

Use this template to indicate functions or events that are being deleted from MTA because there is a more generic way to perform what they do (and they are necessary no longer). The last two arguments of this template aren't mandatory, and can be ignored if there isn't an alternative function or aditional text.

Format: {{Deprecated|alternativeFunction|more text}}

Emblem-important.png This function is deprecated. This means that its use is discouraged and that it might not exist in future versions, but there should be a more generic way to perform what it does.


Emblem-important.png This function is deprecated. This means that its use is discouraged and that it might not exist in future versions.

Please use alternativeFunction instead. more text


Wiki pages containing this template will be added to the Category:Deprecated for reference.

Function/event needs example

Use this template to indicate when a function or event needs a scripting example.

Format: {{Needs Example}}

Accessories-text-editor.png Script Example Missing Function Help:MTA Wiki Specific Templates needs a script example, help out by writing one.

Before submitting check out Editing Guidelines Script Examples.


Wiki pages containing this template will be added to the Category:Needs Example for reference.

Disabled function/event

Use this template to indicate when a function or event has been disabled in the MTA: SA source code. Normally there's an important reason for this. The last two parameters aren't mandatory and can be ignored.

Format: {{Disabled|reason|bugTrackerIssueNumber}}

Dialog-warning.png Function has been disabled.


Dialog-warning.png Function has been disabled.

Reason/Note: reason - Bugtracker Issue: #bugTrackerIssueNumber


Wiki pages containing this template will be added to the Category:Needs Checking and Category:Disabled Functions and Events for reference.

Module only function/event

Use this template to indicate a module only function/event template. That will inform readers that this function is module specific and not build-in to MTA itself. Note: You only have to add the module name not the 'Modules/' prefix.

Format: {{ModuleFunction|Module Name}}

Package-x-generic.png This function is provided by the external module ModuleName. You must install this module to use this function.


New function/event/change

Use this template to indicate a function, event or change that will be applied in a future version of MTA. This template is best used when it contains the function/event/change description, because it removes itself when MTA gets updated (MTA version is greater than the targetVersion specified in this template parameters). All arguments of this template are mandatory. Notes: targetVersion parameter must be a number in the format 3.0XXX, where XXX is the version when the function/event/change will be applied. For example, if a function will be added in MTA version 2.0.1, put 3.0201 in targetVersion. showVersion parameter is only visual and specifies the text contained in "From version ... onwards".

Format: {{New feature/item|targetVersion|showVersion|Revision}}

ADDED/UPDATED IN VERSION 2.9 r19999:

This template has 3.0157 and 2.9 and 19999 as parameters, so it'll be removed and only this text will be shown when MTA version is 3.1.2 or higher.


If you want to display a change from a previous version in the format of "Before version x.x", use the following code:

Format: {{Deprecated feature|untilVersion|showVersion}}

BEFORE VERSION 3.0

This template has 3.0300 and 3.0 versions as parameters, so this box will only be displayed until MTA's version is 3.0 or higher. After that, it'll disappear completely.

Article/Page/Category Maintenance

Article Needs Checking

These are functions that need to be checked to ensure they do work as specified. If there are any problems with a function, example or the wiki page itself, attach a note to the top of the page and describe the problems.

Format: {{Needs Checking|STATE_PROBLEM_HERE}}

Dialog-information.png This article needs checking.

Reason: STATE_PROBLEM_HERE

Wiki pages attached to this template will be added to the Category:Needs_Checking

Article Outdated

If the information in the article no longer applies and/or an alternative article exists you can use this template and link to the alternative article. If it is still useful and/or (partially) valid and needs to be updated or no alternative article exists use the 'Article Needs Checking' template.

Format without reason: {{Outdated}}

Dialog-information.png This article is (partially) outdated and the information may no longer apply.

Format with reason: {{Outdated|The Reason HERE}}

Dialog-information.png This article is (partially) outdated and the information may no longer apply.

Reason: The Reason HERE

Wiki pages attached to this template will be added to the Category:Outdated Pages

Article translation Outdated

If the article translation is outdated use this template.

Format without subtext: {{Outdatedtr}}

Preferences-desktop-locale.png This translated article is (partially) outdated and the information may no longer apply.

Format with subtext: {{Outdatedtr|The subtext here}}

Preferences-desktop-locale.png This translated article is (partially) outdated and the information may no longer apply.

The subtext here

Wiki pages attached to this template will be added to the Category:Outdated Pages

General Templates

Warning

Warning template for in-line warnings.

Format: {{Warning|Warning info here}}

[[{{{image}}}|link=|]] Warning: Warning info here

Warning template for article warnings.

Format: {{Warning|Warning info here|true}}

Dialog-warning.png Warning: Warning info here

Note

Note: Note info here

The note box floats always right in the page/article.

Format: {{Note box|Note info here}}

Template for in-line note:

Format: {{Note|Note info here}}

[[{{{image}}}|link=|]] Note: Note info here

Alternative in-line note:

Format: {{Important Note|Note info here}}

[[{{{image}}}|link=|]] Important Note: Note info here

Tip

Format: {{Tip|Text here}}


[[{{{image}}}|link=|]] Tip: Text here

Localization

Localized article

Adds a link to a localized article in this wiki, with a flag which represents the language the article is written in.

Format: {{Localized article|Main Page|Wiki's main page|us|en}}

Wiki's main page In English For more information about the use of the template, please refer to its page.

Special

Delete

Mark a page for deletion, so administrators can decide if they remove the page.

Format: {{Delete|Reason here}}


Edit-delete.png This page is marked for deletion.

Reason: Reason Here
Actions: Delete (Administrators) - Discuss - What links here - Category

Wiki pages attached to this template will be added to the Category:MTA Wiki:Delete