Module:ElementAchievementHeader
Appearance
Documentation for this module may be created at Module:ElementAchievementHeader/doc
--[[
* Name: ElementAchievementHeader
* Author: Mark W. Datysgeld
* Description: Element module that renders achievement headers for Person templates and handles all title-type achievements
* Notes: Creates blocks for Blueprint framework; loads achievement data using AchievementSystem; filters for title-type achievements; renders with animated backgrounds using two-layer approach for readability; includes phantom row when no achievements found; protected execution with error handling
]]
local p = {}
p.elementName = "achievementHeader"
-- Load required modules
local ErrorHandling = require('Module:ErrorHandling')
local Achievements = require('Module:AchievementSystem')
-- Default configuration
p.defaultConfig = {
headerClass = "achievement-header"
}
-- Create block function
function p.createBlock()
return function(template, args)
-- Protected execution wrapper
local function execute()
local frame = mw.getCurrentFrame()
-- Get the current page ID
local pageId = mw.title.getCurrentTitle().id
if not pageId then
-- Include debug comment when no page ID available
return "<!-- Achievement Header: No page ID available -->"
end
-- CRITICAL: WE MUST PRE-LOAD THE JSON DATA WITH THE FRAME BEFORE GETTING ANY ACHIEVEMENTS
pcall(function()
Achievements.loadData(frame)
Achievements.loadTypes(frame)
end)
-- Now get the title achievement
local titleAchievement = Achievements.getTitleAchievement(pageId, frame)
-- Minimal debug comment only visible in source
local debugInfo = string.format(
"<!-- Achievement Header: pageId=%s -->",
pageId or "nil"
)
-- Always create a row for debugging purposes
if titleAchievement then
-- Get category link from the centralized function
local categoryLink = Achievements.getCategoryLinks({ { type = titleAchievement.id } }, frame)
-- Achievement found: create populated row with achievement data
return string.format(
'|-\n! colspan="2" class="achievement-header %s" data-achievement-id="%s" data-achievement-name="%s" | ' ..
'<div class="achievement-foreground-layer">%s</div>%s%s',
titleAchievement.id, titleAchievement.id, titleAchievement.name, titleAchievement.name, debugInfo, categoryLink
)
else
-- No achievement found: create empty phantom row
return string.format(
'|-\n! colspan="2" class="achievement-header-phantom" | ' ..
'<div class="achievement-foreground-layer"></div>%s',
debugInfo
)
end
end
-- Wrap with error handling
if template._errorContext then
return ErrorHandling.protect(
template._errorContext,
"ElementBlock_achievementHeader",
execute,
""
)
else
local ok, result = pcall(execute)
return ok and result or "<!-- Achievement Header: Protected execution failed -->"
end
end
end
return p