Introduction:
The member management pages allow for the use of parameter queries on the URL which can make your Admin life a lot easier when editing the membership list, especially if you have a large number of members.
When you go the Member management pages, the URL is the standard no-parameter version, i.e.?
https://groups.io/g/<groupname>/members
?
and the code uses the built-in defaults for the parameters.? If you select any criteria on that page, i.e. click on "email" to sort on the email address, the URL will now change to:
?
https://groups.io/g/<groupname>/members?p=email,members,,0,1,0,0
Knowing how to manipulate those parameters will allow you to create browser bookmarks to setup and perform certain/specific member management tasks quickly without having to manually select the criteria on the page that you want to display, i.e. with one click you can go directly to the task you want to perform.? Examples on how and for what to use this functionality will follow after the parameter explanation.
Parameter Query format:
/g/<groupname>/members?p=P1,P2,P3,P4,P5,P6,P7[&q=<search_criteria>]
or
/g/<groupname>/members?q=<search_criteria>
?
(where [ ] means optional, and <groupname> <search_criteria> would be your own particulars)
??
?
P1:?Member list display sorting criteria, i.e. how to sort the member list
? -?Allowable values are:?joined?(DateApplied),?delivery?(EmailDeliveryType),?email?(EmailAddress),?fullname?(DisplayName)
? - If blank or none of the above, default is?joined?(SortAscending-oldest first)
?
P2:?Who to display, i.e. which [sub]set of the full member list to display.
? -?Allowable values are: [all]?members,?mods,?pending,?bouncing,?banned,?removed
? -?If blank?or none of these, default is?members.
?
P3:?Search query criteria, what you type in the Search box***
? -?Allowable values are: blank (for no criteria, i.e. return all members) or?whatever search criteria you want to use
? -?Default is blank
***Note that this parameter can also be passed as the /q= parameter, see more below;?for example, these three URLs will produce the same screen output (search membership for all members whose name or email contains "chris"):
/g/<groupname>/members?p=,,chris,100,2,0,0&q=
/g/<groupname>/members?p=,,,100,2,0,0&q=chris
/g/<groupname>/members?q=chris
?
P4:?How many members/rows to display per page.
? -?Allowable values are: numeric only,?no blank is allowed (if blank is used?the list returns no rows)
? -?If 0, default is?20***
?
P5:?Sorting order for P1.
? -?Allowable values are: 1?(SortAscending-oldest first) or?2?(SortDescending-newest first),?no blank is allowed (if blank is used?the list returns no rows)
? -?If 0, default?is?2
?
P6: Where to start displaying from within the member list.
? -?Allowable values are: numeric only,?no blank is allowed (if blank is used?the list returns no rows)
? -?If 0, default is same as using?1 ?(start from the beginning)
?
P7:? STILL LOOKING FOR INFO ON THIS, IT'S SOME KIND OF ID ME THINKS.
? -?Allowable values are: numeric only,?no blank is allowed (if blank is used?the list returns no rows)
? -?If 0, default is?...
?
/q=<search_criteria>
WIP
same as omitting this parameter
?
?
Examples on using the parameters to perform certain tasks:
?
?(NOT FINISHED YET, WORK IN PROGRESS)
?
?
The official Groups.io user documentation is in the Groups.io Help Center.