A beginner’s guide to WordPress plugin development
WordPress is one of the most popular open source content management systems in the world, and it’s little wonder when you consider its user-friendly nature, quick installation process, and especially its adaptability. Ever since version 1.2 hit the market, WordPress has supported self-developed plugins. Taking this step allowed programmers to adapt the CMS to meet their individual needs, all without actually changing the source code. Since then, tens of thousands of WordPress plugins have been developed and released, which has allowed the software, originally developed for blogging, to make a smooth transition to managing websites.
The advantages of programming your own WordPress plugins
With the wide range of extensions on offer (most of which are available for free), and the extensive plugin directory found on the official WordPress website it’s not always necessary to develop your own WordPress plugins. But when searching for a suitable extension for your web project, you might find that many WordPress plugins match your search criteria, but one of the following issues occurs:
- The plugin you want is no longer being developed
- The plugin you want no longer functions the way it was designed to
- There isn’t a plugin with the full range of functions that you need
These are among the most common reasons for creating your own WordPress plugin or modifying an existing one. Having your own extension can be an excellent alternative to conventional WordPress addons made with individual functions.php files. Copying prepared snippets of code in order to, for example, integrate Google Analytics into your web project is the quickest and easiest way to expand WordPress. When faced with larger projects, however, doing this often causes the functions.php file to become less clearly arranged, potentially leading to errors that affect the entire project. What’s more, users are also faced with the task of having to transfer any changes into the functions.php file whenever a new theme is adopted. Luckily, some plugins can help here by allowing you to individually manage all changes when switching WordPress themes. These plugins can be developed even if you have only limited programming experience.
Step 1: creating your WordPress plugin
WordPress is based on the script language PHP, which is why its plugins are essentially nothing more than PHP scripts. A simple extension can consist of a single PHP file with just a few lines of code, provided that this script adheres to its corresponding license. WordPress is subject the GNU General Public License (GPL), so make sure to select a license that complies with these rules, such as GPLv2. In order to unify plugin codes, coding standards have been created to serve as programming guidelines, which comes in handy for those who wish to publish their plugins. To develop your own WordPress plugin, proceed as follows:
1. First, a PHP file needs to be created. Any word processing program can be used for this step (but when working with lines of code, it’s best to use a special program, like Notepad++). When saving the file, just select ‘All files’ and add the ending ‘.php’. For example, my.plugin.php. Copy and paste this file into the WordPress plugin directory—generally the file path, /wp-content/plugins/ is used here. For better structuring, especially with scripts that are composed of more than one file, it’s recommended to create a directory for your plugin: /wp-content/plugins/my-plugin.
2. In the file, you can add the following general information to your plugin:
<?php
/*
Plugin Name: PLUGIN NAME
Plugin URI: LINK TO PLUGIN
Description: PLUGIN DESCRIPTION
Version: 1.0
Author: YOUR NAME
Author URI: LINK TO YOUR WEBSITE
License: GPLv2
*/
?>
3. After including this code, you’ve essentially finished the initial step and have created your first WordPress plugin. You should be able to find it on your WordPress administration page within the list of plugins, including the description and two automatically generated links to your website and plugin page. You’ll also find buttons for activating and deactivating the plugin. These are, of course, still irrelevant at this stage of the development as no functions have been defined in your extension yet.
Step 2: breathing life into your own plugin
Once the PHP script’s header area has been created, you can start programming your WordPress plugin’s functions. To this end, you can use the snippet of code from step one that you’ve perhaps decided to include into the functions.php file. To illustrate this point, we’ve added some short code to our PHP file that will allow us to integrate an excerpt from Google maps:
<?php
/*
Plugin Name: PLUGIN NAME
Plugin URI: LINK TO PLUGIN
Description: PLUGIN DESCRIPTION
Version: 1.0
Author: YOUR NAME
Author URI: LINK TO YOUR WEBSITE
License: GPLv2
*/
?>
Enter the corresponding embed code into the src attribute that you received from Google Maps, and presto: you’ve now developed your very first WordPress plugin. Now you’ll be able to find and activate it anytime under the tab ‘Maps’ in the navigation menu, and using its corresponding code, you can add it to your web project.
WordPress programming: practice makes perfect
The plugin covered in this Digital Guide article shows you don’t need to be a PHP expert in order to program your own WordPress extensions. But it’s important to remember that this example showcases a very simple implementation. For the most part, complex plugins that comprise multiple scripts require more than just a few minutes of work before a finished tool can be ready for use. More ambitious projects require a structured approach so as to keep errors to an absolute minimum. For this reason, it’s important to write the cleanest code possible from get-go, and don’t forget to incorporate informative comments that describe each function in detail. Ideally, the plugin should also feature a unique name that makes it clear to the user which tasks it supports.
For further information on the topic, we recommend taking a look at the WordPress Plugin Handbook. From programming tips to suggestions for useful development tools, here you’ll find extensive support for both beginners and experts.
Related articles
Ruslan GrumbleShutterstock The best WordPress backup plugins
If you have invested a lot of time and effort in your WordPress project, you should ensure you have an adequate backup solution. With a WordPress backup plugin, you can manage how your data is backed up in the popular content management system to counteract data loss in the long run. Why are these extensions so important? And which plugins are available?
The best email newsletter plugins for WordPress
Email marketing is a proven way to keep customers or users up to date – even in times of social media. WordPress newsletter plugins are the perfect tools to create digital newsletters and integrate them into your project. Read on to find out more about the best extensions for your privacy-compliant WordPress newsletter.
Ruslan GrumbleShutterstock Social plugins: expand your outreach on Facebook, Twitter, Pinterest, et al.
Link your online project with your social media presence and enable cross-site interactions with the help of social plugins. By enabling like, share, and comment functions, website owners can increase the outreach of text posts, images, and videos exponentially, thanks to the ever-growing social media user base. Implementing social media plugins into your website can help you transform visitors…
What is a plug-in and what is it used for?
Plug-ins have many advantages. For example, these small add-ons are the simplest solution if you want to play Flash videos on your website, display PDF files in your browser or spice up your e-mail application with new features. Plug-ins allow you to add practical features to almost any software. However, these useful little add-ons also present some risks.
How to set up a WordPress staging site
WordPress staging refers to a separate test environment for a WordPress installation, which allows you to test WordPress updates, plugins, and templates for compatibility before integrating them on a live website. WordPress test environments protect developers from crippling a working WordPress site with updates or self-written code.
