Module:T-Process: Difference between revisions

// via Wikitext Extension for VSCode
// via Wikitext Extension for VSCode
 
(71 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 ConfigRepository = require('Module:ConfigRepository')
local ErrorHandling = require('Module:ErrorHandling')
local ErrorHandling = require('Module:ErrorHandling')
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: 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 ==========
-- Blueprint default: Create error context for the module
-- Blueprint default: Create error context for the module
local errorContext = ErrorHandling.createContext("T-Process")
local errorContext = ErrorHandling.createContext("T-Process")
Line 42: Line 25:
         semanticProperties = true,
         semanticProperties = true,
         categories = true,
         categories = true,
         errorReporting = true
         errorReporting = true,
        navigation = 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


-- Get the SemanticCategoryHelpers module
-- ================================================================================
local SemanticCategoryHelpers = require('Module:SemanticCategoryHelpers')


-- Register a property provider using the new helper function
-- ==================== Preprocessors ====================
Blueprint.registerPropertyProvider(
-- Basic preprocessors
    template,
Blueprint.addPreprocessor(template, 'setPageIdField') -- Blueprint default
    SemanticCategoryHelpers.createCombinedPropertyProvider(
Blueprint.addPreprocessor(template, 'deriveRegionFromCountry')
        {"process", "has_previous", "has_next"}, -- Fields to combine
        require('Module:ConfigRepository').semanticProperties.process_connection, -- Property to set
        function(value, fieldName) -- Extractor function
            -- Extract plain text from wiki links
            local plainText = extractSemanticValue(value, fieldName)
           
            -- For a Page property, we need to ensure it's a valid page reference
            -- If the value doesn't already have wiki link syntax, add it
            if plainText and plainText ~= "" and not plainText:match("^%[%[.+%]%]$") then
                -- Format as a page reference
                return plainText -- Return plain text for SMW to handle properly
            end
           
            return plainText
        end,
        {propertyType = "Page"} -- Specify that this is a Page type property
    )
)
 
-- Add a debug property provider to see what values are being passed to SMW
Blueprint.registerPropertyProvider(template, function(template, args)
    local debugProperties = {}
   
    -- Add debug info as HTML comments
    local debugInfo = {}
    table.insert(debugInfo, "<!-- Process Template Debug Info -->")
    table.insert(debugInfo, "<!-- process: " .. tostring(args.process or "") .. " -->")
    table.insert(debugInfo, "<!-- has_previous: " .. tostring(args.has_previous or "") .. " -->")
    table.insert(debugInfo, "<!-- has_next: " .. tostring(args.has_next or "") .. " -->")
   
    -- Return empty properties but with debug output
    return debugProperties, table.concat(debugInfo, "\n")
end)


-- ========== Main Render Function ==========
-- ==================== Main Render Function ====================
-- Blueprint default: Main render function
-- Blueprint default: Render
function p.render(frame)
function p.render(frame)
     return ErrorHandling.protect(
     return ErrorHandling.protect(