Add subtitles (subheadings) to your pages, posts or custom post types.

Ben Huson

husani

The WP Subtitle plugin allows your pages and posts to contain a subtitle. Also called a sub-heading, this this short line of text is meant to appear beneath a post’s (or page’s) title, but can be inserted in your template wherever you choose.
The subtitle can be inserted into your theme template files (or plugin) using the following API:
<h4>Display The Subtitle</h4>
All parameters are optional. If ‘post_id’ is omitted then the current post ID in the loop is used.
PHP Code:
<pre><code>do_action( 'plugins/wp_subtitle/the_subtitle', array(
 'before' => '',
 'after' => '',
 'post_id' => get_the_ID(),
 'default_value' => ''
) );
</code></pre>
Output:
<pre><code>My Post Subtitle
</code></pre>
<h4>Get The Subtitle</h4>
All parameters are optional. If ‘post_id’ is omitted then the current post ID in the loop is used.
A default value can be supplied as the second parameter for <code>apply_filters</code>. This will be used if the post does not have a subtitle. Leave as an empty string to return an empty string if the post does not have a subtitle.
PHP Code:
<pre><code>$subtitle = apply_filters( 'plugins/wp_subtitle/get_subtitle', '', array(
 'before' => '',
 'after' => '',
 'post_id' => get_the_ID()
) );
</code></pre>
Result:
<pre><code>$subtitle = 'My Post Subtitle'
</code></pre>
<h4>Parameters</h4>
The array of arguments accepted for the <code>plugins/wp_subtitle/the_subtitle</code> action and <code>plugins/wp_subtitle/get_subtitle</code> filter are:
before 
(string) Text to place before the subtitle if one exists. Defaults to an empty string.
after 
(string) Text to place after the subtitle if one exists. Defaults to to an empty string.
post_id 
(integer) Post, page or custom post type ID.
default_value 
(string) Only used by the <code>plugins/wp_subtitle/the_subtitle</code> action, allows you to specify a default subtitle to display if the post does not have one. For the <code>plugins/wp_subtitle/get_subtitle</code> filter the second parameter of <code>apply_filters</code> should be used instead. Defaults to to an empty string.
<h4>Post Type Support</h4>
By default, subtitle are supported by both posts and pages. To add support for custom post types add teh following to your theme functions file or plugin:
<pre><code>add_post_type_support( 'my_post_type', 'wps_subtitle' )
</code></pre>
<h4>WooCommerce Plugin Support</h4>
Subtitles can automatically be added to your WooCommerce products without needing to make template changes. In the admin go to WooCommerce > Settings > Products where you can choose to:
<ul>
<li>Enable Product Subtitles</li>
<li>Display the subtitle on single product pages</li>
<li>Display the subtitle on product archives (category pages)</li>
</ul>
<h4>Yoast SEO and SEOPress Plugin Support</h4>
The plugin allows you to include the subtitle in your meta titles and descriptions via the <a href="https://wordpress.org/plugins/wordpress-seo/" rel="ugc">Yoast SEO</a> and <a href="https://wordpress.org/plugins/wp-seopress/" rel="ugc">SEOPress</a> plugins.
Similar to the Yoast <code>%%title%%</code> placeholder which inserts the post title, you can use <code>%%wps_subtitle%%</code>.
There are also addition placeholders and filters to allow to to customize seperators for the subtitle.
For more information, <a href="https://github.com/benhuson/wp-subtitle/wiki/Yoast-SEO-Plugin-Support" rel="nofollow ugc">view the SEO support documentation here</a>.

WP Subtitle

Works great!

The development of this plugin follows the WordPress future.


Development

I found this plugin when developing a theme where I needed to show the subtitle below the title of the page/post/CPT. Now I saw many reviews saying what's the point of this plugin or this is not a plug-n-play plugin etc. and I would like those people to say, trust me, guys, you have no development experience whatsoever, otherwise you would have understood the importance of the plugin and thanked that it is not a plug-n-play plugin which gives you full control over how you wanna show, where you wanna show and styling.

When Gutenberg was in beta it has the subheading block built-in, but then it did not get released. What a shame! Anyways, I initially thought that I will create a custom Gutenberg Block myself for the subheading, but I quickly saw that any block you make will be shown inside the the_content(); section. Which didn't worked for me as I wanted it outside of the content so that I can place it below the title and show where I want it to be shown. Also, you can easily add the subtitle support to your CPT which is truly awesome.

Again, I will highly recommend this plugin and I would have given 10 stars if it was possible. I just hope that the plugin developer maintains the plugin in future and not leave it in the middle as this is truly an amazing plugin which I would hate to see die.

Alternatives to WP Subtitle

Top alternatives