Creating A WordPress Plugin Is Easier Than You Think
Until a few years ago, I hadn’t written a single WordPress plugin. I had created and customized many themes for our clients, but for some reason, I kept telling myself that creating a plugin was beyond my capabilities.
In hindsight, I couldn’t have been more wrong.
If you’ve ever felt this way, let me tell you something. Creating a WordPress plugin is not beyond your capabilities. Anyone that has skills enough to write basic PHP and modify a theme can create a plugin.
This is how I started the Beaver Builder plugin (it’s free so you can try it) and how you can start yours too.
Why would you want to create a plugin?
If you’re like I was, you’ve probably been adding functionality to your theme instead of creating a plugin. There are plenty of cases where doing so is fine, but there are also cases where custom functionality is better off being added to a plugin. Why might you ask?
Consider this scenario.
You’ve added functionality to your theme that changes the default gravatar to your own custom gravatar. The only issue is, you’ve just changed themes and now that’s gone. If you had added that code to a plugin it would still be there when you decided to switch themes.
We ran into this issue with the Tabata Times multisite network. They use a handful of themes that need to share custom functionality. How do you think we solved that problem? You guessed it, by adding a good chunk of the functionality into a plugin so it is available to all sites on the network, regardless of which theme they are using.
Don't lock yourself into a theme. Use #WordPress Plugins for functionality instead. Share on XCreate your first plugin in five simple steps
I’m not kidding. You can create a WordPress plugin in five simple steps. Let me show you how…
1. FTP into your site
The first thing you’ll need to do is access your site via FTP using the FTP program of your choice (mine is Coda). If you’re not familiar with FTP, I recommend you read up on that before moving forward.
2. Navigate to the WordPress plugins folder
Once you’ve accessed your site via FTP, you’ll need to navigate to the WordPress plugins folder. That folder is almost always located at /wp-content/plugins.
3. Create a new folder for your plugin
Now that you’re in the plugins folder it’s time to create a folder for yours! Go ahead and create a new folder, giving it a unique name using lowercase letters and dashes such as my-first-plugin. Once you’ve done that, enter your new folder and move on to the next step.
4. Create the main PHP file for your plugin
Next, you’ll need to create the main file for your plugin. To do so, create a PHP file within your new plugin folder and give it the same name such as my-first-plugin.php. After you’ve done that, open your plugin’s main file and get ready to do some editing.
5. Setup your plugin’s information
Finally, copy and paste the plugin information below into your main plugin file. Make sure to edit the details such as Plugin Name and Plugin URI as they pertain to your plugin.
<?php
/**
* Plugin Name: My First Plugin
* Plugin URI: http://www.mywebsite.com/my-first-plugin
* Description: The very first plugin that I have ever created.
* Version: 1.0
* Author: Your Name
* Author URI: http://www.mywebsite.com
*/
That’s it! You’ve just completed the minimum number of steps that are required to create a WordPress plugin. You can now activate it within the WordPress admin and revel in all of your glory.
What now?
At this point, you’re probably wondering what this plugin is supposed to do. Well, it doesn’t do anything! I said I would show you how to create a plugin, I didn’t say I’d show you how to create a plugin that does anything. 🙂
All kidding aside, the goal of this post is to illustrate just how simple it is to get started creating WordPress plugins. Whip one up with the steps outlined above and you’re ready to start making things happen.
Making your plugin do something simple
Now that you have a plugin, let’s make it do something.
The easiest way to make things happen in WordPress is with actions and filters. Let’s explore that by creating a simple action that adds a line of text below all of the posts on your site. Copy and paste this code into your main plugin file (below the plugin information) and save it.
add_action( 'the_content', 'my_thank_you_text' );
function my_thank_you_text ( $content ) {
return $content .= '<p>Thank you for reading!</p>';
}
This code hooks into “the_content” action that fires when WordPress renders the post content for your site. When that action fires, WordPress will call our “my_thank_you_text” function that is defined below the “add_action” call.
Going beyond a simple plugin
If you’ve made it this far, hopefully, we’re in agreement that creating a simple WordPress plugin is relatively easy. But what if you want to create a plugin that does more than accomplish one simple task?
Actions and Filters
If you’re going to start coding your own plugins, I highly suggest you familiarize yourself with how actions and filters work and which ones are available for you to use. The WordPress Codex is where I spend a lot of my time, I suggest you do the same.
Plugin API: Actions and Filters
Plugin API: Action Reference
Plugin API: Filter Reference
WordPress Functions
Again, I spend a lot of my time in the WordPress Codex reading up on core functions as I develop my plugins. There are so many core functions that I wouldn’t expect you to know what each and every one of them is and does. That’s what the Codex is for, after all, so use it!
Creating an Options Page
Finally, if you end up creating a plugin that does something nifty, you’ll probably want to create an options page so people that use it can modify the functionality. Creating an options page isn’t necessary, there are many plugins that install and do something without one, but having one can be a nice addition for users of your plugin.
Creating an options page is beyond the scope of this post, so once again, I’ll leave you in the hands of the WordPress Codex.
Writing a Plugin
Creating Options Pages
If you haven’t already, create your first plugin!
Creating WordPress plugins is extremely liberating and a great way to gain a deeper knowledge of how WordPress works. If you haven’t already, I strongly urge you to try your hand at creating a plugin. If you do and come up with sometimes useful, don’t forget that you can distribute it freely to others via the WordPress plugin directory.
Have you already created your first plugin or plan on creating one soon? If so, I would love to hear about it in the comments below!
38 Comments
Related articles
48in48 Spotlight: Beaver Builder’s Nonprofit Website Builder
For the past ten years, Beaver Builder has been the go-to nonprofit website builder for 48in48. This incredible initiative brings…
Bento Grid Design in WordPress with Beaver Builder’s Box Module
The Bento Grid Design seamlessly combines clean lines, balanced proportions, and intuitive organization, drawing inspiration from Japanese bento boxes. Beaver...
10 Best WordPress Training Courses (Updated 2024)
It’s true, you can teach yourself WordPress by learning as you go. There are plenty of blogs, YouTube videos, and…
Join the community
We're here for you
There's a thriving community of builders and we'd love for you to join us. Come by and show off a project, network, or ask a question.
Since 2014
Build Your Website in Minutes, Not Months
Join Over 1 Million+ Websites Powered By Beaver Builder.
great and inspiring too
An inspiring and firing article.
Especially for me like you mentioned yourself as being afraid of the code side of WordPress.
I like and use WordPress a lot.
When it comes to add some fetaures to it I go for plugins
But as you mentioned, the plugins have some missing functions to fulfill all my needs.
So I get blocked to go further in my projects. Because I can’t do the necessary modifications to the codes.
Thus I really look forward to beIng able to cope with the codex of WordPress and get my way out through the projects.
Thanks again for the inspiring and motivating content.
Nice. Good enough for a jumpstart
What a nice article! How about another about converting a html template to a wordpress theme?
Good idea! That might be a good one to do after Gutenberg is live…
This was incredibly helpful! Thanks
Very useful icebreaker for people like me that had the same phobia of looking ‘únder the hood’ of plugins! Thanks.
Woow! Thanks so much for this, I can write plugins now. always wondered how those guys do write them, never knew it was this easy! My doubts have been cleared.
I always thought child themes were the best way to solve this problem, but alas, if I change parent themes, I lose the functionality. This makes a lot of sense. Thank you!
Glad you found the article helpful!
Yep! You got me at “I didn’t say I’d show you how to create a plugin that does anything. 🙂”
Great way to teach and keep the user engaged!
I am now adding admin interface to my plugin… thanks so much!
I think you may be missing a PHP closing tag: ?> Thanks for the tutorial!
If a file contains only PHP code, it is preferable to omit the PHP closing tag at the end of the file. This prevents accidental whitespace or new lines being added after the PHP closing tag, which may cause unwanted effects because PHP will start output buffering when there is no intention from the programmer to send any output at that point in the script.
Interesting. The other tutorials I read include the closing tag so I just assumed it was a mistake, but you’re totally right.
Thank you
Thank you for this post for all of us WP rookies 🙂 May I ask a silly question – if I add the PHP code from my child theme’s functions.php into the new plugin’s main php file, it will do the same thing but it will be independent from the theme, right? Thank you 😊
It should do the same thing, yes!
Thank you so much for sharing this. Today I manage 3 plugins of my own. It all started with this post. Thanks, Rob.
After reading your whole article very carefully then I create my first WordPress plugin. Thanks man for sharing your valuable information.
Nice post it is helpful tips for me. Thanks for sharing.
Thanks for this great post that has boosted my confidence in touching WordPress code and creating my own plugins.
Hi and thanks for the info
Is it add_action or add_filter in the above code?
as I know the ‘the_content’ is a filter not an action. So instead of add_action you should use add_filter
Great post. But there is a little bug in the code. Instead of add_action, you must use add_filter as the_content is a filter.
Thanks alot! very helpful
Hi,
I have realized your tutorial and have had some ideas regarding making a plugin. I seem it is really a nice article for every guy that would be prolific for the beginners. More might be gained and hope you will help me.
Excellent! A very easy and handy approach to developing WP plugins, I liked it.
I will be creating a calculator plugin for my WP, which I wasn’t able to find it anywhere online.
Thanks for sharing
Can i use this steps for WordPress 5.3.x ?
Hi, thanks for the basics, as most have said but having looked around Wordpress, as suggested, I can’t find the “How to add” a “View Details” page. You know like, how many people are using it, star ratings, etc. A link or post on this subject would be good.
Thanks
This is wow! I thought creating a plugin will cost me heaven and earth.
Thanks for the great post 🙂
Thanks exactly what I needed!
This is great, as someone trying to decide if I want to jump into plugin development this was really helpful.
Today i built my 1st plugin. Thanks for the inspiration 🙂
This was awesome article! Just made a quick plugin using your BB module usage filter. Woohoo!
I haven’t created a plugin, yet however I do regularly create custom content for themes. When is it good to use a plugin and when would you advise against it?
I’m considering what pieces of my current theme I want to break out into plugins to help with version control.
I don’t want to have a ton of plugins activated in the site but also looking to implement plugins when it is smart to do so and I’m interested in your thoughts about this.
Nice one.
I was thinking creating wordpress plugin is very difficult task but after reading this blog my mind is totally changes
thank you.
Perfect Post! I really like your simple and perfect message. Thanks a lot for your nice share. I will lots of time in Codex for learning your tips. Thanks again
Just amazing Post. It’s helpful for all blogger who are using WordPress.