Filament: Show Calendar of Tasks with FullCalendar

November 04, 2023

2 min read

In this tutorial, we will show you how to quickly create a calendar in Filament for your model to display Tasks, Events, etc, using the package called "Filament FullCalendar".

Here, we have the Task Model that contains the name (string), start (datetime), and end (datetime) fields.

Filament FullCalendar

Install the Filament FullCalendar package via Composer.

composer require saade/filament-fullcalendar:^3.0

app/Providers/Filament/AdminPanelProvider.php

use Saade\FilamentFullCalendar\FilamentFullCalendarPlugin; 
 
public function panel(Panel $panel): Panel
{
    return $panel
        // ...
        ->plugins([FilamentFullCalendarPlugin::make()]); 
}

Then, create a widget.

php artisan make:filament-widget CalendarWidget

Replace CalendarWidget contents as follows.

app/Filament/Widgets/CalendarWidget.php

namespace App\Filament\Widgets;
 
use App\Models\Task;
use Illuminate\Database\Eloquent\Model;
use Saade\FilamentFullCalendar\Widgets\FullCalendarWidget;
 
class CalendarWidget extends FullCalendarWidget
{
    public Model | string | null $model = Task::class;
 
    public function fetchEvents(array $fetchInfo): array
    {
        return Task::where('start', '>=', $fetchInfo['start'])
            ->where('end', '<=', $fetchInfo['end'])
            ->get()
            ->map(function (Task $task) {
                return [
                    'id'    => $task->id,
                    'title' => $task->name,
                    'start' => $task->start,
                    'end'   => $task->end,
                ];
            })
            ->toArray();
    }
 
    public static function canView(): bool
    {
        return false;
    }
}

The fetchEvents() method returns your model data in a specific format, so you must map the data from your model.

id - Model's id
title - Property you want to display as calendar title
start - DateTime value when the Task starts
end - DateTime value when the Task ends

By default, CalendarWidget is displayed on the Dashboard page. The canView() returns a boolean whether to display the widget on the Dashboard or not. It may contain your custom logic.

For this example, we return false to completely hide it because we will display it on a separate page.

Let's create the said page.

php artisan make:filament-page Calendar

Finally, update the page contents.

resources/views/filament/pages/calendar.blade.php

<x-filament-panels::page>
    @livewire(\App\Filament\Widgets\CalendarWidget::class) 
</x-filament-panels::page>

If you want more Filament examples, you can find more real-life projects on our FilamentExamples.com.

<?php namespace App\Filament\Widgets; use Saade\FilamentFullCalendar\Widgets\FullCalendarWidget; class CalendarWidget extends FullCalendarWidget { public function config(): array { return [ 'initialView' => 'resourceTimelineDefault', 'headerToolbar' => [ 'left' => 'dayGridWeek,dayGridDay', 'center' => 'title', 'right' => 'prev,next today', ], 'views' => [ 'resourceTimelineDefault' => [ 'type' => 'resourceTimeline', 'duration' => ['days' => 4], // I cant get arg object here 'slotLabelContent' => function($arg) { if ($arg.level === 1) { $time = $arg.date.getHours(); $timeLabel = ''; if ($time >= 0 && $time < 8) { $timeLabel = 'Morning'; } else if ($time >= 8 && $time < 16) { $timeLabel = 'Afternoon'; } else if ($time >= 16 && $time < 24) { $timeLabel = 'Night'; } return [ 'html' => '<div class="custom-label-top">' + $arg.text + '</div>' + '<div class="custom-label-bottom">' + $timeLabel + '</div>' ]; } else { return [ 'html' => '<div class="custom-label-top">' + arg.text + '</div>' ]; } }, ] ] ]; } }

anguz 2 years ago

Hi!

This gives me an error: "Typed static property Filament\Widgets\Widget::$view must not be accessed before initialization"

I'm using Laravel 10 and Filament 3

David Lun 2 years ago

check if you really extend FullCalendarWidget instead of Widget

thank you very much! It was that

Daniel Schweiger 2 years ago

I get this error when pressing "New Task" top right Action:

Filament\Actions\CreateAction::Filament\Actions{closure}(): Argument #2 ($form) must be of type Filament\Forms\Form, null given, called in /Users/d4n333/work/valet/xxx/vendor/filament/support/src/Concerns/EvaluatesClosures.php on line 35

For my Tasks I use simple Resource. Is this the problem? Should I use Pages for Create and Edit the Tasks?

Do you actually have a create form page and form() defined in your resource?

This tutorial is only for displaying calendar. Please see plugin documentation.

thx david, fullcalendars documentation helped me out.

Jose Antonio Rojas Rodríguez 1 year ago

Same error here, how did you solve it?

Davide Cavallini 2 years ago

why can't i see the timegrid? i don't see the hours inside the day

Oreste Barranco Hernández 2 years ago

Great tutorial. How could I add filters to show events within a given date for example?

👍 1

Siddiq Abdur Rozzaq 2 years ago

hey guys. I want to change some appearance using slotLabelContent function on resourceTimeline view. I can't get arg object on function. how to do it? please help.

Ivan Teran 1 year ago

Did you find a way to write the javascript code?

Med Frk 1 year ago

How can we implement a filtering system above the calendar? For instance, when displaying orders in the calendar view, we could add a form at the top that allows users to filter orders based on their status.

Oreste Barranco Hernández 1 year ago

How I can show the calendar inside a modal?

Richard A. Hoyle 5 days ago

Is their anny way you would consider redoing this cours using Laravel 13.12.0, Filament 5.6.6, FullCalendar 7.0 or newer?

Filament: Show Calendar of Tasks with FullCalendar

Enjoyed This Tutorial?

Recent Courses on Laravel Daily

Roles and Permissions in Laravel 13

Testing in Laravel 13 For Beginners

How to Structure Laravel 13 Projects

We'd Love Your Feedback

Thank You!