Skip to content
Schedule is a package that helps tracking schedules for your models. If you have workers in a company, you can set schedules for them and see their availability though the time.
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
config Apply fixes from StyleCI (#3) Jun 23, 2018
database Apply fixes from StyleCI (#3) Jun 23, 2018
src Porting getMinutesOn() and getHoursOn() to the model itself (#10) Sep 7, 2018
tests Porting getMinutesOn() and getHoursOn() to the model itself (#10) Sep 7, 2018
.codecov.yml Support for Laravel 5.7 (#8) Sep 4, 2018
.gitignore Adding composer.lock on .gitignore [skip ci] Jun 16, 2018
.styleci.yml Added StyleCI badge and config file. [skip ci] Jun 23, 2018
.travis.yml Added Codecov and better tests for more coverage (#2) Jun 16, 2018
LICENSE Create LICENSE Jun 1, 2018
composer.json
phpunit.xml Added files for unit tests & unit tests themselves. Jun 1, 2018
readme.md Updated readme [skip ci] Jul 28, 2018

readme.md

Build Status codecov StyleCI Latest Stable Version Total Downloads Monthly Downloads License

PayPal

Schedule

Schedule is a package that helps tracking schedules for your models. If you have workers in a company, you can set schedules for them and see their availability though the time.

Inspiration

This package is inspired from Spatie's Opening Hours package, which uses a schedule but only statically, rather than binding it to a model. This gave me the idea of brining it closer to Eloquent Models than to the classic Class.

Installation

Install the package via Composer CLI:

$ composer require rennokki/schedule

For versions of Laravel that doesn't support package discovery, you should add this to your config/app.php file, in the providers array:

\Rennokki\Schedule\ScheduleServiceProvider::class,

Publish the migration file and the config file.

$ php artisan vendor:publish

Migrate the database.

$ php artisan migrate

Add the trait to your model.

use Rennokki\Schedule\Traits\HasSchedule;

class User extends Model {
    use HasSchedule;
    ...
}

Getting Started

To get stared, let's create a schedule for our user. It will be from Monday to Friday, between 8-12 and 13-18.

$user->setSchedule([
    'monday' => ['08:00-12:00', '13:00-18:00'],
    'tuesday' => ['08:00-12:00', '13:00-18:00'],
    'wednesday' => ['08:00-12:00', '13:00-18:00'],
    'thursday' => ['08:00-12:00', '13:00-18:00'],
    'friday' => ['08:00-12:00', '13:00-18:00'],
]);

$user->hasSchedule(); // true

Let's say the user has its birthday on 1st March each year, so let's add this to an exclusions list. Adding to this, the first and the second day of Christmas is free for anyone, and let's add 1st May 2018 in our exclusions list too.

Note: 1st May 2018 will occur only once, it's not recurrent.

$user->setExclusions([
    '03-01' => ['08:00-12:00'],
    '12-25' => [],
    '12-26' => [],
    '2018-05-01' => [],
]);

Checking for availability

You can check if the user has working hours on a certain day, date. Passing date also works with Carbon instance.

$user->isAvailableOn('monday'); // true
$user->isAvailableOn('05-28'); // true; This is Monday, in 2018 (current year)
$user->isAvailableOn('2018-05-28'); // true
$user->isAvailableOn(Carbon::create(2018, 5, 28, 0, 0, 0)); // true

$user->isUnavailableOn('monday'); // false
$user->isUnavailableOn('05-28'); // false
$user->isUnavailableOn('2018-05-28'); // false
$user->isUnavailableOn(Carbon::create(2018, 5, 28, 0, 0, 0)); // false

If there is an exclusion that day, it will return the correct value based on the schedule set that day:

$user->isUnavailableOn('12-25'); // true
$user->isUnavailableOn('03-01'); // false

Checking for availability at a certain time

You can also check availability for a certain time on a specific day.

$user->isAvailableOnAt('monday', '09:00'); // true
$user->isUnavailableOnAt('monday', '09:00'); // false

Getting the amount of hours or minutes for a day

You can get the amount of hours or minutes scheduled for a day. Good for tracking workable hours, for example.

$user->getHoursOn('03-01'); // 4
$user->getHoursOn('12-26'); // 0
$user->getHoursOn('05-28'); // 9
$user->getHoursOn('2018-05-28'); // 9

$user->getMinutesOn('03-01'); // 240

Deleting the schedule

If you plan to delete the user's schedule, you can do so by calling deleteSchedule().

$user->deleteSchedule();
$user->hasSchedule(); // false
You can’t perform that action at this time.