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 how to create and edit a custom plugin for all of your tweaks to the core plugin and for any Add Ons you are using.
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 helps your developers and our support team know exactly WHERE the custom code is located as it relates to your Paid Memberships Pro setup.
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
- Download the blank customizations plugin (.zip)
- Upload the .zip file via the Plugins > Add New > Upload page in your WordPress admin.
- Activate the plugin.
- Create a folder called
wp-content/pluginsfolder of your site.
- Create a file called
pmpro-customizations.phpin the folder you just created.
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.
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.
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.