وحدة:Sports table/Volleyball

This style for Lua-based Module:Sports table is meant to build group and league tables for competitions with a volleyball format. Note that this module is used extensively, so test potential changes rigorously in the sandbox and please ensure consensus exists before implementing major changes. The rest of this documentation explains how to use this module with the WL style in an article or template, check the table of contents for specific items.

Usage

Basic usage

In it's simplest form only several parameters need to be used to build a table

In article

What you type {{#invoke:Sports table|main|style=Volleyball


|team1=FDT |team2=BBB |team3=CCC |team4=DDD |team5=EEE

|bwin_FDT=4 |swin_FDT=1 |sloss_FDT=0 |bloss_FDT=0 |sw_FDT=15 |sl_FDT=3 |spw_FDT=423 |spl_FDT=210
|bwin_BBB=3 |swin_BBB=0 |sloss_BBB=1 |bloss_BBB=0 |sw_BBB=9 |sl_BBB=4 |spw_BBB=377 |spl_BBB=251
|bwin_CCC=1 |swin_CCC=2 |sloss_CCC=0 |bloss_CCC=2 |sw_CCC=9 |sl_CCC=5 |spw_CCC=301 |spl_CCC=287
|bwin_DDD=1 |swin_DDD=0 |sloss_DDD=0 |bloss_DDD=3 |sw_DDD=3 |sl_DDD=9 |spw_DDD=222 |spl_DDD=327
|bwin_EEE=0 |swin_EEE=0 |sloss_EEE=2 |bloss_EEE=3 |sw_EEE=0 |sl_EEE=15 |spw_EEE=151 |spl_EEE=399

|name_FDT=[[Dream Team]]
|name_BBB=Team 2
|name_CCC=Team 3
|name_EEE={{bk|GIB}}
}}

What it looks like
م Team Pld W L Pts SW SL SR SPW SPL SPR
1 Dream Team 5 5 0 14 15 3 5�000 423 210 2٫014
2 Team 2 4 3 1 10 9 4 2٫250 377 251 1٫502
3 Team 3 5 3 2 7 9 5 1٫800 301 287 1٫049
4 DDD 4 1 3 3 3 9 0٫333 222 327 0٫679
5  جبل طارق 5 0 5 2 0 15 0�000 151 399 0٫378
تم تحديثها حتى المباريات التي لعبت في unknown. مصدر: [بحاجة لمصدر]

