ICANNWiki

Module:T-Process: Difference between revisions

← Older edit
MarkWD (talk | contribs)
Bureaucrats, Check users, Interface administrators, Administrators (Semantic MediaWiki), Curators (Semantic MediaWiki), Editors (Semantic MediaWiki), steward, Suppressors, Administrators, Temporary account IP viewers
25,069 edits
// via Wikitext Extension for VSCode
// via Wikitext Extension for VSCode
 
(60 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')
local TemplateHelpers = require('Module:TemplateHelpers')
local SemanticAnnotations = require('Module:SemanticAnnotations')
local SemanticCategoryHelpers = require('Module:SemanticCategoryHelpers')


-- ========== Helper Functions ==========
-- ==================== Helper Functions ====================
-- 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 23: 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')


-- Add a preprocessor to sanitize args for semantic properties
-- ELEMENT:NAVIGATION
-- This follows the same pattern as the Event template
if template.features.navigation then
Blueprint.addPreprocessor(template, function(template, args)
    local ElementNavigation = ErrorHandling.safeRequire(errorContext, 'Module:ElementNavigation', false)
     -- Create a sanitized version of args for semantic properties
     if ElementNavigation and ElementNavigation.elementName then
    args._sanitizedArgs = {}
        Blueprint.registerElement(ElementNavigation.elementName, ElementNavigation)
   
Blueprint.addElementToTemplate(template, 'navigation')
    -- Copy and sanitize all values
         template.config.navigation = {
    for k, v in pairs(args) do
            prevLabel = "← %s",
         if type(v) == "string" and v ~= "" then
            nextLabel = "%s →",
             args._sanitizedArgs[k] = TemplateHelpers.sanitizeUserInput(v)
             classPrefix = "process"
         else
         }
            args._sanitizedArgs[k] = v
        end
     end
     end
   
end
    -- Add special handling for has_previous and has_next
 
    if args.has_previous and args.has_previous ~= "" then
-- ================================================================================
        -- Extract the page name from wiki links if present
        args._sanitizedArgs.has_previous_process = TemplateHelpers.extractSemanticValue(
            args.has_previous, "Preceded By", errorContext)
    end
   
    if args.has_next and args.has_next ~= "" then
        -- Extract the page name from wiki links if present
        args._sanitizedArgs.has_next_process = TemplateHelpers.extractSemanticValue(
            args.has_next, "Succeeded By", errorContext)
    end
   
    return args
end)


-- Override the semanticProperties block to use our sanitized args
-- ==================== Preprocessors ====================
-- This is similar to how the Event template handles semantic properties
-- Basic preprocessors
Blueprint.registerPropertyProvider(template, function(template, args)
Blueprint.addPreprocessor(template, 'setPageIdField')  -- Blueprint default
    -- Get the sanitized args
Blueprint.addPreprocessor(template, 'deriveRegionFromCountry')
    local sanitizedArgs = args._sanitizedArgs or args
   
    -- Get the config
    local Config = template.config
   
    -- Set basic properties using the transformation functions from Config
    local properties = {}
    local semanticOutput = ""
   
    -- Use the standard SemanticAnnotations module
    local propertiesSuccess, propertiesResult = pcall(function()
        return SemanticAnnotations.setSemanticProperties(
            sanitizedArgs,
            Config.semantics.properties,
            {transform = Config.semantics.transforms}
        )
    end)
   
    if propertiesSuccess then
        semanticOutput = propertiesResult
    else
        -- Log error but continue
        semanticOutput = "<!-- Error setting semantic properties -->"
    end
   
    -- Handle special case for has_previous and has_next
    if sanitizedArgs.has_previous_process and sanitizedArgs.has_previous_process ~= "" then
        -- Add as a separate property
        local processConnectionProperty = require('Module:ConfigRepository').semanticProperties.process_connection
        semanticOutput = semanticOutput .. '\n<div style="display:none;">\n'
        semanticOutput = semanticOutput .. '  {{#set: ' .. processConnectionProperty .. '=' .. sanitizedArgs.has_previous_process .. ' }}\n'
        semanticOutput = semanticOutput .. '</div>'
    end
   
    if sanitizedArgs.has_next_process and sanitizedArgs.has_next_process ~= "" then
        -- Add as a separate property
        local processConnectionProperty = require('Module:ConfigRepository').semanticProperties.process_connection
        semanticOutput = semanticOutput .. '\n<div style="display:none;">\n'
        semanticOutput = semanticOutput .. ' {{#set: ' .. processConnectionProperty .. '=' .. sanitizedArgs.has_next_process .. ' }}\n'
        semanticOutput = semanticOutput .. '</div>'
    end
   
    -- Return empty properties but with semantic output
    return properties, semanticOutput
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(
Retrieved from "https://staging.icannwiki.org/Module:T-Process"