single_month_title

The timeline below displays how wordpress function single_month_title has changed across different WordPress versions. If a version is not listed, refer to the next available version below.

WordPress Version: 6.1

/**
 * Displays or retrieves page title for post archive based on date.
 *
 * Useful for when the template only needs to display the month and year,
 * if either are available. The prefix does not automatically place a space
 * between the prefix, so if there should be a space, the parameter value
 * will need to have it at the end.
 *
 * @since 0.71
 *
 * @global WP_Locale $wp_locale WordPress date and time locale object.
 *
 * @param string $prefix  Optional. What to display before the title.
 * @param bool   $display Optional. Whether to display or retrieve title. Default true.
 * @return string|false|void False if there's no valid title for the month. Title when retrieving.
 */
function single_month_title($prefix = '', $display = true)
{
    global $wp_locale;
    $m = get_query_var('m');
    $year = get_query_var('year');
    $monthnum = get_query_var('monthnum');
    if (!empty($monthnum) && !empty($year)) {
        $my_year = $year;
        $my_month = $wp_locale->get_month($monthnum);
    } elseif (!empty($m)) {
        $my_year = substr($m, 0, 4);
        $my_month = $wp_locale->get_month(substr($m, 4, 2));
    }
    if (empty($my_month)) {
        return false;
    }
    $result = $prefix . $my_month . $prefix . $my_year;
    if (!$display) {
        return $result;
    }
    echo $result;
}

WordPress Version: 5.5

/**
 * Display or retrieve page title for post archive based on date.
 *
 * Useful for when the template only needs to display the month and year,
 * if either are available. The prefix does not automatically place a space
 * between the prefix, so if there should be a space, the parameter value
 * will need to have it at the end.
 *
 * @since 0.71
 *
 * @global WP_Locale $wp_locale WordPress date and time locale object.
 *
 * @param string $prefix  Optional. What to display before the title.
 * @param bool   $display Optional. Whether to display or retrieve title. Default true.
 * @return string|void Title when retrieving.
 */
function single_month_title($prefix = '', $display = true)
{
    global $wp_locale;
    $m = get_query_var('m');
    $year = get_query_var('year');
    $monthnum = get_query_var('monthnum');
    if (!empty($monthnum) && !empty($year)) {
        $my_year = $year;
        $my_month = $wp_locale->get_month($monthnum);
    } elseif (!empty($m)) {
        $my_year = substr($m, 0, 4);
        $my_month = $wp_locale->get_month(substr($m, 4, 2));
    }
    if (empty($my_month)) {
        return false;
    }
    $result = $prefix . $my_month . $prefix . $my_year;
    if (!$display) {
        return $result;
    }
    echo $result;
}

WordPress Version: 5.3

/**
 * Display or retrieve page title for post archive based on date.
 *
 * Useful for when the template only needs to display the month and year,
 * if either are available. The prefix does not automatically place a space
 * between the prefix, so if there should be a space, the parameter value
 * will need to have it at the end.
 *
 * @since 0.71
 *
 * @global WP_Locale $wp_locale WordPress date and time locale object.
 *
 * @param string $prefix  Optional. What to display before the title.
 * @param bool   $display Optional, default is true. Whether to display or retrieve title.
 * @return string|void Title when retrieving.
 */
function single_month_title($prefix = '', $display = true)
{
    global $wp_locale;
    $m = get_query_var('m');
    $year = get_query_var('year');
    $monthnum = get_query_var('monthnum');
    if (!empty($monthnum) && !empty($year)) {
        $my_year = $year;
        $my_month = $wp_locale->get_month($monthnum);
    } elseif (!empty($m)) {
        $my_year = substr($m, 0, 4);
        $my_month = $wp_locale->get_month(substr($m, 4, 2));
    }
    if (empty($my_month)) {
        return false;
    }
    $result = $prefix . $my_month . $prefix . $my_year;
    if (!$display) {
        return $result;
    }
    echo $result;
}

WordPress Version: 4.4

