Módulo:Alto uso/Testes

Esta é a página de testes de módulos de Módulo:Alto uso (dif).

Documentação do módulo[ver] [editar] [histórico] [purgar]

Este módulo está classificado como pronto para uso geral. Ele chegou a uma forma madura e pensa-se que está livre de erros e pronta para ser usado onde é apropriado. Ele está pronto para ser mencionado nas páginas de discussão e em outros recursos da Wikipédia como opção para novos usuários aprenderem. Para reduzir cargas nos servidores e mostrar texto estragado, ele deve ser melhorado pelo Exemplos para testes em vez de tentativas de edição a experimentar e erro.

Este módulo Lua é usado em muitas páginas e as mudanças podem ser amplamente notadas. Teste as mudanças nas subpáginas, /Testes ou /Exemplos para testes do módulo, ou em sua própria subpágina de testes de módulos. Considere discutir as mudanças na página de discussão antes de implementá-las.

Este módulo depende dos seguintes outros módulos:

Implementa {{Alto uso/Testes}}. Usa valores atualizados por bot de subpáginas de Módulo:Testes/Gkiyoshinishimoto/Transclusion count/data/ quando disponível.

Uso[editar código-fonte]

{{#invoke:Alto uso/Testes|main|1=número de transclusões|2=página de discussão ou uso + notação|all-pages=|info=|demo=|form=|expiry=}}

número de transclusões: O primeiro parâmetro é um número estático de vezes que a predefinição foi transcluída ou a palavra "risk" (sem aspas) para mostrar "um número muito grande de" em vez do valor real. Este valor será ignorado se os dados de transclusão estiverem disponíveis para a página atual.
página de discussão ou uso + notação: O segundo parâmetro é sobrecarregado. Isso fará com que o número de transclusões seja exibido como "#.###+" em vez de "aproximadamente #.###" quando definido igual a "yes" (sem aspas). Quando usados dessa maneira, os valores serão arredondados para baixo, em vez de arredondados para o número mais próximo com o número apropriado de algarismos significativos. Quando definido para qualquer outro valor que não seja em branco, ele substituirá a ligação^[a] para a página de discussão da predefinição pelo valor do parâmetro (por exemplo, 2=Wikipédia:Café dos programadores inserirá uma ligação^[a] para Wikipédia:Café dos programadores),
|all-pages=yes: Também mostrará a porcentagem de todas as páginas que usam a predefinição. Isso só deve ser usado para predefinições altamente transcluídas, e a porcentagem só será mostrada se for maior que 1%.
|info=informações extras: Quando definido como não em branco, inserirá informações extras no texto da predefinição se a predefinição tiver mais de 10.000 transclusões ou o parâmetro 1 estiver definido como "risk".
|demo=Nome da predefinição: Usará a contagem de transclusões para a predefinição em "Predefinição:Nome da predefinição" em vez de detectar em qual predefinição está sendo usada. A capitalização deve corresponder exatamente ao valor usado em Especial:Índice por prefixo/Módulo:Testes/Gkiyoshinishimoto/Transclusion_count/data/.
|form=: Quando definido como "editnotice", mostrará a mensagem usando {{Editnotice}} em vez de {{Ombox/Testes}}.
|expiry=: Define o parâmetro |expiry= para {{Editnotice}}.
|system=em mensagens de sistema: Se definido, este módulo se parece com {{Usada em sistema/Testes}}. Usa essa predefinição diretamente enquanto ela executa algumas verificações.
|fetch=: Se definido como "false", o módulo não tentará buscar contagens de transclusão usando Módulo:Testes/Gkiyoshinishimoto/Transclusion count

Outras funções[editar código-fonte]

num: Produz o texto e a ligação^[a] para toolforge em torno da quantidade de transclusões.
risk: Com esta função, se risk for passado para o primeiro parâmetro sem nome ou houver mais de 100 mil transclusões, isso retornará risco.
text: Retorna o corpo do texto desta predefinição, com "nil" (nulo) ou um número de transclusões.

Nota[editar código-fonte]

↑ ^a ^b ^c do inglês link

A documentação acima é transcluída de Módulo:Alto uso/Testes/doc. (editar | histórico)
Editores podem experimentar nas páginas de teste (editar | dif) e de exemplos para testes (criar) deste módulo.
Subpáginas deste módulo.

local p = {}

-- "_fetch" examina o argumento "demo"
local _fetch = require('Módulo:Testes/Gkiyoshinishimoto/Transclusion_count').fetch
local yesno = require('Módulo:Yesno/Testes')

function p.num(frame, count)
	if count == nil then
		if yesno(frame.args['fetch']) == false then
			if (frame.args[1] or '') ~= '' then count = tonumber(frame.args[1]) end
		else
			count = _fetch(frame)
		end
	end
	
	-- Constrói a sequência ('string') de saída
	local return_value = ""
	if count == nil then
		if frame.args[1] == "risk" then
			return_value = "um número muito grande de"
		else
			return_value = "muitas"
		end
	else
		-- Usa 2 algarismos significativos para números menores e 3 para os maiores
		local sigfig = 2
		if count >= 100000 then
			sigfig = 3
		end
		
		-- Prepara para arredondar para o número apropriado de "sigfigs"
		local f = math.floor(math.log10(count)) - sigfig + 1
		
		-- Arredonda e insere "aproximadamente" ou "+" quando apropriado
		if (frame.args[2] == "yes") or (mw.ustring.sub(frame.args[1],-1) == "+") then
			-- Arredonda para baixo
			return_value = string.format("%s+", mw.getContentLanguage():formatNum(math.floor( (count / 10^(f)) ) * (10^(f))) )
		else
			-- Arredonda para o mais próximo
			return_value = string.format("aproximadamente&#x20;%s", mw.getContentLanguage():formatNum(math.floor( (count / 10^(f)) + 0.5) * (10^(f))) )
		end

		-- Insere a porcentagem de páginas se for >= 1% e quando "|no-percent=" não estiver definido como sim
		if count and count > 250000 and not yesno (frame:getParent().args['no-percent']) then
			local percent = math.floor( ( (count/frame:callParserFunction('NUMBEROFPAGES', 'R') ) * 100) + 0.5)
			if percent >= 1 then
				return_value = string.format("%s&#x20;páginas, ou aproximadamente %s%% de todas", return_value, percent)
			end
		end	
	end
	
	return return_value
end

-- Ações se houver uma contagem de transclusões grande (maior ou igual a 100.000)
function p.risk(frame)
	local return_value = ""
	if frame.args[1] == "risk" then
		return_value = "risco"
	else
		local count = _fetch(frame)
		if count and count >= 100000 then return_value = "risco" end
	end
	return return_value
end

function p.text(frame, count)
	-- Só mostra as informações sobre como este modelo é atualizado se alguém 
	-- estiver realmente editando a página e talvez tentando atualizar a contagem.
	local bot_text = (frame:preprocess("{{REVISIONID}}") == "") and "\n\n----\n'''Mensagem de pré-visualização''': Contagem de transclusões atualizada automaticamente. ([[Predefinição:Alto uso/Testes/doc#Detalhes técnicos|ver documentação]])." or ''
	
	if count == nil then
		if yesno(frame.args['fetch']) == false then
			if (frame.args[1] or '') ~= '' then count = tonumber(frame.args[1]) end
		else
			count = _fetch(frame)
		end
	end
	local title = mw.title.getCurrentTitle()
	if title.subpageText == "doc" or title.subpageText == "Testes" then
		title = title.basePageTitle
	end
	
	local systemMessages = frame.args['system']
	if frame.args['system'] == '' then
		systemMessages = nil
	end
	
	-- Isso recupera o localizador de recursos uniforme (L.R.U., 'U.R.L.') do projeto automaticamente para simplificar a localização
	local templateCount = ('em [https://linkcount.toolforge.org/index.php?project=%s&page=%s %s páginas]'):format(
		mw.title.getCurrentTitle():fullUrl():gsub('//(.-)/.*', '%1'),
		mw.uri.encode(title.fullText), p.num(frame, count))
	local used_on_text = "'''Est" .. (mw.title.getCurrentTitle().namespace == 828 and "e módulo ''Lua''" or "a predefinição") .. ' é usad' .. (mw.title.getCurrentTitle().namespace == 828 and "o " or "a ");
	if systemMessages then
		used_on_text = used_on_text .. systemMessages ..
			((count and count > 2000) and ("''', e " .. templateCount) or ("'''"))
	else
		used_on_text = used_on_text .. templateCount .. "'''"
	end
	
	
	local sandbox_text =  ("subpáginas, [[%s/Testes|/Testes]] ou [[%s/Exemplos para testes|/Exemplos para testes]] " .. (mw.title.getCurrentTitle().namespace == 828 and "do " or "da ") .. "%s, ou em sua própria [[%s]]. "):format(
		title.fullText, title.fullText,
		(mw.title.getCurrentTitle().namespace == 828 and "módulo" or "predefinição"),
		mw.title.getCurrentTitle().namespace == 828 and "Módulo:Testes|subpágina de testes de módulos" or "Wikipédia:Página de usuário#Subpáginas|subpágina de usuário"
	)
	
	local infoArg = frame.args["info"] ~= "" and frame.args["info"]
	if (systemMessages or frame.args[1] == "risk" or (count and count >= 100000) ) then
		local info = systemMessages and '.<br/>As mudanças, feitas aqui, podem causar mudanças imediatas na <i>interface</i> de usuário da Wikipédia.' or '.'
		if infoArg then
			info = info .. "<br />" .. infoArg
		end
		sandbox_text = info .. '<br /> Para evitar grandes transtornos' ..
			(count and count >= 100000 and ' e carga do servidor' or '') ..
			', quaisquer mudanças devem ser testadas nas ' .. sandbox_text ..
			'As mudanças testadas podem ser adicionadas a essa página em uma única edição. '
	else
		sandbox_text = (infoArg and ('.<br />' .. infoArg .. ' A') or ' e a') ..
			's mudanças podem ser amplamente notadas. Teste as mudanças nas ' .. sandbox_text
	end

	
	local discussion_text = systemMessages and 'Por favor, discuta as mudanças ' or 'Considere discutir as mudanças '
	if frame.args["2"] and frame.args["2"] ~= "" and frame.args["2"] ~= "yes" then
		discussion_text = string.format("%sem [[%s]]", discussion_text, frame.args["2"])
	else
		discussion_text = string.format("%sna [[%s|página de discussão]]", discussion_text, title.talkPageTitle.fullText )
	end
	
	return used_on_text .. sandbox_text .. discussion_text .. " antes de implementá-las." .. bot_text
end

function p.main(frame)
	local count = nil
	if yesno(frame.args['fetch']) == false then
		if (frame.args[1] or '') ~= '' then count = tonumber(frame.args[1]) end
	else
		count = _fetch(frame)
	end
	local image = "[[Ficheiro:Ambox warning yellow.svg|40px|alt=Aviso|link=]]"
	local type_param = "style"
	local epilogue = ''
	if frame.args['system'] and frame.args['system'] ~= '' then
		image = "[[Ficheiro:Ambox important.svg|40px|alt=Aviso|link=]]"
		type_param = "content"
		local nocat = frame:getParent().args['nocat'] or frame.args['nocat']
		local categorise = (nocat == '' or not yesno(nocat))
		if categorise then
			epilogue = frame:preprocess('{{Testes outro||{{#switch:{{#invoke:Nível efetivo de proteção|{{#switch:{{NAMESPACE}}|File=upload|#default=edit}}|{{FULLPAGENAME}}}}|sysop|templateeditor|interfaceadmin=|#default=[[Categoria:!Páginas usadas em mensagens do sistema que precisam de proteção]]}}}}')
		end
	elseif (frame.args[1] == "risk" or (count and count >= 100000)) then
		image = "[[Ficheiro:Ambox warning orange.svg|40px|alt=Aviso|link=]]"
		type_param = "content"
	end
	
	if frame.args["form"] == "editnotice" then
		return frame:expandTemplate{
				title = 'Editnotice',
				args = {
						["image"] = image,
						["text"] = p.text(frame, count),
						["expiry"] = (frame.args["expiry"] or "")
				}
		} .. epilogue
	else
		return require('Módulo:Message box/Testes').main('ombox', {
			type = type_param,
			image = image,
			text = p.text(frame, count),
			expiry = (frame.args["expiry"] or "")
		}) .. epilogue
	end
end

return p

[link-1] ↑ ^a ^b ^c do inglês link

[a]