amr users plus

Adds features to amr-users:

  • custom (alphabetical) navigation
    • choose which field to ‘index’ on – last name, display name, company name, region ?
    • enter own alphabet or set of characters to filter on – other values will be shown under ‘other’
  • Add ability to do real time filtering, and partial column filtering. (Note: for very simple filtering needs, you can write your own html
  • Filtering options can be defined per column.  Filter options can be normal or unusual:
    • Column values: normal filtering
    • Column empty or not: sometimes one only needs/wants to see/remove lines with blank/non blank values. EG: who has entered first names?
    • Field filter options: A column may be composed of many fields strung together. These options will cause a full search on the individual values in the fields in the columns. The cache cannot be used.
    • Field empty or not: filters blank/non blank on fields. The nice field names become the filter values. To find these values, the cache cannot be used. Result may be slow on big lists.
    • Field values: Allows The field values to become filter values. Cache will not be used as the cache no longer knows about fields.
  • Linking to a detail page provided by list 2.  It assumes you are using list 1 as your user directory and list 2 as your profile display page.  Only really relevant for front end lists.
  • Formats for fields where a field type has been defined. These are pluggable functions for extra flexibility. As at Oct, 2017 these are implemented :
    • boolean – tick or cross
    • boolean – true or false
    • image where image url is given
    • timestamp as datetime
    • timestamp as date
    • timestamp as time
    • timestamp as ‘ago’
    • timestamp as age
    • datetime as date
    • datetime as time
    • datetime as ‘ago’
    • datetime as age
    • email as mailto (note: for wp user email one can also use the linktype)
  • Formats still to come – may show greyed out if the matching function (eg: ausers_format_fieldtype_format ) is not available.  The fieldtypes are usually added by the base free plugin.  Formats for fieldtypes can be added via filters in addons:
    • telephone – text with call html
    • telephone – phone icon with call link
    • integer – ?
    • currency – ?
    • floating point number



user list with lower case latin alphabet and custom text

user list with lower case latin alphabet and custom text

Create a custom alphabet

Create a custom alphabet

Filter the user list on any field including custom and meta values

Filter on any field

User List with filtering above the list on custom fields

User List with filtering above the list on custom fields

  1. Activate the ‘plus’ plugin
  2. Configure a list – click the  ‘navigation’  tab
  3. Customised and save the navigation settings (optional)
    1. maybe it is just the fieldname to index on that you need to change?
    2. ensure that the combination of settings makes sense.
  4. In the list’s overview settings switch custom navigation on
  5. Rebuild the cache
  6. View the list

Enable custom navigation in the overview settings if not already enabled.

Customise the navigation

Filtering instructions

  1. Activate the ‘plus’ plugin.
  2. In Configure the list, click the ‘filtering’ tab (now functional)
  3. Choose the filter type for the fields you wish to filter by  (they must of course be in your list)
  4. Click Update
  5. In the configure list overview settings, specify where filtering should be show in the public view (in table headers, above the list or not at all (field settings will be saved))
  6. Rebuild the cache

Configure Filtering


  • amr-users version 3.5.3 or later.


Filters are available to resort or otherwise rearrange the drop down values.

  • $lables = apply_filters (‘amr_filter_lables’, $lables, $col, $selected, $type);
  • $values = apply_filters (‘amr_filter_values’, $values, $col, $selected, $type);
  • $lables usually equals the values translation
  • $values is an array of keyed by the values and with the count of each value in the curret set of data
  • $col is the field name
  • $selected is the value that has been selected (if it has)
  • $type is the type of filtering in action (from your settings)


For latest files, please see