There are two fields that show details of date of registration.  When the plugin started I wanted to see a human based ‘days ago’ view as I found that much more helpful to assess how long a user had been a member.

Thus that is the real wordpress registration date fields default formatting.  If one hovers over the field full details of the actual date will show.

It is also possible for you to write your own formatting function to format the date any way you would like.   For those people who are unable to write their own functions from the example and just want to display the registration date, there is a ‘pseudo’ field created which is called ‘Registration Date’ – it is not a real field though and does not sort well.

Days ago for registration date

Registered days ago

• real registration date field formatted using wordpress’s human time difference date time function
• has hover text so you can see the actual date
• will sort by date
• will display the date in the csv extract

Registration date

• pseudo field created on the fly in display only
• doesn’t sort.  Sort by the ‘days ago’ field and then remove the display order to hide the field
• doesn’t show in csv

Registration and days ago in excel

Future

In the future there may be the possibility for one to choose from a range of formats. For  example I can imagine a number of possibilities:

• a range of date formatting options using php date format options
• human time diff, days ago
• birthday (no years)

Advanced Shortcode Parameters

From version 3.4.4, Parameters are available to overide list settings. If you are not a farly expert wordpress user, please use the settings rather to avoid confusing yourself. The parameters are for more expert users or more complex requirements. For example they allow one to reuse a single list on multiple pages but with different sort or filtering criteria.

Example of shortcode with parameters

• show_headings=1 (or 0)
• show_csv=1 (or 0)
• show_refresh=1 (or 0)
• show_search=1 (or 0)
• show_totals=1
• rows_perpage=n
• sort=columnname, can be used with
  • dir=SORT_ASC (or SORT_DESC)
• filter=show (or hide to hide the filtered column), must be used with
  • columnname=value       eg: roles=Subscriber
    

Parameter to show total records

Examples:

URL Parameter use opens up some possibilities that have been requested. EG: currently search only allows one to search the fields that are in the list. One can now add fields to the list, then ‘hide’ that field by adding a filter ‘*’ (display all with values) to it. Then the search will include that field, but not display it. (Personally I do not recommend this as i think it’s confusing.)

 filter=hide columnname=*

Special parameters:

• start_empty=1,
  • should be used with a search or filteroption to start with a blank list. See example blank user list at start
• show_randompage=1,
  • start at a random page. Eg: (using url parameter to test) http://directories.wpusersplugin.com/simple-user-list/?show_randompage=1.     Note if you are logged in as admin and see an exclamation mark – the cached html is still being shown.  Click on the exclamation mark to refresh.
• shuffle=1,
  • shuffle the results. Eg: http://directories.wpusersplugin.com/simple-user-list/?shuffle=1.

Several add-ons have been developed to extract data created by third party plugins and not stored in the wordpress user and user meta tables.

Request an add-on (charges apply) or If you some php skills, use the example plugin to write your own addon.

If you have a custom table that has user data in it, you can pull it into a list by writing a little site specific plugin and making use of some of the hooks available in the amr-users plugin.

The hooks you may need are:

• amr_get_fields (to add custom fields to the list of fields in usermeta table)
• amr_get_users (to add users to the list of existing  users) or
• amr_get_users_with_meta (to add data to array of existing users)

Read the filter documentation and see the add-on plugins to see how to use these hooks.  Many of the add-ons use them to add data from a variety of different styles of tables.

See https://wpusersplugin.com/2940/filters/#examples

More details

See one of the add-on plugins or thee xample site specific plugin.  Do NOT cut and paste the code here. It is meant to inform only and will NOT  work as is.

 add_filter('amr_get_fields', 'amr_add_my_fields', 1);

 add_filter('amr_get_users_with_meta', 'amr_get_my_users_data', 1);

function amr_add_my_fields ($keys) {

// write code here to return the list of additional fields
// you'd like to see in your user lists. 
//IE these are fields in your custom table that are 
//NOT in wordpress user or usermeta table.

// the function will be passed the existing list of fields 
//and should add the additional fields to the array.  eg: 

$keys[] = 'newfield';

return ($keys);

// then return the array $keys

}

function amr_get_my_users_data ($users) {

// write code here to get the user data from the custom tables. Various approaches are open to you.  Either

• drive from array of user passed to the function, or
• from the array of user data from your custom table.. then add to the users array passed extradata = sql query to fetch data from custom table keyed by userid;

for each $extradata {

    $users[$userid]['newfield'] =  $extradata['newfield'];

// then return the array $users
    return ($users);

/pre>
Alternative (or to format nicely)
The function above has to process ALL the users.  The data will then be available in csv export.  If you only need the data to be displayed, then you could use a formatting function  rather.  The amr-users plugin will look for a custom formatting function for each column to be displayed for each user.
function ausers_format_newfield($value, $user) {

  $customdata_maybearray = code to get data ($user->ID);

  $html = implode (', ',$customdata_maybearray)

}