Module:T-Person: Difference between revisions

// via Wikitext Extension for VSCode
// via Wikitext Extension for VSCode
 
(36 intermediate revisions by the same user not shown)
Line 6: Line 6:
-- ==================== Required modules ====================
-- ==================== Required modules ====================
local Blueprint = require('Module:LuaTemplateBlueprint')
local Blueprint = require('Module:LuaTemplateBlueprint')
local TemplateHelpers = require('Module:TemplateHelpers')
local ErrorHandling = require('Module:ErrorHandling')
local ErrorHandling = require('Module:ErrorHandling')
local ConfigRepository = require('Module:ConfigRepository')
local LinkParser = require('Module:LinkParser')
local LinkParser = require('Module:LinkParser')
local Achievements = require('Module:AchievementSystem')
local Achievements = require('Module:AchievementSystem')
-- Blueprint default: Module-level cache for lazy-loaded modules
local moduleCache = {}
-- Blueprint default: Lazy module loader
local function lazyRequire(moduleName)
    return function()
        if not moduleCache[moduleName] then
            moduleCache[moduleName] = require(moduleName)
        end
        return moduleCache[moduleName]
    end
end
-- Blueprint default: Modules to lazy load
    -- local getTemplateHelpers = lazyRequire('')


-- ==================== Helper Functions ====================
-- ==================== Helper Functions ====================
-- Blueprint default: Create error context for the module
-- Blueprint default: Create error context for the module
local errorContext = ErrorHandling.createContext("T-Person")
local errorContext = ErrorHandling.createContext("T-Person")
-- Blueprint default: Helper for extracting semantic values from wiki links
local function extractSemanticValue(fieldValue, fieldName)
    return TemplateHelpers.extractSemanticValue(fieldValue, fieldName, errorContext)
end


