Module:WikiProject metrics: Difference between revisions

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

This module contains assorted tools for building WikiProject X metrics pages.

Usage

{{#invoke:WikiProject metrics|list|start month}}

Generates a list of months and the number of pages created in each month, starting with the given month

{{#invoke:WikiProject metrics|recent}}

Transcludes the current month's article list; if the month has just started, it may show last month's as well

{{#invoke:WikiProject metrics|chart|start month}}

Generates a line chart showing article creations over time, starting with the given month

The above documentation is transcluded from Module:WikiProject metrics/doc. (edit | history)
Editors can experiment in this module's sandbox (create | mirror) and testcases (create) pages.
Subpages of this module.

local p = {}

local Date = require("Module:Date")._Date
local lang = mw.language.new(mw.language.getContentLanguage().code)

local function getMonths(start)
	local month = Date("1 " .. start)
	local current = Date("currentdate")
	current = Date(current.year, current.month, 1)

	if month > current then
		return {}
	end

	local months = {month}

	while month < current do
		month = month + "1 month"
		table.insert(months, month)
	end

	return months
end

function p.list(frame)
	local baseTitle = frame:getParent():getTitle()
	local startMonth = frame.args[1]

	local months = getMonths(startMonth)
	local list = {}

	for i, month in pairs(months) do
		if i == 1 or month:text("%B") == "January" then
			local tag = '<span style="font-size: 120%%;">%s</span>'
			table.insert(list,  string.format(tag, month:text("%Y")))
		end

		local line = "* [[%s|%s]]: %s"
		local title = baseTitle .. "/" .. month:text("%B %Y")
		local count = frame:preprocess("{{#lst:" .. title .. "|count}}")
		count = lang:formatNum(tonumber(count))
		local item = string.format(line, title, month:text("%b"), count)
		table.insert(list, item)
	end

	return table.concat(list, "\n")
end

function p.recent(frame)
	return "nothing at all! :("
end

function p.chart(frame)
	local baseTitle = frame:getParent():getTitle()
	local startMonth = frame.args[1]

	local months = getMonths(startMonth)
	local xdata = {}
	local ydata = {}

	for i, month in pairs(months) do
		local title = baseTitle .. "/" .. month:text("%B %Y")
		local count = frame:preprocess("{{#lst:" .. title .. "|count}}")
		
		table.insert(xdata, month:text("%b %Y"))
		table.insert(ydata, count)
	end

	local chart = frame:expandTemplate{ title = "Graph:Chart", args = {
		width = "600",
		height = "200",
		type = "line",
		xAxisTitle = "Month",
		yAxisTitle = "Number of articles created",
		xType = "date",
		yAxisMin = "0",
		x = table.concat(xdata, ","),
		y = table.concat(ydata, ",")
	}}

	local div = '<div style="text-align: center; margin: auto;">%s</div>'
	return string.format(div, chart)
end

return p