Jump to content

Module:Contentious topics talk banner

Permanently protected module
From Wikipedia, the free encyclopedia

local p = {}
local TableTools = require('Module:TableTools')
local yesno = require('Module:Yesno')
local setToList = require('Module:Set to list')
local restrictionsDatabase = mw.loadJsonData("Template:Contentious topics/Additional restrictions.json")
local restrictionsDefinition = mw.loadJsonData("Template:Contentious topics/Restrictions definition.json")
local standardSet = mw.loadJsonData("Template:Contentious topics/Standard set.json")
local categoryDatabase = mw.loadJsonData("Template:Contentious topics/Category database.json")

local function collectTopics(args)
    local seen = {}
    local topics = {}

    local function add(value)
        if value then
            value = mw.text.trim(value)
            if value ~= '' and not seen[value] then
                seen[value] = true
                table.insert(topics, value)
            end
        end
    end

    -- Primary topic params
    add(args.topic)
    add(args.t)
    add(args[1])

    -- Additional topics via numbered forms
    for i = 2, 10 do
        add(args[i])
        add(args['t' .. i])
        add(args['topic' .. i])
    end

    return topics
end

function p.main(frame)
    local args = require('Module:Arguments').getArgs(frame)
    local topics = collectTopics(args)
    local restrictions = {} -- A list of which restrictions are enabled for easier iteration
    local restrictionFlags = {} -- Track which restrictions are enabled, as a set
    local currentTitleObject = mw.title.getCurrentTitle()
    local subjectTitleObject = currentTitleObject.subjectPageTitle
    local underRestrictions -- a boolean for whether there are any active restrictions
    local articleOrPage -- the string "article" (if a mainspace page) or "page" (if not)
    local protectionLevel -- the edit protection level
    local messageBody -- the text within the message box
	local messageBox -- the message box itself
	local categories = '' -- initialize categories
	local manualRestrictions = false -- have we set any restrictions via |parameters?
	local section = yesno(args.section) or yesno(args.relatedcontent) -- whether we are a section
	
	--[[
	This area sets active restrictions
	The end goal is to get the restrictions variable into a nice, neat, sorted list of which restrictions are active
	This is a somewhat intense process
	--]]
	
    -- Helpers to add a restriction if it's active and hasn't been added yet
	local function maybeAddRestriction(restriction)
		if yesno(args[restriction]) then
			restrictionFlags[restriction] = true
			manualRestrictions = true
		end
	end
	
	local function alwaysAddRestriction(restriction)
		restrictionFlags[restriction] = true
	end
	
    -- Add the always-available restrictions
    for _, r in ipairs(standardSet) do
    	maybeAddRestriction(r)
    end

    -- Topic-based restrictions
    for _, topic in ipairs(topics) do
        local topicWide = restrictionsDatabase["topic-wide"][topic]
        if topicWide then
            for _, restriction in ipairs(topicWide) do
                alwaysAddRestriction(restriction)
            end
        end

        local additional = restrictionsDatabase["additional-available"][topic]
        if additional then
            for _, restriction in ipairs(additional) do
                maybeAddRestriction(restriction)
            end
        end
    end
    
    -- Add the protection level
    protectionLevel = subjectTitleObject.protectionLevels["edit"][1]
    if protectionLevel then
    	-- we have page protection
    	-- so we check if ECR is active, and if so only care about full protection
    	if restrictionFlags["ECR"] then
    		if protectionLevel == "full" then alwaysAddRestriction("full") end
    	else
    		alwaysAddRestriction(protectionLevel)
		end
    end
    
    --[[
    Clear duplicate restrictions (e.g. 0RR and 1RR; consensus-required is stronger than BRD)
	--]]
    
	-- if 0RR, then clear 1RR
	if restrictionFlags["0RR"] then
		restrictionFlags["1RR"] = nil
	end

	-- clear BRD if consensus-required is enabled
	if restrictionFlags["consensus-required"] then
		restrictionFlags["BRD"] = nil
	end
	
	-- and finally, convert our set to a list to make it easy to work with
	
    restrictions = setToList(restrictionFlags)
    
	--[[
	Restrictions are now all set. Here, we add additional helper functions and variables necessary for generating the banner
	--]]
	
    -- Check whether any of the added restrictions are enabled
    underRestrictions = #restrictions > 0 or args.other
    
    -- Determines whether we should use the string "article" or "page"
    local articleOrPage = currentTitleObject:inNamespaces(1) and "article" or "page"
	
	-- helper to add a category
	local function addCategory(cat)
		if cat then
			categories = categories .. '[[Category:' .. cat .. '|' .. currentTitleObject.text .. ']]'
		end
	end

	-- Makes a bullet point for a given contentious topic
    local function makeTopicBulletPoint(code)
    	topicBlurb = frame:expandTemplate{ title = "Contentious topics/list", args = { scope=code } }
    	if topicBlurb == '' then
    		addCategory(categoryDatabase['bad-topic'])
    		return ''
    	else 
	        return '* <b>' .. topicBlurb .. '</b>\n'
	    end
    end
	
	-- Makes a restriction bullet point
    local function makeRestrictionBulletPoint(code)
        local def = restrictionsDefinition[code]
        return def and ('* <b>' .. def .. '</b>\n') or ''
    end
	
	--[[
	Place into an error category if not given a contentious topic code
	--]]
	if #topics == 0 then
		addCategory(categoryDatabase['no-topic'])
	end
	
	--[[
	Begin building the messageBody
	--]]
	
    messageBody = '<b>The [[Wikipedia:Contentious topics|contentious topics]] procedure applies to this '
        .. articleOrPage .. '.</b>'
        .. (section and (' Parts of this ' .. articleOrPage .. ' relate ') or (' This ' .. articleOrPage .. ' relates '))

    if #topics > 1 then
        messageBody = messageBody  .. 'to the following contentious topics:\n'
        for _, topic in ipairs(topics) do
            messageBody = messageBody .. makeTopicBulletPoint(topic)
        end
    else
    	local topicBlurb = frame:expandTemplate{ 
    		title = "Contentious topics/list",
    		args = { scope=topics[1] } }
    	if topicBlurb ~= '' then
    		messageBody = messageBody .. 'to <b>'
            .. topicBlurb
            .. '</b>, a contentious topic.</p>'
        else
        	addCategory(categoryDatabase['bad-topic'])
        end
    end

    if underRestrictions then
        messageBody = '<p style="margin-top:0"><strong style="text-transform: uppercase;">Warning: active arbitration remedies</strong></p>'
            .. messageBody
            .. '<p style="text-decoration:underline; text-align:center; font-size:120%;">The following restrictions apply to everyone editing this ' .. articleOrPage .. ':</p>\n'
        for _, restriction in ipairs(restrictions) do
            messageBody = messageBody .. makeRestrictionBulletPoint(restriction)
            addCategory(categoryDatabase[restriction])
        end
        if args.other then
        	messageBody = messageBody .. '* <b>' .. args.other .. '</b>\n'
        	addCategory(categoryDatabase["other"])
        end
    end
	
	messageBody = messageBody .. ' Editors are advised to familiarise themselves with the [[Wikipedia:Contentious topics|contentious topics procedures]] before editing this page.'
	
	if not yesno(args.brief) then
		messageBody = messageBody .. ' Editors who repeatedly or seriously fail to adhere to the [[WP:Five pillars|purpose of Wikipedia]], any expected [[WP:Etiquette|standards of behaviour]], '
        .. 'or any [[WP:List of policies|normal editorial process]] may be blocked or restricted by an administrator.'
	end
	
	if section then
		messageBody = messageBody .. '<p>If it is unclear which parts of the page are related to this contentious topic, the content in question should be marked within the wiki text by an invisible comment.'
        .. 'If no comment is present, please ask an administrator for assistance. If in doubt it is better to assume that the content is covered.</p>'
	end

	if underRestrictions then
		if args['placed-date'] then
			messageBody = messageBody .. '<p>Restrictions placed: ' .. require('Module:Date')._Date(args['placed-date']):text() .. '</p>'
		elseif manualRestrictions then
			addCategory(categoryDatabase['no-date'])
		end
	end
	
	
	--[[
	Now build some further information collapse boxes
	We get the content of each collapse box from Wikipedia:Contentious topics/[Topic]/Further information
	--]]
	
	-- Now build the messageBox
	
    messageBox = require('Module:Message box').main("tmbox", {
        ["type"] = underRestrictions and "delete" or "content",
        ["small"] = yesno(args.small),
        ["image"] = "[[File:Commons-emblem-"
            .. (underRestrictions and "hand" or "issue")
            .. ".svg|"
            .. (yesno(args.small) and "30" or "40")
            .. "px]]",
        ["text"] = messageBody
    })
	
	-- If ECR is enabled, prepend the ECR warning
	if restrictionFlags["ECR"] then
		messageBox = frame:expandTemplate{ 
			title = "Template:Contentious topics/talk notice/ECR warning", 
			args = { section = section and "yes" or "", small = args.small}} 
		.. messageBox
		
		-- Hard code for [[WP:BER]]
		if TableTools.inArray(topics, "a-i") then
			addCategory("Wikipedia pages subject to the extended confirmed restriction related to the Arab-Israeli conflict")
		end
	end
	
	--[[
	Categories!!!
	We set the restriction categories back in the if underRestrictions loop
	to avoid looping through the restrictions twice. So we only need to do some cleanup and handle nocat
	
	Because nocat is only for the ultra-rare case of demonstration,
	manually clearing the categories is more efficient
	--]]
	
	if yesno(args.nocat) then
		categories = ''
	else
		addCategory(categoryDatabase["all"])
	end
	
    return messageBox .. categories
end

return p