en

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.

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!

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. 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 “My Custom Functions PRO” plugin.

Secure payment and delivery of the “My Custom Functions PRO” plugin is done using the Gumroad platform.

Installation

Install “My Custom Functions PRO” plugin just as you would any other 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 by first downloading the plugin.

Automatic installation (via WordPress Admin Area):

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

  1. 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.
  2. Log in to Admin Area of your WordPress website.
  3. Go to Plugins -> Add New.
  4. 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.
  5. 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:

  1. 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.
  2. 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.

  3. 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.

  4. 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.

  5. 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.
  6. Log in to Admin Area of your WordPress website.
  7. 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 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.

In one of the upcoming updates, we plan to implement an automatic plugin update system 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:

  1. Log in to Admin Area of your WordPress website.
  2. Deactivate this plugin through the Plugins tab.
  3. 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.
  4. 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.

  5. 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.

  6. 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.

  7. It’s best to have a backup, so download the plugin folder my-custom-functions-pro to your computer.
  8. 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.

  9. 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:

  1. Log in to Admin Area of your WordPress website.

  2. Go to Settings -> PHP Inserter PRO. You will be taken to the plugin settings page.

  3. Navigate to the License tab.

  4. Enter your license key in the field License Key.
  5. Click the Submit License Key button.

Using at first time

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

  1. Log in to Admin Area of your WordPress website.

  2. Go to Settings -> PHP Inserter PRO. You will be taken to the plugin settings page.

  3. Enter a title or a small description for the new function.

  4. Place your custom PHP code in the field bellow.

    Note! Please do not wrap your custom PHP code in the 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.

  5. 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:

  1. Click the Add another function button. New function will appear.

  2. Enter the name or small description for your function in the field Title or small description.

  3. Place your custom PHP code in the field bellow.

  4. 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:

  1. Find the function that you want to enable or disable.
  2. Switch the toggle to the ON (green color) or OFF (red color) position.

  3. Click the Save changes button.

Edit function

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

  1. Find the function that you want to edit.
  2. Click the Pencil button in the upper-right corner of this function. The function editor panel opens.

  3. Edit the code of the function.

  4. Click the Save changes button.

Delete function

You can easily delete any function by following these steps:

  1. Find the function that you want to delete.
  2. Click the Trash button on the right side of the function panel.

  3. You will be prompted to confirm the deletion. Click the OK button. This function will disappear, but not deleted yet.

  4. 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.

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:

  1. Go to the “Settings” tab.

  2. Select the desired settings.

  3. 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.

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.

  1. 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.

  2. 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.

  3. 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.
  4. Log in to Admin Area of your WordPress website.
  5. Go to the plugin settings page Settings -> PHP Inserter PRO.
  6. Edit/fix your custom PHP code that you entered before the crash.
  7. 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.

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.