Module:Jumelages

 Documentation[voir] [modifier] [historique] [purger]

Module utilisé par le modèle {{Jumelages}}.

Utilisation

Fonctions exportables :

• tableauDesJumelages(frame) – Permet d'obtenir la liste des jumelages d'une ville / d'un village, ainsi qu'une carte interactive des villes jumelées.

La documentation de ce module est générée par le modèle {{Documentation module}}.
Elle est incluse depuis sa sous-page de documentation. Veuillez placer les catégories sur cette page-là.
Les éditeurs peuvent travailler dans le bac à sable (créer).
Voir les statistiques d'appel depuis le wikicode sur l'outil wstat et les appels depuis d'autres modules.

local contries = require 'Module:Country data'
local linguistic = require 'Module:Linguistique'
local wikidata = require 'Module:Wikidata'

-- TODO: Ajouter une carte de localisation?

local p = {}

local function getCity(statement)
	local name = wikidata.formatSnak(statement.mainsnak) or ''
	local references = wikidata.getReferences(statement)
	-- TODO: Ajouter le drapeau de la ville
	return name .. (wikidata.sourceStr(references) or '')
end

local function getCountry(statement)
	local entity = wikidata.getMainId(statement)
	-- TODO: changer atdate pour les jumelages terminés
	local country = wikidata.getClaims({entity = entity, property = 'P17',
		numval=1, atdate = 'today'})
	if country then
		local qid = wikidata.getMainId(country[1])
		-- TODO personnaliser args.date pour contries.standarddisplay
		-- TODO fix sort
		return contries.standarddisplay(qid, {})
			or wikidata.formatStatement(country[1])
	end
end

local function getPeriod(statement)
	return wikidata.getFormattedDate(statement)
end

local function getDefaultTitle(entity)
	local title = 'Jumelages et partenariats'
	local locationName = wikidata.getLabel(entity)
	if locationName then
		return title .. ' ' .. linguistic.of(locationName) .. '.'
	end
	return title .. '.'
end

function p.tableauDesJumelages(frame)
	local templateArgs = frame:getParent().args
	
	-- Entité Wikidata
	local entity = wikidata.getEntity(templateArgs.wikidata)
	if not entity then
		return mw.html.create('span')
			:addClass('error')
			:wikitext('Pas d\'entité Wikidata pour l\'élément.')
			:done()
	end
	
	local twinCities = wikidata.getClaims({entity = entity,
		property = 'P190', sorttype = 'chronological', rank = 'valid'})
	
	if not twinCities then
		return
	end
	
	local title = templateArgs.titre
		or getDefaultTitle(entity)

	local tab = mw.html.create('table')
		:addClass('wikitable')
		:addClass('centre')
		:addClass('sortable')
	
	tab = tab:node(mw.html.create('caption')
		:wikitext(title)
		:done()) --titre

	local columns = {
		{fn = getCity, colName = 'Ville'},
		{fn = getCountry, colName = 'Pays'},
    	{fn = getPeriod, colName = 'Période'},
	}
	
	local data = {}
	for _, statement in ipairs(twinCities) do
		local cityData = {}
		for _, column in ipairs(columns) do
			value = column.fn(statement)
			table.insert(cityData, value)
			if value and not column.hasValues then
				column.hasValues = true
			end
		end
		table.insert(data, cityData)
	end

	local tr = mw.html.create('tr')
	for _, column in pairs(columns) do
		if column.hasValues then
			tr = tr:node(mw.html.create('th')
			:attr('scope', 'col')
			:wikitext(column.colName)
			:done())
		end
	end
	tab = tab:node(tr:done())
	
	for _, cityData in ipairs(data) do
		local tr = mw.html.create('tr')
		for j, column in pairs(columns) do
			if column.hasValues then
				tr = tr:node(mw.html.create('td')
					:wikitext(cityData[j]))
			end
		end
		tab = tab:node(tr:done())
	end
	
	return tab:done()
end

return p