Функция get_calendar() в WordPress: синтаксис и примеры использования

## Функция GET_CALENDAR() │ WP 1.0.0

Функция get_calendar() отображает календарь, где дни, в которые были написаны посты, отображаются как ссылки. 

Если календарь уже был сохранён (кэширован), он будет взят из кэша. Если за месяц не было постов, календарь не будет показан.

### Хуки, используемые в функции

- get_calendar

### Возвращаемое значение

- null | String. Функция ничего не возвращает, если аргумент $display равен true, и возвращает HTML-код календаря, если $display равен false.

### Использование

```php
get_calendar( $initial, $display );

• $initial (true|false) — следует ли использовать первоначальные названия календаря. По умолчанию: true.
• $display (true|false) — следует ли показывать вывод календаря. По умолчанию: true.

Примеры

1. Базовый пример

   Давайте отобразим календарь, где каждый день, в который был написан хотя бы один пост, будет ссылкой.

   get_calendar();

2. Отображение сокращений для дней недели

   Чтобы отобразить сокращения названий дней недели в текущей локализации (Суббота: Сб):

   get_calendar(false);

Примечания

• Объект базы данных WordPress: $wpdb
• Глобальные переменные:
  • $m
  • $monthnum
  • $year
  • $wp_locale — объект локализации даты и времени WordPress.
  • $posts — массив постов.

Изменения

• С версии 1.0.0 — функция была введена.

Код функции GET_CALENDAR()

Ниже представлен код функции get_calendar():

function get_calendar( $initial = true, $display = true ) {
global $wpdb, $m, $monthnum, $year, $wp_locale, $posts;

$key   = md5( $m . $monthnum . $year );
$cache = wp_cache_get( 'get_calendar', 'calendar' );

if ( $cache && is_array( $cache ) && isset( $cache[ $key ] ) ) {
    $output = apply_filters( 'get_calendar', $cache[ $key ] );

    if ( $display ) {
        echo $output;
        return;
    }

    return $output;
}

if ( ! is_array( $cache ) ) {
    $cache = array();
}

// Быстрое проверка. Если у нас нет постов, прерываем выполнение!
if ( ! $posts ) {
    $gotsome = $wpdb->get_var( "SELECT 1 as test FROM $wpdb->posts WHERE post_type = 'post' AND post_status = 'publish' LIMIT 1" );
    if ( ! $gotsome ) {
        $cache[ $key ] = '';
        wp_cache_set( 'get_calendar', $cache, 'calendar' );
        return;
    }
}

// Обработка номера недели
if ( isset( $_GET['w'] ) ) {
    $w = (int) $_GET['w'];
}

// Получаем настройку первого дня недели
$week_begins = (int) get_option( 'start_of_week' );

// Определяем текущий месяц и год
if ( ! empty( $monthnum ) && ! empty( $year ) ) {
    $thismonth = zeroise( (int) $monthnum, 2 );
    $thisyear  = (int) $year;
} elseif ( ! empty( $w ) ) {
    $thisyear = (int) substr( $m, 0, 4 );
    $d         = ( ( $w - 1 ) * 7 ) + 6;
    $thismonth = $wpdb->get_var( "SELECT DATE_FORMAT((DATE_ADD('{$thisyear}0101', INTERVAL $d DAY) ), '%m')" );
} elseif ( ! empty( $m ) ) {
    $thisyear = (int) substr( $m, 0, 4 );
    if ( strlen( $m ) < 6 ) {
        $thismonth = '01';
    } else {
        $thismonth = zeroise( (int) substr( $m, 4, 2 ), 2 );
    }
} else {
    $thisyear  = current_time( 'Y' );
    $thismonth = current_time( 'm' );
}

$unixmonth = mktime( 0, 0, 0, $thismonth, 1, $thisyear );
$last_day  = gmdate( 't', $unixmonth );

// Получаем следующий и предыдущий месяц с хотя бы одним постом.
$previous = $wpdb->get_row(
    "SELECT MONTH(post_date) AS month, YEAR(post_date) AS year
    FROM $wpdb->posts
    WHERE post_date < '$thisyear-$thismonth-01'
    AND post_type = 'post' AND post_status = 'publish'
    ORDER BY post_date DESC
    LIMIT 1"
);

$next = $wpdb->get_row(
    "SELECT MONTH(post_date) AS month, YEAR(post_date) AS year
    FROM $wpdb->posts
    WHERE post_date > '$thisyear-$thismonth-{$last_day} 23:59:59'
    AND post_type = 'post' AND post_status = 'publish'
    ORDER BY post_date ASC
    LIMIT 1"
);

$calendar_caption = _x( '%1$s %2$s', 'caption календаря' );
$calendar_output  = '';

$myweek = array();

for ( $wdcount = 0; $wdcount <= 6; $wdcount++ ) {
    $myweek[] = $wp_locale->get_weekday( ( $wdcount + $week_begins ) % 7 );
}

foreach ( $myweek as $wd ) {
    $day_name         = $initial ? $wp_locale->get_weekday_initial( $wd ) : $wp_locale->get_weekday_abbrev( $wd );
    $wd               = esc_attr( $wd );
    $calendar_output .= "ntt";
}

$calendar_output .= '
';

$daywithpost = array();

// Получение дней с постами
$dayswithposts = $wpdb->get_results(
    "SELECT DISTINCT DAYOFMONTH(post_date)
    FROM $wpdb->posts WHERE post_date >= '{$thisyear}-{$thismonth}-01 00:00:00'
    AND post_type = 'post' AND post_status = 'publish'
    AND post_date <= '{$thisyear}-{$thismonth}-{$last_day} 23:59:59'",
    ARRAY_N
);

if ( $dayswithposts ) {
    foreach ( (array) $dayswithposts as $daywith ) {
        $daywithpost[] = (int) $daywith[0];
    }
}

// Определяем начало ряда
$pad = calendar_week_mod( gmdate( 'w', $unixmonth ) - $week_begins );
if ( 0 != $pad ) {
    $calendar_output .= "ntt" . '';
}

$newrow      = false;
$daysinmonth = (int) gmdate( 't', $unixmonth );

for ( $day = 1; $day <= $daysinmonth; ++$day ) {
    if ( isset( $newrow ) && $newrow ) {
        $calendar_output .= "ntntntt";
    }
    $newrow = false;

    if ( current_time( 'j' ) == $day &&
        current_time( 'm' ) == $thismonth &&
        current_time( 'Y' ) == $thisyear ) {
        $calendar_output .= '';

    if ( 6 == calendar_week_mod( gmdate( 'w', mktime( 0, 0, 0, $thismonth, $day, $thisyear ) ) - $week_begins ) ) {
        $newrow = true;
    }
}

$pad = 7 - calendar_week_mod( gmdate( 'w', mktime( 0, 0, 0, $thismonth, $day, $thisyear ) ) - $week_begins );
if ( 0 != $pad && 7 != $pad ) {
    $calendar_output .= "ntt" . '';
}

$calendar_output .= "ntnt";

$calendar_output .= "nt

' . sprintf(
    $calendar_caption,
    $wp_locale->get_month( $thismonth ),
    gmdate( 'Y', $unixmonth )
) . '

$day_name


 
';
    } else {
        $calendar_output .= '
';
    }

    if ( in_array( $day, $daywithpost, true ) ) {
        $date_format = gmdate( _x( 'F j, Y', 'формат даты архивов' ), strtotime( "{$thisyear}-{$thismonth}-{$day}" ) );
        $label = sprintf( __( 'Публикации, выпущенные %s' ), $date_format );
        $calendar_output .= sprintf(
            '%s',
            get_day_link( $thisyear, $thismonth, $day ),
            esc_attr( $label ),
            $day
        );
    } else {
        $calendar_output .= $day;
    }

    $calendar_output .= '
 
";

$calendar_output .= '';

$cache[ $key ] = $calendar_output;
wp_cache_set( 'get_calendar', $cache, 'calendar' );

if ( $display ) {
    echo apply_filters( 'get_calendar', $calendar_output );
    return;
}
return apply_filters( 'get_calendar', $calendar_output );

}

Связанные функции

• calendar_week_mod()
• current_time()
• get_date_from_gmt()
• get_gmt_from_date()
• get_weekstartend()
• human_time_diff()
• mysql2date()
• wp_date()
• wp_maybe_decline_date()
• wp_timezone()
• wp_timezone_string()