Use this hook to execute custom code after a user’s membership level is changed or cancelled. This hook passes the new level ID, the user ID of the WordPress user, and the level ID being cancelled (if specified).
do_action( 'pmpro_after_change_membership_level', int $level_id, int $user_id, int $cancel_level );
Note: In cases where there may be multiple level changes during the same page load (e.g. when expiring many members at once or when using the Multiple Memberships per User add on) you may want to use the pmpro_after_all_membership_level_changes action hook, which only fires once per page load.
- int; the level ID being changed to
- int; the user ID whose level is changing
- int; the level ID of the level being cancelled if specified
File: https://github.com/strangerstudios/paid-memberships-pro/blob/master/includes/functions.phpView in Source Code
Related Articles and Recipes
Using Subscription Delays Add On for One-Time, Credit Card Required Trials By Kimberly Coleman
Automatically Approve Previously Approved Members By Andrew Lima
Send Members Confirmation Email when Admins Change their Membership Level By Jason Coleman
Send the New User Email to Members Added via Zapier By Travis Lima
Hide Pending or Denied Members from your Member Directory and Frontend Profile Page By Andrew Lima
Create and Manage Affiliates by Membership Level Using AffiliateWP By Kimberly Coleman
Set a Member Author’s Posts to Draft When Membership is Cancelled By Kimberly Coleman
Apply a BuddyPress “Member Type” on Membership Checkout or Level Change By Kimberly Coleman
Change Membership Level on Cancellation or Expiration By Kimberly Coleman
Offer Trial Memberships That Can Only Be Used Once By Andrew Lima
About Actions and Filters in PMPro
Hooks allow you to extend Paid Memberships Pro without editing any core plugin files. You can use a hook to program custom code that interacts with or modifies code in our plugin, Add Ons, your theme, and even WordPress itself.
There are two kinds of hooks: actions and filters.
- Action hooks allow you to run new custom code at pre-defined locations.
- Filter hooks allow you change or extend existing code by modifying the data and returning it back to the software.
Click here to browse the full database of action and filter hooks available in Paid Memberships Pro. For help extending our Add Ons, refer to the individual Add On's documentation page for a list of available hooks.
For more developer-focused information about Paid Memberships Pro, check out the advanced developer topics documentation.