Developer’s Toolkit

Our Developer’s Toolkit Add On offers several development tools for Paid Memberships Pro sites. Some of the most popular features include:

• Database scripts to perform bulk data updates, like membership cancellations, user data deletion, and clearing report data.
• Debugging tools for checkout and email deliverability.
• Logic to migrate settings between two PMPro sites (import and export all settings or specific settings like customized email templates or membership levels).
• Settings to temporarily disable specific cron jobs from running.
• Scripts for sites to disable PMPro emails and scrub member data when imported into a staging site (for testing).

Keep reading to learn how to install this Add On and for help with all of the different development tools for your Paid Memberships Pro site.

Toolkit Options

Navigate to Memberships > Toolkit in the WordPress admin. From here you can explore all of Toolkit’s development tools, including:

Email Debugging

This setting redirects all Paid Memberships Pro emails to a specific address for debugging purposes.

1. Locate the Email Debugging section in Toolkit Options.
2. Enter the email address where you want all PMPro emails to be sent.
3. Click Save Changes to save your settings.

All email that Paid Memberships Pro attempts to send to your admins or users will now be sent to the specific debugging address.

Scheduled Cron Job Debugging

You can disable specific scheduled scripts that run daily via WP-Cron. This is useful for debugging issues in your membership site or when you want to temporarily stop these processes.

• Expire Memberships: Check to disable the script that checks for expired memberships.
• Expiration Warnings: Check to disable the script that sends expiration warnings to members.
• Credit Card Expirations: Check to disable the script that checks for expired credit cards.
• Click Save Settings at the bottom of the page.

Gateway/Checkout Debugging

Use these settings to enable debugging for various payment gateways like PayPal IPNs, Stripe Webhooks, Authorize.net Silent Posts, and more.

• Gateway Callback Debug Email: Enter the email address where you want the debug logs to be sent.
• Send Checkout Debug Email: Enable this feature to receive an email every time the Checkout page is submitted. The email will contain data about the request, user, membership level, order, and other relevant information.
• Click Save Settings at the bottom of the page.

Database Scripts

Navigate to Memberships > Toolkit > Database Scripts in the WordPress admin. This screen has many different scripts you can use to bulk manage data in your WordPress site. Check the box for the script you want to run (we recommend only running one script at a time). The script will run after select “Run Selected Tools“.

Database Clean Up Scripts

• Delete Member Data: Delete all member data. This script deletes data from the wp_pmpro_memberships_users, wp_pmpro_membership_orders, wp_pmpro_discount_codes_uses, wp_pmpro_subscriptions and wp_pmpro_subscriptionmeta  tables
• Reset Membership Settings: Delete all membership level, content protection, and discount code settings.
• Scrub Member Data: Scrub all member emails and transaction IDs.
• Delete Users: Deletes all non-admin users and their user meta information users and usermeta tables.
• Reset Options: Delete all PMPro options.
• Clear Logins Report: Clear and reset all visits, views, and logins report data.
• Delete Test Orders: Delete all orders made through the testing or sandbox gateway environment
• Clear Cached Report Data: Clear cached report data.

Member Scripts

• Change Membership Level: Use this script to bulk change members in one level to be in another level. Note: this script does not cancel any recurring subscriptions at the gateway.
• Assign Membership Level: Use this script to bulk apply a membership level to all users without an active membership level. Set the start date and end dates in the format: YYYY-MM-DD. Note: This only gives users the level via the database and does NOT fire the pmpro_change_membership_level hook or process live payments.
• Cancel Membership: Set the level ID to bulk cancel all members in that level. This script also cancels recurring subscriptions at the payment gateway and cannot be reversed.

Other Scripts

• Copy Content Restrictions: Use this script to make all pages that require a specific level ID to also require another level ID. This is useful when you add a new membership level to your site. Note: this script does not update uses of the Content Visibility block, membership shortcode, or membership requirements for post categories and tags.
• Delete Incomplete Orders: Run the Delete Incomplete Orders script.

Note: Some operations here may time out on slow servers or sites with a large number of users. Consider performing these actions during low-traffic periods or increasing your server’s timeout settings if necessary.

Toolkit Migration Assistant

Import and export functionality included in the Toolkit helps you to migrate settings between two PMPro sites. This is a useful development tool for Paid Memberships Pro users that want to set up a development site with a clone of your settings.

How to Import PMPro Settings

1. Navigate to Memberships > Toolkit > Migration Assistant in the WordPress admin.
2. Choose your settings file that you downloaded from another site (JSON format).
3. Click Import PMPro Data button to complete the import.
4. Click to confirm the import and data override in the popup window.

Once the import is complete, all of the included data will be updated in your membership site.

Your Email Templates, Payment, and Advanced Settings get replaced by any imported settings.

Membership Levels, however, are created as new levels in your site. We do not override existing membership levels that may already be in the destination WordPress site. For example, if you already have a membership level in the destination site named “Free” and import a new level named “Free”, the import will create a new level named “Free” with the settings based on the import. Each newly created level has a unique level ID.

How to Export PMPro Settings

1. To export membership site settings, navigate to Memberships > Toolkit > Migration Assistant in the WordPress admin.
2. Select which data to include in your export. The migration assistant supports exporting your Membership Levels, Email Templates, Payment & SSL Settings, Advanced Settings, and User Fields.
3. Or, use the Select all button to include all membership settings.
4. Click Export PMPro Data to complete the export.

Your browser will automatically download the settings file in JSON format.

Video: How to Import and Export Membership Settings

Screenshots

Action and Filter Hooks

apply_filters( 'pmpro_toolkit_allowed_import_options', $pmpro_options );

Customize the list of allowed import options when you import settings via the Toolkit Migration Assistant.