-- ================================================================================
-- ================================================================================
Line 41: Line 18:
-- IMPORTANT! TEMPLATE BLUEPRINT FRAMEWORK INSTRUCTIONS
-- IMPORTANT! TEMPLATE BLUEPRINT FRAMEWORK INSTRUCTIONS
-- CONTROL OF TEMPLATE FEATURES: THIS LIST SPECIFIES IN AN EXPLICIT MANNER WHAT FEATURES ARE TO BE CALLED/RENDERED BY THE TEMPLATE.
-- CONTROL OF TEMPLATE FEATURES: THIS LIST SPECIFIES IN AN EXPLICIT MANNER WHAT FEATURES ARE TO BE CALLED/RENDERED BY THE TEMPLATE.
local template = Blueprint.registerTemplate('Person2', {
local template = Blueprint.registerTemplate('Person', {
     features = {
     features = {
         title = true,
         title = true,
        achievementHeader = true,
        portraitCarousel = true,
         logo = true,
         logo = true,
         fields = true,
         fields = true,
        achievementBadges = true,
         socialMedia = true,
         socialMedia = true,
         semanticProperties = true,
         semanticProperties = true,
Line 59: Line 39:
template.config.blockSequence = {
template.config.blockSequence = {
     'title',
     'title',
    'achievementHeader',
    'portraitCarousel',
     'logo',
     'logo',
     'fields',
     'fields',
    'achievementsSectionHeader',
    'achievementBadges',
     'socialMedia',
     'socialMedia',
     'semanticProperties',
     'semanticProperties',
Line 71: Line 55:
-- TEMPLATE-SPECIFIC CALLS AND CODE
-- TEMPLATE-SPECIFIC CALLS AND CODE


-- ELEMENTS GO HERE
-- BLOCK: ACHIEVEMENTS SECTION HEADER
-- Safely load element modules with ErrorHandling.safeRequire, then register them via Blueprint.addElementToTemplate(template, 'example')
local function renderAchievementsHeader(template, args)
    -- Get the current page ID from the arguments pre-filled by the 'setPageIdField' preprocessor
    local pageId = args.ID
    if not pageId or pageId == '' then
        return ''
    end
 
    -- Get badge achievements using the centralized function
    local badgeAchievements = Achievements.getBadgeAchievements(pageId, template.current_frame)
 
    -- Only render the header if there are badges to display
    if #badgeAchievements > 0 then
        local TemplateStructure = require('Module:TemplateStructure')
        return TemplateStructure.renderDividerBlock("Achievements")
    end


-- if template.features.navigation then
    return ''
--    local ElementExample = ErrorHandling.safeRequire(errorContext, 'Module:ElementNavigation', false)
end
--    if ElementExample and ElementExample.elementName then
template.config.blocks = template.config.blocks or {}
--        Blueprint.registerElement(ElementExample.elementName, ElementExample)
template.config.blocks.achievementsSectionHeader = {
--         Blueprint.addElementToTemplate(template, 'example')
    render = function(template, args)
--     end
         return renderAchievementsHeader(template, args)
-- end
     end
}


-- SPECIAL SEMANTIC MAPPINGS GO HERE
-- ELEMENT: ACHIEVEMENT HEADER
if template.features.achievementHeader then
    local ElementAchievementHeader = ErrorHandling.safeRequire(errorContext,
        'Module:ElementAchievementHeader', false)
    if ElementAchievementHeader then
        Blueprint.registerElement(ElementAchievementHeader.elementName, ElementAchievementHeader)
        Blueprint.addElementToTemplate(template, 'achievementHeader')
    end
end


-- ================================================================================
-- ELEMENT: ACHIEVEMENT BADGES
if template.features.achievementBadges then
    local ElementAchievementBadges = ErrorHandling.safeRequire(errorContext,
        'Module:ElementAchievementBadges', false)
    if ElementAchievementBadges then
        Blueprint.registerElement(ElementAchievementBadges.elementName, ElementAchievementBadges)
        Blueprint.addElementToTemplate(template, 'achievementBadges')
    end
end


-- ==================== Preprocessors ====================
-- ELEMENT: PORTRAIT CAROUSEL
-- Basic preprocessors
if template.features.portraitCarousel then
Blueprint.addPreprocessor(template, 'setPageIdField') -- Blueprint default
    local ElementPortraitCarousel = ErrorHandling.safeRequire(errorContext,
Blueprint.addPreprocessor(template, 'deriveRegionFromCountry')
        'Module:ElementPortraitCarousel', false)
    if ElementPortraitCarousel then
        Blueprint.registerElement(ElementPortraitCarousel.elementName, ElementPortraitCarousel)
       
        -- Add the element with a custom wrapper that creates a separate table row
        Blueprint.addElementToTemplate(template, 'portraitCarousel', {
            wrapperTemplate = '|-\n| colspan="2" class="person-portrait-row" |%s'
        })
    end
end


-- ==================== Custom Configuration ====================
-- PROCESSORS
-- Initialize processor functions for fields
template.config.processors = {
template.config.processors = {
     -- SOI field processor to format SOI as a link
     -- SOI field processor
     soi = function(value)
     soi = function(value)
         if value and value ~= "" then
         if value and value ~= "" then
             return string.format("[%s SOI]", value)
             return string.format("[%s Here]", value)
         end
         end
         return value
         return value
     end,
     end,
      
      
    -- Languages field processor with normalization
    languages = function(value)
        if not value or value == "" then return value end
       
        local NormalizationLanguage = require('Module:NormalizationLanguage')
        local languages = TemplateHelpers.splitMultiValueString(value)
        local normalized = {}
       
        for i, language in ipairs(languages) do
            normalized[i] = NormalizationLanguage.normalize(language) or language
        end
       
        return table.concat(normalized, "; ")
    end
}
}
-- ================================================================================
-- ==================== Preprocessors ====================
-- Basic preprocessors
Blueprint.addPreprocessor(template, 'setPageIdField')  -- Blueprint default
Blueprint.addPreprocessor(template, 'deriveRegionFromCountry')


-- ==================== Main Render Function ====================
-- ==================== Main Render Function ====================