Instructions

WordPress Plugin: My Custom Functions PRO

This is the “My Custom Functions PRO” plugin instructions page. We have tried our best to keep it as simple as possible. If you think it can be made even simpler let us know we will be glad to change it. Let’s start!

The following documentation is dedicated to version 3 of the plugin. If you need documentation for another version, please use one of the links below.

Documentation for “My Custom Functions PRO” v1
Documentation for “My Custom Functions PRO” v2
Documentation for “My Custom Functions PRO” v3 (this documentation)

On the left side, you can see the table of contents of this documentation. Jump to the section you want, or read it all through – your choice. Let’s move on!

This plugin is currently in the active development stage, which means that in the shortest possible time many new features will be added to it. As soon as we receive a request for a new feature, we immediately begin work on creating an update of the plugin to make our lovely customers happy. We are already preparing new versions for publication, and now they are undergoing testing. We will do our best to better develop the plugin and add the requested features as soon as possible.

Purchase process

To start using the “My Custom Functions PRO” plugin, you need to make a purchase on the official page of this plugin. To do this, select a license suitable for your case and make a payment. Secure payment of the plugin is done using the platform of our partner Gumroad.

After the successful completion of the purchase, you will receive an email receipt with a button through which you can download a copy of the plugin.

Download the latest release

Delivery of the “My Custom Functions PRO” plugin is done using the platform of our partner Gumroad.

There are two methods to download the latest release of the plugin. You can download it directly from the Gumroad website, or you can download it using the button in the email with a receipt.

After purchasing a copy of the “My Custom Functions PRO” plugin, you should have received an email with a receipt from Gumroad with a link to download the latest release of the plugin. This link should be fine for future downloads of the plugin, so please keep the email save for later usage.

Don’t worry if you deleted this email. We periodically send email notifications (with the download information) whenever there is a major update of the plugin. We do not send email notifications very often so as not to annoy our lovely customers.
If you have a Gumroad account, you are able to access your Gumroad purchases at any time through your Library. Please visit the How do I Access My Purchase page on the Gumroad website to learn more.

Installation

Install “My Custom Functions PRO” plugin just as you would any other premium WordPress plugin.

There are two methods to install the plugin. You can install it directly from the WordPress Admin Area, or you can install it manually via FTP access.

Automatic installation (via WordPress Admin Area):

To install the plugin automatically (from the WordPress Admin Area), please perform the following steps:

Download the ZIP archive with this plugin to your computer. After downloading you should have a ZIP archive called my-custom-functions-pro.3.0.zip. This is a compressed file containing all the folders and files required for the plugin to function properly.
Log in to Admin Area of your WordPress website.
Go to Plugins -> Add New.
Click Upload Plugin, and browse the ZIP archive with the plugin. Click the Install Now button. Wait a few seconds until the plugin is installed.
Activate the plugin through the Plugins tab.

After installation and activation, the PHP Inserter PRO menu item will appear in the Settings section of Admin Area. Click on it in order to view the plugin settings page.

Manual installation (via FTP access)

To install the plugin manually (by simply uploading all files via FTP or SFTP), please perform the following steps:

Download the ZIP archive with this plugin to your computer. After downloading you should have a ZIP archive called my-custom-functions-pro.3.0.zip. This is a compressed file containing all the folders and files required for the plugin to function properly.
Unzip the ZIP archive with this plugin on your computer. You’ll get the folder my-custom-functions-pro.

You need to preserve the directory structure in the archive when extracting these files.
Access your server via FTP or SFTP.

If you aren’t sure how usually your web hosting provider will have instructions somewhere on their website.
Browse to the directory wp-content/plugins/.

The location of the folder wp-content depends on your host’s setup. Typically, the folder public_html contains all the files of the website, among which you will find this folder. Please contact your web hosting company to get help if you can’t find this folder.
Upload the plugin folder my-custom-functions-pro from step 1. Wait for the uploading to complete, it may take several minutes. Once the upload complete, the plugin should be in wp-content/plugins/my-custom-functions-pro/ on your server.
Log in to Admin Area of your WordPress website.
Activate the plugin through the Plugins tab.

After installation and activation, the PHP Inserter PRO menu item will appear in the Settings section of Admin Area. Click on it in order to view the plugin settings page.

More help installing plugins

Update plugin to new release

The “My Custom Functions PRO” plugin can be updated to the new release just as you would any other premium WordPress plugin.

We have three types of updates:

Adding new features - We add new features to the plugin whenever we have a new cool feature requests by our customers, as well as our team.
Code improvement - This makes the plugin more stable and faster, and also improves security.
Solving bugs or issues - If any bugs or issues appear due to browser updates or WordPress version changes, we make sure to update the plugin ASAP to keep you and visitors of your website safe.

Regardless of the type of updates, they should be applied as soon as conveniently possible.

Automatic update (via WordPress Admin Area):

