Template:Software status/doc: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
No edit summary
 
(17 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Doc/subpage}}
{{Doc/subpage}}
This is a replacement of {{t|Game release}} template and other based off this template, combining all of these into one. When this template was good enough, the original "{{t|Game release}}", "{{t|Game announced}}" (and variants of this templates, or similar) will be replaced with something similar to {{t|Banned spammer}}, a redirect page that automatically calls {{t|Software status}} with {{param|type|game}} instead.
This is a replacement of {{t|Game release}} template and variants of it, combining all of these into one. This will make it quicker to maintenance and any edit on this template will apply to all the pages, instead of having to edit multiple separate [[Template:Game release]] template.


The purpose of this template is to tell users whether the game is announced, delisted or currently available on Steam or not, plus whether the game is Chromebook ready or Steam Deck verified.
The purpose of this template is to tell users whether the game is announced, delisted or currently available on Steam or not, plus whether the game is Steam Deck verified.
== Copy and paste ==
== Usage (copy & paste) ==
=== For anything else ===
=== For anything else ===
{{CodeBlock|<nowiki>{{Software status
{{CodeBlock|<nowiki>{{Software status
| appid = <appid>
| appid = <appid>
| type = <games/mods/tools>
| type = games <!-- games/mods/tools -->
| free = <yes/no> <!-- optional, can be removed. - "No" by default -->
| free = no <!-- yes/no - "No" by default -->
| status = <announced/available/delisted/delisted-dl/earlyaccess (ea)/in development (dev/indev)> <!-- More values is available on testcases page. -->
| status = released <!-- announced/released/delisted/delisted-dl/earlyaccess (ea)/in development (dev/indev) --> <!-- More values is available on testcases page. -->
| os = all <!-- See template testcases for more values. -->
| os = all <!-- See template testcases for more values. If you want to hide this, leave the parameter blank. -->
| deck = <deck status> <!-- By default: Unknown. -->
| chromebook = <Chromebook ready status>
| note = <!-- Put any custom notice here. Optional. -->
| note = <!-- Put any custom notice here. Optional. -->
<!-- OTHER STOREFRONTS
<!-- OTHER STOREFRONTS
Line 21: Line 19:
}}
}}
</nowiki>}}
</nowiki>}}
==== System requirements section ====
To make the "See system requirements" button work, you must use this header:
{{CodeBlock|<nowiki>Replace this:
== System Requirements ==
with
== System Requirements<span id="Sysreq"><!--Used by Sysreq template, clicking on "See system requirements" will send you to this section.--></span> ==
</nowiki>}}
This will also works in other languages aswell, and in different text, as long if the "Sysreq" id is not changed.
To add the System requirements template, see {{T|Sysreq}} for more info.


=== For announced games ===
=== For announced games ===
Line 37: Line 44:


== Parameters and Examples ==
== Parameters and Examples ==
{| class="standard-table" style="width:100%"
{| width="100%" class="unsortable" style="overflow: hidden; border-radius:.4em; border:2px solid #525252"
! style="width:15%" | {{Dictionary/common|Param}}
|- bgcolor="#3A3A3A" style="white-space:nowrap"
! style="text-align:center" | {{Dictionary/common|Desc}}
! style="width:15%" style="background-color:#4f5559; color:#FFF" | {{Dictionary/common|Param}}
! style="text-align:center" | Value
! style="text-align:center" style="background-color:#4f5559; color:#FFF" | {{Dictionary/common|Desc}}
! {{Dictionary/common|Previews}}
! style="text-align:center" style="background-color:#4f5559; color:#FFF" | Value
! style="background-color:#4f5559; color:#FFF" | {{Dictionary/common|Previews}}
|-
|-
| align="center" | {{Code|style=2|{{Param|type}}}}
| bgcolor="#3A3A3A" align="center" | {{Code|style=2|{{Param|type}}}}
| align="center" |Type of software, see more value on [[/testcases|testcases page]].<br> '''This must be specified'''.
| bgcolor="#3A3A3A" align="center" |Type of software, see more value on [[/testcases|testcases page]].<br> '''This must be specified'''.
| {{CodeBlock|margin=5px|<nowiki>| type = games</nowiki>}}{{CodeBlock|margin=5px|<nowiki>| type = mods</nowiki>}}{{CodeBlock|margin=5px|<nowiki>| type = tools</nowiki>}}
| bgcolor="#3A3A3A" | {{CodeBlock|margin=5px|<nowiki>| type = games</nowiki>}}{{CodeBlock|margin=5px|<nowiki>| type = mods</nowiki>}}{{CodeBlock|margin=5px|<nowiki>| type = tools</nowiki>}}
| {{Software status|nocat=1|appid = 220|type=mod}}<br>{{Software status|nocat=1|appid = 220|type=tools}}
| bgcolor="#3A3A3A" | {{Software status|nocat=1|appid = 220|type=mod}}<br>{{Software status|nocat=1|appid = 220|type=tools}}
|-
|-
| align="center" | {{Code|style=2|{{Param|appid}}}}
| bgcolor="#3A3A3A" align="center" | {{Code|style=2|{{Param|appid}}}}
| align="center" |Set the AppID for the software
| bgcolor="#3A3A3A" align="center" |Set the AppID for the software
| {{CodeBlock|margin=5px|<nowiki>| appid = 220</nowiki>}}
| bgcolor="#3A3A3A" | {{CodeBlock|margin=5px|<nowiki>| appid = 220</nowiki>}}
| {{Software status|nocat=1|appid = 220|type=game}}
| bgcolor="#3A3A3A" | {{Software status|nocat=1|appid = 220|type=game}}
|-
|-
| align="center" | {{Code|style=2|{{Param|free}}}}
| bgcolor="#3A3A3A" align="center" | {{Code|style=2|{{Param|gamename}}<br>{{Param|customgamename}}}}
| align="center" |Is this software free?<br>If {{code|{{param|free}}{{=}}no}} or left blanks, mark the software as paid, if {{code|{{param|free}}{{=}}yes}}, mark it as a free software.
| bgcolor="#3A3A3A" align="center" | Set the custom game name.<br>{{Param|gamename}} must be set to {{code|other}}, then you put the game name on {{Param|customgamename}} parameters. Used on pages like {{bms|2}}.
| {{CodeBlock|margin=5px|<nowiki>| free = yes/no</nowiki>}}
| bgcolor="#3A3A3A" | {{CodeBlock|margin=5px|<nowiki>| gamename = other</nowiki><br><nowiki>| customgamename = Black Mesa</nowiki>}}
| {{Software status|nocat=1|free = yes|type=game}}
| bgcolor="#3A3A3A" | {{Software status|nocat=1|appid = 362890|type=game|gamename=other|customgamename=Black Mesa}}
|-
|-
| align="center" | {{Code|style=2|{{Param|status}}}}
| bgcolor="#3A3A3A" align="center" | {{Code|style=2|{{Param|free}}}}
| align="center" |Availability of the software, by default, it is marked as "available". If the game was delisted on Steam, set {{param|status}} to {{code|delisted}}<br>If this game is currently in Early Access, set {{param|status}} to {{code|ea}} or {{Code|earlyaccess}}. <br>More value can be found on [[/testcases|testcases page]].
| bgcolor="#3A3A3A" align="center" |Is this software free?<br>If {{code|{{param|free}}{{=}}no}} or left blanks, mark the software as paid, if {{code|{{param|free}}{{=}}yes}}, mark it as a free software.
| {{CodeBlock|margin=5px|<nowiki>| status = delisted</nowiki>}}{{CodeBlock|margin=5px|<nowiki>| status = ea</nowiki>}}
| bgcolor="#3A3A3A" | {{CodeBlock|margin=5px|<nowiki>| free = yes/no</nowiki>}}
| {{Software status|nocat=1|status = delisted|type=game}}<br>{{Software status|nocat=1|status = ea|type=game}}
| bgcolor="#3A3A3A" | {{Software status|nocat=1|free = yes|type=game}}
|-
|-
| align="center" | {{Code|style=2|{{Param|os}}}}
| bgcolor="#3A3A3A" align="center" | {{Code|style=2|{{Param|status}}}}
| align="center" |Supported OS for the game, software, etc..., more can be found on [[/testcases|testcases page]].
| bgcolor="#3A3A3A" align="center" |Availability of the software, by default, it is marked as "available". If the game was delisted on Steam, set {{param|status}} to {{code|delisted}}<br>If this game is currently in Early Access, set {{param|status}} to {{code|ea}} or {{Code|earlyaccess}}. <br>More value can be found on [[/testcases/Availability|testcases/Availability page]].
| {{CodeBlock|margin=5px|<nowiki>| os = win</nowiki>|type=game}}
| bgcolor="#3A3A3A" | {{CodeBlock|margin=5px|<nowiki>| status = delisted</nowiki>}}{{CodeBlock|margin=5px|<nowiki>| status = ea</nowiki>}}{{CodeBlock|margin=5px|<nowiki>| status = demo</nowiki>}}
| {{Software status|nocat=1|os = win|type=game}}
| bgcolor="#3A3A3A" | {{Software status|nocat=1|status = delisted|type=game}}<br>{{Software status|nocat=1|status = ea|type=game}}<br>{{Software status|nocat=1|status = demo|type=game}}
|-
|-
| align="center" | {{Code|style=2|{{Param|deck}}}}
| bgcolor="#3A3A3A" align="center" | {{Code|style=2|{{Param|os}}}}
| align="center" |Steam Deck support status, more value can be found on [[/testcases|testcases page]].
| bgcolor="#3A3A3A" align="center" |Supported OS for the game, software, etc..., more can be found on [[/testcases|testcases page]].
| {{CodeBlock|margin=5px|<nowiki>| deck = verified</nowiki>|type=game}}
| bgcolor="#3A3A3A" | {{CodeBlock|margin=5px|<nowiki>| os = win</nowiki>|type=game}}
| {{Software status|nocat=1|deck = verified|type=game}}
| bgcolor="#3A3A3A" | {{Software status|nocat=1|os = win|type=game}}
|-
|-
| align="center" | {{Code|style=2|{{Param|chromebook}}}}
<!--
| align="center" |'''(EXPERIMENTAL)''' Chromebook ready status, more value can be found on [[/testcases|testcases page]].
| bgcolor="#3A3A3A" align="center" | {{Code|style=2|{{Param|deck}}}}
| {{CodeBlock|margin=5px|<nowiki>| chromebook = playable </nowiki>|type=game}}
| bgcolor="#3A3A3A" align="center" |Steam Deck support status, more value can be found on [[/testcases|testcases page]].
| {{Software status|nocat=1|chromebook = playable|type=game}}
| bgcolor="#3A3A3A" | {{CodeBlock|margin=5px|<nowiki>| deck = verified</nowiki>|type=game}}
| bgcolor="#3A3A3A" | {{Software status|nocat=1|deck = verified|type=game}}
-->
|-
|-
| align="center" | {{Code|style=2|{{Param|3rdpartystore}}}}
| bgcolor="#3A3A3A" align="center" | {{Code|style=2|{{Param|3rdpartystore}}}}
| align="center" | Used to put 3rd party stores links. Works similarly to "note" parameters.<br>'''Recommended templates''': <br>{{t|gog}} <br>{{t|epic}} <br>{{t|gplay}} (for {{Nvidia|1}} Shield port), etc...<br> For spacing, use "•".
| bgcolor="#3A3A3A" align="center" | Used to put 3rd party stores links. Works similarly to "note" parameters.<br>'''Recommended templates''': <br>{{t|gog}} <br>{{t|epic}} <br>{{t|gplay}} (for {{Nvidia|1}} Shield port), etc...<br> For spacing, use "•".
| {{CodeBlock|margin=5px|<nowiki>| 3rdpartylinks={{gog|vampire_the_masquerade_bloodlines|GOG.com}}</nowiki>|type=game}}
| bgcolor="#3A3A3A" | {{CodeBlock|margin=5px|<nowiki>| 3rdpartylinks={{gog|vampire_the_masquerade_bloodlines|GOG.com}}</nowiki>|type=game}}
| {{Software status|nocat=1|appid=2600|deck = verified|type=game|3rdpartylinks={{gog|vampire_the_masquerade_bloodlines|GOG.com}}}}
| bgcolor="#3A3A3A" | {{Software status|nocat=1|appid=2600|deck = verified|type=game|3rdpartylinks={{gog|vampire_the_masquerade_bloodlines|GOG.com}}}}
|-
|-
| align="center" | {{Code|style=2|{{Param|note}}}}
| bgcolor="#3A3A3A" align="center" | {{Code|style=2|{{Param|note}}}}
| align="center" | Add custom notices.
| bgcolor="#3A3A3A" align="center" | Add custom notices.
| {{CodeBlock|margin=5px|<nowiki>| note=Lorem ipsum</nowiki>}}
| bgcolor="#3A3A3A" | {{CodeBlock|margin=5px|<nowiki>| note=Lorem ipsum</nowiki>}}
| {{Software status|nocat=1|appid=2600|deck = verified|type=game|note={{lorem}}}}
| bgcolor="#3A3A3A" | {{Software status|nocat=1|appid=2600|deck = verified|type=game|note={{lorem}}}}
|}
|}


