Straightforward calendars, with events, for any templating system.
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
tests [Feature] Add addEvents method (#3) Jun 6, 2017
phpunit.xml.dist Feature: Timeframe intersections (#2) Apr 24, 2017


The Calendar component is a simple, but powerful package to help you in the rendering of, well, Calendars!

Build Status Latest Stable Version Total Downloads License


  • No dependancies
  • PHP 5.3+
  • Straightforward interface
  • Support for multiple "resolutions" (week view, month view etc)
  • Easily extended
  • Templating system agnostic

Getting Started

Installation is via composer, in the usual manner:

    "require": {
        "solution10/calendar": "^1.0"

Creating a basic calendar is as such:

// Creates a calendar, using today as a starting point.
$calendar = new Solution10\Calendar\Calendar(new DateTime('now'));

// We now need to give the calendar a "resolution". This tells the
// Calendar whether we're showing a month view, or a Week, or maybe
// even a whole year. Let's start with a Month:

$calendar->setResolution(new MonthResolution());

// That's it! Let's grab the view data and render:
$viewData = $calendar->viewData();
$months = $viewData['contents'];

<?php foreach ($months as $month): ?>
    <caption><?php echo $month->title('F Y'); ?></caption>
            <?php foreach ($month->weeks()[0]->days() as $day): ?>
                <th><?php echo $day->date()->format('D'); ?></th>
            <?php endforeach; ?>
        <?php foreach ($month->weeks() as $week): ?>
                <?php foreach ($week->days() as $day): ?>
                            if ($day->isOverflow()) {
                                if ($calendar->resolution()->showOverflowDays()) {
                                    echo '<span style="color: #ccc">'.$day->date()->format('d').'</span>';
                                } else {
                                    echo '&nbsp;';
                            } else {
                                echo $day->date()->format('d');
                <?php endforeach; ?>
        <?php endforeach; ?>
<?php endforeach; ?>

Solution10\Calendar does not provide you with templates as we have no idea what templating engine (if any) you're using. Instead, we give you a powerful and simple API so you can do the rendering yourself.

Further Reading


For more information on creating Calendars, see the Calendars Section.

If you want to know more about Resolutions, check out the Resolutions Section.

Want to see how you can add Events to your calendars? You'll be wanting the Events Section.

PHP Requirements

  • PHP >= 5.3


Alex Gisby: GitHub, Twitter




Contributors Notes