Module:Badge display

Module documentation[view] [edit] [history] [purge]

Usage

Please rather use the template I've created to use this data. {{Template:Badge display}}.

Module:MilAward/data

EDITORS PLEASE NOTE: Be VERY careful that you understand exactly what you are doing if you edit the data in the subpage file. If in doubt, add a topic on the talk page or ping me User:BoonDock with your questions.

Structure

Note that I have set this up to use the structure: xx = {Code = "xx", Type = "", Description = "xx", Class="", Variation="", Image="XX", PageLink="XX", Country="ZAR", Note="", Org="SANDF", RecipCat="" },

• xx : the UNIQUE code we use to access this record.
• Description : Description to be used at the top of the display-box, so it will be used when producing the link
• class: intended to be for the class of the badge, it's turning out to be useful for other things as well
• Variation: Mainly whether it's cloth, metal etc. What it's made out of etc
• Image : File name of the file for the badge to be displayed
• PageLink  : Name of Wiki Article which the specific badge will link to
• Country.  : This should be obvious, but I haven't made a decision whether to use codes or country name
• org: Organisation
• RecipCat: Contents of this field are used as a category name. Not being used at the moment

Examples:

With different sizes:

You can also float left and right:

What this does is it provides the data to various routines which combine it in different ways.

When a template calls one of the routines in the module, the {{{size}}} is replaced with the second un-named parameter when the template is called. That is passed on to this module to set the size of the image.

The "PageLink" provides the name of an article on Wikipedia with no wikilinking. (In theory it could be a URL, but that's not preferred)

The contents of the Description field can be any text which can be used as shown in the examples. Please be careful with this. Using links or curly braces "{}" or inverted commas '' etc can break that entry as well as, potentially, the rest of the entries in the template.

How this works, is that the first unnamed parameter when you call the template is used as the value to look up the corresponding value in this list. Once that value has been found, then the fields in that line are available to the module. These fields are combined in different ways to produce the specific formatting required for the template that called this module.

For this reason, it's very important that this format is not broken or interfered with!

There are now named parameters.

• code: The code for the image
• size: Size of the image
• float: left, right or none

A NOTE ON COUNTRIES

Separation of countries didn't make sense. It is a lot easier to sort based on a field in the data

Let's please try to keep this as organised as possible. Search the file for your Country's name. If there isn't any mention of it, then create a heading using a comment for your country and add any relevant entries there. Within the country heading, not a bad idea to create sub-headings for different things.

NOTE: the data in this module is now self documenting.

The above documentation is transcluded from Module:Badge display/doc. (edit | history)
Editors can experiment in this module's sandbox (create | mirror) and testcases (edit) pages.
Subpages of this module.

local p = {}
local getArgs = require('Module:Arguments').getArgs
local http = require("luasocket")
local json = require("json")

function GetWidth(file)
    local url = "https://commons.wikimedia.org/w/api.php?action=query&titles=" .. file .. "&prop=imageinfo&iiprop=width&format=json"
    local response, status = http.request(url)
  
    if status ~= 200 then
      return nil, "Failed to retrieve image metadata"
    end
  
    local data = json.decode(response)
    local pages = data.query.pages
  
    for _, page in pairs(pages) do
      if page.imageinfo and page.imageinfo[1] and page.imageinfo[1].width then
        return tonumber(page.imageinfo[1].width)
      end
    end
  
    return nil, "Failed to retrieve image width"
  end


function p.DisplayImage(frame)
    -- Usage from a template etc:
    -- {{#invoke:BadgeDisplay|DisplayImage
    -- | image = NameOfImage.jpg
    -- | caption = Caption for the image
    -- | description = Description of the image
    -- | float = left/right/center
    -- | height = height in pixels or other units
    -- | width = width in pixels or other units
    -- | size = size in pixels or other units, e.g. "x25px"
    -- }}

    local args = getArgs(frame)

    -- Set default values for optional parameters
    local float = args.float or 'none'
    local size = args.size or '200'
	local imageName = args.image or ''

    -- local imageWidth = size 
    -- if not imageWidth then
    --    local imageTitle = mw.title.new(imageName)
    --    local imageInfo = imageTitle and mw.info or {}
    --    imageWidth = imageInfo.width or '200'
    --end
    local imageWidth, err = GetWidth('File:' .. imageName)
    -- if width then
    --  print("Width: " .. width)
    --else
    --  print("Error: " .. err)
    --end

    -- Build the wikitext table
    local wikitext = '{| class="wikitable" style="width:' .. (tonumber(imageWidth) * 1.1) .. 'px; margin:0 auto;border:none;"\n'
    wikitext = wikitext .. '|caption style="text-align:center;"|' .. (args.caption or 'No Caption') .. '\n|-\n'
    wikitext = wikitext .. '|style="text-align:center;border:none;"| [[File:' .. (args.image or 'No Image') .. '|' .. size .. ']]\n|-\n'
    --wikitext = wikitext .. '|style="text-align:center;"| [[File:' .. (args.image or 'No Image') .. ']]\n|-\n'
    wikitext = wikitext .. '|style="text-align:center;"|' .. (args.description or 'No Description') .. '\n|-\n'
    wikitext = wikitext .. '|}\n'
    wikitext = wikitext .. '=== Debug === \n'
    wikitext = wikitext .. '* float: ' .. float .. '\n'
    wikitext = wikitext .. '* height: ' .. height .. '\n'
    wikitext = wikitext .. '* width: ' .. width .. '\n'
    wikitext = wikitext .. '* size: ' .. size .. '\n'
    wikitext = wikitext .. '* imageName: ' .. imageName .. '\n'
    wikitext = wikitext .. '* imageWidth: ' .. imageWidth .. '\n'

    return wikitext
end

return p