The main command is the {{#invoke:Sports table|main|style=Volleyball}} statement which basically calls the module and enables you to set everything up. Then you list the positions of the teams as |team1=, |team2=, etc for however many teams you need in the table. You can use full team names there without spaces if you want, but using codes (as in the example) can make it easier. For each team you now define the big wins small wins, small losses, big losses, sets won, sets lost, setpoints won and setpoints lost by using |bwin_TTT=, |swin_TTT=, |sloss_TTT=, |bloss_TTT=, |sw_TTT=, |sl_TTT=, |spw_TTT= and |spl_TTT= respectively (with TTT replaced by the team code). If you do not define these numbers, it is automatically assumed to be 0. It is good practice though to include them anyway and to align the columns using appropriate spaces (as in the example), so the code is easy to read. The last step now is to define the |name_TTT= parameters which determine what name is shown in the table, you can use wiki markup and templates in here as well. See #Dating to see how to change the update date.

In template

What you type {{#invoke:Sports table|main|style=Volleyball

|template_name=Example

|team1=FDT |team2=BBB |team3=CCC |team4=DDD |team5=EEE

|bwin_FDT=4 |swin_FDT=1 |sloss_FDT=0 |bloss_FDT=0 |sw_FDT=15 |sl_FDT=3 |spw_FDT=423 |spl_FDT=210
|bwin_BBB=3 |swin_BBB=0 |sloss_BBB=1 |bloss_BBB=0 |sw_BBB=9 |sl_BBB=4 |spw_BBB=377 |spl_BBB=251
|bwin_CCC=1 |swin_CCC=2 |sloss_CCC=0 |bloss_CCC=2 |sw_CCC=9 |sl_CCC=5 |spw_CCC=301 |spl_CCC=287
|bwin_DDD=1 |swin_DDD=0 |sloss_DDD=0 |bloss_DDD=3 |sw_DDD=3 |sl_DDD=9 |spw_DDD=222 |spl_DDD=327
|bwin_EEE=0 |swin_EEE=0 |sloss_EEE=2 |bloss_EEE=3 |sw_EEE=0 |sl_EEE=15 |spw_EEE=151 |spl_EEE=399

|name_FDT=[[Dream Team]]
|name_BBB=Team 2
|name_CCC=Team 3
|name_EEE={{bk|GIB}}
}}

What it looks like
م Team Pld W L Pts SW SL SR SPW SPL SPR
1 Dream Team 5 5 0 14 15 3 5�000 423 210 2٫014
2 Team 2 4 3 1 10 9 4 2٫250 377 251 1٫502
3 Team 3 5 3 2 7 9 5 1٫800 301 287 1٫049
4 DDD 4 1 3 3 3 9 0٫333 222 327 0٫679
5  جبل طارق 5 0 5 2 0 15 0�000 151 399 0٫378
تم تحديثها حتى المباريات التي لعبت في unknown. مصدر: [بحاجة لمصدر]

The markup is effectively the same, except the |template_name= with the actual name of the Template-page, which creates the V, T and E buttons that link to the template page (so you can easily reach it from any article it is included in).

Customization

Several things can be customized in these tables

Hiding played column

Setting |hide_played=yes hides the played column.

Wins or points

By default teams are ranked by wins, but also list points which can be adjusted as follows:

What you type {{#invoke:Sports table|main|style=Volleyball

|ranking_style=points

|team1=FDT |team2=BBB |team3=CCC |team4=DDD |team5=EEE

|bwin_FDT=4 |swin_FDT=1 |sloss_FDT=0 |bloss_FDT=0 |sw_FDT=15 |sl_FDT=3 |spw_FDT=423 |spl_FDT=210
|bwin_BBB=3 |swin_BBB=0 |sloss_BBB=1 |bloss_BBB=0 |sw_BBB=9 |sl_BBB=4 |spw_BBB=377 |spl_BBB=251
|bwin_CCC=1 |swin_CCC=2 |sloss_CCC=0 |bloss_CCC=2 |sw_CCC=9 |sl_CCC=5 |spw_CCC=301 |spl_CCC=287
|bwin_DDD=1 |swin_DDD=0 |sloss_DDD=0 |bloss_DDD=3 |sw_DDD=3 |sl_DDD=9 |spw_DDD=222 |spl_DDD=327
|bwin_EEE=0 |swin_EEE=0 |sloss_EEE=2 |bloss_EEE=3 |sw_EEE=0 |sl_EEE=15 |spw_EEE=151 |spl_EEE=399

|adjust_points_FDT=1.5
|adjust_points_EEE=-1.5

|name_FDT=[[Dream Team]]
|name_BBB=Team 2
|name_CCC=Team 3
|name_EEE={{bk|GIB}}

|bwinpoints=5
|swinpoints=1.5
|slosspoints=-0.1
|blosspoints=-0.8
}}

What it looks like
م Team Pld W L Pts SW SL SR SPW SPL SPR
1 Dream Team 5 5 0 23 15 3 5�000 423 210 2٫014
2 Team 2 4 3 1 14.9 9 4 2٫250 377 251 1٫502
3 Team 3 5 3 2 6.4 9 5 1٫800 301 287 1٫049
4 DDD 4 1 3 2.6 3 9 0٫333 222 327 0٫679
5  جبل طارق 5 0 5 −4.1 0 15 0�000 151 399 0٫378
تم تحديثها حتى المباريات التي لعبت في unknown. مصدر: [بحاجة لمصدر]

As a default a big win is worth 3 points, a small win 2 points, a small loss 1 point and a big loss 0 points, these values can be overwritten to what you need by |bwinpoints=, |swinpoints=, |slosspoints= and |blosspoints=. Teams can also start the season with bonus or penalty points, this can be included by using |adjust_points_TTT= for that specific team.

Alternatively teams can also be ranked by points (set |ranking_style=points to bold that row instead) وحدة:Sports table/شرح/doc


-- Style for football tables
local pp = {}
 
function pp.header(t,Args,p_sub,pos_label,group_col,VTE_text,full_table,results_header_txt)
	-- Load relevant modules
	local yesno = require('Module:Yesno')
	
	-- Create table header
	-- Pre stuff
	local team_width = Args['teamwidth'] or '170'
	local sort_text = ''
	local sort_table_val = Args['sortable_table'] 	or 'no'
	if yesno(sort_table_val) then sort_text = 'sortable' end
	local show_played = true
	local hide_played_val = Args['hide_played'] 	or 'no'
	if yesno(hide_played_val) then show_played = false end
	
	-- Custom header
	local group_head_text = Args['group_header'] or '<abbr title="Group">Grp</abbr>'
	
	table.insert(t,'{|class="wikitable '..sort_text..'" style="text-align:center;"\n')            			-- Open table
	
	-- Initialize
	local tt = {}
	tt.count = 0 		-- Up by one after every call
	tt.tab_text = t		-- Actual text
	-- Actual headers
	tt = p_sub.colhead(tt,28,pos_label)										-- Position col
	-- Add group header
	if full_table and group_col then
		tt = p_sub.colhead(tt,28,group_head_text)							-- Group col
	end
	tt = p_sub.colhead(tt,team_width,'Team'..VTE_text)						-- Team col
	if show_played then
		tt = p_sub.colhead(tt,28,'<abbr title="Played">Pld</abbr>')			-- Matches played col
	end
	
	if full_table then
		tt = p_sub.colhead(tt,28,'<abbr title="Won">W</abbr>')				-- Win col
		tt = p_sub.colhead(tt,28,'<abbr title="Lost">L</abbr>')				-- Loss col
	end

	tt = p_sub.colhead(tt,28,'<abbr title="Points">Pts</abbr>')			-- Points col
	
	if full_table then
		tt = p_sub.colhead(tt,28,'<abbr title="Sets won">SW</abbr>')	    -- Sets won col
		tt = p_sub.colhead(tt,28,'<abbr title="Sets lost">SL</abbr>')		-- Sets lost col
		tt = p_sub.colhead(tt,36,'<abbr title="Set ratio">SR</abbr>')		-- Set ratio col
		tt = p_sub.colhead(tt,32,'<abbr title="Setpoints won">SPW</abbr>')	-- Setpoints won col
		tt = p_sub.colhead(tt,32,'<abbr title="Setpoints lost">SPL</abbr>')	-- Setpoints lost col
		tt = p_sub.colhead(tt,36,'<abbr title="Setpoint ratio">SPR</abbr>')	-- Setpoint ratio col
	end
 
 	if full_table then
		tt.count = tt.count+1
		table.insert(tt.tab_text,results_header_txt)
	end
 
	return tt
end
 
function pp.row(frame,t,Args,p_sub,notes_exist,hth_id_list,full_table,rand_val,team_list,team_code_ii,ii_start,ii_end,ii_fw,bg_col,N_teams,ii,ii_show)
	-- Build the inner parts of individual rows
	
	-- Sub-module usage
	local mm = require('Module:Math')
	local yesno = require('Module:Yesno')
	
	-- Get custom/default options for in table
	local bwin_points = tonumber(Args['bwinpoints'])			or 3
	local swin_points = tonumber(Args['swinpoints'])			or 2
	local sloss_points = tonumber(Args['slosspoints'])			or 1
	local bloss_points = tonumber(Args['blosspoints'])			or 0
 
	-- Get some input
	local bigwins = tonumber(Args['bwin_'..team_code_ii])		or 0
	local smallwins = tonumber(Args['swin_'..team_code_ii])		or 0
	local biglosses = tonumber(Args['bloss_'..team_code_ii])	or 0
	local smallosses = tonumber(Args['sloss_'..team_code_ii])	or 0
	local setswon = tonumber(Args['sw_'..team_code_ii]) 		or 0
	local setslost = tonumber(Args['sl_'..team_code_ii])		or 0
	local setpointswon = tonumber(Args['spw_'..team_code_ii]) 	or 0
	local setpointslost = tonumber(Args['spl_'..team_code_ii])	or 0
	local s_pts = tonumber(Args['adjust_points_'..team_code_ii]) or tonumber(Args['startpoints_'..team_code_ii]) or 0
	local hth_local = Args['hth_'..team_code_ii]				or nil
	
	-- Then calculate some values
	local matches = bigwins + smallwins + biglosses + smallosses
	local points = bwin_points*bigwins + swin_points*smallwins + sloss_points*smallosses + bloss_points*biglosses + s_pts
	local wins = bigwins + smallwins
	local losses = biglosses + smallosses

	-- Some local vars	
	local hth_string
	local tt_return = p_sub.hth(frame,Args,full_table,hth_id_list,hth_local,notes_exist,team_list,team_code_ii,ii_start,ii_end,rand_val)
	hth_string = tt_return.str
	hth_id_list = tt_return.list
	notes_exist = tt_return.notes_exist
 
 	-- What to rank the teams by
	local ranking_style = Args['ranking_style'] or 'wins'
	local win_fw, win_string, pts_fw, pts_string
	ranking_style = string.lower(ranking_style)
	if ranking_style=='p' or ranking_style=='pts' or ranking_style=='points' then
		-- Based on points
		win_fw=ii_fw
		win_string = ''
		pts_fw = 'font-weight: bold;'
		pts_string = hth_string
	else
		-- Based on wins
		win_fw = 'font-weight: bold;'
		win_string = hth_string
		pts_fw=ii_fw
		pts_string = ''
	end
	
	-- Show games played
	local show_played = true
	local hide_played_val = Args['hide_played'] 	or 'no'
	if yesno(hide_played_val) then show_played = false end
	
	-- Set ratio
	local sratio
	if setslost == 0 then
		sratio = '&mdash;'
	else
		sratio = mm._precision_format(setswon / setslost, 3)
	end
	
	-- Setpoint ratio
	local spratio
	if setpointslost == 0 then
		spratio = '&mdash;'
	else
		spratio = mm._precision_format(setpointswon / setpointslost, 3)
	end

	-- Row building
	if show_played then
		table.insert(t,'| style="'..ii_fw..bg_col..'" |'..matches..'\n') 		-- Played
	end
	if full_table then
		table.insert(t,'| style="'..win_fw..bg_col..'" |'..wins..win_string..'\n') 	-- Won
		table.insert(t,'| style="'..ii_fw..bg_col..'" |'..losses..'\n') 		    -- Lost
	end
	
	if points<0 then
		table.insert(t,'| style="'..pts_fw..bg_col..'" | &minus;'..-points..pts_string..'\n')
	else
		table.insert(t,'| style="'..pts_fw..bg_col..'" | '..points..pts_string..'\n')
	end
	
	if full_table then
		table.insert(t,'| style="'..ii_fw..bg_col..'" |'..setswon..'\n') 		-- SW
		table.insert(t,'| style="'..ii_fw..bg_col..'" |'..setslost..'\n')		-- SL
		table.insert(t,'| style="'..ii_fw..bg_col..'" |'..sratio..'\n')   		-- Set ratio
		table.insert(t,'| style="'..ii_fw..bg_col..'" |'..setpointswon..'\n') 	-- SPW
		table.insert(t,'| style="'..ii_fw..bg_col..'" |'..setpointslost..'\n')	-- SPL
		table.insert(t,'| style="'..ii_fw..bg_col..'" |'..spratio..'\n')   		-- Setpoint ratio
	end

	return {t=t, notes_exist=notes_exist, hth_id_list=hth_id_list}
end
 
function pp.status(Args)
	-- Declare status options
	-- ------------------------------------------------------------
	-- NOTE: If you add to status_code, also add to status_called and status_letters!!
	-- Or functionality will be compromised
	-- ------------------------------------------------------------
	local status_code, status_called = {}
	status_code = {	A='Advances to a further round', C='Champion', D='Disqualified', 
		E='Eliminated', H='Host', O='Play-off winner', P='Promoted', Q='Qualified to the phase indicated',
		R='Relegated', T='Qualified, but not yet to the particular phase indicated',
		X='?', Y='?', Z='?'}
	status_called = {	A=false, C=false, D=false, E=false, H=false, O=false, P=false,
		Q=false, R=false, T=false, X=false, Y=false, Z=false}
	local status_letters = 'ACDEHOPQRTXYZ'
	
	-- Status position (before or after read and default)
	local stat_pos_val = Args['status_pos'] or ''
	local status_position = 'after' 	-- Default location
	stat_pos_val = string.lower(stat_pos_val)
	if stat_pos_val=='before' then
		status_position = 'before'
	elseif stat_pos_val=='after' then
		status_position = 'after'
	end
	
	-- Read in custom status options
	if Args['status_text_X'] then status_code.X = Args['status_text_X'] end
	if Args['status_text_Y'] then status_code.Y = Args['status_text_Y'] end
	if Args['status_text_Z'] then status_code.Z = Args['status_text_Z'] end
	
	return {code=status_code, called=status_called, letters=status_letters, position=status_position}
end

return pp