How to Create WordPress Plugin from Scratch – Step-by-Step Guide

Introduction:

When you want to extend the functionality of your WordPress site, the best way is to create WordPress plugin. A custom plugin allows you to add new features, improve functionality, and enhance your website without editing the core files. In this guide, we’ll walk you through the steps required to create WordPress plugin from scratch, perfect for both beginners and experienced developers.

By following these instructions, you’ll learn how to set up your plugin folder, write the code, and deploy the plugin on your WordPress website. Let’s get started and learn how to create WordPress plugin today!

What You’ll Need to Create a WordPress Plugin:

To get started with creating WordPress plugin, you will need a few tools:

• A local WordPress installation or a live WordPress environment
• A code editor, such as Visual Studio Code or Notepad++
• Basic knowledge of PHP, HTML, and CSS
• FTP or file access to your wp-content/plugins directory

By having these tools ready, you’ll be able to create WordPress plugin easily.

Step-by-Step Instructions to Create WordPress Plugin

Step 1: Setting Up Your Plugin Folder

To begin, every WordPress plugin needs its own folder inside the wp-content/plugins directory of your WordPress installation. Start by navigating to the wp-content/plugins directory and create a new folder named after your plugin.

For example, if you want to call your plugin “Custom Welcome Message,” name the folder custom-welcome-message.

Step 2: Creating the Main Plugin File

Inside the folder you just created, you need to add a PHP file that will serve as the main plugin file. Typically, this file shares the same name as the folder. For example, custom-welcome-message.php.

At the top of this PHP file, include a comment block that tells WordPress about your plugin. This is required for WordPress to recognize the plugin. Here’s a template:

<?php
/*
Plugin Name: Custom Welcome Message
Plugin URI: https://example.com/custom-welcome-message
Description: A plugin to add a custom welcome message to the homepage.
Version: 1.0
Author: Your Name
Author URI: https://example.com
License: GPL2
*/
?>

This block includes basic information like the plugin’s name, version, and author. You can modify this information to suit your needs.

Step 3: Basic Plugin Functionality – Adding a Custom Message

Now that your plugin is set up, it’s time to add some functionality. Let’s start by adding a simple message that appears on your homepage.

Add this code to your custom-welcome-message.php file:

function display_welcome_message() {
    echo '<p style="text-align:center; font-size:20px;">Welcome to My WordPress Site!</p>';
}
add_action('wp_footer', 'display_welcome_message');

This code defines a function called display_welcome_message that adds a simple message in the footer of your site. The add_action hook tells WordPress to run this function whenever the wp_footer is generated.

Step 4: Activating Your Plugin

At this stage, your plugin is functional but not yet activated. Go to your WordPress dashboard, click on Plugins, and you should see your plugin listed. Click Activate.

Visit the homepage of your website to see the custom message displayed at the bottom.

Step 5: Enhancing the Plugin with Custom Settings

Now let’s make your plugin more dynamic by allowing users to customize the welcome message through the WordPress admin panel.

Adding a Settings Page:

First, we’ll need to add a settings page to the WordPress admin where users can input their custom message. Add the following code to your plugin file:

function custom_message_menu() {
    add_options_page(
        'Custom Welcome Message Settings',
        'Welcome Message',
        'manage_options',
        'custom-welcome-message',
        'custom_message_settings_page'
    );
}
add_action('admin_menu', 'custom_message_menu');

function custom_message_settings_page() {
    ?>
    <div class="wrap">
        <h1>Custom Welcome Message Settings</h1>
        <form method="post" action="options.php">
            <?php
            settings_fields('custom_message_group');
            do_settings_sections('custom-welcome-message');
            submit_button();
            ?>
        </form>
    </div>
    <?php
}

Registering the Setting:

Next, we need to register the setting so that WordPress can save the message. Add this code to your plugin file:

function custom_message_settings_init() {
    register_setting('custom_message_group', 'custom_welcome_message');

    add_settings_section(
        'custom_message_section',
        'Message Settings',
        null,
        'custom-welcome-message'
    );

    add_settings_field(
        'custom_welcome_message_field',
        'Enter your custom message:',
        'custom_message_field_callback',
        'custom-welcome-message',
        'custom_message_section'
    );
}
add_action('admin_init', 'custom_message_settings_init');

function custom_message_field_callback() {
    $message = get_option('custom_welcome_message');
    echo '<input type="text" name="custom_welcome_message" value="' . esc_attr($message) . '" />';
}

Displaying the Custom Message:

Now, modify the function that displays the message to use the saved setting:

function display_welcome_message() {
    $message = get_option('custom_welcome_message', 'Welcome to My WordPress Site!');
    echo '<p style="text-align:center; font-size:20px;">' . esc_html($message) . '</p>';
}

Step 6: Testing and Debugging

Make sure to test your plugin thoroughly. Change the message in the settings, save it, and check if it updates correctly on your site. Look for any errors in the PHP log or in your browser’s developer console to ensure everything works as expected.

Step 7: Deploying Your Plugin

Once your plugin is functioning and tested, you can deploy it. If you’re sharing it with others or releasing it publicly, make sure to:

• Add a README file with instructions.
• Make sure the plugin is secure by sanitizing user inputs.
• Test compatibility with different versions of WordPress.

You can upload the plugin via FTP to your WordPress site or submit it to the WordPress Plugin Repository if you plan on sharing it with the community.

Conclusion:

Now that you’ve followed this guide and learned how to create WordPress plugin, you have the foundation to start building custom features for your site. WordPress plugins are a powerful way to extend the functionality of your website without altering core files. With a little practice, you’ll be able to create more advanced plugins that meet your exact needs.

Don’t stop here—now that you know how to create WordPress plugin, continue experimenting and enhancing your plugin development skills.

References:
WordPress Plugin Handbook
The official documentation for developing WordPress plugins. It covers everything from basic plugin creation to advanced features.
WordPress Plugin Handbook

How to Create a WordPress Plugin (for Beginners)
A beginner-friendly guide with step-by-step instructions on creating your first plugin.
WPMU DEV Blog

Writing a Plugin
A detailed guide from WordPress Codex on the essential aspects of plugin writing.
WordPress Codex

Best Practices for WordPress Plugin Development
Tips and guidelines on how to ensure your plugin is secure, well-coded, and performs optimally.
Smashing Magazine

Explore More: “Solving Rest API CORS Issues in WordPress as a Headless CMS”