adzon/laravel-gantt

Laravel package to display items within a Gantt Chart.

1.1 2017-05-06 15:22 UTC

This package is auto-updated.

Last update: 2024-10-24 18:33:22 UTC


README

License

A Laravel 5.x package to display items within a Gantt chart (adapted from bastianallgeier/gantti).

Screenshot

Installation

Require this package with composer:

composer require swatkins/laravel-gantt

After updating composer, add the ServiceProvider to the providers array in config/app.php

Swatkins\LaravelGantt\GanttServiceProvider::class,

Copy the package css file to your local css with the publish command:

php artisan vendor:publish --tag="gantt"

Usage

The model to display in the Gantt Chart will need to have properties of label, start and end at minimum.

  • label is the string to display for the item
  • start is a date or datetime (will need to pass this as a YYYY-MM-DD format)
  • end is a date or datetime (will need to pass this as a YYYY-MM-DD format)
/**
 *  You'll pass data as an array in this format:
    $test_array = [
                      [
                        'label' => 'The item title',
                          'date' => [
                             [
                                 'start' => '2016-10-08',
                                 'end'   => '2016-10-14',
                                 'class' => '',
                             ],
                             [
                                 'start' => '2016-10-16',
                                 'end'   => '2016-10-19',
                                 'class' => '',
                             ]
                         ]
 
                     ]
                 ];
 */
 
$gantt = new Swatkins\LaravelGantt\Gantt($test_array, array(
    'title'      => 'Demo',
    'cellwidth'  => 25,
    'cellheight' => 35
));

return view('gantt')->with([ 'gantt' => $gantt ]);

Display in your view

In your view, add the gantt.css file:

<link href="/vendor/swatkins/gantt/css/gantt.css" rel="stylesheet" type="text/css">

And then output the gantt HTML:

{!! $gantt !!}

Model Factory

Here is a factory for creating test data for your projects. You can paste this into your database/factories/ModelFactory.php file and then run this via tinker. See https://laravel.com/docs/5.2/seeding#using-model-factories.

$factory->define(App\Project::class, function (Faker\Generator $faker) {
    return [
        'title' => $faker->sentence(),
        'start' => $faker->dateTimeBetween('-30 days'),
        'end' => $faker->dateTimeBetween('now', '+30 days')
    ];
});

Attribution

This code is adapted from https://github.com/bastianallgeier/gantti

License:

MIT License - http://www.opensource.org/licenses/mit-license.php