Stars: 139
Forks: 45
Pull Requests: 8
Issues: 21
Watchers: 7
Last Updated: 2022-12-05 15:42:16
:calendar: Laravel 8 - FullCalender.io 5 Helper
License:
Languages: PHP, Blade
This is a simple helper package to make generating http://fullcalendar.io in Laravel apps easier.
Thanks to @maddhatter for the initial repo for laravel < 7
Require the package with composer using the following command:
composer require acaronlex/laravel-calendar
The provider and Calendar
alias will be registered automatically.
You will also need to include fullcalendar.io's files in your HTML.
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'
]
);
Event
InterfaceAlternatively, you can use an existing class and have it implement Acaronlex\LaravelCalendar\Event
. An example of an Eloquent model that implements the Event
interface:
class EventModel extends Eloquent implements \Acaronlex\LaravelCalendar\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
InterfaceIf you wish for your existing class to have event IDs, implement \Acaronlex\LaravelCalendar\IdentifiableEvent
instead. This interface extends \Acaronlex\LaravelCalendar\Event
to add a getId()
method:
class EventModel extends Eloquent implements \Acaronlex\LaravelCalendar\IdentifiableEvent
{
// Implement all Event methods ...
/**
* Get the event's ID
*
* @return int|string|null
*/
public function getId();
}
If you want to add additional parameters to your events, there are two options:
Calendar::event()
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
]
);
getEventOptions
method to your event class<?php
class CalendarEvent extends \Illuminate\Database\Eloquent\Model implements \Acaronlex\LaravelCalendar\Event
{
//...
/**
* Optional FullCalendar.io settings for this event
*
* @return array
*/
public function getEventOptions()
{
return [
'color' => $this->background_color,
//etc
];
}
//...
}
To create a calendar, in your route or controller, create your event(s), then pass them to Calendar::addEvent()
or Calendar::addEvents()
(to add an array of events). addEvent()
and addEvents()
can be used fluently (chained together). Their second parameter accepts an array of valid FullCalendar Event Object parameters.
$events = [];
$events[] = \Calendar::event(
'Event One', //event title
false, //full day event?
'2015-02-11T0800', //start time (you can also use Carbon instead of DateTime)
'2015-02-12T0800', //end time (you can also use Carbon instead of DateTime)
0 //optionally, you can specify an event ID
);
$events[] = \Calendar::event(
"Valentine's Day", //event title
true, //full day event?
new \DateTime('2015-02-14'), //start time (you can also use Carbon instead of DateTime)
new \DateTime('2015-02-14'), //end time (you can also use Carbon instead of DateTime)
'stringEventId' //optionally, you can specify an event ID
);
$calendar = new Calendar();
$calendar->addEvents($events);
$calendar->setOptions([
'locales' => 'allLocales',
'locale' => 'fr',
'firstDay' => 0,
'displayEventTime' => true,
'selectable' => true,
'initialView' => 'timeGridWeek',
'headerToolbar' => [
'left' => 'prev,next today myCustomButton',
'center' => 'title',
'right' => 'dayGridMonth,timeGridWeek,timeGridDay'
],
'customButtons' => [
'myCustomButton' => [
'text'=> 'custom!',
'click' => 'function() {
alert(\'clicked the custom button!\');
}'
]
]
]);
$calendar->setId('1');
$calendar->setCallbacks([
'select' => 'function(selectionInfo){}',
'eventClick' => 'function(event){}'
]);
return view('hello', compact('calendar'));
$events = [];
$events[] = \Calendar::event(
'Event One', //event title
false, //full day event?
'2015-02-11T0800', //start time (you can also use Carbon instead of DateTime)
'2015-02-12T0800', //end time (you can also use Carbon instead of DateTime)
0 //optionally, you can specify an event ID
);
$events[] = \Calendar::event(
"Valentine's Day", //event title
true, //full day event?
new \DateTime('2015-02-14'), //start time (you can also use Carbon instead of DateTime)
new \DateTime('2015-02-14'), //end time (you can also use Carbon instead of DateTime)
'stringEventId' //optionally, you can specify an event ID
);
$calendar = new Calendar();
$calendar->addEvents($events)
->setOptions([
'plugins' => [ 'window.interaction', 'window.momentPlugin', 'window.dayGridPlugin', 'window.timeGridPlugin', 'window.listPlugin' ],
'locales' => 'window.allLocales',
'locale' => 'fr',
'firstDay' => 0,
'displayEventTime' => true,
'selectable' => true,
'initialView' => 'timeGridWeek',
'headerToolbar' => [
'left' => 'prev,next today myCustomButton',
'center' => 'title',
'right' => 'dayGridMonth,timeGridWeek,timeGridDay'
],
'customButtons' => [
'myCustomButton' => [
'text'=> 'custom!',
'click' => 'function() {
alert(\'clicked the custom button!\');
}'
]
]
]);
$calendar->setId('1');
$calendar->setEs6();
$calendar->setCallbacks([
'select' => 'function(info) {
alert(\'selected \' + info.startStr + \' to \' + info.endStr);
}',
'eventClick' => 'function(info) {
alert(\'Event: \' + info.event.title);
alert(\'Coordinates: \' + info.jsEvent.pageX + \',\' + info.jsEvent.pageY);
alert(\'View: \' + info.view.type);
// change the border color just for fun
info.el.style.borderColor = \'red\';
}',
'dateClick' => 'function(info) {
alert(\'clicked \' + info.dateStr);
}'
]);
return view('hello', compact('calendar'));
Then to display, add the following code to your View:
<!doctype html>
<html lang="en">
<head>
<script src="https://code.jquery.com/jquery-3.5.1.min.js"></script>
<script src="//cdnjs.cloudflare.com/ajax/libs/moment.js/2.9.0/moment.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/[email protected]/main.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/[email protected]/locales-all.min.js"></script>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/[email protected]/main.css"/>
<style>
/* ... */
</style>
</head>
<body>
{!! $calendar->calendar() !!}
{!! $calendar->script() !!}
</body>
</html>
In your /resources/js/app.js
add any necessary plugins after installing them with NPM.
// FullCalendar.io
import { Calendar } from '@fullcalendar/core';
window.Calendar = Calendar;
import interaction from '@fullcalendar/interaction';
window.interaction = interaction;
import dayGridPlugin from '@fullcalendar/daygrid';
window.dayGridPlugin = dayGridPlugin;
import timeGridPlugin from '@fullcalendar/timegrid';
window.timeGridPlugin = timeGridPlugin;
import listPlugin from '@fullcalendar/list';
window.listPlugin = listPlugin;
import momentPlugin from '@fullcalendar/moment';
window.momentPlugin = momentPlugin;
import allLocales from '@fullcalendar/core/locales-all';
window.allLocales = allLocales;
In your resources/css/app.scss
add the necessary CSS.
// Fullcalendar
@import '~@fullcalendar/bootstrap/main.css';
@import '~@fullcalendar/daygrid/main.css';
@import '~@fullcalendar/timegrid/main.css';
@import '~@fullcalendar/list/main.css';
Then in your blade view file output the HTML:
<!DOCTYPE html>
<html lang="{{ str_replace('_', '-', app()->getLocale()) }}">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<link href="{{ mix('/css/app.css') }}" rel="stylesheet">
<script src="{{ mix('/js/app.js') }}"></script>
</head>
<body>
{!! $calendar->calendar() !!}
{!! $calendar->script() !!}
</body>
</html>
Note: The output from calendar()
and script()
must be non-escaped, so use {!!
and !!}
(or whatever you've configured your Blade compiler's raw tag directives as).
The script()
can be placed anywhere after calendar()
, and must be after fullcalendar was included.