Unfortunately, there is no way yet to update the plugin automatically. Sorry for the inconvenience. But we will do our best to find a way to change this as soon as possible. We plan to implement an automatic plugin update system in one of the upcoming plugin updates, so that you no longer have to install updates manually.

Update via FTP or SFTP:

To update the plugin manually (by simply overriding all files via FTP or SFTP), please perform the following steps:

Log in to Admin Area of your WordPress website.
Deactivate this plugin through the Plugins tab.
Download the ZIP archive with the new version of this plugin to your computer. After downloading you should have a ZIP archive called my-custom-functions-pro.3.0.zip. This is a compressed file containing all the folders and files required for the plugin to function properly.
Unzip the ZIP archive with the new version of this plugin on your computer. You’ll get the folder my-custom-functions-pro.

You need to preserve the directory structure in the archive when extracting these files.
Access your server via FTP or SFTP.

If you aren’t sure how usually your web hosting provider will have instructions somewhere on their website.
Browse to the directory wp-content/plugins/.

The location of the folder wp-content depends on your host’s setup. Typically, the folder public_html contains all the files of the website, among which you will find this folder. Please contact your web hosting company to get help if you can’t find this folder.
It’s best to have a backup, so download the plugin folder my-custom-functions-pro to your computer.
Upload the plugin folder my-custom-functions-pro from step 4, with replacing the current folder of the plugin. Wait for the uploading to complete, it may take several minutes. Once the upload complete, the plugin should be in wp-content/plugins/my-custom-functions-pro/ on your server.

Important! Sometimes files are deleted inside the plugin folder so make sure that your program is deleting all files and uploading the new ones when it overrides instead of simply “updating newer files”. It can cause issues if you have files on your server inside the plugin folder that are no longer used in the plugin itself.
Activate this plugin through the Plugins tab.

Note! After you are done updating a plugin please also clear your website and browser cache to prevent errors (this should be done when updating any theme or plugin).

License key

You will receive a license key along with your purchase confirmation. As long as it is active, this key allows you to get updates for the purchased WordPress plugin and get access to premium support.

To enter your license key into the plugin, please perform the following steps:

Log in to Admin Area of your WordPress website.
Go to Settings -> PHP Inserter PRO. You will be taken to the plugin settings page.
Navigate to the License tab.
Enter your license key in the field License Key.
Click the Submit License Key button.

Using at first time

To use this plugin at first time, follow these steps:

Log in to Admin Area of your WordPress website.
Go to Settings -> PHP Inserter PRO. You will be taken to the plugin settings page.
Enter a title or a small description for the new function.
Place your custom PHP code in the field bellow.

Note! Please do not wrap your custom PHP code in the <?php...?> HTML tags.

Note! Before use, please read the instructions on the F.A.Q. tab on what to do in case of a website crash.
Click the Save changes button.

Now your new function added and waiting when you enable it!

Add new function

You can easily add new function by following these steps:

Click the Add another function button. New function will appear.
Enter a title or a small description for your function in the field Title or small description.
Place your custom PHP code in the field bellow.
Click the Save changes button.

Now your new function added and waiting when you enable it!

You can add unlimited number of new functions. This is very useful, because that way you can manage your functions separately. Just use a clear names for your functions and you’ll always be know about what functions and is responsible for what.

Enable or disable function

To enable or disable a function, follow these steps:

Find the function that you want to enable or disable.
Switch the toggle to the ON (green color) or OFF (red color) position.
Click the Save changes button.

Edit function

To edit the code of a function, follow these steps:

Find the function that you want to edit.
Click the Pencil button in the upper-right corner of this function. The function editor panel opens.
Edit the code of the function.
Click the Save changes button.

Delete function

You can easily delete any function by following these steps:

Find the function that you want to delete.
Click the Trash button on the right side of the function panel.
You will be prompted to confirm the deletion. Click the OK button. This function will disappear, but not deleted yet.
Click the Save changes button.

Done, the function is now deleted.

Backups of functions

Each time you push the Save changes button this plugin creates a new backup of your functions. This backup is a typical TXT file with all your functions, like this:

                            /* Name:     My function 1
 * Enabled:  YES
 -------------------------------------- */
 $a = array('a' => 1, 'b' => 2, 3 => 'c');

 echo "$a[a] ${a[3] /* } comment */} {$a[b]} \$a[a]";

 function hello($who) {
     return "Hello $who!";
 }


/* Name:     My function 2
 * Enabled:  NO
 -------------------------------------- */
 $a = array('a' => 1, 'b' => 2, 3 => 'c');

 echo "$a[a] ${a[3] /* } comment */} {$a[b]} \$a[a]";

 function hello($who) {
     return "Hello $who!";
 }

                        

The file is given the name of the corresponding date of the creation and placed in the catalog backups. Also, for usability, creates a copy of the last backup and it’s named backup-last. You can download this file (backup-last.txt) directly from the plugin settings page.

