My Custom Functions

Description

An easy to use, with intuitive interface, WordPress plugin that gives you the ability to easily and safely add your custom PHP code to your WordPress website, directly out of the WordPress Admin Area, without the need to have an external editor.

This is a simple and perfect tool to use as your website’s functionality plugin. This is a must have tool for authors and website’s owners. Its purpose is to provide a familiar experience to WordPress users. There is no need for any more editing of the functions.php file of your theme or any of your plugin files for to add custom PHP code. Just add your custom PHP code in the field on the plugin page and this plugin will do the rest for you. It will automatically add your PHP code to your website, without changing any of your theme files and without slowing down your website.

The plugin works completely independently of the theme, so you can use it with any theme, and regardless of whether the theme does or does not have a functions.php file. The code you place on the plugin page will be entirely unaffected if you edit the contents of the theme’s functions.php file, or even completely change the theme. This is really useful in case of updating theme or plugins, because your custom PHP code would never be overwritten. Your custom PHP code will keep on working, no matter how many times you upgrade or switch your theme and plugins.

On the plugin page you find the code editor powered by CodeMirror. This code editor has options such as syntax highlighting, line numbering, and more. And if you want more options, let us know and we will be happy to add them.

Features

  • Lightweight and fast
  • Secure code with using clear coding standards
  • Intuitive interface
  • Cross browser compatible (work smooth in any modern browser)
  • Compatible with all WordPress themes
  • RTL compatible (right to left)
  • Translation ready

Key features include

  • Insert custom PHP code into the site
  • Checks the entered code for fatal errors
  • Easy disable option for WSOD
  • Ability to temporarily disable all custom PHP code
  • Code syntax highlighting
  • Line numbering
  • Active line highlighting
  • Editor allow for Tab indentation
  • And much, much more!

PRO features include

  • Ability to easily customize the code editor by selecting the desired settings
  • 56 themes for syntax highlighting
  • Toolbar with useful buttons, such as Undo, Redo, etc.
  • Ability to use shortcut keys (both Mac and PC) for Search, Replace, etc.
  • Unlimited number of fields for functions
  • Automatic backup of all functions to a downloadable text file
  • Separate activation and deactivation of functions
  • No ads on the settings page
  • Well documented

Get the PRO version now!

Supported languages

  • PHP

Translation

This plugin is ready for translation and has already been translated into several languages.

  • English (default)
  • Russian (translation by Milena Kiseleva)
  • German (translation by Michael)
  • Chinese-Taiwan (translation by Gordon Yu)
  • Spanish (translation by Ramiro Garcés and Patricio Toledo)
  • French (translation by Theophil Bethel)
  • Dutch (translation by Peter Leenders)

If you want to help translate this plugin then please visit the translation page.

Minimum system requirements:

  • PHP version 5.2 or higher.
  • MySQL version 5.0 or higher.

Recommended system requirements:

  • PHP version 7.0 or higher.
  • MySQL version 5.6 or higher.

Contribution

Developing plugins is long and tedious work. If you benefit or enjoy this plugin please take the time to:

“My Custom Functions” is one of the own software projects of Space X-Chimp.

License

This plugin is licensed under the GNU General Public License, version 3 (GPLv3) and is distributed free of charge.
Commercial licensing (e.g. for projects that can’t use an open-source license) is available upon request.

Credits

Links

Screenshots

  • Plugin page.
  • Plugin page with custom PHP code added.
  • Success message.
  • «Fatal error» message.

Installation

Install “My Custom Functions” just as you would any other WordPress Plugin.

Automatically via WordPress Admin Area:

  1. Log in to Admin Area of your WordPress website.
  2. Go to “Plugins” -> “Add New“.
  3. Find this plugin and click install.
  4. Activate this plugin through the “Plugins” tab.

Manually via FTP access:

  1. Download a copy (ZIP file) of this plugin from WordPress.org.
  2. Unzip the ZIP file.
  3. Upload the unzipped catalog to your website’s plugin directory (/wp-content/plugins/).
  4. Log in to Admin Area of your WordPress website.
  5. Activate this plugin through the “Plugins” tab.

After installation and activation, the “PHP Inserter” 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

FAQ

Q. Will this plugin work on my WordPress.COM website?

A. Sorry, this plugin is available for use only on self-hosted (WordPress.ORG) websites.

Q. Can I use this plugin on my language?

A. Yes. This plugin is ready for translation and has already been translated into several languages. But If your language is not available then you can make one. The POT file is included and placed in the “languages” folder. Just send the PO file to us and we will include this translation within the next plugin update. Many of plugin users would be delighted if you share your translation with the community. Thanks for your contribution!

