Skip to Content

Changes for page Users

From version 5.1
edited by Andrea Omicini
on 2026/08/29 00:50
Change comment: There is no comment for this version
To version 17.1
edited by Andrea Omicini
on 2026/08/29 18:30
Change comment: no index link in the footer when the page has a single group

Summary

Details

Page properties
Content
... ... @@ -1,78 +1,145 @@
1 1  {{velocity}}
2 2  ################################################################################
3 -## People — built from the `status` field of XWiki.XWikiUsers.
3 +## Users — built from the `status` field of XWiki.XWikiUsers.
4 4  ##
5 5  ## Nothing is hand-maintained here: the groups are the values declared by
6 6  ## XWiki.XWikiUsers.status, in the class's own order, and every user carrying a
7 7  ## status appears in exactly one of them. Add a status to the class and it shows
8 -## up here; change someone's status and they move.
8 +## up here; change someone's status and they move. Disabled accounts (active = 0)
9 +## are left out.
9 9  ##
11 +## ?status=<value> narrows the page to that one group. The value is checked
12 +## against the list the class itself declares, so no status value is written
13 +## down here: change the class and grouping, filter and bar all follow.
14 +##
10 10  ## Headings use the translation keys XWiki.XWikiUsers_status_<value>, so the page
11 11  ## is bilingual without a single string of its own.
17 +##
18 +## Layout follows the house pattern of Talks.PerYear.Showcase: mainheader,
19 +## mainselectbar index, then one mainselectseparator / mainselectbottom per group.
12 12  ################################################################################
13 13  ##
14 -## the groups, in class order,users themselves
15 -#set( $statusList = $xwiki.getDocument('XWiki.XWiket('status').getListValues() )
16 -#set( $people = {} ) #foreach( $s in $statusList )
17 - #set( $discard = $people.put($s, []) ) #end
18 -## distinct: a user page with a translation (XWiki.AntonioNatali.it) returns one rowlocale
19 -#set( $rows = $services.query.xwql("select distinct doc.fullName from Document doc, doc.object(XWiki.XWikiUsers) a.execute() )
22 +## the groups, in class order, and the people, from the users themselves
23 +#set( $statusList = $xwiki.getDocument('XWiki.XWikiUsers').getxWikiClass().get('status').getListValues() )
24 +## an optional ?status=<value> filter. The value is validated against the list the
25 +## class itself declares, so no status value is written down here: change the class
26 +## and both the grouping and the filter follow.
27 +#set( $wanted = "$!request.getParameter('status')" )
28 +#set( $known = ( $wanted == '' || $statusList.contains($wanted) ) )
29 +#set( $people = {} )
30 +#foreach( $s in $statusList )
31 + #set( $discard = $people.put($s, []) )
32 +#end
33 +## distinct: a user page with a translation (XWiki.AntonioNatali.it) returns one row per locale
34 +#set( $rows = $services.query.xwql("select distinct doc.fullName from Document doc, doc.object(XWiki.XWikiUsers) as u where u.status <> ''").execute() )
20 20  #set( $seen = [] )
21 21  #foreach( $ref in $rows )
22 22   #set( $uDoc = $xwiki.getDocument($ref) )
23 - #set( $uObj = $uDoc.getObjec
38 + #set( $uObj = $uDoc.getObject('XWiki.XWikiUsers') )
24 24   #set( $st = "$!uObj.getValue('status')" )
25 - #if( $people.containsKey($st )
40 + ## `active` is unset on most user objects, so only an explicit 0 counts as disabled
41 + #set( $isActive = ("$!uObj.getValue('active')" != '0') )
42 + #if( $people.containsKey($st) && $isActive && !$seen.contains($ref) )
26 26   #set( $discard = $seen.add($ref) )
27 - ## sort key: surname, thenrence
44 + ## sort key: surname, then given name, then the reference
28 28   #set( $last = "$!uObj.getValue('last_name')" )
29 - #set( $first = "$!uObj.get
46 + #set( $first = "$!uObj.getValue('first_name')" )
30 30   #set( $discard = $people.get($st).add("${last}|${first}|${ref}") )
31 31   #end
32 32  #end
33 33  ##
51 +## the groups actually on this page, in class order, and the head count
52 +#set( $shown = [] )
53 +#set( $total = 0 )
54 +#foreach( $s in $statusList )
55 + #if( ( $wanted == '' || $s == $wanted ) && !$people.get($s).isEmpty() )
56 + #set( $discard = $shown.add($s) )
57 + #set( $total = $total + $people.get($s).size() )
58 + #end
59 +#end
60 +##
34 34  ## one person: given name + bold surname, linked to their XWiki user page
35 35  #macro( apicePerson $entry )
36 36   #set( $bits = $entry.split('\|') )
37 -[[${bits[1]} **${bits[0]}**>>$
64 +[[${bits[1]} **${bits[0]}**>>${bits[2]}]]##
38 38  #end
39 39  ##
40 -## a section, printed only when somebody is in it
41 -#macro( apiceGroup $status )
42 - #set( $group = $people.get($status) )
43 - #if( $group && !$group.isEmp
44 - #set( $group = $collectiontool.sort($group) )
45 -
46 ->$services.localization.render("XWiki.XWikiUsers_status_${status}")
47 -(%%)//($group.size())//
48 -
49 - #foreach( $entry in $group• #end#apicePerson($entry)#end
50 -
51 - #end
67 +## how many, spelled for one or many
68 +#macro( apiceCount $n )
69 +$n #if( $n == 1 )$services.localization.render('user').toLowerCase()#else$services.localization.render('users').toLowerCase()#end##
52 52  #end
53 53  ##
54 -#### CURRENT PEOPLE — every status except students and past members
55 -#foreach( $s in $statusList )
56 - #if( $s != 'Student' && $s != 'Gone' )
57 - #apiceGroup($s)
58 - #end
59 -#end
72 +{{html clean="false" wiki="true"}}
73 +#template('apice_macros.vm')
60 60  ##
61 -#### PAST MEMBERS
62 -#apiceGroup('Gone')
63 -##
75 +#if( !$known )
76 +#### the class does not declare this value — say so, and show what it does declare
77 +<div class="mainheader">
78 +{{stringEngIta eng="Unknown status" ita="Stato sconosciuto"/}}
79 +<span class="textsecondary">&ensp;/&ensp;</span>
80 +$escapetool.xml($wanted)
81 +</div>
82 +<div class="mainselectbar">
83 +#foreach( $s in $statusList )#if( !$foreach.first )&ensp;&bull;&ensp;#end[[$services.localization.render("XWiki.XWikiUsers_status_${s}")>>path:$doc.getURL('view', "status=${s}")]]#end
84 +</div>
85 +#else
86 +#### page subtitle: how many people, and over what
87 +<div class="mainheader">
88 +#apiceCount($total)
89 +#if( $wanted != '' )
90 +<span class="textsecondary">&ensp;/&ensp;</span>
91 +$services.localization.render("XWiki.XWikiUsers_status_${wanted}")
92 +#end
93 +</div>
94 +#if( $shown.isEmpty() )
95 +<div class="mainselectbar">
96 +{{stringEngIta eng="Nobody has this status" ita="Nessuno ha questo stato"/}}
97 +</div>
98 +#end
99 +#### the index bar, only when the page carries more than one group
100 +#if( $shown.size() > 1 )
101 +<div class="mainselectbar" id="index">
102 +#foreach( $s in $shown )#if( !$foreach.first )&ensp;&bull;&ensp;#end[[$services.localization.render("XWiki.XWikiUsers_status_${s}")>>||anchor="$s"]]#end
103 +</div>
104 +#end
105 +#### one block per group: separator, the people, footer
106 +#foreach( $s in $shown )
107 +<div class="mainselectseparator">
108 + <a class="mainselectseparatorlink" id="$s" href=$doc.getURL('view', "status=${s}")>
109 + $services.localization.render("XWiki.XWikiUsers_status_${s}")
110 + </a>
111 +</div>
112 +<div style="font-style: normal">
113 +#set( $group = $collectiontool.sort($people.get($s)) )
114 +#foreach( $entry in $group )#if( !$foreach.first )&ensp;&bull;&ensp;#end#apicePerson($entry)#end
115 +</div>
116 +<div #if( $foreach.last )id="bottom"#end class="mainselectbottom">
117 +#apiceCount($people.get($s).size())
118 +<span class="textsecondary">&ensp;/&ensp;</span>
119 +$services.localization.render("XWiki.XWikiUsers_status_${s}")
120 +&ensp;&bull;&ensp;
121 +#### the shared macro also offers the index; with one group there is no index bar
122 +#if( $shown.size() > 1 )#anchorlinks()#else[[$services.localization.render('top').toLowerCase()>>||anchor="top"]] &bull; [[$services.localization.render('bottom').toLowerCase()>>||anchor="bottom"]]#end
123 +</div>
124 +#end
64 64  #### anyone whose status is not among those declared by the class — should be empty
126 +#if( $wanted == '' )
65 65  #set( $strays = [] )
66 66  #foreach( $ref in $rows )
67 - #set( $uObj = $xwiki.getDocui.XWikiUsers') )
129 + #set( $uObj = $xwiki.getDocument($ref).getObject('XWiki.XWikiUsers') )
68 68   #set( $st = "$!uObj.getValue('status')" )
69 - #if( !$people.containsKey($sys.add("${ref} (${st})") )#end
131 + #if( !$people.containsKey($st) )#set( $discard = $strays.add("${ref} (${st})") )#end
70 70  #end
71 71  #if( !$strays.isEmpty() )
72 -
73 ->{{stringEngIta eng="Unrecogni riconosciuto"/}}
74 -
75 - #foreach( $stray in $strays ) • #end#end
76 -
134 +<div class="mainselectseparator">
135 +{{stringEngIta eng="Unrecognised status" ita="Stato non riconosciuto"/}}
136 +</div>
137 +<div style="font-style: normal">
138 +#foreach( $stray in $strays )$stray#if( !$foreach.last )&ensp;&bull;&ensp;#end#end
139 +</div>
77 77  #end
141 +#end
142 +#end
143 +{{/html}}
78 78  {{/velocity}}
145 +