Module:HeroData/nav

Overview

Generates hero navigation cards

Functions

get_hero_nav_cards

For Template:Hero Navbox on Heroes, individual hero pages like Abrams, and the home page.

Examples

First with debug_mode on, to help visualize what the output's source looks like.

{{#invoke:HeroData/nav|get_hero_nav_cards
|text_size=13
|card_size=88
|in_herolabs=false
|debug_mode=true
}}

Now with debug_mode defaulted to false (off) to see actual visual output.

{{#invoke:HeroData/nav|get_hero_nav_cards
|text_size=13
|card_size=88
|in_herolabs=false
}}

Parameters

• text_size - Font size of the hero name
• card_size - Size of the hero card
• in_herolabs - Get hero labs heroes (there are none at the moment)
• debug_mode - (OPTIONAL) Defaults to false. With true, the output is raw wikitext source that isn't processed, allowing to see more clearly what is ran.

debug_mode is the only optional parameter. All other parameters are required. Template:Hero card2 utilizes this with some default values, see there for suggested values.

get_hero_roster

For Template:Roster on Heroes, generate a list using Template:HeroRosterCard.

get_hero_bulletpoints

For navboxes such as Template:Quotes Navbox, generate a bulletpoint list of heroes.

Add the name of a subpage to link to specific subpages. It will still display only the hero name but link to the subpage instead.

Add variable "no_redlinks=true" to hide red links (non-existent pages).

Examples

{{#invoke:HeroData/nav|get_hero_bulletpoints}}

To link to "/Movement" subpages:

{{#invoke:HeroData/nav|get_hero_bulletpoints|Movement}}

Hide redlinks:

{{#invoke:HeroData/nav|get_hero_bulletpoints|Movement|no_redlinks=true}}

---

local p = {}
local heroes_data = mw.loadJsonData("Data:HeroData.json")
local hero_release_module = require('Module:HeroData/release')
local lang_module = require('Module:Lang')

-- for [[Template:Deadlock_Wiki/Heroes]] on home page, i.e. [[Template:Hero card2]]
function p.get_hero_nav_cards(frame)
    local in_herolabs = frame.args['in_herolabs'] -- true or false
    local text_size = frame.args['text_size']
    local card_size = frame.args['card_size']
    local sticker_size = frame.args['sticker_size']
    local herolabs_text_size = frame.args['herolabs_text_size']
    local debug_mode = frame.args['debug_mode']
	
	local lang_code = lang_module.get_lang_code() -- Get the language code
    
    -- Turn debug_mode from string to bool, default to false
    if debug_mode == nil then
        debug_mode = false
    elseif debug_mode == 'true' then
         debug_mode = true
    elseif debug_mode == 'false' then
        debug_mode = false
    end

    if in_herolabs ~= 'true' and in_herolabs ~= 'false' then
        return 'in_herolabs must be either true or false'
    end
    
    -- Only add subpage if not English
    local subpage_str = ''
    if lang_code ~= 'en' then 
        subpage_str = '/' .. lang_code 
    end
    
    -- Iterate heroes
    local heroes = {}
    for hero_key, hero_data in pairs(heroes_data) do
        if hero_data["Name"] ~= nil then
            -- if herolabs is requested, only needs to have herolabs=true
            -- otherwise, needs to be not disabled, in development, and herolabs is nil or false
            local this_hero_status = hero_release_module.get_hero_release_status(hero_key)
            
            if this_in_herolabs == nil then this_in_herolabs = false end
            
            if ((in_herolabs == 'true' and this_hero_status == 'HeroLabs') or
                (in_herolabs == 'false' and this_hero_status == 'Released')) then
                
                local is_recommended = hero_data['IsRecommended']
                if is_recommended == nil then
                    is_recommended = false
                end
                
                -- ===== Create a sort key and store an object instead of a string =====
                local hero_name = lang_module.get_string(hero_key, nil, 'en')
                local sort_key = hero_name
                
                -- If the name starts with "The ", make the sort key the rest of the string
                if string.sub(sort_key, 1, 4) == "The " then
                    sort_key = string.sub(sort_key, 5) -- "Doorman"
                end

                local hero_wikitext = '|name=' .. hero_name .. 
                               '|link=' .. lang_module.get_string(hero_key, 'en') .. 
                               '|subpage=' .. subpage_str .. 
                               '|recommended=' .. tostring(is_recommended)
                
                table.insert(heroes, {sort_key = sort_key, wikitext = hero_wikitext})
            end
        end
    end
        
    -- ===== Use a custom sort function =====
    table.sort(heroes, function(a, b)
        return a.sort_key < b.sort_key
    end)
    
    -- Add each item to output
    local ret = ''
    -- ===== Access the wikitext property of the hero object =====
    for index, hero_object in ipairs(heroes) do
        ret = ret .. '{{Hero card2' .. hero_object.wikitext
        ret = ret .. '|text_size=' .. text_size
        ret = ret .. '|herolabs=' .. in_herolabs
        ret = ret .. '|card_size=' .. card_size
        ret = ret .. '|sticker_size=' .. sticker_size
        ret = ret .. '|herolabs_text_size=' .. herolabs_text_size
        ret = ret .. '}} '
    end
    
    -- Remove the last space
    ret = string.sub(ret, 1, -(string.len(' '))-1)
    
    if debug_mode then
        return ret
    else -- evaluate wikitext if not in debug mode
        return frame:preprocess(ret)
    end
end

return p