Many of our articles and code recipes include instructions on how to “customize and add this code to a plugin for customizations”. In addition, our support team may provide you with customizations to add to your site via this method.
This tutorial explains two methods for adding custom code to adjust your membership site functionality: creating a custom plugin or using the Code Snippets plugin available for free in the WordPress repository.
But can’t I just edit my theme?
We strongly recommend using the customization plugin method for a variety of reasons. To be clear, the file functions.php within any theme or child theme performs like a plugin in that it can execute php code. While adding code to your active theme’s functions.php file is often quicker than building a plugin, the downside is that if you change or update your theme, you’ll lose the functionality that was built into that theme. Code in a plugin will persist.
In addition, the use of a customizations plugin or the Code Snippets interface helps your developers and our support team know exactly WHERE the custom code is located as it relates to your Paid Memberships Pro setup.
How to Copy and Paste Custom PHP Recipes
Before you begin using a custom recipe, please read through our documentation on how to safely copy and paste PHP recipes. This guide is useful for beginner to intermediate level WordPress users who may not be very familiar with PHP and code.Read the Guide on Copying Custom PHP Recipes
Create a Plugin for PMPro Customizations
First, figure out how to FTP into your Website
While many of our Add Ons can be installed directly via your WordPress Dashboard, the customizations plugin is one instance where knowing how to use FTP to “put” or “edit” files on your web server is very important.
Your web host should have provided you with FTP or SFTP credentials. To properly log in to your web server you will need the:
- FTP (or SFTP) address
- (possibly) a port number and root directory
If you don’t know how to use FTP, this guide on the WordPress Codex provides some background on FTP and options for FTP clients, you can also refer to your web host’s FAQs and guides.
Creating Your Customizations Plugin
- Option 1: Download a Blank Customizations Plugin
- Download the blank customizations plugin (.zip)
- Upload the .zip file via the Plugins > Add New > Upload page in your WordPress admin.
- Activate the plugin.
- Option 2: Create a Customizations Plugin
- Create a folder called
wp-content/pluginsfolder of your site.
- Create a file called
pmpro-customizations.phpin the folder you just created.
- Edit the
pmpro-customizations.phpfile and paste this block of code into the file:
- Save the file.
- Upload the plugin via FTP to your website.
- Activate the plugin via the Plugins page of your WordPress Admin.
- Create a folder called
Editing Your Customizations Plugin
- Connect to your web server via FTP.
- Navigate to the
- Download the latest copy of the
- Open the file in your preferred editor.
- Add the code for the recipe or code shared via your support forum thread at the bottom of
- Save the File and upload the folder and file to your website via FTP.
Using the Code Snippets Plugin
Code Snippets by Shea Bunge is available for free download in the WordPress.org plugin repository. This plugin provides a simple way to run PHP code snippets (or what we call “recipes”) on your site. It removes the need to add custom snippets to your theme theme’s functions.php file or use a separate plugin for PMPro Customizations.
How to fix things if customizations break your site.
We understand that you may not be completely comfortable working “in the code”. If you are updating the customizations on your own and an update to the customizations plugin completely breaks your site, don’t fret.
These steps should repair your site:
- Connect to your website via FTP and navigate to the
- Rename the folder
pmpro-customizationsto anything else (I generally rename it to
- Now, visit your site. WordPress will automatically deactivate the plugin and, in doing do, your site should be restored.
- You can then repair any broken code in the file and rename the folder to the original
- Upload the updated file and reactivate the plugin via the ‘Plugins’ dashboard page.
Need to customize the appearance (CSS/stylesheet) of Paid Memberships Pro?
We have a separate guide that covers setting up CSS stylesheet for customizations to your Paid Memberships Pro-powered membership site.View the PMPro Customizations Stylesheet Tutorial