Skip to Content

Changes for page Users

From version 4.1
edited by Andrea Omicini
on 2026/08/29 00:47
Change comment: There is no comment for this version
To version 18.1
edited by Andrea Omicini
on 2026/08/29 18:32
Change comment: lowercase the labels in the select bar

Summary

Details

Page properties
Content
... ... @@ -1,28 +1,46 @@
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 14  ## the groups, in class order, and the people, from the users themselves
15 15  #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) ) )
16 16  #set( $people = {} )
17 17  #foreach( $s in $statusList )
18 18   #set( $discard = $people.put($s, []) )
19 19  #end
20 -#set( $rows = $services.query.xwql("from doc.object(XWiki.XWikiUsers) as u where u.status <> ''").execute() )
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() )
35 +#set( $seen = [] )
21 21  #foreach( $ref in $rows )
22 22   #set( $uDoc = $xwiki.getDocument($ref) )
23 23   #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) )
43 + #set( $discard = $seen.add($ref) )
26 26   ## sort key: surname, then given name, then the reference
27 27   #set( $last = "$!uObj.getValue('last_name')" )
28 28   #set( $first = "$!uObj.getValue('first_name')" )
... ... @@ -30,43 +30,82 @@
30 30   #end
31 31  #end
32 32  ##
33 -## one person: given name + bold surname, linked to the personal space when there is one
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 +##
61 +## one person: given name + bold surname, linked to their XWiki user page
34 34  #macro( apicePerson $entry )
35 35   #set( $bits = $entry.split('\|') )
36 - #set( $pDoc = $xwiki.getDocument($bits[2]) )
37 - #set( $pObj = $pDoc.getObject('XWiki.XWikiUsers') )
38 - #set( $space = "$!pObj.getValue('personalWiki')" )
39 - #if( $space != '' && $xwiki.exists("${space}.WebHome") )#set( $target = "${space}.WebHome" )#else#set( $target = $bits[2] )#end
40 -[[${bits[1]} **${bits[0]}**>>${target}]]##
64 +[[${bits[1]} **${bits[0]}**>>${bits[2]}]]##
41 41  #end
42 42  ##
43 -## a section, printed only when somebody is in it
44 -#macro( apiceGroup $status )
45 - #set( $group = $people.get($status) )
46 - #if( $group && !$group.isEmpty() )
47 - #set( $group = $collectiontool.sort($group) )
48 -
49 ->$services.localization.render("XWiki.XWikiUsers_status_${status}") (%%)//($group.size())//
50 -
51 - #foreach( $entry in $group )#if( !$foreach.first ) • #end#apicePerson($entry)#end
52 -
53 - #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##
54 54  #end
55 55  ##
56 -#### CURRENT PEOPLE — every status except students and past members
57 -#foreach( $s in $statusList )
58 - #if( $s != 'Student' && $s != 'Gone' )
59 - #apiceGroup($s)
60 - #end
61 -#end
72 +{{html clean="false" wiki="true"}}
73 +#template('apice_macros.vm')
62 62  ##
63 -#### STUDENTS
64 -#apiceGroup('Student')
65 -##
66 -#### PAST MEMBERS
67 -#apiceGroup('Gone')
68 -##
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}").toLowerCase()>>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}").toLowerCase()>>||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
69 69  #### anyone whose status is not among those declared by the class — should be empty
126 +#if( $wanted == '' )
70 70  #set( $strays = [] )
71 71  #foreach( $ref in $rows )
72 72   #set( $uObj = $xwiki.getDocument($ref).getObject('XWiki.XWikiUsers') )
... ... @@ -74,10 +74,15 @@
74 74   #if( !$people.containsKey($st) )#set( $discard = $strays.add("${ref} (${st})") )#end
75 75  #end
76 76  #if( !$strays.isEmpty() )
77 -
78 ->{{stringEngIta eng="Unrecognised status" ita="Stato non riconosciuto"/}}
79 -
80 - #foreach( $stray in $strays )$stray#if( !$foreach.last ) • #end#end
81 -
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>
82 82  #end
141 +#end
142 +#end
143 +{{/html}}
83 83  {{/velocity}}
145 +