PHPackages                             plummer/calendarful - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. plummer/calendarful

ActiveLibrary

plummer/calendarful
===================

Calendar generator that allows for recurring events.

v0.2.1(10y ago)1142.1k↓100%9[1 issues](https://github.com/benplummer/calendarful/issues)MITPHPPHP >=5.3.0

Since Dec 29Pushed 3y ago6 watchersCompare

[ Source](https://github.com/benplummer/calendarful)[ Packagist](https://packagist.org/packages/plummer/calendarful)[ Docs](http://benplummer.co.uk)[ RSS](/packages/plummer-calendarful/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (2)Versions (13)Used By (0)

Calendarful
-----------

[](#calendarful)

[![Author](https://camo.githubusercontent.com/788c788e73856b8e807ea11364b85ce6203d98ee7f07cdaebe6dc19c496b08ff/687474703a2f2f696d672e736869656c64732e696f2f62616467652f617574686f722d4042656e5f506c756d6d65722d626c75652e7376673f7374796c653d666c61742d737175617265)](https://twitter.com/ben_plummer)[![Build Status](https://camo.githubusercontent.com/983a60cbba4ec6f402862270960b1249debe760d4537427651be4b7ac340148b/68747470733a2f2f7472617669732d63692e6f72672f62656e706c756d6d65722f63616c656e64617266756c2e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/benplummer/calendarful)[![Packagist](https://camo.githubusercontent.com/1f63beda3a53930be84a15655b57639cb10fceae9efb8a82ba03f6135406975f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f706c756d6d65722f63616c656e64617266756c2e7376673f7374796c653d666c6174)](https://packagist.org/packages/plummer/calendarful)[![Packagist](https://camo.githubusercontent.com/3a2df596f4408fcb9d9ff2b36800294f087ffe3890e42d98d1175ea35599512d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f706c756d6d65722f63616c656e64617266756c2e7376673f7374796c653d666c6174)](https://github.com/benplummer/calendarful/blob/master/LICENSE)

Calendarful is a simple and easily extendable PHP solution that allows the generation of occurrences of recurrent events, thus eliminating the need to store hundreds or maybe thousands of occurrences in a database or other methods of storage.

This package ships with default implementations of interfaces for use out of the box although it is very simple to provide your own implementations if needs be.

It is compliant with [PSR-2](http://www.php-fig.org/psr/psr-2/).

Installation
------------

[](#installation)

This package can be installed via [Composer](https://getcomposer.org/):

```
$ composer require plummer/calendarful
```

It requires **PHP >= 5.3.0**.

Required Set Up
---------------

[](#required-set-up)

Before using this package, a few steps need to be taken.

#### Event Models

[](#event-models)

This package requires that you have `Event` and `RecurrentEvent` models.For the models to be compatible with this package they **must** implement the relevant package interfaces.

The `Event` model represents standard non-recurrent events and follows the `EventInterface`:

```