Kingwarz: Created page with "{{Module rating|protected}} {{High-use}} This module is used by the {{tl|Infobox song}} template to format the {{para|certification}} parameter and assign categories based on the certification level of a song. == Usage == The module is invoked within the {{tl|Infobox song}} template as follows:

 {{#invoke:SongCertifications|getCertification|certification={{{certification|}}}}}

The module processes the {{para|certification}} parameter and formats the output..."

2025-06-11T00:47:59Z

Created page with "{{Module rating|protected}} {{High-use}} This module is used by the {{tl|Infobox song}} template to format the {{para|certification}} parameter and assign categories based on the certification level of a song. == Usage == The module is invoked within the {{tl|Infobox song}} template as follows: <pre> {{#invoke:SongCertifications|getCertification|certification={{{certification|}}}}} </pre> The module processes the {{para|certification}} parameter and formats the output..."

New page

{{Module rating|protected}}
{{High-use}}
This module is used by the {{tl|Infobox song}} template to format the {{para|certification}} parameter and assign categories based on the certification level of a song.

== Usage ==
The module is invoked within the {{tl|Infobox song}} template as follows:
<pre>
{{#invoke:SongCertifications|getCertification|certification={{{certification|}}}}}
</pre>

The module processes the {{para|certification}} parameter and formats the output while adding appropriate categories:
* <code>Gold</code> (case-insensitive): Displays <code>[[Gold]] ●</code> and adds <nowiki>[[Category:Gold Songs]]</nowiki>.
* A number from <code>1</code> to <code>9</code>: Displays <code>Nx [[Platinum]] ▲</code> (e.g., <code>3x [[Platinum]] ▲</code> for <code>3</code>) and adds <nowiki>[[Category:Platinum Songs]]</nowiki>.
* A number <code>10</code> or higher: Displays <code>Nx [[Diamond]] ⬥</code> (e.g., <code>24x [[Diamond]] ⬥</code> for <code>24</code>) and adds <nowiki>[[Category:Diamond Songs]]</nowiki>.
* Invalid inputs (e.g., non-numeric values other than <code>Gold</code>, or numbers less than <code>1</code>): Displays the input as-is and adds <nowiki>[[Category:Songs with Invalid Certifications]]</nowiki>.

== Example ==
In an article using the {{tl|Infobox song}} template:
<pre>
{{Infobox song
| name = Example Song
| type = Major Hit Song
| artist = Example Artist
| album = Example Album
| released = January 1, 2020
| genre = Pop
| certification = 24
| rating = 4
}}
</pre>
This will display the certification as <code>24x [[Diamond]] ⬥</code> and add the article to <nowiki>[[Category:Diamond Songs]]</nowiki>.

== Notes ==
* The module is case-insensitive for <code>Gold</code> (e.g., <code>gold</code>, <code>GOLD</code> are accepted).
* Invalid inputs, such as <code>23x [[Diamond]] ⬥</code> or non-numeric values other than <code>Gold</code>, are displayed as entered and categorized in <nowiki>[[Category:Songs with Invalid Certifications]]</nowiki> for manual review.
* Ensure the categories (<nowiki>[[Category:Gold Songs]]</nowiki>, <nowiki>[[Category:Platinum Songs]]</nowiki>, <nowiki>[[Category:Diamond Songs]]</nowiki>, <nowiki>[[Category:Songs with Invalid Certifications]]</nowiki>) exist on the wiki to avoid redlinks.

== See also ==
* {{tl|Infobox song}} – The template that uses this module.
* [[Module:SongCategories]] – Handles type-based categories for the same template.

<includeonly>
[[Category:Template documentation]]
</includeonly>

Module:SongCertifications/doc - Revision history