This is the template sandbox page for Template:Flagg (diff). See also the companion subpage for test cases. |
This template is used on approximately 22,000 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them.
Preview message: Transclusion count updated automatically (see documentation). |
This template uses Lua: |
{{Flagg}}
(flag general) is a flag template with variable output format. Using Lua instead of the standard mechanism, it allows overriding the image name and link target, and works even if a country data template for an entity does not exist (without using any expensive functions).
The template is not intended to fully supersede any specific flag templates it can simulate (see below), but can be useful for formats for which no template exists, or if its additional options are needed. It can also be used in conjunction with Module:Flag to reduce post-expand include size of pages with lots of templates.
Aliases (alternatives) for each parameter or value are given in square brackets.
The first parameter is an alphabetic code specifying the output format. The first letter concerns the image, the second the separator, and the third the country name. The parameter is fully case-insensitive.
If any position in the parameter value is missing or has a character not corresponding to an option below, the options marked as default will be used; e.g. a first parameter equal to i
, i**
or izz
will be read as isc
.
First letter: Image
Letter | Meaning | Description | Example |
---|---|---|---|
u |
unlinked | Image is not linked (default). | {{flagg|uxx|France}} →
|
c |
country | Image links to country/entity page. | {{flagg|cxx|France}} →
|
p [f ] |
prefix/suffix | Image links to country name with prefixed and/or suffixed text (default "Flag of ..."), set using |pref= and |suff= (see below). |
{{flagg|pxx|France}} →
|
i |
image page | Image links to file description page; use this for non-public-domain images, for which attribution is required. | {{flagg|ixx|France}} →
|
d |
data template | Image links to the used country data template, for use in discussion/documentation. Automatically adds redirect=no if link is a redirect. |
{{flagg|dxx|France}} →
|
x |
X mark | No image is displayed. If the second letter is anything other than x , and o is not set, an unlinked transparent image is actually used to preserve the spacing. |
{{flagg|xnx|France}} →
|
Second letter: Separator
Letter | Meaning | Description | Example | |
---|---|---|---|---|
s |
span box | The flag image is put in a fixed-width <span> tag, meaning the country names are aligned in vertical lists; see documentation of {{Flaglist}} (default). | {{flagg|usu|Niger}} → Niger
| |
n |
non-breaking space | A non-breaking space ( ) is used, like in most flag templates, including {{flag}}. Note that does not actually prevent wrapping between image and text in all browsers; use w as described below if needed. |
{{flagg|unu|Niger}} → Niger
| |
l |
line break | A line break (<br/> ) is used as separator. |
{{flagg|ulu|Niger}} → Niger | |
t |
table cell | A table cell separator (two pipes) is used. | Niger | |
x |
X mark | No separator is used. | {{flagg|uxu|Niger}} → Niger
|
Third letter: Name
Letter | Meaning | Description | Example |
---|---|---|---|
c |
country | The country name links to the main country/entity page (default). | {{flagg|xxc|Chile}} → Chile
|
p |
prefix/suffix | The country name links to the country page with prefixed or suffixed text (default "Flag of ..."), set using |pref= and |suff= (see below). |
{{flagg|xxp|Chile}} → Chile
|
f |
full prefix/suffix | Same as p , except that the prefix and/or suffix is/are displayed. |
{{flagg|xxf|Chile}} → Flag of Chile
|
l |
link target | Same as p , except that the target of the link is displayed. |
{{flagg|xxl|Chile|avar=army}} → Chilean Army
|
b |
both country and prefix/suffix | Combined country link and prefix/suffix link: country name links to country page, while prefix and/or suffix link(s) to prefixed/suffixed title. | {{flagg|xxb|Chile}} → Flag of Chile
|
u |
unlinked (cf. {{flagu}}) | The country name is displayed as plain text, without link. | {{flagg|xxu|Chile}} → Chile
|
d |
data template | Country name is linked to the used country data template, for use in discussion/documentation. Automatically adds redirect=no if a redirect is used. |
{{flagg|xxd|Chile}} → Chile
|
a |
abbreviation | Country name is not linked, but the name of the main country/entity page is presented as mouseover text if it is different. | {{flagg|xxa|Chile}} → Chile{{flagg|xxa|CHI}} → CHI
|
x |
X mark | No text is displayed. | {{flagg|xxx|Chile}} →
|
* |
Add * | Similar to "p", except that an asterisk (*) is added to the text of the link if it goes to a more specific article. | {{flagg|xx*|Chile}} → Chile *
|
Some additional options can be enabled by appending the following letters to the three-letter code in any order:
Letter | Description | Example |
---|---|---|
a |
Adds the country name (the "name" parameter, or if unset the second unnamed parameter) as alt text and mouseover for the image. If |alt= is used for a custom alt/mouseover text, this does not need to be separately set. |
{{flagg|uxxa|Pakistan}} →
|
b |
Blanks the text portion if a flag is not found. | {{flagg|uncb|Xanadu}} → Compare with: {{flagg|unc|Xanadu}} → Xanadu
|
e |
Uses the name set in the country data template (rather than the first parameter) as display name, like in {{flag country}} (i.e. expands abbreviated forms). | {{flagg|unue|PAK}} → Pakistan
|
f |
If the prefixed/suffixed article name doesn't exist, fallback to linking to the non-prefixed/suffixed page. This may be expensive, and the number of time it can be used on single page is limited. | {{flagg|psff|Egypt|pref=Flag templates in}} → Flag templates in EgyptCompare with: {{flagg|psf|Egypt|pref=Flag templates in}} → Flag templates in Egypt
|
i |
Uses the IOC country codes table from Module:Country alias/data to resolve the country data from the entity parameter. | {{flagg|uxxi|BRN}} → Compare with: {{flagg|uxx|BRN}} →
|
l |
Adds the link name (as defined by the "image" parameter) as alt text and mouseover for the image. If |alt= is used for a custom alt/mouseover text, this does not need to be separately set. |
{{flagg|cxxl|PAK}} → Compare with: {{flagg|cxxa|PAK}} →
|
o |
Omits the image and spacing in case the image is an invisible placeholder, i.e., only include the spacing if a flag is displayed. Useful for inline/standalone usages or horizontal lists, where name alignment is not needed. | {{flagg|unuo|Pakistan|image=}} → PakistanCompare with: {{flagg|unu|Pakistan|image=}} → Pakistan
|
p |
Wraps the text in Parentheses. | {{flagg|unup|Pakistan}} → (Pakistan)
|
r |
Reverses the order of the elements, putting the image to the right of the name; cf. {{flagright}}. Doesn't affect the order of letters in the format code. | {{flagg|uncr|Pakistan}} → Pakistan
|
w |
Avoids wrapping by adding <span class="nowrap">...</span> around the output. |
{{flagg|unuw|Pakistan}} → Pakistan
|
t |
Aligns to the left in a table. |
The second parameter is the country or entity name. The template attempts to read the flag and link data from "Template:Country data country"; if that does not exist, the same parameter will be used as default country link and no automatic image will be displayed. The parameter also defines the default displayed country name, if the e option above is not used.
|variant=
[third unnamed parameter]{{flagg|ixx|Germany|naval}}
→ uses the "naval" variant of Template:Country data Germany.|image=
|size=
[|sz=
]|border=
|border=
can be set to "yes" ["y", "1"] to force a border when excluded by default, or "no" ["n", "0", empty string] to prevent one.|align=
[|al=
]|width=
[|w=
]|alt=
|ilink=
|noredlink=no
notext
, no text will be displayed alongside the red link. Defaults to "yes" (no red link displayed).|missingcategory=category name
|name=
|clink=
[|link=
]|pref=
, |suff=
, |plink=
|pref=
and |suff=
set the prefix and suffix to use for the prefix/suffix links (format letters f, p and b). The default, if neither is specified, is "Flag of" as prefix (cf. {{flagof}}) and no suffix. |plink=
can be used to override the combined link.|the=
{{flagg|usf|Philippines|the=1}}
→ Flag of the Philippines. Use |pthe=
if the link needs "the" but the name doesn't, and |nthe=
if the name needs it but the link doesn't.|section=
|csection=
for a section of the country article, and |psection=
for a section of the prefixed/suffixed article.|altvar=
[|avar=
], |age=
{{flagg|usp|Ireland|avar=ru}}
→ Ireland uses the IRFU flag to represent the Irish rugby union team. For youth teams in some sports (see the data page), the age limit must be additionally set using |age=
.|nalign=
[|nal=
]|align=
.|preftext=
 
