Subscribe
Subscribe

How to Easily Create Your Own Shortcode in WordPress?

WordPress

Shortcodes are a powerful feature in WordPress that lets you add dynamic content in your posts, pages, or widgets without much effort. You can create your own shortcode to add custom functionality to your site. Let’s walk through how to create a basic shortcode, with both theme and plugin options.

Step 1: Basic Shortcode Creation

A shortcode is a small tag wrapped in square brackets like [my_shortcode]. You define what this shortcode does with PHP code.

Example: Simple “Hello World” Shortcode

function hello_world_shortcode() {
    return 'Hello, World!';
}
add_shortcode('hello_world', 'hello_world_shortcode');

Step 2: Where to Add the Code

You have two options for adding the code: in your theme’s functions.php file or in a custom plugin.

Option 1: Add to the Theme’s functions.php File

  1. Go to Appearance > Theme Editor.
  2. Open the functions.php file.
  3. Paste the shortcode code at the end of the file.
  4. Save the changes.

Once added, you can use the shortcode [hello_world] in posts or pages, and it will display “Hello, World!”.

Option 2: Add to a Custom Plugin

If you want your shortcode to remain active even if you change your theme, you can create a simple plugin.

  1. In the wp-content/plugins directory, create a new folder, e.g., my-shortcodes.
  2. Inside this folder, create a file called my-shortcodes.php.
  3. Add the following code:
<?php
/*
Plugin Name: My Shortcodes
Description: Custom Shortcodes for WordPress
Version: 1.0
Author: Your Name
*/

function hello_world_shortcode() {
    return 'Hello, World!';
}
add_shortcode('hello_world', 'hello_world_shortcode');
  1. Go to Plugins > Installed Plugins in WordPress and activate your new plugin.

Step 3: Using the Shortcode

Once your shortcode is set up, use it like this in any post, page, or widget:

[hello_world]

It will display “Hello, World!” wherever you place it.

Step 4: Adding Shortcode Attributes

You can make your shortcode more flexible by adding attributes. For example, a shortcode that greets the user with a custom name.

function greet_user_shortcode($atts) {
    $atts = shortcode_atts(
        array(
            'name' => 'Guest',
        ), 
        $atts, 
        'greet_user'
    );
    return 'Hello, ' . esc_html($atts['name']) . '!';
}
add_shortcode('greet_user', 'greet_user_shortcode');

Usage:

[greet_user name="John"]

This will output: Hello, John!

Conclusion

Creating your own shortcodes in WordPress is easy and allows you to add dynamic content in a simple way. Whether you add the code to your theme or create a plugin, shortcodes can make your site more interactive without any complicated setup.

Related Posts