Module:Flags
Appearance
All the logics of Template:Flags are handled here. This module works together with Module:Flags/MasterData and Module:Flags/LocaleData, where the flags data is maintained.
Features
Functionality implemented:
- Full name in English or the locale language: "Andorra".
Andorra
- 2 letter code - link points to full name: "AD"
Andorra
- 3 letter code - link points to full name: "AND"
Andorra
- Nepal and Ohio flags are shown without border.
Nepal
Ohio
- When a name is not found in the list, attempts to offer a Commons image and a link e.g. "Berlin" or "WHO".
Berlin
WHO
- Size as in "size=44px" or "size=40x44px" can be defined in any position.
Andorra
Nepal
- Nepal, Switzerland and Vatican City have a default size of 20x17px (for the rest it's 20x22px):
Nepal
Switzerland
Vatican City
- Variants for historical flags "1901"
Afghanistan or "variant=1901" (for compatibility reasons)
Afghanistan
- Variants for labeled flags: "naval", "air force" and any other specified at FlagTranslations: "civil"
United Kingdom - "naval-RMAS"
United Kingdom
- Variant / label flags not found in FlagTranslations return the Flag of None but still point to the right article: "whatever"
Ohio - "quatsch"
Berlin
- Redirects (different names pointing to a same flag) are supported: "GB"
the United Kingdom - "UK"
the United Kingdom
- Full Commons filenames can be defined in tables when they don't follow the "Flag of " syntax: "File:Flag Belgium brussels"
Brussels-Capital Region
- Localization: "Illes Balears"
the Balearic Islands - "中華人民共和國" File:Flag of 中華人民共和國.svg China
- Localization + variants: "Afganistan" + "1901"
Afganistan - "Regne Unit" + "civil"
United Kingdom
- Flags listed only in FlagTranslations always link to the local language article: parameter "Native Peoples of Colombia" File:Flag of Pueblos Indígenas de Colombia.svg Native Peoples of Colombia links to "Pueblos Indígenas de Colombia"
Roadmap
- Performance testing.
- Extensive testing with copies of real pages, also for non-Latin scripts and Right-to-left languages.
- Cover the rest of functionality offered by other flag templates.
- Allow editors to define the year of the event, leaving to the template the task of finding the right flag.
local p = {}
-- Converts "Flag of" in a variable in order to accept images that don't follow this name schema
flagOf = "Flag_of_"
-- Loading the flag translations module --
local translations = mw.loadData("Module:Flags/LocaleData")
local master = mw.loadData("Module:Flags/MasterData")
-- Assigning the parameter to a flag and a link
function p.flag(territory)
-- Searching in the master table only.
-- 2 letter code search
if #territory.args[1] == 2 then
for flagParameter,commonsFile in pairs(master.twoLetter) do
if flagParameter == territory.args[1] then
commonsName = commonsFile
tempLink = commonsFile
end
end
for flagParameter,commonsFile in pairs(translations.fullName) do
if commonsFile == tempLink then
link = flagParameter
end
end
if link == nil then link = commonsName
end
end
-- 3 letter code search
if #territory.args[1] == 3 then
for flagParameter,commonsFile in pairs(master.threeLetter) do
if flagParameter == territory.args[1] then
commonsName = commonsFile
tempLink = commonsFile
end
end
for flagParameter,commonsFile in pairs(translations.fullName) do
if commonsFile == tempLink then
link = flagParameter
end
end
if link == nil then link = commonsName
end
end
-- Searching in FlagTranslations, then in FlagMaster
-- Full name search
if commonsName == nil then
flagTables = { translations.fullName, master.fullName, }
for k,v in ipairs(flagTables) do
for flagParameter,commonsFile in pairs(v) do
if flagParameter == territory.args[1] then
commonsName = commonsFile
link = flagParameter
elseif commonsFile == territory.args[1] then
commonsName = commonsFile
link = flagParameter
end
end
end
end
-- Fallback to Commons when the parameter doesn't have an entry in the table.
if commonsName == nil then
commonsName = territory.args[1]
link = territory.args[1]
end
-- Variant check for historical flags --
if territory.args[3] ~= "" then
variant = territory.args[3]
commonsName = master.variant[commonsName .. "|" .. variant]
flagOf=""
end
-- Label check --
if territory.args[2] ~= "{{{2}}}" then
variant = territory.args[2]
commonsName = master.variant[commonsName .. "|" .. variant]
flagOf = ""
end
-- Digesting Commons flag files not following the format "Flag of "
-- These filenamess must be preceded by "File:" in the table values.
if commonsName ~= nil and string.find( commonsName, "File:", 1 ) == 1 then
commonsName = string.sub( commonsName, 6)
flagOf = ""
end
-- Fallback for non-identified variant/label flags --
if commonsName == nil then
commonsName = "Flag of None"
end
-- Border for everybody except Nepal and Ohio
if commonsName == "Nepal" or commonsName == "Ohio" then
border = ""
else
border = "border|"
end
-- Size of flag --
-- Function to define the default size for the flag if needed
function defaultSize()
sizeExceptions = { "Nepal", "Switzerland", "the Vatican City", }
for some,exceptions in pairs(sizeExceptions) do
if commonsName == exceptions then
size = "20x17px"
end
end
if size == nil then
size = "20x22px"
end
return size
end
-- Checking whether a size parameter has been introduced, otherwise set default
if territory.args[4]:find("px", -2) ~= nil then
size = territory.args[4]
else
size = defaultSize(commonsName)
end
-- Text in addition to flag
text = ""
if territory.args[5] ~= "{{{text}}}" then
text = territory.args[5]
if text == "" then text = " [[" .. link .. "]]"
else link = text
text = " [[" .. territory.args[5] .. "]]"
end
end
return '[[File:' .. flagOf .. commonsName .. '.svg|' .. border .. 'link=' .. link .. '|'.. size .. ']]' .. text
end
return p