• Skip to primary navigation
  • Skip to main content
  • Skip to primary sidebar

RocketGeek

Home of WP-Members, The Original WordPress Membership Plugin

  • WordPress Plugins
    • WP-Members
      • FAQs
      • Quick Start
      • Documentation
      • Extensions
    • Advanced Options
      • Documentation
      • Purchase the Plugin
      • Get the Pro Bundle
    • Download Protect
      • Documentation
      • Purchase the Plugin
      • Get the Pro Bundle
    • Invite Codes
      • Documentation
      • Purchase the Plugin
      • Get the Pro Bundle
    • MailChimp Integration
      • Documentation
      • Purchase the Plugin
      • Get the Pro Bundle
    • PayPal Subscriptions
      • Documentation
      • Purchase the Plugin
      • Get the Pro Bundle
    • Salesforce Web-to-Lead
    • Security
      • Documentation
      • Purchase the Plugin
      • Get the Pro Bundle
    • Text Editor
      • Purchase the Plugin
      • Get the Pro Bundle
    • User List
      • Documentation
      • Purchase the Plugin
      • Get the Pro Bundle
    • User Tracking
      • Documentation
      • Purchase the Plugin
      • Get the Pro Bundle
    • Memberships for WooCommerce
    • WordPass
  • Blog
    • Basics
    • Tips and Tricks
    • Filters
    • Actions
    • Code Snippets
    • Shortcodes
    • Design
    • Release Announcements
  • Store
    • Cart
    • Checkout
  • Contact
  • Log In
  • Show Search
Hide Search
Home » Plugins » WP-Members » Documentation » Filter Hooks » wpmem_ul_settings_args

wpmem_ul_settings_args

Description

This filter allows you to pass arguments to the User List to override default values set in the admin or passed through the shortcode. The wpmem_list_users function uses the wp_parse_args function to merge arguments passed through this filter with the following defaults:

$defaults = shortcode_atts( array(
    'display_style'=> 'list',       // list|table
    'role'         => 'subsriber',  // role to filter by
    'active_only'  => true,
    'verified_only' => true,
    'exclude'      => '',           // comma separated string of user ids
    'number'       => 10,           // number to display per page
    'search'       => true,         // is search enabled, "true"
    'search_by'    => '',           // comma separated string of meta keys
    'fields'       => 'user_login,member_since',
    'local_avatar' => false,        // whether to use a local avatar or gravatar
    'avatar'       => 45,           // size of the avatar in pixels
    'h2'           => 'first_last', // 
    'order_by'     => 'user_login',
    'order_meta'   => '',
    'order'        => 'ASC',
    'show_titles'  => false,
    'show_empty'   => true,
    'filter_key'   => '',
    'filter_value' => '',
    'fe_user_edit' => false,
), $atts, $tag );

Parameters

$args
(array) (required) An array of arguments that are to override form $defaults.

Changelog

Introduced in extension version 1.4

Source

wpmem_ul_settings_args is located in wp-members-user-list.php

Not sure what to do with this code?

You're not a "coder" and don't know what to do? Don't worry! Code Snippets are the basic building blocks of WordPress customization, and once you know the basics, they are simple to use.

Here are some free articles to get you started:

  • Using Code Snippets from the Site
  • Using a code snippets plugin
  • The functions.php File
  • Create a plugin file for custom functions
  • Create a child theme
  • Do not modify plugin files!

For "hands on" help, consider a plugin support subscription or the Pro Bundle.

WP-Members User List

Plugin Info

Current Stable Version: 2.1.4
Minimum WordPress Version: 5.0
Tested up to WordPress Version: 6.8
Last Updated: 2025-04-30

Documentation

    • Installation
    • Settings
    • Display the List
    • Profile Page
    • Stylesheets
    • Filter Hooks
    • Tips and Tricks
    • Manage License
    • Change Log

Get the Plugin

  • Purchase the Plugin
  • Get the Pro Bundle

Ready to get started?

Join Today!

© 2025 · butlerblog.com · RocketGeek is built using WordPress, WP-Members, and the Genesis Framework

  • butlerblog.com
  • WP-Members Support Subscription
  • Terms of Service
  • Privacy Policy
  • Refund Policy