BACK TO DIRECTORY

Simple Subtitles

by Jonathan Desrosiers

5.0
(1 ratings)

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.

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.

If you want to display the subtitle in your theme on your own, use the following filter:

<?php
    function mytheme_disable_subtitle_display( $show ) {
        return false;
    }
    add_filter( 'simple_subtitle_auto', 'mytheme_disable_subtitle_display' );
?>

By default, only tags are allowed in subtitles (with only class and style attributes). There is a filter this.

<?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' );

?>

For more info on this, read into the wp_kses functions.

Get the subtitle.

<?php $subtitle = get_the_simple_subtitle( $post_id ); ?>

Display the current post’s subtitle. Should be used within the loop.

<?php $subtitle = the_simple_subtitle( $before = '', $after = '', $echo = true ); ?>

Get the subtitle for use in an HTML attribute.

<?php
    $args = array(
        'before' => '',
        'after' =>  '',
        'echo' => true
    );
    $subtitle = the_simple_subtitle_attribute( $args );
?><h3>Roadmap</h3>

* Add a column in the admin showing subtitles.
* Add a setting for selecting the subtitle HTML tag.

Screenshots

Simple Subtitles on the edit screen.

Simple Subtitles on the edit screen.

Default Simple Subtitle display on the front end.

Default Simple Subtitle display on the front end.

Plugin Details

Active Installs
30
Total Downloads
8,493
Version
2.1.1
Requires WP
3.5
Requires PHP
Tested Up To
4.5.33
Added
2016-04-11
Last Updated
2016-05-10 9:38pm GMT

Ratings

5
1
4
0
3
0
2
0
1
0