Over time, it can accumulate a lot of backup files, so you may want to remove unnecessary files. To do this just go to the catalog backups (/wp-content/plugins/my-custom-functions-pro/backups/) and remove unnecessary (or all) files.

Customization

Our programmers and designers have done a great job to make the plugin easily customizable using the plugin settings page interface.

You can easily customize it by simply selecting the desired settings. And if you want more options, let us know and we will be happy to add them. We will do our best to better develop the plugin and add the requested features as soon as possible.

Customize code editor

This plugin uses the code editor powered by CodeMirror. This code editor has options such as syntax highlighting, line numbering, and more. In addition, you can easily customize it by simply selecting the desired settings. And if you want more options, let us know and we will be happy to add them.

To customize the code editor, follow these steps:

Go to the Settings tab.
Select the desired settings.
Click the Save changes button.

The sidebar, which is located on the “Settings” tab, consists of several sections. It gives you quick access to the documentation of the plugin, and also you can download the latest backup of your functions. We plan to add some more useful features here soon.

On a specific page

For now, this plugin does not have an option to apply the custom PHP code only on specific pages. We plan to add this feature soon. But for now in order to apply your custom PHP code only on specific pages of your website, you need to wrap your custom PHP code in a PHP function that will determine the page you want. You need something like this:

                            function my_custom_php_code() {

    // Stop the function if this is not the Home page of website
    if ( !is_home() ) {
        return;
    }

    // YOUR CUSTOM PHP CODE HERE

}
my_custom_php_code();

                        

Site failure

This plugin has a built-in functions for checking the custom code for syntax errors, duplicate functions names, and etc. But plugin is not perfect, so there are times when the entered custom code causes the error and white screen (WSOD). This is due to the fact that your custom code has a syntax error that this plugin could not detect. When this happens with you, please perform the following steps.

Access your server via FTP or SFTP.

If you aren’t sure how usually your web hosting provider will have instructions somewhere on their website.
Browse to the directory wp-content/plugins/my-custom-functions-pro/.

The location of the folder wp-content depends on your host’s setup. Typically, the folder public_html contains all the files of the website, among which you will find this folder. Please contact your web hosting company to get help if you can’t find this folder.
Rename the file START to STOP. This will stop the execution of your custom code. Now your website should be returned to life and the WordPress Admin Area should be accessible.
Log in to Admin Area of your WordPress website.
Go to the plugin settings page Settings -> PHP Inserter PRO.
Edit/fix your custom PHP code that you entered before the crash.
Return to the plugin folder and rename the file STOP to START and you’re done!

This plugin stored you entered code in the database of your website. For getting your code, you also can go to the Database -> Table “wp_options” -> Option “spacexchimp_p011_settings” -> “option_value”.

We are already working on a feature to automatically stop the execution of users custom PHP code for cases when this plugin could not detect the error, and this caused the inaccessibility of the website.

Troubleshooting

As with every plugin, it’s possible that things don’t work. It’s impossible to tell what could be wrong exactly.

The most common cause of any type of problem experienced by users is the website cache and the plugin conflict. Our plugin is compatible with most third-party plugins and themes. But, unfortunately, we cannot check it with all third-party plugins and themes (especially paid ones) for compatibility, therefore there are cases when the plugin does not work with a third-party plugin or theme. We constantly check our plugin for compatibility with third-party plugins and themes. If we find that our plugin is incompatible with a third-party plugin or theme, and if we can fix it on our part, we release an update of the plugin to fix the problem.

Perhaps the problem will be solved by one of the following solutions. Please try this and let us know. Thank you!

Please try to clear your browser’s cache. Every web browser stores a cache of the websites you visit (pages, images, and etc.) to reduce bandwidth usage and server load.
Please try to clear your website’s cache created by any kind of caching system, it could be a WordPress plugin or a web service such as the CloudFlare.
Please try to re-login to your WordPress website.
Please try to restart your computer or try on another computer.
Please try to temporarily disable all other plugins and сheck if the issue persists. If the problem is gone, then the problem is in conflict with another plugin installed on your WordPress website.
Please try to temporarily change the theme to the WordPress built-in theme “Twenty Nineteen” and сheck if the issue persists. If the problem is gone, then the problem is in conflict with the theme installed on your WordPress website.

Bug report

Bug reports are very welcome! Please visit our contact page and report. Thank you!

Please include as much information as possible, including a link to your website where the problem can be seen (if applicable). Describe in more detail what exactly you are seeing. Here are some examples:

Elements of the plugin settings page are not working.
An error message is displayed on the plugin settings page.
An error message is displayed on the front-end of website.
Website is crashed.

More help & support

If you have any questions that are beyond the scope of this documentation, please read the Frequently Asked Questions. If you still can’t find an answer to your enquiry, please don’t hesitate to contact us and we’ll be happy to help you out.

Answers to common questions about licenses, payment process, refunds and customer support can be found on the page Common Questions.