KIA Subtitle

FAQ

How do I display the subtitle in my theme?

The intended way is with the the_subtitle() template tag as follows:

if ( function_exists( 'the_subtitle' ) ) the_subtitle();

You can wrap the string in some markup using the $before and $after parameters.

if ( function_exists( 'the_subtitle' ) ) the_subtitle( '<h2 class="subtitle">', '</h2>' );

As an absolute worst case fallback you could also add the following snippet to your functions.php in order to prepend the subtitle to the content.

/**
 * Prepend the subtitle to the post content. 
 *
 * @param string $content The post content
 * @return string
 */
function kia_prepend_subtitle_to_content( $content ) {
    if ( ! is_admin() ) {

        $subtitle = function_exists( 'get_the_subtitle' ) ? get_the_subtitle() : '';

        if ( ! empty( $subtitle ) ) {
            $content = '<h2 class="subtitle">' . wp_kses_post( $subtitle ) . '</h2>' . $content;
        }
    }
    return $content;
}
add_filter( 'the_content', 'kia_prepend_subtitle_to_content' );

You could also filter the_title and but it would have to be part of the post title’s markup and could not have it’s own markup as nesting header elements is invalid HTML markup.

/**
 * Append the subtitle to the title. 
 *
 * @param string $title The post title
 * @return string
 */
function kia_append_subtitle_to_title( $title ) {
    if ( ! is_admin() ) {
        $subtitle = function_exists( 'get_the_subtitle' ) ? get_the_subtitle() : '';

        if ( ! empty( $subtitle ) ) {
            $title .= ' — ' . wp_kses_post( $subtitle );
        }
    }
    return $title;
}
add_filter( 'the_title', 'kia_append_subtitle_to_title' );

Where do I add this code?

Unfortunately, I cannot tell you exactly what file to place the above code in because 1. I don’t know where you want to display the subtitle and 2. every theme’s structure is different.

However, in general, the_subtitle() is a template tag so you will want to put it in a template file. Probably, you are looking for the file that contains your post loop. For most themes it’s single.php ( or page.php for pages ), but for many it could also be content.php. Assuming you want the subtitle to display directly after your main title, you’d place the above code after:

<h1 class="entry-title"><?php the_title(); ?></h1>

As an example if you wanted to display the subtitle on standard single posts, in the Twenty Twenty theme you’d create a copy of the entry-header.php template in your child theme and modify it as shown in this gist

How do I style the subtitle?

If you have wrapped the subtitle in an H2 tag with the class of subtitle like in the gist above, you can then style it any way you’d like.

.subtitle { color: pink; }

Can I display the subtitle for my WooCommmerce products

Yes! You can use this bridge plugin to automatically display the subtitle in most WooCommerce locations.

Can I add the subtitle to the Page Title Meta tag

function kia_add_subtitle_to_wp_title( $title ) {
if ( is_single() && function_exists( ‹get_the_subtitle› ) ) && $subtitle == get_the_subtitle( get_the_ID() ) ) {
$title .= $subtitle;
}
}
add_filter( ‹wp_title›, ‹kia_add_subtitle_to_wp_title› );

Is this translation ready?

WPML now supports KIA Subtitle!