simple-calendar Follow @yiiframework

Introduction ¶

I was looking for a simple calendar for a project I'm working on. All I needed was something where you could navigate through the months and click on a day to select it. Unfortunately, I couldn't find a Yii extension for that, so I ended up developing one myself: Simple Calendar

Simple Calendar will render a calendar without using any client side code. Everything works with links and query string parameters.

Installation ¶

Just extract the contents of the package to your extensions directory. Usually protect/extensions

Usage ¶

To use it, add the following to your view:

<?php $this->widget('ext.simple-calendar.SimpleCalendarWidget'); ?>

This will render a calendar where each of the days displayed is a link in the following format:

http://example.com/current_url?month=current_month&year=current_year&day=select_day

The previous and next month links are created exactly the same way:

http://example.com/current_url?month=current_month&year=current_year&day=last_day_of_the_month

Using the query string parameters, you can get the selected date and use it wherever you need.

By default, Simple Calendar will render the calendar based on the current date. If you need it to start displaying any other date, just pass it in the widget initialization:

<?php $this->widget('ext.simple-calendar.SimpleCalendarWidget', array('year' => 2012, 'month' => 12, 'day' => 21); ?>

Recent Updates ¶

Version 1.1
- Fixes error when current day was 30 or 31 and February was acessed
- Updated the html for the calendar to make it easier to be themed. Now you have classes for the month/year row and the for the next and previous links

Links ¶

• Project page
• Try out a demo