/**
 * Display or retrieve page title for post archive based on date.
 *
 * Useful for when the template only needs to display the month and year,
 * if either are available. The prefix does not automatically place a space
 * between the prefix, so if there should be a space, the parameter value
 * will need to have it at the end.
 *
 * @since 0.71
 *
 * @global WP_Locale $wp_locale
 *
 * @param string $prefix  Optional. What to display before the title.
 * @param bool   $display Optional, default is true. Whether to display or retrieve title.
 * @return string|void Title when retrieving.
 */
function single_month_title($prefix = '', $display = true)
{
    global $wp_locale;
    $m = get_query_var('m');
    $year = get_query_var('year');
    $monthnum = get_query_var('monthnum');
    if (!empty($monthnum) && !empty($year)) {
        $my_year = $year;
        $my_month = $wp_locale->get_month($monthnum);
    } elseif (!empty($m)) {
        $my_year = substr($m, 0, 4);
        $my_month = $wp_locale->get_month(substr($m, 4, 2));
    }
    if (empty($my_month)) {
        return false;
    }
    $result = $prefix . $my_month . $prefix . $my_year;
    if (!$display) {
        return $result;
    }
    echo $result;
}

WordPress Version: 4.3

/**
 * Display or retrieve page title for post archive based on date.
 *
 * Useful for when the template only needs to display the month and year, if
 * either are available. Optimized for just this purpose, so if it is all that
 * is needed, should be better than {@link wp_title()}.
 *
 * It does not support placing the separator after the title, but by leaving the
 * prefix parameter empty, you can set the title separator manually. The prefix
 * does not automatically place a space between the prefix, so if there should
 * be a space, the parameter value will need to have it at the end.
 *
 * @since 0.71
 *
 * @global WP_Locale $wp_locale
 *
 * @param string $prefix  Optional. What to display before the title.
 * @param bool   $display Optional, default is true. Whether to display or retrieve title.
 * @return string|void Title when retrieving.
 */
function single_month_title($prefix = '', $display = true)
{
    global $wp_locale;
    $m = get_query_var('m');
    $year = get_query_var('year');
    $monthnum = get_query_var('monthnum');
    if (!empty($monthnum) && !empty($year)) {
        $my_year = $year;
        $my_month = $wp_locale->get_month($monthnum);
    } elseif (!empty($m)) {
        $my_year = substr($m, 0, 4);
        $my_month = $wp_locale->get_month(substr($m, 4, 2));
    }
    if (empty($my_month)) {
        return false;
    }
    $result = $prefix . $my_month . $prefix . $my_year;
    if (!$display) {
        return $result;
    }
    echo $result;
}

WordPress Version: 3.7

/**
 * Display or retrieve page title for post archive based on date.
 *
 * Useful for when the template only needs to display the month and year, if
 * either are available. Optimized for just this purpose, so if it is all that
 * is needed, should be better than {@link wp_title()}.
 *
 * It does not support placing the separator after the title, but by leaving the
 * prefix parameter empty, you can set the title separator manually. The prefix
 * does not automatically place a space between the prefix, so if there should
 * be a space, the parameter value will need to have it at the end.
 *
 * @since 0.71
 *
 * @param string $prefix Optional. What to display before the title.
 * @param bool $display Optional, default is true. Whether to display or retrieve title.
 * @return string|null Title when retrieving, null when displaying or failure.
 */
function single_month_title($prefix = '', $display = true)
{
    global $wp_locale;
    $m = get_query_var('m');
    $year = get_query_var('year');
    $monthnum = get_query_var('monthnum');
    if (!empty($monthnum) && !empty($year)) {
        $my_year = $year;
        $my_month = $wp_locale->get_month($monthnum);
    } elseif (!empty($m)) {
        $my_year = substr($m, 0, 4);
        $my_month = $wp_locale->get_month(substr($m, 4, 2));
    }
    if (empty($my_month)) {
        return false;
    }
    $result = $prefix . $my_month . $prefix . $my_year;
    if (!$display) {
        return $result;
    }
    echo $result;
}