Line 92: Line 102:
* Use {{code|<nowiki>{{Software status|type=game}}</nowiki>}} for:
* Use {{code|<nowiki>{{Software status|type=game}}</nowiki>}} for:
{{Software status|type=game|nocat=1}}
{{Software status|type=game|nocat=1}}
=== System Requirements<span id="Sysreq"><!--Used by Sysreq template, clicking on "See system requirements" will send you to this section.--></span> ===
If you have clicked on the ("'''See system requirements'''") button on the template, it should send you to this section.
=== Similar templates ===
* {{t|Package}} - For packages.


{{Note|To avoid slowing down loading times, see more examples on [[/testcases|Testcases page]].}}
{{Note|To avoid slowing down loading times, see more examples on [[/testcases|Testcases page]].}}

Latest revision as of 04:21, 19 June 2024

Edit-copy.png
This is a documentation subpage for Template:Software status.
Don't forget to purge the contents of the base page upon creating or editing this subpage.

This is a replacement of {{Game release}} template and variants of it, combining all of these into one. This will make it quicker to maintenance and any edit on this template will apply to all the pages, instead of having to edit multiple separate Template:Game release template.

The purpose of this template is to tell users whether the game is announced, delisted or currently available on Steam or not, plus whether the game is Steam Deck verified.

