PHPackages                             masterro/laravel-fullcalendar - 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. [Utility & Helpers](/categories/utility)
4. /
5. masterro/laravel-fullcalendar

ActiveLibrary[Utility & Helpers](/categories/utility)

masterro/laravel-fullcalendar
=============================

Laravel helper for FullCalendar.io

v1.6.0(4y ago)121MITPHPPHP >=5.4.0

Since Feb 11Pushed 4y ago1 watchersCompare

[ Source](https://github.com/MasterRO94/laravel-fullcalendar)[ Packagist](https://packagist.org/packages/masterro/laravel-fullcalendar)[ RSS](/packages/masterro-laravel-fullcalendar/feed)WikiDiscussions master Synced today

READMEChangelog (3)Dependencies (1)Versions (19)Used By (0)

Laravel 5 Full Calendar Helper
==============================

[](#laravel-5-full-calendar-helper)

[![Latest Stable Version](https://camo.githubusercontent.com/f33c2f0dbac3dff343beec72c89ef0c4f1e6b9c2ef4d7e530e39df01a4b590ee/68747470733a2f2f706f7365722e707567782e6f72672f6d6164646861747465722f6c61726176656c2d66756c6c63616c656e6461722f762f737461626c65)](https://packagist.org/packages/maddhatter/laravel-fullcalendar) [![Total Downloads](https://camo.githubusercontent.com/f79ab1d7f6b9202270b745dc40ffc49cb581d139850e91889269aea81f38ed48/68747470733a2f2f706f7365722e707567782e6f72672f6d6164646861747465722f6c61726176656c2d66756c6c63616c656e6461722f646f776e6c6f616473)](https://packagist.org/packages/maddhatter/laravel-fullcalendar) [![Latest Unstable Version](https://camo.githubusercontent.com/8455a9e873278b2bc1c8a6dcc487aed69de2f2ce1af0e16724b6ba6969debb63/68747470733a2f2f706f7365722e707567782e6f72672f6d6164646861747465722f6c61726176656c2d66756c6c63616c656e6461722f762f756e737461626c65)](https://packagist.org/packages/maddhatter/laravel-fullcalendar) [![License](https://camo.githubusercontent.com/1fdbb6eb623b00acedd244730cd5ac06ac262ee0cf265ad9eddd3473a49f06b5/68747470733a2f2f706f7365722e707567782e6f72672f6d6164646861747465722f6c61726176656c2d66756c6c63616c656e6461722f6c6963656e7365)](https://packagist.org/packages/maddhatter/laravel-fullcalendar)

***For Laravel 4.2: use the [laravel-4 branch](https://github.com/maddhatter/laravel-fullcalendar/tree/laravel-4)***

This is a simple helper package to make generating  in Laravel apps easier.

Installing
----------

[](#installing)

Require the package with composer using the following command:

```
composer require maddhatter/laravel-fullcalendar

```

Or add the following to your composer.json's require section and `composer update`

```
"require": {
	"maddhatter/laravel-fullcalendar": "~1.0"
}
```

### Laravel 5.4 (and earlier)

[](#laravel-54-and-earlier)

Register the service provider in your `app.php` config file:

```
MaddHatter\LaravelFullcalendar\ServiceProvider::class,
```

And optionally create an alias:

```
'Calendar' => MaddHatter\LaravelFullcalendar\Facades\Calendar::class,
```

### Laravel 5.5+

[](#laravel-55)

The provider and `Calendar` alias will be registered automatically.

You will also need to include [fullcalendar.io](http://fullcalendar.io/)'s files in your HTML.

Usage
-----

[](#usage)

### Creating Events

[](#creating-events)

#### Using `event()`:

[](#using-event)

The simpliest way to create an event is to pass the event information to `Calendar::event()`:

```
$event = \Calendar::event(
    "Valentine's Day", //event title
    true, //full day event?
    '2015-02-14', //start time, must be a DateTime object or valid DateTime format (http://bit.ly/1z7QWbg)
    '2015-02-14', //end time, must be a DateTime object or valid DateTime format (http://bit.ly/1z7QWbg),
	1, //optional event ID
	[
		'url' => 'http://full-calendar.io'
	]
);
```

#### Implementing `Event` Interface

[](#implementing-event-interface)

Alternatively, you can use an existing class and have it implement `MaddHatter\LaravelFullcalendar\Event`. An example of an Eloquent model that implements the `Event` interface:

```
class EventModel extends Eloquent implements \MaddHatter\LaravelFullcalendar\Event
{

    protected $dates = ['start', 'end'];

    /**
     * Get the event's id number
     *
     * @return int
     */
    public function getId() {
		return $this->id;
	}

    /**
     * Get the event's title
     *
     * @return string
     */
    public function getTitle()
    {
        return $this->title;
    }

    /**
     * Is it an all day event?
     *
     * @return bool
     */
    public function isAllDay()
    {
        return (bool)$this->all_day;
    }

    /**
     * Get the start time
     *
     * @return DateTime
     */
    public function getStart()
    {
        return $this->start;
    }

    /**
     * Get the end time
     *
     * @return DateTime
     */
    public function getEnd()
    {
        return $this->end;
    }
}
```

#### `IdentifiableEvent` Interface

[](#identifiableevent-interface)

If you wish for your existing class to have event IDs, implement `\MaddHatter\LaravelFullcalendar\IdentifiableEvent` instead. This interface extends `\MaddHatter\LaravelFullcalendar\Event` to add a `getId()` method:

```
class EventModel extends Eloquent implements \MaddHatter\LaravelFullcalendar\IdentifiableEvent
{

	// Implement all Event methods ...

    /**
     * Get the event's ID
     *
     * @return int|string|null
     */
    public function getId();

}
```

### Additional Event Parameters

[](#additional-event-parameters)

If you want to add [additional parameters](http://fullcalendar.io/docs/event_data/Event_Object) to your events, there are two options:

#### Using `Calendar::event()`

[](#using-calendarevent)

Pass an array of `'parameter' => 'value'` pairs as the 6th parameter to `Calendar::event()`:

```
$event = \Calendar::event(
    "Valentine's Day", //event title
    true, //full day event?
    '2015-02-14', //start time, must be a DateTime object or valid DateTime format (http://bit.ly/1z7QWbg)
    '2015-02-14', //end time, must be a DateTime object or valid DateTime format (http://bit.ly/1z7QWbg),
	1, //optional event ID
	[
		'url' => 'http://full-calendar.io',
		//any other full-calendar supported parameters
	]
);
```

#### Add an `getEventOptions` method to your event class

[](#add-an-geteventoptions-method-to-your-event-class)

```