Q. How does it work?

A. Simply go to the plugin settings page, place your custom PHP code in the code editor field, switch the toggle to the “ON” position and click the “Save changes” button. Enjoy the result of applying your custom PHP code. It’s that simple!
You can find the plugin settings page at “WordPress Admin Area” -> “Settings” -> “PHP Inserter“.

Q. Can I use HTML/CSS/JS code integrated in PHP code?

A. Yes. But you need to do it properly, like this:

function my_custom_html_code() {

    // Print the custom HTML code
    echo '<script>YOUR CUSTOM HTML CODE HERE</script>';

}
add_action( 'wp_head', 'my_custom_html_code' );
Q. How much of PHP code (characters) I can enter in the code editor?

A. We don’t limit the number of characters.

Q. On the plugin settings page, an error message appears. What could be wrong?

A. Here are a few of the most likely causes of the error message:

  1. You make a syntax error in the code that you have entered. Check the syntax of your code and try again.
  2. You entered two functions with the same name. Use a unique names for your functions.
  3. You have entered function with a name that is already occupied by another function. Use a unique name for your function.
  4. You are trying to overwrite an existing function (of WordPress, theme, or plugin). Instead, use filters and hooks.
Q. Does this plugin requires any modification of the theme?

A. Absolutely not. This plugin is configurable entirely from the plugin settings page that you can find in the Admin Area of your WordPress website.

Q. Does this require any knowledge of HTML or CSS?

A. This plugin can be configured with no knowledge of HTML or CSS, using an easy-to-use plugin settings page. But you need to know the HTML or CSS in order to add/remove/modify the HTML or CSS code by using this plugin.

Q. Can I add my custom PHP code to a specific page of my website?

A. 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();
Q. It’s not working. What could be wrong?

A. As with every plugin, it’s possible that things don’t work. The most common reason for this is a web 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. This is called the browser’s cache.​ Clearing your browser’s cache may solve the problem.

It’s impossible to tell what could be wrong exactly, but if you post a support request in the plugin’s support forum on WordPress.org, we’d be happy to give it a look and try to help out. Please include as much information as possible, including a link to your website where the problem can be seen.

Q. What to do if this plugin crashed the website?

A. 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/. 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.
  4. Log in to Admin Area of your WordPress website.
  5. Go to the plugin settings page Settings -> PHP Inserter.
  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_p001_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.

Q. The last WordPress update is preventing me from editing my website that is using this plugin. Why is this?

A. This plugin can not cause such problem. More likely, the problem are related to the settings of the website. It could just be a cache, so please try to clear your website’s cache (may be you using a caching plugin, or some web service such as the CloudFlare) and then the cache of your web browser. Also please try to re-login to the website, this too can help.

Q. Where to report bug if found?

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

Q. Where to share any ideas or suggestions to make the plugin better?

A. Any suggestions are very welcome! Please visit our contact page and share. Thank you!

Q. I love this plugin! Can I help somehow?

A. Yes, any contributions are very welcome! Please visit our donation page. Thank you!

Reviews

Fantastic

I will use this on EVERY web site I do from now on. No more headaches with the functions.php file being overwritten when I change themes. No more worries about FTP backups of the functions.php file!

Clear and elegant method of disabling the customizations at will! Thank you so much! This is brilliant!

Admin Links

This rating would be a 5 EXCEPT for the fact that they insist on adding Donate and Upgrade to Pro links in the plugin admin. Take that crap out of there.

Awesome Plugin and Dev Team!

I use this plugin for dynamically displaying archive pages for custom taxonomies by calling my custom functions in the page templates. Works like a charm!

In addition, I’ve just had an issue when putting in some other code. It broke my WP admin panel (completely white page only).
I panicked for a second, but then found the solution to fix the issue here: https://wordpress.org/support/topic/instruction-error/

You guys are awesome for implementing this! Just saved my ass!
I’ll be more careful now with the code that I add, but it’s very nice to know that you are always able to revert the settings even when the admin panel is broken.

Thanks!!

Read all 40 reviews

Contributors & Developers

“My Custom Functions” is open source software. The following people have contributed to this plugin.

Contributors

“My Custom Functions” has been translated into 5 locales. Thank you to the translators for their contributions.

Translate “My Custom Functions” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

4.31

  • Improvement: Design of the plugin settings page is improved.

4.30

  • Improvement: Design of the plugin settings page is improved.
  • Content of the “Usage Instructions” section updated.
  • Translation files are updated.

4.29

  • Added new feature: If the changes in the code editor were made, but not saved, the message “NOT SAVED” is displayed.
  • Code commenting improved.
  • Translation files are updated.

