Last edited · 16 revisions  

 


Introduction:

The member management pages allow for the use of parameter queries on the URL line 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 help you perform certain/specific member management tasks quicker and easier, and by creating bookmarks, you can skip
 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:

https://groups.io/g/<groupname>/members?p=P1,P2,P3,P4,P5,P6,P7[&q=<search_criteria>]
or
https://groups.io/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 arejoined (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
  - I
f blank or none of these, default is members.

 

P3: Search query criteria, i.e. 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, all of the URLs below will produce the same screen output (search membership for all members whose name or email contains "chris", display 100 rows per page):
 
https://groups.io/g/<groupname>/members?p=,,chris,100,2,0,0
https://groups.io/g/<groupname>/members?p=,,chris,100,2,0,0&q=
https://groups.io/g/<groupname>/members?p=,,,100,2,0,0&q=chris
https://groups.io/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)
  - I
f 0, default is 20***

 *** You can set this default to a higher number, go to your account preferences (https://groups.io/account?page=prefs)

 

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)
  - I
f 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)
  - I
f 0, default is same as using 1  (start from the beginning)

 

P7:  ID for member on each group, not of much use.
  - Allowable values are: numeric only, no blank is allowed (if blank is used the list returns no rows)
  - I
f 0, default is ...

 

/q=<search_criteria>: Search query criteria, i.e. 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 
  - If blank <search_criteria> is used, it's the same as totally omitting this parameter from the URL line

Note this is an alternative version of P3 whereas it can be used just by itself.  It can also be used together with the above P format. <WHO TAKES PRECEDENCE??> 

 
Examples on using the parameters to perform certain tasks:
 

 (NOT FINISHED YET, WORK IN PROGRESS)