Usage (copy & paste)

For anything else

{{Software status | appid = <appid> | type = games <!-- games/mods/tools --> | free = no <!-- yes/no - "No" by default --> | status = released <!-- announced/released/delisted/delisted-dl/earlyaccess (ea)/in development (dev/indev) --> <!-- More values is available on testcases page. --> | os = all <!-- See template testcases for more values. If you want to hide this, leave the parameter blank. --> | note = <!-- Put any custom notice here. Optional. --> <!-- OTHER STOREFRONTS This is for games that did uses Valve engines (or closely related to it), that was sold or available for free outside Steam. Works similarly to "note" parameters. Beside that, you can also use this for console versions of the game sold on PlayStation Network (PS)/MS Store (Xbox) Do not use affiliate link as it's can affect users with adblockers. And remember to use "•" for spacing if there are sold in multiple other storefronts. --> | 3rdpartylinks = <!-- Example: "{{gog|vampire_the_masquerade_bloodlines|GOG.com}}" for VTMB (on GOG.com), "{{epic|quake|Epic Games}}" for Quake 1 (on Epic Games Store), etc... --> }}

System requirements section

To make the "See system requirements" button work, you must use this header:

Replace this: == System Requirements == with == System Requirements<span id="Sysreq"><!--Used by Sysreq template, clicking on "See system requirements" will send you to this section.--></span> ==

This will also works in other languages aswell, and in different text, as long if the "Sysreq" id is not changed. To add the System requirements template, see {{Sysreq}} for more info.

For announced games

See code
{{Software status | appid = <appid> | type = games | free = <!-- doesn't do anything with announced, but still useful --> | status = announced | deck = hide | website = <!-- Optional --> }}

To prevent categorization, add the following parameters:

| nocat = 1

Parameters and Examples

Parameter Description Value Previews
{{{type}}} Type of software, see more value on testcases page.
This must be specified.
| type = games
| type = mods
| type = tools

{{{appid}}} Set the AppID for the software
| appid = 220
{{{gamename}}}
{{{customgamename}}}
Set the custom game name.
{{{gamename}}} must be set to other, then you put the game name on {{{customgamename}}} parameters. Used on pages like Black Mesa Black Mesa.
| gamename = other
| customgamename = Black Mesa
{{{free}}} Is this software free?
If {{{free}}}=no or left blanks, mark the software as paid, if {{{free}}}=yes, mark it as a free software.
| free = yes/no
{{{status}}} Availability of the software, by default, it is marked as "available". If the game was delisted on Steam, set {{{status}}} to delisted
If this game is currently in Early Access, set {{{status}}} to ea or earlyaccess.
More value can be found on testcases/Availability page.
| status = delisted
| status = ea
| status = demo


{{{os}}} Supported OS for the game, software, etc..., more can be found on testcases page.
| os = win
{{{3rdpartystore}}} Used to put 3rd party stores links. Works similarly to "note" parameters.
Recommended templates:
{{gog}}
{{epic}}
{{gplay}} (for Nvidia Shield port), etc...
For spacing, use "•".
| 3rdpartylinks={{gog|vampire_the_masquerade_bloodlines|GOG.com}}
{{{note}}} Add custom notices.
| note=Lorem ipsum

Previews and testcases

  • Use {{Software status|type=game}} for:

System Requirements

If you have clicked on the ("See system requirements") button on the template, it should send you to this section.

Similar templates

Note.pngNote:To avoid slowing down loading times, see more examples on Testcases page.