Help:MTA Wiki Specific Templates: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(→‎Article/Page/Category Maintenance: Added template outdatedtr)
m (Templates are dynamic and updated now at →‎Funtion / Event Templates: (part I))
Line 2: Line 2:
{{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 [http://www.mediawiki.org/wiki/Help:Magic_words magic words].}}
{{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 [http://www.mediawiki.org/wiki/Help:Magic_words magic words].}}


== Funtion / Event Templates ==
== Funtion / event templates ==
=== Function Deprecated ===
=== Deprecated function/event ===
Functions that are being deleted from MTA because there is a more generic way.
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}}</nowiki>
'''Format:''' <nowiki>{{Deprecated|alternativeFunction|more text}}</nowiki>
{{MessageBox|
<noinclude>{{Deprecated}}
  bordercolorhex = FF0000 |
{{Deprecated|alternativeFunction|more text}}</noinclude>
  bgcolorhex = FFBFBF |
  image = File:Emblem-important.png |
  message = This {{#ifeq: {{padleft:|2|{{lc:{{PAGENAME}}}}}}|on|event|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. |
}}
Wiki pages attached to this template will be added to the [[:Category:Deprecated]]


=== Function Deprecated With Alternative ===
Wiki pages containing this template will be added to the [[:Category:Deprecated]] for reference.
Same as above but now with a linked alternative function.


'''Format:''' <nowiki>{{DeprecatedWithAlt|functionAlternative|More Text}}</nowiki>
=== Function/event needs example ===
 
Use this template to indicate when a function or event needs a scripting example.
{{MessageBox|
  bordercolorhex = FF0000 |
  bgcolorhex = FFBFBF |
  image = File:Emblem-important.png |
  message = This {{#ifeq: {{padleft:|2|{{lc:{{PAGENAME}}}}}}|on|event|function}} is deprecated. This means that its use is discouraged and that it might not exist in future versions. |
  subtext = Please use [[functionAlternative]] instead. More text |
}}
Wiki pages attached to this template will be added to the [[:Category:Deprecated]]
 
=== Function Needs Example ===
Use this template when a function or event needs an example.


'''Format:''' <nowiki>{{Needs Example}}</nowiki>
'''Format:''' <nowiki>{{Needs Example}}</nowiki>
<noinclude>{{Needs Example}}</noinclude>
Wiki pages containing this template will be added to the [[:Category:Needs Example]] for reference.


{{MessageBox|
=== Disabled function/event ===
  bordercolorhex = 000000 |
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.
  bordertype = dotted |
  bgcolorhex = EFEFEF |
  image = File:Accessories-text-editor.png |
  title = Script Example Missing |
  message = {{#ifeq: {{padleft:|2|{{lc:{{PAGENAME}}}}}}|on|Event|Function}} <includeonly>{{FULLPAGENAME}}</includeonly> <noinclude><nowiki>{{FULLPAGENAME}}</nowiki></noinclude> needs a script example, help out by writing one. |
  subtext = <span style="font-size: 85%;">''Before submitting check out [[Help:Editing_Guidelines#Script_Examples|Editing Guidelines Script Examples]].''</span> |
}}
Wiki pages attached to this template will also be added to the [[:Category:Needs Example]]
 
=== Disabled Function/Event ===
Use this template when a function or event has been disabled in the code.


'''Format without parameters:''' <nowiki>{{Disabled}}</nowiki>
'''Format:''' <nowiki>{{Disabled|reason|bugTrackerIssueNumber}}</nowiki>
{{MessageBox|
<noinclude>{{Disabled}}
  bordercolorhex = FF0000 |
{{Disabled|reason|bugTrackerIssueNumber}}</noinclude>
  bgcolorhex = E5E5E5 |
  image = File:Dialog-warning.png |
  title = {{#ifeq: {{padleft:|2|{{lc:{{PAGENAME}}}}}}|on|Event|Function}} has been disabled. |
}}
'''Format with parameters:''' <nowiki>{{Disabled|Function disabled because it crashes|1337}}</nowiki>
{{MessageBox|
  bordercolorhex = FF0000 |
  bgcolorhex = E5E5E5 |
  image = File:Dialog-warning.png |
  title = {{#ifeq: {{padleft:|2|{{lc:{{PAGENAME}}}}}}|on|Event|Function}} has been disabled. |
  subtext = '''Reason/Note:''' Function disabled because it crashes - '''Bugtracker Issue:''' [http://bugs.mtasa.com/view.php?id=1337 #1337] |
}}
Wiki pages attached to this template will be added to the [[:Category:Needs Checking]] and [[:Category:Disabled Functions and Events]].


=== Function/Event Requirements ===
Wiki pages containing this template will be added to the [[:Category:Needs Checking]] and [[:Category:Disabled Functions and Events]] for reference.
Inform the reader that this function or event requires a specific MTA build.


'''Format:''' <nowiki>{{Requirements|1.1.1-9.serverbuild|1.1.1-9.clientbuild}}</nowiki>
=== Function/event requirements ===
Use this template to inform the reader that this function or event requires a minimum MTA build to work.


{| cellpadding="4" style="border-collapse: collapse; border-width: 1px; border-style: solid; border-color: #FFF"
'''Format:''' <nowiki>{{Requirements|minServerBuild|minClientBuild}}</nowiki>
|-
<noinclude>{{Requirements|minServerBuild|minClientBuild}}</noinclude>
!style="background-color: #FFAA44; border-style: solid; border-width: 1px; border-color: #FFF; color:#7A4A20"| Minimum supported server
!width=60 style="background-color: #FFCC66; border-style: solid; border-width: 1px; border-color: #FFF"| 1.1.1-9.serverbuild
|-
!style="background-color: #FF6666; border-style: solid; border-width: 1px; border-color: #FFF; color:#AA0028"| Minimum supported client
!style="background-color: #FFBBBB; border-style: solid; border-width: 1px; border-color: #FFF"| 1.1.1-9.clientbuild
|}Note: Using this function requires the resource to have the above minimum version declared in the [[Meta.xml|meta.xml]] '''<min_mta_version>''' section.


=== Module Only Function ===
=== Module Only Function ===

Revision as of 13:38, 4 July 2014

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

Function/event requirements

Use this template to inform the reader that this function or event requires a minimum MTA build to work.

Format: {{Requirements|minServerBuild|minClientBuild}}

This template will be deleted.

Module Only Function

Module only function template, 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 [[Modules/{{{1}}}|{{{1}}}]]. You must install this module to use this function.

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

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