Modül:Koruma kutu

Bu modül korunan sayfaların üstüne kilit simgesi veya ileti kutusu oluşturur.

Kullanımı

Bu modülün neredeyse hiçbir zaman direkt kullanılması gerekmez. Koruma şablonu olarak {{koruma}} kullanabilirsiniz. Diğer koruma şablonları aşağıdaki gibidir.

---

-- This module implements {{pp-meta}} and its daughter templates such as
-- {{pp-dispute}}, {{pp-vandalism}} and {{pp-sock}}.

-- Initialise necessary modules.
require('strict')
local makeFileLink = require('Module:File link')._main
local effectiveProtectionLevel = require('Module:Effective protection level')._main
local effectiveProtectionExpiry = require('Module:Effective protection expiry')._main
local yesno = require('Modül:Evethayır')

-- Lazily initialise modules and objects we don't always need.
local getArgs, makeMessageBox, lang

-- Set constants.
local CONFIG_MODULE = 'Modül:Koruma kutu/config'

--------------------------------------------------------------------------------
-- Helper functions
--------------------------------------------------------------------------------

local function makeCategoryLink(cat, sort)
	if cat then
		return string.format(
			'[[%s:%s|%s]]',
			mw.site.namespaces[14].name,
			cat,
			sort
		)
	end
end

local function validateDate(dateString, dateType)
	if not lang then
		lang = mw.language.getContentLanguage()
	end
	local success, result = pcall(lang.formatDate, lang, 'U', dateString)
	if success then
		result = tonumber(result)
		if result then
			return result
		end
	end
	error(string.format('invalid %s: %s', dateType, tostring(dateString)), 4)
end

local function makeFullUrl(page, query, display)
	return string.format(
		'[%s %s]',
		tostring(mw.uri.fullUrl(page, query)),
		display
	)
end

local function getReachableNodes(graph, start)
	local toWalk, retval = {[start] = true}, {}
	while true do
		local k = next(toWalk)
		if k == nil then
			return retval
		end
		toWalk[k] = nil
		retval[k] = true
		for _,v in ipairs(graph[k] or {}) do
			if not retval[v] then
				toWalk[v] = true
			end
		end
	end
end

--------------------------------------------------------------------------------
-- Protection class
--------------------------------------------------------------------------------

local Protection = {}
Protection.__index = Protection

Protection.supportedActions = { edit = true, move = true, autoreview = true, upload = true }
Protection.bannerConfigFields = { 'text', 'explanation', 'tooltip', 'alt', 'link', 'image' }