4.28

  • CSS code, which is located in the file “admin.css” and is related to the “FAQ” section, is improved.
  • The sidebar items are rearranged.
  • Some texts are updated.
  • Translation files are updated.

4.27

  • The design of the message “Successful” is improved.
  • The design of the message “Error” is improved.
  • The “readme.txt” file is updated.
  • Some texts are updated.
  • Translation files are updated.

4.26

  • The function ‘_prepare’ is improved.
  • The function ‘_duplicates’ is improved.
  • The function ‘_exec’ is improved.
  • Code commenting improved.
  • Some texts are updated.
  • Translation files are updated.

4.25

  • Some texts are updated.
  • Translation files are updated.
  • The translation into Russian has been corrected.

4.24

  • Dutch translation added. (Thanks to Peter Leenders)
  • The function ‘_load_scripts_codemirror’ is improved. Removed an unnecessary call of constants.
  • The function ‘_load_scripts_admin’ is improved.
  • The banner of Space X-Chimp, located on the settings page of the plugin, is updated. The image ‘banner.png’ is deleted.
  • Some texts are updated.
  • All translation files are updated.

4.23

  • The code block that enqueue the CodeMirror library files is moved to a separate function ‘_load_scripts_codemirror’ within the ‘enqueue.php’ file.
  • Enqueue of the CodeMirror addons is moved to the beginning of the queue, before enqueuing the CodeMirror mods.
  • All translation files are updated.

4.22

  • Fixed: CodeMirror addon ‘autorefresh.js’ was added to one of the previous versions of the plugin, but it was not enabled.

4.21

  • Fixed localization of the word “licence”. (Thanks to Garrett Hyder @garrett-eclipse)
  • Settings for the CodeMirror editor are moved to a separate file ‘codemirror-settings.js’.
  • Added the addon ‘placeholder.js’ to the CodeMirror editor. Added a placeholder for code field.
  • Texts on the plugin settings page are updated. Translations are updated.

4.20

  • Updated the method of loading the addons of the CodeMirror library.
  • Added the addon ‘autorefresh.js’ to the CodeMirror editor. The code for manual refreshing the CodeMirror editor is deleted.
  • Texts on the plugin settings page are updated. Translations are updated.

4.19

  • CodeMirror library updated to the latest version v5.38.0. The directory structure is changed (files are better organized). Added a test files for the CodeMirror modes.
  • Updated the method of loading the modes and addons of the CodeMirror library.

4.18

  • Fixed a bug due to which the plugin data that stored in the database to not be deleted during the uninstallation of the plugin.
  • The contents of the file ‘uninstall.php’ is moved to the file ‘core.php’. The file ‘uninstall.php’ is deleted.
  • The upgrade banner has moved from an external source to the plugin folder.
  • Some texts are corrected.

4.17

  • Added new constant “_FILE”.
  • Added a function that runs during the plugin activation. Now the date of the first activation of the plugin is recorded in the database.

4.16

  • Added auto-versioning of the CSS and JavaScript files to avoid cache issues.
  • CSS code in the file ‘admin.css’ is optimized.

4.15

  • Fixed the link “Settings”, located in the plugin’s meta row on the “Plugins” page. The suffix “.php” was deleted.
  • Fixed information stored in the header of the translation files.
  • Translation files updated.

4.14

  • Some texts updated, and typos corrected.
  • All translation files updated.
  • The information about the author of the plugin (including name, links, copyright, etc.) was changed due to the fact that the plugin became the property of SpaceXChimp.
  • The human.txt file updated.

4.13

  • Texts updated.
  • The year in the copyright text is updated.
  • The sidebar items are rearranged.
  • Translation files updated.

4.12

  • The plugin is fully tested for compatibility with WordPress version 4.9.
  • CSS code improved.

4.11

  • German translation added. (Thanks to Michael)
  • Spanish translation updated. (Thanks to Patricio Toledo)
  • Fixed an issue where the “Hello” message could not be hidden.

4.10

  • At the request of some users, plugin settings page moved to the submenu item in the top-level menu item “Settings”, like before.
  • In the “_register_submenu_page” function, “$capability” changed from the ‘edit_theme_options’ to ‘manage_options’.

4.9

  • Fixed the issue due to which the ‘Space X-Chimp’ sub menu item in the brand menu item was displayed.
  • Added branded footer text on the plugin’s settings page.

4.8

  • Added the top level menu item of the brand.
  • The submenu item of the plugin has moved to the menu item of the brand.
  • The menu item of the plugin is renamed.
  • The “Author” tab on the settings page is removed.
  • Content of the “Support” tab on the settings page is updated.
  • Copyright of plugin files is changed to the “Space X-Chimp”.
  • The “Support” tab renamed to the “Support Me”.
  • The “Usage” tab renamed to the “Usage Instructions”.

