CodeIgniter, руководство пользователя к версии 1.6.1


Класс Calendar

Класс Calendar позволяет динамически создавать календари. Отображение вашего календаря может быть изменено с помощью использования шаблонов календаря, которые предоставляют полный контроль над каждым аспектом его дизайна. Также вы можете поместить данные в ячейки календаря.

Инициализация Класса

Как и многие другие классы в CodeIgniter, класс Calendar инициализируется в вашем контроллере с использованием функции $this->load->library:

$this->load->library('calendar');

Однажды загруженный, объект Calendar будет доступен, с использованием: $this->calendar

Отображение календаря

Простой пример, показывающий, как вы можете отобразить календарь:

$this->load->library('calendar');

echo $this->calendar->generate();

Вышеприведенный код сгенерирует календарь для текущего месяца/года в соответствии с временем на вашем сервере. Чтобы отобразить календарь с определенным месяцем и годом, вы должны сообщить эту информацию в функцию, генерирующую календарь:

$this->load->library('calendar');

echo $this->calendar->generate(2006, 6);

Вышеприведенный код сгенерирует календарь для июня 2006 года. Первый параметр соответствует году, второй - месяцу.

Помещение данных в ячейки вашего календаря

Добавление данных в ячейки вашего календаря включает создание ассоциативного массива, в котором ключи соответствуют дням, в которые вы хотите добавить данные, а значения массива содержат эти данные. Массиву соответствует третий параметр функции, генерирующей календарь. Рассмотрим этот пример:

$this->load->library('calendar');

$data = array(
               3  => 'http://your-site.com/news/article/2006/03/',
               7  => 'http://your-site.com/news/article/2006/07/',
               13 => 'http://your-site.com/news/article/2006/13/',
               26 => 'http://your-site.com/news/article/2006/26/'
             );

echo $this->calendar->generate(2006, 6, $data);

Используя вышеприведенный пример, дни 3, 7, 13, и 26 наделяются ссылками, указывающими на предусмотренные вами страницы.

Примечание: По умолчанию предполагается, что ваш массив содержит ссылки. В секции, рассказывающей о шаблонах календаря, вы увидете как вы можете изменить отображение данных в ячейках календаря.

Установка предпочтений отображения

Вы можете установить семь предпочтений для управления отображением календаря. Предпочтения устанавливаются отправкой массива предпочтений вторым параметром функции загрузки. Пример:

$prefs = array (
               'start_day'    => 'saturday',
               'month_type'   => 'long',
               'day_type'     => 'short'
             );

$this->load->library('calendar', $prefs);

echo $this->calendar->generate();

Вышеприведенный код отображает календарь, начинающийся с субботы, использующий "длинный" заголовок месяца и "короткие" имена дней недели. Больше информации, касательно преподчтений отображения, приведено ниже.

Параметр Значение по умолчанию Параметры Описание
templateНетНетСтрока, содержащая шаблон вашего календаря. О шаблонах смотрите секцию "Создание шаблонов календаря".
local_timetime()НетСоответствующий текущему времени unix timestamp.
start_daysundayЛюбой день недели (sunday, monday, tuesday и т.д.)Устанавливает, с какого дня недели начинать отображение календаря.
month_typelonglong, shortОпределяет отображение имени месяца в заголовке. long = January, short = Jan.
day_typeabrlong, short, abrОпределяет отображение дней недели в заголовках колонок. long = Sunday, short = Sun, abr = Su.
show_next_prevFALSETRUE/FALSE (boolean)Определяет отображение ссылок на следующий/предыдущий месяц. Смотрите информацию об этой возможности ниже.
next_prev_urlНетA URLУстанавливает базовый путь, используемый ссылками следующий/предыдущий в календаре.

Отображение ссылок на следующий/предыдущий месяц

Чтобы разрешить вашему календарю менять месяц и год через ссылки следующий/предыдущий, требуется установить код вашего календаря, подобный этому:

$prefs = array (
               'show_next_prev'  => TRUE,
               'next_prev_url'   => 'http://www.your-site.com/index.php/calendar/show/'
             );

$this->load->library('calendar', $prefs);

echo $this->calendar->generate($this->uri->segment(3), $this->uri->segment(4));

Несколько важных замечаний о вышеприведенном коде:

Создание шаблонов календаря

Создав шаблон календаря, вы получаете полный контроль над отображением вашего календаря. Каждый компонент вашего календаря будет размещен внутри пары псевдо-переменных как показано здесь:

$prefs['template'] = '

   {table_open}<table border="0" cellpadding="0" cellspacing="0">{/table_open}

   {heading_row_start}<tr>{/heading_row_start}

   {heading_previous_cell}<th><a href="{previous_url}">&lt;&lt;</a></th>{/heading_previous_cell}
   {heading_title_cell}<th colspan="{colspan}">{heading}</th>{/heading_title_cell}
   {heading_next_cell}<th><a href="{next_url}">&gt;&gt;</a></th>{/heading_next_cell}

   {heading_row_end}</tr>{/heading_row_end}

   {week_row_start}<tr>{/week_row_start}
   {week_day_cell}<td>{week_day}</td>{/week_day_cell}
   {week_row_end}</tr>{/week_row_end}

   {cal_row_start}<tr>{/cal_row_start}
   {cal_cell_start}<td>{/cal_cell_start}

   {cal_cell_content}<a href="{content}">{day}</a>{/cal_cell_content}
   {cal_cell_content_today}<div class="highlight"><a href="{content}">{day}</a></div>{/cal_cell_content_today}

   {cal_cell_no_content}{day}{/cal_cell_no_content}
   {cal_cell_no_content_today}<div class="highlight">{day}</div>{/cal_cell_no_content_today}

   {cal_cell_blank}&nbsp;{/cal_cell_blank}

   {cal_cell_end}</td>{/cal_cell_end}
   {cal_row_end}</tr>{/cal_row_end}

   {table_close}</table>{/table_close}
';

$this->load->library('calendar', $prefs);

echo $this->calendar->generate();