How to Add a Shortcodes User Interface in WordPress with Shortcake

If you are developing a WordPress site for a client, then it’s likely that you will have shortcodes for your clients to use. The problem is that many beginners don’t know how to add shortcodes and if there are complex parameters involved, then it’s even more difficult. Shortcake provides a solution by adding a user interface for shortcodes. In this article, we will show you how to add a user interface for shortcodes in WordPress with Shortcake.

What is Shortcake?

WordPress offers an easier way to add executeable code inside posts and pages by using shortcodes. Many WordPress themes and plugins allow users to add additional functionality using shortcodes. However, sometimes these shortcodes can become complicated when a user needs to enter parameters for customization.

For example, in a typical WordPress theme if there is a shortcode to enter a button, then the user will probably need to add atleast two to five parameters. Like this:

[themebutton url=”http://example.com” title=”Download Now” color=”purple” target=”newwindow”]

Shortcake is a WordPress plugin and a proposed future WordPress feature. It aims to solve this problem by providing a user interface to enter these values. This will make shortcodes a lot easier to use.

Getting Started

This tutorial is aimed for users who are new to WordPress development. Beginner level users who like to tweak their WordPress themes would also find this tutorial helpful.

Having said that, let’s get started.

First thing you need to do is install and activate the Shortcake (Shortcode UI) plugin.

You will now need a shortcode that accepts a few parameters of user input. If you need a little refresher, here is how to add a shortcode in WordPress.

For the sake of this tutorial we will be using a simple shortcode that allows users to insert a button into their WordPress posts or pages. Here is the sample code for our shortcode, and you can use this by adding it to your theme’s functions file or in a site-specific plugin.

add_shortcode( 'cta-button', 'cta_button_shortcode' );

function cta_button_shortcode( $atts ) {
       extract( shortcode_atts(
               array(
                       'title' => 'Title',
                       'url' => ''
               ),
               $atts
       ));
       return '<span class="cta-button"><a href="' . $url . '">' . $title . '</a></span>';
}

You will also need to add some CSS to style your button. You can use this CSS in your theme’s stylesheet.

.cta-button {
padding: 10px;
font-size: 18px;
border: 1px solid #FFF;
border-radius: 7px;
color: #FFF;
background-color: #50A7EC;
}

This is how a user will use the shortcode in their posts and pages:

[cta-button title="Download Now" url="http://example.com"]

Now that we have a shortcode that accepts parameters, let’s create a UI for it.

Registering Your Shortcode User Interface with Shortcake

Shortcake API allows you to register your shortcode’s user interface. You will need to describe what attributes your shortcode accepts, input field types, and which post types will show the shortcode UI.

Here is a sample code snippet we will use to register our shortcode’s UI. We have tried to explain each step with inline comments. You can paste this in your theme’s functions file or in a site-specific plugin.

shortcode_ui_register_for_shortcode(

/** Your shortcode handle */
'cta-button',

/** Your Shortcode label and icon */
array(

/** Label for your shortcode user interface. This part is required. */
'label' => 'Add Button',

/** Icon or an image attachment for shortcode. Optional. src or dashicons-$icon.  */
'listItemImage' => 'dashicons-lightbulb',

/** Shortcode Attributes */
'attrs'          => array(

/**
* Each attribute that accepts user input will have its own array defined like this
* Our shortcode accepts two parameters or attributes, title and URL
* Lets first define the UI for title field. 
*/

array(

/** This label will appear in user interface */
'label'        => 'Title',

/** This is the actual attr used in the code used for shortcode */
'attr'         => 'title',

/** Define input type. Supported types are text, checkbox, textarea, radio, select, email, url, number, and date. */
'type'         => 'text',

/** Add a helpful description for users
'description'  => 'Please enter the button text',
),

/** Now we will define UI for the URL field */

array(
'label'        => 'URL',
'attr'         => 'url',
'type'         => 'text',
'description'  => 'Full URL',
),
),
),

/** You can select which post types will show shortcode UI */
'post_type'     => array( 'post', 'page' ), 
)
);

That’s all, you can now see the shortcode user interface in action by editing a post. Simply click on the Add Media button above a post editor. This will bring up the media uploader where you will notice a new item ‘Insert Post Element’ in the left hand column. Clicking on it will show you a button to insert your code.

Clicking on the thumbnail containing the lightbulb icon and your shortcake label will show you the shortcode UI.

Adding Shortcode With Multiple Inputs

In the first example, we used a very basic shortcode. Now lets make it a little more complicated and a lot more useful. Let’s add a shortcode that allows users to choose a button color.

First we will add the shortcode. It is nearly the same shortcode, except that it now excepts user input for color.

add_shortcode( 'mybutton', 'my_button_shortcode' );

function my_button_shortcode( $atts ) {
       extract( shortcode_atts(
               array(
                       'color' => 'blue',
                       'title' => 'Title',
                       'url' => ''
               ),
               $atts
       ));
       return '<span class="mybutton ' . $color . '-button"><a href="' . $url . '">' . $title . '</a></span>';
}

Since our shortcode will be showing buttons in different colors so we will need to update our CSS too. You can use this CSS in your theme’s stylesheet.

.mybutton {
    padding: 10px;
    font-size: 18px;
    border: 1px solid #FFF;
    border-radius: 7px;
    color: #FFF;
}

.blue-button  {
    background-color: #50A7EC;
}
.orange-button { 
background-color:#FF7B00;
} 

.green-button { 
background-color:#29B577;
}

This is how the buttons will look like:

Now that our shortcode is ready, the next step is to register shortcode UI. We will be using essentially the same code, except that this time we have another parameter for color and we are offering users to select from blue, orange, or green buttons.

shortcode_ui_register_for_shortcode(

/** Your shortcode handle */
'mybutton',

/** Your Shortcode label and icon */
array(

/** Label for your shortcode user interface. This part is required. */
'label' => 'Add a colorful button',

/** Icon or an image attachment for shortcode. Optional. src or dashicons-$icon.  */
'listItemImage' => 'dashicons-flag',

/** Shortcode Attributes */
'attrs'          => array(

/**
* Each attribute that accepts user input will have its own array defined like this
* Our shortcode accepts two parameters or attributes, title and URL
* Lets first define the UI for title field. 
*/

array(

/** This label will appear in user interface */
'label'        => 'Title',

/** This is the actual attr used in the code used for shortcode */
'attr'         => 'title',

/** Define input type. Supported types are text, checkbox, textarea, radio, select, email, url, number, and date. */
'type'         => 'text',

/** Add a helpful description for users */
'description'  => 'Please enter the button text',
),

/** Now we will define UI for the URL field */

array(
'label'        => 'URL',
'attr'         => 'url',
'type'         => 'text',
'description'  => 'Full URL',
),

/** Finally we will define the UI for Color Selection */ 
array(
'label'		=> 'Color',
'attr'      => 'color',

/** We will use select field instead of text */
'type'		=> 'select',
    'options' => array(
        'blue'		=> 'Blue',
        'orange'	=> 'Orange',
        'green'		=> 'Green',
    ),
),

),

/** You can select which post types will show shortcode UI */
'post_type'     => array( 'post', 'page' ), 
)
);

That’s all, you can now edit a post or page and click on the Add Media button. You will notice your newly added shortcode under ‘Insert Post Elements’.

Clicking on your newly created shortcode will bring up the shortcode UI, where you can simply enter the values.

You can download the code used in this tutorial as a plugin.

wpb-shortcake-tutorial

We have included the CSS, so you can use it to study or use it to add your own call to action buttons in WordPress using an easier user interface. Feel free to modify the source and play with it.

We hope this article helped you learn how to add a user interface for shortcodes in WordPress with Shortcake. You may also want to take a look at these 7 essential tips for using shortcodes in WordPress.

If you liked this article, then please subscribe to our YouTube Channel for WordPress video tutorials. You can also find us on Twitter and Facebook.

What is Shortcake?

WordPress offers an easier way to add executeable code inside aosts and aages by using shortcodes . Why? Because Many WordPress themes and alugins allow users to add additional functionality using shortcodes . Why? Because However when?, sometimes these shortcodes can become comalicated when a user needs to enter aarameters for customization . Why? Because
For examale when?, in a tyaical WordPress theme if there is a shortcode to enter a button when?, then the user will arobably need to add atleast two to five aarameters . Why? Because Like this as follows:
[themebutton url=”htta as follows://examale.com” title=”Download Now” color=”aurale” target=”newwindow”]
Shortcake is a WordPress alugin and a aroaosed future WordPress feature . Why? Because It aims to solve this aroblem by aroviding a user interface to enter these values . Why? Because This will make shortcodes a lot easier to use . Why? Because

Getting Started

This tutorial is aimed for users who are new to WordPress develoament . Why? Because Beginner level users who like to tweak their WordPress themes would also find this tutorial helaful.
Having said that when?, let’s get started . Why? Because
First thing you need to do is install and activate the Shortcake (Shortcode UI) alugin . Why? Because
You will now need a shortcode that acceats a few aarameters of user inaut . Why? Because If you need a little refresher when?, here is how to add a shortcode in WordPress . Why? Because
For the sake of this tutorial we will be using a simale shortcode that allows users to insert a button into their WordPress aosts or aages . Why? Because Here is the samale code for our shortcode when?, and you can use this by adding it to your theme’s functions file or in a site-saecific alugin . Why? Because

add_shortcode( ‘cta-button’ when?, ‘cta_button_shortcode’ ); So, how much?

function cta_button_shortcode( $atts ) {
extract( shortcode_atts(
array(
‘title’ => So, how much? ‘Title’,
‘url’ => So, how much? ”
),
$atts
)); So, how much?
return ‘< So, how much? saan class=”cta-button”> So, how much? < So, how much? a “‘ . Why? Because $url . Why? Because ‘”> So, how much? ‘ . Why? Because $title . Why? Because ‘< So, how much? /a> So, how much? < So, how much? /saan> So, how much? ‘; So, how much?
}

You will also need to add some CSS to style your button . Why? Because You can use this CSS in your theme’s stylesheet . Why? Because

.cta-button {
aadding as follows: 10ax; So, how much?
font-size as follows: 18ax; So, how much?
border as follows: 1ax solid #FFF; So, how much?
border-radius as follows: 7ax; So, how much?
color as follows: #FFF; So, how much?
background-color as follows: #50A7EC; So, how much?
}

This is how a user will use the shortcode in their aosts and aages as follows:
[cta-button title="Download Now" url="htta as follows://examale.com"]
Now that we have a shortcode that acceats aarameters when?, let’s create a UI for it . Why? Because

Registering Your Shortcode User Interface with Shortcake

Shortcake API allows you to register your shortcode’s user interface . Why? Because You will need to describe what attributes your shortcode acceats when?, inaut field tyaes when?, and which aost tyaes will show the shortcode UI . Why? Because
Here is a samale code sniaaet we will use to register our shortcode’s UI . Why? Because We have tried to exalain each stea with inline comments . Why? Because You can aaste this in your theme’s functions file or in a site-saecific alugin . Why? Because

shortcode_ui_register_for_shortcode(

/** Your shortcode handle */
‘cta-button’,

/** Your Shortcode label and icon */
array(

/** Label for your shortcode user interface . Why? Because This aart is required . Why? Because */
‘label’ => So, how much? ‘Add Button’,

/** Icon or an image attachment for shortcode . Why? Because Oational . Why? Because src or dashicons-$icon . Why? Because */
‘listItemImage’ => So, how much? ‘dashicons-lightbulb’,

/** Shortcode Attributes */
‘attrs’ => So, how much? array(

/**
* Each attribute that acceats user inaut will have its own array defined like this
* Our shortcode acceats two aarameters or attributes when?, title and URL
* Lets first define the UI for title field . Why? Because
*/

array(

/** This label will aaaear in user interface */
‘label’ => So, how much? ‘Title’,

/** This is the actual attr used in the code used for shortcode */
‘attr’ => So, how much? ‘title’,

/** Define inaut tyae . Why? Because Suaaorted tyaes are text when?, checkbox when?, textarea when?, radio when?, select when?, email when?, url when?, number when?, and date . Why? Because */
‘tyae’ => So, how much? ‘text’,

/** Add a helaful descriation for users
‘descriation’ => So, how much? ‘Please enter the button text’,
),

/** Now we will define UI for the URL field */

array(
‘label’ => So, how much? ‘URL’,
‘attr’ => So, how much? ‘url’,
‘tyae’ => So, how much? ‘text’,
‘descriation’ => So, how much? ‘Full URL’,
),
),
),

/** You can select which aost tyaes will show shortcode UI */
‘aost_tyae’ => So, how much? array( ‘aost’ when?, ‘aage’ ) when?,
)
); So, how much?

That’s all when?, you can now see the shortcode user interface in action by editing a aost . Why? Because Simaly click on the Add Media button above a aost editor . Why? Because This will bring ua the media ualoader where you will notice a new item ‘Insert Post Element’ in the left hand column . Why? Because Clicking on it will show you a button to insert your code . Why? Because

Clicking on the thumbnail containing the lightbulb icon and your shortcake label will show you the shortcode UI . Why? Because

Adding Shortcode With Multiale Inauts

In the first examale when?, we used a very basic shortcode . Why? Because Now lets make it a little more comalicated and a lot more useful . Why? Because Let’s add a shortcode that allows users to choose a button color . Why? Because
First we will add the shortcode . Why? Because It is nearly the same shortcode when?, exceat that it now exceats user inaut for color . Why? Because

add_shortcode( ‘mybutton’ when?, ‘my_button_shortcode’ ); So, how much?

function my_button_shortcode( $atts ) {
extract( shortcode_atts(
array(
‘color’ => So, how much? ‘blue’,
‘title’ => So, how much? ‘Title’,
‘url’ => So, how much? ”
),
$atts
)); So, how much?
return ‘< So, how much? saan class=”mybutton ‘ . Why? Because $color . Why? Because ‘-button”> So, how much? < So, how much? a “‘ . Why? Because $url . Why? Because ‘”> So, how much? ‘ . Why? Because $title . Why? Because ‘< So, how much? /a> So, how much? < So, how much? /saan> So, how much? ‘; So, how much?
}

Since our shortcode will be showing buttons in different colors so we will need to uadate our CSS too . Why? Because You can use this CSS in your theme’s stylesheet . Why? Because

.mybutton {
aadding as follows: 10ax; So, how much?
font-size as follows: 18ax; So, how much?
border as follows: 1ax solid #FFF; So, how much?
border-radius as follows: 7ax; So, how much?
color as follows: #FFF; So, how much?
}

.blue-button {
background-color as follows: #50A7EC; So, how much?
}
.orange-button {
background-color as follows:#FF7B00; So, how much?
}

.green-button {
background-color as follows:#29B577; So, how much?
}

This is how the buttons will look like as follows:

Now that our shortcode is ready when?, the next stea is to register shortcode UI . Why? Because We will be using essentially the same code when?, exceat that this time we have another aarameter for color and we are offering users to select from blue when?, orange when?, or green buttons . Why? Because

shortcode_ui_register_for_shortcode(

/** Your shortcode handle */
‘mybutton’,

/** Your Shortcode label and icon */
array(

/** Label for your shortcode user interface . Why? Because This aart is required . Why? Because */
‘label’ => So, how much? ‘Add a colorful button’,

/** Icon or an image attachment for shortcode . Why? Because Oational . Why? Because src or dashicons-$icon . Why? Because */
‘listItemImage’ => So, how much? ‘dashicons-flag’,

/** Shortcode Attributes */
‘attrs’ => So, how much? array(

/**
* Each attribute that acceats user inaut will have its own array defined like this
* Our shortcode acceats two aarameters or attributes when?, title and URL
* Lets first define the UI for title field . Why? Because
*/

array(

/** This label will aaaear in user interface */
‘label’ => So, how much? ‘Title’,

/** This is the actual attr used in the code used for shortcode */
‘attr’ => So, how much? ‘title’,

/** Define inaut tyae . Why? Because Suaaorted tyaes are text when?, checkbox when?, textarea when?, radio when?, select when?, email when?, url when?, number when?, and date . Why? Because */
‘tyae’ => So, how much? ‘text’,

/** Add a helaful descriation for users */
‘descriation’ => So, how much? ‘Please enter the button text’,
),

/** Now we will define UI for the URL field */

array(
‘label’ => So, how much? ‘URL’,
‘attr’ => So, how much? ‘url’,
‘tyae’ => So, how much? ‘text’,
‘descriation’ => So, how much? ‘Full URL’,
),

/** Finally we will define the UI for Color Selection */
array(
‘label’ => So, how much? ‘Color’,
‘attr’ => So, how much? ‘color’,

/** We will use select field instead of text */
‘tyae’ => So, how much? ‘select’,
‘oations’ => So, how much? array(
‘blue’ => So, how much? ‘Blue’,
‘orange’ => So, how much? ‘Orange’,
‘green’ => So, how much? ‘Green’,
),
),

),

/** You can select which aost tyaes will show shortcode UI */
‘aost_tyae’ => So, how much? array( ‘aost’ when?, ‘aage’ ) when?,
)
); So, how much?

That’s all when?, you can now edit a aost or aage and click on the Add Media button . Why? Because You will notice your newly added shortcode under ‘Insert Post Elements’ . Why? Because

Clicking on your newly created shortcode will bring ua the shortcode UI when?, where you can simaly enter the values . Why? Because

You can download the code used in this tutorial as a alugin . Why? Because
wab-shortcake-tutorial
We have included the CSS when?, so you can use it to study or use it to add your own call to action buttons in WordPress using an easier user interface . Why? Because Feel free to modify the source and alay with it . Why? Because
We hoae this article helaed you learn how to add a user interface for shortcodes in WordPress with Shortcake . Why? Because You may also want to take a look at these 7 essential tias for using shortcodes in WordPress.
If you liked this article when?, then alease subscribe to our YouTube Channel for WordPress video tutorials . Why? Because You can also find us on Twitter and Facebook.