4.7

  • Added Spanish translation. (Thanks Patricio Toledo)
  • The group name of the ‘_service_info’ option renamed to ‘_settings_group_si’.
  • The ‘admin.css’ file improved.
  • The “Font Awesome” library is integrated for use on the plugin settings page.
  • The ON/OFF switch replaced with new.
  • The ‘bootstrap-checkbox.js’ JavaScript plugin added.
  • Prefixes of the PHP functions changed to ”spacexchimp_p001_.
  • Prefixes of the PHP constants changed to ”SPACEXCHIMP_P001_.
  • Plugin data that saved in the database upgraded to version 0001.

4.6

  • Russian translation updated.
  • The navigation of the tabs is rearranged.
  • Fixed an issue due to which the sidebar was not hiding on mobile devices.
  • Code of sidebar moved to separate file ‘sidebar.php’.
  • Support page tab moved from external source to plugin code.
  • My avatar moved from external source to plugin folder.
  • Banner moved from external source to plugin folder.
  • Code of PayPal button updated.

4.5

  • Stylesheet in the admin.css file improved.
  • The ‘!important’ declarations in the admin.css file removed.
  • Code formatting in the admin.js file improved.
  • Code commenting improved.
  • Load of the additional remote CSS file removed from the admin.js file.
  • Changed the sorting of enqueueing of scripts.
  • The ‘Family’ page tab renamed to ‘Store’.
  • Added ad banner of my store website.

4.4.1

  • The HTTPS mixed content issue fixed by changing all links to HTTPS.
  • Content of the “FAQ” section updated.

4.4

  • On the plugin settings page, text of buttons are corrected.
  • On the plugin settings page, the information about the plugin version number moved to header section.
  • Some mention of constants replaced with variables for easier access.
  • Content of the “Usage” tab updated.
  • Content of the “FAQ” tab updated.
  • An SSL issue within the admin area fixed. The ‘src=”http://’ replaced with ‘src=”//’.
  • Added load of the jQuery library on the plugin settings page.

4.3

  • To the plugin settings page added information about the plugin version number.
  • The “Tested up to:” comment changed to 4.8 after full testing process.
  • The “version.php” file renamed to “versioning.php”.
  • The “versioning.php” file updated to new version.
  • The “_plugin_version_number” function renamed to the “_versioning”.
  • Content of the FAQ tab updated.
  • Values of the variables on the settings page are improved.

4.2

  • Compatibility with PHP version 5.2 improved.
  • PHP shorthands improved.
  • Added function for generating the plugin constants.
  • Some constants now get the value from the plugin header data.
  • The “_plugin_version_number” function improved.
  • Added file “upgrade.php” for future upgrades.

4.1.1

  • Fixed the bug due to which the “Warning: Constants may only evaluate to scalar values in” warning are displayed.

4.1

  • Added new constants: “_SLUG”, “_PREFIX”, “_SETTINGS” and “_NAME”.
  • Value of the “_VERSION” constant replaced with information from the plugin header data.
  • All references to the plugin name, slug, prefix are replaced with constants.
  • The “name” attribute removed from the “form” tag.
  • Code formatting improved.
  • F.A.Q. section updated.

4.0.1

  • Fixed the bug due to which the the “Warning: Illegal string offset ‘version’ in” and the “Warning: Illegal string offset ‘old_version’ in” warnings are displayed. (Thanks to Sven Brill)
  • Contents of the F.A.Q. tab updated.

4.0

  • The design of the plugin settings page is completely redone.
  • Added additional donate link to the “Plugins” page.
  • The ‘Using’ section renamed to ‘Usage’.
  • My Unicode signature added to the main file.
  • The donate button replaced with new.
  • The ‘Donate’ section renamed to ‘Support’.
  • The ‘donate.png’ image removed.
  • Options from the settings page moved to a separate file.
  • The “Usage” section removed from the sidebar area.
  • Additional “Support” section added.
  • Added tab navigation menu for the settings page.
  • Added additional tabs on the settings page.
  • Code of the ‘admin.css’ file improved and better commented.
  • A full version of the Bootstrap framework is integrated.
  • The ‘MCFunctions_load_scripts’ function renamed to ‘MCFunctions_load_scripts_admin’.
  • Added the CSS code for the custom list numbers on the plugin settings page.
  • The main font is changed to “Verdana”.
  • All PHP and HTML code is better formatted.
  • The header on the settings page of plugin is redesigned.
  • The “LICENSE.txt” file renamed to “license.txt”.
  • The “humans.txt” file added.
  • Messages from the plugin settings page moved to a separate file “messages.php”.
  • The “_service_info” setting added to the data-base.
  • Added function for managing information about the version number of the plugin.
  • Added the “Hello” message that show when the plugin is just installed.
  • Added the “Error” message that show when user is trying to degrade the version number of the plugin.
  • Fixed the parameter that contain the path to source files in all translation files.
  • The POT file updated.
  • Translations updated.

