Module:Effective protection level/sandbox

Module documentation[view] [edit] [history] [purge]

This module provides a way to retrieve the group required to perform a given action on a page. It currently tests the following criteria:

• The page being pending-changes protected: autoconfirmed
• The page being a JavaScript or CSS subpage in userspace, or in the MediaWiki namespace: interfaceadmin
• The page being in the MediaWiki namespace: sysop
• The page being a JSON subpage in userspace: sysop
• The page being protected: sysop, templateeditor, extendedconfirmed, or autoconfirmed
• The page being used in a cascading-protected page: sysop
• The page's title matching the titleblacklist: templateeditor or autoconfirmed
• A file being moved: filemover
• A page being moved or a file being uploaded: autoconfirmed
• A non-Draft non-talk page being created: user
• Anything else: *

Note that if a template-protected file is moved, both filemover and templateeditor are required, but this will return only templateeditor. This is not likely to be changed any time soon, since template protection currently shouldn't be used on files.

Usage

Warning: This module will use up to 4 expensive parser function calls each time it is ran. It should only be used if the exact effective protection level is necessary. Otherwise, consider using title.protectionLevels instead.

From other modules

To load this module:

local effectiveProtectionLevel = require('Module:Effective protection level')._main

The function accepts two parameters. The first is a string containing the action to check, which must be one of "edit", "create", "move", "upload", "undelete", or "autoreview". The second is optional, and can either be the name of the page to check, or a title returned from the mw.title functions. If the second parameter is omitted, the page being displayed is the one checked against. The return value is a string containing the name of the group required to perform the given action.

From wikitext

The parameters are the same as when it is called directly.

{{#invoke:Effective protection level|action|title}}

See also

• Module:Effective protection expiry

The above documentation is transcluded from Module:Effective protection level/doc. (edit | history)
Editors can experiment in this module's sandbox (edit | diff) and testcases (create) pages.
Add categories to the /doc subpage. Subpages of this module.

local p = {}

p.groupForPermission = {
	review = 'reviewer',
	autoconfirmed = 'autoconfirmed'
}
p.groupForPermission[''] = ''

-- Returns the permission required to perform a given action on a given title.
-- If no title is specified, the title of the page being displayed is used.
function p.main(action, pagename)
	local frame = mw.getCurrentFrame()
	local title
	if type(pagename) == 'table' then
		title = pagename
		pagename = title.prefixedText
	else
		title = mw.title.new(pagename) or mw.title.getCurrentTitle()
	end
--	if action == 'accept'  then
--		return p.groupForPermission[frame:callParserFunction('PENDINGCHANGELEVEL', pagename)]
--	elseif action ~= 'edit' and action ~= 'move' and action ~= 'create' and action ~= 'upload' then
--		error( 'First parameter must be one of accept, edit, move, create, upload', 2 )
--	end
	if action ~= 'edit' and action ~= 'move' and action ~= 'create' and action ~= 'upload' then
		error( 'First parameter must be one of edit, move, create, upload', 2 )
	end
	if title.namespace == 8 then -- MediaWiki namespace
		return 'sysop'
	elseif title.namespace == 2 and ( mw.ustring.find( pagename, '/.*%.js$') or mw.ustring.find( pagename, '/.*%.css$') ) then -- user .js or .css page
		return 'sysop'
	else
		local level = frame:callParserFunction('PROTECTIONLEVEL', action, pagename)
		if level == 'sysop' then
			return 'sysop'
		-- Uncomment the following two lines once CASCADINGSOURCES is available here
--		elseif frame:callParserFunction('CASCADINGSOURCES', obj.prefixedText) ~= '' then -- used by a cascading-protected page
--			return 'sysop'
		elseif level == 'templateeditor' then
			return 'templateeditor'
		-- Check for titleblacklist here once that's working. Note: Don't test if action=move, as the titleblacklist applies to move targets, not sources
		end
		return level
	end
end

-- Make this usable from wikitext rather than just other lua modules
function p.p(frame)
	local parent = frame:getParent()
	return p.main(frame.args.action or frame.args[1] or parent.args.action or parent.args[1], frame.args.title or frame.args[2] or parent.args.title or parent.args[2])
end

return p