Admin Filters for MemberPress
| 开发者 | omarelhawary |
|---|---|
| 更新时间 | 2026年5月8日 23:06 |
| PHP版本: | 8.1 及以上 |
| WordPress版本: | 6.9 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
Admin Filters for MemberPress extends the MemberPress -> Members, Subscriptions, Lifetimes, and Transactions admin screens 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.
GET requests) and builds SQL EXISTS conditions on wp_usermeta scoped to each list query. No data is sent to external services by this plugin.
What you get
- Extra filter controls on the MemberPress -> Members, Subscriptions, Lifetimes, and Transactions admin lists so you can narrow rows by address, registration fields, and (optionally) other stored member data you wire in with code.
- Each list still works like MemberPress; this plugin only adds filtering options for administrators.
安装:
- 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.
常见问题:
Does this plugin include MemberPress?
No. You must purchase and install MemberPress separately. This plugin only adds filters to the supported MemberPress admin lists when MemberPress is active.
Where do I use the filters?
In the WordPress admin, open MemberPress -> Members (or Subscriptions, Lifetimes, or Transactions). 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 those admin MemberPress list screens. 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.
What happens if MemberPress is turned off?
The plugin waits quietly. Once MemberPress is active again, the filters show on the supported lists as before.
Where do I get support for this plugin?
Use the Support forum on WordPress.org for Admin Filters for MemberPress.
How do developers extend the filters?
- Filter hook for extra meta-based filter definitions:
meprmf_members_meta_filters_fields. - Optional UI hook (floating Filters panel vs inline toolbar):
meprmf_use_floating_members_panel. - Source and issues: see Plugin URI and GitHub URI in the main plugin file header (
admin-filters-for-memberpress.php).
更新日志:
1.7.0
- Subscriptions, Lifetimes, and Transactions: the same address and Settings → Fields meta filters as on Members, scoped to each list’s user column (
mepr_list_table_args). - Floating Filters panel: print panel markup in
admin_footeron supported screens so MemberPress toolbar markup stays valid; filtermeprmf_use_floating_meta_filters_panelto control the panel per screen (Members still respectsmeprmf_use_floating_members_panel). - Build: minify floating-panel JS and toolbar CSS with esbuild when building the release zip (
npm run buildfrombuild-release.sh).
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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).