About this plugin
KIA subtitle allows you to add a subtitle to your posts and retrieve it in the loop in the same manner as the post title. By using the Subtitle block or the the_subtitle() or get_the_subtitle() template tags.
It adds an input field right under the title field of posts, pages and any custom post type. It also add a subtitle column to the edit screen as well as to the quick edit.
You can also use the Subtitle block or the shortcode [the-subtitle] to display it within the post content.
Site Editor
The plugin provides a Subtitle block in the editor. In the post editor, this doesn’t make a lot of sense, but mimics the core Title block. The ideal use case for the Subtitle block is when editing your theme
- Click Edit Site in the WordPress toolbar
- Select the template you wish to edit, commonly this might be called Single Post, or Singular.
- Insert the Subtitle block where needed, commonly right after the Title block.
Template Tags
This plugin does not attempt to output the subtitle. With an infinite number of themes, it is not possible for us to support that. The onus is on the user to customize their theme accordingly.
The plugin provides two template tags that can be used to customize your theme as desired.
`the_subtitle( string $before
”, string $after = ”, bool $display = true ): void|string` =
Displays or retrieves the current post subtitle with optional markup.
Parameters
$before `string` `optional` Markup to prepend to the title. Default: `''`
$after `string` `optional` Markup to append to the title. Default: `''`
$display `bool` `optional` Whether to echo or return the title. Default true for echo. Default: `true`
Example usage:
if ( function_exists( 'the_subtitle' ) ) the_subtitle( '<h2 class="subtitle">', '</h2>' );
`get_the_subtitle( int|WP_Post $post ): string`
Retrieves the post subtitle.
Parameters
$post `int|WP_Post` `optional` Post ID or WP_Post object. Default: global `$post` object.
`
WooCommerce support
There is a small bridge plugin you can install and activate to automatically display the subtitle in most WooCommerce locations. This will work for all themes that are using WooCommerce’s default hooks.
NB: It’s known that the Ocean WP theme has it’s own hooks in the WooCommerce templates. You will need to alter the bridge plugin… please take a look at this support thread.
WPML Ready
KIA Subtitle has been tested by WPML and will allow you to translate the subtitle on multilingual sites.
Support
Support is handled in the WordPress forums. Please note that support is limited and does not cover any custom implementation of the plugin.
Please report any bugs, errors, warnings, code problems to Github