Module:T-Process: Difference between revisions

// via Wikitext Extension for VSCode
// via Wikitext Extension for VSCode
 
(61 intermediate revisions by the same user not shown)
Line 1: Line 1:
--Module:T-Process
--Module:T-Process
-- Renders the "Process" template for governance processes and initiatives, making use of ICANNWiki's "Template Blueprint Framework"
-- Makes use of ICANNWiki's "Template Blueprint Framework" to render the "Process" template


local p = {}
local p = {}


-- ========== Required modules ==========
-- ==================== Required modules ====================
local Blueprint = require('Module:LuaTemplateBlueprint')
local Blueprint = require('Module:LuaTemplateBlueprint')
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')


-- Blueprint default: Module-level cache for lazy-loaded modules
-- ==================== Helper Functions ====================
local moduleCache = {}
-- Blueprint default: Create error context for the module
 
-- 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
 
-- ========== Helper Functions ==========
-- Create error context for the module
local errorContext = ErrorHandling.createContext("T-Process")
local errorContext = ErrorHandling.createContext("T-Process")


Line 33: Line 19:
local template = Blueprint.registerTemplate('Process', {
local template = Blueprint.registerTemplate('Process', {
     features = {
     features = {
        -- Core rendering features
         title = true,
         title = true,
         logo = true,
         logo = true,
         fields = true,
         fields = true,
         socialMedia = true,
         socialMedia = true,
       
        -- Semantic features
         semanticProperties = true,
         semanticProperties = true,
         categories = true,
         categories = true,
          
         errorReporting = true,
         -- Error handling
         navigation = true
        errorReporting = true
     }
     }
})
})


-- Initialize the standard configuration
-- Blueprint default: Initialize standard configuration
Blueprint.initializeConfig(template)
Blueprint.initializeConfig(template)
-- CONTROL THE VISUAL ORDER THAT EACH ASPECT IS RENDERED IN
template.config.blockSequence = {
    'title',
    'logo',
    'fields',
    'navigation',
    'socialMedia',
    'semanticProperties',
    'categories',
    'errors'
}


-- ================================================================================
-- ================================================================================


-- ========== Preprocessors ==========
-- TEMPLATE-SPECIFIC CALLS AND CODE
-- Basic preprocessors
Blueprint.addPreprocessor(template, 'setPageIdField')
Blueprint.addPreprocessor(template, 'deriveRegionFromCountry')


-- Helper function to extract plain text from wiki links for semantic properties
-- ELEMENT:NAVIGATION
local TemplateHelpers = require('Module:TemplateHelpers')
if template.features.navigation then
local function extractSemanticValue(fieldValue, fieldName)
    local ElementNavigation = ErrorHandling.safeRequire(errorContext, 'Module:ElementNavigation', false)
    return TemplateHelpers.extractSemanticValue(fieldValue, fieldName, errorContext)
    if ElementNavigation and ElementNavigation.elementName then
        Blueprint.registerElement(ElementNavigation.elementName, ElementNavigation)
Blueprint.addElementToTemplate(template, 'navigation')
        template.config.navigation = {
            prevLabel = "← %s",
            nextLabel = "%s →",
            classPrefix = "process"
        }
    end
end
end


-- Skip the automatic process_connection property
-- ================================================================================
local processConnectionProperty = require('Module:ConfigRepository').semanticProperties.process_connection
template.config.semantics = template.config.semantics or {}
template.config.semantics.skipProperties = template.config.semantics.skipProperties or {}
template.config.semantics.skipProperties[processConnectionProperty] = true


-- Preprocessor for semantic property extraction
-- ==================== Preprocessors ====================
Blueprint.addPreprocessor(template, function(template, args)
-- Basic preprocessors
    -- Extract values for process connections
Blueprint.addPreprocessor(template, 'setPageIdField')  -- Blueprint default
    args._processConnection = extractSemanticValue(args.process, "Process")
Blueprint.addPreprocessor(template, 'deriveRegionFromCountry')
    args._previousConnection = extractSemanticValue(args.has_previous, "Preceded By")
    args._nextConnection = extractSemanticValue(args.has_next, "Succeeded By")
   
    -- Configure semantic properties to use extracted values
    template.config.semantics.properties = template.config.semantics.properties or {}
   
    -- Add our custom process connections using direct property mappings
    -- This is exactly how T-LibraryInterview.lua does it
    if args._processConnection and args._processConnection ~= "" then
        template.config.semantics.properties[processConnectionProperty] = "_processConnection"
    end
   
    -- Add additional mappings for previous and next connections if they exist
    if args._previousConnection and args._previousConnection ~= "" then
        -- Create a unique property name for each connection to avoid conflicts
        template.config.semantics.properties[processConnectionProperty .. "_prev"] = "_previousConnection"
    end
   
    if args._nextConnection and args._nextConnection ~= "" then
        -- Create a unique property name for each connection to avoid conflicts
        template.config.semantics.properties[processConnectionProperty .. "_next"] = "_nextConnection"
    end
   
    return args
end)


-- ========== Main Render Function ==========
-- ==================== Main Render Function ====================
-- Main render function which delegates to the template's render method
-- Blueprint default: Render
function p.render(frame)
function p.render(frame)
     return ErrorHandling.protect(
     return ErrorHandling.protect(