ਮੌਡਿਊਲ:Resolve category redirect

Resolves a soft category redirect.

It takes one parameter, which is the name of a category. It returns that category name, unless the category exists and is a {{category redirect}} ... when it returns the name of the redirect target.

Usage

{{Resolve category redirect|categoryname}}

Examples

Category exists and is not redirected

Category:1970s

• {{Resolve category redirect|1970s}} → 1970s
• {{Resolve category redirect|Category:1970s}} → 1970s

Category exists and is a soft redirect

Category:Mosques completed in the 19th century

• {{Resolve category redirect|Mosques completed in the 19th century}} → Mosques completed in the 19th century
• {{Resolve category redirect|Category:Mosques completed in the 19th century}} → Mosques completed in the 19th century

Category exists and is a soft redirect

Category:Organisations

• {{Resolve category redirect|Organisations}} → Organisations
• {{Resolve category redirect|Category:Organisations}} → Organisations

Non-existent category

Category:Colourless green things

• {{Resolve category redirect|Colourless green things}} → Colourless green things
• {{Resolve category redirect|Category:Colourless green things}} → Colourless green things

Templates

Do not use templates in the target name.

{{Resolve category redirect}} cannot expand any templates in the target name, and the { character caused crashes (as did } and !). So it does not attempt to resolve any redirect where the target includes those characters.

Example

• Category:1781 in Mexico‎ contained {{category redirect|{{title year}} in New Spain}} which cannot be resolved. To be safe, {{Resolve category redirect|1781 in Mexico‎}} simply returned 1781 in Mexico‎.
  The above example has since been changed to {{category redirect|1781 in New Spain}}, which can be resolved.

Avoiding deletion of the redirected page

If the parameter |keep=yes is included in the category redirect, this hides a speedy deletion button that is otherwise displayed to administrators.

It is helpful to also add {{R from category navigation}} to indicate that the redirect is required for navigation between category pages. See that template page for full syntax.

See also

• Template:Category redirect

---

local p = {}

local function cleanup( rtarget )
	rtarget = mw.text.trim( rtarget )
	rtarget = mw.ustring.gsub( rtarget, '^1%s*=%s*', '' )
	rtarget = string.gsub( rtarget, '^[Cc]ategory:', '' )
	return rtarget
end

local function escape( text )
	return string.gsub( text or '', '-', '%%-' ) --expand as needed
end

--Returns the target of {{Category redirect}}, if it exists, else returns the original cat.
function p.rtarget( cat, frame )
	cat = string.gsub( cat, '^[Cc]ategory:', '' ) --"!" in cat not recognized by mw.title.makeTitle() otherwise
	if string.match( cat, '[|]' ) then return cat end
	local cattitle = mw.title.makeTitle( 'Category', cat or '' ) --makeTitle() allows ':' in cat names
	if not cattitle then return cat end
	local catcontent = cattitle:getContent()
	if string.match( catcontent or '', '{{ *[Cc]at' ) then --regex common to all possible calls
		catcontent = mw.ustring.gsub( catcontent, '|%s*keep%s*=%s*[yY]?[eE]?[sS]?%s*', '' ) --remove other params
		local getRegex = require('Module:Template redirect regex').main
		local tregex = getRegex('Category redirect')
		for _, v in pairs (tregex) do
			local found = mw.ustring.match( catcontent, v..'%s*|' )
			if found then --refine
				local rtarget = mw.ustring.match( catcontent, v..'%s*|%s*([^{|}]+)}}' ) or --{{Category redirect|...}} (most common)
								mw.ustring.match( catcontent, v..'%s*|%s*([^{|}]+)|' )     --{{Category redirect|...|...}} (2nd most common)
				if rtarget then --normal, plain text target
					return cleanup(rtarget)
				else
					local ty_regex = '%s*|%s*([^{|}]*{{([^#][^{|}]+)}}[^{|}]*)' --$1 nests $2
					local rtarget_ty, ty = mw.ustring.match( catcontent, v..ty_regex )
					if rtarget_ty then --{{Category redirect|...{{Title year}}... (less common)
						local ty_eval = frame:expandTemplate{ title = ty, args = { page = cat } } --frame:newChild doesn't work, use 'page' param instead
						local rtarget_ty_eval = mw.ustring.gsub( rtarget_ty, '{{%s*'..escape(ty)..'%s*}}', ty_eval )
						return cleanup(rtarget_ty_eval)
					else --resolve basic parser functions: e.g. {{#time:j F Y}} on Proposed deletion as of today (very uncommon)
						local pf_regex = '%s*|%s*([^{|}]*{{%s*(#[^{|}#:]+):([^{|}#:]+)}}[^{|}]*)' --$1 nests $2 & $3
						local rtarget_pf, pf, pf_arg = mw.ustring.match( catcontent, v..pf_regex )
						if rtarget_pf then
							local pf_eval = frame:callParserFunction{ name = pf, args = { pf_arg } }
							local rtarget_pf_eval = mw.ustring.gsub( rtarget_pf, '{{%s*'..escape(pf)..'%s*:%s*'..escape(pf_arg)..'%s*}}', pf_eval )
							return cleanup(rtarget_pf_eval)
						else --resolve parser functions with sub-parameter: e.g. {{#time:F Y|now -1 year}} on Orphaned articles from last year
							local pfp_regex = '%s*|%s*([^{|}]*{{%s*(#[^{|}#:]+):([^{|}#:]+)|([^{|}#:]+)}}[^{|}]*)' --$1 nests $2, $3, $4
							local rtarget_pfp, pfp, pfp_arg1, pfp_arg2 = mw.ustring.match( catcontent, v..pfp_regex )
							if rtarget_pfp then
								local pfp_args_gsub = escape(pfp_arg1)..'%s*|%s*'..escape(pfp_arg2)
								local pfp_eval = frame:callParserFunction{ name = pfp, args = { pfp_arg1, pfp_arg2 } }
								local rtarget_pfp_eval = mw.ustring.gsub( rtarget_pfp, '{{%s*'..escape(pfp)..'%s*:%s*'..pfp_args_gsub..'%s*}}', pfp_eval )
								return cleanup(rtarget_pfp_eval)
							else --potential TODO: +loop for multiple templates/parameters
								return cat
							end
						end
	end	end	end	end	end
	return cat
end

function p.main( frame )
	local args = frame:getParent().args
	local cat  = mw.text.trim( args[1] or '' )
	if (cat == '') or (cat == nil) then
		return ''
	end
	return p.rtarget( cat, frame )
end

return p