Editing Module:Protection banner
From MINR.ORG WIKI
Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.
The edit can be undone.
Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision | Your text | ||
Line 4: | Line 4: | ||
-- Initialise necessary modules. | -- Initialise necessary modules. | ||
require('Module:No globals') | require('Module:No globals') | ||
− | local | + | local class = require('Module:Middleclass').class |
+ | local newFileLink = require('Module:File link').new | ||
local effectiveProtectionLevel = require('Module:Effective protection level')._main | local effectiveProtectionLevel = require('Module:Effective protection level')._main | ||
− | |||
local yesno = require('Module:Yesno') | local yesno = require('Module:Yesno') | ||
-- Lazily initialise modules and objects we don't always need. | -- Lazily initialise modules and objects we don't always need. | ||
local getArgs, makeMessageBox, lang | local getArgs, makeMessageBox, lang | ||
− | |||
− | |||
− | |||
-------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | ||
Line 19: | Line 16: | ||
-------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | ||
− | local function makeCategoryLink(cat | + | local function makeCategoryLink(cat) |
if cat then | if cat then | ||
return string.format( | return string.format( | ||
− | '[[%s: | + | '[[%s:%s]]', |
mw.site.namespaces[14].name, | mw.site.namespaces[14].name, | ||
− | cat | + | cat |
− | |||
) | ) | ||
+ | else | ||
+ | return '' | ||
end | end | ||
end | end | ||
Line 32: | Line 30: | ||
-- Validation function for the expiry and the protection date | -- Validation function for the expiry and the protection date | ||
local function validateDate(dateString, dateType) | local function validateDate(dateString, dateType) | ||
− | + | lang = lang or mw.language.getContentLanguage() | |
− | |||
− | |||
local success, result = pcall(lang.formatDate, lang, 'U', dateString) | local success, result = pcall(lang.formatDate, lang, 'U', dateString) | ||
if success then | if success then | ||
Line 43: | Line 39: | ||
end | end | ||
error(string.format( | error(string.format( | ||
− | 'invalid %s | + | 'invalid %s ("%s")', |
dateType, | dateType, | ||
tostring(dateString) | tostring(dateString) | ||
− | ), | + | ), 0) |
end | end | ||
Line 57: | Line 53: | ||
end | end | ||
− | + | local function toTableEnd(t, pos) | |
− | + | -- Sends the value at position pos to the end of array t, and shifts the | |
− | + | -- other items down accordingly. | |
− | local function | + | return table.insert(t, table.remove(t, pos)) |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
end | end | ||
Line 82: | Line 63: | ||
-------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | ||
− | local Protection = | + | local Protection = class('Protection') |
− | |||
Protection.supportedActions = { | Protection.supportedActions = { | ||
edit = true, | edit = true, | ||
move = true, | move = true, | ||
− | autoreview | + | autoreview = true |
− | |||
} | } | ||
Line 101: | Line 80: | ||
} | } | ||
− | function Protection | + | function Protection:initialize(args, cfg, title) |
− | + | self._cfg = cfg | |
− | + | self.title = title or mw.title.getCurrentTitle() | |
− | |||
-- Set action | -- Set action | ||
if not args.action then | if not args.action then | ||
− | + | self.action = 'edit' | |
− | elseif | + | elseif self.supportedActions[args.action] then |
− | + | self.action = args.action | |
else | else | ||
error(string.format( | error(string.format( | ||
− | 'invalid action | + | 'invalid action ("%s")', |
tostring(args.action) | tostring(args.action) | ||
− | ), | + | ), 0) |
end | end | ||
-- Set level | -- Set level | ||
− | + | self.level = effectiveProtectionLevel(self.action, self.title) | |
− | if not | + | if self.level == 'accountcreator' then |
+ | -- Lump titleblacklisted pages in with template-protected pages, | ||
+ | -- since templateeditors can do both. | ||
+ | self.level = 'templateeditor' | ||
+ | elseif not self.level or (self.action == 'move' and self.level == 'autoconfirmed') then | ||
-- Users need to be autoconfirmed to move pages anyway, so treat | -- Users need to be autoconfirmed to move pages anyway, so treat | ||
-- semi-move-protected pages as unprotected. | -- semi-move-protected pages as unprotected. | ||
− | + | self.level = '*' | |
end | end | ||
-- Set expiry | -- Set expiry | ||
− | + | if args.expiry then | |
− | + | if cfg.indefStrings[args.expiry] then | |
− | + | self.expiry = 'indef' | |
− | + | elseif type(args.expiry) == 'number' then | |
− | + | self.expiry = args.expiry | |
+ | else | ||
+ | self.expiry = validateDate(args.expiry, 'expiry date') | ||
+ | end | ||
end | end | ||
-- Set reason | -- Set reason | ||
if args[1] then | if args[1] then | ||
− | + | self.reason = mw.ustring.lower(args[1]) | |
− | if | + | if self.reason:find('|') then |
− | error('reasons cannot contain the pipe character ("|")', | + | error('reasons cannot contain the pipe character ("|")', 0) |
end | end | ||
end | end | ||
Line 144: | Line 129: | ||
-- Set protection date | -- Set protection date | ||
if args.date then | if args.date then | ||
− | + | self.protectionDate = validateDate(args.date, 'protection date') | |
end | end | ||
-- Set banner config | -- Set banner config | ||
do | do | ||
− | + | self.bannerConfig = {} | |
local configTables = {} | local configTables = {} | ||
− | if cfg.banners[ | + | if cfg.banners[self.action] then |
− | configTables[#configTables + 1] = cfg.banners[ | + | configTables[#configTables + 1] = cfg.banners[self.action][self.reason] |
end | end | ||
− | if cfg.defaultBanners[ | + | if cfg.defaultBanners[self.action] then |
− | configTables[#configTables + 1] = cfg.defaultBanners[ | + | configTables[#configTables + 1] = cfg.defaultBanners[self.action][self.level] |
− | configTables[#configTables + 1] = cfg.defaultBanners[ | + | configTables[#configTables + 1] = cfg.defaultBanners[self.action].default |
end | end | ||
configTables[#configTables + 1] = cfg.masterBanner | configTables[#configTables + 1] = cfg.masterBanner | ||
− | for i, field in ipairs( | + | for i, field in ipairs(self.bannerConfigFields) do |
for j, t in ipairs(configTables) do | for j, t in ipairs(configTables) do | ||
if t[field] then | if t[field] then | ||
− | + | self.bannerConfig[field] = t[field] | |
break | break | ||
end | end | ||
Line 168: | Line 153: | ||
end | end | ||
end | end | ||
− | |||
end | end | ||
function Protection:isProtected() | function Protection:isProtected() | ||
return self.level ~= '*' | return self.level ~= '*' | ||
− | |||
− | |||
− | |||
− | |||
end | end | ||
Line 197: | Line 177: | ||
-- Get the namespace key fragment. | -- Get the namespace key fragment. | ||
− | local namespaceFragment = cfg.categoryNamespaceKeys[title.namespace] | + | local namespaceFragment |
− | + | do | |
− | + | namespaceFragment = cfg.categoryNamespaceKeys[title.namespace] | |
+ | if not namespaceFragment and title.namespace % 2 == 1 then | ||
+ | namespaceFragment = 'talk' | ||
+ | end | ||
end | end | ||
Line 224: | Line 207: | ||
-- instead. | -- instead. | ||
--]] | --]] | ||
− | table.insert(order, table.remove(order, | + | if self.reason and cfg.reasonsWithNamespacePriority[self.reason] then |
+ | -- table.insert(order, 3, table.remove(order, 2)) | ||
+ | toTableEnd(order, 2) | ||
+ | else | ||
+ | toTableEnd(order, 3) | ||
+ | end | ||
--[[ | --[[ | ||
Line 301: | Line 289: | ||
local attempt = cats[key] | local attempt = cats[key] | ||
if attempt then | if attempt then | ||
− | return makeCategoryLink(attempt | + | return makeCategoryLink(attempt) |
end | end | ||
end | end | ||
return '' | return '' | ||
+ | end | ||
+ | |||
+ | function Protection:needsExpiry() | ||
+ | local cfg = self._cfg | ||
+ | return not self.expiry | ||
+ | and cfg.expiryCheckActions[self.action] | ||
+ | and self.reason -- the old {{pp-protected}} didn't check for expiry | ||
+ | and not cfg.reasonsWithoutExpiryCheck[self.reason] | ||
end | end | ||
Line 325: | Line 321: | ||
local msg = self._cfg.msg | local msg = self._cfg.msg | ||
local ret = { self:makeProtectionCategory() } | local ret = { self:makeProtectionCategory() } | ||
+ | if self:needsExpiry() then | ||
+ | ret[#ret + 1] = makeCategoryLink(msg['tracking-category-expiry']) | ||
+ | end | ||
if self:isIncorrect() then | if self:isIncorrect() then | ||
− | ret[#ret + 1] = makeCategoryLink( | + | ret[#ret + 1] = makeCategoryLink(msg['tracking-category-incorrect']) |
− | |||
− | |||
− | |||
end | end | ||
if self:isTemplateProtectedNonTemplate() then | if self:isTemplateProtectedNonTemplate() then | ||
− | ret[#ret + 1] = makeCategoryLink( | + | ret[#ret + 1] = makeCategoryLink(msg['tracking-category-template']) |
− | |||
− | |||
− | |||
end | end | ||
return table.concat(ret) | return table.concat(ret) | ||
Line 344: | Line 337: | ||
-------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | ||
− | local Blurb = | + | local Blurb = class('Blurb') |
− | |||
Blurb.bannerTextFields = { | Blurb.bannerTextFields = { | ||
Line 355: | Line 347: | ||
} | } | ||
− | function Blurb | + | function Blurb:initialize(protectionObj, args, cfg) |
− | + | self._cfg = cfg | |
− | + | self._protectionObj = protectionObj | |
− | + | self._args = args | |
− | |||
− | |||
end | end | ||
Line 393: | Line 383: | ||
parameterFuncs.IMAGELINK = self._makeImageLinkParameter | parameterFuncs.IMAGELINK = self._makeImageLinkParameter | ||
parameterFuncs.INTROBLURB = self._makeIntroBlurbParameter | parameterFuncs.INTROBLURB = self._makeIntroBlurbParameter | ||
− | |||
parameterFuncs.PAGETYPE = self._makePagetypeParameter | parameterFuncs.PAGETYPE = self._makePagetypeParameter | ||
parameterFuncs.PROTECTIONBLURB = self._makeProtectionBlurbParameter | parameterFuncs.PROTECTIONBLURB = self._makeProtectionBlurbParameter | ||
Line 401: | Line 390: | ||
parameterFuncs.TALKPAGE = self._makeTalkPageParameter | parameterFuncs.TALKPAGE = self._makeTalkPageParameter | ||
parameterFuncs.TOOLTIPBLURB = self._makeTooltipBlurbParameter | parameterFuncs.TOOLTIPBLURB = self._makeTooltipBlurbParameter | ||
− | |||
parameterFuncs.VANDAL = self._makeVandalTemplateParameter | parameterFuncs.VANDAL = self._makeVandalTemplateParameter | ||
Line 452: | Line 440: | ||
if level == 'autoconfirmed' then | if level == 'autoconfirmed' then | ||
requestType = 'semi' | requestType = 'semi' | ||
− | |||
− | |||
elseif level == 'templateeditor' then | elseif level == 'templateeditor' then | ||
requestType = 'template' | requestType = 'template' | ||
Line 463: | Line 449: | ||
local display = self:_getExpandedMessage('edit-request-display') | local display = self:_getExpandedMessage('edit-request-display') | ||
− | return mEditRequest. | + | return mEditRequest.exportLinkToLua{type = requestType, display = display} |
end | end | ||
Line 505: | Line 491: | ||
level, | level, | ||
talkKey | talkKey | ||
− | ) | + | )) |
end | end | ||
return self:_substituteParameters(msg) | return self:_substituteParameters(msg) | ||
Line 526: | Line 512: | ||
function Blurb:_makeIntroBlurbParameter() | function Blurb:_makeIntroBlurbParameter() | ||
− | if self._protectionObj | + | if type(self._protectionObj.expiry) == 'number' then |
return self:_getExpandedMessage('intro-blurb-expiry') | return self:_getExpandedMessage('intro-blurb-expiry') | ||
else | else | ||
return self:_getExpandedMessage('intro-blurb-noexpiry') | return self:_getExpandedMessage('intro-blurb-noexpiry') | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
end | end | ||
end | end | ||
Line 545: | Line 523: | ||
return pagetypes[self._protectionObj.title.namespace] | return pagetypes[self._protectionObj.title.namespace] | ||
or pagetypes.default | or pagetypes.default | ||
− | or error('no default pagetype defined' | + | or error('no default pagetype defined') |
end | end | ||
Line 560: | Line 538: | ||
msg = protectionBlurbs.edit.default | msg = protectionBlurbs.edit.default | ||
else | else | ||
− | error('no protection blurb defined for protectionBlurbs.edit.default' | + | error('no protection blurb defined for protectionBlurbs.edit.default') |
end | end | ||
return self:_substituteParameters(msg) | return self:_substituteParameters(msg) | ||
Line 586: | Line 564: | ||
msg = protectionLevels.edit.default | msg = protectionLevels.edit.default | ||
else | else | ||
− | error('no protection level defined for protectionLevels.edit.default' | + | error('no protection level defined for protectionLevels.edit.default') |
end | end | ||
return self:_substituteParameters(msg) | return self:_substituteParameters(msg) | ||
Line 621: | Line 599: | ||
function Blurb:_makeTooltipBlurbParameter() | function Blurb:_makeTooltipBlurbParameter() | ||
− | if self._protectionObj | + | if type(self._protectionObj.expiry) == 'number' then |
return self:_getExpandedMessage('tooltip-blurb-expiry') | return self:_getExpandedMessage('tooltip-blurb-expiry') | ||
else | else | ||
return self:_getExpandedMessage('tooltip-blurb-noexpiry') | return self:_getExpandedMessage('tooltip-blurb-noexpiry') | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
end | end | ||
end | end | ||
Line 665: | Line 635: | ||
tostring(key), | tostring(key), | ||
type(msg) | type(msg) | ||
− | ) | + | )) |
end | end | ||
return self:_substituteParameters(msg) | return self:_substituteParameters(msg) | ||
Line 675: | Line 645: | ||
-------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | ||
− | local BannerTemplate = | + | local BannerTemplate = class('BannerTemplate') |
− | |||
− | function BannerTemplate | + | function BannerTemplate:initialize(protectionObj, cfg) |
− | + | self._cfg = cfg | |
− | |||
-- Set the image filename. | -- Set the image filename. | ||
local imageFilename = protectionObj.bannerConfig.image | local imageFilename = protectionObj.bannerConfig.image | ||
if imageFilename then | if imageFilename then | ||
− | + | self._imageFilename = imageFilename | |
else | else | ||
-- If an image filename isn't specified explicitly in the banner config, | -- If an image filename isn't specified explicitly in the banner config, | ||
Line 691: | Line 659: | ||
local action = protectionObj.action | local action = protectionObj.action | ||
local level = protectionObj.level | local level = protectionObj.level | ||
+ | local expiry = protectionObj.expiry | ||
local namespace = protectionObj.title.namespace | local namespace = protectionObj.title.namespace | ||
− | |||
-- Deal with special cases first. | -- Deal with special cases first. | ||
− | if ( | + | if (namespace == 10 or namespace == 828) |
− | |||
− | |||
− | |||
− | |||
and action == 'edit' | and action == 'edit' | ||
and level == 'sysop' | and level == 'sysop' | ||
− | and not | + | and not expiry |
then | then | ||
-- Fully protected modules and templates get the special red "indef" | -- Fully protected modules and templates get the special red "indef" | ||
-- padlock. | -- padlock. | ||
− | + | self._imageFilename = self._cfg.msg['image-filename-indef'] | |
else | else | ||
-- Deal with regular protection types. | -- Deal with regular protection types. | ||
− | local images = | + | local images = self._cfg.images |
if images[action] then | if images[action] then | ||
if images[action][level] then | if images[action][level] then | ||
− | + | self._imageFilename = images[action][level] | |
elseif images[action].default then | elseif images[action].default then | ||
− | + | self._imageFilename = images[action].default | |
end | end | ||
end | end | ||
end | end | ||
end | end | ||
− | + | end | |
+ | |||
+ | function BannerTemplate:setImageWidth(width) | ||
+ | self._imageWidth = width | ||
+ | end | ||
+ | |||
+ | function BannerTemplate:setImageTooltip(tooltip) | ||
+ | self._imageCaption = tooltip | ||
end | end | ||
Line 726: | Line 697: | ||
or self._cfg.msg['image-filename-default'] | or self._cfg.msg['image-filename-default'] | ||
or 'Transparent.gif' | or 'Transparent.gif' | ||
− | return | + | return newFileLink(filename) |
− | + | :width(self._imageWidth or 20) | |
− | + | :alt(self._imageAlt) | |
− | alt | + | :link(self._imageLink) |
− | link | + | :caption(self._imageCaption) |
− | caption | + | :render() |
− | |||
end | end | ||
Line 739: | Line 709: | ||
-------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | ||
− | local Banner = | + | local Banner = BannerTemplate:subclass('Banner') |
− | |||
− | function Banner | + | function Banner:initialize(protectionObj, blurbObj, cfg) |
− | + | BannerTemplate.initialize(self, protectionObj, cfg) -- This doesn't need the blurb. | |
− | + | self:setImageWidth(40) | |
− | + | self:setImageTooltip(blurbObj:makeBannerText('alt')) -- Large banners use the alt text for the tooltip. | |
− | + | self._reasonText = blurbObj:makeBannerText('text') | |
− | + | self._explanationText = blurbObj:makeBannerText('explanation') | |
− | + | self._page = protectionObj.title.prefixedText -- Only makes a difference in testing. | |
− | |||
end | end | ||
Line 755: | Line 723: | ||
-- Renders the banner. | -- Renders the banner. | ||
makeMessageBox = makeMessageBox or require('Module:Message box').main | makeMessageBox = makeMessageBox or require('Module:Message box').main | ||
− | local reasonText = self._reasonText or error('no reason text set' | + | local reasonText = self._reasonText or error('no reason text set') |
local explanationText = self._explanationText | local explanationText = self._explanationText | ||
local mbargs = { | local mbargs = { | ||
Line 774: | Line 742: | ||
-------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | ||
− | local Padlock = | + | local Padlock = BannerTemplate:subclass('Padlock') |
− | |||
− | function Padlock | + | function Padlock:initialize(protectionObj, blurbObj, cfg) |
− | + | BannerTemplate.initialize(self, protectionObj, cfg) -- This doesn't need the blurb. | |
− | + | self:setImageWidth(20) | |
− | + | self:setImageTooltip(blurbObj:makeBannerText('tooltip')) | |
− | + | self._imageAlt = blurbObj:makeBannerText('alt') | |
− | + | self._imageLink = blurbObj:makeBannerText('link') | |
− | + | self._right = cfg.padlockPositions[protectionObj.action] | |
− | or cfg. | + | or cfg.padlockPositions.default |
− | or ' | + | or '55px' |
− | |||
end | end | ||
function Padlock:__tostring() | function Padlock:__tostring() | ||
− | local | + | local root = mw.html.create('div') |
− | + | root | |
− | + | :addClass('metadata topicon nopopups') | |
− | + | :attr('id', 'protected-icon') | |
− | + | :css{display = 'none', right = self._right} | |
− | + | :wikitext(self:renderImage()) | |
− | + | return tostring(root) | |
end | end | ||
Line 818: | Line 784: | ||
function p._main(args, cfg, title) | function p._main(args, cfg, title) | ||
args = args or {} | args = args or {} | ||
− | cfg = cfg or require( | + | cfg = cfg or require('Module:Protection banner/config') |
− | local protectionObj = Protection.new(args, cfg, title) | + | -- Initialise the protection object and check for errors |
+ | local protectionObjCreated, protectionObj = pcall( | ||
+ | Protection.new, Protection, -- equivalent to Protection:new() | ||
+ | args, | ||
+ | cfg, | ||
+ | title | ||
+ | ) | ||
+ | if not protectionObjCreated then | ||
+ | local errorBlurb = cfg.msg['error-message-blurb'] or 'Error: $1.' | ||
+ | local errorText = mw.message.newRawMessage(errorBlurb) | ||
+ | :params(protectionObj) -- protectionObj is the error message | ||
+ | :plain() | ||
+ | return string.format( | ||
+ | '<strong class="error">%s</strong>%s', | ||
+ | errorText, | ||
+ | makeCategoryLink(cfg.msg['tracking-category-incorrect']) | ||
+ | ) | ||
+ | end | ||
+ | |||
+ | -- Initialise the blurb object | ||
+ | local blurbObj = Blurb:new(protectionObj, args, cfg) | ||
local ret = {} | local ret = {} | ||
− | -- | + | -- Render the banner |
− | + | if protectionObj:isProtected() then | |
− | + | ret[#ret + 1] = tostring( | |
− | if protectionObj | + | (yesno(args.small) and Padlock or Banner) |
− | + | :new(protectionObj, blurbObj, cfg) | |
− | + | ) | |
− | + | end | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
-- Render the categories | -- Render the categories | ||
if yesno(args.category) ~= false then | if yesno(args.category) ~= false then | ||
Line 855: | Line 827: | ||
function p.main(frame, cfg) | function p.main(frame, cfg) | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
getArgs = getArgs or require('Module:Arguments').getArgs | getArgs = getArgs or require('Module:Arguments').getArgs | ||
− | local | + | cfg = cfg or require('Module:Protection banner/config') |
− | + | local parentTitle = frame:getParent():getTitle() | |
− | + | parentTitle = parentTitle:gsub('/sandbox$', '') | |
− | + | local defaultArgs = cfg.wrappers[parentTitle] or {} | |
− | + | local args = getArgs(frame, {parentOnly = defaultArgs and true}) | |
− | + | for k, v in pairs(defaultArgs) do | |
− | local args = { | ||
− | |||
− | |||
− | |||
− | for k, v in pairs( | ||
args[k] = v | args[k] = v | ||
end | end |