3.5

  • Added French translation. (Thanks Theophil Bethel)
  • Image of the donate button changed.

3.4.1

  • Translations updated.
  • Readme for translations updated.
  • Link of banner image updated.

3.4

3.3

  • User’s PHP code displayed on settings page are escaped for output by htmlentities() instead of esc_attr() for prevent converting characters to HTML entities.
  • Added global constant for plugin text-domain.
  • Russian translation improved.

3.2

  • Added option for easy disable the custom code for cases of WSOD.
  • Style sheet of settings page improved.
  • On the settings page added an advertisement about the PRO version of this plugin.
  • The Readme.txt file improved.
  • Added the Readme.txt file for translation contribution.

3.1

  • Added prefixes to the stylesheet and script names when using wp_enqueue_style() and wp_enqueue_script().
  • Added constant for storing the plugin version number.

3.0

  • The structure of files changed.
  • Style sheet of settings page improved and better commented.
  • JS code improved.
  • The “thanks.png” image removed.
  • POT file updated.
  • Russian translation updated.
  • Chinese (Taiwan) translation updated.

2.5.1

  • The update_option() returned into _duplicates function.

2.5

  • Added active-line add-on to CodeMirror.
  • Extra update_option() removed from the _duplicates function.
  • The _exec function optimized.
  • CSS class “slider” renamed to “trigger”.
  • Styles of settings page optimized for mobile devices.
  • The styles.css file better commented.
  • The _enqueue_codemirror_scripts function renamed to mcfunctions_load_scripts.

2.4

  • Added a toggle for temporarily disable the custom functions.
  • Functions _prepare, _duplicates, and _exec optimized.

2.3

  • Added function to check for duplicate function names. Compares the names of all functions (internal, user). The _duplicates function added.
  • Added function of automatic remove the “successful” message after 3 seconds.
  • Removed the default message about successful saving.
  • The function of user code cleaning modified.
  • File js-functions.js renamed to functions.js.
  • Removed my personal ad about freelance.

2.2

  • Added Chinese (Taiwan) translation. (Thanks Gordon Yu)
  • Text domain changed to “my-custom-functions”.
  • Added compatibility with the translate.wordpress.org.

2.1

  • In the page.php, on the line 21, fixed typo.
  • Removed extra rules in style.css file.
  • All images are moved to the directory “images”.
  • Image “btn_donateCC_LG.gif” is now located in the “images” directory.

2.0

  • New design of settings page (new layout).
  • Constants variables added.
  • editor.js deleted.
  • js-functions.js (file with all js functions) created.
  • Prefixes changed to “MCFunctions”.
  • Text domain changed to “MCFunctions”.
  • Plugin URI changed to GitHub repository.
  • Added my personal ad about freelance.
  • .pot file updated.
  • Russian translation updated.

1.9

  • Authors URI changed.
  • Donate link changed.
  • Localization improved.
  • .pot file updated.
  • Russian translation updated.

1.8

  • The mode of CodeMirror editor changed from ‘application/x-httpd-php’ (HTML+PHP) to ‘text/x-php’ (PHP).
  • Placeholder of changed to “/* Enter Your Custom Functions Here */”.
  • Removed more unused do_action() from page.php file.

1.7

  • The stylesheet of plugin page moved to separate file.
  • The javascript from page.php moved to separate file.
  • Textdomain changed to “mcfunctions”.
  • Changed the style of title in plugin page.
  • The LICENSE file renamed to LICENSE.txt

1.6

  • Fixed the issue due to which nothing appears below line 26 until you click below that line.
  • Added “register_setting” for error option.
  • Corrected comments to source code.

1.5

  • CodeMirror scripts are combined and minified.

1.4

  • Fixed the issue due to which the alert message was appearing after installation.

1.3

  • .pot file included.
  • Minor fixes.

1.2

  • Added the syntax highlighting and line numbering.

1.1

  • Fixed positioning of the sidebar at the plugin settings page.

1.0

  • Initial release.
  • Added the check for safety execution code.
  • Added ready for translation.

0.3

  • Release candidate.

0.2

  • Beta version.

0.1

  • Alpha version.