Philip Arthur Moore

We Cobble

<p>Right now WordPress currently presents no easy way for web publishers to add subtitles into their posts, pages, and other custom post types. This leaves users and developers in a bit of a quandary, trying to figure out how best to present subtitles in a beautiful and sensible way. Post <a href="https://codex.wordpress.org/Function_Reference/the_excerpt" rel="nofollow ugc">excerpts</a> are a very poor choice for subtitles and the only available option outside of <a href="https://codex.wordpress.org/Custom_Fields" rel="nofollow ugc">custom fields</a>, but custom fields aren’t entirely self-explanatory or user-friendly. This simple, straightforward plugin aims to solve this issue.</p>
<p>Simply download <em>Subtitles</em>, activate it, and begin adding subtitles into your posts and pages today. For more advanced usage of the plugin, please see the <a href="https://wordpress.org/plugins/subtitles/faq/" rel="ugc">Frequently Asked Questions</a>.</p>
<p>If you like <em>Subtitles</em>, <a href="https://www.paypal.me/wecobble" rel="nofollow ugc">thank me with coffee</a>. If you find it buggy, <a href="https://github.com/wecobble/Subtitles/issues" rel="nofollow ugc">tell me on GitHub</a>. And if you have a cool example of how you’re using <em>Subtitles</em> on your website, let me know on <a href="https://twitter.com/philip_arthur" rel="nofollow ugc">Twitter</a>.</p>


Subtitles

Thanks. Hopefully it will get Gutenberg support too when the time comes.

Clean code, no ads or nags, works perfect

Add subtitles into your WordPress posts, pages, custom post types, and themes. No coding required. Simply activate Subtitles and you're ready.

Jonathan Desrosiers

Linchpin

Aaron Ware

<p>Simple subtitles adds a field on posts, pages, or custom post types for adding a subtitle. Post types can be enabled/disabled in the writing settings section.</p>
<p>There are several functions in the plugin that allow you to easily get subtitles for different contexts. These functions mirror the functions in core for titles.</p>
<h4>If you want to display the subtitle in your theme on your own, use the following filter:</h4>
<pre><code><?php
    function mytheme_disable_subtitle_display( $show ) {
        return false;
    }
    add_filter( 'simple_subtitle_auto', 'mytheme_disable_subtitle_display' );
?>
</code></pre>
<h4>By default, only  tags are allowed in subtitles (with only class and style attributes). There is a filter this.</h4>
<pre><code><?php
    function mytheme_simple_subtitle_allowed_html( $allowed ) {
        $allowed['strong'] = array();
        $allowed['div'] = array(
            'class' => true,
        );

        return $allowed;
    }
    add_filter( 'simple_subtitle_allowed_html', 'mytheme_simple_subtitle_allowed_html' );

?>
</code></pre>
<p>For more info on this, read into <a href="https://codex.wordpress.org/Function_Reference/wp_kses" title="the wp_kses functions" rel="nofollow ugc">the wp_kses functions</a>.</p>
<h4>Get the subtitle.</h4>
<pre><code><?php $subtitle = get_the_simple_subtitle( $post_id ); ?>
</code></pre>
<h4>Display the current post’s subtitle. Should be used within the loop.</h4>
<pre><code><?php $subtitle = the_simple_subtitle( $before = '', $after = '', $echo = true ); ?>
</code></pre>
<h4>Get the subtitle for use in an HTML attribute.</h4>
<pre><code><?php
    $args = array(
        'before' => '',
        'after' =>  '',
        'echo' => true
    );
    $subtitle = the_simple_subtitle_attribute( $args );
?><h3>Roadmap</h3>
</code></pre>
<p>* Add a column in the admin showing subtitles.<br />
* Add a setting for selecting the subtitle HTML tag.</p>


Simple Subtitles

Define a subtitle on any post, page, or custom post type.

Subtitles vs Simple Subtitles