PHPackages                             labapawel/filament-planer - 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. labapawel/filament-planer

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

labapawel/filament-planer
=========================

Filament form component for weekly planning.

v1.0.1(6mo ago)05MITBladePHP ^8.2

Since Dec 29Pushed 6mo agoCompare

[ Source](https://github.com/labapawel/filament-planer)[ Packagist](https://packagist.org/packages/labapawel/filament-planer)[ RSS](/packages/labapawel-filament-planer/feed)WikiDiscussions main Synced today

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

Filament Planer
===============

[](#filament-planer)

A Filament PHP form component that creates an interactive weekly timetable, allowing users to select specific hours for each day of the week.

[![image.png](image.png)](image.png)

Features
--------

[](#features)

- **Weekly Timetable UI:** Responsive grid layout with hours on the left and days on top.
- **Interactive Selection:**
    - Drag & drop support for selecting multiple cells.
    - Click to toggle individual hours.
    - "Select All" / "Deselect All" icon buttons for each day.
- **Visual Feedback:**
    - Real-time counters: Total selected hours (global) and daily totals.
    - customizable selection colors via CSS.
- **Configurable:** Customizable hours range, time steps, meaningful days labels, and "full day" selection strategies.
- **Data Storage:** Saves selection as a clean JSON object (e.g., `{"1":["08:00","09:00"],"2":["10:00"]}`).
- **Multilingual:** Built-in support for Polish, English, and German.
- **Dark Mode:** Fully compatible with Filament's dark mode.
- **Read-only Support:** Respects Filament's `disabled()` state.

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

[](#installation)

You can install the package via composer:

```
composer require labapawel/filament-planer
```

The service provider will automatically register itself. You can publish the configuration file with:

```
php artisan vendor:publish --tag="filament-planer-config"
```

Usage
-----

[](#usage)

Add the `Planer` component to your Filament form schema:

```
use Labapawel\FilamentPlaner\Forms\Components\Planer;

public static function form(Form $form): Form
{
    return $form
        ->schema([
            Planer::make('schedule')
                ->label('Weekly Plan')
                // Optional customizations:
                ->days([1, 2, 3, 4, 5]) // Define visible days (1=Mon to 7=Sun)
                ->hours(['08:00', '09:00', '10:00', '11:00', '12:00', '13:00', '14:00', '15:00', '16:00']) // Custom hour slots
                ->fullDayConfig([
                    'enabled' => true,      // Enable "Select All" buttons
                    'default_hours' => 8,   // Max hours to select when using 'first_n' strategy
                    'strategy' => 'first_n', // Strategies: 'all_available' or 'first_n'
                ])
                ->disabled(fn ($record) => $record?->is_locked),
        ]);
}
```

Styling & Customization
---------------------------

[](#styling--customization)

The component uses a dedicated CSS class `.sel` for selected cells, allowing for easy color customization outside of the standard Filament theme.

To customize the selection color, you can modify or override the CSS variables or classes in your project's stylesheet, or edit `resources/css/filament-planer.css` if you have published the assets.

**Default values (`filament-planer.css`):**

```
/* Light mode */
.filament-planer-table .sel {
    background-color: #93c5fd; /* blue-300 */
}

/* Dark mode */
:is(.dark .filament-planer-table) .sel {
    background-color: #3b82f6; /* blue-500 */
}
```

Configuration
-------------

[](#configuration)

The default settings can be globally modified in `config/filament-planer.php`:

```
return [
    'hours' => [
        'start' => '08:00',
        'end' => '16:00',
        'step' => 60, // Interval in minutes
    ],
    'days' => [1, 2, 3, 4, 5], // Default: Monday to Friday
    'full_day' => [
        'enabled' => true,
        'default_hours' => 8,
        'strategy' => 'all_available',
    ],
];
```

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

34

—

LowBetter than 75% of packages

Maintenance68

Regular maintenance activity

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1 days

Total

2

Last Release

185d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/11938667?v=4)[PawelL](/maintainers/labapawel)[@labapawel](https://github.com/labapawel)

---

Top Contributors

[![labapawel](https://avatars.githubusercontent.com/u/11938667?v=4)](https://github.com/labapawel "labapawel (8 commits)")

### Embed Badge

![Health badge](/badges/labapawel-filament-planer/health.svg)

```
[![Health](https://phpackages.com/badges/labapawel-filament-planer/health.svg)](https://phpackages.com/packages/labapawel-filament-planer)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3355.3M346](/packages/psalm-plugin-laravel)[bezhansalleh/filament-google-analytics

Google Analytics integration for FilamentPHP

211189.7k8](/packages/bezhansalleh-filament-google-analytics)[promethys/revive

A 'RecycleBin' page where users can restore or delete permanently soft-deleted models.

162.9k](/packages/promethys-revive)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)