unless the x or n separator options are specified (in which case it will use nothing or a line break, respectively).|text=
|nodata=y
{{country data ...}}
template, which is useful when the corresponding data template doesn't exist.|pref2=
, |suff2=
, |plink2=
, |psection2=
Formats:
{{flagg|usc|Fiji}}
→ Fiji (default format){{flagg||Fiji}}
→ Fiji (default format){{flagg|pnbr|Fiji}}
→ Flag of Fiji <span style="display:inline-block;text-align:center;">{{flagg|ilf|Fiji|sz=xl}}</span>
→ Table format & alignment:
{{flagg|utu|Jamaica}} |
Jamaica | |
{{flagg|utur|Jamaica}} |
Jamaica | |
{{flagg|utu|Jamaica|al=l|nal=l}} |
Jamaica | |
{{flagg|utu|Jamaica|al=c|nal=c}} |
Jamaica | |
{{flagg|utu|Jamaica|al=r|nal=r}} |
Jamaica |
{{flagg|usu|Switzerland}}
→ Switzerland{{flagg|usu|Switzerland|al=l}}
→ Switzerland{{flagg|usu|Switzerland|al=c}}
→ Switzerland{{flagg|usu|Switzerland|al=r}}
→ SwitzerlandStandard image & name parameters:
{{flagg|isc|Myanmar}}
→ Myanmar{{flagg|isc|Myanmar|border=}}
→ Myanmar{{flagg|isc|Myanmar|1974}}
→ Myanmar{{flagg|isc|Myanmar|variant=1974}}
→ Myanmar{{flagg|isc|Myanmar|name=Burma|variant=1974}}
→ Burma{{flagg|isc|Burma|variant=1974}}
→ Burma{{flagg|isc|Myanmar|sz=30}}
→ Myanmar{{flagg|isc|Myanmar|size=30}}
→ Myanmar{{flagg|isc|Myanmar|size=30px}}
→ Myanmar{{flagg|isc|Myanmar|size=30x18px}}
→ Myanmar{{flagg|isc|Myanmar|size=xs}}
→ Myanmar{{flagg|isc|Myanmar|size=xl}}
→ Myanmar{{flagg|isc|Myanmar|width=30|size=xs}}
→ Myanmar{{flagg|isc|Myanmar|image=}}
→ Myanmar{{flagg|isc|Myanmar|image=Flag of None.svg}}
→ Myanmar{{flagg|isc|Myanmar|image=File:Flag of None.svg}}
→ MyanmarLinks and altvars:
{{flagg|psp|Egypt}}
→ Egypt{{flagg|psf|Egypt}}
→ Flag of Egypt{{flagg|psb|Egypt}}
→ Flag of Egypt{{flagg|psb|Philippines|the=1}}
→ Flag of the Philippines{{flagg|csc|Egypt|section=History}}
→ Egypt{{flagg|csb|Egypt|csection=History}}
→ Flag of Egypt{{flagg|psb|Egypt|psection=Kingdom of Egypt (1922–1953)|variant=1922}}
→ Flag of Egypt{{flagg|psb|Egypt|plink=List of Egyptian flags}}
→ Flag of Egypt{{flagg|psf|Egypt|pref=History of}}
→ History of Egypt{{flagg|psp|Egypt|suff=at the Olympics}}
→ Egypt{{flagg|psp|Egypt|avar=fb}}
→ Egypt{{flagg|psp|Egypt|avar=football}}
→ Egypt{{flagg|psp|Egypt|avar=fbu|age=20}}
→ Egypt{{flagg|psl|Egypt|avar=navy}}
→ Egyptian Navy{{flagg|unapi|EGY|preftext=Sara Ahmed}}
→ Sara Ahmed (EGY)Non-existing data template:
{{flagg|isc|EUSSR|nodata=1}}
→ EUSSR{{flagg|isc|EUSSR|image=EUSSR red flag.svg|size=xl|nodata=1}}
→ EUSSRFor example:
Once you have a table with {{flaglist}}, and/or other flag template such as {{flag}}, it is easy to convert the links to specialized links. So instead of Oklahoma you would have Incarceration in Oklahoma, or if that article does not exist, then Crime in Oklahoma.
This works with full country or US state names. Also with abbreviated (3-letter) country names, and abbreviated (2-letter) US state names.
Use a global find-and-replace as previously described, but without regular expressions. Replace:
{{flag|
{{flaglist|
with
{{flagg|us*eft|pref=Incarceration in|pref2=Crime in|
The bar after flag or flaglist is necessary to avoid problems in case you have to replace 2 flag templates.
The {{flagg}} template looks for the articles. If it finds one of the two choices it adds the link and an asterisk after the location name. If it does not find either article, it just adds the standard link.
Substitute your preferred topics in the pref= and pref2= spots.
{{flagg|us*eft|
usually left aligns the text of that column (due to the "t" at the end of the code). For some unknown reason that is not always true. In that case each cell in that column will need style=text-align:left
in it. Or use the whole column code described here: #Column alignment and here: {{Table alignment}}. See example table.
Washington, D.C. - Have to force the full name to be shown:
{{flagg|us*eft|pref=Crime in|Washington, D.C.|name=Washington, D.C.}}
This particular use of {{flagg}} parameters is expensive and can only be used on a few hundred links per article. Every time the article is saved it occurs, even for null edits. So only one big country table per article. Other country tables in the same article should use standard links.
In List of countries by incarceration rate the {{flagg}} template creates a link to Incarceration in United States. That link is a redirect to Incarceration in the United States. Add "the" as necessary to create redirect pages. Admins will delete redirects that are not linked from within Wikipedia. So if you need to create redirects be sure to use them right away in an article table. Or keep them in a sandbox that the admins can see until you use them in an article table. See examples. See list.
{{Flagg}} removes the names of the countries behind territories, subnational areas, etc.. This makes for more compact tables. Other flag templates (such as {{flaglist}}) do not do that. But that template can not create specialized country links.
See Global Search at Toolforge. Search for
"{{flagg|us*eft" - in quotes. To get transclusion count and list of articles.
The {{flagg}} template does not work if colspan is used before the country/state name. {{flag+link}} works. See: Template talk:Flagg#Does not work with colspan. See section farther down for {{flag+link}} info: #Without asterisks. Only one preference.
These "specialized" templates predate Flagg, and while most do not have options for custom links and images, they are probably faster because they only do two transclusions without invoking Lua.
Template | Corresponding {{flagg}} syntax |
Example |
---|---|---|
{{flag|country}} |
{{flagg|uncb|country}} |
{{flag|China}} → China{{flagg|unc|China}} → China
|
{{flagbig|country}} |
{{flagg|ulc|country|sz=l}} |
{{flagbig|China}} → China {{flagg|ulc|China|sz=l}} → China |
{{flagc|country}} |
{{flagg|inc|country}} |
{{flagc|China}} → China{{flagg|inc|China}} → China
|
{{flag country|country}} |
{{flagg|unce|country}} |
{{flag country|CHN}} → China{{flagg|unce|CHN}} → China
|
{{flag decoration|country}} |
{{flagg|uxxo|country}} |
{{flag decoration|China}} → {{flagg|uxx|China}} →
|
{{flag icon|country}} |
{{flagg|cxxlo|country}} |
{{flag icon|China}} → {{flagg|cxxlo|China}} →
|
{{flagicon image|image}} |
{{flagg|uxx|image=image}} |
{{flagicon image|Flag of China.svg}} → {{flagg|uxx|image=Flag of China.svg}} →
|
{{flag link|country|suffix}} |
{{flagg|unpe|country|suff=suffix}} |
{{flag link|China|at the Hopman Cup}} → China{{flagg|unpe|China|suff=at the Hopman Cup}} → China
|
{{flag+link|prefix|country}} |
{{flagg|unpe|country|pref=prefix}} (no existence check){{flagg|unpef|country|pref=prefix}} (expensive) |
{{flag+link|Agriculture in|China}} → China{{flagg|unpe|China|pref=Agriculture in}} → China{{flagg|unpef|China|pref=Examples in}} → China
|
{{flaglist|country}} |
{{flagg|usc|country}} |
{{flaglist|China}} → China{{flagg|usc|China}} → China
|
{{flagof|country}} |
{{flagg|unp|country|sz=l}} |
{{flagof|China}} → China{{flagg|unp|China|sz=l}} → China
|
{{flagright|country}} |
{{flagg|uncr|country}} |
{{flagright|China}} → China {{flagg|uncr|China}} → China
|
{{flagu|country}} |
{{flagg|unu|country}} |
{{flagu|China}} → China{{flagg|unu|China}} → China
|
{{noflag|country}} |
{{flagg|xnu|country}} |
{{noflag|China}} → China{{flagg|xnu|China}} → China
|
{{noflag|[[country]]}} |
{{flagg|xnc|country}} |
{{noflag|[[China]]}} → China{{flagg|xnc|China}} → China
|
The football templates are used as examples here; other sports that have separate templates work correspondingly.
Template | Corresponding {{flagg}} syntax |
Example |
---|---|---|
{{fb|country}} |
{{flagg|unpe|country|avar=fb}} |
{{fb|China}} → China{{flagg|unpe|China|avar=fb}} → China
|
{{fb|country|align=1}} |
{{flagg|uspe|country|avar=fb|al=c}} |
{{fb|China|align=1}} → China{{flagg|uspe|China|avar=fb|al=c}} → China
|
{{fb-big|country}} |
{{flagg|ulpe|country|avar=fb|sz=l}} |
{{fb-big|China}} → China {{flagg|ulpe|China|avar=fb|sz=l}} → China |
{{fb-rt|country}} |
{{flagg|unpre|country|avar=fb}} |
{{fb-rt|China}} → China {{flagg|unpre|China|avar=fb}} → China
|
{{fbicon|country}} |
{{flagg|pxxl|country|avar=fb}} |
{{fbicon|China}} → {{flagg|pxxl|China|avar=fb}} →
|
{{fbu|age|country}} |
{{flagg|unpe|country|avar=fbu|age=age}} |
{{fbu|17|China}} → China{{flagg|unpe|China|avar=fbu|age=17}} → China
|
{{fbw|country}} |
{{flagg|unpe|country|avar=fbw}} |
{{fbw|China}} → China{{flagg|unpe|China|avar=fbw}} → China
|
{{fbwu|age|country}} |
{{flagg|unpe|country|avar=fbwu|age=age}} |
{{fbwu|17|China}} → China{{flagg|unpe|China|avar=fbwu|age=17}} → China
|
{{army|country}} |
{{flagg|unl|country|avar=army}} |
{{army|China}} → People's Liberation Army Ground Force{{flagg|unl|China|avar=army}} → People's Liberation Army Ground Force
|
{{navy|country}} |
{{flagg|unl|country|avar=navy}} |
{{navy|China}} → People's Liberation Army Navy{{flagg|unl|China|avar=navy}} → People's Liberation Army Navy
|
{{air force|country}} |
{{flagg|unl|country|avar=air force}} |
{{air force|China}} → People's Liberation Army Air Force{{flagg|unl|China|avar=air force}} → People's Liberation Army Air Force
|
{{armed forces|country}} |
{{flagg|usl|country|avar=military}} |
{{armed forces|China}} → People's Liberation Army{{flagg|usl|China|avar=military}} → People's Liberation Army
|