function Protection.new(args, cfg, title)
	local obj = {}
	obj._cfg = cfg
	obj.title = title or mw.title.getCurrentTitle()

	if not args.action then
		obj.action = 'edit'
	elseif Protection.supportedActions[args.action] then
		obj.action = args.action
	else
		error(string.format('invalid action: %s', tostring(args.action)), 3)
	end

	obj.level = args.demolevel or effectiveProtectionLevel(obj.action, obj.title)
	if (obj.action == 'move' and obj.level == 'sysop') then
		obj.level = 'sysop'
	elseif not obj.level or (obj.action == 'move' and obj.level == 'autoconfirmed') then
		obj.level = '*'
	end

	local effectiveExpiry = effectiveProtectionExpiry(obj.action, obj.title)
	if effectiveExpiry == 'infinity' then
		obj.expiry = 'indef'
	elseif effectiveExpiry ~= 'unknown' then
		obj.expiry = validateDate(effectiveExpiry, 'expiry date')
	end

	if args[1] then
		obj.reason = mw.ustring.lower(args[1])
		if obj.reason:find('|') then
			error('gerekçe pipe karakterini ("|") içeremez', 3)
		end
	end

	if args.date then
		obj.protectionDate = validateDate(args.date, 'koruma tarihi')
	end
	
	obj.bannerConfig = {}
	local configTables = {}
	if cfg.banners[obj.action] then
		configTables[#configTables + 1] = cfg.banners[obj.action][obj.reason]
	end
	if cfg.defaultBanners[obj.action] then
		configTables[#configTables + 1] = cfg.defaultBanners[obj.action][obj.level]
		configTables[#configTables + 1] = cfg.defaultBanners[obj.action].default
	end
	configTables[#configTables + 1] = cfg.masterBanner
	for i, field in ipairs(Protection.bannerConfigFields) do
		for j, t in ipairs(configTables) do
			if t and t[field] then
				obj.bannerConfig[field] = t[field]
				break
			end
		end
	end

	return setmetatable(obj, Protection)
end

function Protection:isUserScript()
	local title = self.title
	return title.namespace == 2 and (title.contentModel == 'javascript' or title.contentModel == 'css')
end

function Protection:isProtected()
	return self.level ~= '*'
end

function Protection:shouldShowLock()
	return self:isProtected() and not self:isUserScript()
end

Protection.shouldHaveProtectionCategory = Protection.shouldShowLock
function Protection:isTemporary()
	return type(self.expiry) == 'number'
end

--------------------------------------------------------------------------------
-- Blurb class
--------------------------------------------------------------------------------

local Blurb = {}
Blurb.__index = Blurb
Blurb.bannerTextFields = { text=true, explanation=true, tooltip=true, alt=true, link=true }

function Blurb.new(protectionObj, args, cfg)
	return setmetatable({ _cfg=cfg, _protectionObj=protectionObj, _args=args }, Blurb)
end

--------------------------------------------------------------------------------
-- BannerTemplate, Banner, Padlock
--------------------------------------------------------------------------------

local BannerTemplate = {}
BannerTemplate.__index = BannerTemplate

function BannerTemplate.new(protectionObj, cfg)
	local obj = {}
	obj._cfg = cfg
	local imageFilename = protectionObj.bannerConfig.image
	if imageFilename then
		obj._imageFilename = imageFilename
	else
		local action, level, namespace, reason = protectionObj.action, protectionObj.level, protectionObj.title.namespace, protectionObj.reason
		if (namespace == 10 or namespace == 828 or (reason and obj._cfg.indefImageReasons[reason]))
			and action=='edit' and level=='sysop' and not protectionObj:isTemporary()
		then
			obj._imageFilename = obj._cfg.msg['image-filename-indef']
		else
			local images = obj._cfg.images
			if images[action] then
				obj._imageFilename = images[action][level] or images[action].default
			end
		end
	end
	return setmetatable(obj, BannerTemplate)
end

local Banner = setmetatable({}, BannerTemplate)
Banner.__index = Banner

function Banner.new(protectionObj, blurbObj, cfg)
	local obj = BannerTemplate.new(protectionObj, cfg)
	obj.imageWidth = 40
	obj.imageCaption = blurbObj:makeBannerText('alt')
	obj._reasonText = blurbObj:makeBannerText('text')
	obj._explanationText = blurbObj:makeBannerText('explanation')
	obj._page = protectionObj.title.prefixedText
	return setmetatable(obj, Banner)
end

function Banner:__tostring()
	makeMessageBox = makeMessageBox or require('Modül:İleti kutusu').main
	local reasonText = self._reasonText or error('no reason text set', 2)
	local explanationText = self._explanationText
	local mbargs = {
		page = self._page,
		type = 'protection',
		image = self:renderImage(),
		text = string.format("'''%s'''%s", reasonText, explanationText and '<br />' .. explanationText or '')
	}
	return makeMessageBox('mbox', mbargs)
end

local Padlock = setmetatable({}, BannerTemplate)
Padlock.__index = Padlock

function Padlock.new(protectionObj, blurbObj, cfg)
	local obj = BannerTemplate.new(protectionObj, cfg)
	obj.imageWidth = 20
	obj.imageCaption = blurbObj:makeBannerText('tooltip')
	obj._imageAlt = blurbObj:makeBannerText('alt')
	obj._imageLink = blurbObj:makeBannerText('link')
	obj._indicatorName = cfg.padlockIndicatorNames[protectionObj.action] or cfg.padlockIndicatorNames.default or 'pp-default'
	return setmetatable(obj, Padlock)
end

function Padlock:__tostring()
	local frame = mw.getCurrentFrame()
	return frame:extensionTag{name='nowiki'} .. frame:extensionTag{name='indicator', args={name=self._indicatorName}, content=self:renderImage()}
end

--------------------------------------------------------------------------------
-- Exports
--------------------------------------------------------------------------------

local p = {}

function p._exportClasses()
	return { Protection=Protection, Blurb=Blurb, BannerTemplate=BannerTemplate, Banner=Banner, Padlock=Padlock }
end

function p._main(args, cfg, title)
	args = args or {}
	cfg = cfg or require(CONFIG_MODULE)
	local protectionObj = Protection.new(args, cfg, title)
	local ret = {}

	if not yesno(args.catonly) and (protectionObj.action=='edit' or args.demolevel or not getReachableNodes(cfg.hierarchy, protectionObj.level)[effectiveProtectionLevel('edit', protectionObj.title)]) then
		local blurbObj = Blurb.new(protectionObj, args, cfg)
		local parameter = args["küçük"] or args["small"]
		if protectionObj:shouldShowLock() then
			ret[#ret+1] = tostring((yesno(parameter) and Padlock or Banner).new(protectionObj, blurbObj, cfg))
		end
	end

	if yesno(args.category) or yesno(args.kategori) ~= false then
		ret[#ret+1] = protectionObj:makeCategoryLinks()
	end

	return table.concat(ret)
end

function p.main(frame, cfg)
	cfg = cfg or require(CONFIG_MODULE)
	cfg.wrappers = cfg.wrappers or {}
	local parent = frame.getParent and frame:getParent()
	local defaultArgs = parent and cfg.wrappers[parent:getTitle():gsub('/sandbox$', '')] or {}
	getArgs = getArgs or require('Modül:Bağımsız değişkenler').getArgs
	local userArgs = getArgs(frame, { parentOnly=defaultArgs, frameOnly=not defaultArgs })
	local args = {}
	for k,v in pairs(defaultArgs or {}) do args[k]=v end
	for k,v in pairs(userArgs) do args[k]=v end
	return p._main(args, cfg)
end

return p