Installation
You must have the Paid Memberships Pro plugin installed and activated with a valid license type to use this Add On.
- Navigate to Memberships > Add Ons in the WordPress admin.
- Locate the Add On and click Install Now.
- To install this plugin manually, download the .zip file above, then upload the compressed directory via the Plugins > Add New > Upload Plugin screen in the WordPress admin.
- Activate the plugin through the Plugins screen in the WordPress admin.
Settings
This Add On is designed to only work for sites with:
- Paid Memberships Pro v3.0+
- Sites with the primary gateway set to Stripe onsite checkout or Braintree.
After installing and activating this Add On, make sure your Membership Levels page has the default levels page shortcode [pmpro_levels]
. This shortcode will display the proper layout where users can choose multiple levels to a single checkout / transaction.
Note: If you are using the Advanced Levels Page Add On, that levels pay layout will not be overwritten by this multiselect layout. You should not use Advanced Levels Page in combination with this legacy Add On.
There are no other settings to enable for this Add On. All of the level group settings and individual membership levels pricing logic is now handled in the core PMPro plugin.
Limited Support for Multiple, Simultaneous Level Checkouts
For some gateways and level setups, the former MMPU Add On allowed members to purchase multiple levels in a single checkout. This feature is not offered in the official v3.0 release, which merges MMPU features into core PMPro.
In core PMPro v3.0+, members can hold multiple membership levels, but they must make each level purchase through a distinct checkout process.
We created this MMPU Legacy Add On to allow members to purchase multiple levels in a single checkout for Stripe onsite checkout and Braintree gateways only. These are the only gateways that we can confidently support with this legacy Add On.
Note that this functionality is not going to be supported indefinitely. We are offering this MMPU (Legacy) plugin as an intermediate option for sites to upgrade to 3.0 and maintain their current multiple levels checkout experience.
Why PMPro Core Won’t Support Multiple Levels in a Single Checkout
Here are some factors that went into the decision to not support multiple levels in single checkout and how this may affect sites that were using this feature:
- One main goal for PMPro v3.0 was to merge the MMPU Add On into the core plugin. This brings MMPU out of “beta” and gives us a more robust base to build on for sites utilizing multiple levels per user.
- While preparing that merge, we realized that the feature allowing users to check out for multiple levels at the same time caused many conflicts that we wouldn’t be able to fully address for all of our users.
- First, the multiple membership checkouts feature was already not supported by all gateways.
- Even for supported gateways, the gateways are also moving their development in a direction where support could be restricted or removed later. (e.g. Stripe’s offsite option, Stripe Checkout, doesn’t work with this. Also, the rise of “Secure Customer Authorization” and “payment intents” means that credit card companies and the gateways want explicit confirmation for each individual subscription created.)
- Many of our checkout-related Add Ons are not compatible with this specific feature.
It was not an easy decision to drop support for multiple subscriptions in one checkout, but ultimately we decided to push development in that direction.
Timeline for MMPU Legacy Add On Support
- In the short term, sites can use this MMPU Legacy plugin or continue to run PMPro 2.12.x with the MMPU Add On. For about 1 year or so after the 3.0 release, we will continue to release important security updates for PMPro 2.12.
- In the medium term, many of our Add Ons and future updates to our checkout code and UI won’t be compatible with the feature to process multiple subscriptions in one checkout.
- In the long term, we expect Stripe and Braintree to drop support for the way we are processing these checkouts. At that time, this Add On will not work and all sites will need to move to single level purchases per checkout.
Action and Filter Hooks
apply_filters( 'pmprommpu_disable_levels_multiselect_page', false );
Filter to enable or disable the multiselect levels page template.
apply_filters( 'pmprommpu_gateway_supports_multiple_level_checkout', $has_support, $gateway );
Filter used to flag a payment gateway that supports multiple level checkouts in a single transaction/checkout process.
This is a Plus Add On.
Plus Add Ons are included in all Plus or higher premium membership plans.