Deskripzioa
Admin Filters for MemberPress extends the MemberPress Members admin screen with extra filters: MemberPress address fields (when your site captures them), every MemberPress registration Settings Fields field, and any further user meta filters you add with the meprmf_members_meta_filters_fields filter (for example in a small custom plugin).
This plugin is an independent project. It is not affiliated with, endorsed by, or sponsored by MemberPress.
Requirements
- WordPress 5.6 or newer and PHP 8.1 or newer.
- A working install of MemberPress. This extension does not ship MemberPress and cannot run without it.
Privacy
Filtering reads values you or your administrators submit on the Members list (standard admin GET requests) and builds SQL EXISTS conditions on wp_usermeta scoped to the list query. No data is sent to external services by this plugin.
What you get (in plain terms)
- Extra filter controls on the MemberPress Members screen so you can narrow the member list by address, registration fields, and (optionally) other stored member data you wire in with code.
- The member list itself still works like MemberPress; this plugin only adds filtering options for administrators.
- Support: Use the Support forum on wordpress.org for this plugin. MemberPress licensing and product support come from MemberPress / Caseproof.
- Trademark: “MemberPress” is a trademark of its owner. This plugin is not affiliated with, endorsed by, or sponsored by MemberPress.
- Developers: Filter hook for extra meta-based filters:
meprmf_members_meta_filters_fields. Optional UI hook:meprmf_use_floating_members_panel. Repository and issues: see the Plugin URI / GitHub URI in the main plugin file header.
Pantaila-argazkiak
Instalazioa
- Upload the plugin files to the
/wp-content/plugins/admin-filters-for-memberpressdirectory, or install the plugin through the WordPress plugins screen directly. - Activate the plugin through the Plugins screen in WordPress.
- Ensure MemberPress is already installed and active. If MemberPress is inactive, this plugin does nothing.
MEG
-
Does this plugin include MemberPress?
-
No. You must purchase and install MemberPress separately. This plugin only adds filters to the Members admin list when MemberPress is active.
-
Where do I use the filters?
-
In the WordPress admin, open MemberPress Members. Use the Filters area above the table to choose criteria, then apply them to refresh the list.
-
What can I filter members by?
-
- Address fields when your site collects them in MemberPress (for example country, city, postal code), including when address is captured on the account page.
- Every field you configure under MemberPress Settings Fields (registration / profile style fields).
- Extra user meta only if a developer adds filter definitions using the
meprmf_members_meta_filters_fieldsfilter hook (for data stored inwp_usermetathat is not already covered).
-
Does this change my public website or checkout?
-
No. It only affects the admin Members list. Visitors and the front of your site are unchanged.
-
Is member data sent to a third-party service?
-
No. Filtering runs inside your WordPress install and database. See the Privacy note in the description above.
-
I enabled address on signup or account — why don’t I see address filters?
-
Address filters are added when MemberPress collects address (Show on Signup and/or Show on Account). If you use the floating Filters panel, the plugin resets saved field visibility when the list of filter parameters changes so new fields are not left hidden by an older browser
localStorageentry. Reload MemberPress Members after changing MemberPress field settings. -
What happens if MemberPress is turned off?
-
The plugin waits quietly. Once MemberPress is active again, the filters show on Members as before.
Berrikuspenak
Ez dago berrikuspenik plugin honentzat.
Laguntzaileak eta Garatzaileak
“Admin Filters for MemberPress” software librea da. Ondoko pertsonek egin dizkiote ekarpenak plugin honi.
LaguntzaileakItzul zaitez Admin Filters for MemberPress zure hizkuntzara.
Garapena interesatzen zaizu?
Araka kodea, begiratu SVN biltegia edo harpidetu garapen erregistrora RSS bidez.
Aldaketen loga
This section follows the Version line in the main plugin file on the default branch. Version labels 1.6.3 and 1.6.4 were never used as semver bumps here (development went from 1.6.2 to 1.6.5). Commits that shipped on main while the header still read 1.5.0, before 1.6.1, are grouped under 1.5.0 so the git history is complete.
1.6.8
- Floating Filters panel: when the set of filter query params changes (for example after enabling MemberPress Show on Account or Show on Signup for address), reset saved field visibility so new address filters are not left hidden by an older
localStoragewhitelist. - Members provider: document address toggles explicitly; add a unit test for signup-only address capture.
1.6.7
- Improve escaping in Members filter controls (WordPress Plugin Check / PHPCS).
- Replace the languages directory placeholder with a non-hidden
index.phpso release zips avoid dotfiles flagged by Plugin Check. - Drop redundant
load_plugin_textdomain(); WordPress.org installs load translations automatically (WordPress 4.6+). - Clarify read-only admin
GETusage for script loading and filter query parameters where static analysis required it. - Toolbar renderer: clearer attribute handling and inline documentation for SQL / predicate behavior; document WordPress.org banner/icon layout under
wordpress-org-assets/. - README (GitHub): structure and screenshot guidance refresh.
1.6.6
- WordPress.org packaging: add
readme.txt, align the text domain with the plugin slug (admin-filters-for-memberpress), and clarify third-party / trademark disclaimer. - Remove the
Requires Plugins: memberpressheader because MemberPress is not distributed from the wordpress.org plugin directory (dependency is documented here instead). - Track a
languages/directory for translation drops (initial placeholder before the 1.6.7index.phplayout). - Release hygiene: tighten
.gitignore, extendscripts/build-release.sh, and alignreadme.txt/ README notes with the zip build and WordPress.org upload flow. - WordPress.org review: set Plugin URI to the plugin directory listing; correct GitHub repository URL in plugin header and developer metadata (
composer.json/ README where applicable). - Prefix compliance: rename the custom extension filter from
mepr_members_meta_filters_fieldstomeprmf_members_meta_filters_fields. If you added filters in code, update youradd_filterhook name.
1.6.5
- Floating Filters panel on MemberPress Members (field visibility in the browser via
localStorage; filtermeprmf_use_floating_members_panelto use the previous inline toolbar). - Address filters when MemberPress captures address on the account page only (not only at checkout).
- Refine filter control rendering for the floating panel.
- Style: toggle control layout and icon dimensions on the Members filters UI.
- README guidance for when to use extra user-meta filters vs MemberPress Settings Fields; slightly smaller Members toolbar typography for alignment.
1.6.2
- Raise minimum PHP to 8.1 (was 7.4). WordPress 5.6+ requirement unchanged.
- Run PHPUnit / CI on PHP 8.1 through 8.3.
- Skipped semver labels: 1.6.3 and 1.6.4 were not published from this repository; the next version after 1.6.2 was 1.6.5.
1.6.1
- Rebrand and paths: plugin folder
admin-filters-for-memberpress, main fileadmin-filters-for-memberpress.php(formerly MemberPress Members Meta Filters /memberpress-members-meta-filters.php). - Refactor monolithic bootstrap into
includes/classes with a compatibility layer incompat/legacy-functions.phpso existingmeprmf_*snippets keep working. - Add
uninstall.phpfor option cleanup on delete; remove redundantregister_uninstall_hookusage. - Add PHPUnit suite,
phpunit.xml.dist, and GitHub Actions workflow. - Consolidate filter field definition validation (duplicate
meta_keyrows, select rows missing choices, duplicate dropdown keys) and related helpers.
1.5.0
- Full MemberPress address filters: state/province, zip/postal code, and address lines 1 & 2 (in addition to country and city).
- Filter hook
meprmf_include_address_filtersto control when built-in address filters are shown (default follows MemberPress address capture settings). - Prefer MemberPress-configured address field labels when available.
-
Plugin header: Author URI and GitHub repository URI.
-
Pre-1.6.1 while the header still read 1.5.0 (monolithic memberpress-members-meta-filters.php): README sync — metadata and changelog match the shipped 1.4.0/1.5.0 feature set; document all six address filter fields.
- Uninstall: move option cleanup to
uninstall.phpand remove redundantregister_uninstall_hookusage. - Refactor: replace magic numbers with named constants; document maximum lengths enforced when validating filter
paramvalues. - Refactor: extract
meprmf_normalize_filter_fields()(and related helpers) for shared filter field validation. - Merge
develop(pull request #1): consolidate validation and handling for configured meta filters ahead of the rebrand.
1.4.0
- Declare Requires at least: 5.6 and Requires PHP: 7.4 in the plugin header.
- Guard plugin constants with
defined()checks so they are not redefined. - Load a text domain from the
languages/directory. - On uninstall, remove leftover plugin options when the plugin is deleted from wp-admin (
uninstall.php). - Stricter sanitization when normalizing filter field definitions: skip duplicate
meta_keyrows, require choices for select-type rows, and handle duplicate option keys in dropdown definitions.
1.3.0
- Initial release (as MemberPress Members Meta Filters): filters on the MemberPress Members admin list for country, city, and MemberPress custom fields (dropdown, radios, multiselect, checkboxes, checkbox, and text-style field types mapped to sensible controls).
- Apply list constraints via
EXISTSsubqueries onwp_usermetathroughmepr_list_table_args, scoped to the Members list query. - Compact collapsible filter layout when many filters are active (threshold filterable in later releases).

