开发者 | helgatheviking |
---|---|
更新时间 | 2024年4月25日 02:57 |
捐献地址: | 去捐款 |
PHP版本: | 6.1 及以上 |
WordPress版本: | 6.5.0 |
版权: | GPLv3 or later |
版权网址: | 版权信息 |
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.
plugin
folder to the /wp-content/plugins/
directoryThe 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.
`
/**
You could also filter
the_titleand 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.
/**
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:
`
`
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
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; }
Yes! You can use this bridge plugin to automatically display the subtitle in most WooCommerce locations.
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' );
WPML now supports KIA Subtitle!
kia_subtitle_sanitize_subtitle
for adding your own custom sanitization rules.the_subtitle
to allow subtitle content to be modifiedthe_subtitle( $before = '', $after = '', $echo = true )